Tabla 18 - Clientes

Este artículo presenta los campos del diseño de integración de clientes. Para comprender mejor el concepto detrás de los clientes, consulte nuestro artículo sobre Concepto de cliente.

Orden

Descripción del campo

Formato y tamaño

Obligatorio

Versión

Nota

Identificador de tabla (IDENTIFICADOR)

FIJO=18 (2)

Sí

1.0

Código del cliente (codigo)

Entero (10)

Sí

1.0

Los clientes registrados por el vendedor asumen el código "0"; la clave para actualizar el código de estos clientes es el campo CNPJ/CPF.

CNPJ/CPF (cpfCNPJ)

Texto (18)

1.0

Enviar con máscara EJ: 01.010.101/0001-72; el campo pasa a ser obligatorio cuando codigo y uniqueID son nulos, en blanco o cero.

Código de condición de pago (codCondicaoPagamento)

Texto (20)

1.0

Determina la condición de pago predeterminada de este cliente. Esta es la condición de pago que se seleccionará al iniciar la digitación de un nuevo pedido. *Cuando la condición de pago está bloqueada, no se permite modificarla en el pedido.

Si bloqueiaCondPagamento = 1, solo se muestra la condición de pago definida al crear un Pedido y no se puede modificar.
Si bloqueiaCondPagamento = 0 y tiene una condición de pago definida, se carga como predeterminada, pero se permite modificarla.
Si bloqueiaCondPagamento = 0 y NO tiene una condición de pago definida, no se carga una condición predeterminada, pero se permite seleccionar otra condición de pago.

Este campo no se limpia cuando se envía vacío desde el ERP a Demander. Para limpiar el campo, se debe enviar el código de una condición de pago que no esté registrada.

Código de forma de pago (codFormaPagamento)

Texto (20)

1.0

Determina la forma de pago predeterminada de este cliente. Esta es la forma de pago que se seleccionará al iniciar la digitación de un nuevo pedido. *Cuando la forma de pago está bloqueada, no se permite modificarla en el pedido.

Si bloqueiaFormaPagamento = 1, solo se muestra la forma de pago definida al crear un Pedido y no se puede modificar.
Si bloqueiaFormaPagamento = 0 y tiene una forma de pago definida, se carga como predeterminada, pero se permite modificarla.
Si bloqueiaFormaPagamento = 0 y NO tiene una forma de pago definida, no se carga una forma de pago predeterminada, pero se permite seleccionar otra forma de pago.

Este campo no se limpia cuando se envía vacío desde el ERP a Demander. Para limpiar el campo, se debe enviar el código de una forma de pago que no esté registrada.

Código de región (codRegiao)

Texto (30)

5.18

Código de región

Código del vendedor (codVendedor)

Entero (10)

1.0

ATENCIÓN: Si se envía el código del vendedor, el cliente aparece únicamente para el vendedor informado; de lo contrario, aparece para todos los vendedores.

Código de lista de precios (codListaPreco)

Texto (20)

1.0

Determina la lista de precios predeterminada de este cliente. Esta es la lista de precios que se seleccionará al iniciar la digitación de un nuevo pedido. *Cuando la lista de precios está bloqueada, no se permite modificarla en el pedido.

Si bloqueiaListaPreco = 1, solo se muestra la lista de precios definida al crear un Pedido y no se puede modificar.
Si bloqueiaListaPreco = 0 y tiene una lista de precios definida, se carga como predeterminada, pero se permite modificarla.
Si bloqueiaListaPreco = 0 y NO tiene una lista de precios definida, no se carga una lista predeterminada, pero se permite seleccionar otra lista de precios.

Este campo no se limpia cuando se envía vacío desde el ERP a Demander. Para limpiar el campo, se debe enviar el código de una lista de precios que no esté registrada.

Código de la ciudad del cliente (codCidade)

Entero (10)

Sí

1.0

Código de la sucursal (codFilial)

Texto (15)

1.0

Determina la sucursal predeterminada de este cliente. Esta es la sucursal que se seleccionará al iniciar la digitación de un nuevo pedido. *Cuando la sucursal está bloqueada, no se permite modificarla en el pedido.

