Cadastro de cliente prospect
Histórico de Revisões
| Data | Quem | Comentários |
|---|---|---|
| 12/06/2018 | Ryvane Maria | Criação do Documento |
| 15/06/2018 | João Felipe Maciel | Ajustes no Documento |
| 20/06/2018 | Ryvane Maria | Ajustes e finalização do Documento |
| 21/06/2018 | Leonardo Sousa | Aprovação de documentação |
| 03/08/2018 | Ana Júlia | Atualização da documentação |
Necessidade
Atualmente uma ficha cadastral de novos clientes é preenchida manualmente. Esta ficha contém algumas informações que não estão contidas no atual cadastro de prospect do Geosales. Essas informações, por sua vez, são primordiais à análise dos novos clientes cadastrados.
É importante, também, que este novo cliente tenha seu cadastro enviado ao ERP e que este cadastro seja inserido com o status 'Bloqueado'. Além disso, é necessário identificar que o cliente está com o status bloqueado por se tratar de um novo cliente, ou seja, clientes prospect devem entrar no ERP com status de bloqueado, e identificados com o motivo do bloqueio (no caso, cliente prospect).
Solução
Para que este cadastro de clientes prospect do GeoSales receba as informações que são cadastradas pela empresa atualmente, será feita uma adequação na plataforma GeoSales de forma que esta possa vir a receber (por meio de cadastro no portal ou no aplicativo mobile) as informações utilizadas no cadastro de clientes prospect. Com esta finalidade, serão criados novos campos para cadastro dessas informações,e ,ao passo deste cadastro, os campos serão salvos e enviados ao ERP no momento da integração de cadastro de clientes prospect.
É também no momento da integração que o cliente terá seu status setado como 'bloqueado', bem como será inserida uma flag com a finalidade de identificar o tipo de bloqueio daquele cliente, que, neste caso, é por ser um cliente prospect.
Integração
As tabelas contendo a informação de cadastro de cliente prospect deverão ser enviadas ao ERP, como já ocorre atualmente, incluindo-se todos os campos que serão adicionados.
Além disso é no momento da integração que o status do cliente deverá ser salvo como 'Bloqueado' no ERP. Para setar esse status, deve-se inserir o valor '1' no campo 'A1_MSBLQL', que significa que o cliente está bloqueado pelo tipo '1', novo cliente.
Deve ser setado, também, o campo 'A1_XGRUPO' com o valor 'PC', informando assim, que o cliente é um cliente prospect (Pré-Cadastro).
Os campos que possuem ListBox setado para 'SIM', terão que ser integrados, caso não exista em nossa base. Outros serão populados automaticamente em nossa base, ou seja, não havendo necessidade de integração. Segue abaixo tabelas que serão integradas e as que não precisam ser integradas.
O campo DS_REGIAO será tratado na integração, onde será classificado as regiões do Brasil (Norte, Nordeste, Centro-Oeste, Sudeste e Sul) de acordo com o estado que o vendedor selecionou na hora do cadastro de cliente novo.
Observação: O campo 'Integração' é composto por dois valores, 'Integrada' e 'Não Integrada'. O valor 'Integrada' significa que já está sendo enviada ao Geosales, e o valor 'Não Integrada' significa que não está sendo enviada ao GeoSales. As que possuem o valor 'Não Integrada', será necessário traze-las ao GeoSales, ou seja, integrar.
| INTEGRAÇÃO | |||||
|---|---|---|---|---|---|
| CAMPO GEOSALES | TABELA GEOSALES | INTEGRAÇÃO | |||
| CD_COND_PGTO_PADRAO | CONDICAO_PAGAMENTO | Integrada | |||
| CD_GRUPO | GRUPO_CLIENTE | Não é Integrada | |||
| CD_ROTA | CLIENTE_ROTA_APROVACAO | Integrada | |||
| CD_SETOR_VENDA | SETOR_VENDA | Não é Integrada | |||
| DS_REGIAO | * | Não é Integrada | |||
| DS_SEGMENTO_1 | SEGMENTO | Não é Integrada | |||
| DS_SEGMENTO_2 | SEGMENTO | Não é Integrada | |||
| DS_SEGMENTO_3 | SEGMENTO | Não é Integrada | |||
| ID_TIPO_FRETE_PADRAO | TIPO_FRETE | Integrada | |||
| NM_MUNICIPIO | MUNICIPIO | Integrada | |||
| CD_UF | UNIDADE_FEDERATIVA | Integrada | |||
Desenvolvimento
As telas de cadastro de prospect, tanto do mobile quanto do portal, deverão ser alteradas de forma a contemplar o cadastro dos novos campos que serão criados (vide tabela abaixo).
Para que esses campos sejam exibidos no cadastro de cliente prospect no GeoSales, deverá ser criada uma configuração chamada 'ID_HABILITA_DETALHES_PROSPECT' para ativá-los. Essa configuração poderá receber o valor 'S', para ativar a exibição dos campos ou 'N' para desativar. Caso essa configuração não seja ativada, será setado o valor NULL como padrão, neste caso, os campos estarão desabilitados.
Será criada a tabela SETOR_VENDA, que conterá os campos de descrição do setor de venda (DS_SETOR) e o código de cada setor de venda (CD_SETOR).
Na tabela SEGMENTO, será necessário criar uma coluna que receba o código pai do segmento (CD_PAI), para que seja possível fazer os vínculos de segmentos. No mobile quando o vendedor for selecionar o segmento, será exibido a descrição do segmento, mas deverá ser salvo e enviado ao ERP do cliente o código do segmento.
As informações de segmento serão tratadas de uma maneira que uma informação complete a outra, por isso será criado na tabela de segmento a coluna CD_PAI. Quando um segmento for salvo na tela do mobile, deverá ser salvo na tabela CLIENTE_APROVACAO o código do segmento salvo no moble.
Por exemplo: O vendedor está fazendo o cadastro de cliente novo, e começa a preencher os dados de segmento, no segmento 1 o vendedor seleciona o primeiro segmento; estarão disponíveis para seleção uma sequencia de dados previamente cadastradas no ERP; em que estarão visíveis na tela as opções 'Varejistas' e 'Atacadistas', o vendedor selecionou a opção 'Varejista'. No segmento 2, será exibido as opções 'Varejista comercial' e 'Varejista Local', o vendedor seleciona a opção 'Varejista comercial'. No segmento 3, será exibido as opções 'Depósito de Bebidas' e 'Supermercado', o vendedor seleciona a opção 'Supermercado', dessa maneira o cadastro de segmento está concluído.
| TABELA SEGMENTO | |||||
|---|---|---|---|---|---|
| CD_SEGMENTO | DS_SEGMENTO | CD_PAI | |||
| 001 | VAREJISTA | 002 | |||
| 002 | VAREJISTA COMERCIAL | 003 | |||
| 003 | VAREJISTA LOCAL | 004 | |||
| 004 | DEPOSITO DE BEBIDAS | NULL | |||
| 004 | SUPERMERCADO | NULL | |||
| 005 | ATACADISTA | 005 | |||
| 006 | MERCADO | NULL | |||
Obs.: As informações contidas no exemplo e na tabela de segmento acima, são meramente ilustrativas.
Com a finalidade de armazenar as informações de cliente prospect, serão criados novos campos na tabela 'CLIENTE_APROVACAO', alguns desses campos já existem, não havendo a necessidade de cria-los novamente. Os dados de cliente prospect serão integrados no ERP, de acordo com o que foi cadastrado e salvo na tabela de CLIENTE_APROVACAO.
Os campos que possuem 'ListBox', sinalizados na tabela abaixo, deverão ser integrados para o ambiente GeoSales, tornando-se então disponíveis para o vendedor selecionar os dados, previamente cadastrados no ERP, no cadastro do cliente prospect.
Segue abaixo tabela com informações dos campos que precisam ser incluídos:
- Deverá ser criadas configurações para que seja controlada a obrigatoriedade dos campos citados na tabela abaixo. A configuração terá como padrão a nomenclatura, tendo sufixo 'CAMPO_OBR:' mais o prefixo sendo o nome da coluna que será obrigatória. As configurações poderão receber o valor 'S', para ativar a exibição dos campos ou 'N' para desativar. Caso essa configuração não seja ativada, será setado o valor NULL como padrão, neste caso, os campos estarão desabilitados.
| CLIENTE_APROVACAO | ||||||||
|---|---|---|---|---|---|---|---|---|
| NOME | TIPO | OBRIGATÓRIO | CHAVE PRIMÁRIA | OBSERVAÇÃO | CAMPO ERP | TABELAS DE SELEÇÃO | VALIDAÇÃO | CAMPOS LISTBOX |
| CD_COND_PGTO_PADRAO | Int | NÃO | NÃO | Condição de pagamento padrão | A1_COND | SE4 | E4_CODIGO cujo o valor inicie com a letra "C" | SIM |
| CD_GRUPO | Varchar(20) | NÃO | NÃO | Código do grupo de clientes | A1_GRPVEN | ACY | SIM | |
| CD_ROTA | Int | SIM | NÃO | Código da rota | A1_XROTA | SZ3 | SIM | |
| CD_SETOR_VENDA | Varchar(30) | NÃO | NÃO | Código do setor de venda | A1_XSETOR | SZ2 | SIM | |
| CD_TAB_PRECO_PADRAO | Int | NÃO | NÃO | Tabela de preço de venda | A1_TABELA | NÃO | ||
| CD_VENDEDOR | Varchar(20) | NÃO | NÃO | Código do vendedor responsável | A1_VEND | NÃO | ||
| DS_CONTATO | Varchar (30) | NÃO | NÃO | Nome do contato da empresa cliente | A1_CONTATO | Caracteres em caixa alta | NÃO | |
| DS_ENDERECO | Varchar (70) | NÃO | NÃO | Endereço do cliente | A1_END | Caracteres em caixa alta | NÃO | |
| DS_HOMEPAGE | Varchar(300) | NÃO | NÃO | HomePage do cliente | A1_HPAGE | NÃO | ||
| DS_REGIAO | Varchar(20) | NÃO | NÃO | Região de vendas do cliente | A1_REGIAO | SX5 | tabela = A2 | SIM |
| DS_SEGMENTO_1 | Varchar(100) | NÃO | NÃO | O 1o. segmento de negócio da empresa | A1_SATIV1 | SX5 | tabela = T3 | SIM |
| DS_SEGMENTO_2 | Varchar(100) | NÃO | NÃO | O 2o. segmento de negócio da empresa | A1_SATIV2 | SX5 | tabela = T3 | SIM |
| DS_SEGMENTO_3 | Varchar(100) | NÃO | NÃO | O 3o. segmento de negócio da empresa | A1_SATIV3 | SX5 | tabela = T3 | SIM |
| DT_NASCIMENTO | Datetime | NÃO | NÃO | Data de nascimento do cliente | A1_DTNASC | NÃO | ||
| DS_EMAIL | Varchar (200) | NÃO | NÃO | E-mail do Cliente | A1_EMAIL | Validar se a sintaxe do e-mail digitado é válido | NÃO | |
| ID_TIPO_FRETE_PADRAO | Char(1) | NÃO | NÃO | Tipo de frete do cliente (C para CIF, F para FOB) | A1_TPFRET | Buscar informações do tipo de frete CIF/FOB | SIM | |
| NM_BAIRRO | Varchar (40) | NÃO | NÃO | Bairro do cliente | A1_BAIRRO | NÃO | ||
| NM_CLIENTE | Varchar (100) | NÃO | NÃO | Nome ou razão social do cliente | A1_RAZAO | Caracteres em caixa alta | NÃO | |
| NM_MUNICIPIO | Varchar (80) | NÃO | NÃO | Municipio do cliente | A1_MUN | CC2 | SIM | |
| NR_CNPJ_CPF | varchar (25) | SIM | NÃO | CNPJ/CPF do cliente | A1_CGC | Validar se código do CPF e CNPJ são válidos | NÃO | |
| NR_FREQUENCIA_VISITA | Int | NÃO | NÃO | Intervalo de dias entre as visitas ao cliente | A1_TEMVIS | NÃO | ||
| NR_IDENTIDADE | Varchar(30) | NÃO | NÃO | Número do RG do cliente | A1_PFISICA | NÃO | ||
| NR_INSCRICAO_ESTADUAL | Varchar(30) | NÃO | NÃO | Inscrição estadual do cliente | A1_INSCR | NÃO | ||
| NR_CGF | Varchar(30) | NÃO | NÃO | Inscrição municipal do cliente | A1_INSCRM | NÃO | ||
| NR_SEQ_ATEND | Int | NÃO | NÃO | Ordem do percurso de atendimento do cliente na rota | A1_XXPERCU | NÃO | ||
| NR_TELEFONE | Varchar(25) | NÃO | NÃO | Número de Celular para contato | A1_XCELULA | NÃO | ||
| UF | varchar (2) | SIM | NÃO | Unidade federativa do cliente | A1_EST | SIM | ||
| VR_LIMITE | Decimal | NÃO | NÃO | Limite de crédito do cliente | A1_LC | NÃO | ||
A coluna 'validação' define quais validações o sistema terá que fazer na hora do preenchimento do cadastro de cliente prospect.
A coluna 'LISTBOX', determina quais os campos que o usuário deverá selecionar a informação ao invés de digitá-la. Caso a coluna 'LISTBOX' esteja preenchido com o valor 'SIM', as opções que o usuário poderá selecionar como reposta, para este item do cadastro de prospect, estarão cadastradas na tabela contidas na coluna 'TABELAS DE SELEÇÃO'.
As tabela contidas na coluna 'TABELAS DE SELEÇÃO' serão trazidas do ERP via integração e salvas no GeoSales.
Por exemplo: Quando o usuário estiver cadastrando um cliente prospect, e selecionar a opção 'Condição de Pagamento', o sistema exibirá um campo do tipo selectbox, tendo como possibilidades de repostas as informações contidas na tabela SE4, o dado selecionado neste campo será salvo no campo CD_COND_PGTO_PADRAO da tabela CLIENTE_APROVACAO.
Não será necessário criar no mobile ou portal campo com informações de região (DS_REGIAO), pois a informação de região será tratada na integração.
Regras de Negócio
RN1 - Não será criado nenhum outro campo além dos que estão contemplados neste documento.
RN2 - Para que seja inserida a informação "PC" no campo “A1_XGRUPO”, é necessário que esteja sendo aplicado o modelo Claudus de integração.
RN3 - Deverá ser habilitado o status 'bloqueado' aos clientes prospect que forem recém cadastrados.
RN4 - Os campos cadastrados só serão incluídos no cadastro de prospect caso a configuração ID_HABILITA_DETALHES_PROSPECT estiver setada com o valor 'S'.
RN5 - Não será realizado nenhuma outra validação das que se encontram neste documento.
RN6 - O campo DS_REGIAO, será alimentada diretamente na integração, onde o vendedor não irá precisar selecionar a região, de acordo com o estado que for selecionado a integração setará para a região de destino.
Regras de Integração
RI1 - O campo A1_PESSOA da tabela SA1, deverá ser preenchido, no momento da integração, com o valores 'J' caso se trate de uma pessoa jurídica e 'F' caso se trate de uma pessoa física.
RI2 - A tabela ACY do ERP, que alimenta a tabela GRUPO_CLIENTE terá que ser enviado pela Reflexa, caso contrário não terá informações no selectbox.
RI3 - A tabela SZ2 do ERP , que alimenta a tabela SETOR_VENDA terá que ser enviado pela Reflexa, caso contrário não terá informações no selectbox.
RI4 - A tabela de seleção SX5 do ERP da tabela A2, que alimenta a tabela 'DS_REGIAO' terá que ser enviado pela Reflexa, caso contrário não terá informações no selectbox.
RI5 - A tabela de seleção SX5 do ERP da tabela T3, que alimenta a tabela 'DS_SEGMENTO_1' terá que ser enviado pela Reflexa, caso contrário não terá informações no selectbox.
RI6 - A tabela de seleção SX5 do ERP da tabela T3, que alimenta a tabela 'DS_SEGMENTO_2' terá que ser enviado pela Reflexa, caso contrário não terá informações no selectbox.
RI7 - A tabela de seleção SX5 do ERP da tabela T3, que alimenta a tabela 'DS_SEGMENTO_3' terá que ser enviado pela Reflexa, caso contrário não terá informações no selectbox.
RI8 - Os campos CD_COND_PGTO_PADRAO, CD_ROTA e ID_TIPO_FRETE_PADRAO já se encontram sendo enviadas ao GeoSales, não havendo necessidade de integrá-las novamente.
RI9 - A tabela de seleção CC2 do ERP, que alimenta a tabela 'MUNICIPIO' terá que ser enviado pela Reflexa, caso contrário não terá informações no selectbox.
RI10 - Não será integrado nenhuma outra informação que não se encontre neste documento.
RI11 - Será necessário tratar os dados de DS_REGIAO, onde levará a informação de região de acordo com o estado selecionado para o cliente novo.
Aprovação
Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.
GeoSales
| Setor | Aprovado Por | Data |
|---|---|---|
| Desenvolvimento - GeoSales | 00/00/0000 | |
| Integração - GeoSales | Carlos Robson | 06/08/2018 |
Empresa solicitante
| Setor | Aprovado Por | Data | Assinatura |
|---|---|---|---|
| Gerente TI | |||
| Gerente Projeto | |||
| Gerente Comercial |