Conectar Cin7: recibir pedidos y clientes, consultar inventario
En Cin7 Omni, en go.cin7.com, abra una API connection y anote su usuario y contraseña, complete solo esos dos campos en Integration, pruebe, mapee y active: entran pedidos de venta y clientes y se puede consultar el inventario.
El conector de Cin7 trae pedidos de venta y clientes de Cin7 Omni a este sistema y puede consultar las cantidades de inventario guardadas en Cin7, incluidas las cantidades disponibles y en mano. Lee datos de Cin7: no devuelve cambios de inventario a Cin7 y no escribe pedidos ni clientes de vuelta en Cin7. No hay ningún campo de dirección que completar: el conector usa siempre la dirección oficial de la API de Cin7. Una conexión usa una API connection de Cin7.
Requisitos previos#
- Una cuenta de Cin7 Omni a la que pueda acceder en go.cin7.com.
- Permiso en Cin7 para abrir o crear una API connection. El usuario y la contraseña de esta integración salen de esa API connection.
- El punto clave antes de empezar: el usuario y la contraseña de la API no son su cuenta de acceso a Cin7. Completar el correo y la contraseña con los que entra en Cin7 no conectará.
- Tenga en cuenta los límites de la API de Cin7 al planificar la frecuencia de extracción: 3 solicitudes por segundo, 60 por minuto y 5.000 por día.
Obtener credenciales#
- Inicie sesión en Cin7 Omni en go.cin7.com.
- Abra el área de API connection y abra la API connection que quiere usar para esta integración, o cree una nueva.
- Anote el usuario de esa API connection. Ese usuario se genera para la API connection y se usa para la autenticación Basic: no es su nombre de acceso a Cin7.
- Anote la contraseña de API definida en esa misma API connection. El usuario y la contraseña deben venir de la misma API connection: no mezcle valores de dos conexiones distintas.
Completar en Integration#
- Abra Integration → Marketplace → Cin7 → Nueva conexión.
- username, obligatorio, usuario de la API de Cin7: complete el usuario de la API connection de Cin7. El texto de ayuda del campo dice API username.
- password, obligatorio, contraseña de la API de Cin7: complete la contraseña de API definida en esa misma API connection. Es un campo de tipo contraseña y se guarda como secreto.
- No hay nada más que completar. Esta conexión no tiene campo de dirección: se conecta siempre a la dirección oficial https://api.cin7.com/api, así que no busque dónde cambiarla.
Probar la conexión#
Haga clic en Probar la conexión. Si falta username o password, la prueba se detiene e informa del campo que falta antes de enviar ninguna solicitud, porque la autenticación Basic necesita ambos valores. En caso contrario, la prueba envía una solicitud con autenticación Basic para leer la lista de sucursales, GET https://api.cin7.com/api/v1/Branches, la lectura más ligera de Cin7. Una respuesta 200 significa que la conexión funciona. Una respuesta 401 significa que las credenciales no son válidas. Una respuesta 403 significa que las credenciales fueron aceptadas, pero esta API connection no tiene permiso para ese recurso: 401 y 403 apuntan a soluciones distintas, así que lea el código antes de cambiar nada. La prueba agota el tiempo a los 12 segundos.
Mapping / elegir plantilla#
Elija el mapping estándar de Cin7. Los pedidos de venta se leen de los datos de pedidos de venta de Cin7, los clientes de los datos de contactos de Cin7 y las consultas de inventario leen los datos de stock de Cin7. Tras aprobar la prueba, ejecute una extracción y compare un pedido real lado a lado (número de pedido, cliente, líneas y cantidades), revise un registro de cliente y contraste la cantidad de un producto con lo que muestra Cin7, antes de activar. Si un campo de sus pedidos difiere, ajuste ese campo en el mapping en lugar de cambiar registros en Cin7.
Activar#
Tras activar, la conexión trae pedidos de venta y clientes de Cin7 a este sistema según la frecuencia definida, dentro de los límites de Cin7 de 3 solicitudes por segundo, 60 por minuto y 5.000 por día, y las consultas de inventario leen las cantidades actuales de Cin7. Vigile las primeras extracciones en Runs / Logs y compárelas con Cin7 antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: no devuelve cambios de inventario a Cin7 y no escribe pedidos, clientes ni resultados de fulfillment de vuelta en Cin7. Siga gestionando eso en el propio Cin7, o en los sistemas donde el trabajo ocurre realmente.
Preguntas frecuentes#
La prueba falla con 401: credenciales no válidas
Cin7 rechazó la autenticación Basic. El usuario o la contraseña no coincide con ninguna API connection de Cin7, normalmente porque se completó el correo y la contraseña de acceso a Cin7, o porque el usuario y la contraseña vienen de dos API connections distintas.
En Cin7 Omni, en go.cin7.com, abra la API connection, copie su usuario tal cual en el campo username, defina o copie la contraseña de API de esa misma conexión en el campo password, guarde y pruebe de nuevo. No use su contraseña de acceso a Cin7.
La prueba falla con 403: esta API connection no tiene permiso para ese recurso
Esto es distinto del 401: Cin7 aceptó las credenciales, pero la API connection no tiene permitido leer la lista de sucursales que usa la prueba. Cambiar la contraseña otra vez no arreglará un 403.
En Cin7, revise el acceso dado a esta API connection y permítale leer los recursos que la conexión necesita, o cambie a una API connection que ya tenga ese acceso. Mantenga el mismo par de usuario y contraseña de esa conexión, guarde y pruebe de nuevo.
La prueba se detiene antes de enviar una solicitud e informa de un campo que falta
username o password está vacío. La prueba necesita ambos valores para la autenticación Basic, así que se detiene en lugar de enviar una solicitud que Cin7 solo puede rechazar.
Complete ambos campos desde la misma API connection de Cin7 (el usuario de la conexión y la contraseña definida en esa misma conexión), guarde y pruebe de nuevo.
Completé mi cuenta de acceso a Cin7, pero no conecta
La cuenta de acceso y las credenciales de la API connection son dos cosas distintas en Cin7. Esta conexión se autentica solo con el usuario y la contraseña de una API connection, así que una cuenta de acceso perfectamente válida sigue fallando aquí.
Vaya a go.cin7.com → API connection en Cin7 Omni, abra o cree una API connection y use su usuario y su contraseña de API en Integration en lugar de sus datos de acceso. Después pruebe de nuevo.
Conectado, pero no llegan pedidos de venta
La conexión funciona (la prueba leyó la lista de sucursales correctamente), pero no hay nada nuevo que traer: Cin7 no tiene pedidos de venta nuevos en el rango de extracción, o los registros que hay no son pedidos de venta.
Cree o confirme un pedido de venta en Cin7, ejecute una extracción manual y confirme que el pedido aparece en la vista previa o en Runs / Logs. Mantenga la frecuencia de extracción dentro de los límites indicados arriba.
La consulta de inventario no devuelve cantidad para un producto
La conexión puede leer el stock en Cin7, pero ese producto no tiene un registro de stock coincidente que leer, o el código de producto del mapping no coincide con el producto en Cin7. La prueba puede aprobar mientras un producto concreto sigue sin nada que devolver.
Revise primero el producto y su registro de stock en Cin7, después revise el código de producto de ese artículo en el mapping y corríjalo para que coincida con Cin7. Vuelva a ejecutar la consulta de inventario solo para ese producto.