Tabla 18 - Clientes
- Este artículo presenta los campos del diseño de incorporación de clientes. Para comprender mejor el concepto detrás de los clientes, consulte nuestro artículo sobre Concepto 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 (10) | 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 | 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. Se bloqueiaCondPagamento = 1, somente a condição de pagamento definida é mostrada ao criar um Pedido e não pode ser alterada. |
| 5 | Código da Forma de Pagamento (codFormaPagamento) | Texto (20) | Não | 1.0 | Determina a forma de pagamento padrão deste cliente. Esta é a forma de pagamento que será selecionada quando iniciar a digitação de um novo pedido. *Quando bloqueada a forma de pagamento, não é permitido alterar no pedido. Se bloqueiaFormaPagamento = 1, somente a forma de pagamento definida é mostrada ao criar um Pedido e não pode ser alterada. |
| 6 | Código da Região (codRegiao) | Texto (30) | Não | 5.18 | Código da Região |
| 7 | Código do Vendedor (codVendedor) | Inteiro (10) | 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 | 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. Se bloqueiaListaPreco = 1, somente a lista de preço definida é mostrada ao criar um Pedido e não pode ser alterada. |
| 9 | Código da Cidade do Cliente (codCidade) | Inteiro (10) | Sim | 1.0 | |
| 10 | Código da Filial (codFilial) | Texto (15) | Não | 1.0 | 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. Se bloqueiaFilialUnidade = 1, somente a filial definida é mostrada ao criar um Pedido e não pode ser alterada. |
| 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 (10) | 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 (10) | 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 | Impede que o vendedor altere a Filial padrão do cliente na emissão de pedido. |
| 34 | Bloquear edição da Lista de Preço (bloqueiaListaPreco) | Inteiro (1) | Não | 1.15 | Impede que o vendedor altere a Lista de Preço padrão do cliente na emissão de pedido. |
| 35 | Bloquear edição da Condição de Pagamento (bloqueiaCondPagamento) | Inteiro (1) | Não | 1.15 | Impede que o vendedor altere a Condição de Pagamento padrão do cliente na emissão de pedido. |
| 36 | Bloquear edição da Forma de Pagamento (bloqueiaFormaPagamento) | Inteiro (1) | Não | 1.15 | Impede que o vendedor altere a Forma de Pagamento padrão do cliente na emissão de pedido. |
| 37 | Inscrição Estadual Pessoa Física (inscricaoEstadualPessoaFisica) | Texto (30) | Não | 2.6 | |
| 38 | Identificador Único do Cliente no Demander (idCliente) | Inteiro (10) | 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 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 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. (Obs interna: Ver a tarefa #31145 no Redmine) |
| 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 Conselho 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 | Listas de preço adicionais que o cliente poderá ter acesso. Caso o cliente tenha uma lista bloqueada, as listas adicionaisNÃOirão aparecer como opção para serem escolhidas. |
| 53 | Raio do checkin (checkinRaio) | Inteiro (10) | Não | 3.20 | Raio em metros do cliente, usado para oMódulo de Check-in. |
| 54 | Dias do checkin (checkinDias) | Inteiro (10) | Não | 3.20 | Quantidade de dias do último Check-in, usado para oMódulo de Check-in. |
| 55 | Condições de pagamento adicionais (condicoesAdicionais) | Texto (255) | Não | 3.28 | Condições de pagamento adicionais que o cliente poderá ter acesso. Caso o cliente tenha uma condição bloqueada, as condições adicionaisNÃOirão aparecer como opção para serem escolhidas. |
| 56 | Observação de integração (observacaoIntegracao) | Texto (2000) | 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 deMargem 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 tabelaTipo de Cliente. |
| 62 | Divisão de Vendas (codDivisaoVenda) | Texto (30) | Não | 4.18 | Código da tabelaDivisão de Vendas. |
| 63 | Tipo de pedido padrão (codTipoPedido) | Inteiro | Não | 4.22 | Define o tipo de pedido padrão do cliente. Este tipo de pedido será selecionado automaticamente ao iniciar um novo pedido. Quando bloqueado, a alteração do tipo de pedido não é permitida, conforme os exemplos abaixo. Se bloqueiaTipoPedido= 1. |
| 64 | Bloqueia edição do tipo de pedido (bloqueiaTipoPedido) | Booleano | Não | 4.22 | Este campo impede que o vendedor altere o tipo de pedido padrão do cliente ao emitir um pedido. |
| 65 | Tipos de pedido adicionais (tipoPedidoAdicionais) | Texto(255) | Não | 4.22 | Tipos de pedido adicionais que o cliente poderá ter acesso. Se o cliente tiver o tipo de pedido bloqueado, os tipos de pedidos adicionais NÃO aparecerão como opções disponíveis. |
| 66 | Valor de descarga (valorDescarga) | Decimal(10,5) | Não | 4.47 | Valor de descarga por Kg de peso liquido do Pedido. Pode ser utilizado no cálculo da Despesa Acessórias. |
| 67 | Permite alterar o valor da Despesa Acessória (permiteAlterarDespesaAcessoria) | Booleano | Não | 4.51 | Determina se o vendedor pode ou não alterar o valor sugerido para a "Despesa Acessória" nos pedidos deste cliente. |
| 68 | Exige ordem de compra (exigeOrdemDeCompra) | Booleano | Não | 4.55 | Determina se o campo "ordem de compra" é obrigatório para este cliente. * Só tem efeito quando a "Tipo de Pedido" também "exige ordem de compra"; |
Ejemplo de registro:
18|3004007|23.596.536/0001-17||0|0|170895|0|4322509|2|VILMAR MACIEL DE MORAES 78145171091|AUTO DESIGN CENTRO AUTOMOTIVO | 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|||