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

Observação: O campo 'Integração' possui valores de 'SIM' e 'NÃO'. O valor 'SIM' significa que não está integrado, sendo necessária integra-las e o valor 'NÃO' significa que não será necessário integrar.

O campo 'Observação' é composto por três valores, 'Integrada' e 'Não Integradas'. 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.

INTEGRAÇÃO
CAMPO GEOSALES	TABELA GEOSALES	INTEGRAÇÃO	OBSERVAÇÃO
CD_COND_PGTO_PADRAO	CONDICAO_PAGAMENTO	NÃO	Integrada
CD_GRUPO	GRUPO_CLIENTE	SIM	Não é Integrada
CD_ROTA	ROTA	NÃO	Integrada
CD_SETOR_VENDA	SETOR_VENDA	SIM	Não é Integrada
DS_REGIAO		SIM	Não é Integrada
DS_SEGMENTO_1	SEGMENTO	SIM	Não é Integrada
DS_SEGMENTO_2	SEGMENTO	SIM	Não é Integrada
DS_SEGMENTO_3	SEGMENTO	SIM	Não é Integrada
ID_TIPO_FRETE_PADRAO	TIPO_FRETE	NÃO	Integrada
NM_MUNICIPIO	MUNICIPIO	SIM	Não é Integrada
CD_UF	UF	SIM	Não é 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, ficará com o valor NULL como padrão, neste caso os campos estarão desabilitados.

Serão criadas as tabelas de SETOR_VENDA, onde só terá descrição do setor de venda (DS_SETOR) e o código de cada setor de venda (CD_SETOR) e a tabela SEGMENTO, onde terá a descrição do segmento (DS_SEGMENTO), o código do segmento (CD_SEGMENTO) e o código pai do segmento (CD_PAI).

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.

Por exemplo: O vendedor está fazendo o cadastro de cliente novo, e começa a preencher os dados de segmento, o segmento 1, é seleciona o campo segmento (onde será exibido uma sequencia de dados), ficou visível na tela as opções de '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

As informações contidas no exemplo e na tabela de segmento acima, são meramente ilustrativas.

Para armazenar as informações de cliente prospect, serão criados novos campos na tabela de '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, terão que ser integrados para o ambiente GeoSales, ficando assim disponível para o vendedor selecionar os dados no cadastro do cliente prospect.

Segue abaixo tabela com informações dos campos que precisam ser incluídos:

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	SIM	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)	SIM	NÃO	Código do setor de venda	A1_XSETOR	SZ2		SIM
CD_TAB_PRECO_PADRAO	Int	SIM	NÃO	Tabela de preço de venda	A1_TABELA			NÃO
CD_VENDEDOR	Varchar(20)	SIM	NÃO	Código do vendedor responsável	A1_VEND			NÃO
DS_CONTATO	Varchar (30)	SIM	NÃO	Nome do contato da empresa cliente	A1_CONTATO		Caracteres em caixa alta	NÃO
DS_ENDERECO	Varchar (70)	SIM	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)	SIM	NÃO	O 1o. segmento de negócio da empresa	A1_SATIV1	SX5	tabela = T3	SIM
DS_SEGMENTO_2	Varchar(100)	SIM	NÃO	O 2o. segmento de negócio da empresa	A1_SATIV2	SX5	tabela = T3	SIM
DS_SEGMENTO_3	Varchar(100)	SIM	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 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)	SIM	NÃO	Bairro do cliente	A1_BAIRRO			NÃO
NM_CLIENTE	Varchar (100)	SIM	NÃO	Nome ou razão social do cliente	A1_RAZAO		Caracteres em caixa alta	NÃO
NM_MUNICIPIO	Varchar (80)	SIM	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	SIM	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_INSCRICAO_MUNICIPAL	Varchar(30)	NÃO	NÃO	Inscrição municipal do cliente	A1_INSCRM			NÃO
NR_SEQ_ATEND	Int	SIM	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 na 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.

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.

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 - Os campos NM_MUNICIPIO e UF, serão populadas automaticamente pelo Geosales, não havendo necessidade de integrá-las.

RI10 - Não será integrado nenhuma outra informação que não se encontre neste documento.

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		00/00/0000

Empresa solicitante

Setor	Aprovado Por	Data	Assinatura
Gerente TI
Gerente Projeto
Gerente Comercial