Saltar para o conteúdo

API

Programadores

A API pública do Itemoo para ERP, armazém e produção, e dados de produto para agentes e leitores. A documentação é gerada a partir do código da API.

API para ERPDados públicos de produtoAPI do passaporte (EN 18222:2026)

A primeira chamada em três minutos

  1. No painel do Itemoo, abra Integrações → Chaves API e crie uma chave com os âmbitos de que precisa. A chave só é mostrada uma vez.

  2. Verifique a ligação: GET /v1/ping com o cabeçalho Authorization: Bearer itm_…

  3. Envie o stock ou obtenha as encomendas — cada endpoint abaixo tem um exemplo. As notificações de encomendas configuram-se no mesmo local do painel.

Criar uma chave no painel →

cURL

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

Servidores MCP para assistentes de IA

O Model Context Protocol permite que os assistentes de IA (Claude, ChatGPT e outros) utilizem o Itemoo sem uma integração própria: o assistente descobre sozinho as ferramentas e os respetivos parâmetros.

MCP global — produtos e compras

Pesquisa de produtos, marcas, empresas, vendedores e artigos, dados de produto com a fonte de cada facto, recolhas, documentos e um carrinho com ligação para o checkout. Sem iniciar sessão. A pesquisa abrange as marcas que aceitaram ser listadas; o comprador paga sempre na loja da marca.

Endereço do servidor

https://itemoo.eu/mcp

Ferramentas

  • 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 da marca — os dados da sua marca

Catálogo, lotes, leituras, lacunas de conformidade, vendas e stock em números, sem dados pessoais de clientes. Com o consentimento separado do titular da marca, o assistente também cria rascunhos de páginas de produto, publicações, artigos, campanhas e do site da marca — quem os publica é sempre uma pessoa no painel. Cada ligação pertence a uma pessoa da equipa e a uma marca.

A sua marca: endereço no painel

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

  1. O proprietário da marca ativa esta opção no painel, em Integrações → Assistentes de IA (MCP), e escolhe as funções que podem ligar-se.

  2. No seu assistente, adicione um conector personalizado com o endereço do servidor da marca indicado no painel.

  3. Inicie sessão no Itemoo e aprove o acesso. O assistente vê apenas o que a sua função permite; pode revogar a ligação no painel.

Ferramentas

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

Guias

Passo a passo: ligar o ERP, webhooks, o passaporte do produto.

Os guias estarão disponíveis em breve.