Endereço
Seu guia para a integração V5!
O endpoint de importação 'Endereço' pode ser usado para adicionar endereços a fornecedores e clientes, que podem então ser usados para envio e recebimento . Os endereços também podem ser adicionados como ' endereços de local ' que são usados para Transferências.
Guias de integração vinculados:
Este guia se concentrará em como usar esse ponto de extremidade 'Endereço', tanto por meio da importação de CSV quanto usando JSON por meio da API V5.
Conteúdo
1. Layout do Centro de Controle
Em termos de como podemos relacionar o endpoint de endereço com o que vemos no V5 Control Center, veremos a tabela 'Customer' aqui. A tabela 'Supplier' funcionaria exatamente da mesma forma, já que tanto fornecedores quanto clientes compartilham o mesmo endpoint 'Client'.
2. Links API
Para saber mais sobre as definições desta classe de banco de dados 'Endereço', consulte o seguinte link:
3. Guia de campo de endereço
3.1. Chaves primárias
Para importar por meio do ponto de extremidade 'Endereço', a chave primária é:
Nome – O nome exclusivo para este endereço
3.2. Os campos obrigatórios
Outros campos necessários para criar uma entrada válida no V5:
Tipo – o tipo de endereço; este valor deve ser 0 para uso com Clientes e 1 para uso como endereço de site para Transferências (modlink).
Client_Code – Caso esteja adicionando um endereço de cliente, este campo é necessário para vinculá-lo ao cliente/fornecedor.
3.3. Campos Adicionais
Linha 1 – A primeira linha do endereço.
Linha 2 – A segunda linha do endereço.
Linha 3 – A terceira linha do endereço.
Cidade – A cidade onde o endereço está localizado.
Estado – O estado onde o endereço está localizado.
País – O país onde o endereço está localizado.
CEP – O código postal do endereço.
Contato – Um nome para contato associado ao endereço.
Tel – Número de telefone associado ao endereço.
E-mail – Endereço de e-mail associado ao endereço.
Endereços de entrega (se diferentes do endereço inserido usando os detalhes acima) e contatos/detalhes de recall de emergência também podem ser adicionados aqui, mas usaremos apenas os pontos de dados acima em nosso exemplo.
4. Conjunto de dados de exemplo
Nesta etapa, vamos adicionar um endereço ao cliente exibido no painel CC acima. Este cliente foi adicionado ao sistema anteriormente usando o endpoint ' Cliente '.
5. Metodologia
5.1. JSON – Importar
'Endereço' importar Endpoint/URI –
http://host:port/V5-API/api/integrate/import/address
amostras:
Usando o endpoint 'Address', podemos estruturar um arquivo de importação para as adições acima assim:
Este arquivo JSON de exemplo pode ser baixado aqui.
Depois de publicar isso no sistema, podemos ver que este endereço foi adicionado ao cliente 'CUS01':
5.2. CSV - Importar
Como clientes/fornecedores podem ter vários endereços atribuídos a eles, vamos simplesmente adicionar outro endereço ao cliente 'CUS01' que adicionamos no exemplo JSON acima.
Para importações de CSV, primeiro precisamos construir um arquivo de cabeçalho para nossas importações.
Nome do arquivo de definição de cabeçalho/coluna: “address.csvh”
Os arquivos de cabeçalho completos devem ser colocados em: “<diretório de instalação>\SG Control Center\gateway\import\column_defs”
Importar arquivo CSV com o nome: “address-datetime.csv”
Os arquivos CSV para importação devem ser colocados em: “<diretório de instalação>\SG Control Center\gateway\import”
amostras:
Arquivo de cabeçalho:
Um arquivo de cabeçalho de exemplo pode ser visto abaixo. Usaremos os mesmos campos que usamos para a importação JSON.
Para obter mais informações sobre como estruturamos esses arquivos, consulte a página principal de integração . Este arquivo de cabeçalho de exemplo pode ser baixado aqui.
Arquivo de importação CSV:
Podemos então usar a ordem definida de pontos de dados no cabeçalho para estruturar nosso arquivo de importação. Observe que essa primeira linha pode ser ignorada pelo Control Center e, portanto, pode ser mantida no arquivo ao enviar para importação. Um exemplo de importação com base em nossos requisitos acima ficaria assim:
Este arquivo de importação de exemplo pode ser baixado aqui.
Podemos então soltar esse arquivo em nossa pasta de importação, conforme definido acima, e quando a importação estiver concluída, poderemos ver que esse endereço foi adicionado ao mesmo cliente.
