Cliente (Fornecedores e Clientes)

O ponto de extremidade de importação 'Cliente' pode ser usado para criar fornecedores e clientes dentro do sistema de rastreabilidade V5, que pode então ser usado para receber Ordens de compra e navio Ordens de venda respectivamente.

Guias de integração relacionados:

Ordens de compra

Ordens de venda

Endereço 

Este guia se concentrará em como usar esse ponto de extremidade 'Cliente', tanto por meio da importação de CSV quanto usando JSON por meio da API V5.

1. Layouts do centro de controle
2. Links da API
3. Guia de campo do cliente
   1. Chaves Primárias
   2. Os campos obrigatórios
   3. Campos adicionais
4. Conjunto de dados de exemplo
5. Metodologia
   1. 1. JSON – Importar
      2. CSV - Importar

Em termos de como podemos relacionar o ponto de extremidade do cliente com o que vemos no V5 Control Center, isso se relacionará com ambos os 'Fornecedores 'E'Clientes' janelas. Então para Fornecedores:

E para os clientes:

Para saber mais sobre as definições para este 'Cliente' e a classe de banco de dados relacionada, consulte o seguinte link:

Clientes 

Para importar por meio do ponto de extremidade 'Cliente', a chave primária é:

Code - O código exclusivo do fornecedor ou cliente.

Outros campos necessários para criar uma entrada válida no V5:

Formato – o tipo de cliente, que deve ser 0 para Fornecedores e 1 para Clientes.

Outras opções aqui que podemos adicionar da classe de banco de dados 'Cliente' são:

Nome - O nome do fornecedor/cliente.

AssinaturaObrigatória - um 0 ou 1 para indicar se uma assinatura é necessária ou não ao receber/enviar do cliente.

Existem também alguns campos adicionais que são específicos para Fornecedores :

Website – O site do fornecedor.

Nome_da_moeda – para definir a moeda que o fornecedor utiliza.

E para Clientes:

Descrição do conjunto de rótulos – permite que um conjunto de etiquetas seja atribuído para uso com os produtos daquele cliente.

Neste artigo, veremos como importar 1 fornecedor e 1 cliente para que possamos ver como nossas metodologias de importação funcionarão na prática.

Importação de ponto final/URI do 'cliente' –

http://host:port/V5-API/api/integrate/import/client

Descrição do terminal

amostras:

Usando o endpoint 'Cliente', podemos estruturar um arquivo de importação para adicionar um fornecedor e um cliente conforme abaixo:

Este arquivo JSON de amostra pode ser baixado aqui..

Depois de publicar isso no sistema, podemos ver que o novo fornecedor foi adicionado:

Junto com o novo cliente:

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: “cliente.csvh”

Os arquivos de cabeçalho completos devem ser colocados em: “ \SG Control Center\gateway\import\column_defs”

Nome do arquivo CSV de importação: “cliente-datahora.csv”

Os CSVs para importação devem ser colocados em: “ \SG Control Center\gateway\importar”

amostras:

Arquivo de cabeçalho:

Um exemplo de arquivo de cabeçalho pode ser visto abaixo. Como acima, adicionaremos um cliente e um fornecedor com os mesmos parâmetros:

Para mais informações sobre como estruturamos esses arquivos, consulte o página principal de integração. Este arquivo de cabeçalho de amostra 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 amostra 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 novamente que nosso fornecedor:

E o cliente foi criado: