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 ChatGPT 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 ChatGPT. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
El plugin de AnythingMCP en el directorio de ChatGPT responde, en AnythingMCP Cloud, a preguntas sobre las bases de datos de tu empresa (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, solo lectura): abre la ficha (se abre en una pestaña nueva) y pulsa Install plugin. Los demás conectores se añaden a ChatGPT como servidor MCP personalizado con la URL MCP de tu AnythingMCP.
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 + ChatGPT
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 ChatGPT
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.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
Cin7 Omni. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
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.
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Próximos pasos
¿Te ha sido útil esta guía?