Conectar Epicor Kinetic: recibir pedidos y clientes, consultar inventario
Cree una cuenta de servicio y una API Key en Epicor Kinetic, complete la URL base del servidor, el Company ID, el usuario, la contraseña y la API Key en Integration, pruebe, mapee y active.
El conector de Epicor Kinetic trae pedidos de venta y clientes de su ERP Epicor Kinetic a este sistema y puede consultar las cantidades de inventario guardadas en Epicor. Lee datos de Epicor: no devuelve cambios de inventario a Epicor. Cada solicitud usa dos credenciales juntas, la cuenta de servicio para el acceso Basic y la API Key, así que ambas son siempre obligatorias. Una conexión por instancia de Epicor y compañía.
Requisitos previos#
- Una instancia de Epicor Kinetic a la que pueda acceder y su dirección base del servidor: en la nube, una forma como https://mycompany.epicorsaas.com/MyInstance; en una instalación local, https://<servidor>/<nombre de instancia>.
- Su Company ID, por ejemplo EPIC06. Es el segmento de compañía en la dirección OData v2, así que debe coincidir exactamente con la compañía de la que quiere traer datos.
- Una cuenta de servicio dedicada de Epicor, creada en User Account Security Maintenance, con acceso a esa compañía. Su usuario y contraseña son la mitad de las credenciales.
- Permiso para crear una clave en API Key Maintenance y para darle un Access Scope que cubra Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc y Erp.BO.PartSvc.
Obtener credenciales#
- Cree o confirme la cuenta de servicio dedicada en User Account Security Maintenance y asegúrese de que tiene acceso a la compañía de la que traerá datos. Anote su usuario y tenga lista su contraseña.
- Abra Epicor Kinetic → API Key Maintenance → New Key y cree una API Key nueva.
- Dé a la clave un Access Scope que cubra los tres servicios: Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc y Erp.BO.PartSvc. Una clave cuyo alcance omite un servicio no puede leer ese tipo de datos.
- Copie la API Key en el momento en que se muestra: se muestra una sola vez. Si la pierde, cree una clave nueva en lugar de buscar la antigua.
- Anote al mismo tiempo los otros dos valores: la dirección base del servidor, sin ningún sufijo /api, y el Company ID, por ejemplo EPIC06.
Completar en Integration#
- Abra Integration → Marketplace → Epicor Kinetic → Nueva conexión.
- base_url, obligatorio, URL base del servidor de Epicor: la dirección de su instancia, por ejemplo https://mycompany.epicorsaas.com/MyInstance. No añada un sufijo /api: el sistema construye el resto de la dirección.
- company, obligatorio, Company ID: el segmento de compañía, por ejemplo EPIC06. Debe ser la compañía a la que la cuenta de servicio puede acceder.
- username, obligatorio, usuario de la cuenta de servicio: el usuario de la cuenta de servicio dedicada de User Account Security Maintenance.
- password, obligatorio, contraseña de la cuenta de servicio: la contraseña de esa misma cuenta de servicio. Es un campo de tipo contraseña y se guarda como secreto.
- api_key, obligatorio, clave de la API REST: pegue la API Key copiada de API Key Maintenance → New Key, con su Access Scope cubriendo Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc y Erp.BO.PartSvc. Es un campo de tipo contraseña y se guarda como secreto.
Probar la conexión#
Haga clic en Probar la conexión. La prueba primero comprueba que los cinco campos estén completos: si falta base_url, se detiene con MISSING_BASE_URL, y cualquier otro campo faltante también detiene la prueba antes de enviar nada. Después hace una solicitud real de solo lectura con ambas credenciales juntas: pide un solo pedido de venta al servicio SalesOrder, enviando la cuenta de servicio como acceso Basic y la API Key en la misma solicitud. Una respuesta 200 cuenta como aprobado. El error le dice qué credencial revisar: 401 significa que el usuario o la contraseña de la cuenta de servicio fueron rechazados, mientras que 400 o 403 significa que la propia API Key fue rechazada o que su Access Scope no cubre el servicio. La prueba se rinde tras unos 12 segundos si la instancia no responde.
Mapping / elegir plantilla#
Elija el mapping estándar de Epicor Kinetic. Trabaja con los tres servicios que cubre el alcance de la API Key: los pedidos de venta vienen de Erp.BO.SalesOrderSvc, los clientes de Erp.BO.CustomerSvc y las consultas de inventario leen Erp.BO.PartSvc. 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) y contraste la cantidad de una pieza con lo que muestra Epicor, antes de activar. Si un campo de su instancia difiere, ajuste ese campo en el mapping en lugar de renombrar nada en Epicor.
Activar#
Tras activar, la conexión trae pedidos de venta y clientes de Epicor Kinetic a este sistema según la frecuencia definida, y las consultas de inventario leen las cantidades actuales de Epicor. Vigile las primeras extracciones en Runs / Logs y compárelas con Epicor antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: no devuelve cambios de inventario a Epicor Kinetic. Las cantidades en Epicor siguen bajo el control de Epicor: esta conexión solo las lee. Siga manteniendo el inventario en el propio Epicor.
Preguntas frecuentes#
La prueba falla con 401
Epicor rechazó el acceso Basic: el usuario o la contraseña de la cuenta de servicio no coinciden, o esa cuenta no puede acceder a la compañía del campo company. Este error trata de la cuenta de servicio, no de la API Key.
Contraste username y password con la cuenta en User Account Security Maintenance, confirme que esa cuenta tiene acceso a la compañía que completó y pruebe de nuevo. No cambie la API Key por un 401.
La prueba falla con 400 o 403
La propia API Key fue rechazada, o su Access Scope no cubre el servicio que la prueba llamó. La cuenta de servicio puede estar perfectamente bien: este error trata de la clave y su alcance, la segunda mitad de las credenciales.
En API Key Maintenance, revise la clave que pegó y su Access Scope: debe cubrir Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc y Erp.BO.PartSvc. Si la clave se copió incompleta o el alcance es corto, corrija el alcance o cree una clave nueva, péguela entera en api_key y pruebe de nuevo.
La prueba se detiene con MISSING_BASE_URL u otro mensaje de campo faltante
Uno de los cinco campos obligatorios está vacío, así que la prueba se detuvo antes de enviar nada. Los cinco (base_url, company, username, password y api_key) son obligatorios, porque cada solicitud necesita ambas credenciales y la dirección de la compañía.
Complete los cinco campos según el paso de completar en Integration, guarde y pruebe de nuevo. Para base_url, use la dirección completa de la instancia, sin que falte nada al principio.
Todos los valores parecen correctos, pero la prueba sigue fallando
Una causa común es la dirección: si base_url termina con un sufijo /api, el sistema añade sus propias partes de dirección después y la solicitud va a una dirección equivocada. El valor de company causa el mismo tipo de fallo: forma parte de la dirección, así que un Company ID incorrecto apunta la prueba a una compañía que no responde para estas credenciales.
Quite cualquier sufijo /api de base_url para que sea exactamente la dirección de la instancia, por ejemplo https://mycompany.epicorsaas.com/MyInstance, y vuelva a revisar company contra el Company ID de la compañía a la que la cuenta de servicio puede acceder. Guarde y pruebe de nuevo antes de cambiar cualquier credencial.
Los pedidos entran, pero los clientes o el inventario no
La conexión en sí funciona: la prueba aprobó sobre el servicio SalesOrder. El tipo de datos que falta apunta al alcance de la API Key: cada servicio necesita su propia cobertura, y un alcance que cubre SalesOrderSvc pero omite CustomerSvc o PartSvc lee pedidos mientras los otros dos quedan vacíos.
En API Key Maintenance, amplíe el Access Scope de la clave para que cubra los tres: Erp.BO.SalesOrderSvc, Erp.BO.CustomerSvc y Erp.BO.PartSvc. Si el alcance no se puede cambiar en la clave existente, cree una clave nueva con el alcance completo, péguela en api_key, pruebe de nuevo y ejecute una extracción.
Conectado, pero no llegan pedidos de venta
La conexión funciona (la prueba leyó de verdad el servicio SalesOrder), pero no hay nada nuevo que traer: la compañía en Epicor no tiene pedidos de venta nuevos en el rango de extracción, o los pedidos que hay pertenecen a otra compañía distinta de la del campo company.
Cree o confirme un pedido de venta en Epicor bajo el mismo Company ID que usa la conexión, ejecute una extracción manual y confirme que el pedido aparece en la vista previa o en Runs / Logs.