Cliente (Proveedores y Clientes)
¡Su guía para la integración de V5!
El punto final de importación 'Cliente' se puede utilizar para crear proveedores y clientes dentro del sistema de Trazabilidad V5, que luego se pueden utilizar para recibir Ordenes de compra y barco Ordenes de venta respectivamente.
Guías de integración relacionadas:
Esta guía se centrará en cómo utilizar este punto final 'Cliente', tanto a través de la importación CSV como mediante JSON a través de la API V5.
Índice
1. Disposición del Centro de Control
En términos de cómo podemos relacionar el punto final del cliente con lo que vemos en el Centro de control V5, esto se relacionará tanto con 'Proveedores'Y'Clientes'ventanas. Así que para los proveedores:
Y para los clientes:
2. Enlaces API
Para obtener más información sobre las definiciones de este 'Cliente' y la clase de base de datos relacionada, consulte el siguiente enlace:
3. Guía de campo del cliente
3.1. Claves primarias
Para importar a través del punto final 'Cliente', la clave principal es:
Código – El código único del proveedor o cliente.
3.2. Campos requeridos
Otros campos que son necesarios para crear una entrada válida en V5:
Tipo – el tipo de cliente, este debe ser 0 para Proveedores y 1 para Clientes.
3.3. Campos Adicionales
Otras opciones aquí que podemos agregar desde la clase de base de datos 'Cliente' son:
Nombre – El nombre del proveedor/cliente.
Firma requerida – un 0 o 1 para indicar si se requiere o no firma al recibir/enviar al cliente.
También hay algunos campos adicionales que son específicos de Proveedores:
sitio web – El sitio web del proveedor.
Nombre de la moneda – para establecer la moneda que utiliza el proveedor.
Y para Clientes:
Descripción del conjunto de etiquetas – permite asignar un conjunto de etiquetas para su uso con los productos de ese cliente.
4. Conjunto de datos de ejemplo
Para este artículo, analizaremos la importación de 1 proveedor y 1 cliente para poder ver cómo funcionarán nuestras metodologías de importación en la práctica.
5. Metodología
5.1. JSON – Importar
Punto final/URI de importación 'Cliente' –
http://host:port/V5-API/api/integrate/import/client
muestras:
Usando el punto final 'Cliente', podemos estructurar un archivo de importación para agregar un proveedor y un cliente como se muestra a continuación:
Este archivo JSON de muestra se puede descargar aquí.
Una vez que hayamos publicado esto en el sistema, podremos ver que se ha agregado el nuevo proveedor:
Junto con el nuevo cliente:
5.2. CSV – Importar
Para las importaciones CSV, primero debemos construir un archivo de encabezado para nuestras importaciones.
Nombre de archivo de definición de encabezado/columna: “cliente.csvh”
Los archivos de encabezado completos deben colocarse en: “ \SG Control Center\gateway\import\column_defs”
Importar nombre de archivo CSV: “cliente-fecha-hora.csv”
Los CSV para la importación deben colocarse en: " \SG Control Center\puerta de enlace\importación”
muestras:
Archivo de cabecera:
A continuación se muestra un ejemplo de archivo de encabezado. Como en el caso anterior, agregaremos un cliente y un proveedor con los mismos parámetros:
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 los puntos de datos en el encabezado para estructurar nuestro archivo de importación. Tenga en cuenta que el Centro de control puede ignorar esta primera fila y, por lo tanto, puede conservarla en el archivo al enviarlo para su importación. Un ejemplo de importación basado en nuestros requisitos anteriores se vería así:
Este archivo de importación de muestra se puede descargar aquí.
Luego podemos colocar este archivo en nuestra carpeta de importación como se definió anteriormente, y una vez que se complete la importación, podremos ver una vez más que nuestro proveedor:
Y se han creado los clientes:
