Zum Inhalt springen

API

Für Entwickler

Die öffentliche Itemoo-API für ERP, Lager und Produktion sowie Produktdaten für Agenten und Scanner. Die Doku entsteht aus dem Code der API selbst.

Der erste Aufruf in drei Minuten

  1. Öffnen Sie im Itemoo-Panel Integrationen → API-Schlüssel und erstellen Sie einen Schlüssel mit den nötigen Berechtigungen. Sie sehen ihn nur einmal.

  2. Verbindung prüfen: GET /v1/ping mit dem Header Authorization: Bearer itm_…

  3. Bestände senden oder Bestellungen abrufen — zu jedem Endpunkt unten gibt es ein Beispiel. Bestellbenachrichtigungen richten Sie an derselben Stelle im Panel ein.

Schlüssel im Panel erstellen →

cURL

curl 'https://itemoo.eu/v1/ping' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

MCP-Server für KI-Assistenten

Mit dem Model Context Protocol nutzen KI-Assistenten (Claude, ChatGPT und andere) Itemoo ohne eigene Integration: Der Assistent erkennt die Werkzeuge und ihre Parameter selbst.

Globaler MCP — Produkte und Einkauf

Suche nach Produkten, Marken, Unternehmen, Händlern und Artikeln, Produktdaten mit der Quelle jeder Angabe, Rückrufe, Dokumente und ein Warenkorb mit Link zur Kasse. Ohne Anmeldung. Die Suche umfasst Marken, die der Listung zugestimmt haben; bezahlt wird immer im Shop der Marke.

Serveradresse

https://itemoo.eu/mcp

Werkzeuge

  • search — Search products, brands, companies, sellers and articles
  • brand_get — Brand profile
  • product_lookup — Product data with provenance
  • recall_status — Recall and safety notice status
  • documents_list — Product documents
  • sellers_for_product — Where to buy
  • cart_create — Prepare a cart in a brand shop

Marken-MCP — Daten Ihrer Marke

Katalog, Chargen, Scans, Compliance-Lücken, Verkäufe und Bestand in Zahlen, ohne personenbezogene Kundendaten. Mit gesonderter Zustimmung des Markeninhabers legt der Assistent auch Entwürfe von Produktseiten, Beiträgen, Artikeln, Kampagnen und der Markenwebsite an — veröffentlicht werden sie immer von einem Menschen im Panel. Jede Verbindung gehört einer Person im Team und einer Marke.

Ihre Marke: Adresse im Panel

https://itemoo.eu/mcp/b/{brand}

  1. Der Markeninhaber aktiviert es im Panel unter Integrationen → KI-Assistenten (MCP) und wählt die Rollen, die sich verbinden dürfen.

  2. Fügen Sie im Assistenten einen eigenen Konnektor mit der im Panel angezeigten Serveradresse der Marke hinzu.

  3. Melden Sie sich bei Itemoo an und bestätigen Sie den Zugriff. Der Assistent sieht nur, was Ihre Rolle erlaubt; die Verbindung widerrufen Sie im Panel.

Werkzeuge

  • products_list — Products of the brand
  • products_get — Product details
  • batches_list — Batches (LOT)
  • codes_stats — QR code and unit statistics
  • scans_analytics — Scan analytics
  • plan_usage — Plan and usage
  • catalog_gaps — Catalogue gaps
  • translations_status — Translation status
  • orders_summary — Orders summary
  • customers_summary — Customers summary
  • stock_overview — Stock overview
  • promotions_list — Promotions
  • marketplace_status — Marketplace channels
  • team_overview — Team overview
  • billing_summary — Billing summary
  • product_page_get — Product page draft for editing
  • product_draft_create — Create product drafts
  • product_page_draft_patch — Edit a product page draft
  • site_draft_get — Brand website draft
  • site_draft_patch — Edit the brand website draft
  • publications_list — Social media posts
  • publication_get — One post
  • publication_draft_upsert — Create or edit a post draft
  • articles_list — Knowledge articles
  • article_get — One article
  • article_draft_upsert — Create or edit an article draft
  • campaigns_list — Push and newsletter campaigns
  • campaign_get — One campaign
  • campaign_draft_upsert — Create or edit a campaign draft
  • draft_discard — Discard your own draft

cURL

curl -X POST 'https://itemoo.eu/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"resin"}}}'

Anleitungen

Schritt für Schritt: ERP anbinden, Webhooks, Produktpass.

Anleitungen folgen in Kürze.