Árvore de páginas

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
(estrela) – 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
Opções:

  • Corporativo
  • Eventos
  • Lazer

 

Risco

Grau de Risco do cliente – Segmento Corporativo
Opções:

  • A
  • B
  • C
  • D
  • E

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
Cliente

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