Resumen
Gestión de inventario y pedidos de Cin7 Omni (go.cin7.com) a través de la API v1: pedidos de venta, cotizaciones, órdenes de compra, notas de crédito, contactos, productos, stock por sucursal, sucursales, pagos (solo lectura), ajustes de stock, transferencias entre sucursales y usuarios. Crea pedidos, órdenes de compra, contactos y transferencias. Nombre de usuario y clave de API.
Configuración guiada
Conecta Cin7 Omni a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Cin7 Omni con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Cin7 Omni
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Cin7 Omni, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Cin7 Omni + Microsoft Copilot
Gestión de inventario y pedidos de Cin7 Omni (go.cin7.com) a través de la API v1: pedidos de venta, cotizaciones, órdenes de compra, notas de crédito, contactos, productos, stock por sucursal, sucursales, pagos (solo lectura), ajustes de stock, transferencias entre sucursales y usuarios. Crea pedidos, órdenes de compra, contactos y transferencias. Nombre de usuario y clave de API.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY
Paso 1 — Obtener credenciales
La configuración toma aproximadamente 3 minutos. Necesitas una cuenta de Cin7 Omni (inicias sesión en go.cin7.com) y un administrador que pueda añadir una conexión de API v1. El conector necesita el nombre de usuario de la API y una clave de API.
¿Omni o Core? Cin7 vende dos productos diferentes. Cin7 Omni (este conector) inicia sesión en go.cin7.com y tiene API v1 con un nombre de usuario y clave de API. Cin7 Core (anteriormente DEAR Inventory) inicia sesión en inventory.dearsystems.com y tiene su propia API con un ID de Cuenta y una Clave de Aplicación: utiliza el conector de Cin7 Core para ello. Las dos APIs y sus credenciales no son intercambiables.
- En Cin7 Omni abre el menú de usuario, luego Configuración → Integraciones y API → API v1.
- Copia el Nombre de usuario de API que se muestra en la parte superior de la página en
CIN7_OMNI_API_USERNAME. - Haz clic en Agregar nueva conexión de API, dale un nombre y copia su clave de API en
CIN7_OMNI_API_KEY. Regenerar clave reemplaza una clave perdida. - Bajo Permisos marca Lectura para cada recurso que la IA debería ver, y Crear o Actualizar para los recursos que las herramientas de escritura necesitan, luego haz clic en Guardar. Un recurso sin permiso responde 403.
- Instala el conector. Ejecuta
cin7_omni_list_branchespara verificar la conexión: lista tus sucursales con sus ids.
La nube y el autoalojamiento funcionan de la misma manera: las credenciales son las mismas, y no hay URL de redirección que configurar. El conector envía el nombre de usuario y la clave como autenticación HTTP Basic.
Dónde empezar: cin7_omni_list_branches para ids de sucursales, cin7_omni_list_sales_orders para pedidos recientes, cin7_omni_list_stock para stock por sucursal, y cin7_omni_list_contacts para encontrar un cliente o proveedor.
Lo que lee: pedidos de venta, cotizaciones y notas de crédito con sus líneas; pagos registrados contra pedidos; órdenes de compra; productos, sus opciones (los SKUs vendibles) con precios y categorías; stock por opción de producto y sucursal (disponible, en mano, ventas abiertas, entrantes); ajustes de stock y transferencias entre sucursales; contactos y usuarios.
Lo que escribe: cin7_omni_create_sales_order, cin7_omni_update_sales_order (solo campos de encabezado, como etapa, código de seguimiento e instrucciones de entrega), cin7_omni_create_purchase_order, cin7_omni_create_contact, cin7_omni_update_contact y cin7_omni_create_branch_transfer están habilitados. Un nuevo pedido de venta se aprueba a menos que la IA lo cree como un borrador; las órdenes de compra y transferencias se guardan como borradores a menos que sean aprobadas. El despacho y la recepción de transferencias ocurren en Cin7.
Desactivado al instalar: cin7_omni_create_adjustment (crear un ajuste de stock en una sucursal). Un ajuste aprobado cambia el stock en mano y el valor del stock a la vez. Actívalo en la página del conector si la IA debería usarlo; la IA te pide que confirmes cada cambio.
Verifica la respuesta de cada escritura: Cin7 responde HTTP 200 con una lista de {index, success, id, code, errors}, también cuando rechaza el registro. La IA verifica success y errors antes de informar que una escritura se ha completado.
Los pagos son solo lectura: el conector nunca registra, cambia o elimina un pago, y no despacha, factura o anula pedidos.
Filtrado: where toma condiciones al estilo SQL sobre los campos del registro, no de sus líneas. Cadenas y fechas van entre comillas simples, los números se dejan sin comillas: modifiedDate>='2026-01-01T00:00:00Z' AND branchId=3, reference LIKE 'SO-10%', id IN (21,24). Las fechas son UTC, yyyy-MM-ddTHH:mm:ssZ. fields recorta la respuesta (id,reference,total,lineItems(code,qty)), lo que ayuda con las listas de pedidos, porque son grandes.
Paginación: page comienza en 1 y rows es como máximo 250 (por defecto 50, 25 en listas de pedidos). La IA pide la siguiente página hasta que una vuelva vacía.
Límites de tasa: Cin7 Omni permite 3 llamadas por segundo, 60 por minuto y 5,000 por día por cuenta; más allá de eso responde 429 con Retry-After. Grandes rows con filtros where estrechos utilizan mejor el presupuesto que muchas llamadas pequeñas.
Valores: el status del pedido es DRAFT, APPROVED o VOID, y stage es una etapa de flujo de trabajo de texto libre (Nuevo, Esperando Pago, Procesando, En Espera, Despachado). El stock available es el stock en mano menos las ventas abiertas. El type de contacto es Cliente, Proveedor o Interno. Las escrituras toman montos en la moneda del pedido; las lecturas devuelven valores en moneda base con el tipo de cambio. Los nuevos usuarios pueden tardar hasta 2 horas en aparecer en cin7_omni_list_users.
Errores comunes: 403 significa que la conexión de API no tiene permiso para ese recurso: márcalo bajo Permisos y guarda. 429 es el límite de tasa: espera el tiempo de Retry-After.
Paso 2 — Instalar el adaptador
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Agregar el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Cin7 Omni. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
cin7_omni_list_sales_orders | Lista los pedidos de venta, los más nuevos primero: id, referencia, estado (DRAFT, APPROVED, VOID), etapa, cliente (memberId, empresa, email), branchId, fechas… |
cin7_omni_get_sales_order | Lee un pedido de venta con sus líneas, direcciones, totales, etapa, estado, fechas de factura y despacho |
cin7_omni_list_quotes | Lista las cotizaciones de ventas con cliente, sucursal, totales, etapa y líneas |
cin7_omni_list_purchase_orders | Lista las órdenes de compra, las más nuevas primero: id, referencia, proveedor (memberId, empresa), branchId, estado, etapa, estimatedArrivalDate… |
cin7_omni_get_purchase_order | Lee una orden de compra con sus líneas, proveedor, fechas y totales |
cin7_omni_list_credit_notes | Lista las notas de crédito: id, referencia, salesReference (el pedido de venta que acredita), cliente, totales, estado y líneas (cantidades negativas) |
cin7_omni_get_credit_note | Lee una nota de crédito con sus líneas y totales |
cin7_omni_list_payments | Lista los pagos registrados contra pedidos: id, orderId, orderRef, paymentDate, amount, method, direction (1 recibido, -1 pagado o reembolsado)… |
cin7_omni_list_contacts | Lista contactos (clientes, proveedores, internos): id, type, empresa, nombre y apellido, email, teléfono, direcciones, accountNumber… |
cin7_omni_get_contact | Lee un contacto con direcciones, contactos secundarios, precios y detalles de cuenta |
cin7_omni_list_products | Lista productos (estilos): id, nombre, styleCode, estado, marca, ids de categoría, descripción, control de stock y sus productOptions (variantes con… |
cin7_omni_get_product | Lee un producto con todas sus opciones, precios y dimensiones |
cin7_omni_list_product_options | Lista opciones de producto (las variantes vendibles, SKUs): id, productId, code, barcode, option1-3, retail, wholesale y precios especiales, precio… |
cin7_omni_list_product_categories | Lista categorías de productos: id, nombre, parentId (0 = nivel superior), orden |
cin7_omni_list_stock | Stock por opción de producto y sucursal: productId, productOptionId, code, barcode, branchId, branchName, available (stock en mano menos ventas abiertas… |
cin7_omni_list_branches | Lista sucursales (almacenes, tiendas): id, empresa, branchType, isActive, dirección y ubicaciones de bin |
cin7_omni_list_adjustments | Lista ajustes de stock: id, referencia, branchId, isApproved, completedDate, adjustmentReason y líneas (code, qty, unitCost) |
cin7_omni_list_branch_transfers | Lista transferencias de stock entre sucursales: id, referencia, sourceBranchId, destinationBranchId, etapa, isApproved, dispatchedDate, receivedDate… |
cin7_omni_list_users | Lista los usuarios de la cuenta de Cin7 Omni: id, firstName, lastName, jobTitle, email, isActive |
cin7_omni_create_sales_order | Crea un pedido de venta |
cin7_omni_update_sales_order | Actualiza los campos de encabezado de un pedido de venta: etapa, código de seguimiento, número de pedido del cliente, fecha estimada de entrega, instrucciones de entrega… |
cin7_omni_create_purchase_order | Crea una orden de compra a un proveedor (member_id de un contacto Proveedor) |
cin7_omni_create_contact | Crea un contacto (cliente o proveedor) |
cin7_omni_update_contact | Actualiza un contacto; solo cambian los campos dados |
cin7_omni_create_branch_transfer | Crea una transferencia de stock entre dos sucursales |
cin7_omni_create_adjustment | Crea un ajuste de stock en una sucursal (cantidad positiva añade stock, negativa lo elimina) |
Ejemplos de indicaciones
- "¿Qué pedidos de venta fueron aprobados esta semana y aún no han sido despachados?"
- "¿Cuánto stock del SKU TSHIRT-BLK-M está disponible en cada sucursal?"
- "¿Qué órdenes de compra están previstas para llegar este mes, y de qué proveedores?"
- "Encuentra al cliente con el email [email protected] y muestra su saldo pendiente."
- "Crea una transferencia borrador de 20 unidades de TSHIRT-BLK-M desde el almacén principal a la tienda de la ciudad."
Preguntas frecuentes
Uso Cin7 Core (DEAR Inventory). ¿Es este el conector correcto? No. Cin7 Core tiene su propia API y credenciales: utiliza el conector de Cin7 Core. Las credenciales de un producto no funcionan en el otro.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?