Ordenes de compra
¡Su guía para la integración de V5!
La integración de órdenes de compra entre V5 Traceability y el sistema ERP de un cliente permite que los detalles de la orden, los elementos de línea de la orden y la información de programación se envíen a V5 Traceability. Estos pedidos se pueden recibir a través del software V5 WMS, después de lo cual la información, como la cantidad recibida, la ubicación y las asignaciones de contenedores/palés, se puede enviar de vuelta al ERP.
Para obtener más información sobre cómo funciona el módulo de órdenes de compra en V5 Traceability, consulte nuestra guía de módulos aquí.
Índice
1. Disposición del centro de control
En términos de cómo podemos relacionar las órdenes de compra y las líneas de órdenes de compra con lo que vemos en el Centro de control, podemos ver que el panel superior aquí es para las órdenes de compra, donde los proveedores, las fechas de pedidos y entregas, las referencias de pedidos externos, etc., pueden todos sean importados.
El panel inferior es donde podemos agregar nuestras Líneas de orden de compra, que contiene datos relevantes para los productos básicos, las cantidades y el costo de las líneas de orden.
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 donde se seleccionan y almacenan los artículos en la orden de compra cuando se procesa la orden de compra. Estos datos formarán parte de los datos exportados que podemos recibir del 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
La plantilla de integración para Órdenes de Compra se puede descargar aquí.
4. Guía de campo de orden de compra
4.1. Claves primarias
Las claves primarias son el identificador único para cada tabla dentro de la API V5. Para Purchase Orders, esto es:
purchaseOrder.orderNumber – el número de orden de compra.
Para Purchase Order Lines, la clave principal es ya sea:
purchaseOrder.orderNumber + commodity.code – el número de orden de compra junto con el producto que se pedirá
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 del número de pedido y el código del producto.
4.2. Campos requeridos
Otros campos requeridos por SG para completar una línea de orden de compra válida en Control Center son:
quantity – la cantidad de esa mercancía que se pide.
4.3. Campos preferidos
Los campos preferidos sirven para agregar más datos a la orden de compra y, aunque no son obligatorios, son útiles cuando se trata de la funcionalidad dentro de V5 Traceability.
lineID – si no se usa como clave principal arriba, este campo debe incluirse.
commodity.code – si no se usa como clave principal arriba, este campo debe incluirse.
purchaseOrder.orderNumber – si no se usa como clave principal arriba, este campo debe incluirse.
purchaseOrder.supplier.code – el código único utilizado para identificar al proveedor.
orden de compra. fecha de colocación – la fecha en que se realizó el pedido.
purchaseOrder.deliveryDate – la fecha de entrega establecida para el pedido.
unit – la unidad de medida de la mercancía que se solicita.
4.4. Campos Adicionales
También se pueden incluir campos adicionales, como:
purchaseOrder.notes – cualquier nota para la orden de compra.
cost – el costo (por unidad) de la mercancía que se solicita.
5. Metodología
Dada la naturaleza de la PurchaseOrder más antigua y PurchaseOrderLine , podemos optar por importar datos de 2 formas:
- Podemos usar el punto final 'PurchaseOrder' para importar órdenes de compra y luego, como veremos a continuación, pasar a la clase 'PurchaseOrderLine' 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 pedidos completos, ya que requiere solo 1 conjunto de información de encabezado y luego las líneas de pedido posteriores. Tenga en cuenta que este también es el único punto final que podemos utilizar para modificar la información del encabezado de la orden de compra.
- Podemos utilizar el punto final ''PurchaseOrderLine' para modificar o agregar líneas una vez que se haya creado el pedido. Esto aún se puede usar para importar pedidos completos, pero es menos eficiente ya que cada línea de pedido necesitaría contener una referencia anidada al encabezado de la orden de compra (como el número de pedido). Como se indicó anteriormente, este punto final no se puede utilizar para realizar cambios en la información del encabezado del pedido (número de pedido/fechas de entrega, 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
Purchase Order:
‘PurchaseOrder’ importar punto final/URI –
http://host:port/V5-API/api/integrate/import/purchase
Para esta importación de muestra, usaremos el ‘PurchaseOrder’ endpoint, y estructurando un archivo de importación básico, esto podría verse así:
Este archivo JSON de muestra se puede descargar aquí.
Podemos ver por qué usaríamos el ‘PurchaseOrder’ punto final para este formato, dada la capacidad de los archivos JSON para contener datos anidados, lo que nos permite incluir sangría ‘PurchaseOrderLine’, 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.
Purchase Order Lines:
‘PurchaseOrderLine’ importar punto final/URI –
http://host:port/V5-API/api/integrate/import/purchase_line
También podemos usar el ‘PurchaseOrderLine’ punto final para agregar o editar líneas de un pedido existente. También podemos agregar órdenes de compra usando este punto final, pero solo podemos editar una orden de compra usando el ‘PurchaseOrder’ URI.
Podemos ver un ejemplo de un ‘PurcahseOrderLine’ JSON a continuación, donde agregaremos otra línea de pedido para ordenar 'PO-8471' que creamos anteriormente:
Este archivo JSON de muestra se puede descargar aquí.
Luego podemos ver en el Centro de control que nuestra PO se ha importado con la línea adicional que acabamos de agregar.
5.2. JSON – Exportar
En términos de recibir archivos relacionados con la orden de compra de la API V5, si verificamos los resúmenes de métodos en el IntegrationExport clase, entonces tenemos algunas opciones diferentes aquí:
Purchase Orders:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/purchase_orders
Este punto final exportará archivos JSON completos de pedidos de compra mediante la clase de base de datos de pedidos de compra e incluirá todos los pedidos de compra que el sistema aún no haya marcado como exportados. Esto no incluirá ningún dato de recepción, sino que proporcionará un retorno para cada punto de datos en el ‘PurchaseOrder’ clase.
Podemos ver el inicio de un ejemplo de exportación de este tipo a continuación:
Se puede descargar un archivo JSON de ejemplo aquí.
Purchase Order:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/purchase_order/{ordernumber}
Este punto de enlace exportará archivos JSON de pedidos de compra completos utilizando la clase de base de datos de pedidos de compra, pero solo para el pedido especificado, y solo si el sistema aún no ha marcado este pedido como exportado. Como se indicó anteriormente, esto no incluirá ningún dato de recepción, sino que proporcionará un retorno para cada punto de datos en el ‘PurchaseOrder’ clase.
Purchase Order Logs:
Exportar punto final/URI – http://host:port/V5-API/api/integrate/export/po_logs
Este punto final se puede usar para recuperar una lista de registros de pedidos de compra relacionados con eventos que surgen durante la recepción del pedido de compra y, a diferencia de los tipos anteriores, se puede usar para recuperar información como qué se recibió, cuánto y dónde se almacenó, etc. Esto hace uso de la ‘SystemLog’ clase de datos para proporcionar datos transaccionales adicionales, como descriptores del sistema. El punto final proporciona estos datos solo para pedidos completados, siempre que no se hayan marcado previamente como exportados.
Podemos ver el inicio de un ejemplo de exportación de este tipo a continuación:
Se puede descargar un archivo JSON de ejemplo aquí.
Purchase Order Transactions:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/po_transactions
Este punto final funciona de la misma manera que ‘Purchase Order Logs’ anterior, excepto que este punto final también proporcionará datos de pedidos que aún no están completos (es decir, pedidos en curso).
También podemos utilizar un puntos finales transaccionales y de registro para recuperar información más relevante sobre los productos recibidos en Órdenes de Compra.
Tenemos uno Transaccional/Genérico punto final que podemos usar aquí:
5.3. CSV – Importar
Tenga en cuenta que para las importaciones CSV, normalmente estaríamos usando el ‘PurchaseOrderLine’ punto final, lo que nos permite generar órdenes de compra y sus líneas de pedido mediante el uso de un solo archivo csv.
Nombre de archivo de definición de encabezado/columna: “purchaseOrderLine.csvh”
Los archivos de encabezado completos deben colocarse en: “ \SG Control Center\gateway\import\column_defs”
Importar nombre de archivo CSV:“purchaseOrderLine-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 las órdenes de compra 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 estamos importando 2 pedidos diferentes, uno con 2 artículos de línea y el otro con solo 1. Este archivo de importación de muestra se puede descargar aquí.
Con la importación completa, podemos ver que estos pedidos, junto con sus líneas de pedido, se agregaron al Centro de control. Tenga en cuenta que si los datos de 'Fecha de colocación' no se incluyen en la importación, la fecha de colocación hará referencia a la fecha de hoy.
5.4. CSV – Exportar
Al buscar exportar información de órdenes de compra 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 aquí.
Archivo de cabecera:
Podemos usar puntos de datos como ‘user’, ‘timestamp’ más antigua y ‘quantity’ en esta parte superior ‘System Log’ nivel, pero luego también podemos usar el ‘Purchase Order más antigua y ‘Purchase Order Line’ páginas para desarrollar aún más la información que requerimos, como el número de orden de compra, el producto comprado, dónde se almacenó, etc.
En un nivel muy básico, nuestra parte del encabezado del registro del sistema que se ocupa de nuestras órdenes de compra podría verse así:
Este archivo de encabezado de muestra se puede descargar aquí.
Archivo de exportación CSV:
Si seguimos adelante y recibimos la ‘Flour’ línea de pedido para el pedido 'PO-8472' anterior, nos daría la siguiente exportación, diciéndonos que esta harina se reservó en cantidades de 2x 250 lb y se almacenó por ‘SG User’ en el ‘GEN’ ubicación de existencias.
Este archivo de exportación de muestra se puede descargar aquí.
