# modifier_carte

> Für KI-Agenten: Das vollständige Verzeichnis der Dokumentation steht unter [llms.txt](https://stampywallet.com/de/docs/llms.txt), die gesamte Dokumentation passt in eine Datei: [llms-full.txt](https://stampywallet.com/de/docs/llms-full.txt). Seite online: https://stampywallet.com/de/docs/mcp/werkzeuge/modifier_carte/

Mit Konto · Schreibt (bestätigen).

Ändert eine oder mehrere Einstellungen der Kundenkarte des Ladens in einem einzigen Aufruf: aufgedruckter Name, Stil (Kollektion, Palette oder freie Farbe), Stempel, Prämienregel (Modus tampons/paliers/points, Schwellen, Prämien), geschenkte Stempel bei der Anmeldung, Ablauf der Prämien, im Modus paliers die Form der Karte (forme_paliers: tampons oder eine der fünf Formen) und im Modus points der Name der Punkte, die Form der Karte (forme_points), der Standardwert eines Besuchs, die Schnellwerte und die Punkte pro Euro. Nur die angegebenen Einstellungen ändern sich; zuerst die Karte mit voir_carte lesen. Mit confirmer=false (Standard) aufrufen, um vorher/nachher zu zeigen, dann mit confirmer=true nach ausdrücklicher Zustimmung. Eine Regeländerung gilt auch für Karten, die die Kunden schon haben. Die Bilder (Logo, Hintergrund, Stempel als Bild) ändern Sie in der App, Seite Karte.

## Parameter

- `nom` (string, ≤ 80 Zeichen, optional) : Name des Ladens, oben auf die Karte gedruckt.
- `mode` (enum, optional) : tampons: eine Prämie bei einer Schwelle (am einfachsten). paliers: mehrere Prämien auf derselben Karte (z. B. 5 und 10). points: Der Ladeninhaber gibt bei jedem Besuch eine Anzahl Punkte ein (unterschiedliche Einkaufsbeträge). Werte : tampons, paliers, points.
- `recompense` (string, ≤ 120 Zeichen, optional) : Die Prämie (Modus tampons). Wird ignoriert, wenn „paliers“ angegeben ist.
- `tampons` (integer, 2…30, optional) : Anzahl der Besuche bis zur Prämie (Modus tampons), von 2 bis 30.
- `paliers` (array<object>, ≤ 6, optional) : Die Prämien und ihre Schwellen (Modi paliers und points). Von der kleinsten zur größten.
- `paliers[].a` (integer, 1…1000000, Pflicht) : Schwelle: Anzahl Stempel (oder Punkte im Modus points), um diese Stufe zu erreichen.
- `paliers[].recompense` (string, ≤ 120 Zeichen, Pflicht) : Was der Kunde bekommt, so wie es auf der Karte steht. Z. B. „Ein Kaffee gratis“.
- `paliers[].icone` (enum, optional) : Icon der Stufe (Standard: cadeau). Werte : etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette, cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau, feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion, croissant.
- `collection` (enum, optional) : Stil der Karte: original (schlicht), cafe (feiner Rahmen), botanique (kursiv, Blätter), trattoria (gewellter Rand), atelier (modern), pass (wie ein Apple Wallet Pass: großes Logo, Stempel als Objekte mit Schatten, kräftiger Hintergrund). Werte : original, cafe, botanique, trattoria, atelier, pass.
- `palette` (integer, 0…3, optional) : Palette der Kollektion: 0, 1 oder 2 (jede Kollektion bietet drei; pass bietet eine vierte, 3). Wird ignoriert, wenn „couleur“ angegeben ist.
- `couleur` (string, optional) : Freie Hintergrundfarbe, hexadezimal. Die Schriftfarbe (Text) wird automatisch so gewählt, dass sie lesbar bleibt.
- `tampon` (enum, optional) : Das Zeichen, das bei jedem Besuch gesetzt wird. „rond“: der einfache Punkt. Beauty: etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette. Food: cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau. Sonstiges: feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion. Werte : rond, etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette, cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau, feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion, croissant.
- `tampons_bienvenue` (integer, 0…5, optional) : Stempel, die der Kunde bei der Anmeldung geschenkt bekommt (0 bis 5). Standard 1: Eine angefangene Karte will man vollmachen.
- `nom_des_points` (string, ≤ 20 Zeichen, optional) : Modus points: wie die Punkte heißen („Punkte“, „Bohnen“, „Sterne“…).
- `forme_paliers` (enum, optional) : Modus paliers: das Aussehen der Karte. tampons (Standard): die Stempel im Raster, jede Prämie an der Stelle des Stempels ihrer Schwelle. Oder eine der fünf Formen der Punkte, die dann Stempel zählt: medailles (ein Balken und eine Medaille pro Prämie), vitrine (die Prämien nebeneinander, jede mit eigenem Balken), remplissage (die nächste Prämie in groß, die sich einfärbt), chemin (ein Weg in S-Form, auf dem jeder Stempel den Marker voranbringt), anneau (ein runder Balken um die nächste Prämie). Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : tampons, medailles, vitrine, remplissage, chemin, anneau.
- `forme_points` (enum, optional) : Modus points: das Aussehen der Karte. medailles (Standard): ein dicker Balken und eine große Medaille pro Prämie. vitrine: die Prämien nebeneinander, jede mit eigenem kleinen Balken. remplissage: die nächste Prämie in groß, die sich nach und nach einfärbt. chemin: ein Weg in S-Form, die Prämien als Etappen. anneau: ein runder Balken um die nächste Prämie, die Liste daneben. Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : medailles, vitrine, remplissage, chemin, anneau.
- `expiration_recompense_jours` (integer, 0…365, optional) : Tage, die eine verdiente Prämie gültig bleibt: 0, 30, 60, 90, 180, 365 (0 = läuft nicht ab).
- `points_par_defaut` (integer, 1…100000, optional) : Modus points: Punkte, die standardmäßig bei jedem Besuch gesetzt werden (1 bis 100 000).
- `points_raccourcis` (array<integer>, ≤ 12, optional) : Modus points: die Werte, die beim Scannen mit einem Tippen angeboten werden (bis zu 6, sortiert und ohne Doppelte). Z. B. [1, 2, 5, 10].
- `points_par_euro` (number, 0.01…10000, optional) : Modus points: Punkte pro ausgegebenem Euro, Richtwert für den Ladeninhaber (z. B. 1 oder 0,5).
- `conversion` (number, 0.01…100000, optional) : Passage tampons ↔ points seulement : combien de points vaut UN tampon (ex. 15). Les soldes des cartes ouvertes et, si aucune récompense n’est donnée, les seuils sont convertis avec. Défaut : le dernier ratio choisi, sinon le panier moyen en points, sinon 10.
- `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false.

## Antwort

Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann.

> **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft.

## Beispiel

Prompt : « Stell meine Karte auf Stufen um: ein Kaffee nach 5 Besuchen, ein Croissant nach 10. »

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "modifier_carte",
    "arguments": {
      "mode": "paliers",
      "paliers": [
        {
          "a": 5,
          "recompense": "Ein Kaffee gratis",
          "icone": "cafe"
        },
        {
          "a": 10,
          "recompense": "Ein Croissant gratis",
          "icone": "croissant"
        }
      ],
      "confirmer": false
    }
  }
}
```

```bash
curl https://app.stampywallet.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $STAMPY_JETON" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"modifier_carte","arguments":{"mode":"paliers","paliers":[{"a":5,"recompense":"Ein Kaffee gratis","icone":"cafe"},{"a":10,"recompense":"Ein Croissant gratis","icone":"croissant"}],"confirmer":false}}}'
```

`$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun.
