Conecta tu ERP y otros sistemas

Tu ERP ya conoce tus cosechas, recepciones y envíos. Si lo conectas, nadie tiene que escribirlos 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; consulta 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 sí solo: se convierte en un evento, un borrador o una aprobación, y una persona tiene que aprobarlo.

Elige la forma correcta

Recibe mensajes de tu ERP

1. En Entrantes, selecciona Agregar endpoint entrante.
2. Remitente: ponle un nombre (por ejemplo «Recepciones de mercancía de ERP») y elige Cómo firma el remitente.
3. Acceso y límites: si quieres, limita las Direcciones de remitente permitidas y define el tamaño y la frecuencia de los mensajes.
4. Mensaje de ejemplo: pega un mensaje típico. Sus campos pasan a ser el formato esperado.
5. Selecciona Crear y confirma con el código de tu app de autenticación. Copia 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. Abre uno y usa Comprobar de nuevo después de corregir los campos, o Descartar para eliminarlo.

Envía eventos a tu ERP (webhooks)

1. En Webhooks, selecciona Agregar endpoint.
2. Destino: un nombre, la URL https de tu sistema y el Formato (CloudEvents (recomendado) o JSON simple). Marca Las automatizaciones pueden enviar a este endpoint si los pasos de una automatización deben enviarle mensajes.
3. Eventos: Empieza con una plantilla (Todo sobre lotes, Aprobaciones, Informes, Cambios en el directorio, Solo problemas, Reglas de lotes y complementos), o elige los eventos por grupo. Por ejemplo, Entrega en espera y Entrega fallida avisan a tu ERP cuando una entrega aprobada queda retenida o no se puede hacer.
4. Revisión y luego Crear. Copia 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 fallidas se reintentan, y Recuperar / reenviar faltantes vuelve a enviar lo que tu sistema no recibió. Permite en tu firewall las direcciones de Direcciones IP.

Comprueba 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 comprobar esa firma antes de confiar en un mensaje. Abre el endpoint en Webhooks: el panel Verificar firmas trae código listo en TypeScript, Python, Java y C# para que tu equipo de TI lo copie. Cuando usas Rotar secreto, el secreto anterior y el nuevo valen durante el período de superposición que elijas, así que pasa los dos a la comprobación.

Clientes de máquina

En Clientes de máquina, selecciona Crear cliente y elige su Acceso (Lectura, Propuesta) y su Método de inicio de sesión: Clave privada (recomendado) o Secreto de cliente. Ningún acceso permite 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 con arex_sk_prod_ o arex_sk_sandbox_, así que 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 TI, A-REX describe su API en OpenAPI 3.1 y cada evento de webhook en AsyncAPI 3.0. Ambas se generan a partir de la propia plataforma, así que coinciden con lo que acepta y envía. Tus desarrolladores pueden pedir los archivos actuales en Soporte y luego 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, una finca o un producto por tu código, y los mensajes pueden incluirlo. Tu ERP nunca tiene que aprender los identificadores de A-REX.

Importación de archivos

Estamos agregando a Integraciones la importación de archivos (CSV) de recepciones de cosecha, entregas, resultados de laboratorio y entradas del directorio. Primero revisa cada fila y lista los errores; luego crea aprobaciones pendientes, nunca cambios directos.

Practica en un sandbox

Prueba todo antes de que lo use tu empresa de producción:

• Crea 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: aprueba una cosecha de práctica y mira cómo llega el mensaje real. Los operadores pueden agregar endpoints ahí; en una empresa de producción, los endpoints necesitan a un propietario o un administrador con verificación en dos pasos.
• En un endpoint, selecciona Enviar un evento de ejemplo para enviar un ejemplo firmado, marcado como ejemplo, y ver exactamente la solicitud y la respuesta.
• La ejecución de prueba de una automatización solo simula sus mensajes: nada llega a tus sistemas reales. Lee Automatiza el trabajo de rutina.