Nota: Esta es una página web con una guía de carácter muy técnico. Por lo tanto, le recomendamos que consulte con su departamento de TI al leerla. Si tiene alguna duda o solicitud, póngase en contacto con nosotros a través desupport@old-old-wordpress.azumuta.com; estaremos encantados de ayudarle.
¿Qué es la integración simple de entrada? #
Un caso de uso común de la integración de entrada simple es la navegación automática a los pedidos de productos. Un operario puede escanear el código de barras de un pedido de producto y su pantalla se redirigirá automáticamente a ese pedido de producto, para que pueda empezar a trabajar inmediatamente en ese pedido de producto en su dispositivo.
Para ello, hemos creado una integración genérica de Simple Entry, disponible en la sección "Integraciones" de la configuración de su empresa. A continuación te indicamos cómo llegar a esta sección.
- Haga clic en "Configuración" en "Gestión".
- Haga clic en "Integraciones" en "Integraciones".
La URL /api/integrations/generic/v1/getOrderByBarcode preconfigurada es una implementación genérica del proceso de entrada simple. Esta configuración permite un flujo directo en el que escanear e introducir un identificador de pedido de producto abrirá un pedido de producto existente.
Nota: Esto sólo funciona si el pedido del 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 un pedido de producto que aún no existe, 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 utilizarla. Navegue hasta la pestaña Pedidos de productosy revise detenidamente los ajustes que se indican 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 utilizar la entrada simple, enviará una solicitud a la URL especificada en el campo "simpleEntryEndpoint". El campo config 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 denominado código de barras, que representa el código escaneado o introducido en el dispositivo.
Nota: El código de barras estará codificado en URL
Además, las cabeceras de la solicitud contendrán una clave x-api que podrá utilizar para autenticarse con la API REST de Azumuta.
Solicitud Ejemplo #
Request:
url: <simpleEntryEndpoint>?barcode=<barcode>
headers: { x-api-key: <Azumuta REST API key>
Después de procesar su lógica personalizada, la integración debe responder con un objeto JSON que contenga el campo identificador. El tipo de contenido de la solicitud debe ser application/json.
Ejemplo de respuesta #
{ identifier: “<identifier>” }
Cómo crear un pedido de producto automáticamente
Una petición común que recibimos a menudo de los clientes es la capacidad de crear automáticamente un pedido de producto para el código escaneado (si el pedido de producto no ha existido todavía).
Esto se puede lograr fácilmente con una sola llamada a la API REST de creación de productos: https://app.old-old-wordpress.azumuta.com/docs/api/products/create
Puede realizar una solicitud POST para crear un punto final de producto utilizando los siguientes parámetros:
- returnExisting: true - Esto no creará un nuevo producto pero devolverá el producto existente en caso de que el pedido del producto ya exista.
- activar: true - Activar automáticamente la orden de producto al crearla. La activación de una orden de producto la hace visible en la interfaz del operador. Esta acción garantiza que las instrucciones de trabajo asociadas estén bloqueadas en sus últimas versiones aprobadas.