Saltar al contenido

API

Desarrolladores

La API pública de Itemoo para ERP, almacén y producción, y datos de producto para agentes y escáneres. La documentación se genera con el código de la API.

La primera llamada en tres minutos

  1. En el panel de Itemoo abre Integraciones → Claves API y crea una clave con los permisos necesarios. Solo la verás una vez.

  2. Comprueba la conexión: GET /v1/ping con la cabecera Authorization: Bearer itm_…

  3. Envía existencias o descarga pedidos — cada endpoint de abajo tiene un ejemplo. Las notificaciones de pedidos se configuran en el mismo lugar del panel.

Crear una clave en el panel →

cURL

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

Servidores MCP para asistentes de IA

El Model Context Protocol permite a los asistentes de IA (Claude, ChatGPT y otros) usar Itemoo sin una integración propia: el asistente descubre por sí mismo las herramientas y sus parámetros.

MCP global — productos y compras

Búsqueda de productos, marcas, empresas, vendedores y artículos, datos de producto con la fuente de cada dato, retiradas, documentos y un carrito con enlace a la caja. Sin iniciar sesión. La búsqueda incluye las marcas que aceptaron figurar; se paga siempre en la tienda de la marca.

Dirección del servidor

https://itemoo.eu/mcp

Herramientas

  • 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 de la marca — los datos de su marca

Catálogo, lotes, escaneos, carencias de conformidad, ventas y stock en cifras, sin datos personales de clientes. Con el consentimiento aparte del propietario de la marca, el asistente también crea borradores de páginas de producto, publicaciones, artículos, campañas y del sitio de la marca — siempre los publica una persona en el panel. Cada conexión pertenece a una persona del equipo y a una marca.

Su marca: dirección en el panel

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

  1. El propietario de la marca lo activa en el panel en Integraciones → Asistentes de IA (MCP) y elige los roles que pueden conectarse.

  2. En su asistente, añada un conector personalizado con la dirección del servidor de la marca que muestra el panel.

  3. Inicie sesión en Itemoo y apruebe el acceso. El asistente solo ve lo que permite su rol; puede revocar la conexión en el panel.

Herramientas

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

Guías

Paso a paso: conectar el ERP, webhooks, el pasaporte de producto.

Las guías llegarán pronto.