Integración de entrada simple

Nota: Esta es una página de guía altamente técnica. Por lo tanto, recomendamos involucrar a su departamento de TI al leerla. Si tiene alguna consulta o petición, por favor contáctenos a través de support@azumuta.com - estaremos encantados de ayudarle.

¿Qué es la Integración de Entrada Simple?

Un caso de uso común de la integración de entrada simple es la navegación automática a órdenes de producto. Un operario puede escanear el código de barras de una orden de producto y su pantalla se redirigirá automáticamente a esa orden de producto, de modo que pueda comenzar a trabajar inmediatamente en ella desde su dispositivo.

Para habilitar esto, hemos creado una Integración de Entrada Simple genérica, disponible en la sección “Integrations” de los ajustes de su empresa. Así es como puede acceder a esta sección.

1. Haga clic en “Settings” bajo “Management”.
2. Haga clic en “Integrations” bajo “Integrations”.

La URL preconfigurada /api/integrations/generic/v1/getOrderByBarcode es una implementación genérica del proceso de entrada simple. Esta configuración permite un flujo sencillo en el que escanear e introducir un identificador de orden de producto abrirá una orden de producto existente.

Nota: Esto solo funciona si la orden de producto ya existe y el código escaneado coincide exactamente con el identificador del producto en Azumuta.

Si necesita una funcionalidad más avanzada, como crear automáticamente una orden de producto que aún no exista, consulte esta sección de la guía.

Después de configurar una Integración de Entrada Simple en los ajustes de su empresa, actualice los ajustes del dispositivo donde desee usarla. Vaya a la pestaña de Órdenes de producto y revise cuidadosamente los ajustes destacados a continuación:

Cómo crear una Integración de Entrada Simple personalizada

Si desea ampliar este proceso con su propia lógica de negocio personalizada, puede crear una integración personalizada.

Cuando un dispositivo esté configurado para usar la entrada simple, enviará una solicitud a la URL especificada en el campo “simpleEntryEndpoint”. El campo de configuración puede dejarse en blanco.

Después de escanear un código de barras en el dispositivo configurado, nuestro servicio enviará una petición GET a la URL indicada en el campo simpleEntryEndpoint.

La solicitud incluirá un parámetro de consulta llamado barcode, que representa el código escaneado o la entrada en el dispositivo.

Nota: El barcode estará codificado en la URL

Además, las cabeceras de la petición contendrán un x-api-key que puede usar para autenticarse con la Azumuta REST API.

Ejemplo de solicitud

Request:
url: ?barcode=
headers: { x-api-key:

Después de procesar su lógica personalizada, la integración debe responder con un objeto JSON que contenga el campo identifier. El Content-type de la solicitud debe ser application/json.

Ejemplo de respuesta

{ identifier: “” }

Cómo crear automáticamente una orden de producto

Una petición frecuente que recibimos de los clientes es la capacidad de crear automáticamente una orden de producto para el código escaneado (si la orden de producto aún no existe).

Esto se puede lograr fácilmente usando una única llamada a la Products Create REST API: https://app.azumuta.com/docs/api/products/create

Puede hacer una solicitud POST al endpoint de creación de producto usando los siguientes parámetros:

• returnExisting: true — Esto no creará un nuevo producto, sino que devolverá el producto existente en caso de que la orden de producto ya exista.

• activate: true — Active automáticamente la orden de producto al crearla. Activar una orden de producto la hace visible en la interfaz del operario. Esta acción garantiza que las instrucciones de trabajo asociadas queden bloqueadas en sus últimas versiones aprobadas.