Dirección
¡Su guía para la integración de V5!
El punto final de importación 'Dirección' se puede utilizar para agregar direcciones a proveedores y clientes, que luego se pueden usar para envío más antigua y aprovechaLas direcciones también se pueden agregar como 'direcciones del sitio' que se utilizan para Traslados.
Guías de integración vinculadas:
Esta guía se centrará en cómo utilizar este punto final 'Dirección', 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 cuanto a cómo podemos relacionar el punto final de la dirección con lo que vemos en el Centro de control V5, analizaremos la tabla "Cliente". La tabla "Proveedor" funcionaría exactamente de la misma manera, ya que tanto los proveedores como los clientes comparten el mismo punto final "Cliente".
2. Enlaces API
Para obtener más información sobre las definiciones de esta clase de base de datos 'Dirección', consulte el siguiente enlace:
3. Guía de campos de dirección
3.1. Claves primarias
Para importar a través del punto final 'Dirección', la clave principal es:
Nombre – El nombre único para esta dirección
3.2. Campos requeridos
Otros campos que son necesarios para crear una entrada válida en V5:
Tipo – el tipo de dirección, que debe ser 0 para usar con Clientes y 1 para usar como dirección de sitio para Transferencias (modlink).
Código de cliente – Si se agrega una dirección de cliente, esta es necesaria para vincularla con el cliente/proveedor.
3.3. Campos Adicionales
Line1 – La primera línea de la dirección.
Line2 – La segunda línea de la dirección.
Line3 – La tercera línea de la dirección.
Ciudad – La ciudad en la que se encuentra la dirección.
Estado – El estado en el que se encuentra la dirección.
País – El país en el que se encuentra la dirección.
Código postal – El código postal de la dirección.
Contacto – Un nombre de contacto para la dirección.
Tel – Número de teléfono asociado a la dirección.
Correo electrónico – Dirección de correo electrónico asociada a la dirección.
También se pueden agregar aquí las direcciones de envío (si son diferentes de la dirección ingresada con los detalles anteriores) y los contactos/detalles de retiro de emergencia, pero solo usaremos los puntos de datos anteriores en nuestro ejemplo.
4. Conjunto de datos de ejemplo
Para esta pieza, buscaremos agregar una dirección al cliente que se muestra en el panel CC de arriba. Este cliente se agregó al sistema anteriormente mediante el uso de 'Cliente' punto final.
5. Metodología
5.1. JSON – Importar
'Dirección' importar punto final/URI –
http://host:port/V5-API/api/integrate/import/address
muestras:
Usando el punto final 'Dirección', podemos estructurar un archivo de importación para las adiciones anteriores de la siguiente manera:
Este archivo JSON de muestra se puede descargar aquí.
Una vez que hayamos publicado esto en el sistema, podremos ver que esta dirección se ha agregado al cliente 'CUS01':
5.2. CSV – Importar
Dado que los clientes/proveedores pueden tener varias direcciones asignadas, simplemente agreguemos otra dirección al cliente "CUS01" que agregamos en el ejemplo JSON anterior.
Para las importaciones CSV, primero debemos construir un archivo de encabezado para nuestras importaciones.
Nombre de archivo de definición de encabezado/columna: “dirección.csvh”
Los archivos de encabezado completos deben colocarse en: “ \SG Control Center\gateway\import\column_defs”
Importar nombre de archivo CSV: “dirección-fechahora.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. Utilizaremos los mismos campos que para la importación JSON.
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 que esta dirección se ha agregado para el mismo cliente.
