Integración ERP

Actualizado

Nota: Este es un artículo de carácter altamente técnico. Por ello, le recomendamos involucrar a su departamento de TI al leerlo. Si tiene alguna consulta o solicitud, por favor contáctenos a través de support@azumuta.com; estaremos encantados de ayudarle.

Integración de Azumuta con un sistema ERP

Es posible integrar Azumuta con un sistema ERP externo. Con mayor frecuencia, esta integración se utiliza para la creación automática de órdenes de producto en Azumuta, basada en los datos de pedidos de producto suministrados por el sistema ERP.

¿La ventaja? Sus órdenes de producto pueden crearse automáticamente en Azumuta en un instante (incluidos sus parámetros, variantes, y cualquier otro dato importante) — sin intervención manual.

La integración entre Azumuta y un sistema ERP suele utilizar REST API y comprende varios pasos. Tenga en cuenta que los detalles pueden variar según sus necesidades y el sistema ERP que utilice.

A continuación se presenta un esquema general del proceso:

  1. Comprender los requisitos: Identifique los datos y procesos específicos que deben integrarse entre Azumuta y el sistema ERP. Un ejemplo básico es la creación automática de órdenes de producto basada en la información procedente del ERP.
  2. Autenticación y autorización: Asegúrese de disponer de las credenciales y permisos necesarios para acceder a la REST API tanto de Azumuta como del sistema ERP. La autenticación con Azumuta se realiza mediante API keys.
  3. Revisar la documentación de la API: Obtenga y revise la documentación de la API de Azumuta y la del sistema ERP. Dicha documentación proporcionará detalles sobre los endpoints disponibles, formatos de request/response y los requisitos de autenticación.
  4. Acordar el mapeo de datos: Mapee los campos y estructuras de datos entre Azumuta y el ERP. Asegúrese de que exista un entendimiento común sobre cómo se representarán e intercambiarán los datos. Para el ejemplo básico de creación de órdenes de producto, esto se reduce a las siguientes preguntas: ¿Cómo se determina el número de orden de producto? ¿Sobre qué artículos se crean las órdenes de producto? ¿Qué parámetros o variantes se envían junto con la orden de producto recién creada?
  5. Desarrollo: Desarrolle el middleware o los conectores para facilitar la comunicación entre Azumuta y el sistema ERP. Normalmente llamamos a esto la capa de integración, que actúa como una “capa de pegamento” entre Azumuta y el ERP.

A continuación se muestra una representación esquemática de la creación de órdenes de producto basada en la información procedente del sistema ERP.

documentación: integración de Azumuta con un sistema ERP

Uso de triggers para recuperar datos de Azumuta

Existen dos opciones para extraer datos de Azumuta. Por un lado, es posible ejecutar triggers de forma automática. Un trigger es un evento que ocurre como consecuencia de otro evento. Por ejemplo, se llamará a un webhook después de que un operador haya completado una orden de producto. Preferimos este método porque solo se intercambian los datos necesarios en el momento deseado.

Por otro lado, es posible recuperar datos periódicamente a través de nuestra REST API. Este método se desaconseja enérgicamente porque genera una carga innecesaria en nuestros sistemas.

Mostraremos la primera opción, ya que es el método recomendado. Los triggers pueden configurarse para una categoría de artículo y ejecutarse cuando ocurre un evento específico.

En el ejemplo siguiente, se llama a un webhook cuando se completa una orden de producto vinculada a una categoría de artículo concreta.

documentación: uso de triggers para recuperar datos

Para asegurarse de que el webhook funcione, los servidores de Azumuta necesitan acceso al endpoint configurado. El número de orden de producto y, si procede, la instrucción de trabajo y los ID de registro se incluyen como parámetros de consulta (para una solicitud GET) o como JSON (en caso de una solicitud POST) en el webhook. Cada llamada al webhook también incluye un apiKey de un Api Device del workspace: necesita al menos un Api Device configurado para que los webhooks tengan éxito.

Para la configuración paso a paso (endpoint, GET/POST y payload POST personalizado opcional), consulte Calling a Webhook from a Trigger. Para la configuración de Api Device / API key, consulte Create and manage API keys.

Nota: Un webhook es la forma en que un sistema notifica a otro en tiempo real sobre eventos o actualizaciones. Es un método de comunicación entre dos aplicaciones, en el que una aplicación envía datos a un endpoint URL específico cuando ocurre un evento determinado. Los webhooks se usan comúnmente para integrar distintos sistemas y automatizar procesos.

Para emplear triggers en la transmisión de datos al sistema ERP, primero debe implementarse una capa de integración. La capa de integración se configura como el endpoint designado para el disparador del webhook. Este componente middleware es capaz de interpretar los eventos activados por Azumuta. Si es necesario, la capa de integración obtiene datos adicionales mediante la REST API para garantizar que exista la información adecuada para su transmisión al sistema ERP.

documentación: uso de triggers para recuperar datos 2