elevai Commerce Demo is an MCP server published by ch.elevai, hosted at elevai.ch. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including search_products, get_product, search_catalog, create_order, review_terms.
Open demo shop: search products, place a 0.05 CHF order, create a PostFinance payment link.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Durchsucht den Katalog des Demoshops von elevai.ch nach einem Begriff und liefert Name, Preis, Waehrung und Produktseite. Ohne Begriff kommen die zuletzt aufgenommenen Produkte.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | Suchbegriff, etwa "Kite" oder "Abo". |
{
"name": "search_products",
"title": "Produkte suchen",
"description": "Durchsucht den Katalog des Demoshops von elevai.ch nach einem Begriff und liefert Name, Preis, Waehrung und Produktseite. Ohne Begriff kommen die zuletzt aufgenommenen Produkte.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"description": "Suchbegriff, etwa \"Kite\" oder \"Abo\"."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"products",
"count"
],
"properties": {
"count": {
"type": "integer"
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"price",
"currency"
],
"properties": {
"id": {
"type": "integer",
"description": "product_id fuer create_order"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"image": {
"type": [
"string",
"null"
]
},
"price": {
"type": "string"
},
"currency": {
"type": "string"
},
"in_stock": {
"type": "boolean"
}
}
}
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Liefert die Einzelheiten zu einem Produkt: Beschreibung, Preis, Lagerstatus, Kategorien und Bild.
| Parameter | Type | Description |
|---|---|---|
| product_id * | integer | Die id aus search_products. |
{
"name": "get_product",
"title": "Produkt ansehen",
"description": "Liefert die Einzelheiten zu einem Produkt: Beschreibung, Preis, Lagerstatus, Kategorien und Bild.",
"inputSchema": {
"type": "object",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "integer",
"description": "Die id aus search_products."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"id",
"name",
"price",
"currency"
],
"properties": {
"id": {
"type": "integer",
"description": "product_id fuer create_order"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"image": {
"type": [
"string",
"null"
]
},
"price": {
"type": "string"
},
"currency": {
"type": "string"
},
"in_stock": {
"type": "boolean"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search the product catalog des Demoshops von elevai.ch by keyword (UCP name; same as search_products). Returns id, name, price, currency, stock and product URL. Without a query: the newest products. No sign-in needed. The id is the product_id for get_product and create_order.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | Suchbegriff, etwa "Kite" oder "Abo". |
{
"name": "search_catalog",
"title": "Search catalog",
"description": "Search the product catalog des Demoshops von elevai.ch by keyword (UCP name; same as search_products). Returns id, name, price, currency, stock and product URL. Without a query: the newest products. No sign-in needed. The id is the product_id for get_product and create_order.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"description": "Suchbegriff, etwa \"Kite\" oder \"Abo\"."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"products",
"count"
],
"properties": {
"count": {
"type": "integer"
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"price",
"currency"
],
"properties": {
"id": {
"type": "integer",
"description": "product_id fuer create_order"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"image": {
"type": [
"string",
"null"
]
},
"price": {
"type": "string"
},
"currency": {
"type": "string"
},
"in_stock": {
"type": "boolean"
}
}
}
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Legt im Demoshop von elevai.ch eine Bestellung an. Ein Aufruf mit product_id allein genuegt fuer den Anfang (mehrere Artikel: items, alle in EINER Bestellung): Das Werkzeug prueft selbst, was noch fehlt, und liefert die Geschaeftsbedingungen samt Fassung mit — Nachfragen nach Bedingungen, E-Mail, Namen oder Adresse erledigen sich damit meist von selbst. Fehlt die Zustimmung, steht das in der Antwort; ein zweiter Aufruf mit accept_terms: true und der terms_version aus dieser Antwort schliesst die Bestellung ab (die Fassung stammt immer aus der Antwort, nie aus einer Annahme). Ist der Agent mit einem Kundenkonto verbunden (OAuth), sind Person und Adresse bereits bekannt; liegt zusaetzlich ein Mandat vor, entfaellt die AGB-Rueckfrage ganz. Zurueck kommt ein order_handle fuer create_payment_link; wie es unter einem Mandat weitergeht, steht dort. Demoshop mit Grenzen: Einzelpreis bis 0.05 CHF, Bestellsumme bis 0.25 CHF. Was sonst gilt, steht in den Geschaeftsbedingungen — nicht in deiner Antwort wiederholen.
| Parameter | Type | Description |
|---|---|---|
| string | Nur mitgeben, wenn das Werkzeug in einer vorherigen Antwort ausdruecklich danach gefragt hat. Niemals erfinden, niemals einen Platzhalter wie "?" einsetzen, und nie von sich aus danach fragen. Entfaellt ganz, wenn der Agent mit einem Kundenkonto verbunden ist oder ein bestaetigtes login_handle mitge… | |
| items | array | Mehrere Artikel in EINER Bestellung: je {product_id, quantity}. Will die Person mehrere Artikel, gehoeren sie in einen Aufruf mit items — nicht in mehrere Bestellungen. Statt product_id/quantity, nicht zusaetzlich. |
| country | string | Zwei Buchstaben, ISO 3166-1, Vorgabe CH. |
| quantity | integer | |
| last_name | string | |
| first_name | string |
Zeigt der Person die Geschaeftsbedingungen zu einer geplanten Bestellung als Karte mit dem Knopf «Zustimmen und bestellen». Aufrufen, wenn create_order terms_required meldet — mit derselben product_id und quantity bzw. denselben items. Legt selbst keine Bestellung an; das geschieht erst mit dem Klick der Person in der Karte.
| Parameter | Type | Description |
|---|---|---|
| items | array | Dieselben items wie bei create_order. |
| quantity | integer | |
| product_id | integer | Dieselbe product_id wie bei create_order. |
{
"name": "review_terms",
"title": "Geschaeftsbedingungen zeigen",
"description": "Zeigt der Person die Geschaeftsbedingungen zu einer geplanten Bestellung als Karte mit dem Knopf «Zustimmen und bestellen». Aufrufen, wenn create_order terms_required meldet — mit derselben product_id und quantity bzw. denselben items. Legt selbst keine Bestellung an; das geschieht erst mit dem Klick der Person in der Karte.",
"inputSchema": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id"
],
"properties": {
"quantity": {
"type": "integer",
"default": 1,
"maximum": 5,
"minimum": 1
},
"product_id": {
"type": "integer"
}
}
},
"maxItems": 5,
"minItems": 1,
"description": "Dieselben items wie bei create_order."
},
"quantity": {
"type": "integer",
"default": 1,
"maximum": 5,
"minimum": 1
},
"product_id": {
"type": "integer",
"description": "Dieselbe product_id wie bei create_order."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Zeigt zu einer Bestellung die Zahlkarte im Chat: PostFinance Pay, TWINT und Kreditkarte, je mit der Art der Bestaetigung (Push, Ein Klick mit hinterlegtem Zahlungsmittel, TWINT App, 3-D Secure). Die Person waehlt und bezahlt dort selbst. Verlangt das Handle aus create_order; der Betrag stammt aus der Bestellung, nicht vom Aufrufer. Wortwahl: Sprich von «bezahlen» oder «der Zahlkarte», NIE von einem «Zahlungslink» oder «Zahllink» — der Link ist nur ein Rueckfall, falls keine Karte erscheint.
| Parameter | Type | Description |
|---|---|---|
| method | string | Zahlart (Schluessel aus der Auswahl, die das Werkzeug ohne method liefert): pfpay = PostFinance Pay, twint = TWINT. Ohne Angabe liefert das Werkzeug die Zahlarten zur Auswahl zurueck, statt eine Zahlseite zu erzeugen. Alle ausser pfpay gehen ueber die Zahlseite mit Bestaetigung dort (TWINT App, 3-D … |
| stepup | boolean | Nur true, wenn die Person die Zahlung lieber selbst in der PostFinance App bestaetigen will, statt im Gespraech zuzustimmen. Zusammen mit no_card: liefert den Link zur Zahlseite. |
| confirm | string | Nur von der Zahlkarte selbst gesetzt (Klick auf den Knopf). Nie vom Modell ausfuellen. |
| no_card | boolean | Nur true, wenn die Person sagt, dass KEINE Zahlkarte und kein Knopf angezeigt wird. Dann liefert das Werkzeug einen Link zur Zahlseite (Bestaetigung in der PostFinance App) — auch unter einem Mandat mit Direktzahlung. Sonst weglassen. |
| unattended | boolean | Nur true bei einer autonomen, geplanten Aufgabe, bei der KEIN Mensch im Gespraech ist. Dann bucht ein Mandat mit Direktzahlung ohne Klick. Ist eine Person im Chat, IMMER weglassen. |
| order_handle * | string |
Listet die Bestellungen, die Agenten fuer das verbundene Kundenkonto angelegt haben (letzte sieben Tage, neueste zuerst), je mit einem frischen order_handle. Damit lassen sich auch aeltere Bestellungen aus anderen Gespraechen finden, ihr Stand abfragen (get_order_status) und offene oder reservierte stornieren (cancel_order). Bezahlen laesst sich nur eine Bestellung, die hoechstens zwei Stunden alt ist.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Vorgabe 10. |
| status | string | open: nur offene und reservierte (stornierbar). Vorgabe: all. |
{
"name": "list_orders",
"title": "Eigene Bestellungen auflisten",
"description": "Listet die Bestellungen, die Agenten fuer das verbundene Kundenkonto angelegt haben (letzte sieben Tage, neueste zuerst), je mit einem frischen order_handle. Damit lassen sich auch aeltere Bestellungen aus anderen Gespraechen finden, ihr Stand abfragen (get_order_status) und offene oder reservierte stornieren (cancel_order). Bezahlen laesst sich nur eine Bestellung, die hoechstens zwei Stunden alt ist.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Vorgabe 10."
},
"status": {
"enum": [
"open",
"all"
],
"type": "string",
"description": "open: nur offene und reservierte (stornierbar). Vorgabe: all."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"orders"
],
"properties": {
"orders": {
"type": "array",
"items": {
"type": "object",
"properties": {
"items": {
"type": "string"
},
"total": {
"type": "string"
},
"status": {
"type": "string"
},
"created": {
"type": "string"
},
"payable": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"mandate_id": {
"type": [
"integer",
"null"
]
},
"cancellable": {
"type": "boolean"
},
"mandate_name": {
"type": [
"string",
"null"
]
},
"order_handle": {
"type": "string"
},
"order_number": {
"type": "string"
},
"mandate_state": {
"enum": [
"active",
"revoked",
"expired",
"deleted",
null
],
"type": [
"string",
"null"
]
}
}
}
},
"account": {
"type": [
"object",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Storniert eine eigene Bestellung, die noch offen oder reserviert ist. Eine Reservation bei PostFinance wird dabei sofort freigegeben (statt erst nach Ablauf der Reservationsfrist). Nur auf ausdruecklichen Wunsch der Person: erst ohne confirmed_in_chat aufrufen — das Werkzeug nennt, was storniert wuerde —, die Person fragen, und erst nach ihrem Ja mit confirmed_in_chat: true erneut aufrufen. Nur Bestellungen, deren Nummer die Person ausdruecklich nennt; sagt sie «alle» oder nennt keine Nummer, die stornierbaren Nummern aufzaehlen und sie bitten, die gewuenschten Nummern zu nennen. Verlangt das Handle aus create_order oder list_orders (fuer aeltere Bestellungen aus anderen Gespraechen: zuerst list_orders).
| Parameter | Type | Description |
|---|---|---|
| reason | string | Optional: Grund in den Worten der Person, kurz. |
| order_handle * | string | |
| confirmed_in_chat | boolean | Nur true, wenn die Person der Stornierung im Gespraech ausdruecklich zugestimmt hat. Nie selbst setzen. |
{
"name": "cancel_order",
"title": "Bestellung stornieren",
"description": "Storniert eine eigene Bestellung, die noch offen oder reserviert ist. Eine Reservation bei PostFinance wird dabei sofort freigegeben (statt erst nach Ablauf der Reservationsfrist). Nur auf ausdruecklichen Wunsch der Person: erst ohne confirmed_in_chat aufrufen — das Werkzeug nennt, was storniert wuerde —, die Person fragen, und erst nach ihrem Ja mit confirmed_in_chat: true erneut aufrufen. Nur Bestellungen, deren Nummer die Person ausdruecklich nennt; sagt sie «alle» oder nennt keine Nummer, die stornierbaren Nummern aufzaehlen und sie bitten, die gewuenschten Nummern zu nennen. Verlangt das Handle aus create_order oder list_orders (fuer aeltere Bestellungen aus anderen Gespraechen: zuerst list_orders).",
"inputSchema": {
"type": "object",
"required": [
"order_handle"
],
"properties": {
"reason": {
"type": "string",
"description": "Optional: Grund in den Worten der Person, kurz."
},
"order_handle": {
"type": "string"
},
"confirmed_in_chat": {
"type": "boolean",
"description": "Nur true, wenn die Person der Stornierung im Gespraech ausdruecklich zugestimmt hat. Nie selbst setzen."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"retry": {
"type": "boolean"
},
"total": {
"type": "string"
},
"status": {
"type": "string"
},
"currency": {
"type": "string"
},
"cancelled": {
"type": "boolean"
},
"order_handle": {
"type": "string"
},
"already_cancelled": {
"type": "boolean"
},
"reservation_released": {
"type": "boolean"
},
"confirmation_required": {
"type": "boolean"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Zeigt den aktuellen Stand einer Bestellung. In dieser Demo ist "reserviert" (on-hold) der Endzustand: der Betrag wird nie eingezogen und die Reservation faellt nach Ablauf ihrer Frist weg. Verlangt das Handle aus create_order.
| Parameter | Type | Description |
|---|---|---|
| order_handle * | string |
{
"name": "get_order_status",
"title": "Bestellstatus abfragen",
"description": "Zeigt den aktuellen Stand einer Bestellung. In dieser Demo ist \"reserviert\" (on-hold) der Endzustand: der Betrag wird nie eingezogen und die Reservation faellt nach Ablauf ihrer Frist weg. Verlangt das Handle aus create_order.",
"inputSchema": {
"type": "object",
"required": [
"order_handle"
],
"properties": {
"order_handle": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"status",
"is_paid"
],
"properties": {
"total": {
"type": "string"
},
"status": {
"type": "string"
},
"created": {
"type": [
"string",
"null"
]
},
"is_paid": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"failed_tx": {
"type": "string"
},
"order_handle": {
"type": "string"
},
"payment_failed": {
"type": "boolean",
"description": "Letzte Zahlung abgebrochen, Bestellung noch offen: erneut create_payment_link, keine neue Bestellung."
},
"cancelled_on_request": {
"type": "boolean"
},
"reservation_released": {
"type": "boolean"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Haelt die Anfrage offen, bis die Zahlung zu einer Bestellung eingetroffen ist, und meldet dann den Endstand. Eine Runde dauert rund 25 Sekunden; kommt in dieser Zeit nichts an, ist das KEIN Fehler, sondern das Zeichen, sofort die naechste Runde zu starten (hoechstens 5 hintereinander, mit hochgezaehltem attempt). Sinnvoll direkt nach create_payment_link, sobald die Zahlungsaufforderung im Gespraech steht. Grund: Der Chat erfaehrt von einer Zahlung nichts von selbst, und die Bestaetigungsseite von PostFinance fuehrt nicht hierher zurueck. Wer waehrend des Wartens bezahlt und dann in den Chat zurueckkehrt, findet die Bestaetigung bereits vor. Verlangt das Handle aus create_order.
| Parameter | Type | Description |
|---|---|---|
| attempt | integer | Die wievielte Warterunde das ist. Erste Runde 1, danach hochzaehlen. Das Werkzeug sagt selbst, wann Schluss ist. |
| max_seconds | integer | Wie lange eine Runde warten soll. Ohne Angabe 25 Sekunden — nicht erhoehen, der Webserver schneidet laengere Anfragen ab. |
| order_handle * | string |
{
"name": "wait_for_payment",
"title": "Auf den Zahlungseingang warten",
"description": "Haelt die Anfrage offen, bis die Zahlung zu einer Bestellung eingetroffen ist, und meldet dann den Endstand. Eine Runde dauert rund 25 Sekunden; kommt in dieser Zeit nichts an, ist das KEIN Fehler, sondern das Zeichen, sofort die naechste Runde zu starten (hoechstens 5 hintereinander, mit hochgezaehltem attempt). Sinnvoll direkt nach create_payment_link, sobald die Zahlungsaufforderung im Gespraech steht. Grund: Der Chat erfaehrt von einer Zahlung nichts von selbst, und die Bestaetigungsseite von PostFinance fuehrt nicht hierher zurueck. Wer waehrend des Wartens bezahlt und dann in den Chat zurueckkehrt, findet die Bestaetigung bereits vor. Verlangt das Handle aus create_order.",
"inputSchema": {
"type": "object",
"required": [
"order_handle"
],
"properties": {
"attempt": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "Die wievielte Warterunde das ist. Erste Runde 1, danach hochzaehlen. Das Werkzeug sagt selbst, wann Schluss ist."
},
"max_seconds": {
"type": "integer",
"maximum": 90,
"minimum": 5,
"description": "Wie lange eine Runde warten soll. Ohne Angabe 25 Sekunden — nicht erhoehen, der Webserver schneidet laengere Anfragen ab."
},
"order_handle": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"status",
"is_paid"
],
"properties": {
"total": {
"type": "string"
},
"status": {
"type": "string"
},
"attempt": {
"type": "integer"
},
"created": {
"type": [
"string",
"null"
]
},
"is_paid": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"is_final": {
"type": "boolean"
},
"timed_out": {
"type": "boolean"
},
"is_reserved": {
"type": "boolean"
},
"order_handle": {
"type": "string"
},
"attempts_left": {
"type": "integer"
},
"waited_seconds": {
"type": "integer"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Zeigt, mit welchem Kundenkonto dieser Agent verbunden ist und was er darf: Mandat, Hoechstbetraege, verbrauchtes Monatsbudget, freigegebene Kategorien, Art der Zahlungsfreigabe, Laufzeit. Aufrufen, wenn die Person fragt, was der Agent darf, oder bevor eine Bestellung an einer Grenze scheitern koennte. Mandat anlegen, aendern, widerrufen oder Verbindung trennen: https://elevai.ch/demos/woo-shop/wordpress/my-account/agenten/?von=chat
No parameters.
{
"name": "get_connection",
"title": "Verbindung und Mandat anzeigen",
"description": "Zeigt, mit welchem Kundenkonto dieser Agent verbunden ist und was er darf: Mandat, Hoechstbetraege, verbrauchtes Monatsbudget, freigegebene Kategorien, Art der Zahlungsfreigabe, Laufzeit. Aufrufen, wenn die Person fragt, was der Agent darf, oder bevor eine Bestellung an einer Grenze scheitern koennte. Mandat anlegen, aendern, widerrufen oder Verbindung trennen: https://elevai.ch/demos/woo-shop/wordpress/my-account/agenten/?von=chat",
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {
"account": {
"type": [
"object",
"null"
],
"description": "Das Kundenkonto im Shop, mit dem diese Verbindung zugelassen wurde."
},
"mandate": {
"type": [
"object",
"null"
]
},
"connected": {
"type": "boolean"
},
"manage_url": {
"type": "string"
}
}
}
}Katalog und Bestellablauf des Demoshops von elevai.ch. Der Agent ist per OAuth mit einem Kundenkonto verbunden; was er darf, steht im Mandat des Kunden (get_connection zeigt es). Mandat anlegen, aendern, widerrufen: https://elevai.ch/demos/woo-shop/wordpress/my-account/agenten/?von=chat Hinweis des Shops zur Zahlung: «Wird nur reserviert und nach drei Tagen automatisch storniert.» Bezahlt wird im Chat in der Zahlkarte (PostFinance Pay, TWINT, Kreditkarte) — biete nie einen «Zahlungslink» an. Vor der Bestellung: «Soll ich ihn bestellen?»; nach der Bestellung: «Soll ich die Zahlung vorbereiten?» — dann folgt die Zahlkarte.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| product_id | integer | Die id aus search_products (ein Artikel). Fuer mehrere Artikel: items. |
| accept_terms | boolean | Nur true, wenn der Mensch den Geschaeftsbedingungen ausdruecklich zugestimmt hat. Nie selbst setzen. |
| login_handle | string | Nur fuer den alten Anmeldeweg ohne OAuth (Werkzeug start_login, einem verbundenen Agenten gar nicht angeboten). Bist du per OAuth verbunden, lass dieses Feld weg — das Konto steht bereits fest. |
| terms_version | string | Die Fassung, der zugestimmt wurde — woertlich aus der Antwort dieses Werkzeugs. Ohne eine solche Antwort gibt es keine Fassung: dann das Werkzeug erst ohne accept_terms aufrufen. |
{
"name": "create_order",
"title": "Bestellung anlegen",
"description": "Legt im Demoshop von elevai.ch eine Bestellung an. Ein Aufruf mit product_id allein genuegt fuer den Anfang (mehrere Artikel: items, alle in EINER Bestellung): Das Werkzeug prueft selbst, was noch fehlt, und liefert die Geschaeftsbedingungen samt Fassung mit — Nachfragen nach Bedingungen, E-Mail, Namen oder Adresse erledigen sich damit meist von selbst. Fehlt die Zustimmung, steht das in der Antwort; ein zweiter Aufruf mit accept_terms: true und der terms_version aus dieser Antwort schliesst die Bestellung ab (die Fassung stammt immer aus der Antwort, nie aus einer Annahme). Ist der Agent mit einem Kundenkonto verbunden (OAuth), sind Person und Adresse bereits bekannt; liegt zusaetzlich ein Mandat vor, entfaellt die AGB-Rueckfrage ganz. Zurueck kommt ein order_handle fuer create_payment_link; wie es unter einem Mandat weitergeht, steht dort. Demoshop mit Grenzen: Einzelpreis bis 0.05 CHF, Bestellsumme bis 0.25 CHF. Was sonst gilt, steht in den Geschaeftsbedingungen — nicht in deiner Antwort wiederholen.",
"inputSchema": {
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "Nur mitgeben, wenn das Werkzeug in einer vorherigen Antwort ausdruecklich danach gefragt hat. Niemals erfinden, niemals einen Platzhalter wie \"?\" einsetzen, und nie von sich aus danach fragen. Entfaellt ganz, wenn der Agent mit einem Kundenkonto verbunden ist oder ein bestaetigtes login_handle mitgegeben wird."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id"
],
"properties": {
"quantity": {
"type": "integer",
"default": 1,
"maximum": 5,
"minimum": 1
},
"product_id": {
"type": "integer"
}
}
},
"maxItems": 5,
"minItems": 1,
"description": "Mehrere Artikel in EINER Bestellung: je {product_id, quantity}. Will die Person mehrere Artikel, gehoeren sie in einen Aufruf mit items — nicht in mehrere Bestellungen. Statt product_id/quantity, nicht zusaetzlich."
},
"country": {
"type": "string",
"description": "Zwei Buchstaben, ISO 3166-1, Vorgabe CH."
},
"quantity": {
"type": "integer",
"default": 1,
"maximum": 5,
"minimum": 1
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"product_id": {
"type": "integer",
"description": "Die id aus search_products (ein Artikel). Fuer mehrere Artikel: items."
},
"accept_terms": {
"type": "boolean",
"description": "Nur true, wenn der Mensch den Geschaeftsbedingungen ausdruecklich zugestimmt hat. Nie selbst setzen."
},
"login_handle": {
"type": "string",
"description": "Nur fuer den alten Anmeldeweg ohne OAuth (Werkzeug start_login, einem verbundenen Agenten gar nicht angeboten). Bist du per OAuth verbunden, lass dieses Feld weg — das Konto steht bereits fest."
},
"terms_version": {
"type": "string",
"description": "Die Fassung, der zugestimmt wurde — woertlich aus der Antwort dieses Werkzeugs. Ohne eine solche Antwort gibt es keine Fassung: dann das Werkzeug erst ohne accept_terms aufrufen."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"terms": {
"type": "object",
"description": "Wortlaut, Link und Fassung der Geschaeftsbedingungen."
},
"total": {
"type": "string"
},
"reason": {
"type": "string"
},
"status": {
"type": "string"
},
"is_demo": {
"type": "boolean"
},
"mandate": {
"type": "string"
},
"currency": {
"type": "string"
},
"order_handle": {
"type": "string",
"description": "Schluessel fuer create_payment_link und get_order_status, zwei Stunden gueltig. Fehlt, wenn noch etwas fehlt — siehe terms_required / email_required."
},
"email_required": {
"type": "boolean",
"description": "Es fehlt eine E-Mail-Adresse."
},
"terms_required": {
"type": "boolean",
"description": "Es fehlt die Zustimmung zu den Geschaeftsbedingungen. Frag die Person und rufe erneut auf."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}| Das Handle aus create_order. |
| request_approval | boolean | Nur aus der Zahlkarte. Stoesst die Freigabe in der PostFinance App an, ohne eine Seite zu oeffnen. Verlangt eine Bestellung, fuer die schon ein Zahllink erzeugt wurde. |
| confirmed_in_chat | boolean | Nur true, wenn die Person im Gespraech soeben ausdruecklich Ja gesagt hat auf deine Frage, ob jetzt bezahlt werden soll. Gilt nur unter einem Mandat mit Direktzahlung und nur zusammen mit no_card. Nie selbst setzen, nie annehmen, nie aus dem Zusammenhang erschliessen. |
{
"name": "create_payment_link",
"title": "Bezahlen im Chat",
"description": "Zeigt zu einer Bestellung die Zahlkarte im Chat: PostFinance Pay, TWINT und Kreditkarte, je mit der Art der Bestaetigung (Push, Ein Klick mit hinterlegtem Zahlungsmittel, TWINT App, 3-D Secure). Die Person waehlt und bezahlt dort selbst. Verlangt das Handle aus create_order; der Betrag stammt aus der Bestellung, nicht vom Aufrufer. Wortwahl: Sprich von «bezahlen» oder «der Zahlkarte», NIE von einem «Zahlungslink» oder «Zahllink» — der Link ist nur ein Rueckfall, falls keine Karte erscheint.",
"inputSchema": {
"type": "object",
"required": [
"order_handle"
],
"properties": {
"method": {
"enum": [
"pfpay",
"twint"
],
"type": "string",
"description": "Zahlart (Schluessel aus der Auswahl, die das Werkzeug ohne method liefert): pfpay = PostFinance Pay, twint = TWINT. Ohne Angabe liefert das Werkzeug die Zahlarten zur Auswahl zurueck, statt eine Zahlseite zu erzeugen. Alle ausser pfpay gehen ueber die Zahlseite mit Bestaetigung dort (TWINT App, 3-D Secure bzw. wie die Zahlart es verlangt)."
},
"stepup": {
"type": "boolean",
"description": "Nur true, wenn die Person die Zahlung lieber selbst in der PostFinance App bestaetigen will, statt im Gespraech zuzustimmen. Zusammen mit no_card: liefert den Link zur Zahlseite."
},
"confirm": {
"type": "string",
"description": "Nur von der Zahlkarte selbst gesetzt (Klick auf den Knopf). Nie vom Modell ausfuellen."
},
"no_card": {
"type": "boolean",
"description": "Nur true, wenn die Person sagt, dass KEINE Zahlkarte und kein Knopf angezeigt wird. Dann liefert das Werkzeug einen Link zur Zahlseite (Bestaetigung in der PostFinance App) — auch unter einem Mandat mit Direktzahlung. Sonst weglassen."
},
"unattended": {
"type": "boolean",
"description": "Nur true bei einer autonomen, geplanten Aufgabe, bei der KEIN Mensch im Gespraech ist. Dann bucht ein Mandat mit Direktzahlung ohne Klick. Ist eine Person im Chat, IMMER weglassen."
},
"order_handle": {
"type": "string",
"description": "Das Handle aus create_order."
},
"request_approval": {
"type": "boolean",
"description": "Nur aus der Zahlkarte. Stoesst die Freigabe in der PostFinance App an, ohne eine Seite zu oeffnen. Verlangt eine Bestellung, fuer die schon ein Zahllink erzeugt wurde."
},
"confirmed_in_chat": {
"type": "boolean",
"description": "Nur true, wenn die Person im Gespraech soeben ausdruecklich Ja gesagt hat auf deine Frage, ob jetzt bezahlt werden soll. Gilt nur unter einem Mandat mit Direktzahlung und nur zusammen mit no_card. Nie selbst setzen, nie annehmen, nie aus dem Zusammenhang erschliessen."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"note": {
"type": "string"
},
"paid": {
"type": "boolean"
},
"state": {
"type": "string"
},
"total": {
"type": "string"
},
"direct": {
"type": "boolean",
"description": "Mandat erlaubt die Zahlung ohne Bestaetigung in der App."
},
"method": {
"type": "string"
},
"stepup": {
"type": "boolean"
},
"is_paid": {
"type": "boolean"
},
"methods": {
"type": "array",
"items": {
"type": "object"
}
},
"currency": {
"type": "string"
},
"mandate_id": {
"type": "integer"
},
"order_line": {
"type": "string",
"description": "Was bestellt wurde, fuer die Karte."
},
"is_reserved": {
"type": "boolean"
},
"mandate_url": {
"type": "string"
},
"method_name": {
"type": "string"
},
"payment_url": {
"type": "string",
"description": "Link zur Zahlseite; erst in der Antwort MIT Zahlart enthalten"
},
"shipping_to": {
"type": "string"
},
"fallback_url": {
"type": "string"
},
"mandate_name": {
"type": "string"
},
"order_handle": {
"type": "string"
},
"method_locked": {
"type": "string",
"description": "Zahlart der schon angelegten Zahlung, wenn sich nicht umstellen liess."
},
"choice_required": {
"type": "boolean",
"description": "Die Karte zeigt den Knopf; gebucht wird erst beim Tippen."
},
"approval_requested": {
"type": "boolean",
"description": "Die Freigabe wurde an die PostFinance App geschickt."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}