Boletim Técnico

Integração Financial Services

Produto : Microsiga Protheus® Controle de Loja e Front de Lojas versão 11

Chamado : TEXNRP Data da publicação : 19/10/12

País(es) : Todos Banco(s) de Dados : Todos

Esta melhoria depende de execução do update de base UPDLOJ90, conforme Procedimentos para
Implementação.

Criado o Wizard de Integração (LJWValConf) que realiza a configuração e/ou validação dos componentes necessários
para habilitar a integração via EAI (Enterprise Application Integration) - do Microsiga Protheus® com o Financial Services.

Alterada a rotina de Venda Assistida (LOJA701) para realizar a integração- via EAI com o Financial Services. Nessa
rotina foram disponibilizadas as seguintes operações:

 Envio da análise de crédito de pagamentos financiados durante a finalização do orçamento/venda.

 Reenvio da análise de crédito com status Reprovada para mesa de crédito do Financial Services (opção Reenv. Análise Cred
Financial).

 Liberação manual de análise de créditos com status Mesa de Crédito ou Sem análise/Off-line, (opção Lib Man Análise Cred
Financial ).

Para realizar a liberação, deve-se possuir a permissão, sinalizada na operação Liberação Manual do Orçamento
na Mesa de Crédito na aba Permissões na rotina de Caixa (Loja120).

Efetuadas validações/restrições na rotina de Atendimento (FRTA271), para os orçamentos que foram gerados na retaguarda e que
possuam análise de Crédito realizada pela integração com o Financial Services.

Implementada melhoria na função de geração das parcelas (LjParcela) dos títulos gerados a partir das vendas realizadas no Controle
de Lojas (SIGAlOJA) na rotina de Venda Assistida (LOJA701) e/ou na rotina de Atendimento (FRTA271) do Front-Loja (SIGAFRT). Para
utilizar a regra de sequenciamento das parcelas utilizada no módulo Faturamento (SIGAFAT), o parâmetro MV_LJPARFA deve estar
habilitado.

Criado o adapter de integração EAI (LOJA2503) que recebe o resultado da análise da mesa de crédito do orçamento, realizada no
sistema Financial Services, e altera o status da análise no orçamento do Microsiga Protheus®.

Criada a rotina automática (LOJA2500) que envia os dados dos títulos em atraso para o sistema de cobrança do Financial Services,
através do EAI.

SIGAFRT/SIGALOJA – Integração Financial Service 1

 Boletim Técnico

Foi criada a rotina automática (LOJA2501) que envia os dados dos pagamentos/estornos dos títulos que já foram enviados para
o sistema de cobrança do Financial Services, através da rotina automática de Envio dos títulos em atraso ao sistema de
cobrança do Financial Services (LOJA2500).

Devido aos dados necessários para geração da política de crédito no Financial Services, foi disponibilizado no
módulo Controle de Loja (SIGALOJA), a rotina Cadastro de Cliente (CRDA010) já existente no módulo Fidelização
e Análise de Crédito (SIGACRD). E bloqueado no módulo Controle de Loja (SIGALOJA) a rotina Clientes
(MATA030).

PROCEDIMENTO PARA IMPLEMENTAÇÃO

Para viabilizar essa melhoria, é necessário aplicar o pacote de atualizações (Patch) deste chamado.

Antes de executar o compatibilizador U_UPDLOJ90 é imprescindível:

a) Realizar o backup da base de dados do produto que será executado o cmpatibilizador(diretório
\PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (\PROTHEUS11_DATA\SYSTEM).
b) Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme
o produto instalado na empresa.
c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
d) Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador,
certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a
partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam
identificados pelo nickname.
e) O compatibilizador deve ser executado com a Integridade Referencial desativada*.

O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de
Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no
banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:

i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção

Integridade/Verificação (APCFG60A).
ii. Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais
cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é
necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a

2 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

verificação e aplicar normalmente o compatibilizador, conforme instruções.

iii. Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela
Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída,
ou;
iv. Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas
em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em)
integridade estará(rão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade
ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk
Framework para informações quanto a um arquivo que contém essa informação).
v. Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, é necessário desativar tal integridade,
selecionando a opção Integridade/Desativar (APCFG60D).
vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido
desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s)
empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a
ativação.

Contate o Help Desk Framework EM CASO DE DÚVIDAS!

1. Em Microsiga Protheus® Smart Client, digite U_UPDLOJ90 no campo Programa Inicial.

Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a
27/04/2012.
2. Clique em Ok para continuar.

3. Após é exibida uma mensagem de advertência sobre os componentes customizados do cliente e a necessidade de
sua execução em modo exclusivo.

4. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
Selecione a empresa desejada e confirme.

5. Clique em Ok para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos, conforme
mensagem explicativa apresentada na tela.

6. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas.
Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O
update/compatibilizador cria os campos que ainda não existem no dicionário de dados.

7. Clique em Gravar para salvar o histórico (log) apresentado.

8. Clique em Ok para encerrar o processamento.

9. Após a atualização, altere o conteúdo dos parâmetros para habilitar a integração com o Financial Services, ou
execute o Wizard de configuração da integração com o Financial Services (LJWValConf).

ATUALIZAÇÕES DO COMPATIBILIZADOR
1. Criação de Arquivos no arquivo SX2 – Cadastro de Arquivos:

