Especificação de Requisitos | |
Projeto/Versão: PDR_SER_TUR-P12 | Requisito/Módulo: PCREQ-XXXX/SIGATUR |
Sub-Requisito/Função: | Tarefa/Chamado: |
País: All | Data Especificação: 20/04/2016 |
Rotinas Envolvidas | ||
Rotina | Tipo de Operação | Opção de Menu |
TURA018.PRW | Alteração | Atualizações-> Cadastro de Cliente -> Complemento de Cliente |
FATXFUN.PRX | Alteração |
|
TURICRED.PRW | Criação |
|
Estratégia de Desenvolvimento e Liberação | |
Produto | Microsiga Protheus |
Release que está sendo desenvolvido | Versão 12 |
Possui Réplica? | ( ) Sim ( X ) Não |
Qual a versão? | 12.1.8 |
Avaliação de Crédito - Cliente
Objetivo
Alteração do cadastro de complemento de cliente que será utilizado para determinar e avaliar o crédito de um cliente.
Definição da Regra de Negócio
Numa agência de viagem existem diversos critérios de avaliação de crédito referente a um cliente, as agencias de viagens necessitam avaliar o crédito dos seus clientes conforme o segmento de negócio, pois cada segmento possue limites diferenciado.A agencia precisa no momento da venda (Frontoffice) avaliar o crédito do cliente com relação ao valor da venda que representa em média 85% , desconsiderando as receitas, pois somente após integrado seriam aplicados os acordos que compõem a receita.
Dessa forma, para que possa analisar o credito de um cliente serão criados campos no cadastro de "Complemento de Cliente" e parâmetros de controle.
Nesse cadastro serão atribuídos campos relativos a Risco, Limite de crédito, Vencimento do Limite e Moeda por segmento de negócio (Corporativo, Evento e Lazer).
Futuramente será criada uma mensagem única no padrão para avaliação de crédito que receberá Cliente/Loja, valor a ser analisado/avaliado e o segmento de negócio. Esta mensagem retornará se o valor ultrapassará ou não o limite de crédito e saldo de crédito naquele momento, considerando os itens financeiros em aberto e os reembolsos, que contarão como crédito para aquele cliente naquele segmento e a soma de seus títulos em aberto.
Risco
Grau de risco na aprovação do crédito do cliente, onde pode assumir conteúdos distintos:
• Risco A - significa que não existe risco para venda, ou seja, o valor estaria aprovado, exceto se a data do vencimento do limite de crédito estiver ultrapassada.
• Risco B - esta situação depende do conteúdo do parâmetro MV_RISCOB[C/E/L] que indica o número de dias de atraso tolerável no pagamento de títulos de clientes, além disso, é considerado também o valor do limite de crédito e a data de vencimento do limite de crédito do cliente.
• Risco C - esta situação depende do conteúdo do parâmetro MV_RISCOC[C/E/L] que indica o número de dias de atraso tolerável no pagamento de títulos de clientes, além disso, é considerado também o valor do limite de crédito e a data de vencimento do limite de crédito do cliente.
• Risco D - esta situação depende do conteúdo do parâmetro MV_RISCOD[C/E/L] que indica o número de dias de atraso tolerável no pagamento de títulos de clientes, além disso, é considerado também o valor do limite de crédito e a data de vencimento do limite de crédito do cliente.
• Risco E - significa que existe um grande risco na venda, ou seja, o valor sempre ultrapassa o limite.
Aplicação Prática:
Considerando que, no cadastro de um cliente o campo Risco está definido como A, ao avaliar qualquer valor do segmento, este estaria valido, pois quando o cliente está classificado como Risco A, indica que não existe restrição, sendo assim todos as avaliações estariam validas.
Já no caso de outro cliente classificado como Risco E, na avaliação, independente do valor, sempre estará invalido por crédito.
Exemplo:
Estão definidos os parâmetros com os seguintes conteúdos:
• MV_RISCOBC = 30 (tolerância de até 30 dias de atraso no pagamento dos títulos)
• MV_RISCOCC = 20 (tolerância de até 20 dias de atraso no pagamento dos títulos)
• MV_RISCODC = 10 (tolerância de até 10 dias de atraso no pagamento dos títulos)
Se o cliente for classificado como Risco B (Considerando segmento Corporativo), estará valido por crédito mesmo que existam títulos a receber em aberto até 30 dias da data de vencimento real, caso este período seja ultrapassado, não estará valido.
Segue o mesmo conceito para os clientes considerados Risco C e Risco D, sempre é analisado o conteúdo do parâmetro e os dias de atrasos de pagamento dos títulos.
Limite de Crédito
No campo Limite de Crédito é definido o valor total do limite de crédito do cliente, valor relacionado ao campo Moeda 1 (moeda nacional).
Vencimento do Limite
No campo Vencimento do Limite é definida a data do vencimento do limite de crédito do cliente e está diretamente relacionado aos campos Limite de Crédito.
Moeda do Limite de Crédito
O campo Moeda do Limite de Crédito é utilizado para definir a moeda forte para controle dos limites de crédito e seus respectivos saldos.
Protótipo de Tela (Figuras meramente ilustrativas)
Tela do cadastro de Complemento de Cliente – Aba de Análise de Crédito
Atributos
( * ) – Campos obrigatórios
( ** ) – Campos chaves da tabela
– Campos internos do sistema
Cabeçalho
Atributos
– Campos obrigatórios
(**) – Campos chaves da tabela
Nome | Descrição | Exemplo |
Filial (**) | Código da Filial do sistema | 01 – Matriz |
Código (**) | Código do complemento | 000001 |
Segmento (**) | Código do Segmento
|
|
Risco | Grau de Risco do cliente – Segmento Corporativo
| B |
Limite | Limite de Cred.do cliente – Segmento Corporativo | 30.000,00 |
Vencimento | Vencimento do Lim. Credit – Segmento Corporativo | 31/12/15 |
Moeda | Moeda do Limite de credit – Segmento Corporativo | 1 |
Considerações:
- Somente deve ser habilitado para edição os campos dos segmentos em que o complemento estiver com seu respectivo segmento ativado.
- Caso um dos segmentos do complemento for desativado devem ser limpos seus respectivos campos de crédito.
- Para a analise do crédito serão utilizados os títulos gerados ou disponibilizados nas tabelas do módulo financeiro
Parâmetros:
- Número de dias de Atraso tolerável no Pagamento de Títulos para Clientes com Risco B no Cadastro de Clientes, utilizado na Liberação de Credito:
MV_RISCOBC – Segmento Corporativo
MV_RISCOBE – Segmento Evento
MV_RISCOBL – Segmento lazer
- Número de dias de Atraso tolerável no Pagamento de Títulos para Clientes com Risco C no Cadastro de Clientes, utilizado na Liberação de Credito:
MV_RISCOCC – Segmento Corporativo
MV_RISCOCE – Segmento Evento
MV_RISCOCL – Segmento lazer
- Número de dias de Atraso tolerável no Pagamento de Títulos para Clientes com Risco D no Cadastro de Clientes, utilizado na Liberação de Credito:
MV_RISCOCC – Segmento Corporativo
MV_RISCOCE – Segmento Evento
MV_RISCOCL – Segmento lazer
Fluxo
Entidades e Relacionamentos
Mensagem Única (EAI)
- Desenvolver o fonte TURICRED, que fará todo o tratamento para o recebimento do XML, da seguinte forma:
Function TURICRED( cXML, nTypeTrans, cTypeMessage )
Local lRet := .T.
Local cXMLRet := ""
If nTypeTrans == TRANS_RECEIVE
If cTypeMessage == EAI_MESSAGE_BUSINESS
cXMLRet := '<TAGX>TESTE DE RECEPCAO BUSINESS MESSAGE</TAGX>'
ElseIf cTypeMessage == EAI_MESSAGE_RESPONSE
cXMLRet := '<TAGX>TESTE DE RECEPCAO RESPONSE MESSAGE</TAGX>'
ElseIf cTypeMessage == EAI_MESSAGE_WHOIS
cXMLRet := ' <Version>1.0 </Version>'
Endif
ElseIf nTypeTrans == TRANS_SEND
cXMLRet := '<TAGX>TESTE DE ENVIO</TAGX>'
EndIf
Return { lRet, cXMLRet }
- Essa mensagem será do Tipo Request
- No fonte TURICRED, deve ser adicionado a diretiva de include para o arquivo FWADAPTEREAI.CH;
- Microsigra Protheus recebe Mensagem Única:
- Ao receber a mensagem de negócio (BusinessMessage), o EAI verificará se a rotina TURICRED está cadastrada no "Adapter EAI" e se a mesma está configurada para o recebimento de mensagem no método Síncrono. Caso a rotina esteja cadastrada e configurada corretamente, a função IntegDef deverá chamar a rotina TURICRED que fará o tratamento do XML recebido, e efetuar a gravação dos dados;
- No final do processamento, deverá será enviada a mensagem de resposta (ResponseMessage) ao sistema requisitante com o status do processamento;
- Depois da alteração do fonte TURA018 e do desenvolvimento do fonte TURICRED, acessar o módulo Configurador e cadastrar o adapter através do menu Ambiente -> Schedule -> Adapter E.a.i da seguinte forma:
- Mensagem única: Sim;
- Rotina: TURICRED;
- Mensagem: TourismCreditEvaluation;
- Descrição: Analise de Credito Turismo;
- Envia: Não;
- Recebe: Sim;
- Método: Síncrono;
- Operação: Todas;
- Versão Envio: 1.000;
- A seguir, detalhe das informações necessárias para realizar a analise de crédito;
Tag Superior | TAG | Campo | Observação |
BusinessContentType | CompanyId |
| Código |
BusinessContentType | BranchId | A1_FILIAL | Código da Filial |
BusinessContentType | CompanyIternalId |
| InternalId da chave Empresa+Filial |
BusinessContentType | CustomerCode | A1_COD+A1_LOJA | Código |
BusinessContentType | CustomerInternalId |
| InternalId do Cliente+Loja |
BusinessContentType | Value |
| Valor a ser analizado |
BusinessContentType | TravelCurrency | G8T_MOEDA | Código da Moeda de Turismo |
BusinessContentType | TravelCurrencyInternalId |
| InternalId da Moeda de Turismo |
BusinessContentType | TradingProcess |
| Segmento de Negócio ("1"-Corporativo / "2"-Eventos / "3"-Lazer) |
Fluxo do Processo
Protótipo de Tela (Figuras meramente ilustrativas)
Browser do cadastro de Adpater E.a.i
Formulário de Cadastro do Adapter E.a.i – TURICRED
Arquivo SX6 – Parâmetros
Variável
MV_RISCOBC
Tipo
N
Descrição
Numero de dias de Atraso toleravel no Pagamento de Titulos para Clientes com Risco B utilizado no credito de turismo corporativo.
Conteúdo
30
Variável
MV_RISCOBE
Tipo
N
Descrição
Numero de dias de Atraso toleravel no Pagamento de Titulos para Clientes com Risco B utilizado no credito de turismo evento.
Conteúdo
30
Variável
MV_RISCOBL
Tipo
N
Descrição
Numero de dias de Atraso toleravel no Pagamento de Titulos para Clientes com Risco B utilizado no credito de turismo lazer.
Conteúdo
30
Variável
MV_RISCOCC
Tipo
N
Descrição
Numero de dias de Atraso toleravel no Pagamento de Titulos para Clientes com Risco C utilizado no credito de turismo corporativo.
Conteúdo
""
Variável
MV_RISCOCE
Tipo
N
Descrição
Numero de dias de Atraso toleravel no Pagamento de Titulos para Clientes com Risco C utilizado no credito de turismo evento.
Conteúdo
""
Variável
MV_RISCOCL
Tipo
N
Descrição
Numero de dias de Atraso toleravel no Pagamento de Titulos para Clientes com Risco C utilizado no credito de turismo lazer.
Conteúdo
""
Variável
MV_RISCODC
Tipo
N
Descrição
Numero de dias de Atraso toleravel no Pagamento de Titulos para Clientes com Risco D utilizado no credito de turismo corporativo.
Conteúdo
""
Variável
MV_RISCOCDE
Tipo
N
Descrição
Numero de dias de Atraso toleravel no Pagamento de Titulos para Clientes com Risco D utilizado no credito de turismo evento.
Conteúdo
""
Variável
MV_RISCODL
Tipo
N
Descrição
Numero de dias de Atraso toleravel no Pagamento de Titulos para Clientes com Risco D utilizado no credito de turismo lazer.
Conteúdo
""
Arquivo SX2 – Tabela
Tabela
G8T
Arquivo
G8T990
Nome
ANALISE DE CREDITO - TURISMO
Modo
C
Modo Unidade
C
Modo Empresa
E
Unico
G8T_FILIAL+G8T_CODIGO+G8T_SEGNEG
Arquivo SIX – Índices
Índice
G8T
Ordem
01
Chave
G8T_FILIAL+G8T_CODIGO+G8T_SEGNEG
Descrição
Complemento + Segmento
- Arquivo SX3 – Campos da Tabela
Tabela G9I – Controle de Protocolos
Campo | G8T_FILIAL |
---|---|
Tipo | C |
Tamanho | 8 |
Decimal |
|
Formato |
|
Contexto | Real |
Propriedade | Alterar |
Título | Filial |
Descrição | Filial do Sistema |
Help | Filial do Sistema |
Lista de Opções |
|
Inic. Padrão |
|
Inic. Browse |
|
Modo Edição |
|
Cons. Padrão |
|
Val. Sistema |
|
Obrigatório | Não |
Usado | Não |
Browse | Não |
Campo | G8T_CODIGO |
---|---|
Tipo | C |
Tamanho | 06 |
Decimal |
|
Formato |
|
Contexto | Real |
Propriedade | Visual |
Título | Complemento |
Descrição | Codigo do Compl. Cliente |
Help | Codigo do Complemento do |
Lista de Opções |
|
Inic. Padrão |
|
Inic. Browse |
|
Modo Edição |
|
Cons. Padrão |
|
Val. Sistema |
|
Obrigatório | Não |
Usado | Sim |
Browse | Não |
Campo | G8T_SEGNEG |
Tipo | C |
Tamanho | 01 |
Decimal |
|
Formato |
|
Contexto | Real |
Propriedade | Visual |
Título | Segmento |
Descrição | Segmento |
Help | Segmento de Negócio do Cliente |
Lista de Opções | 1=Corporativo;2=Eventos;3=Lazer |
Inic. Padrão |
|
Inic. Browse |
|
Modo Edição |
|
Cons. Padrão |
|
Val. Sistema | Vazio() .Or. Pertence("123") |
Obrigatório | Não |
Usado | Sim |
Browse | Não |
Campo | G8T_RISCO |
---|---|
Tipo | C |
Tamanho | 01 |
Decimal |
|
Formato |
|
Contexto | Real |
Propriedade | Alterar |
Título | Risco |
Descrição | Classificação de Risco |
Help | Classificação de Risco do Cliente |
Lista de Opções | A=Risco A;B=Risco B;C=Risco C;D=Risco D;E=Risco E |
Inic. Padrão |
|
Inic. Browse |
|
Modo Edição | !Empty(FwFldGet("G8T_SEGNEG")) |
Cons. Padrão |
|
Val. Sistema | Vazio() .Or. Pertence("ABCDE") |
Obrigatório | Não |
Usado | Sim |
Browse | Não |
Campo | G8T_LIMITE |
---|---|
Tipo | N |
Tamanho | 14 |
Decimal | 02 |
Formato | @E 99,999,999,999.99 |
Contexto | Real |
Propriedade | Alterar |
Título | Limite Cred. |
Descrição | Limite de Credito |
Help | Limite de Credito do Cliente |
Lista de Opções |
|
Inic. Padrão |
|
Inic. Browse |
|
Modo Edição | !Empty(FwFldGet("G8T_SEGNEG")) |
Cons. Padrão |
|
Val. Sistema |
|
Obrigatório | Não |
Usado | Sim |
Browse | Não |
Campo | G8T_VENCTO |
---|---|
Tipo | D |
Tamanho | 08 |
Decimal |
|
Formato |
|
Contexto | Real |
Propriedade | Alterar |
Título | Vencimento |
Descrição | Vencimento da Análise |
Help | Vencimento da Análise de Crédito do Cliente |
Lista de Opções |
|
Inic. Padrão |
|
Inic. Browse |
|
Modo Edição | !Empty(FwFldGet("G8T_SEGNEG")) |
Cons. Padrão |
|
Val. Sistema |
|
Obrigatório | Não |
Usado | Sim |
Browse | Não |
Campo | G8T_MOEDA |
---|---|
Tipo | C |
Tamanho | 02 |
Decimal |
|
Formato |
|
Contexto | Real |
Propriedade | Alterar |
Título | Moeda |
Descrição | Moeda do Limite Crédito |
Help | Moeda do Limite Crédito |
Lista de Opções |
|
Inic. Padrão |
|
Inic. Browse |
|
Modo Edição | !Empty(FwFldGet("G8T_SEGNEG")) |
Cons. Padrão | G5T |
Val. Sistema | vazio() .or. ExistCpo("G5T",FwFldGet("G8T_MOEDA")) |
Obrigatório | Não |
Usado | Sim |
Browse | Não |
Assinaturas
Nome | Data | Assinatura |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|