Enviar Sugestões Created with Sketch.
ENVIAR SUGESTÕES
Tabela 18 - Clientes
10 min
Criado por Leonardo Rizzi em 14/08/2020 14:43
Atualizado por Luis Barbon em 11/03/2022 18:29

Este artigo apresenta os campos do layout de integração de cliente.

Ordem Descrição do Campo Formato e Tamanho Obrigatório Versão Observação
1 Identificador da Tabela (IDENTIFICADOR) FIXO=18 (2) Sim 1.0  
2 Código do Cliente (codigo) Inteiro Sim 1.0 Clientes cadastrados pelo vendedor, assumem código "0", a chave para atualizar o código desses clientes é o campo CNPJ/CPF
3 CNPJ/CPF (cpfCNPJ)  Texto (20) Não 1.0 Enviar com máscara EX:01.010.101/0001-72, campo passa a ser obrigatório quando codigo e uniqueID são nulos, em branco ou zero.
4 Código da Condição de Pagamento (codCondicaoPagamento) Inteiro Não 1.0  
5 Código da Forma de Pagamento (codFormaPagamento) Texto (20) Não 1.0  
6 Código da Região (codRegiao) Inteiro Não 1.0 Reservado para uso futuro
7 Código do Vendedor (codVendedor) Inteiro Não 1.0 ATENÇÃO: Se enviado o código do vendedor o cliente aparece somente para o vendedor informado, caso contrario ele aparece para todos os vendedores
8 Código da Lista de Preço (codListaPreco) Texto (20) Não 1.0  
9 Código da Cidade do Cliente (codCidade) Inteiro Sim 1.0  
10 Código da Filial (codFilial) Inteiro Não 1.0  
11 Razão Social (nomeRazao) Texto (100) Sim 1.0  
12 Nome Fantasia (nomeFantasia) Texto (100) Sim 1.0  
13 Tipo da Pessoa (tipoPessoa) Texto Sim 1.0 F = Pessoa Física; J = Jurídica
14 Intervalo entre Visitas (intervaloVisitas) Inteiro Não 1.0  
15 RG ou Inscrição Estadual (rgIE) Texto Não 1.0  
16 Telefone Principal (telefone1) Texto Não 1.0 Enviar com máscara. EX: (51) 3714-7017
17 Telefone Secundário (telefone2) Texto Não 1.0  
18 Endereço de E-mail do Comprador (emailComprador0) Texto Não 1.0  
19 Endereço de E-mail para NF-e (emailNfe) Texto Não 1.0  
20 Endereço de E-mail do Financeiro (emailFinanceiro) Texto Não 1.0  
21 Pessoa de Contato no Cliente (contato) Texto Não 1.0  
22 Endereço do Cliente (endereco) Texto Não 1.0  
23 Bairro (bairro) Texto Não 1.0  
24 CEP (cep) Texto Não 1.0 Enviar com máscara EX: 95900-000
25 UF - Estado (uf) Texto Não 1.0  
26 Observação (observacao) Texto Não 1.0  
27 Ativo (ativo) Booleano Não 1.0 1 = Ativo ou 0 = Inativo
28 Bloqueado (bloqueado) Booleano Não 1.7 1 = Não permite venda para o Cliente, 0=Permite venda para o Cliente
29 Número (numero) Inteiro Não 1.11 Número do Endereço
30 Complemento de Endereço (complemento) Texto Não 1.11  
31 Latitude (latitude) Texto Não 1.12  
32 Longitude (longitude) Texto Não 1.12  
33 Bloquear edição da Filial/Unidade (bloqueiaFilialUnidade) Booleano Não 1.15 Bloquear edição da Filial/Unidade Padrão do Cliente pelo vendedor
34 Bloquear edição da Lista de Preço (bloqueiaListaPreco) Booleano Não 1.15 Bloquear edição da Lista de Preço Padrão do Cliente pelo vendedor
35 Bloquear edição da Condição de Pagamento (bloqueiaCondPagamento) Booleano Não 1.15 Bloquear edição da Condição de Pagamento Padrão do Cliente
36 Bloquear edição da Forma de Pagamento (bloqueiaFormaPagamento) Booleano Não 1.15 Bloquear edição da Forma de Pagamento Padrão do Cliente pelo vendedor
37 Inscrição Estadual Pessoa Física (inscricaoEstadualPessoaFisica) Texto Não 2.6  
38 Identificador Único do Cliente no Demander (idCliente) Inteiro Não 2.10 ATENÇÃO: Se o vendedor cadastrou um cliente novo sem informar CPF/CNPJ, o cliente assume código Zero, porém quando o ERP devolve a informação do cliente ele já vem com código, então esse campo é utilizado como chave para atualizar o cliente, já que o CPF/CNPJ não foi preenchido. Sendo assim seu ERP precisa armazenar esse campo para devolver ao Demander, caso contrário os clientes vão duplicar no Demander ou não será permitido aos vendedores cadastrarem clientes sem informar CPF/CNPJ.
39 Tipo de Cliente Tributário (codTipoClienteTributario) Texto (20) Não 2.13 Esse campo é usado por algumas empresas nos cálculos de IPI e ICMS ST, só se preocupe com ele se você for integrar a configuração de Tributação.
40 Vendedores Relacionados (vendedoresRelacionados) Texto (200) Não 2.17 Envie aqui os códigos dos Vendedores que atendem ao cliente separados por virgula. Esse campo só precisa ser enviado do ERP para o Demander se mais que um vendedor atende (visualizar) ao Cliente. Exemplo de preenchimento: "24, 75, 145" (Se apenas um vendedor atende ao cliente, utilize apenas o campo codVendedor). Se um vendedor cadastrar um novo cliente no demander, apenas o campo codVendedor é preenchido, este campo nasce vazio.
41 Cliente em Prospecção (prospecto) Booleano Não 2.30 0 - Não é Prospecto, já é Cliente. 1 - É prospecto, ainda não é Cliente. O Demander possibilita que os vendedores cadastrem clientes que eles estão prospectando. Normalmente esses Prospectos não querem fornecer todos os dados cadastrais, por causa disso no aplicativo do Demander temos uma funcionalidade separada para o cadastro de prospectos, inclusive com configuração obrigatoriedade separada. Mesmo não sendo cliente os Prospects são exportados ao ERP no layout da tabela de clientes, se o seu ERP não estiver estruturado para importar Prospects, a sugestão é ignorar estes registros, par evitar transtornos cadastrais. (Atualmente não suportamos a importação de prospects sem código ou CNPJ, a não ser que você utilize o campo "Identificador Único do Demander")
42 Identificador da Alteração (idAlteracaoERP) Texto Não 2.31 Campo exclusivo de controle do ERP. O Demander apenas importa e devolve ao ERP. Esse campo pode ser utilizado para que o ERP implante algum controle de conflito de alterações entre ERP e vendedor.
43 Percentual do acordo comercial (percAcordoComercial) Decimal Não 2.36 Atualmente o campo acordo comercial é utilizado para diminuir ou aumentar o desconto máximo do cliente.
EX: Se a empresa tem desconto máximo de 25%, mas o cliente tem um acordo comercial de 5% então, para esse cliente o vendedor pode dar até 30% de desconto.
Se for necessário diminuir o desconto máximo do cliente para 20%,
pode ser enviado -5 no campo do acordo comercial.
(Desconto máximo do Cliente = Desconto máximo da Empresa + Acordo Comercial)
44 Código da Transportadora Preferencial (codTransportadora) Texto (20) Não 2.41 Código da Transportadora preferencial do Cliente. Se este campo estiver preenchido na emissão do pedido o sistema vai selecionar automaticamente esta transportadora, mas ainda vai permitir a alteração.
45 Código da Transportadora de Re-despacho Preferencial (codTransportadoraRedespacho) Texto (20) Não 2.41 Código da Transportadora de Re-despacho preferencial do Cliente. Se este campo estiver preenchido na emissão do pedido o sistema vai selecionar automaticamente esta transportadora, mas ainda vai permitir a alteração.
46 Data de Nascimento (dataNascimento) Data Não 2.47  
47 Segmentos relacionados (segmentosRelacionados) Texto (500) Não 2.48 Campo para identificar os segmentos que o determinado cliente utiliza.
Ex.: Utilitários para motos, Utilitário para bicicletas
48 Número do Concelho regional de Odontologia (cro) Texto (50) Não 3.5  
49 Percentual máximo de desconto do cliente (percentualDescontoMaximo) Decimal Não 3.6 Percentual máximo de desconto que o cliente pode ter no pedido.
Este campo quando preenchido, é soberano sobre qualquer outra regra de desconto;
50 Código da Tabela de Faixa de Frete (codFaixaFrete) Texto (30) Não 3.14 Código da tabela de Faixa de Frete Utilizado para cálculo do valor sugerido de frete.
51 Código do grupo econômico (codGrupoEconomico) Texto Não 3.20  
52 Listas de preço adicionais (listasPrecosAdicionais) Texto Não 3.20  
53 Raio do checkin (checkinRaio) Inteiro Não 3.20  
54 Dias do checkin (checkinDias) Inteiro Não 3.20  
55 Condições de pagamento adicionais (condicoesAdicionais) Texto Não 3.28  
56 Observação de integração (observacaoIntegracao) Texto Não 3.34  
57 Limite de crédito (Z) Decimal Não 3.37  
58 Percentual da margem de contribuição (percMargemContribuicao) Decimal Não 3.38  
59 Vendedores Prepostos (VendedoresPrepostos) Texto (500) Não 3.42  

 

Exemplo de Registro:

18|3004007|23.596.536/0001-17||0|0|170895|0|4322509|2|VILMAR MACIEL DE MORAES 78145171091|AUTO DESIGN CENTRO AUTOMOTIVO|J|0|ISENTO|54 991127156|54 991127156|macieldemorais@bol.com.br|||ALINE|EST DO MARMELEIRO, 35|MAUA|95214410|RS||1|0||||||0|0|||9695140|G||0|2020-08-11 08:19:23|0||||||0||||0|0||