Integração via CSV

Postado por Bruno Soares
3 de setembro de 2018

O Salescope Integrador pode ler um arquivo CSV e importar os resultados para um banco de dados próprio.

Para isso, você deve criar um arquivo CSV com os dados de seu ERP em um formato pré-determinado.

Este manual irá lhe auxiliar na criação deste arquivo.

Layout CSV

Seu arquivo CSV deve conter os dados de acordo com a tabela abaixo. Cada linha representa um item de nota ou item de pedido. As colunas não utilizadas devem ser enviadas em branco.

DescriçãoTam. máximoObrigatórioCol.Informação atrelada a
Número do pedido (ou NF)50Sim1Cabeçalho do pedido
Filial emissora502Cabeçalho do pedido
Estado2Sim3Cliente
Cidade50Sim4Cliente
Região505Cabeçalho do pedido
Gerente506Cabeçalho do pedido
Representante507Cabeçalho do pedido
Canal de distribuição508Cabeçalho do pedido
Segmento de mercado509Cabeçalho do pedido
Marca5010Produto
Linha5011Produto
Grupo5012Produto
Subgrupo5013Produto
Produto (código, nome ou ambos)50Sim14Produto
Cliente (razão ou nome fantasia)100Sim15Cliente
Informação adicional de pedido5016Cabeçalho do pedido
Dia de emissão da nota ou pedido2Sim17Cabeçalho do pedido
Mês de emissão da nota ou pedido 2Sim18Cabeçalho do pedido
Ano de emissão da nota ou pedido 4Sim19Cabeçalho do pedido
Valor total do item (já multiplicado pela quantidade) (*1)Campo numéricoSim20Item do pedido
Rentabilidade total do item (já multiplicada pela quantidade) (*1) Campo numérico21Item do pedido
Quantidade total (*1)Campo numéricoSim22Item do pedido
Litros (*1)Campo numérico 23Item do pedido
Quilos (*1)Campo numérico 24Item do pedido
Metros (*1)Campo numérico 25Item do pedido
CNPJ (8 primeiros dígitos) (*2) 8Sim26Cliente
CNPJ (4 dígitos após a barra) (*2) 4Sim27Cliente
Endereço (*3)150Sim28Cliente
CEP929Cliente
Telefone10030Cliente
Email10031Cliente
Observações adicionais50032Cliente
Valor monetário adicionalCampo numérico 33Item do pedido
Valor monetário adicional Campo numérico 34Item do pedido
Valor monetário adicional Campo numérico 35Item do pedido
Valor monetário adicional Campo numérico 36Item do pedido
Valor monetário adicional Campo numérico 37Item do pedido
Informação adicional de pedido5038Cabeçalho do pedido
Informação adicional de pedido 5039Cabeçalho do pedido
Informação adicional de pedido 5040Cabeçalho do pedido
Informação adicional de pedido 5041Cabeçalho do pedido
Informação adicional de pedido 5042Cabeçalho do pedido
Informação adicional de produto5043Produto
Informação adicional de produto 5044Produto
Informação adicional de produto 5045Produto
Informação adicional de produto 5046Produto
Informação adicional de produto 5047Produto
Informação adicional de cliente5048Cliente
Informação adicional de cliente 5049Cliente
Informação adicional de cliente 5050Cliente
Informação adicional de cliente 5051Cliente
Informação adicional de cliente 5052Cliente

Observações:

(*1) – Casas decimais devem ser separadas por vírgula;
(*2) – Os campos de CNPJ não devem conter pontos, traços ou barras.
(*2) – Caso o cliente não possua CNPJ, você pode preencher a primeira parte do CNPJ com um código interno do cliente, e deixar a segunda parte do CNPJ em branco.
(*3) – O campo de endereço, além de servir para consulta, também é utilizado para a geolocalização do cliente no Google Maps. Informações completas como nome da rua e número corretos resultam em uma localização mais precisa.

Você pode consultar um arquivo CSV de exemplo baixando o arquivo abaixo:

Lembre-se de automatizar a geração de seu arquivo CSV antes de avançar para o próximo artigo. O arquivo deve ser gerado automaticamente sempre com o mesmo nome, e na mesma pasta.

Validando o arquivo de dados

Newsletter Salescope

Receba toda semana e-mails úteis com informações sobre o mercado e nosso produto.
WhatsApp
Agende uma
apresentação