Envía leads a Epicor
Un lead del chat se convierte en un cliente, en Kinetic o en Prophet 21.
Epicor es una conexión que cubre dos productos con dos APIs distintas. Elige cuál tienes y el resto del formulario cambia con la respuesta.
Los dos corren en tu servidor, así que la dirección es un campo y la accesibilidad es tuya.
Kinetic quiere las dos mitades
Este es el detalle que conviene saber antes de empezar. La REST v2 de Kinetic rechaza una petición que lleve clave de API sin autenticación, y rechaza una que lleve autenticación sin clave de API -- y los dos rechazos se leen distinto. Un usuario perfectamente válido sin clave parece una contraseña mal.
Por eso los dos campos son obligatorios en el formulario y se comprueban antes de guardar nada. Necesitas:
- La dirección del servidor, con la ruta de la instancia, del estilo
https://erp.example.com/KineticProd. - El id de compañía, porque las URLs de REST v2 van por compañía.
- Una clave de API, del registro de aplicaciones de la API de Epicor.
- Un usuario que pueda crear clientes, y su contraseña.
Prophet 21 inicia sesión primero
Prophet 21 no tiene clave de API. Cambia el usuario y la contraseña por un token en /api/security/token y lleva ese token en la llamada siguiente. El intercambio ocurre en cada envío, así que no hay nada que refrescar ni nada guardado más allá del propio usuario.
Necesitas la dirección del servidor y el usuario.
Conectar y enrutar
- En Destinos, conecta Epicor y elige el producto.
- Pega los valores. Verificamos con una llamada: para Kinetic una lectura que prueba la clave, el usuario y la compañía a la vez; para Prophet 21, el inicio de sesión.
- Crea una ruta -- qué leads coge.
- Mapea los campos. Nombre, email, teléfono y las partes de la dirección.
Qué se envía
Un conjunto de campos de cliente elegido, no todo lo que expone el servicio. Erp.BO.CustomerSvc lleva cientos de columnas, casi ninguna con sentido fuera de un almacén, y un mapeador que las ofrece todas es un mapeador que nadie termina.
Un cliente necesita nombre. Se rellena con el email cuando el mapeo lo deja fuera.
En Kinetic el id de compañía se añade también al registro, además de a la URL, para que un cliente nunca acabe en una compañía que nadie quería.
Errores habituales
Un 401 en Kinetic con un usuario que sabes que está bien casi siempre significa que falta la clave de API, está mal, o pertenece a otra aplicación. Revísalo primero.
En Prophet 21, un inicio de sesión que responde 200 sin token en el cuerpo se trata como un fallo y no como un acierto -- seguir sin token produciría un rechazo confuso un paso más adelante. Qué endpoints expone tu P21 depende de la versión del middleware instalada.
Qué no hace
Crea un cliente. No lo actualiza, no deduplica, y no crea pedidos, ofertas ni contactos. Están en la lista.
Esto no se ha medido contra un sistema real. Los dos productos corren en hardware del cliente, así que no había host contra el que probar. Está escrito contra la documentación de Epicor de las dos APIs, y la primera conexión es la primera medición.