SIGAFRT/SIGALOJA – Integração Financial Service 3

 Boletim Técnico

Chave MEQ

Nome Títulos Recebidos/Enviados

Compartilhamento E
Empresas

Compartilhamento E
Unidade Negócio

Compartilhamento E
Filial

Único MEQ_FILIAL + MEQ_PREFIX + MEQ_NUM + MEQ_PARCEL + MEQ_TIPO +

MEQ_OPERAC + DtoS(MEQ_DTINC)

PYE Sim

2. Criação de Campos no arquivo SX3 – Campos:

 Tabela SL1 - Orçamento:

Campo L1_USRST L1_DTST

Tipo C D

Tamanho 6 8

Decimal 0 0

Título Usr Análise Dt Análise

Descrição Usr Alt Status Análise Data Alt Status Análise

Nível 1 1

Usado Sim Sim

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Val. Sistema Vazio() .Or. UsrExist(M->L1_USRST)

Código do usuário que realizou manualmente a Data da alteração manual da alteração

Help alteração do status do orçamento enviado do status do orçamento enviado para a
para a mesa de crédito mesa de crédito

Campo L1_HRST L1_IFSANST

Tipo C C

Tamanho 6 1

Decimal 0 0

Formato @R 99:99:99

4 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

Título Hr Análise Stat Análise

Descrição Hora Alt Status Análise Status Análise Credito

Nível 1 1

Usado Sim Sim

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Hora da alteração manual da alteração do Status do Orçamento enviado para

Help status do orçamento enviado para a mesa de análise de crédito
crédito

1=Aprovado;0=Negado;2=Mesa de
Opções Crédito;9=Sem análise de
crédito/Offline

Campo L1_IFSCDM1 L1_IFSCDM2

Tipo C C

Tamanho 6 6

Decimal 0 0

Título Cod Mens 1 Cod Mens 2

Descrição Código da Mensagem do FS Código da Mensagem do FS

Nível 1 1

Usado Não Não

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Contém o código para o campo MEMO Contém o código para o campo MEMO
Help
L1_IFSMSG1 e LQ_IFSMSG1 L1_IFSMSG2 e LQ_IFSMSG2

Campo L1_IFSMSG1 L1_IFSMSG2

Tipo M M

Tamanho 255 255

Decimal 0 0

Título Mensagem 1 Msg Análise

Descrição Mensagem de Retorno do FS Msg Análise Crd Financial

Nível 1 1

SIGAFRT/SIGALOJA – Integração Financial Service 5

 Boletim Técnico

Usado Não Sim

Obrigatório Não Não

Browse Não Não

Contexto Virtual Virtual

Propriedade Visualizar Visualizar

IF(!INCLUI,MSMM(SL1->L1_IFSCDM2,
Relação IF(!INCLUI,MSMM(SL1->L1_IFSCDM1, 255),'')
255),'')

Grava a mensagem amigável do

Grava a mensagem do analista de crédito sobre a
Help analista de crédito para informação
avaliação realizada.
ao cliente

Formato @!

 Tabela SLQ - Orçamento:

Campo LQ_USRST LQ_DTST

Tipo C D

Tamanho 6 8

Decimal 0 0

Título Usr Análise Dt Análise

Descrição Usr Alt Status Análise Data Alt Status Análise

Nível 1 1

Usado Sim Sim

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Val. Sistema Vazio() .Or. UsrExist(M->LQ_USRST)

Código do usuário que realizou manualmente a Data da alteração manual da alteração

Help alteração do status do orçamento enviado do status do orçamento enviado para a
para a mesa de crédito mesa de crédito

Campo LQ_HRST LQ_IFSANST

Tipo C C

Tamanho 6 1

Decimal 0 0

Formato @R 99:99:99

Título Hr Análise Stat Análise

6 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

Descrição Hora Alt Status Análise Status Análise Credito

Nível 1 1

Usado Sim Sim

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Hora da alteração manual da alteração do Status do Orçamento enviado para

Help status do orçamento enviado para a mesa de análise de crédito
crédito

1=Aprovado;0=Negado;2=Mesa de
Opções Crédito;9=Sem análise de
crédito/Offline

Campo LQ_IFSCDM1 LQ_IFSCDM2

Tipo C C

Tamanho 6 6

Decimal 0 0

Título Cod Mens 1 Cod Mens 2

Descrição Código da Mensagem do FS Código da Mensagem do FS

Nível 1 1

Usado Não Não

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Contém o código para o campo MEMO Contém o código para o campo MEMO
Help
L1_IFSMSG1 e LQ_IFSMSG1 L1_IFSMSG2 e LQ_IFSMSG2

Campo LQ_IFSMSG1 LQ_IFSMSG2

Tipo M M

Tamanho 255 255

Decimal 0 0

Título Mensagem 1 Msg Análise

Descrição Mensagem de Retorno do FS Msg Análise Crd Financial

Nível 1 1

Usado Não Sim

SIGAFRT/SIGALOJA – Integração Financial Service 7

 Boletim Técnico

Obrigatório Não Não

Browse Não Não

Contexto Virtual Virtual

Propriedade Visualizar Visualizar

IF(!INCLUI,MSMM(SL1->L1_IFSCDM2,
Relação IF(!INCLUI,MSMM(SL1->L1_IFSCDM1, 255),'')
255),'')

Grava a mensagem amigável do

Grava a mensagem do analista de crédito sobre a
Help analista de crédito para informação
avaliação realizada.
ao cliente

Formato @!

 Tabela MEQ – Títulos Recebidos/Enviados:

Campo MEQ_FILIAL MEQ_PREFIX

Tipo C C

Tamanho 8 3

Decimal 0 0

Formato @! @!

Título Filial Prefixo

Descrição Filial do Sistema Prefixo do Título

Nível 1 1

Usado Não Sim

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Grupo de
033
Campos

Filial do sistema, deve ter a mesma Informar o Prefixo do título a ser

Help
característica do SE1 enviado para o CAP

Campo MEQ_NUM MEQ_PARCEL

Tipo C C

Tamanho 9 1

Decimal 0 0

Formato @! @!

Título No. Título Par Título

8 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

Descrição Número do Título Parcela do Título

Nível 1 1

Usado Sim Sim

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Grupo de
018 011
Campos

Informar o número do título a ser enviado Informar o número da parcela a ser

Help
para o CAP enviada para o CAP

Campo MEQ_TIPO MEQ_SEQTIT

Tipo C C

Tamanho 3 12

Decimal 0 0

Formato @! @!

Título Tipo Título Sequência

Descrição Tipo do Título Sequência do Título

Nível 1 1

Usado Sim Sim

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Informar o tipo do título a ser enviado para o Informar o número da sequência da

Help
CAP operação.

Campo MEQ_DTINC MEQ_OPERAC

Tipo D C

Tamanho 8 1

Decimal 0 0

Título Dt Inclusão Operação

Descrição Data da Inclusão Operação

Nível 1 1

Usado Sim Sim

SIGAFRT/SIGALOJA – Integração Financial Service 9

 Boletim Técnico

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Informar a operação a ser realizada no

Help Informar a Data de Inclusão do registro.
Job de Integração.

Formato @!

1= Enviar Título CAP; 2=Receber Título

Opções
CAP;3=Cancelar Recebimento CAP

Campo MEQ_HRINC MEQ_DTENV

Tipo C D

Tamanho 6 8

Decimal 0 0

Formato @R 99:99:99

Título Hr Inclusão Data Envio

Descrição Hora Inclusão Data do Envio

Nível 1 1

Usado Sim Sim

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Informar a Data de Envio do registro para

Help Informar a Hora de Inclusão do registro
integração FS/CAP

Campo MEQ_SEQ MEQ_TIPODO

Tipo C C

Tamanho 2 2

Decimal 0 0

Formato @R 99 @!

Título Seq Mov Tit Tipo Mov Tít

Descrição Sequência Mov. do título Tipo Movimentação Titulo

Nível 1 1

Usado Sim Sim

Obrigatório Não Não

10 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Informa a sequência da baixa/estorno do título Informa o tipo da movimentação do título

Help
(E5_SEQ) (E5_TIPODOC)

Campo MEQ_SALDO MEQ_DTUTPR

Tipo N D

Tamanho 16 8

Decimal 2

Formato @E 9,999,999,999,999.99

Título Saldo Ultm Envio

Descrição Saldo do título Data último envio ao CAP

Nível 1 1

Usado Sim Sim

Obrigatório Não Não

Browse Não Não

Contexto Real Real

Propriedade Visualizar Visualizar

Informa o saldo do título enviado para o CAP.
Utilizado como um dos critérios de seleção dos
Help
títulos a serem enviadas as baixas/estornos.
Informa a data da baixa do último
registro enviado ao CAP. Utilizado como
um dos critérios de seleção dos títulos a
serem enviadas as baixas/estornos.

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
3. Criação de Índices no arquivo SIX – Índices:

Índice MA8

Ordem 4

Chave MA8_FILIAL+MA8_TIPO+MA8_CODCLI+MA8_LOJA

Descrição St Emprego + Cliente + Loja

Proprietário S

Índice MEQ

Ordem 1

MEQ_FILIAL + MEQ_PREFIX + MEQ_NUM + MEQ_PARCEL + MEQ_TIPO +

Chave
MEQ_SEQTIT + DtoS(MEQ_DTINC)

SIGAFRT/SIGALOJA – Integração Financial Service 11

 Boletim Técnico

Descrição Prefixo + Numero + Parcela + Tipo + Sequencia + Dt Inclusão

Proprietário S

Índice MEQ

Ordem 2

MEQ_FILIAL + MEQ_PREFIX + MEQ_NUM + MEQ_PARCEL + MEQ_TIPO +

Chave
MEQ_OPERAC + MEQ_SEQ + MEQ_TIPODO

Descrição Prefixo + Número + Parcela + Tipo + Operação + Seq Tit + Tipo Mov

Proprietário S

4. Criação de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável MV_LJUSRFS

Tipo C

Nome do usuário utilizado para efetuar logon no Financial Services

Descrição
através do Microsiga.

Nome da Variável MV_LJPSWFS

Tipo C

Senha utilizada para efetuar logon no Financial Services através do

Descrição
Microsiga.

Nome da Variável MV_LJINTFS

Tipo L

Descrição Indica existe integração com o Financial Services.

Valor Padrão .F.

Nome da Variável MV_LJJUFIN

Tipo L

Descrição Realiza o cálculo de juros, seguindo a regra do financeiro

Valor Padrão .F.

Nome da Variável MV_LJPARFA

Tipo L

Indica se o sequenciamento das parcelas nos títulos seguira o padrão do

Descrição
Faturamento.

Valor Padrão .F.

12 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

Nome da Variável MV_LJIFSJU

Tipo C

Informa o cálculo de juros dos títulos a receber utilizados pelo Financial

Descrição será utilizado para comparação com o conteúdo do parâmetro
MV_JURTIPO.

Nome da Variável MV_LJIFSCO

Tipo Caracter

Descrição Código da Corporação cadastrado no CAP

Valor Padrão 01

Nome da Variável MV_LJIFSRE

Tipo Caracter

Descrição Código da Regional cadastrada no CAP

Valor Padrão 01

Nome da Variável MV_LJIFSEM

Tipo Caracter

Descrição Código da Empresa cadastrada no CAP.

Valor Padrão 01

Nome da Variável MV_LJTCPFS

Tipo Caracter

Informe os tipos de títulos enviados para o sistema CAP, separando-os por

Descrição
vírgula.

Valor Padrão CH,BO

Nome da Variável MV_LJSTFS

Tipo Caracter

Informe as situações dos títulos que devem ser enviadas para o Sistema
Descrição
CAP, separando-as por vírgula.

Valor Padrão 0,1,2,3,4,5,6,F,G,H

Nome da Variável MV_LJMICAP

Tipo Numérico

Indica o valor mínimo que o título deve ter para que seja enviado para
Descrição
cobrança no CAP.

SIGAFRT/SIGALOJA – Integração Financial Service 13

 Boletim Técnico

Valor Padrão 0

PROCEDIMENTOS PARA CONFIGURAÇÃO

Menus

1. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do SIGALOJA,
conforme instruções a seguir:

Menu Atualizações

Submenu Integrações Financial Services\ Cadastro

Nome da rotina Clientes

Programa CRDA010

Módulo SIGALOJA

Tipo Função Protheus

Tabelas SA1, MA5, MA6, MA7, MA8, MA9, MAA, MAB, MAC, MAD, MAE e MAR

Menu Atualizações

Submenu Integração

Nome da rotina Wizard Integração

Programa LJWVALCONF

Módulo SIGALOJA

Tipo Função Protheus

Tabelas

2. No Configurador (SIGACFG) acesse Base de Dados/Dicionários/Arquivos (CFGX034). Configure a(s) tabela(s) a seguir:

Chave MEQ

Nome Títulos Recebidos/Enviados

Compartilhamento C
Empresas

Compartilhamento C
Unidade Negócio

Compartilhamento C
Filial

14 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

Chave SE1

Nome Contas a receber

Compartilhamento C
Empresas

Compartilhamento C
Unidade Negócio

Compartilhamento C
Filial

Chave SE5

Nome Movimentação Bancária

Compartilhamento C
Empresas

Compartilhamento C
Unidade Negócio

Compartilhamento C
Filial

Campos

3. No Configurador (SIGACFG) acesse Base de Dados/Dicionários/Arquivos (CFGX034). Altere o(s) campo(s) a seguir:

Campo MA7_CELULA

Formato (999)XXXXXXXXXX

Usado Sim

Adapter EAI

4. No Configurador (SIGACFG) acesse Ambientes/Schedule/Adapter EAI (CFGA020). Configure o(s) adapters a seguir:

Rotina LOJA2503

Mensagem MESACREDITO

Mensagem Única Sim

Envia Não

Recebe Sim

Método síncrono

Operação Todos

Canal EAI

SIGAFRT/SIGALOJA – Integração Financial Service 15

 Boletim Técnico

Rotina LOJA2507

Mensagem ANÁLISECREDITO

Mensagem Única Sim

Envia Sim

Recebe Sim

Método Síncrono

Operação Todos

Canal EAI

Rotina LOJA2510

Mensagem TITULOCAP

Mensagem Única Sim

Envia Sim

Recebe Não

Método Síncrono

Operação Todos

Canal EAI

Rotina LOJA2512

Mensagem BAIXATITULOCAP

Mensagem Única Sim

Envia Sim

Recebe Não

Método Síncrono

Operação Todos

Canal EAI

PROCEDIMENTOS PARA UTILIZAÇÃO

Pré-Requisito
Informe os parâmetros de configuração conforme orientação a seguir:
Parâmetro Conteúdo

MV_VALCNPJ 2

MV_VALCPF 2

MV_LJINTFS .T.

16 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

MV_TIPACRD 3

Informe S ou C confirme a regra de cálculo de juros e multa do

MV_JURTIPO
financial Services

MV_LJJUFIN .T.

MV_LJPARFA .T.

Informe S ou C confirme a regra de cálculo de juros e multa do

MV_LJIFSJU
financial Services

MV_LJMICAP Informe o valor mínimo para envio

MV_VLBXREC 3

MV_LJCALJM F

MV_FINJRTP 2

Wizard de configuração da integração com o Financial Services

1. No Controle de Lojas (SIGALOJA), acesse Atualizações / Integração / Wizard Integração (LJWValConf).

2. C.ique em Avançar e selecione a opção de integração Financial Services.

3. Clique em Avançar e clique em Configurar no quadro Configuração integração e verifique os parâmetros

criados/atualizados.

4. Clique em Avançar e clique em Validar no quadro Validação das configurações necessárias para validação e verifique
o resultado dos itens validados.

5. Clique em Avançar e verifique o resumo das tarefas executadas e clique em Finalizar.

Cadastro de Clientes:

1. No Controle de Lojas (SIGALOJA), acesse Atualizações / Int. Financial Services / Cadastro / Clientes (CRDA010).

2. Clique em Incluir e preencha os campos conforme orientação de help de campo.

3. Verifique que não foi permitida a inclusão de clientes com CPF/CNPJ vazios e/ou duplicados.

Geração de análise de crédito durante a geração do Orçamento:

Pré-requisitos:

 Realize os cadastros das informações que são necessárias para o envio dos dados da análise de crédito:

 Inclua 01 banco, na rotina Bancos (Atualizações/Cadastros / Bancos MATA070),

 Inclua 01 adm. financeira, na rotina Adm. Financeiras (Atualizações/ Cadastros / Adm. Financeiras LOJA070),
 Inclua 01 produto, na rotina Produtos (Atualizações / Cadastros / Produtos LOJA110),
 Inclua 01 cliente, na rotina Clientes (Atualizações / Int. Financial Services / Cadastro / Clientes (CRDA010),
 Inclua 01 vendedor, na rotina Vendedores (Atualizações / Cadastros / Vendedores MATA040).

SIGAFRT/SIGALOJA – Integração Financial Service 17

 Boletim Técnico

 Verifique no sistema Financial Service, qual a regra vigente para a geração de uma análise de crédito.

1. No Controle de Loja (SIGALOJA), acesse Atualizações/Atendimento/Venda Assistida (LOJA701).

2. Clique em Atendimento.

3. Selecione um cliente que não seja padrão e preencha os demais campos, conforme orientação de help de campo.

4. Clique em Detalhes ou tecle [F7].

5. É apresentada a tela Pagamentos, selecione a forma de pagamento financiada.

6. Clique em Financiado.

7. Realize a gravação do Orçamento.

Durante a gravação do Orçamento e/ou durante a finalização da venda, o Microsiga Protheus ® envia os dados do
orçamento financiado para o Financial Services executar a política de análise de crédito e retornar seu status que será
gravado no orçamento e que pode ser:
 Negado (0) - interrompe a finalização da venda/orçamento, não sendo permitida a finalização ou a importação do
orçamento na rotina de Atendimento (FRTA271).
 Aprovado (1) - prossegue com a finalização da venda/orçamento, sendo permitida a finalização ou a importação do
orçamento na rotina de Atendimento (FRTA271).
 Mesa de crédito (2) - interrompe a finalização da venda/orçamento, não sendo permitida a finalização ou a
importação do orçamento na rotina Atendimento (FRTA271) até que o Financial Services envie o Status da análise de
crédito realizada pela mesa que pode ser: Negado ou Aprovado.

Quando houver não conformidade na comunicação com o sistema Financial Services ou nos dados de enviados que
impossibilitam a análise de crédito, o Microsiga Protheus® grava o orçamento com o seguinte status de análise de crédito:
 Sem análise/off-line (9)- interrompe a finalização da venda/orçamento, não sendo permitida a finalização ou a
importação do orçamento na rotina Atendimento (FRTA271).

A reposta da análise de crédito executada pelo Financial Services é exibida e fica disponível para consulta na rotina de
Venda Assistida (LOJA701) através do menu: Outros / Mens Análise Crédito (CRTL+F) ou pelo Sumário.

8. No Configurador (SIGACFG), acesse Ambiente / Schedule / Schedule / EAI / Transações (CFGA010). Localize no
Browse Transações o XML de Envio da Análise de Mesa de Crédito do orçamento; identificado pelo campo Código da
Função com conteúdo ANÁLISECREDITO, os campos data da transação e hora da transação com o conteúdo da Data
e Hora da Gravação do Orçamento e o campo Tipo da Transação com o valor Envio.

9. Para visualizar o XML enviado, clique sobre o registro.

10. Clique na lupa. A identificação do XML da análise do orçamento está na tag OrderNumber cujo conteúdo são os
campos Filial(L1_FILIAL) + Número do Orçamento(L1_NUM) e o retorno da análise de crédito está na tag
AnalysisStatus. No browse abaixo, identificado como Eventos da Tarefa, verifique se existe algum evento de não
conformidade, identificado pelo campo Título com valor Erro ou Falha.

11. No Controle de Loja (SIGALOJA), acesse Atualizações/Atendimento/Venda Assistida (LOJA701),

12. Clique em Legenda verifique se a legenda do orçamento foi alterada, conforme a resposta da análise de crédito:

18 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

 Análise de Crédito Aprovada: Orçamento em aberto.

 Análise de Crédito Reprovada: Orçamentos reprovado Análise de credito.
 Análise de Crédito na Mesa: Orçamentos mesa de credito.
 Sem análise de crédito/off-line: Orçamentos sem Análise de credito/off-line.

Reenvio para a mesa de crédito de um orçamento com análise de crédito reprovada:

1. No Controle de Lojas (SIGALOJA), acesse Atualizações / Atendimento / Venda Assistida (LOJA701), selecione o
orçamento com análise de crédito com status reprovada.

2. Clique em Reenv. Análise Cred Financial.

3. Informe o texto da observação a ser enviado para a análise e confirme.

4. No Configurador (SIGACFG), acesse Ambiente / Schedule / Schedule / EAI / Transações (CFGA010). Localize no
Browse Transações o XML de Envio da Análise de Mesa de Crédito do orçamento; identificado pelo campo Código da
Função com conteúdo ANÁLISECREDITO, os campos data da transação e hora da transação com o conteúdo da Data
e Hora da Gravação do Orçamento e o campo Tipo da Transação com o valor Envio.

5. Para visualizar o XML enviado, clique sobre o registro.

6. Clique na lupa. A identificação do XML do reenvio da análise do orçamento está na tag OrderNumber com o
conteúdo dos campos Filial(L1_FILIAL) + Número do Orçamento(L1_NUM). No browse abaixo, identificado como
Eventos da Tarefa, verifique se existe algum evento de não conformidade, identificado pelo campo Título com valor
Erro ou Falha.

7. No Controle de Lojas (SIGALOJA), acesse Atualizações/Atendimento/Venda Assistida (LOJA701).

8. Clique em Legenda e verifique se a legenda do orçamento foi alterada para Orçamentos mesa de credito.

Liberação manual da análise de crédito na mesa de crédito/Off-line:

1. No Controle de Lojas (SIGALOJA), acesse Atualizações/Ponto de Venda/Caixa (LOJA120). Na pasta Permissões,

verifique se a opçãoLiberação Manual do Orçamento na Mesa de Crédito está liberada ou liberada mediante
autorização do superior para o caixa associado ao usuário.

2. Acesse Atualizações / Atendimento / Venda Assistida (LOJA701) selecione um orçamento com a análise de crédito
com status Mesa de Crédito ou Off-line.

3. Clique em Lib Man Análise Cred Financial.

4. Verifique se foi realizada a permissão do usuário ou se foi liberada a operação.

5. Verifique se foi exibida a tela para seleção da operação a ser realizada para a análise de crédito do orçamento, Clique
em Aprovar ou Reprovar.

6. Clique em Legenda e verifique se a legenda do orçamento foi alterada para o status da análise de crédito informada.

Importação de um orçamento que tenha análise de crédito no Frente de Lojas:

SIGAFRT/SIGALOJA – Integração Financial Service 19

 Boletim Técnico

1. No Front Loja (SIGAFRT), acesse Atualizações/Front de Lojas/Atendimento (FRTA271), abra o caixa pressionando
[F4].

2. Realize a importação do orçamento, pressionando [CRTL+Z] e informe o orçamento com a análise de crédito
aprovada.

3. Realize a finalização da venda.

A importação dos Orçamentos com análise de crédito realizada pelo Financial Service, somente é realizada se o
status estiver Aprovada.

Recebimento da análise de crédito que estava na mesa de crédito do Financial Services:

Pré-requisitos:

 No sistema Financial Services, execute a aprovação da mesa de crédito do orçamento enviado.

1. No Controle de Lojas (SIGALOJA), acesse Atualizações / Atendimento / Venda Assistida (LOJA701), identifique um
orçamento enviado para Mesa de Crédito.

2. No Configurardor (SIGACFG), acesse Ambiente / Schedule / Schedule / EAI / Transações (CFGA010) e localize no
Browse Transações o XML de Retorno da Análise de Mesa de Crédito, identificado pelo campo Código da Função
com conteúdo MESACREDITO e o campo Tipo da Transação com o valor Recebimento.

3. Para visualizar o XML enviado, clique sobre o registro.

4. Clique na lupa. A identificação do XML do retorno da análise da mesa de crédito do orçamento está na tag
OrderNumber com o conteúdo dos campos Filial(L1_FILIAL) + Número do Orçamento(L1_NUM) , sendo que o
retorno da análise de crédito está na tag AnalysisStatus, cujo valores de retorno é igual ao da mensagem de análise
de crédito. No browse abaixo, identificado como Eventos da Tarefa, verifique se existe algum evento de não
conformidade, identificado pelo campo Título com valor Erro ou Falha.

5. No Controle de Lojas (SIGALOJA), acesse Atualizações / Atendimento / Venda Assistida (LOJA701).

6. Clique em Legenda e verifique se a legenda do orçamento foi alterada, conforme o retorno da mensagem de Retorno
da Análise de Mesa de Crédito.

Geração de venda parcelada, utilizando a regra de numeração de parcelas do módulo faturamento:

1. No Faturamento (SIGAFAT), acese Atualizações / Pedido / Pedido de Venda (MATA140).

2. Clique em Incluir e realize a inclusão de um pedido de venda, cuja condição de pagamento campo Cond. Pagto
(C5_CONDPAG) gere um título de no mínimo 30 parcelas.

3. Realize o preenchimento dos demais campos, conforme orientação de help de campo e confirme.

4. Acesse Atualizações / Faturamento / Documento de Saída (MATA460A), selecionando os parâmetros que se

referem ao pedido incluído (Pedido De/Até, Liberação De/Até).

5. Marque o pedido incluído e clique em Prep. Docs.

6. No Controle de Loja (SIGALOJA), acesse Atualizações / Gerencia Finanças / Contas a Receber (FINA040), verifique os
código das parcelas campo Parcela (E1_PARCELA) 1ª, 27ª e 30ª, geradas para os títulos referentes à Nota Fiscal
emitida.

20 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

7. No Controle de Loja (SIGALOJA), acesse Atualizações / Atendimento / Venda Assistida (LOJA701) e realize uma
venda com 30 parcelas.

8. No Controle de Loja (SIGALOJA), acesse Atualizações / Gerencia Finanças / Contas a Receber (FINA040), verifique
que os código das parcelas campo Parcela (E1_PARCELA) 1ª, 27ª e 30ª, geradas para os títulos referentes à venda
do Controle de Lojas (SIGALOJA) são iguais ao das sequências geradas pela rotina do Faturamento (SIGAFAT).

A numeração das parcelas do módulo Controle de Lojas (SIGALOJA) e o Faturamento (SIGAFAT) devem ser
iguais, independente do conteúdo do parâmetro MV_1DUP e do tamanho do campo Parcela (E1_PARCELA).

Envio dos títulos em atraso para o CAP (Subsistema Financial Services) – para os títulos do tipo não Financiado:

1. No Controle de Lojas (SIGALOJA), acesse Atualizações / Gerencia Finanças / Contas a Receber (FINA040) e verifique
se existe um título em atraso, na seguinte condição:

 Campo Vencto Real E1_VENCREA) inferior à Data Base do Sistema (dDataBase);

 Campo Saldo E1_SALDO maior que zero);
 Tipo (E1_TIPO) diferente de Financiado (FI) e esteja cadastrado no parâmetro MV_LJTCPFS;
 Situação (E1_SITUACA) pertença ao parâmetro MV_LJSTFS ;
 Não exista registro de envio na tabela Títulos Recebidos/Enviados (MEQ).

2. Caso não exista um título vencido nessas condições, realize a inclusão do registro conforme os critérios citados.

3. Aguarde a execução da rotina automática de envio dos títulos em atraso (LOJA2500).

Esta rotina seleciona os títulos cujo campo Tipo (E1_TIPO) esteja com o valor FI e envia todas as parcelas vencidas e
vincendas para o Financial Services na mesma mensagem XML. Caso o tipo do título seja diferente de Financiado e
estiver contido no parâmetro MV_LJTCPFS, somente a parcela em atraso é enviada ao Financial Services.

4. Além do tipo do título, é utilizado como critério de envio o conteúdo do campo Situação (E1_SITUACA), que deve
estar contido no parâmetro MV_LJSTFS ou não, caso parâmetro esteja vazio.

A alteração da situação de cobrança do título pode ser realizada através da rotina Transferências (FINA060).
Outra condição para o envio do título em atraso é a soma das parcelas em aberto e parcelas vencidas do contrato -
títulos com a mesma Filial (E1_FILIAL) + Prefixo (E1_PREFIXO) + Número (E1_NUM), ser maior ou igual ao valor
estabelecido no parâmetro MV_LJMICAP.

5. No Configurador (SIGACFG), acesse Ambiente / Schedule / Schedule / EAI / Transações (CFGA010), localize no
Browse Transações, o XML de Envio da Cobrança do Título para o CAP, identificado pelo campo Código da Função
com conteúdo TITULOCAP e o campo Tipo da Transação com o valor Envio.

6. Para visualizar o XML enviado, clique sobre o registro.

7. Clique na lupa. A identificação do título enviado está na tag Contract que é composta dos campos: Prefixo do título
(E1_PREIXO) + Número do Título (E1_NUM) + Tipo do Título (E1_TIPO) + Parcela do Título (E1_PARCELA), para os
títulos cujo Tipo do Título (E1_TIPO) é diferente de FI. No browse abaixo, identificado como Eventos da Tarefa,
verifique se existe algum evento de não conformidade, identificado pelo campo Título com valor Erro ou Falha.

SIGAFRT/SIGALOJA – Integração Financial Service 21

 Boletim Técnico

Envio dos títulos em atraso para o CAP (Subsistema Financial Services) – para os títulos do tipo Financiado:

1. No Controle de Lojas (SIGALOJA), acesse Atualizações / Gerencia Finanças / Contas a Receber (FINA040). Verifique
se existe um título em atraso, na seguinte condição:

 Campo Vencto Real E1_VENCREA) inferior à Data Base do Sistema (ddatabase);

 Campo Saldo E1_SALDO maior que zero);
 Tipo (E1_TIPO) igual a Financiado (FI);
 Situação (E1_SITUACA) pertença ao parâmetro MV_LJSTFS;
 Não exista registro de envio na tabela MEQ Títulos Recebidos/Enviados.

2. Caso não exista um título vencido nessas condições, realize a inclusão do registro conforme os critérios citados.

3. Verifique se existe mais de um registro nessas condições com a mesma chave, composta pelos campos: Prefixo do
título (E1_PREIXO) + Número do Título (E1_NUM) + Tipo do Título (E1_TIPO).

