Integración de entrada simple
Note: Este es un artículo altamente técnico. Por tanto, recomendamos implicar a su departamento de TI al leerlo. Si tiene alguna consulta o solicitud, póngase en contacto con nosotros a través de support@azumuta.com - estaremos encantados de ayudarle.
¿Qué es Simple Entry Integration?
Un caso de uso común de Simple Entry Integration es la navegación automática hacia ó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 en ella inmediatamente en su dispositivo.
Para habilitar esto, hemos creado una Simple Entry Integration genérica, disponible en la sección “Integrations” de los ajustes de su empresa. A continuación se explica cómo acceder a esta sección.
- Haga clic en “Settings” bajo “Management”.
- Haga clic en “Integrations” bajo “Integrations”.
La URL rellenada por defecto /api/integrations/generic/v1/getOrderByBarcode es una implementación genérica del proceso de simple entry. Esta configuración permite un flujo sencillo en el que el escaneo y la introducción de 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 funcionalidad más avanzada, como crear automáticamente una orden de producto que aún no exista, consulte esta sección.
Tras configurar una Simple Entry Integration en los ajustes de su empresa, actualice la configuración del dispositivo donde desea usarla. Vaya a the Product orders tab y revise detenidamente los ajustes resaltados a continuación:
Cómo crear una Simple Entry Integration 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 simple entry, enviará una solicitud a la URL especificada en el campo “simpleEntryEndpoint”. El campo de configuración puede dejarse en blanco.
Tras escanear un código de barras en el dispositivo configurado, nuestro servicio enviará una solicitud GET a la URL proporcionada 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 se codificará en la URL
Además, los encabezados de la solicitud contendrán una x-api-key que puede usar para autenticarse con la Azumuta REST API.
Ejemplo de solicitud
Solicitud:
url:
encabezados: { x-api-key:
Tras 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 una orden de producto automáticamente
Una solicitud frecuente que recibimos de 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 con una sola llamada al Products Create REST API: https://app.azumuta.com/docs/api/products/create
Puede realizar una solicitud POST para crear un endpoint de producto utilizando 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 — Activará 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.