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/fiche_commerce.md (oder mit dem Header Accept: text/markdown).

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

fiche_commerce

Mit KontoSchreibt (bestätigen)

Liest oder ändert das Profil des Ladens: Name, Art des Ladens, Durchschnittsbon (dient den Schätzungen im Dashboard), Sprache der Kunden, Kontaktdaten auf der Rückseite der Karte (Adresse, Telefon, Öffnungszeiten, Website, Begrüßungstext), öffentlicher Anmeldelink für Kunden (stampywallet.com/rejoindre/<lien>, der des QR-Codes) und die Orte, an denen die Karte erscheinen kann, wenn ein Kunde vorbeigeht, sofern sein Telefon es zulässt (bis zu 10: Laden, Markt, Standplatz eines Foodtrucks), mit ihren Tagen und Uhrzeiten. Ohne Änderungsparameter: liefert das aktuelle Profil. Mit Änderungen: confirmer=false (Standard) zeigt vorher/nachher, confirmer=true schreibt nach ausdrücklicher Zustimmung. Ein alter öffentlicher Link funktioniert nach einer Änderung weiter (bereits gedruckte QR-Codes bleiben gültig).

Parameter

nom
string, ≤ 80 Zeichen
optional
Name des Ladens (wird auch auf die Karte gedruckt).
metier
enum
optional
Art des Ladens, eine der Branchen aus der Anmeldung. „autre“: alles, was keine eigene Branche hat.
Werte (29)

cafe, boulangerie, patisserie, glacier, restaurant, creperie, sushi, snack, foodtruck, boucherie, fromagerie, primeur, vrac, ongles, institut, barbier, boutique, fleuriste, librairie, animalerie, pressing, cordonnerie, laverie, lavage, toilettage, sport, escalade, loisirs, autre

panier_moyen
number, 0.01…100000
optional
Durchschnittliche Ausgabe eines Kunden pro Besuch, in Euro.
langue
enum
optional
Sprache des Ladens: die der Karte, der Seiten und der Nachrichten, die die Kunden sehen.

Werte : fr, en, es, de

adresse
string, ≤ 160 Zeichen
optional
Adresse, auf der Rückseite der Karte (höchstens 160 Zeichen).
telephone
string, ≤ 30 Zeichen
optional
Telefon, auf der Rückseite der Karte.
horaires
string, ≤ 120 Zeichen
optional
Öffnungszeiten, als freier Text (z. B. „Di–Sa 7–19 Uhr“).
site_web
string, ≤ 160 Zeichen
optional
Website oder Instagram-Seite.
message_bienvenue
string, ≤ 180 Zeichen
optional
Kurzer Gruß auf der Rückseite der Karte, den der Kunde beim Hinzufügen liest.
lien
string, ≤ 120 Zeichen
optional
Gewünschter öffentlicher Link, im Klartext („Bäckerei am Bahnhof“ wird zu „baeckerei-am-bahnhof“), 3 bis 32 Zeichen. Ein Link, den schon ein anderer Laden nutzt, wird abgelehnt.
lieux_ajouter
array<object>, ≤ 10
optional
Orte, die für die Nähe-Erinnerung hinzugefügt werden (die Karte kann erscheinen, wenn ein Kunde vorbeigeht, sofern sein Telefon es zulässt): Markt, Standplatz eines Foodtrucks… Insgesamt höchstens 10 Orte, Hauptadresse eingeschlossen. Jeder mit einer Adresse oder Koordinaten.
lieux_ajouter[].nom
string, ≤ 40 Zeichen
Pflicht
Kurzer Name des Ortes („Laden“, „Sonntagsmarkt“), höchstens 40 Zeichen.
lieux_ajouter[].adresse
string, ≤ 160 Zeichen
optional
Adresse, nach der gesucht wird, um den Punkt zu setzen (geokodiert über die Base Adresse Nationale oder OpenStreetMap; die Vorschau zeigt, was gefunden wurde).
lieux_ajouter[].coordonnees
string, ≤ 400 Zeichen
optional
Oder Koordinaten „45.7640, 4.8357“, oder ein Link von Google Maps / OpenStreetMap.
lieux_ajouter[].jours
array<enum>, ≤ 7
optional
Tage, an denen der Ort aktiv ist. Fehlt der Wert oder steht „tous“: jeden Tag.

Werte : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi, tous

lieux_ajouter[].heure_debut
string
optional
Beginn des Zeitfensters, „HH:MM“ (optional, wird auf die Rückseite der Karte geschrieben: Telefone aktivieren einen Ort nur für den ganzen Tag).
lieux_ajouter[].heure_fin
string
optional
Ende des Zeitfensters, „HH:MM“.
lieux_modifier
array<object>, ≤ 10
optional
Orte, die umbenannt, verlegt (Adresse oder Koordinaten) oder neu geplant werden (Tage, Zeitfenster). Die angegebenen Tage ersetzen die alten; ohne Tage und Uhrzeiten ändert sich die Planung nicht.
lieux_modifier[].lieu
string, ≤ 40 Zeichen
Pflicht
Der zu ändernde Ort: seine Kennung (aus dem Lesen des Profils) oder „principal“ (der Ort der Adresse auf der Rückseite der Karte).
lieux_modifier[].nom
string, ≤ 40 Zeichen
optional
Kurzer Name des Ortes („Laden“, „Sonntagsmarkt“), höchstens 40 Zeichen.
lieux_modifier[].adresse
string, ≤ 160 Zeichen
optional
Adresse, nach der gesucht wird, um den Punkt zu setzen (geokodiert über die Base Adresse Nationale oder OpenStreetMap; die Vorschau zeigt, was gefunden wurde).
lieux_modifier[].coordonnees
string, ≤ 400 Zeichen
optional
Oder Koordinaten „45.7640, 4.8357“, oder ein Link von Google Maps / OpenStreetMap.
lieux_modifier[].jours
array<enum>, ≤ 7
optional
Tage, an denen der Ort aktiv ist. Fehlt der Wert oder steht „tous“: jeden Tag.

Werte : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi, tous

lieux_modifier[].heure_debut
string
optional
Beginn des Zeitfensters, „HH:MM“ (optional, wird auf die Rückseite der Karte geschrieben: Telefone aktivieren einen Ort nur für den ganzen Tag).
lieux_modifier[].heure_fin
string
optional
Ende des Zeitfensters, „HH:MM“.
lieux_retirer
array<string>, ≤ 10
optional
Orte, die entfernt werden, nach Kennung. „principal“ entfernt nur den Punkt der Adresse (er kommt zurück, wenn sich die Adresse ändert).
effacer
array<enum>, ≤ 6
optional
Felder, die geleert werden. „lien“: Die öffentliche Adresse wird wieder die technische Kennung (der Link bleibt für diesen Laden reserviert).

Werte : adresse, telephone, horaires, site_web, message_bienvenue, lien

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?