Puntos finales de transacciones y registros
¡Su guía para la integración de V5!
Introducción
Además de los puntos finales de exportación vistos hasta ahora en nuestras guías de integración V5, la API V5 también presenta varios puntos finales transaccionales que se pueden usar para devolver descriptores de eventos del sistema/logs a un ERP externo.
Índice
1. Puntos finales del registro del sistema
Se pueden utilizar puntos finales genéricos para devolver una amplia gama de descriptores a través de una serie de diferentes módulos.
Estos puntos finales devolverán datos más complejos que los puntos finales transaccionales/genéricos y, a menudo, contendrán múltiples conjuntos de datos anidados relacionados con eventos de descriptores. Si bien esto es útil en el sentido de que se devolverán los datos correctos, a menudo será necesario filtrar estos puntos finales para aprovechar mejor los datos devueltos.
Podemos ver cuáles son para la API V5 a continuación:
1.1. Registros del sistema
Punto final/URI –
http://host:port/V5-API/api/integrate/export/system_logs
Este punto final proporcionará un archivo de retorno JSON que incorpora todos evento del sistema descriptores y los datos que les conciernen. Si llegamos a este punto final, obtendremos un resultado similar a este:
Entonces podemos ver aquí que, aunque recibimos el descriptor 'CONSUMIDO' hacia la parte inferior de esta imagen para algunos hilos de azafrán que se usan para un lote, también recibimos muchos datos anidados adicionales, como un retorno de clase completo para el proveedor y ubicación que podemos ver aquí.
Se pueden configurar filtros dentro de su ERP para seleccionar selectivamente los datos que desea ver.
Este archivo de ejemplo se puede descargar aquí.
Útil para:
1.2. Registro del sistema
Punto final/URI –
http://host:port/V5-API/api/integrate/export/system_log/{id}
Este punto final proporcionará un archivo de retorno JSON estructurado de manera similar a la exportación de 'Registros del sistema' anterior, pero aquí podemos especificar un número de ID de registro individual para devolver la información asociada. Esto es útil si queremos centrarnos en un evento específico o descriptor.
Se puede descargar un ejemplo de este tipo de archivo. aquí.
Útil para:
1.3. Registros del sistema de ajuste
Punto final/URI –
http://host:port/V5-API/api/integrate/export/adjustment_logs
Este punto final devolverá un archivo JSON con una lista de eventos de registro del sistema con el 'AJUSTE' descriptor, reduciendo el retorno de lo que hemos visto anteriormente para 'Registros del sistema' a entradas que contienen solo este descriptor. Esto ayuda a proporcionar datos más relevantes para que el ERP los procese según sus necesidades.
Se puede descargar un ejemplo de este tipo de archivo. aquí.
Útil para:
1.4. Registros del sistema consumidos/producidos:
Punto final/URI –
http://host:port/V5-API/api/integrate/export/system_logs_cp
Este punto final devolverá un archivo JSON con una lista de eventos de registro del sistema con "CONSUMED" o "PRODUCED". descriptor, reduciendo el retorno de lo que hemos visto anteriormente para 'Registros del sistema' a las entradas que contienen estos descriptores. Estos registros pertenecen al proceso principal de procesamiento por lotes, específicamente a la reducción y producción de inventario. Esto ayuda a proporcionar datos más relevantes para que el ERP los procese según sus necesidades.
Se puede descargar un ejemplo de este tipo de archivo. aquí.
Útil para:
1.5. Registros del sistema no consumidos/producidos:
Punto final/URI –
http://host:port/V5-API/api/integrate/export/system_logs_noncp
Este punto final actúa efectivamente como el inverso del punto final 'Registros del sistema consumidos/producidos' anterior y devolverá un archivo JSON que enumera los registros del sistema con cualquier cosa que no sea 'CONSUMIDO' o 'PRODUCIDO'. descriptores.
Útil para:
1.6. Registros de uso
Punto final/URI –
http://host:port/V5-API/api/integrate/export/batch_system_logs
Este punto final devolverá un archivo JSON con una lista de eventos de registro del sistema relacionados con el procesamiento por lotes, reduciendo el retorno de lo que hemos visto anteriormente para 'Registros del sistema' a entradas que contienen descriptores como 'CLASIFICADO', 'LOTE SUSPENDIDO', etc. (así como 'CONSUMIDO' y 'PRODUCIDO'). Esto ayuda a proporcionar datos más relevantes para que el ERP los procese según sus necesidades.
Se puede descargar un ejemplo de este tipo de archivo. aquí.
Útil para:
1.7. Registros de uso (filtrar fecha)
Punto final/URI –
http://host:port/V5-API/api/integrate/export/batch_system_logs/filterFrom/{filterDate}
Este punto final devuelve la misma información que los 'Registros de uso' anteriores, pero permite un filtro desde la fecha (marca de tiempo de época) para limitar los resultados si se desea.
Útil para:
1.8. Registros de trabajo
Punto final/URI –
http://host:port/V5-API/api/integrate/export/job_logs
Este punto final proporcionará un archivo de retorno JSON que incorpora el sistema descriptores relacionados con la producción de empleo.
Se puede descargar un archivo de ejemplo de este tipo. aquí.
Útil para:
2. Puntos finales transaccionales/genéricos
Los puntos finales transaccionales se utilizan para devolver información simplificada sobre descriptor eventos que pertenecen más específicamente a cómo varios módulos gestionan los niveles de inventario. A diferencia de los puntos finales genéricos que hemos visto anteriormente, que proporcionan una variedad de datos anidados, estos puntos finales proporcionan información simplificada sin datos anidados.
Podemos ver cómo se vería esto en nuestros ejemplos a continuación:
2.1. Transacciones de ajuste
Punto final/URI –
http://host:port/V5-API/api/integrate/export/transactions/adjustments
Este punto final se puede utilizar para proporcionar una lista de transacciones de ajuste que han ocurrido en el sistema. Al utilizar este punto final, obtendremos una entrada cada vez que se cambie (o ajuste) la cantidad de un lote mediante el Centro de control o WMS. Esto podría deberse a daños o productos vencidos que deben retirarse del sistema.
Un ejemplo de exportación de este tipo podría verse así:
Como podemos ver aquí, esta es una entrada única para un 'AJUSTE' descriptor evento, y no contiene ninguno de los datos anidados potencialmente superfluos que vimos con el punto final genérico.
Se puede descargar un archivo de ejemplo de este tipo. aquí.
Útil para:
2.2. Transacciones de consumo por lotes
Punto final/URI –
http://host:port/V5-API/api/integrate/export/transactions/batching/{completedBatches}
Una exportación de transacciones de consumo por lotes proporcionará un archivo JSON simplificado que proporciona consumo y producción. descriptor datos relevantes para un lote específico y completado que ha sido procesado por el sistema.
Usando este punto final, obtendremos un retorno que muestra todos los productos básicos que se han consumido en el procesamiento por lotes, y también cuántos lotes se produjeron posteriormente.
Se puede descargar un ejemplo de este tipo de archivo. aquí.
Útil para:
2.3. Transacciones de consumo por lotes (fecha de filtrado)
Punto final/URI –
http://host:port/V5-API/api/integrate/export/transactions/batching/filterfrom/{filterDate}
Este punto final devuelve la misma información que el 'Consumo por lotes' anterior, pero permite un filtro desde la fecha (marca de tiempo de época) para limitar los resultados si se desea.
Útil para:
2.4. Transacciones de órdenes de compra
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/transactions/purchase
Una exportación de transacciones de compra desde este punto final proporcionará un archivo JSON simplificado que proporciona datos de recepción relevantes para las órdenes de compra, incluidos descriptores del sistema como "RECIBIDO".
El punto final solo proporciona estos datos para los pedidos completados que no se han marcado como exportados.
Se puede descargar un ejemplo de este tipo de archivo. aquí.
Útil para:
2.5. Transacciones de órdenes de venta
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/transactions/sales/{true/false}
Una exportación de transacciones de ventas desde este punto final proporcionará un archivo JSON simplificado que proporciona datos de asignación/recogida/envío relevantes para los pedidos de ventas. El uso de este punto final devolverá datos relacionados con todos los artículos vendidos a través de pedidos de venta y descriptores como "SELECCIONADO" y "ENVIADO".
El punto final puede proporcionar estos datos para los pedidos completados (verdadero) o todos los pedidos (falso), siempre que estos pedidos aún no se hayan marcado como exportados.
Se puede descargar un ejemplo de este tipo de archivo. aquí.
Útil para:
