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) | 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 | 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 (limiteCredito) | 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 | |
| 60 | Hierarquia padrão do cliente (codHierarquiaLiberacaoPedido) | Texto | 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||