4. Aguarde a execução da rotina automática de envio dos títulos em atraso (LOJA2500).

5. No Configurador (SIGACFG), acesse Ambiente / Schedule / Schedule / EAI / Transações (CFGA010), localize no
Browse Transações o XML de Envio da Cobrança do Título para o CAP, identificado pelo campo Código da Função
com conteúdo TITULOCAP e o campo Tipo da Transação com o valor Envio.

6. Para visualizar o XML enviado, clique sobre o registro.

7. Clique na lupa.A identificação do título enviado está na tag Contract que é composta dos campos: Prefixo do título
(E1_PREIXO) + Número do Título (E1_NUM) + Tipo do Título (E1_TIPO) + 0, para os títulos de Tipo Financiado
campo Tipo (E1_TIPO) com valor FI.

8. Verifique se o XML do WebServices de Envio da Cobrança dos Títulos para o CAP consta o título em atraso e suas
parcelas abertas, identificada pela mesma chave: Prefixo do título (E1_PREIXO) + Número do Título (E1_NUM) +
Tipo do Título (E1_TIPO) com valor FI. No browse abaixo, identificado como Eventos da Tarefa, verifique se existe
algum evento de não conformidade, identificado pelo campo Título com valor Erro ou Falha.

Os procedimentos a seguir, referem-se ao procedimento de utilização: Envio das baixas dos títulos enviados para o
CAP (Subsistema Financial Services) - Baixa manual de título de contas a receber e podem ser realizados
separadamente, desde que o título já tenha sido enviado ao CAP.

9. No Controle de Lojas (SIGALOJA), acesse Atualizações/ Gerencia Finanças / Baixas a Receber (FINA070). Selecione o
título enviado ao CAP.

10. Clique Baixar.

11. Verifique as informações do título e confirme a baixa do título.

12. Aguarde a execução da rotina automática de seleção e envio dos pagamentos dos títulos (LOJA2501).

13. No Configurador (SIGACFG), acesse Ambiente / Schedule / Schedule / EAI / Transações (CFGA010), localize no
Browse Transações o XML de Envio da Cobrança do Título para o CAP, identificado pelo campo Código da Função
com conteúdo BAIXATITULOCAP e o campo Tipo da Transação com o valor Envio.

22 SIGAFRT/SIGALOJA – Integração Financial Service

 Boletim Técnico

14. Para visualizar o XML enviado, clique sobre o registro.

15. Clique na lupa. A identificação do título enviado está na tag Contract que é composta dos campos: Prefixo do título
(E1_PREIXO) + Número do Título (E1_NUM) + Tipo do Título (E1_TIPO) + Parcela do Título (E1_PARCELA) - para os
títulos cujo Tipo do Título (E1_TIPO) é diferente de FI para parcela e 0 para o agrupamento de parcelas. No browse
abaixo, identificado como Eventos da Tarefa, verifique se existe algum evento de não conformidade, identificado
pelo campo Título com valor Erro ou Falha.

Este procedimento pode ser realizado, utilizando as seguintes variações nas operações de baixa do título de
contas a receber, que podem estar disponíveis em vários módulos do Microsiga Protheus®:
Baixas a Receber Automática – Atualizações / Contas a Receber / Baixa Rec Automat (FINA110);
Faturas a Receber – Atualizações / Contas a Receber / Faturas a Receber (FINA280);
Compensação de Títulos - Atualizações / Contas a Receber / Compensação CR (FINA330);
Recebimento de Títulos (Loja) – Atualizações / Atendimento / Venda Assistida / Recebimento (LOJXREC).
A rotina automática de seleção e envio dos pagamentos dos títulos ao CAP (LOJA2501), também realiza o envio
dos cancelamentos das baixas dos títulos, que pode ser realizados na rotina Baixas a Receber (FINA070).

INFORMAÇÕES TÉCNICAS

MEQ – Títulos Recebidos/Enviados

SL1 – Orçamentos
SLQ – Orçamentos
SA1 - Cadastrais – Adm/Fin. – Fiscais – Vendas – Outros
SE1 – Contas a Receber
SE5 – Movimentação Bancária
MA5 – Perg Sócio X Econ X Cultural
MA6 - Cartões
Tabelas Utilizadas MA7 - Compl. Ficha
MA8 - Ref. Trabalho
MA9 - Ref. Cartões
MAA - Ref. Bancárias
MAB - Ref. Pessoal
MAC – Dependentes do Cartão
MAD - Endereço
MAE - Doc. Entregue
MAR – Semafaro CRD

SIGAFRT/SIGALOJA – Integração Financial Service 23

 Boletim Técnico

CRDA010 – Cadastro de Clientes (SigaCRD)

Funções Envolvidas
MATA030 – Cadastro de Clientes
FRTA271 – Frente de Lojas – Atendimento
LOJA120 – Cadastro de Caixas
LOJA701 – Venda Assistida
LOJA2500 – Envio Título CAP
LOJA2501 – Baixa Título CAP
LOJA2503 – Retorno Mesa de Crédito
LOJA2507 – Análise de Crédito

Sistemas Operacionais Windows®/Linux®

24 SIGAFRT/SIGALOJA – Integração Financial Service