Layout Integração DBF - Clientes
- Este artigo apresenta os campos do layout de integração de clientes. Para entender melhor o conceito por trás de clientes, consulte nosso artigo em Conceito de Cliente.
| Ordem | Descrição do Campo | Formato e Tamanho | Obrigatório | Versão | Observação |
| 1 | Código do Cliente(codigo) | INT (11) | Sim | 4.58 | |
| 2 | CPF/CNPJ(cpfCNPJ) | Texto (18) | Não | 4.58 | 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. |
| 3 | Código da Condição de Pagamento(codCondicaoPagamento) | Texto (20) | Não | 4.58 | Determina a condição de pagamento padrão deste cliente. Esta é a condição de pagamento que será selecionada quando iniciar a digitação de um novo pedido. *Quando bloqueada a condição de pagamento, não é permitido alterar no pedido. SebloqueiaCondPagamento= 1, somente a condição de pagamento definida é mostrada ao criar um Pedido e não pode ser alterada. SebloqueiaCondPagamento= 0 e tiver uma condição de pagamento definida, ela é carregada como padrão, mas permite ser alterada. SebloqueiaCondPagamento= 0 e NÃO tiver uma condição de pagamento definida, não é carregada uma condição de pagamento padrão, mas permite selecionar outra condição de pagamento. Este campo não é limpo quando enviado vazio do ERP para o Demander. Para limpar o campo, deve-se enviar um código de uma forma de pagamento que não esteja cadastrada. |
| 4 | Código da Forma de Pagamento(codFormaPagamento) | Texto (20) | Não | 4.58 | |
| 5 | Código da Região(codRegiao) | INT (11) | Não | 4.58 | |
| 6 | Código do Vendedor(codVendedor) | INT (11) | Não | 4.58 | |
| 7 | Código da Lista de Preço(codListaPreco) | Texto (20) | Não | 4.58 | Determina a lista de preço padrão deste cliente. Esta é a lista de preço que será selecionado quando iniciar a digitação de um novo pedido. *Quando bloqueada a lista de preço, não é permitido alterar no pedido. SebloqueiaListaPreco= 1, somente a lista de preço definida é mostrada ao criar um Pedido e não pode ser alterada. SebloqueiaListaPreco= 0 e tiver uma lista de preço definida, ela é carregada como padrão, mas permite ser alterada. SebloqueiaListaPreco= 0 e NÃO tiver uma lista de preço definida, não é carregada uma lista padrão, mas permite selecionar outra lista de preço. Este campo não é limpo quando enviado vazio do ERP para o Demander. Para limpar o campo, deve-se enviar um código de uma lista de preço que não esteja cadastrada. |
| 8 | Código da Cidade(codCidade) | INT (11) | Sim | 4.58 | |
| 9 | Código da Filial(codFilial) | INT (11) | Não | 4.58 | Determina a filial padrão deste cliente. Esta é a filial que será selecionada quando iniciar a digitação de um novo pedido. *Quando bloqueada a filial, não é permitido alterar no pedido. SebloqueiaFilialUnidade= 1, somente a filial definida é mostrada ao criar um Pedido e não pode ser alterada. SebloqueiaFilialUnidade= 0 e tiver uma filial definida, ela é carregada como padrão, mas permite ser alterada. SebloqueiaFilialUnidade= 0 e NÃO tiver uma filial definida, não é carregada uma filial padrão, mas permite selecionar outra filial. Este campo não é limpo quando enviado vazio do ERP para o Demander. Para limpar o campo, deve-se enviar um código de uma filial que não esteja cadastrada. |
| 10 | Nome Razão(nomeRazao) | Texto (100) | Sim | 4.58 | |
| 11 | Nome Fantasia(nomeFantasia) | Texto (100) | Sim | 4.58 | |
| 12 | Tipo de Pessoa(tipoPessoa) | Texto (1) | Sim | 4.58 | F = Pessoa Física; J = Jurídica |
| 13 | RG/IE(rgIE) | Texto (20) | Não | 4.58 | |
| 14 | Telefone 1(telefone1) | Texto (254) | Não | 4.58 | Enviar com máscara. EX: (51) 3714-7017 |
| 15 | Telefone 2 (telefone2) | Texto (254) | Não | 4.58 | |
| 16 | Email do Comprador(emailComprador) | Texto (254) | Não | 4.58 | |
| 17 | Email NF-e(emailNfe) | Texto (254) | Não | 4.58 | |
| 18 | Email Financeiro(emailFinanceiro) | Texto (254) | Não | 4.58 | |
| 19 | Contato(contato) | Texto (50) | Não | 4.58 | |
| 20 | Endereço(endereco) | Texto (100) | Não | 4.58 | |
| 21 | Bairro(bairro) | Texto (50) | Não | 4.58 | |
| 22 | CEP (cep) | Texto (50) | Não | 4.58 | Enviar com máscara EX: 95900-000 |
| 23 | UF (uf) | Texto (2) | Não | 4.58 | |
| 24 | Observação (observacao) | Texto (254) | Não | 4.58 | |
| 25 | Número (numero) | INT (11) | Não | 4.58 | Número do Endereço |
| 26 | Complemento (complemento) | Texto (200) | Não | 4.58 | |
| 27 | Identificador Único do Cliente (idCliente) | INT (11) | Não | 4.58 | 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. |
| 28 | Código do Tipo de Cliente Tributário (codTipoClienteTributario) | Texto (50) | Não | 4.58 | 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. |
| 29 | Prospécto (prospecto) | INT (1) | Não | 4.58 | 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 Prospecto eles podem ser exportados ao ERP no layout da tabela de clientes, se o seu ERP não estiver estruturado para importar prospectos, configure para que eles não sejam exportados, para isso acesse as "Configurações da Empresa", aba "Configurações adicionais" e procure pela configuração "Exportar prospectos" e defina Sim ou Não. (Atualmente não suportamos a importação de prospectos sem código ou CNPJ, exceto se você utiliza o campo "Identificador Único do Demander") |
| 30 | Data de Nascimento (dataNascimento) | Data | Não | 4.58 | |
| 31 | Segmentos Relacionados (segmentosRelacionados) | Texto (254) | Não | 4.58 | Campo para identificar os segmentos que o determinado cliente utiliza. Ex.: Utilitários para motos, Utilitário para bicicletas |
| 32 | Limite de Crédito (limiteCredito) | INT (11) | Não | 4.58 | Utilizado para bloquear pedidos para clientes que ultrapassarem o limite de crédito. Também utilizado para Módulo de recebimento financeiro. |
| 33 | Código do Tipo de Cliente (codTipoCliente) | Texto (50) | Não | 4.58 | Código da tabelaTipo de Cliente. |
| 34 | Código da Divisão de Venda (codDivisaoVendas) | Texto (50) | Não | 4.58 | Código da tabelaDivisão de Vendas. |
Exemplo de Registro: