Verkaufskanäle — API und MCP
Überblick
Dieser Bereich stellt 23 Operationen bereit. Jede davon ist zugleich ein MCP-Werkzeug.
Der Bereich hängt am Modul-Schalter module.channels. Ist das Modul aus, antworten diese Operationen mit 404.
Operationen
| Methode | Pfad | Zweck | Recht | Parameter |
|---|---|---|---|---|
GET | /api/v1/channels/channels | Liste der SalesChannel | channels.channel.view · channels.channel.manage | page, active, connectorType, channelKey, q |
POST | /api/v1/channels/channels | Creates a SalesChannel resource. — Legt einen Kanal an. Er entsteht INAKTIV — ein Kanal, der mit dem ersten POST scharf ist, geht in dem Moment gegen ein Fremdsystem, in dem jemand ihn halb fertig speichert. | channels.channel.manage | + Rumpf |
DELETE | /api/v1/channels/channels/{ulid} | Eine SalesChannel löschen | channels.channel.manage | ulid |
GET | /api/v1/channels/channels/{ulid} | Eine SalesChannel lesen | channels.channel.view · channels.channel.manage | ulid |
PATCH | /api/v1/channels/channels/{ulid} | Eine SalesChannel ändern | channels.channel.manage | ulid, + Rumpf |
POST | /api/v1/channels/channels/{ulid}/activate | Activate channel — Activate channel. Dedicated action endpoint — not a standard CRUD create. | channels.channel.manage | ulid, + Rumpf |
POST | /api/v1/channels/channels/{ulid}/checkouts | Warenkörbe des Kanals übernehmen — Übernimmt begonnene Warenkörbe (Checkouts) dieses Kanals (checkouts = einer oder eine Liste, höchstens 100) — der Weg für Shop-Webhooks wie Shopify checkouts/create und checkouts/update und eigene Zuordnungen über einen Connect-Flow (06:ENT-OWNER-RUNDE-1021-45). Felder je Warenkorb: externalId (Pflicht, Wiedererkennung je Kanal), email, phone, firstName, lastName, locale, currency, totalAmount (Cent), items ([{sku, title, qty, unitPriceAmount}] oder in Shop-Form quantity + price als Dezimalzahl), recoveryUrl, startedAt, updatedAt, completedAt (gesetzt = bestellt). Jede Meldung schreibt denselben Warenkorb fort. Ruht er eine Stunde mit Adresse und ohne Bestellung, meldet die Standard-Automation „Warenkorb verlassen". Antwort result: imported, updated, ordered, invalid. | channels.sync.execute | ulid, + Rumpf |
POST | /api/v1/channels/channels/{ulid}/deactivate | Deactivate channel — Deactivate channel. Dedicated action endpoint — not a standard CRUD create. | channels.channel.manage | ulid, + Rumpf |
POST | /api/v1/channels/channels/{ulid}/fulfillment | Sendung an den Kanal zurückmelden — Meldet eine Sendung samt Sendungsnummer an den Kanal zurück (Befund R47-015). Ziel ist entweder externalOrderId (Fremd-Kennung) oder orderUlid (eigener Auftrag); dazu carrier, trackingNumber, trackingUrl, shippedAt und optional lines für eine Teilsendung. Positions-Kennungen legt der Rahmen aus dem Bestell-Import bei — Marktplätze melden je POSITION. Ohne diese Meldung sieht der Käufer seine Bestellung nie als versandt und der Marktplatz zählt sie als verspätet. Der geplante Betrieb ruft GENAU DIESE Operation über den Baustein <gruppe>_fulfillment_push auf. | channels.sync.execute | ulid, + Rumpf |
POST | /api/v1/channels/channels/{ulid}/orders | Kanal-Bestellungen als Aufträge übernehmen — Übernimmt bereits zugeordnete Bestellungen dieses Kanals als Aufträge (orders = eine Bestellung oder eine Liste). Der Weg für Shop-Webhooks und eigene Zuordnungen: ein Connect-Flow ordnet die Felder des Fremdsystems zu und ruft diese Operation über octibiz_api auf. Idempotent über (Kanal, Fremd-Kennung) — eine doppelt gemeldete Bestellung wird übersprungen, nicht doppelt angelegt. | channels.sync.execute | ulid, + Rumpf |
POST | /api/v1/channels/channels/{ulid}/sync | Sync channel — Sync channel. Dedicated action endpoint — not a standard CRUD create. | channels.sync.execute | ulid, + Rumpf |
POST | /api/v1/channels/channels/{ulid}/test-connection | Kanal-Verbindung prüfen — Prüft die Verbindung, ohne etwas zu verändern. Antwort: valid + errors. | channels.channel.manage | ulid, + Rumpf |
GET | /api/v1/channels/checkouts | Warenkörbe der Kanäle — Begonnene Warenkörbe mit Adresse, Summe (Cent), Positionen, letzter Aktivität und Stand: offen, verlassen gemeldet (Auslöser der Warenkorb-Erinnerung) oder doch bestellt. Neueste Aktivität zuerst. | channels.checkout.view | page, status, channelUlid, q |
GET | /api/v1/channels/checkouts/{ulid} | Eine ChannelCheckout lesen | channels.checkout.view | ulid |
GET | /api/v1/channels/connector-types | Retrieves the collection of ChannelConnectorType resources. — Alle verfügbaren Kanal-Konnektoren mit Fähigkeiten und Konfigurationsfeldern. Konnektoren deaktivierter Plugins fehlen hier. | channels.channel.view · channels.channel.manage | — |
GET | /api/v1/channels/external-stock | Fremdbestand eines Kanals (FBA) ansehen | channels.channel.view · channels.channel.manage | page, channelUlid, sku, q, inStock |
GET | /api/v1/channels/listings | Retrieves the collection of ChannelListing resources. — Angebote je Kanal mit Status, letztem Abgleich und letztem Fehler. Mit productId und includeVariants=1 der Shop-Sync-Stand eines Artikels samt seiner Varianten (Reiter am Artikel). | channels.channel.view · channels.listing.manage | page, channelUlid, status, productId, includeVariants |
POST | /api/v1/channels/listings | Creates a ChannelListing resource. — Stellt einen Artikel in einen Kanal. overrides trägt NUR, was im Kanal anders ist — alles Ungesetzte kommt aus dem Artikel. Ein Artikel steht je Kanal genau einmal. | channels.listing.manage | + Rumpf |
DELETE | /api/v1/channels/listings/{ulid} | Eine ChannelListing löschen | channels.listing.manage | ulid |
GET | /api/v1/channels/listings/{ulid} | Eine ChannelListing lesen | channels.channel.view · channels.listing.manage | ulid |
PATCH | /api/v1/channels/listings/{ulid} | Eine ChannelListing ändern | channels.listing.manage | ulid, + Rumpf |
POST | /api/v1/channels/listings/{ulid}/republish | Angebot wieder in die Kanal-Läufe aufnehmen — Nimmt das Angebot wieder in die Läufe auf (Zustand draft) und verwirft den Fingerabdruck, damit der nächste Lauf es sicher sendet. | channels.listing.manage | ulid, + Rumpf |
POST | /api/v1/channels/listings/{ulid}/unpublish | Angebot im Kanal zurückziehen — Zieht das Angebot zurück: es wird von künftigen Läufen übersprungen. Der Eintrag bleibt stehen — ihn zu löschen nähme die Kennung im Fremdsystem mit, an der eingehende Bestellungen hängen. | channels.listing.manage | ulid, + Rumpf |
Zweckangaben, die nicht dem Standardmuster folgen, stammen unverändert aus der Schnittstellen-Beschreibung im Code.