Zum Inhalt springen

Für KI-Agenten: Das Verzeichnis der Dokumentation steht unter https://stampywallet.com/de/docs/llms.txt, die gesamte Dokumentation in einer Datei unter https://stampywallet.com/de/docs/llms-full.txt, und diese Seite gibt es als Markdown: https://stampywallet.com/de/docs/mcp/werkzeuge/modifier_carte.md (oder mit dem Header Accept: text/markdown).

StampyWalletDocs
MCP und KI / Werkzeuge mit Konto / modifier_carteAls Markdown ansehen

modifier_carte

Mit KontoSchreibt (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 (79)

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 (80)

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.

War diese Seite hilfreich?