Si bloqueiaFilialUnidade = 1, solo se muestra la sucursal definida al crear un Pedido y no se puede modificar.
Si bloqueiaFilialUnidade = 0 y tiene una sucursal definida, se carga como predeterminada, pero se permite modificarla.
Si bloqueiaFilialUnidade = 0 y NO tiene una sucursal definida, no se carga una sucursal predeterminada, pero se permite seleccionar otra sucursal.

Este campo no se limpia cuando se envía vacío desde el ERP a Demander. Para limpiar el campo, se debe enviar el código de una sucursal que no esté registrada.

Razón social (nomeRazao)

Texto (100)

Sí

1.0

Nombre de fantasía (nomeFantasia)

Texto (100)

Sí

1.0

Tipo de persona (tipoPessoa)

Texto (1)

Sí

1.0

F = Persona Física; J = Jurídica

Intervalo entre visitas (intervaloVisitas)

Entero (10)

1.0

Documento de identidad o Inscripción Estatal (rgIE)

Texto (20)

1.0

Teléfono principal (telefone1)

Texto (255)

1.0

Enviar con máscara. EJ: (51) 3714-7017

Teléfono secundario (telefone2)

Texto (255)

1.0

Correo electrónico del comprador (emailComprador)

Texto (255)

1.0

Correo electrónico para factura electrónica (emailNfe)

Texto (255)

1.0

Correo electrónico financiero (emailFinanceiro)

Texto (255)

1.0

Persona de contacto en el cliente (contato)

Texto (50)

1.0

Dirección del cliente (endereco)

Texto (100)

1.0

Barrio (bairro)

Texto (50)

1.0

Código Postal (cep)

Texto (10)

1.0

Enviar con máscara EJ: 95900-000

Estado/Provincia (uf)

Texto (2)

1.0

Observaciones (observacao)

Texto (2000)

1.0

Activo (ativo)

Entero (1)

1.0

1 = Activo o 0 = Inactivo

Bloqueado (bloqueado)

Entero (1)

1.7

1 = No permite venta al Cliente, 0 = Permite venta al Cliente

Número (numero)

Entero (10)

1.11

Número de dirección

Complemento de dirección (complemento)

Texto (200)

1.11

Latitud (latitude)

Texto (50)

1.12

Longitud (longitude)

Texto (50)

1.12

Bloquear edición de Sucursal/Unidad (bloqueiaFilialUnidade)

Entero (1)

1.15

Impide que el vendedor modifique la Sucursal predeterminada del cliente en la emisión del pedido.

Bloquear edición de Lista de Precios (bloqueiaListaPreco)

Entero (1)

1.15

Impide que el vendedor modifique la Lista de Precios predeterminada del cliente en la emisión del pedido.

Bloquear edición de Condición de Pago (bloqueiaCondPagamento)

Entero (1)

1.15

Impide que el vendedor modifique la Condición de Pago predeterminada del cliente en la emisión del pedido.

Bloquear edición de Forma de Pago (bloqueiaFormaPagamento)

Entero (1)

1.15

Impide que el vendedor modifique la Forma de Pago predeterminada del cliente en la emisión del pedido.

Inscripción Estatal Persona Física (inscricaoEstadualPessoaFisica)

Texto (30)

2.6

Identificador Único del Cliente en Demander (idCliente)

Entero (10)

2.10

ATENCIÓN: Si el vendedor registró un nuevo cliente sin informar CPF/CNPJ, el cliente asume el código Cero; sin embargo, cuando el ERP devuelve la información del cliente, ya viene con código, por lo que este campo se utiliza como clave para actualizar al cliente, dado que el CPF/CNPJ no se completó. Por lo tanto, su ERP debe almacenar este campo para devolverlo a Demander; de lo contrario, los clientes se duplicarán en Demander o no se permitirá a los vendedores registrar clientes sin informar CPF/CNPJ.

Tipo de cliente tributario (codTipoClienteTributario)

Texto (20)

2.13

Este campo es utilizado por algunas empresas en los cálculos de IPI e ICMS ST; solo preocúpese por él si va a integrar la configuración de Tributación.

Vendedores relacionados (vendedoresRelacionados)

Texto (500)

2.17

Envíe aquí los códigos de los Vendedores que atienden al cliente separados por comas. Este campo solo debe enviarse del ERP a Demander si más de un vendedor atiende (visualiza) al Cliente. Ejemplo: "24, 75, 145" (Si solo un vendedor atiende al cliente, utilice únicamente el campo codVendedor). Si un vendedor registra un nuevo cliente en Demander, solo se completa el campo codVendedor; este campo nace vacío.

Cliente en prospección (prospecto)

Entero (1)

2.30

0 - No es prospecto, ya es Cliente. 1 - Es prospecto, aún no es Cliente. Demander permite a los vendedores registrar clientes que están prospectando. Normalmente estos prospectos no quieren proporcionar todos los datos de registro; por esa razón, en la aplicación Demander disponemos de una funcionalidad separada para el registro de prospectos, inclusive con configuración de obligatoriedad separada. Aunque no sean clientes, los prospectos se pueden exportar al ERP en el diseño de la tabla de clientes; si su ERP no está estructurado para importar prospectos, configure para que no se exporten accediendo a "Configuración de la empresa", pestaña "Configuraciones adicionales" y busque la opción "Exportar prospectos" y defina Sí o No. (Actualmente no admitimos la importación de prospectos sin código o CNPJ, a menos que utilice el campo "Identificador Único de Demander")

Identificador de la modificación (idAlteracaoERP)

Texto (255)

2.31

