Integración de entrada simple
Nota: Este es un artículo de carácter muy técnico. Por ello, recomendamos contar con la colaboración de su departamento de TI al leerlo. Si tiene alguna consulta o petición, 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 habitual de la integración de entrada simple es la navegación automática a órdenes de producción. Un operario puede escanear el código de barras de una orden de producción y su pantalla será redirigida automáticamente a dicha orden, de modo que pueda empezar a trabajar inmediatamente en ella desde su dispositivo.
Para activarlo, hemos creado una Integración de entrada simple genérica, disponible en la sección «Integraciones» de la configuración de la empresa. Así es como puede acceder a esta sección.
- Haga clic en «Configuración» dentro de «Gestión».
- Haga clic en «Integraciones» dentro de «Integraciones».
La URL rellenada por defecto /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 al escanear o introducir un identificador de orden de producción se abrirá la orden existente.
Nota: Esto solo funciona si la orden de producción 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 producción que aún no existe, consulte esta sección.
Tras configurar una Integración de entrada simple en la configuración de la empresa, actualice la configuración del dispositivo donde desea usarla. Vaya a la pestaña Órdenes de producción y revise detenidamente los ajustes marcados 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, puede crear una integración personalizada.
Cuando un dispositivo está configurado para usar la entrada simple, enviará una petición 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 petición GET a la URL proporcionada en el campo simpleEntryEndpoint.
La petición incluirá un parámetro de consulta llamado barcode, que representa el código escaneado o el dato introducido en el dispositivo.
Nota: El parámetro barcode estará codificado en la URL
Además, las cabeceras de la petición contendrán una x-api-key que puede usar para autenticarse con la Azumuta REST API.
Ejemplo de petición
Petición:
url:
headers: { 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 respuesta debe ser application/json.
Ejemplo de respuesta
{ identifier: “
Cómo crear automáticamente una orden de producción
Una petición frecuente de clientes es la posibilidad de crear automáticamente una orden de producción para el código escaneado (si la orden aún no existe).
Esto puede lograrse fácilmente con una única llamada a la REST API Products Create. Abra Ayuda (el signo de interrogación en la esquina superior derecha) → API docs, y abra el endpoint Products Create. Autentíquese con una API key de un Api Device. Más información sobre cómo acceder a la documentación: Azumuta’s REST API.
Puede realizar una petición POST al endpoint de creación de productos 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 producción ya exista.
activate: true — Activa automáticamente la orden de producción al crearla. Activar una orden de producción la hace visible en la interfaz del operario. Esta acción asegura que las instrucciones de trabajo asociadas queden bloqueadas en sus versiones aprobadas más recientes.