Ordenes de venta
¡Su guía para la integración de V5!
La integración de órdenes de venta (SO) entre V5 Traceability y el sistema ERP de un cliente permite que los detalles del pedido, las líneas de pedido y la información de programación se envíen a V5 Traceability. V5 también puede actuar como maestro de datos en este caso y enviar las órdenes creadas dentro del sistema al ERP.
Luego, estos pedidos se pueden recibir a través del software V5 WMS, después de lo cual información como las cantidades recogidas y enviadas, la ubicación y las asignaciones de contenedores/palets se pueden enviar de vuelta al ERP.
Más información sobre cómo funciona el módulo de órdenes de venta 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 ‘Sales Orders’ más antigua y ‘Sales Order Lines’ A lo que vemos en el Centro de control, podemos ver que el panel superior aquí es para Órdenes de venta, donde se pueden importar clientes, fechas de pedidos y entrega, números de referencia externos, etc.
El panel inferior es donde podemos agregar nuestras líneas de pedidos de ventas, que contienen datos relevantes para los productos, las cantidades y el costo de las líneas de pedido.
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 dónde se seleccionan los elementos del SO cuando se procesa el SO. Estos datos formarán parte de los datos exportados que podremos recibir del V5 Gateway.
2. Enlaces API
Para obtener más información sobre las definiciones de las clases de bases de datos que se pueden utilizar para órdenes de venta, consulte los siguientes enlaces:
3. Plantilla de integración
Se puede descargar la plantilla de integración para Órdenes de Venta aquí.
4. Guía de campo de órdenes de venta
4.1. Claves primarias
Las claves primarias son el identificador único para cada tabla dentro de la API V5. Para SalesOrders, esto es:
salesOrder.orderNumber – el número SO.
Para SalesOrderLines, la clave principal es ya sea:
salesOrder.orderNumber + commodity.code – el número SO junto con el producto a 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. Esto es necesario si el pedido incluye más de una línea del mismo producto.
4.2. Campos requeridos
Otros campos que SG requiere para completar un formulario válido ‘SalesOrderLine’ en el Centro de control son:
quantity – la cantidad de ese bien/producto que se vende.
4.3. Campos preferidos
Los campos preferidos sirven para agregar más datos al pedido de ventas y, aunque no son obligatorios, son útiles cuando se trata de funcionalidad dentro de Trazabilidad V5. Si usa el ‘SalesOrderLine’ punto final lo ideal sería agregar:
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.
salesOrder.orderNumber – si no se usa como clave principal arriba, este campo debe incluirse.
salesOrder.customer.code – el código único utilizado para identificar al cliente.
salesOrder.placedDate – la fecha en que se realizó el pedido.
salesOrder.deliveryDate – la fecha prevista de entrega del pedido.
Tenga en cuenta que para los últimos 4 de estos puntos estamos atravesando hasta el ‘SalesOrder’ clase de ‘SalesOrderLine’. Si en lugar de eso estuviéramos usando el ‘SalesOrder’ clase que simplemente podríamos eliminar ‘salesOrder’ de las 4 entradas anteriores.
4.4. Campos Adicionales
También se pueden incluir campos adicionales, como por ejemplo ‘SalesOrderLine’:
salesOrder.referenceNumber – cualquier nota/referencia adicional relacionada con el SO.
5. Metodología
Dada la naturaleza de la ‘SalesOrder’ más antigua y ‘SalesOrderLine’, podemos optar por importar y administrar datos de diferentes maneras:
- Podemos usar el ‘SalesOrder’ punto final para importar pedidos de ventas y luego, como veremos a continuación, atravesar hasta el ‘SalesOrderLine’ 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 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 usar para modificar la información del encabezado del pedido de ventas.
- Podemos usar el ‘SalesOrderLine’ punto final para modificar o agregar líneas una vez que se ha 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 del pedido de ventas (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.).
5.1. JSON – Importar
Órdenes de venta:
‘SalesOrder’ importar punto final/URI –
http://host:port/V5-API/api/integrate/import/sales
Para esta importación de muestra, usaremos el ‘SalesOrder’ 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 ‘SalesOrder’ punto final para este formato, dada la capacidad de los archivos JSON para contener datos anidados, lo que nos permite incluir sangría ‘SalesOrderLine’ 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.
Líneas de orden de venta:
‘SalesOrderLine’ importar punto final/URI –
http://host:port/V5-API/api/integrate/import/sales_line
También podemos usar el ‘SalesOrderLine’ punto final para agregar o editar líneas de un pedido existente. También podemos agregar Órdenes de Venta usando este punto final, pero es importante recordar que solo podemos editar un encabezado de Orden de Venta usando el ‘SalesOrder’ URI. Tenga en cuenta también que la información SO debería anidarse aquí para cada línea SO.
Podemos ver un ejemplo de un ‘SalesOrderLine’ Archivo JSON a continuación, donde agregaremos otra línea de pedido al pedido. ‘SO-8471’ que creamos arriba:
Este archivo JSON de muestra se puede descargar aquí.
Luego podremos ver en el Centro de control que nuestro pedido ha sido importado junto con la línea adicional que acabamos de agregar. Tenga en cuenta que información como la fecha de colocación/entrega y el número de referencia se importó del original ‘SalesOrder’ .
5.2. JSON – Exportar
En términos de recibir archivos relacionados con pedidos de ventas desde la API V5, si verificamos los resúmenes de métodos en 'Integración Exportación'servicio, entonces tenemos algunas opciones diferentes aquí:
Ordenes de venta:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/sales_orders
Este punto final exportará archivos JSON de pedidos de ventas completos utilizando la clase de base de datos de pedidos de ventas e incluirá todos los pedidos de ventas que aún no hayan sido marcados como exportados por el sistema. Esto proporcionará un retorno para cada punto de datos en el ‘SalesOrder’ clase, además de incluir cualquier información de selección de los artículos enviados.
Se puede descargar un archivo JSON de ejemplo de este tipo. aquí.
Órdenes de venta:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/sales_order/{ordernumber}
Este punto final exportará archivos JSON de pedidos de ventas completos utilizando la clase de base de datos de pedidos de ventas, 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 proporcionará un retorno para cada punto de datos en el ‘SalesOrder’ clase, además de incluir cualquier información de selección de los artículos enviados.
Podemos ver el inicio de un ejemplo de exportación de este tipo a continuación:
Este archivo JSON de ejemplo se puede descargar aquí.
Registros de pedidos de ventas:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/sales_logs
Este punto final se puede utilizar para recuperar una lista de registros de pedidos de ventas relacionados con eventos que surgen durante el envío de pedidos de ventas. Esto hace uso de la ‘SystemLog’ clase de datos para proporcionar datos transaccionales, como descriptores del sistema. El punto final solo proporciona estos datos para los pedidos completados que no se han marcado como exportados.
Se puede descargar un archivo JSON de ejemplo de este tipo. aquí.
Registro de pedidos de ventas:
Exportar punto final/URI –
http://host:port/V5-API/api/integrate/export/sales_log/{id}
Este punto final funciona de la misma manera que los 'Registros de pedidos de ventas' anteriores, pero se puede utilizar para devolver la información de un número de registro específico, según lo definido por el sistema V5. Como antes, esto hace uso de la ‘SystemLog’ clase de datos para proporcionar datos transaccionales, como descriptores del sistema. El punto final solo proporciona estos datos para los registros de pedidos completados que no se han marcado como ya exportados.
Podemos ver el inicio de un ejemplo de exportación de este tipo a continuación:
También podemos utilizar un puntos finales transaccionales y de registro para recuperar información más relevante sobre mercancías y productos vendidos en Órdenes de Venta.
Tenemos uno Transaccional/Genérico punto final que podemos usar aquí:
5.3. CSV – Importar
Tenga en cuenta que para las importaciones CSV, normalmente usaríamos solo el ‘SalesOrderLine’ punto final, lo que nos permite generar órdenes de venta y sus líneas de pedido mediante el uso de una única importación csv.
Nombre de archivo de definición de encabezado/columna: “salesOrderLine.csvh”
Los archivos de encabezado completos deben colocarse en: “<installdir>\SG Control Center\gateway\import\column_defs”
Importar nombre de archivo CSV: “salesOrderLine-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 pedidos de ventas 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 un orden similar al 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 estos pedidos, junto con las líneas de pedido requeridas, se agregaron al Centro de control. Tenga en cuenta que si el ‘Date Placed’ 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 pedidos de ventas a través de este método, esto formaría parte de un ‘SalesLog’ exportar. Podemos ver las definiciones de clase para este punto final. aquí.
Nombre de archivo de definición de encabezado/columna: “SalesLog.csvh”
Los archivos de encabezado completos deben colocarse en: “<installdir>\SG Control Center\gateway\export\order”
Exportar nombre de archivo CSV: “SalesLog-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. Esto sería simplemente un caso de comprobar el ‘Sales Order’ y asegúrese de aplicar la configuración y reiniciar el Centro de control.
Archivo de cabecera:
Podemos usar puntos de datos como ‘user’, ‘timestamp’ más antigua y ‘quantity’ en esta parte superior ‘Sales Log’, nivel, pero luego también podemos usar las páginas Pedido de venta y Línea de pedido de venta para desarrollar aún más la información que necesitamos, como el número de pedido, los artículos vendidos y de dónde fueron seleccionados. Tenga en cuenta que aquí el ‘SalesOrder’ Se debe acceder a la clase a través del ‘Line’ clase, como se muestra en el siguiente ejemplo
En un nivel muy básico, nuestra parte del ‘Sales Log’ El encabezado que trata con nuestras Órdenes de Venta podría verse así:
Este archivo de encabezado de muestra se puede descargar aquí.
Archivo de exportación CSV:
Con nuestro encabezado en su lugar y la exportación habilitada, posteriormente obtendremos un archivo de devolución para este pedido (junto con cualquier otro pedido no exportado previamente) que se verá así:
Este archivo de exportación de muestra se puede descargar aquí.