Campo exclusivo de control del ERP. Demander únicamente importa y devuelve al ERP. Este campo se puede utilizar para que el ERP implemente algún control de conflictos de modificaciones entre ERP y vendedor.
(Nota interna: Ver tarea #31145 en Redmine)

Porcentaje del acuerdo comercial (percAcordoComercial)

Decimal

2.36

Actualmente el campo acuerdo comercial se utiliza para disminuir o aumentar el descuento máximo del cliente.
EJ: Si la empresa tiene un descuento máximo del 25%, pero el cliente tiene un acuerdo comercial del 5%, entonces para ese cliente el vendedor puede otorgar hasta un 30% de descuento.
Si es necesario disminuir el descuento máximo del cliente al 20%, se puede enviar -5 en el campo de acuerdo comercial.
(Descuento máximo del Cliente = Descuento máximo de la Empresa + Acuerdo Comercial)

Código de la transportadora preferencial (codTransportadora)

Texto (30)

2.41

Código de la transportadora preferencial del cliente. Si este campo está completado al emitir el pedido, el sistema seleccionará automáticamente esta transportadora, pero seguirá permitiendo modificarla.

Código de la transportadora de reenvío preferencial (codRedespacho)

Texto (30)

2.41

Código de la transportadora de reenvío preferencial del cliente. Si este campo está completado al emitir el pedido, el sistema seleccionará automáticamente esta transportadora, pero seguirá permitiendo modificarla.

Fecha de nacimiento (dataNascimento)

Fecha

2.47

Segmentos relacionados (segmentosRelacionados)

Texto (500)

2.48

Campo para identificar los segmentos que determinado cliente utiliza.
Ej.: Utilitarios para motos, Utilitarios para bicicletas

Número del Consejo Regional de Odontología (cro)

Texto (50)

3.5

Porcentaje máximo de descuento del cliente (percentualDescontoMaximo)

Decimal

3.6

Porcentaje máximo de descuento que el cliente puede tener en el pedido.
Este campo, cuando se completa, tiene prioridad sobre cualquier otra regla de descuento.

Código de tabla de rangos de flete (codFaixaFrete)

Texto (30)

3.14

Código de la tabla de rangos de flete utilizado para el cálculo del valor sugerido de flete.

Código del grupo económico (codGrupoEconomico)

Texto (100)

3.20

Define a qué grupo económico pertenece el cliente. Es necesario integrar la Tabla 35 - Grupo Económico.

Listas de precios adicionales (listaPrecosAdicionais)

Texto (255)

3.20

Listas de precios adicionales a las que el cliente podrá tener acceso.
En caso de que el cliente tenga una lista bloqueada, las listas adicionales NO aparecerán como opción para ser elegidas.

Radio de check-in (checkinRaio)

Entero (10)

3.20

Radio en metros del cliente, utilizado para el Módulo de Check-in.

Días de check-in (checkinDias)

Entero (10)

3.20

Cantidad de días desde el último Check-in, utilizado para el Módulo de Check-in.

Condiciones de pago adicionales (condicoesAdicionais)

Texto (255)

3.28

Condiciones de pago adicionales a las que el cliente podrá tener acceso.
En caso de que el cliente tenga una condición bloqueada, las condiciones adicionales NO aparecerán como opción para ser elegidas.

Observación de integración (observacaoIntegracao)

Texto (2000)

3.34

Cuando está integrado se muestra un ícono de ojo en el registro del cliente y esta observación se visualiza al hacer clic en él.

Límite de crédito (limiteCredito)

Decimal

3.37

Utilizado para bloquear pedidos de clientes que superen el límite de crédito. También se utiliza en el Módulo de cobranzas financieras.

Porcentaje del margen de contribución (percMargemContribuicao)

Decimal (8,2)

3.38

Utilizado para el cálculo en el Módulo de Margen de Contribución.

Vendedores comisionistas/delegados (VendedoresPrepostos)

Texto (500)

3.42

Son vendedores/representantes que el propio vendedor/representante gestiona. Ejemplo: El representante de la Empresa ABC contrata un Vendedor para vender para él; este será un Vendedor delegado de este Representante.

Jerarquía predeterminada del cliente (codHierarquiaLiberacaoPedido)

Texto (255)

3.42

Tipo de cliente (codTipoCliente)

Texto (30)

4.18

Código de la tabla Tipos de Cliente.

División de ventas (codDivisaoVenda)

Texto (30)

4.18

Código de la tabla Divisiones de Venta.

Tipo de pedido predeterminado (codTipoPedido)

Entero

4.22

Define el tipo de pedido predeterminado del cliente. Este tipo de pedido se seleccionará automáticamente al iniciar un nuevo pedido. Cuando está bloqueado, no se permite la modificación del tipo de pedido, según los ejemplos a continuación.

Si bloqueiaTipoPedido = 1.
Solo se muestra el tipo de pedido definido al crear un Pedido y no se puede modificar.

Si bloqueiaTipoPedido = 0 y tiene un tipo de pedido definido.
Este se cargará como predeterminado, pero se permite modificarlo.

Si bloqueiaTipoPedido = 0 y NO tiene un tipo de pedido definido.
No se cargará un tipo de pedido, pero se permite seleccionar otro tipo de pedido.

Este campo no se limpia cuando se envía vacío desde el ERP a Demander. Para limpiar el campo, se debe enviar el código de un tipo de pedido que no esté registrado.

Bloquear edición del tipo de pedido (bloqueiaTipoPedido)

Booleano

4.22

Este campo impide que el vendedor modifique el tipo de pedido predeterminado del cliente al emitir un pedido.

Tipos de pedido adicionales (tipoPedidoAdicionais)

Texto (255)

4.22

Tipos de pedido adicionales a los que el cliente podrá tener acceso.
Si el cliente tiene el tipo de pedido bloqueado, los tipos de pedido adicionales NO aparecerán como opciones disponibles.

Valor de descarga (valorDescarga)

Decimal (10,5)

4.47

Valor de descarga por kg de peso neto del Pedido.

Se puede utilizar en el cálculo de Gastos Accesorios.

Permite modificar el valor del Gasto Accesorio
(permiteAlterarDespesaAcessoria)

Booleano

4.51

Determina si el vendedor puede o no modificar el valor sugerido para el "Gasto Accesorio" en los pedidos de este cliente.

Requiere orden de compra
(exigeOrdemDeCompra)

Booleano

4.55

Determina si el campo "orden de compra" es obligatorio para este cliente.

* Solo tiene efecto cuando el "Tipo de Pedido" también "requiere orden de compra";
* Si la obligatoriedad del campo "Orden de compra" es "Oculto", esta configuración no tiene ningún efecto.

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

Tabla 18 - Clientes

Artículos relacionados