# MCP-Tools > Alle Tools auf dem TradeCatalog MCP-Server, ihre Eingaben, wer sie verwenden kann und was sie zurückgeben. Tools verwenden Ihre aktuelle Arbeitsbereichsrolle bei jedem Aufruf. Lesen-only-Verbindungen funktionieren weiterhin. Änderungen erfordern den zusätzlichen `tradecatalog:write`-Bereich. Konsequente Aktionen zeigen in kompatiblen Clients eine Confirm/Cancel-Karte an, mit einem angemeldeten Überprüfungslink als Fallback, und werden erst nach Ihrer Zustimmung ausgeführt. Die Ergebnisse sind JSON-Text; das ursprüngliche Suchwerkzeug formatiert Preise, während Verwaltungstools ganze Zahlen in Währungseinheiten und Basispunkte (100 = 1%) verwenden. Die meisten Tools benötigen `workspace`: die Arbeitsbereichsadresse aus `list_workspaces`, wie `northgate`. Die KI-App ruft normalerweise `list_workspaces` zuerst selbst auf. Wenn ein Tool etwas nicht tun kann, z. B. Sie nicht Mitarbeiter dieses Arbeitsbereichs sind oder der Kunde nicht existiert, gibt es eine Fehlermeldung, die die KI-App lesen und darauf reagieren kann, z. B. „Kein Kunde „OAK99“. Verwenden Sie list_customers für Kontocodes.“ Wenn ein Lieferant sein Katalog nur für den ausgewählten Kunden preiselt, geben `set_basket_quantity`, `send_order` und `reorder` diesen Fehler zurück. `get_basket`, `list_buyer_orders` und `get_buyer_order` funktionieren weiter, sodass bestehende Bestellungen weiterhin lesbar sind. Der Lieferant legt dies in den Einstellungen fest und kann es pro Kunden überschreiben (`ordering`: `follow`, `prices_only` oder `can_order` auf `update_customer`). Wenn der Lieferant das Herunterladen von Preislisten deaktiviert hat, gibt `download_my_price_list` einen Fehler zurück und der angemeldete CSV-Link antwortet mit 403. `quote_configured_product` liest die Zeilenpreise des ausgewählten Käuferkontos für `productId`, `qty` und optionale `configuration`, ohne den Warenkorb zu ändern. `set_configured_basket_line` erstellt eine separate Zeile oder aktualisiert/entfernt ihre genaue `lineId` (`qty: 0` entfernt). Geben Sie die vollständige Spezifikation bei Änderungen an. Lesen Sie `get_basket` erneut nach Änderungen und überprüfen Sie alle Auswahl, Maße und aktuellen Preise, bevor Sie `send_order` durchführen. Eine Änderung der Spezifikation oder Preismodellversion macht die alte Überprüfung ungültig, auch wenn der Gesamtbetrag unverändert bleibt. Mitarbeiter können `save_product_family` für gemeinsame Varianten-Metadaten und `save_ordering_draft` für einen überprüften fortgeschrittenen Preisentwurf verwenden. Letzteres erfordert Pro und globale Preisberechtigung; die Veröffentlichung verwendet die vorhandene Preisänderungsüberprüfung. Produktimporte akzeptieren optionale Familien, Bestellinkremente und Bestelldefinitionen. Siehe [Trade Catalog Setup](/docs/guides/trade-catalogues). ## Einlieferer-Arbeitsbereich einrichten `create_workspace` erstellt einen Free-Lieferant-Workspace für die angemeldete, verifizierte Person, nachdem sie eine Karte bestätigt hat. Fordern Sie den Geschäftsnamen, Währung der Produkte, Zeitzone und Land an. Die Person wird zum Eigentümer. Es wird keine Abonnement- oder Zahlungserstellung durchgeführt. Rufen Sie dann `list_workspaces` erneut auf und verwenden Sie die zurückgegebene Adresse für die Produkt- und Kundeneinrichtung. Reviewer- und Gast-Logins können keine Workspaces erstellen. Free umfasst bis zu 100 Produkte und verbundene KI-Apps. Jede SKU zählt, einschließlich versteckter und inaktiver Produkte. Bei Erreichen der Quote funktionieren bestehende Produkte, Bearbeitungen und Bestellungen weiter; das Erstellen weiterer Produkte ist nicht möglich. Erklären Sie diese Berechtigung, ohne Upgrades zu fördern oder den Abonnements-Checkout im Plugin zu starten. ## list_workspaces Lieferer-Arbeitsbereiche, in denen Sie arbeiten, und Handelsportale, in denen Sie einkaufen. Beginnen Sie hier. **Wer:** Jeder angemeldete Nutzer. **Eingaben:** Keine. ```json { "supplierWorkspaces": [ { "workspace": "northgate", "name": "Northgate Fixings", "role": "owner" } ], "tradePortals": [ { "workspace": "hartley-timber", "supplier": "Hartley Timber", "yourAccount": "Northgate Fixings", "accountId": "example-account-id" } ] } ``` ## search_products Suche eines Katalogs nach SKU, Herstellerreferenz, Namen, Marke oder Kategorie. Gibt bis zu **25** Produkte zurück. **Wer:** Mitarbeiter und Käufer. | Eingabe | Typ | Erforderlich | Beschreibung | | ----------- | ------------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `workspace` | Zeichenkette | Ja | Workspace-Adresse. | | `query` | Zeichenkette | Ja | Was gesucht werden soll. Leere Liste Produkte nach Namen. | | `accountId` | Zeichenkette | Käufer mit mehr als einem Konto | Wählen Sie Ihr exaktes Konto aus `list_workspaces`. | | `customer` | Zeichenkette | Nein | Nur für Mitarbeiter: ein Kundenkontocode oder Name, um ihre Preise und nur das zu sehen, was sie sehen können. Ignoriert für Käufer. | - **Käufer** sehen immer die Preise ihres eigenen Kontos und nur aktive Produkte, die sie sehen können. - **Mitarbeiter** sehen Listenpreise und jedes Produkt oder die Ansicht eines benannten Kunden. ```json { "supplier": "Northgate Fixings", "pricesFor": "Oakfield Joinery", "taxNote": "ex VAT", "products": [ { "sku": "HX-8510", "name": "Hex bolt M10 x 50 zinc", "unit": "Box of 100", "availability": "in_stock", "price": "£15.73", "listPrice": "£18.50", "why": "Brand discount −15%" } ] } ``` Wenn der Lieferant **Kunden den Standardpreis neben ihrem eigenen Preis anzeigen** deaktiviert hat, werden die Ergebnisse eines Käufers `listPrice` und `why` auslassen und `get_buyer_product`, `get_basket` und `get_buyer_order` tragen auch keinen Listenpreis oder Preisgrund nicht mit. Versuchen Sie: „Suche Northgate nach M10 Hexbolzen zu Oakfields Preisen.“ ## download_products_csv und download_my_price_list Diese Tools geben einen Link zu einem vorhandenen CSV-Download in TradeCatalog zurück. Öffnen Sie es, während Sie angemeldet sind; das Zurückgeben eines Links lädt die Datei nicht herunter oder sendet sie in den Chat. - `download_products_csv`: Mitarbeiter wählen `workspace`, um die Produktliste dieses Lieferanten herunterzuladen. - `download_my_price_list`: Käufer wählen `workspace` und den exakten `accountId` aus `list_workspaces`, um nur die vereinbarten Preise dieses Kontos herunterzuladen. - `download_my_price_list_pdf`: dasselbe Konto, als brandgefertigtes PDF (Pro). Beide Tools sind blockiert, wenn der Lieferant das Herunterladen von Preislisten deaktiviert hat. ## check_price Was ein Kunde für eine SKU bei einer Menge zahlt und welches Regelset den Preis festgelegt hat. **Wer:** Nur Mitarbeiter. | Eingabe | Typ | Erforderlich | Beschreibung | | ----------- | ------------ | ------------ | ---------------------------- | | `workspace` | Zeichenkette | Ja | Workspace-Adresse. | | `customer` | Zeichenkette | Ja | Kontocode oder Name. | | `sku` | Zeichenkette | Ja | SKU. | | `qty` | Ganzzahl | Nein | 1 bis 1.000.000. Standard 1. | ```json { "customer": "Oakfield Joinery", "sku": "HX-8510", "name": "Hex bolt M10 x 50 zinc", "qty": 20, "unitPrice": "£15.73", "lineTotal": "£314.60", "listPrice": "£18.50", "why": "Brand discount −15%", "taxNote": "ex VAT" } ``` Versuchen Sie: „Wie viel zahlt OAK01 für 20 Stück von HX-8510 und warum?“ ## list_customers Handelskunden mit Kontocodes, Kontaktemails, aktiven Status und Rabatt für Konten. **Wer:** nur Mitarbeiter. **Eingaben:** `workspace`. ```json [ { "accountCode": "OAK01", "name": "Oakfield Joinery", "email": "accounts@oakfieldjoinery.co.uk", "active": true, "discount": "5%" } ] ``` Versuchen Sie: „Welche Kunden haben keinen Rabatt festgelegt?“ ## list_orders Kürzliche Bestellungen, am neuesten zuerst, bis zu **50**. **Wer:** Mitarbeiter können die Bestellungen jedes Kunden sehen; Käufer sehen nur die ihres Kontos. | Eingabe | Typ | Erforderlich | Beschreibung | | ----------- | ------------ | ------------ | ------------------------------------------------------------------------------------------ | | `workspace` | Zeichenkette | Ja | Workspace-Adresse. | | `status` | Zeichenkette | Nein | `new`, `pending`, `acknowledged`, `processed`, `dispatched`, `completed` oder `cancelled`. | ```json [ { "reference": "SO-000142", "customer": "Oakfield Joinery", "status": "new", "total": "£314.60", "poNumber": "PO-88231", "placed": "2026-09-27T07:48:12.000Z" } ] ``` Versuchen Sie: „Gibt es neue Bestellungen seit gestern? Summieren Sie sie nach Kunden.“ ## recent_activity Der Aktivitätsprotokoll der Änderungen an Kunden, Rabatten und Preisen, am neuesten zuerst, bis zu **50** Einträge. Optional die Geschichte eines Kunden. **Wer:** Nur Mitarbeiter. Eigentümer und Administratoren sehen das gesamte Protokoll; andere Mitarbeiter sehen nur Änderungen zu Kunden, die sie sehen können. | Eingabe | Typ | Erforderlich | Beschreibung | | ----------- | ------------ | ------------ | -------------------- | | `workspace` | Zeichenkette | Ja | Workspace-Adresse. | | `customer` | Zeichenkette | Nein | Kontocode oder Name. | ```json [ { "when": "2026-09-26T14:21:03.000Z", "who": "Jo Hartley", "customer": "Oakfield Joinery", "what": "Set Northgate brand discount to 15% (was 12.5%)" } ] ``` Versuchen Sie: „Wer hat in diesem Monat die Preise von Oakfield geändert?“ ## Hinweise - Kundennamen und Kontocodes werden ohne Berücksichtigung der Groß-/Kleinschreibung abgeglichen. Ein exakter Kontocode ist am sichersten. - `list_workspaces` gibt Werte für `accountId` des Käufers zurück. Geben Sie das beabsichtigte an `search_products` und jede Käuferaktion an. Vermutungen zwischen Konten vermeiden. - Seitenprodukt-Suchen mit `offset` und dem zurückgegebenen `nextOffset`. Nutzen Sie `list_buyer_orders` für ein explizit ausgewähltes Käuferkonto. ## Änderungen und Bestätigungen Käufer-Warenkorb-Änderungen, Markierung von Updates als gelesen und Erstellung von nicht veröffentlichten Preisentwürfen werden sofort nach Autorisierung ausgeführt. Andere Schreibvorgänge geben `awaiting_confirmation`, ein `actionId` und ein `reviewUrl` zurück. ChatGPT und kompatible Clients zeigen eine Karte mit der exakten Workspace-Adresse und dem vorgeschlagenen Änderung an: wählen Sie **Bestätigen** oder **Abbrechen**, ohne den Chat zu verlassen. Clients ohne Karten verwenden den angemeldeten Überprüfungslink. Überprüfungen verfallen nach 15 Minuten und werden maximal einmal ausgeführt. Das Trennen der App oder das Entfernen der erforderlichen Workspace-Zugriffsrechte macht ausstehende Überprüfungen ungültig. Geänderte Bestellwagen und Preisänderungs-Vorschau erfordern eine neue Überprüfung. Nutzen Sie `get_action_status`, um das Ergebnis zu lesen; ein ausstehender Antrag ist kein abgeschlossener Vorgang. Der `decide_action`-Hilfsprogramm ist nur für die Karten-UI verfügbar. Seine kurzlebige Bestätigungs-Fähigkeit ist für Modell-Ausgaben versteckt und an die anfragende Person, OAuth-Verbindung und Vorschlag gebunden. Ein Modell-Nachricht oder eine Aktion-ID kann keine Änderung genehmigen. Die gleichen Rollen, Snapshots, Ablauf und Einzelverwendung-Überprüfungen gelten für Karten- und Browser-Überprüfungen. Jede Käuferaktion erfordert Ihre genaue `accountId`. Für `send_order` kopieren Sie den Warenkorb `fingerprint` in `expectedBasket`, zusammen mit `expectedTotal`. Preise, Mengen und Konto werden erneut überprüft, bevor sie gesendet werden. Verwenden Sie die separaten Übertragungstools für Arbeit, die im angemeldeten App abgeschlossen wird: Eigentümer verwenden `open_api_key_settings`, `download_workspace_export` und `open_logo_settings`; Mitarbeiter verwenden `open_import_page`, `open_product_image_upload` und `open_product_file_manager`. Die beiden Produktübertragungen erfordern eine von einem Mieter überprüfte `productId`. Dateilinks aus `get_product` und `get_buyer_product` erfordern Ihren angemeldeten Browser; das Zurückgeben eines Links hat nicht die Dokumente gelesen oder eine Upload, Entfernung, Export oder Zertifikaterstellung abgeschlossen. Die Plattformverwaltung wird niemals über OAuth delegiert. ## Genehmigte Kundelisten Mitarbeiter verwenden `get_customer`, um den Katalogumfang und die genehmigten Produkte des Kunden zu lesen. `set_catalogue_scope` wechselt zwischen `all` und `approved`. `approve_products` fügt explizite Produkte oder eine Kategorie hinzu; `unapprove_product` entfernt ein Produkt. Diese Änderungen erfordern die Überprüfung des genauen Kunden, der aktuellen Liste und der betroffenen Produkte. Die Kategoriememberschaft wird bei der Bestätigung erneut überprüft. Käufer bleiben auf ihr ausgewähltes Konto und die für dieses Konto sichtbaren Produkte beschränkt. ## Lieferant- und Käufer-Tools `create_workspace` ist auch dann verfügbar, wenn `list_workspaces` leer ist. Es erstellt einen Free-Lieferantenspace und eine Eigentümermitgliedschaft erst nach Bestätigung. Die optionale `/mcp/account`-Verbindung bietet auch `open_billing`: Eigentümer können sich sichere Abonnementsgebühren öffnen und die Zahlung in Stripe bestätigen, dann `get_settings` überprüfen, um den resultierenden Status zu prüfen. Gebührenlinks vollenden keine Zahlungen. Die Standard-Verbindung `/mcp`, die vom ChatGPT-Plugin verwendet wird, gibt `open_billing` nicht preis. Siehe [Anmeldung und Abrechnung](/docs/mcp#sign-up-and-pay-with-an-agent). MCP 3.0.0 macht jede modellaufrufbare Operation vorab mit ihrem eigenen Namen, ihrer Beschreibung, ihrem Eingabeschema und Annotationen sichtbar. Die vorherigen Tools `bulk_products` und `open_workspace_action` werden durch die unten stehenden Einzelvorgänge ersetzt; aktualisieren Sie nach dem Update die Tool-Definitionen Ihres Clients. Die MCP `tools/list`-Antwort ist das autoritative Eingabeschema. Die folgenden Tools ergänzen die oben genannten Suchwerkzeuge: | Tool | Zweck | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `open_api_key_settings` | Nur für den Besitzer: gibt die angemeldete API-Einstellungen-Seite zurück, um Anmeldezeichen zu erstellen. Das Öffnen des Links erstellt keinen Schlüssel. Fragen Sie Benutzer niemals an, Geheimnisse in den Chat einzufügen. | | `download_workspace_export` | Nur für den Besitzer: gibt den angemeldeten vollständigen Arbeitsbereichs-Export-Link zurück. Der Benutzer muss den Link öffnen, um ihn herunterzuladen; dieses Tool liest oder überträgt den Export nicht. | | `open_logo_settings` | Nur für den Besitzer: gibt die angemeldete Marken-Einstellungen-Seite zurück, um ein Lieferantensymbol hochzuladen. Das Öffnen des Links lädt nicht und ändert nicht das Symbol. | | `open_import_page` | Mitarbeiter: geben Sie die angemeldete Datei-Import-Seite zurück. Der Benutzer lädt die Datei in TradeCatalog hoch und überprüft sie; das Öffnen des Links importiert nichts. | | `open_product_image_upload` | Mitarbeiter: geben Sie den angemeldeten Editor für ein vorhandenes Produkt zurück, um ein Bild hochzuladen. Das Öffnen des Links lädt oder ändert kein Bild. | | `open_product_file_manager` | Mitarbeiter: geben Sie den angemeldeten Editor für ein vorhandenes Produkt zurück, um Produktdateien hochzuladen oder zu entfernen. Das Öffnen des Links liest, lädt oder entfernt keine Dateien. | | `delete_workspace` | Nur Eigentümer: löschen Sie diesen Arbeitsbereich dauerhaft, seine Kataloge, Kundenzugriff und Bilder sowie kündigen Sie seine Abonnement. Erfordert eine angemeldete Überprüfung und die Eingabe des Arbeitsbereichsnamens. Dies kann in der App nicht rückgängig gemacht werden. | | `get_workspace` | Mitarbeiter: aktuelle Rolle, Katalog und Bestellsummen. Beträge sind Ganzzahlen in Währungseinheiten; Prozentsätze sind Basispunkte (100 = 1 %). | | `get_catalogue_options` | Mitarbeiter: Listen Sie Kategorie- und Marken-IDs für Katalog- und Rabattänderungen auf. | | `get_product` | Personal: Produktfelder, aktueller Listenpreis, Sichtbarkeit, Kundenbeschränkungen, Bilder und angehängte Dateien (Spezifikationsblätter). | | `save_product` | Erstellen oder bearbeiten Sie ein Produkt. Lesen Sie zuerst das aktuelle Produkt und bewahren Sie die Felder, die der Benutzer nicht geändert haben. listPrice ist in Kleinwährung; Änderungen des vorhandenen Preises verwenden den App-Preisänderungsfluss. Erfordert Überprüfung. | | `set_product_image` | Wählen Sie das Hauptbild aus oder entfernen Sie es. Das Entfernen entfernt dieses Bild aus der Galerie und das nächste Bild wird zum Hauptbild. Erfordert Überprüfung. | | `create_category` | Erstellen Sie eine benannte Kategorie, optional unter einer übergeordneten Kategorie. Erfordert Überprüfung. | | `update_category` | Benennen Sie eine Kategorie um oder verschieben Sie sie. Ihre Produkte bleiben darin. Erfordert Überprüfung. | | `delete_category` | Kategorie und deren Kategorierabattregeln entfernen. Produkte und untergeordnete Kategorien werden um eine Ebene nach oben verschoben. Erfordert eine Überprüfung. | | `hide_products` | Mitarbeiter: Explizite Produkt-IDs vor Käufern verbergen, ohne sie zu löschen. Erfordert eine Überprüfung. | | `show_products` | Mitarbeiter: Explizite Produkt-IDs aktivieren. Kundenkatalogbeschränkungen gelten weiterhin. Erfordert eine Überprüfung. | | `move_products` | Mitarbeiter: Explizite Produkt-IDs in eine Kategorie verschieben oder null übergeben, um deren Kategorie zu entfernen. Erfordert eine Überprüfung. | | `delete_products` | Mitarbeiter: Explizite Produkt-IDs dauerhaft löschen, einschließlich ihrer Preise, Bilder und Warenkorbzeilen. Historische Bestellungen behalten ihre Kopien. Erfordert eine Überprüfung. | | `clear_catalogue` | Nur der Eigentümer: Entfernen Sie dauerhaft jedes Produkt, Preis und Foto. Erfordert eine angemeldete Überprüfung und das Eintippen des aktuellen Löschphrases. | | `get_customer` | Mitarbeiter: Kundenbedingungen, Preisliste, Katalogumfang, genehmigte Produkte, Rabattregeln, vereinbarte Preise, Käufer und ausstehende Einladungen. `priceLists` sind die Listen, die Sie mit `update_customer` zuweisen können. Das Zuweisen einer anderen nicht-Standard-Preisliste erfordert Pro. | | `create_customer` | Erstellen Sie ein Handelskonto. Die Kontaktemailadresse kann sich als dieses Konto anmelden, daher bestätigen Sie die Adresse. Erfordert eine Überprüfung. | | `update_customer` | Ändern Sie Kundendetails, Kontocode (`accountCode`; eindeutig pro Lieferant, Großschreibung wird ignoriert, lassen Sie es leer, um beizubehalten), Kontaktemail-Login, zusätzliche Aktualisierungsemails (`notifyEmails`), aktiver Status, den gesamten Listenprozentsatz (`discountBp`, 0 bis 10.000) und seine `adjustment` (`discount` oder `markup`; lassen Sie es leer, um beizubehalten), Bestellreihenfolge (`follow`, `prices_only` oder `can_order`) und `priceListId` (null ist Standard). Basispunkte: 100 = 1 %. Lesen Sie zuerst get_customer. Erfordert eine Überprüfung. Das Zuweisen einer anderen nicht-Standard-Preisliste erfordert Pro. | | `save_discount_rule` | Legen Sie eine Kundengruppe, Marke oder Produktprozentsatz fest, in Basispunkten (0 bis 10.000). `adjustment` ist `discount` oder `markup`; lassen Sie es leer, um einen Rabatt zu erstellen. Die spezifischste Regel gewinnt und nichts stapelt. Änderungen wirken sich sofort aus. Erfordert eine Überprüfung. Erfordert Pro. | | `remove_discount_rule` | Entfernen Sie die ausgewählte Kundenrabattregel. Preise können sofort steigen. Erfordert eine Überprüfung. | | `set_fixed_price` | Legen Sie einen kundenspezifischen Produktpreis in ganzen Einheiten der Währung fest. Optional `note` ist eine Bemerkung; `noteVisible` zeigt sie dem Kunden an. `internalNote` bleibt intern. Erfordert Überprüfung. Erfordert Pro. | | `end_fixed_price` | Beenden Sie einen festen Kundentarif, damit normale Rabattregeln gelten. Erfordert Überprüfung. | | `list_staff` | Mitarbeiter: Listen Sie das Arbeitsbereichsteam und ausstehende Einladungen auf. | | `invite_staff` | Nur Eigentümer: E-Mail-Einladung, um Mitarbeiter- oder Eigentümerzugriff zu gewähren. Erfordert Überprüfung des Empfängers und der Rolle. | | `invite_buyer` | Mitarbeiter: E-Mail-Einladung an ein bestimmtes Kundenkonto. Erfordert Überprüfung des Empfängers und des Kontos. | | `remove_buyer` | Entfernen Sie eine Mitgliedschaft aus dem benannten Kundenkonto. Erfordert eine Überprüfung. | | `preview_product_import` | Zeigen Sie die analysierten Zeilen an, ohne sie zu importieren. Reparieren Sie unsichere Quellpreise nicht still. | | `import_products` | Importieren Sie maximal 100 analysierte Zeilen. listPrice geht in priceList (Standard auslassen); listPrices benennen andere Listen. Änderungen jeder Liste werden in einen Entwurf zusammengefasst. Erfordert eine Überprüfung. Bild-URLs können abgerufen werden. | | `import_customers` | Importieren Sie maximal 100 Kunden. Optionale priceList benennen ihre Liste; Anpassung ist Rabatt oder Aufschlag. Ein unbekannter Listenname ist ein Fehler. Erfordert eine Überprüfung. | | `preview_agreed_prices` | Zeigen Sie bis zu 2.000 vereinbarte Preise (Kontonummer, SKU, ganze Minor-Einheitspreis und ein optionaler Hinweis) ohne Speicherung an. Nur für Pro. Unbekannte Konten und SKUs werden gemeldet und übersprungen. Wenn ein Konto und eine SKU wiederholt werden, wird die letzte Zeile verwendet. | | `import_agreed_prices` | Speichern Sie bis zu 2.000 vereinbarte Preise für bestehende Konten und SKUs. Nur für Pro. Jeder Preis wird ab jetzt in Batches von 100 versioniert. Unbekannte Zeilen werden übersprungen. Erfordert eine Überprüfung. | | `list_import_layouts` | Zeigen Sie die gespeicherten Spaltenzuordnungen dieses Lieferanten an. | | `save_import_layout` | Speichern Sie eine wiederverwendbare Spaltenzuordnung für diesen Lieferanten. Erfordert eine Überprüfung. | | `list_price_changes` | Zeigen Sie Entwürfe sowie geplante oder veröffentlichte Preisanpassungen an. | | `draft_price_change` | Erstellen Sie einen Entwurf einer prozentualen Preisanpassung für eine Preisliste (`priceListId`; für Standard weglassen). Eine Batch enthält nie mehrere Listen. Signierte Basispunkte: 600 = +6 %, von −90 % bis +100 %. Veröffentlicht oder sendet keine E-Mails an Kunden. Erfordert Pro. | | `preview_price_change` | Lesen Sie den Einfluss, Warnungen, feste Preise und Konflikte bei der Terminplanung vor der Veröffentlichung. | | `publish_price_change` | Veröffentlichen Sie jetzt oder zu einem ISO-Timestamp, optional per E-Mail an Kunden (bei Veröffentlichung oder bei einem geplanten `notifyAt`) und Ändern Sie vereinbarte Preise. Erfordert eine Überprüfung des aktuellen Vorschaubilds; geänderte Vorschauen heben die Genehmigung auf. Pro ist erforderlich, außer bei sofortigen Standard-Preis-Imports ohne E-Mails oder vereinbarte Preisanpassungen. | | `cancel_price_change` | Einen geplanten Preisanpassung rückgängig machen. Kunden können per E-Mail über die Stornierung informiert werden. Erfordert eine Überprüfung. | | `discard_price_draft` | Eine nicht veröffentlichte Preisanpassung endgültig löschen. Erfordert eine Überprüfung. | | `get_staff_order` | Mitarbeiter: Bestellzeilen, Kunde, Notizen und Statusverlauf. | | `set_order_status` | Eine Bestellung mit der App erlaubten Übergängen annehmen, verarbeiten, abschließen oder stornieren. Kann den Käufer per E-Mail informieren. Erfordert eine Überprüfung. | | `get_settings` | Lieferanteneinstellungen und Abonnementsstatus lesen; keine Zahlungskennungen werden zurückgegeben. | | `save_settings` | Nur für den Eigentümer: Geschäftsdaten, Bestellempfänger, Währung, Verzeichnisliste, Suchpräferenzen, ob Kunden den Standardpreis neben ihrem eigenen sehen (`showStandardPrice`; `false` zeigt nur ihren eigenen Preis an), wie Produkte für Kunden bestellt werden (`productOrder`: `name`, `sku`, `category` oder `custom`; `category` folgt der Reihenfolge der Kategorien-Seite, A bis Z nach Namen innerhalb jeder Kategorie, unkategorisierte letzte), welche Katalogspalten sie sehen und in welcher Reihenfolge (`catalogueColumns`), der Titel für die Handelsvereinbarungsnotiz jedes Produkts (`dealLabel`), ob die markenbezogene Kundenanmeldung den Mitarbeiteranmelde-Link versteckt (`hidePortalStaffLink`; Eigentümer oder Administrator, Standardwert false), ob die Untertitel der Mitarbeiterseite und How-to-Links versteckt werden (`hideStaffGuides`; nur Eigentümer oder Administrator, Standardwert false), ob die Anmeldeseite mit Benutzername und Passwort öffnet (`loginUsernameFirst`; nur Eigentümer oder Administrator, Standardwert false, sodass E-Mail weiterhin zuerst ist), und welche Teile des markenbezogenen PDF-Preislisten zu drucken (`pdfShowLogo`, `pdfShowDate`, `pdfShowSupplierName`, `pdfShowCustomerName`, `pdfShowPageNumbers`; jeder ist standardmäßig true, false versteckt diesen Teil). Zuerst die aktuellen Einstellungen lesen. Erfordert eine Überprüfung. | | `list_api_keys` | Nur für den Eigentümer: Liste der Schlüsselbezeichnungen und Bereiche auflisten. Gibt niemals Geheimnisse zurück. | | `revoke_api_key` | Nur für den Eigentümer: API-Integration sofort trennen. Erfordert eine Überprüfung. | | `list_news` | Mitarbeiter: Ankündigungen auflisten, einschließlich abgelaufener Beiträge. | | `post_news` | Eine Ankündigung an Käufer veröffentlichen, jetzt oder ab `startsLocal` (Lieferantenzugriff). Optionales `endsOn` versteckt sie ab `YYYY-MM-DDTHH:mm` in der Lieferantenzeitzon, oder am Ende eines `YYYY-MM-DD`. emailCustomers sendet auch Abonnenten, wenn es beginnt. Erfordert die Überprüfung der genauen Nachricht und Zielgruppe. | | `remove_news` | Eine veröffentlichte Ankündigung entfernen. Gesendete E-Mails können nicht zurückgerufen werden. Erfordert eine Überprüfung. | | `list_support_tickets` | Nur Eigentümer und Admin: Liste dieser Arbeitsbereichs Support-Tickets. | | `get_support_ticket` | Nur Eigentümer und Admin: Nachrichten eines Tickets dieses Arbeitsbereichs lesen. | | `open_support_ticket` | Nur Eigentümer und Admin: Stellen Sie eine Supportanfrage an Happy Webs. Erfordert die Überprüfung der genauen Nachricht. | | `reply_to_support` | Nur Eigentümer und Admin: Antworten Sie auf eine bestehende Support-Konversation. Erfordert Überprüfung. | | `get_buyer_product` | Lesen Sie ein sichtbares Produkt mit Preisen und angehängten Dateien (Spezifikationsblätter) für das explizit ausgewählte Konto. | | `get_basket` | Lesen Sie aktuelle Mengen und Preise für Ihr explizit ausgewähltes Kundenkonto. | | `set_basket_quantity` | Legen Sie eine absolute Menge fest (0 entfernt die Zeile). Ändert nur Ihren Warenkorb; sendet keinen Auftrag. | | `send_order` | Senden Sie den Warenkorb des ausgewählten Kontos an den Lieferanten mit Kopie der Käufer-E-Mail. Erfordert angemeldete Überprüfung der exakten Produkte, Mengen, Preise, PO und Hinweise. Wenn der Warenkorb geändert wird, fordern Sie eine neue Überprüfung an. Kopieren Sie expectedBasket aus get_basket.fingerprint. | | `list_buyer_orders` | Lesen Sie Aufträge für das explizit ausgewählte Konto. | | `get_buyer_order` | Lesen Sie Zeilen und Statusverlauf für einen Auftrag des ausgewählten Kontos. | | `reorder` | Fügen Sie verfügbare Produkte aus einem früheren Auftrag zu Ihrem Warenkorb zu aktuellen Preisen hinzu. Sendet keinen Auftrag. Erfordert eine Überprüfung. | | `get_buyer_updates` | Lesen Sie aktuelle Nachrichten, Ihre Preisänderungen und ungelesene Updates für das ausgewählte Kundenkonto. | | `mark_updates_read` | Markieren Sie die aktuell verfügbaren Updates des ausgewählten Kontos als gelesen. | | `get_action_status` | Lesen Sie das Ergebnis einer von dieser Verbindung angeforderten Überprüfung. | Mitarbeiterbestellungen verwenden `preview_customer_order`, dann werden `create_customer_order` überprüft, mit exakten Preisen und einem Wiederholungs-UUID. Die Verarbeitung verwendet `set_order_status` mit öffentlichen `note`, privaten `internalNote`/`correctionReason` und `expectedRevision`. Überprüfte `set_order_delivery` protokollieren eine für den Kunden sichtbare Versandmethode und optionalen Kurier, Referenz und HTTPS-Link. Diese Tools folgen den aktuellen Berechtigungen und dem Kundenbereich des Mitglieds. Siehe [Bestellungen](/docs/api/orders) für die Felder und das Verhalten.