Tu ERP ya conoce tus cosechas, recepciones y despachos. Conectarlo hace que nadie tenga que cargarlos dos veces. Todo está en Configuración › Integraciones, en cinco pestañas: Webhooks, Entrantes, Clientes de máquina, Direcciones IP e Identidad de credenciales (la identidad con la que se firman tus pasaportes de producto, mirá Identidad de credenciales). Los propietarios y administradores configuran las conexiones en las empresas de producción; en un sandbox, los operadores también pueden configurarlas.
Lo que llega de otro sistema nunca actúa por su cuenta: se convierte en un evento, un borrador o una aprobación, y una persona tiene que aprobarlo.
Elegí el camino correcto
| Querés… | Usá |
|---|---|
| que tu ERP le envíe a A-REX recepciones de mercadería, entregas o análisis de laboratorio | Entrantes |
| que A-REX le avise a tu ERP cuando un lote se registra, se entrega o se certifica | Webhooks |
| que tu sistema llame por su cuenta a la API de A-REX | Clientes de máquina |
| cargar una planilla de registros | importación de archivos (más abajo) |
Recibir mensajes de tu ERP
- En Entrantes, seleccioná Agregar endpoint entrante.
- Remitente: ponele un nombre (por ejemplo «Recepciones de ERP») y elegí Cómo firma el remitente.
- Acceso y límites: si querés, restringí las Direcciones de remitente permitidas, y definí el tamaño y la frecuencia de los mensajes.
- Mensaje de ejemplo: pegá un mensaje típico. Sus campos pasan a ser el formato esperado.
- Seleccioná Crear y confirmá con un código de tu app de autenticación. Copiá la Dirección y el secreto en tu ERP: el secreto se muestra una sola vez.
Los mensajes que no coinciden con los campos esperados quedan En cuarentena. Abrí uno para Comprobar de nuevo después de corregir los campos, o Descartar si no sirve.
Enviar eventos a tu ERP (webhooks)
- En Webhooks, seleccioná Agregar endpoint.
- Destino: un nombre, la URL https de tu sistema y el Formato (CloudEvents (recomendado) o JSON simple). Tildá Las automatizaciones pueden enviar a este endpoint si los pasos de una automatización tienen que enviarle mensajes.
- Eventos: Empezá con una plantilla (Todo sobre lotes, Solo problemas, Aprobaciones, Reglas de lotes y complementos, Cambios en el directorio, Informes), o elegí los eventos por grupo. Por ejemplo, Entrega en espera y Entrega fallida le avisan a tu ERP cuando una entrega aprobada queda demorada o no se puede hacer.
- Revisión y después Crear. Copiá el secreto de firma. A-REX envía una solicitud de verificación, y el endpoint pasa a Activo cuando tu sistema la responde.
Un endpoint recibe los eventos de su propia empresa: eventos reales en una empresa de producción, eventos de práctica en un sandbox. Los mensajes llevan identificadores y enlaces, no nombres. Cada endpoint lista sus Entregas con cada intento; las que fallan se reintentan, y Recuperar / reenviar faltantes vuelve a enviar lo que tu sistema se perdió. Habilitá en tu cortafuegos las direcciones de Direcciones IP.
Verificá que un mensaje viene de A-REX
Cada mensaje de webhook va firmado con el secreto del endpoint, que empieza con whsec_. Tu sistema
tiene que verificar esa firma antes de confiar en un mensaje. Abrí el endpoint en
Webhooks: el panel Verificar firmas trae código listo en
TypeScript, Python, Java y C# para que lo copie tu equipo de sistemas. Cuando usás Rotar secreto,
el secreto anterior y el nuevo valen los dos durante la superposición que elijas, así que pasale los
dos a la verificación.
Clientes de máquina
En Clientes de máquina, seleccioná Crear cliente,
elegí su Acceso (Lectura, Propuesta) y su Método de inicio de sesión: Clave privada
(recomendado) o Secreto de cliente. Ningún acceso puede aprobar: lo que propone un sistema
espera a una persona. Los secretos de cliente y las claves de API dicen a qué tipo de empresa
pertenecen: empiezan con arex_cs_prod_ o arex_cs_sandbox_, y arex_sk_prod_ o
arex_sk_sandbox_, así una clave de práctica nunca se confunde con una de producción. Las claves
creadas antes siguen funcionando.
Descripciones de la API y de los eventos
Para tu equipo de sistemas, A-REX describe su API en OpenAPI 3.1 y cada evento de webhook en AsyncAPI 3.0. Las dos descripciones se generan a partir de la propia plataforma, así coinciden con lo que acepta y envía. Tus desarrolladores pueden pedir los archivos actuales en Soporte y después conectarse con un cliente de máquina.
Tus propios identificadores
Las contrapartes, los sitios y los productos pueden llevar el identificador propio de tu empresa, el código que tienen en tu ERP. Así tu integración puede buscar un productor, un campo o un producto por tu código, y los mensajes pueden incluirlo, para que tu ERP nunca tenga que aprender los identificadores de A-REX.
Importación de archivos
La importación de archivos (CSV) de recepciones de cosecha, entregas, análisis de laboratorio y datos del directorio se está sumando a Integraciones. Primero revisa cada fila y lista los errores, y después crea aprobaciones pendientes, nunca cambios directos.
Practicá en un sandbox
Probá todo antes de que lo use tu empresa de producción:
- Creá un sandbox desde tu organización: Nueva empresa › Un sandbox. Es una empresa de práctica con datos ficticios, y sus endpoints reciben sus propios eventos: aprobá una cosecha de práctica y mirá cómo llega el mensaje real. Los operadores pueden agregar endpoints ahí; en una empresa de producción, los endpoints necesitan un propietario o administrador y su segundo factor.
- En un endpoint, seleccioná Enviar un evento de ejemplo para mandar un ejemplo firmado, marcado como ejemplo, y ver exactamente la solicitud y la respuesta.
- La prueba de una automatización solo simula sus mensajes: nada llega a tus sistemas reales. Mirá Automatizaciones.