# fiche_commerce

> 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/fiche_commerce/

Mit Konto · Schreibt (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 : 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.

## Beispiel

Prompt : « Schreib meine Öffnungszeiten auf die Rückseite der Karte: Dienstag bis Samstag, 7 bis 19 Uhr. »

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "fiche_commerce",
    "arguments": {
      "horaires": "Di–Sa 7–19 Uhr",
      "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":"fiche_commerce","arguments":{"horaires":"Di–Sa 7–19 Uhr","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.
