Traslados
¡Su guía para la integración de V5!
La integración de Transferencias entre V5 Traceability y el sistema ERP de un cliente permite que los detalles de la transferencia, las líneas de transferencia y la información de programación se envíen a V5 Traceability. Luego, estas transferencias se pueden enviar y recibir a través del software V5 WMS, después de lo cual información como qué lotes se enviaron y recibieron, cuánto se envió, en qué palet estaba, etc., se puede enviar de vuelta al ERP.
V5 también puede actuar como maestro de datos en este caso y enviar las transferencias creadas dentro del sistema al ERP.
Más información sobre cómo funciona el módulo de transferencias en V5 Trazabilidad, consulte nuestra guía del módulo aquí.
Índice
1. Disposición del centro de control
En términos de cómo podemos relacionarnos ‘Transfers’ y ‘Transfer Lines’ A lo que vemos en el Centro de control, podemos ver que el panel superior aquí es para las Transferencias, dónde se pueden importar desde/hacia los sitios, números de referencia externos, etc.
El panel inferior izquierdo es donde podemos agregar nuestras Líneas de transferencia, que contienen datos relevantes a los productos y cantidades requeridas para la transferencia.
Usando la puerta de enlace V5, podemos llenar fácilmente ambos paneles, ya sea por separado o juntos.
El panel inferior derecho contiene datos relacionados con el lugar desde donde se recogieron los artículos en la Transferencia en la ubicación "de" y se recibieron en la ubicación "a". Estos datos formarán parte de la exportación que podremos recibir del V5 Gateway.
2. Enlaces API
Para obtener más información sobre las definiciones de estas clases de bases de datos, consulte los siguientes enlaces:
3. Plantilla de integración
Se puede descargar la plantilla de integración para Transferencias aquí.
4. Guía de campo de transferencias
4.1. Claves primarias
Las claves primarias son el identificador único para cada tabla dentro de la API V5. Para Transfers, esto es:
reference – El número de referencia único de la transferencia. Básicamente, el número de orden de transferencia.
Para TransferLines, la clave principal es ya sea:
reference + commodity.code – La referencia/número de transferencia junto con la mercancía a transferir.
or
lineID – Para fines avanzados en los que el mismo producto puede aparecer en varias líneas, puede especificar un ID de línea como identificador único en lugar de la referencia de transferencia y el código del producto. Esto es necesario si hay más de una línea del mismo producto en la transferencia.
4.2. Campos requeridos
Otros campos que SG requiere para completar una entrada válida en el Centro de control son:
Para TransferLines:
quantityOrdered – la cantidad de esa mercancía que se pide.
Para Transfers:
fromLocation.code – la ubicación desde donde se enviará la transferencia.
toLocation.code – la ubicación a la que se enviará la transferencia.
4.3. Campos preferidos
Los campos preferidos sirven para agregar más datos a la transferencia y, aunque no son obligatorios, son útiles cuando se trata de funcionalidad dentro de Trazabilidad V5. Estos son:
lineID – si no se usa como clave principal arriba, este campo debe incluirse.
commodity.code – Si no se utiliza como clave principal arriba, este campo debe incluirse. El código del producto a transferir.
transfer.reference – si no se usa como clave principal arriba, este campo debe incluirse.
Lo anterior se aplica a 'transferLines'. Podemos aplicar los mismos campos a 'transfers' añadiendo ‘transferLine’ a las primeras 2 entradas, y eliminando ‘transfer’ del último.
4.4. Campos Adicionales
También se pueden incluir campos adicionales, como por ejemplo ‘transfer’:
comment – cualquier comentario adicional para la transferencia.
fromAddress – la dirección desde la que se envía la transferencia. Estos están poblados en ‘Site Addresses‘.
toAddress – la dirección en la que se recibe la transferencia.
directTransfer – si esta transferencia debería ser una transferencia directa o no.
Similar a lo anterior, si crea un 'transferLine’, simplemente podemos pasar a la clase de transferencia agregando ‘transfer’ al inicio de los parámetros anteriores.
5. Metodología
Dada la naturaleza de la ‘Transfer’ y ‘TransferLine’, podemos optar por importar datos de 2 formas:
- Podemos usar el ‘Transfer’ punto final para importar transferencias y luego, como veremos a continuación, atravesar hasta el ‘TransferLine’ class para luego incluir las líneas de pedido del componente, todo en un solo archivo. Esta es la forma más lógica de importar transferencias completas, ya que requiere solo 1 conjunto de información de encabezado y luego las siguientes líneas de pedido. Tenga en cuenta que este también es el único punto final que podemos usar para modificar la información del encabezado de la transferencia.
- Podemos usar el ‘TransferLine’ punto final para modificar o agregar líneas de transferencia una vez que se ha creado la transferencia. Esto aún se puede usar para importar transferencias completas, pero es menos eficiente ya que cada línea de transferencia necesitaría contener una referencia anidada al encabezado de la transferencia (como la referencia). Como se indicó anteriormente, este punto final no se puede utilizar para realizar cambios en la información del encabezado de la transferencia (referencia/hacia y desde ubicaciones, etc.).
Cuál de estos puntos finales usaremos dependerá en gran medida de si usamos una importación JSON o CSV. Ahora podemos ver estos a continuación.
5.1. JSON – Importar
Transfer del aeropuerto:
‘Transfer’ importar punto final/URI –
http://host:port/V5-API/api/integrate/import/transfer
Para esta importación de muestra, usaremos el ‘Transfer’ punto final y estructurar un archivo de importación básico de una transferencia con 2 líneas, esto podría verse así:
Este archivo JSON de muestra se puede descargar aquí.
Podemos ver por qué usaríamos el ‘Transfer’ punto final para este formato, dada la capacidad de los archivos JSON para contener datos anidados, lo que nos permite incluir sangría ‘TransferLines’ listas, y posteriormente ‘Commodity’ puntos de datos en la importación, que se pueden determinar utilizando el manual de la API de SG. por ejemplo, el ‘commodity code’ El punto de datos se puede encontrar utilizando la siguiente ruta en el manual de la API:
Podemos construir el resto de nuestros puntos de datos requeridos utilizando un método de búsqueda de ruta similar.
Usando el archivo anterior, podemos ver que nuestra nueva Transferencia se ha creado en el Centro de control.
Líneas de transferencia:
‘TransferLine’ importar punto final/URI –
http://host:port/V5-API/api/integrate/import/transfer_line
Como hemos comentado anteriormente, podemos utilizar el ‘TransferLine’ punto final para agregar o editar líneas de una transferencia existente. También podemos agregar Transferencias usando este punto final, pero es importante recordar que solo podemos editar un encabezado de Transferencia usando el ‘Transfer’ URI arriba. También tenga en cuenta que la información de Transferencia debería anidarse aquí para cada línea de Transferencia.
Podemos ver un ejemplo de un ‘TransferLine’ Archivo JSON a continuación, donde agregaremos otra línea para transferir ‘TR-1882’ que creamos arriba:
Este archivo JSON de muestra se puede descargar aquí.
Una vez que se haya publicado esta solicitud, podemos regresar al Centro de control y ver que se ha agregado una tercera línea a esta transferencia.
5.2. JSON – Exportar
En términos de recibir archivos relacionados con transferencias desde la API V5, si verificamos los resúmenes de métodos en la sección ‘IntegrationExport‘ clase, entonces tenemos algunas opciones diferentes aquí:
Transferencias:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/transfers
Este punto final exportará archivos JSON de transferencia completa utilizando la clase de base de datos de transferencia e incluirá todas las transferencias que el sistema aún no haya marcado como exportadas o que no hayan sido modificadas desde que se exportó por primera vez. Esto no incluirá ningún dato de movimiento de inventario, sino que proporcionará un retorno para cada punto de datos en el ‘Transfer’ clase.
Se puede descargar un ejemplo de este tipo de archivo JSON. aquí.
Transfer del aeropuerto:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/transfer/{referenceNumber}
Este punto final exportará archivos JSON de transferencia completa utilizando la clase de base de datos de transferencia, pero solo para la transferencia especificada y solo si el sistema aún no ha marcado esta transferencia como exportada. Como se indicó anteriormente, esto no incluirá ningún dato de movimiento de inventario, sino que proporcionará un retorno para cada punto de datos en el ‘Transfer’ clase.
Se puede descargar un ejemplo de este tipo de archivo JSON. aquí.
También podemos utilizar puntos finales transaccionales y de registro para recuperar información más relevante sobre los productos recibidos en Órdenes de Compra.
Para Transferencias, tenemos 1 Registro del sistema punto final que podemos utilizar:
Registros del sistema:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/system_logs
El uso de este punto final devolverá una lista completa de eventos de registro del sistema que no se han marcado como exportados previamente. Puede encontrar más información sobre este punto final aquí. Estos resultados se pueden filtrar para buscar transferencias específicas. descriptores, como ‘MOVED OUT/IN’, ‘PALLET MOVED OUT/IN’ y ‘PALLET TRANSFER OUT/IN’.
Se puede descargar un ejemplo de este tipo de archivo JSON. aquí.
5.3. CSV – Importar
Tenga en cuenta que para las importaciones CSV, normalmente usaríamos solo el ‘TransferLine’ endpoint, lo que nos permite generar Transferencias y sus líneas de pedido mediante el uso de una única importación csv.
Nombre de archivo de definición de encabezado/columna: “transferLine.csvh”
Los archivos de encabezado completos deben colocarse en: “<installdir>\SG Control Center\gateway\import\column_defs”
Importar nombre de archivo CSV: “transferLine-datetime.csv”
Los CSV para la importación deben colocarse en: “<installdir>\SG Control Center\gateway\import”
Archivo de cabecera:
Los archivos de encabezado generalmente serán compilados por SG Systems antes de que se realicen las integraciones CSV, pero podemos ver un ejemplo básico de uno que podemos usar para transferencias a continuación:
Para obtener más información sobre cómo estructuramos estos archivos, consulte el página principal de integración. Este archivo de encabezado de muestra se puede descargar aquí.
Archivo de importación CSV:
Luego podemos usar el orden definido de puntos de datos en el encabezado para estructurar nuestro archivo de importación. SG Systems puede proporcionar un archivo de plantilla para esto, enumerando el punto de datos para cada columna para aclarar las cosas al completar la lista. Tenga en cuenta que el Centro de control puede ignorar esta primera fila y, por lo tanto, puede conservarse en el archivo cuando se envía para importar.
Aquí podemos ver que nuestro objetivo es crear una transferencia similar a la que creamos usando la metodología JSON. Este archivo de importación de muestra se puede descargar aquí.
Una vez completada la importación, podemos ver que esta transferencia, junto con las líneas de pedido requeridas, se han agregado al Centro de control. Tenga en cuenta que si el ‘Created Date’ Los datos no están incluidos en la importación, la fecha colocada hará referencia a la fecha de hoy.
5.4. CSV – Exportar
Cuando se busca exportar información de transferencia a través de este método, esto formaría parte de un ‘SystemLog’ exportar. Podemos ver las definiciones de clase para este punto final. aquí.
Nombre de archivo de definición de encabezado/columna: “SystemLog.csvh”
Los archivos de encabezado completos deben colocarse en: “<installdir>\SG Control Center\gateway\export\order”
Exportar nombre de archivo CSV: “SystemLog-datetime.csv”
Los CSV para las exportaciones se generarán en: “<installdir>\SG Control Center\gateway\export”
Este punto final se puede utilizar para extraer una amplia variedad de datos atravesando los puntos de datos disponibles vinculados desde él.
Encabezamiento:
Podemos usar puntos de datos como ‘user’, ‘timestamp’ y ‘quantity’ en esta parte superior ‘System Log’ nivel, pero luego podemos atravesar hasta el ‘TransferLine’ clase para agregar campos como el número de referencia y mercancías que se solicitaron en la transferencia, así como a la ‘Stock’ clase para recuperar información como las ubicaciones de donde se movieron los elementos o hacia donde se movieron.
En un nivel muy básico, nuestra parte del encabezado del registro del sistema que trata con las transferencias podría verse así:
Este archivo de encabezado de muestra se puede descargar aquí.
Con este encabezado en su lugar, también debemos asegurarnos de haber seleccionado exportar. ‘System Logs’ en la pestaña de exportación de Gateway en Control Center.
Con nuestro encabezado en su lugar y la exportación habilitada (¡no olvide reiniciar el Centro de control para aplicar los cambios realizados en la puerta de enlace!), posteriormente obtendremos un archivo de devolución para esta transferencia (junto con cualquier otra transferencia no exportada previamente) que se parece a este:
