Materias primas
¡Su guía para la integración de V5!
La integración de productos básicos (ingredientes/embalaje/materias primas/SKU) entre V5 Traceability y el sistema ERP de un cliente permite que los detalles de los productos básicos, como costos, unidades, tiempos de vencimiento predeterminados, etc., se envíen a V5 Traceability.
Índice
1. Disposición del centro de control
En términos de cómo podemos relacionar los productos básicos con lo que vemos en Centro de Control, podemos ver que solo tenemos un único panel para completar aquí, la ventana principal de productos básicos.
Usando la puerta de enlace V5, podemos completar fácilmente los datos aquí usando un único punto final.
2. Enlaces API
Para obtener más información sobre las definiciones de estas clases de bases de datos, consulte el siguiente enlace:
3. Plantilla de integración
La plantilla de integración para Commodities se puede descargar aquí.
4. Guía de campo de productos básicos
4.1. Claves primarias
Las claves primarias son el identificador único para cada tabla dentro de la API V5. Para Commodities, esto es:
code – El código identificativo único de cada mercancía.
4.2. Campos requeridos
Otros campos que SG requiere para completar una línea de producto válida en Control Center son:
units.code – La unidad de medida de almacenamiento predeterminada de la mercancía.
type – El tipo de mercancía (ingrediente (0), fórmula (1) o empaque (2)).
recordStock – Si el uso de este producto debe ser rastreado por V5 Traceability (no registrado (0) o registrado (1)).
4.3. Campos preferidos
Los campos preferidos sirven para agregar más información sobre el producto en cuestión y, aunque no son obligatorios, son útiles cuando se trata de funciones adicionales dentro de la trazabilidad de V5.
description – La descripción de la mercancía.
bulkUnit - unidad a granel de la mercancía (por ejemplo, 'Bolsa' o 'Caja').
bulkQuantity – El monto de la unidad de medida predeterminada (unidades.código) de la mercancía entra en la unidad a granel anterior (por ejemplo, '20' para esto, y 'Bolsa' ingresada para la unidad a granel, con una unidad predeterminada de 'lb' significa en 1 bolsa de este producto hay 20 libras).
4.4. Campos Adicionales
También se pueden incluir campos adicionales, como:
cost – El costo predeterminado (por unidad) del producto básico.
defExpiryDays – Número predeterminado de días desde la recepción que un artículo de inventario de este tipo de mercancía se establecerá para caducar
gtin – El GTIN de la mercancía.
5. Metodología
Dado que solo usamos un único punto de conexión para esta clase de objeto, podemos utilizar el punto de conexión "commodity" para las importaciones y exportaciones de JSON y CSV. Ahora podemos ver esto a continuación.
5.1. JSON – Importar
Commodity:
‘Commodity’ importar punto final/URI –
http://host:port/V5-API/api/integrate/import/commodity
Para esta importación de muestra, usaremos el ‘Commodity’ endpoint, y estructurando un archivo de importación básico para un solo producto, esto podría verse así:
Este archivo JSON de muestra se puede descargar aquí.
Podemos ver aquí un ejemplo de uso de clases anidadas relacionadas con el ‘Commodity’ punto final En este caso hemos incluido la sangría ‘units’ y ‘bulkUnit’ puntos de datos, lo que nos permite definir tanto la unidad de medida predeterminada del producto como su unidad a granel. Dado que ambos hacen uso de la ‘WeightUnit’ clase, podemos usar el manual de la API V5 para guiarnos a estos puntos de datos usando la siguiente ruta:
Podemos construir el resto de nuestros puntos de datos requeridos utilizando un método de búsqueda de ruta similar para atravesar clases adicionales como ‘Location’ or ‘Container’ según sea necesario.
Si tuviéramos que importar el archivo de ejemplo anterior, veremos en el Centro de control que nuestra mercancía ha sido importada.
5.2. JSON – Exportar
En términos de recibir archivos relacionados con productos básicos de la API V5, si verificamos los resúmenes de métodos en el IntegrationExport clase, tenemos 2 opciones diferentes aquí:
Commodity:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/commodity/{code}
Este punto final exportará un archivo JSON con toda la información relacionada con un producto específico. Si ejecutamos esta solicitud utilizando el producto que acabamos de importar, obtendremos un archivo similar a este:
Se puede descargar un archivo JSON de ejemplo aquí.
Commodities:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/commodites/{all}
Este punto final exportará un archivo JSON que incluye una lista de toda la información relacionada para todos los productos básicos en el sistema según el valor de la {all} campo. Si esto es ‘true’ entonces tiraremos de todas las mercancías, mientras que si ‘false’ entonces solo obtendremos un retorno por nuevos productos básicos (es decir, productos básicos que no son marcado como ya exportado).
Si ejecutamos esta solicitud como true , obtendremos un archivo que se parece a esto:
Se puede descargar un archivo JSON de ejemplo aquí.
5.3. CSV – Importar
Nombre de archivo de definición de encabezado/columna: “commodity.csvh”
Los archivos de encabezado completos deben colocarse en: “<installdir>\SG Control Center\gateway\import\column_defs”
Importar nombre de archivo CSV: “commodity-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 lleven a cabo las integraciones de CSV, pero podemos ver un ejemplo básico de uno que podemos usar para los productos 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.
Un archivo de importación csv de ejemplo que usa el encabezado anterior podría verse así:
Este archivo de importación de muestra se puede descargar aquí.
Con la importación completa, podemos ver que estos productos se han agregado al Centro de control.
5.4. CSV – Exportar
Al exportar productos utilizando este método, usaríamos las mismas definiciones de clase que usamos para las importaciones, que podemos encontrar aquí.
Nombre de archivo de definición de encabezado/columna: “commodity.csvh”
Los archivos de encabezado completos deben colocarse en: “<installdir>\SG Control Center\gateway\export\order”
Exportar nombre de archivo CSV: “Commodity-datetime.csv”
Los CSV para las exportaciones se generarán en: “<installdir>\SG Control Center\gateway\export”
Esta exportación también debería estar habilitada en la sección Puerta de enlace del Centro de control. Podemos elegir aquí exportar solo ‘Ingredients’ (ingredientes/empaque), o fórmulas, o ambos. Aquí solo veremos la exportación ‘Ingredients’ :
Archivo de cabecera:
A partir de aquí, sería un caso simple estructurar nuestro archivo de encabezado de exportación para adaptarlo a la información que queremos recibir del sistema.
Podríamos estructurarlo de una manera muy similar a cómo estructuramos el encabezado de importación:
Este archivo de encabezado de muestra se puede descargar aquí.
Archivo de exportación CSV:
Con el encabezado anterior en su lugar, recibiríamos un csv de devolución de nuestras importaciones recientes que se vería así:
Este archivo de exportación de muestra se puede descargar aquí.
