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

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 (11) 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 (18) 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) Texto (20) 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 (11) Não 1.0 Reservado para uso futuro
7 Código do Vendedor (codVendedor) Inteiro (11) 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 (11) Sim 1.0  
10 Código da Filial (codFilial) Inteiro (11) 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 (1) Sim 1.0 F = Pessoa Física; J = Jurídica
14 Intervalo entre Visitas (intervaloVisitas) Inteiro (11) Não 1.0  
15 RG ou Inscrição Estadual (rgIE) Texto (20) Não 1.0  
16 Telefone Principal (telefone1) Texto (255) Não 1.0 Enviar com máscara. EX: (51) 3714-7017
17 Telefone Secundário (telefone2) Texto (255) Não 1.0  
18 Endereço de E-mail do Comprador (emailComprador) Texto (255) Não 1.0  
19 Endereço de E-mail para NF-e (emailNfe) Texto (255) Não 1.0  
20 Endereço de E-mail do Financeiro (emailFinanceiro) Texto (255) Não 1.0  
21 Pessoa de Contato no Cliente (contato) Texto (50) Não 1.0  
22 Endereço do Cliente (endereco) Texto (100) Não 1.0  
23 Bairro (bairro) Texto (50) Não 1.0  
24 CEP (cep) Texto (10) Não 1.0 Enviar com máscara EX: 95900-000
25 UF - Estado (uf) Texto (2) Não 1.0  
26 Observação (observacao) Texto (2000) Não 1.0  
27 Ativo (ativo) Inteiro (1) Não 1.0 1 = Ativo ou 0 = Inativo
28 Bloqueado (bloqueado) Inteiro (1) Não 1.7 1 = Não permite venda para o Cliente, 0=Permite venda para o Cliente
29 Número (numero) Inteiro (11) Não 1.11 Número do Endereço
30 Complemento de Endereço (complemento) Texto (200) Não 1.11  
31 Latitude (latitude) Texto (50) Não 1.12  
32 Longitude (longitude) Texto (50) Não 1.12  
33 Bloquear edição da Filial/Unidade (bloqueiaFilialUnidade) Inteiro (1) 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) Inteiro (1) 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) Inteiro (1) 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) Inteiro (1) 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 (30) Não 2.6  
38 Identificador Único do Cliente no Demander (idCliente) Inteiro (11) 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 (500) 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) Inteiro (1) 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 (255) 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 (30) 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 (codRedespacho) Texto (30) 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 (100) Não 3.20 Define a qual grupo econômico o cliente pertence. É necessário integrar a Tabela 35 - Grupo Econômico.
52 Listas de preço adicionais (listaPrecosAdicionais) Texto (255) Não 3.20 Além de definir uma lista de preço fixa no cliente é possível adicionar listas adicionais neste campo.
53 Raio do checkin (checkinRaio) Inteiro (11) Não 3.20 Raio em metros do cliente, usado para o Módulo de Check-in
54 Dias do checkin (checkinDias) Inteiro (11) Não 3.20 Quantidade de dias do último Check-in, usado para o Módulo de Check-in
55 Condições de pagamento adicionais (condicoesAdicionais) Texto (255) Não 3.28 Além de definir uma condição de pagamento fixa no cliente é possível adicionar condições adicionais neste campo.
56 Observação de integração (observacaoIntegracao) Texto Não 3.34 Quando integrado é exibido um ícone de olho no cadastro do cliente e esta observação é mostrada ao clicar nele.
57 Limite de crédito (limiteCredito) Decimal Não 3.37 Utilizado para bloquear pedidos para clientes que ultrapassarem o limite de crédito. Também utilizado para Módulo de recebimento financeiro.
58 Percentual da margem de contribuição (percMargemContribuicao) Decimal (8,2) Não 3.38 Usado para o cálculo no Módulo de Margem de Contribuição.
59 Vendedores Prepostos (VendedoresPrepostos) Texto (500) Não 3.42 São vendedores/representantes que o próprio vendedor/representante gerencia. Exemplo: O representante da Empresa ABC contrata um Vendedor para vender para ele, esse será um Vendedor preposto deste Representante.
60 Hierarquia padrão do cliente (codHierarquiaLiberacaoPedido) Texto (255) Não 3.42  
61 Tipo de Cliente (codTipoCliente) Texto (30) Não 4.18 Código da tabela Tipo de Cliente.
62 Divisão de Vendas (codDivisaoVenda) Texto (30) Não 4.18 Código da tabela Divisão de Vendas.

 

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||