Vai al contenuto

API

Sviluppatori

L’API pubblica di Itemoo per ERP, magazzino e produzione, più i dati di prodotto per agenti e scanner. La documentazione nasce dal codice dell’API.

API ERPDati di prodotto pubbliciAPI del passaporto (EN 18222:2026)

La prima chiamata in tre minuti

  1. Nel pannello Itemoo apri Integrazioni → Chiavi API e crea una chiave con i permessi necessari. La vedrai una sola volta.

  2. Verifica la connessione: GET /v1/ping con l’intestazione Authorization: Bearer itm_…

  3. Invia le giacenze o scarica gli ordini — ogni endpoint qui sotto ha un esempio. Le notifiche degli ordini si impostano nello stesso punto del pannello.

Crea una chiave nel pannello →

cURL

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

Server MCP per assistenti IA

Il Model Context Protocol consente agli assistenti IA (Claude, ChatGPT e altri) di usare Itemoo senza un’integrazione dedicata: l’assistente scopre da solo gli strumenti e i loro parametri.

MCP globale — prodotti e acquisti

Ricerca di prodotti, marchi, aziende, venditori e articoli, dati di prodotto con la fonte di ogni informazione, richiami, documenti e un carrello con link alla cassa. Senza accesso. La ricerca include i marchi che hanno scelto di comparire; si paga sempre nel negozio del marchio.

Indirizzo del server

https://itemoo.eu/mcp

Strumenti

  • 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

MCP del marchio — i dati del Suo marchio

Catalogo, lotti, scansioni, lacune di conformità, vendite e magazzino in cifre, senza dati personali dei clienti. Con un consenso separato del titolare del marchio, l’assistente crea anche bozze di pagine prodotto, post, articoli, campagne e del sito del marchio — a pubblicarle è sempre una persona nel pannello. Ogni connessione appartiene a una persona del team e a un marchio.

Il Suo marchio: indirizzo nel pannello

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

  1. Il titolare del marchio lo attiva nel pannello in Integrazioni → Assistenti IA (MCP) e sceglie i ruoli che possono connettersi.

  2. Nell’assistente aggiunga un connettore personalizzato con l’indirizzo del server del marchio indicato nel pannello.

  3. Acceda a Itemoo e approvi l’accesso. L’assistente vede solo ciò che il Suo ruolo consente; può revocare la connessione nel pannello.

Strumenti

  • 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"}}}'

Guide

Passo dopo passo: collegare l’ERP, i webhook, il passaporto di prodotto.

Le guide arriveranno presto.