Dirección
¡Su guía para la integración de V5!
El punto final de importación 'Dirección' permite agregar direcciones a proveedores y clientes, las cuales se pueden utilizar para envíos y recepciones . También se pueden agregar direcciones como ' direcciones de sitio ' que se utilizan para transferencias.
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, debe ser 0 para su uso con Clientes y 1 para su uso como dirección de sitio para Transferencias (modlink).
Código de cliente : si se agrega una dirección de cliente, este campo es necesario para vincularla con el cliente/proveedor.
3.3. Campos Adicionales
Línea 1 – La primera línea de la dirección.
Línea 2 – La segunda línea de la dirección.
Línea 3 – La tercera línea de la dirección.
Ciudad – La ciudad donde se encuentra la dirección.
Estado – El estado en el que se encuentra la dirección.
País – El país donde 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 este paso, agregaremos una dirección al cliente que aparece en el panel CC de arriba. Este cliente se agregó previamente al sistema mediante el punto final " Cliente ".
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 ejemplo 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 del archivo de definición de encabezado/columna: “address.csvh”
Los archivos de encabezado completados deben colocarse en: “<installdir>\SG Control Center\gateway\import\column_defs”
Importar archivo CSV: “address-datetime.csv”
Los archivos CSV para importar deben colocarse en: “<installdir>\SG Control Center\gateway\import”
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 la página principal de integración . Este archivo de encabezado de ejemplo 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 ejemplo 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.
