Integração do Easy Financing Control via Mensagem Única - EAI

Características do Requisito

Descrição

Implementação da funcionalidade de integração via mensagem única  - EAI - para o Easy Financing Control (Protheus), com o objetivo de flexibilizar a comunicação entre as soluções TOTVS com a utilização da tecnologia de WEB Services, o que ocorrerá com a troca de informações (mensagens) no formato XML entre esses sistemas

Estão previstas nessa atualização as seguintes integrações:

• Movimentação bancária de captação dos contratos.
• Movimentação bancária de Vinculação de invoices a contrato.
• Liquidação de invoices vinculadas.
• Liquidação de juros.
• Contabilização de eventos do contrato.
  
  

Procedimento para Configuração

As atualizações disponibilizadas através deste Boletim Técnico adequam o produto Easy Financing Control para sua utilização na integração via Mensagem Única – EAI. Para a configuração das integrações, devem ser observadas as orientações do manual de integração com o ERP em questão.

Sobre o EAI Protheus, consulte as informações adicionais disponíveis no portal TDN:

http://tdn.totvs.com/display/framework/EAI+Protheus

http://tdn.totvs.com/pages/releaseview.action?pageId=107939550

CONFIGURAÇÃO DE PARÂMETROS

      1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:
          Obs.: Configuração obrigatória.

CONFIGURAÇÃO DE AGENTE DO SCHEDULER DO PROTHEUS

CONFIGURAÇÃO DE WEB SERVICE PROTHEUS

1. Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
2. Informe o Usuário e a Senha.
3. Acesse Módulos WEB e clique em Incluir.
4. Em Módulo Web, selecione o módulo WS – Microsiga Protheus 11 Web Services; em Nome da Instância, informe um nome para o Web Service(exemplo: “ws”). Selecione o enviroment e o ambiente. Marque a opção “Habilitar processos na Inicialização do Servidor”. Clique em Avançar.
5. Será exibida a pergunta “Deseja descompactar o pacote de arquivos HTTP na pasta especificada?”, clique em “Sim”.
6. Em host digite o endereço http do seu web service (Exemplo: “localhost:81/ws”). Selecione a Empresa/Filial e clique em Relacionar. O relacionamento será exibido na parte inferior da tela. Clique em Avançar.
7. Informe o número mínimo (Exemplo: 10) e máximo de usuários (Exemplo: 10) e clique em Finalizar.
8. O sistema irá exibir um aviso sobre a instalação do Web Service e questiona se deseja iniciar tal instalação. Clique em Sim.

CONFIGURAÇÃO DE JOB DO SCHEDULER DO PROTHEUS

1. Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
2. Informe o Usuário e a Senha.
3. Acesse Processos Comuns e clique em Incluir.

4. Preencha os campos conforme abaixo:

   Itens/Pastas	Descrição
   Nome do JOB:	FWSCHDMANAG
   Função ADVPL:	FWSCHDMANAG
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Instâncias:	1
   Parâmetros:	(não informar parâmetros)
   Habilitar JOB no START:	(deixe a opção marcada)

5. Clique em finalizar.
6. Acesse novamente Processos Comuns e clique em Incluir.

7. Preencha os campos conforme abaixo:

   Itens/Pastas	Descrição
   Nome do JOB:	FWSCHDQUEUE
   Função ADVPL:	FWSCHDQUEUE
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Instâncias:	1
   Parâmetros:	(não informar parâmetros)
   Habilitar JOB no START:	(deixe a opção marcada)

8. Clique em finalizar.
9. Após essa configuração, é necessário reiniciar o serviço do Protheus.

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
2. Em Agent/Cadastro, clique em Incluir.
3. Preencha os dados na tela para criação do Agente e clique em Confirmar.
4. Em Agent inicie o serviço criado.
5. Em Schedule inicie os serviços: Task Manager e Queue Manager.

CONFIGURAÇÃO DA TAREFA DE PROCESSAMENTO DE INTEGRAÇÕES ASSINCRONAS DO SCHEDULER DO PROTHEUS

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
2. Em Agendamentos/Cadastro, clique em Incluir.
   

3. Preencha os dados na tela para criação da tarefa conforme abaixo:

   Itens/Pastas	Descrição
   Usuário:	Administrador
   Rotina:	FWEAI
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Empresa/Filial:	(preencha com o empresa/filial em uso no protheus)
   Módulo:	99 – Configurador
   Habilitado:	(deixe a opção marcada)

4. Clique no botão recorrência e informe a periodicidade para processamento da tarefa de integração das mensagens assíncronas. Recomendado deixar na opção “Sempre Ativo” e “Sem data de término”.
   

5. Clique em Confirmar para fechar a tela de recorrência. Clique em confirmar para salvar a configuração da tarefa.
   
6. Recomendado reiniciar o serviço do Protheus após a configuração do agendamento.
   

CONFIGURAÇÃO DO APPSERVER DO PROTHEUS

1. Localize o arquivo appserver.ini, no diretório \bin, onde encontra-se a instalação dos binários do serviço do Protheus.
2. Com um editor de texto, abra o arquivo, e localize a seção [GENERAL].
   
3. Nesta seção, caso não existam as configurações abaixo, adicione ou caso exista, altere para que fiquem conforme abaixo. Não modifique outras configurações que possam existir nessa seção.
   
   [GENERAL]
   DATEZERO=ADVPL
   MemoMega=1
   ConsoleLog=1
    
4. Salve as alterações no arquivo, feche-o, e reinicie o serviço do Protheus. 
   
   

CONFIGURAÇÃO DO SERVIÇO DO PROTHEUS PARA ATUALIZAÇÕES

Após as configurações de webservice e scheduler do Protheus, haverão tarefas em execução no servidor do Protheus mesmo que nenhum usuário esteja logado no sistema. Com isso as aplicações de patchs e updates que necessitam de acesso exclusivo ao sistema podem ser dificultadas pois é necessário derrubar os processos em execução. Recomenda-se fazer uma copia da instalação do serviço do Protheus (pasta “\bin\” que contem os binários do serviço do Protheus) e nessa instalação retirar a configuração da execução dos Jobs (basta remover a seção [ONSTART] no appserver.ini. É importante que todas as outras configurações sejam mantidas). Assim, quando for necessário aplicar um patch ou update, pare o serviço do Protheus que possuir as configurações dos Jobs, inicie o serviço que não possua execução de Jobs, aplique a atualização necessária, pare o serviço que não possuir execução de Jobs e inicie novamente o serviço que possuir a execução de Jobs.

Tome cuidado para executar esse processo da maneira descrita para que o Protheus possa ser atualizado e para que não fique sem a inicialização dos Jobs.

PROCEDIMENTO PARA BACK-UP DE BASE DE DADOS

Devido ao controle e configurações internas do TOTVS DBACCESS, toda criação de backup e restore de backup de base de dados, assim como replicação da base de dados para outros ambientes, deve ser feita através da importação de tabelas da ferramenta APSDU. Isso garante a integridade das tabelas e correta interpretação dos dados pelo TOTVS DBACCESS e consequentemente pelas aplicações do Protheus. Não utilize ferramentas de backup de tabelas diretamente pelo banco de dados, pois isso pode exigir a reinicialização do serviço e até mesmo a reinstação do TOTVS DBACCESS.

RELAÇÃO DE/PARA DE EMPRESAS / FILIAIS

Outros ERPs TOTVS diferentes do Protheus não possuem o conceito de Empresa/Filial como no Protheus, existindo uma ou mais empresas/filiais distintas utilizando o mesmo sistema, são todas cadastradas no ERP como empresas diferentes. Além disso os códigos de empresa do ERP são distintos dos códigos de empresa/filial do Protheus. Por isso é necessário acessar o cadastro da relação DE/PARA no módulo configurador (Ambiente/Schedule/Emp.fil Msg.Unica) para cadastrar esta relação.

Por exemplo, se tivermos a empresa 21 no ERP Logix e quisermos associar á empresa 01 filial 10 do Protheus, devemos cadastrar conforme abaixo.

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Emp.fil Msg.Unica (APCFG050).

2. Clique na opção Incluir e preencha os campos conforme exemplo abaixo:

   Itens/Pastas	Descrição
   Referência	LOGIX (nome do ERP externo)
   Company	21 (código da empresa no ERP)
   Branch	(em branco)
   Emp.Protheus	01
   Fil.Protheus	10

3. Clique em confirmar para salvar o relacionamento empresa/filial.
   

ADEQUAÇÃO DO TAMANHO DOS CAMPOS DO PROTHEUS

O tamanho de campos de algumas tabelas do Easy precisará ser adequado para que fique compatível com o tamanho dos campos no ERP.

Campos como código de cliente, código de fornecedor e código de produto podem ficar divergentes e gerar problemas de integração caso não fiquem com o mesmo numero de caracteres que o ERP.

 Verifique o tamanho dos grupos de campos do Protheus através do módulo configurador, na opção de menu Base de dados / Dicionário / Base de dados. Selecione a empresa do lado esquerdo da tela, selecione Dicionário de dados e Grupo de campos. Veja ao lado direito todos os grupos de campo e na coluna tamanho, o tamanho atualmente em uso no Protheus.

 É recomendado rever os seguintes grupos de campos:

Para integração Protheus X ERP Logix, será necessário efetuar os ajustes abaixo, manualmente, no Configurador (SIGACFG).

• Grupo de Campos:

• Campos:

CONFIGURAÇÃO DE ADAPTER

O módulo Easy Financing Control está preparado para a realização das integrações que seguem. Para configurar as integrações, conforme a necessidade, siga as instruções abaixo:

1. No Configurador (SIGACFG) acesse Schedule/Adapter E.A.I. (CFGA020).

2. Acesse a opção Incluir e informe os dados do adater, conforme as opções que seguem:

Procedimento para Utilização

Pré-requisitos:

Teste de webservices

Os webservices do Protheus e do ERP destino da integração devem estar devidamente configurados e no ar.

Verifique utilizando seu navegador de internet se o webservice do Protheus está no ar acessando o host configurado para o webservice Protheus. Procure o serviço FWWSEAI e veja se o mesmo encontra-se habilitado.

Verifique, utilizando seu navegador de internet, se o webservice do ERP destino está no ar acessando o host configurado no parâmetro MV_EAIURL2.

Integrações de cadastros

As integrações de cadastros ocorrem com origem no ERP com destino ao Easy. Algumas dessas integrações ocorrem de forma síncrona e outras de forma assíncrona.

Quando o cadastro possuir a integração de forma síncrona, o ERP irá aguardar o Easy processar a integração, e então exibirá para o usuário se tudo ocorreu com sucesso ou se houve rejeição por parte do Easy. Quando as rejeições das integrações ocorrem, o ERP não irá efetivar a operação realizada.

Quando o cadastro possuir integração de forma assincrona, o ERP não irá aguardar o Easy processar a integração e irá efetivar a operação independentemente do processo de integração. A mensagem de integração entra em uma fila no ERP para ser enviada ao Easy. Quando a integração ocorrer, a mensagem será recebida pelo Protheus e armazenada em uma fila para posterior processamento, retornando ao ERP apenas o aviso de recebimento da mensagem. O processamento da integração ocorre no Easy conforme a execução da tarefa FWEAI configurada no Scheduler do Protheus. Essa tarefa irá verificar todas as mensagens pendentes na fila do EAI e irá processá-las. Após o processamento, será enviada a mensagem ao ERP com o resultado da integração. Em caso de rejeição na integração, o EAI pode tentar processar novamente a mensagem antes de retornar uma rejeição ao ERP.

Pré-requisitos cadastrais

Eventos Contábeis:

Para realizar a integração com o Financeiro do ERP, o Easy Financing Control precisará saber qual o tipo de documento deve ser gerado. Para isso será necessário que os eventos contábeis associados às integrações/ tipos de movimento financeiro sejam configurados.

Através do menu Atualizações / Tabelas / Eventos Contábeis (ECOA002), os eventos abaixo, do tipo IMPORT, devem ser acessados em modo de alteração e ter os campos informados conforme orientação que segue:

• Evento 101 – FOB INVOICE: da pasta Cadastrais, os campos Descricao (EC6_DESC), Historico (EC6_COD_H) e Hist. Complem (EC6_COM_HI); da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN); da pasta Contábil, os campos Contabiliza (EC6_CONTAB), Cta. Credito (EC6_CTA_CR) e Cta. Debito (EC6_CTA_DB), da pasta Outros o campo Prefixo (EC6_PREFIX).
• Evento 102 – PROV. FRETE: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN), da pasta Outros o campo Prefixo (EC6_PREFIX).
• Evento 103 – PROV. SEGURO: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN), da pasta Outros o campo Prefixo (EC6_PREFIX).
• Evento 150 – DESPESAS PROVISÓRIAS: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN), da pasta Outros o campo Prefixo (EC6_PREFIX).
• Evento 151 – ADIANTAMENTO DE DESPESAS: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN), da pasta Outros o campo Prefixo (EC6_PREFIX). Esse evento contábil será associado à despesa de adiantamento ao despachante, código 9.01, para integração com o financeiro do ERP, caso não tenha sido informado outro para o cadastrado dessa despesa.
• Evento 201 – FOB D.I. / N.F.E.: da pasta Cadastrais, os campos Descricao (EC6_DESC), Historico (EC6_COD_H) e Hist. Complem (EC6_COM_HI); da pasta Contábil, os campos Contabiliza (EC6_CONTAB), Cta. Credito (EC6_CTA_CR) e Cta. Debito (EC6_CTA_DB).
• Evento 320 – DESPESAS: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV), Mot. Baixa (EC6_MOTBX, apenas para a compensação/ prestação de contas), Natureza (EC6_NATURE, tipo de valor (ou ajuste financeiro) que indicará a incidência do ISS) e Tp.Despesa (EC6_NATFIN); da pasta Outros o campo Prefixo (EC6_PREFIX). Esse evento contábil será associado às despesas usadas no processo (exceto as iniciadas com 1 e 9) para a realização da integração com o financeiro do ERP, caso não tenha sido informado outro para o cadastrado dessa despesa. Quando o campo Mot. Baixa (EC6_MOTBX) não estiver preenchido, por default será usada a informação 004 (borderô) na integração.
• Evento 501 – V.CAMB.FOB INV.DEV.: da pasta Cadastrais, os campos Descricao (EC6_DESC), Historico (EC6_COD_H) e Hist. Complem (EC6_COM_HI); da pasta Contábil, os campos Contabiliza (EC6_CONTAB), Cta. Credito (EC6_CTA_CR) e Cta. Debito (EC6_CTA_DB).
• Evento 504 – V.CAMB.FOB INV.CRED.: da pasta Cadastrais, os campos Descricao (EC6_DESC), Historico (EC6_COD_H) e Hist. Complem (EC6_COM_HI); da pasta Contábil, os campos Contabiliza (EC6_CONTAB), Cta. Credito (EC6_CTA_CR) e Cta. Debito (EC6_CTA_DB).
• Evento 608 – PGTO. A FORNECEDOR: da pasta Financeiro, Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN); da pasta Outros os campos C.Custo (EC6_CCUSTO) e Prefixo (EC6_PREFIX).
• Evento 609 – PAGAMENTO ANTECIPADO: da pasta Financeiro, Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN); da pasta Outros os campos C.Custo (EC6_CCUSTO) e Prefixo (EC6_PREFIX).

Existe também uma configuração específica para os eventos dos contratos de financiamento que geram título a pagar no ERP Externo onde é possível determinar o momento em que tal título deve ser gerado, conforme descrição abaixo: 

• Campo Desab.Integ? (EC6_DESINT) que por defaut está vazio e que possui as seguintes configurações possíveis:
  - "1 - Desabilita" - Indica que tal evento do contrato não integrará título para o financeiro do ERP Externo.
  - "2 - Sem Liquidar" - Indica que o título será gerado no financeiro do ERP Externo apenas quando for liquidado o evento no contrato. Neste caso, após o sucesso na inclusão do título no ERP Externo, automaticamente em seguida é integrada a liquidação do mesmo título.
  - "3 - Não Desabilita" - Indica que o título será gerado no financeiro do ERP Externo quando for originado o evento no contrato. Neste caso, após o sucesso na inclusão do título no ERP Externo, só será integrada automaticamente a liquidação do mesmo título caso o campo "Baixa Juros"(EF1_BXJURO) na capa do contrato estiver configurado com o valor "1-Sim", caso contrário o título fica pendente de liquidação manual do evento no contrato.
  - ""  - Irá ter o mesmo comportamento da opção "3 - Não Desabilita".

PROCEDIMENTOS DE UTILIZAÇÃO DO SISTEMA

Sequencia 001 – Cadastro de tipos de financiamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Tabelas / Tip. Financiamento (EFFFI100).
2. Verifique no browser que os tipos de Financiamento padrão já carregados pelo sistema apresentam os tipos “ACC” e “ACE” com o campo “Parcelamento” definido como “Nao”.
3. Posicionado sobre um destes tipos, clique no botão Alterar e verifique que para estes tipos o sistema não permite alterar esta opção visto que por regra de negócio, estes tipos de financiamento não são parcelados.
   
4. Volte para a tela de browser de tipos de financiamento, selecione um outro tipo (Pré-pagamento por exemplo) e clique no botão Alterar. Verifique que para este tipo estará habilitado a edição do campo “Parcelamento”.
   
5. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
   
6. Clique no botão Incluir. Na tela de dados do contrato, pressione F3 sobre o campo “Tipo Financ.” e informe o tipo de Financiamento.
   
7. Ao informar este campo, acesse a aba “Parcelas de Pag.” e verifique que o campo “Parc. Pgt.” estará desabilitado para alteração e com o valod “2=Nao” caso o tipo de financiamento seja ACC ou ACE.
   
8. Caso o tipo de financiamento seja algum outro onde o tipo de financiamento permita parcelamento, o sistema deixará o campo habilitado para informação.
   

Sequencia 002 – Inclusão de Contrato – ACC/ACE

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
   
3. Altere a taxa do evento 100 para que o valor do Financiamento seja recalculado.
4. Clique em Salvar para finalizar.
5. Neste momento, o contrato será enviado através da mensagem única “BANKTRANSACTION” ao ERP externo. nfirme no ERP externo que a mensagem foi enviada com a taxa alterada.
6. O registro é gravado com sucesso.

Sequencia 003 – Vinculação de Contrato – ACC/ACE

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Em Outras Ações clique em Vincular.
4. Selecione a parcela de cambio para vinculação.
5. Clique em Salvar.
6. São calculados e gerados os eventos de variação cambial da parcela principal e dos juros.
7. Clique em Salvar.
8. O registro é gravado com sucesso.

Sequencia 004 – Liquidação de cambio vinculado – ACC/ACE

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações/ Exportação/Cambio (EECAF200).
2. No browser de cambio, selecione o registro e clique no botão “Alterar”.
3. Selecione a parcela que encontra-se vinculada e em Outras Ações clique em Liquidar.
4. Selecione a parcela de cambio para vinculação.
5. Informe os dados de liquidação e clique em Salvar.
6. Clique em Salvar.
7. Neste momento, a liquidação de principal será enviada através da mensagem única “ACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de liquidação.
8. Em cenários onde será necessário efetuar o estorno da liquidação de uma parcela de cambio, esta será enviada através da mensagem única “REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de estorno de liquidação.

Sequencia 005 – Alteração do evento juros vinculado – ACC/ACE

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Selecione a parcela de juros e em Outras Ações clique em Alterar.
   
   Observação: Para eventos de juros dos tipos de contrato ACC/ACE ( iniciados em 62,64,67 ) que integram título a pagar para o ERP Externo, somente em caso de alteração dos campos: Data do evento(EF3_DT_EVE), Moeda do contrato(EF3_MOEDA), Valor em moeda(EF3_VL_MOE), Taxa em reais(EF3_TX_MOE) e Fornecedor do contrato(EF3_FORN) é que será disparada a mensagem de integração para alteração do título.
   
   
4. Informe os dados de liquidação e clique em Salvar.
   
5. Retornando ao browser de dados e parcelas do contrato, Clique em Salvar.
   
6. Neste momento, o sistema irá processar as alterações no contrato e havendo alterações em campos (conforme observação acima) de uma ou mais parcelas de juros que possuam título associado existente no ERP Externo, o sistema processará as integrações da seguinte maneira:
    - irá integrar uma mensagem do tipo ACCOUNTPAYABLEDOCUMENT  em modo de DELETE para estornar o título a pagar associado ao evento no ERP Externo com informações antigas.
    - irá integrar uma mensagem do tipo ACCOUNTPAYABLEDOCUMENT  em modo de UPSERT para incluir o título a pagar associado ao evento no ERP Externo com as novas informações.
    
    Observação: Em cenários onde ocorra sucesso na mensagem de estorno do título antigo e alguma falha na inclusão do novo título, ao acessar o contrato novamente em modo de alteração e apenas gravar, o sistema detectará a falta de título para este evento e executará a integraçao da mensagem ACCOUNTPAYABLEDOCUMENT  em modo de UPSERT para incluir o título a pagar associado ao evento no ERP Externo com as novas informações.
    

Sequencia 006 – Liquidação de juros vinculado – ACC/ACE

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Selecione a parcela de juros e em Outras Ações clique em Liquidar.
   
4. Informe os dados de liquidação e clique em Salvar.
   
5. Clique em Salvar.
   
6. Neste momento, a liquidação de principal será enviada através da mensagem única “ACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de liquidação.
   
7. Em cenários onde será necessário efetuar o estorno da liquidação de uma parcela de juros, esta será enviada através da mensagem única “REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de estorno de liquidação.
   

Sequencia 007 – Contabilização – ACC/ACE

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Miscelanea/Lctos para Contab (EFFEX103).
2. Na tela de parâmetros informe a data para lançamento
3. O sistema inicia a contabilização dos registros.
4. O sistema retorna status de processamento completo, com a conclusão de integração de dados ao ERP Externo.

Sequencia 008 – Inclusão de Contrato – Pre-Pagamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Altere a taxa do evento 100 para que o valor do Financiamento seja recalculado.
4. Clique em Salvar para finalizar.
   
5. Neste momento, o contrato será enviado através da mensagem única “BANKTRANSACTION” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com a taxa alterada.
   
6. O registro é gravado com sucesso.
   

Sequencia 009 – Vinculação de Contrato – Pre-Pagamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Em Outras Ações clique em Vincular.
4. Selecione a parcela de cambio para vinculação.
5. Clique em Salvar.
6. São calculados e gerados os eventos de variação cambial da parcela principal e dos juros.
7. Clique em Salvar.
8. O registro é gravado com sucesso.

Sequencia 010 – Liquidação de cambio vinculado – Pre-Pagamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações/ Exportação/Cambio (EECAF200).
2. No browser de cambio, selecione o registro e clique no botão “Alterar”.
3. Selecione a parcela que encontra-se vinculada e em Outras Ações clique em Liquidar.
4. Selecione a parcela de cambio para vinculação.
5. Informe os dados de liquidação e clique em Salvar.
6. Clique em Salvar.
7. Neste momento, a liquidação de principal será enviada através da mensagem única “ACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de liquidação.
8. Em cenários onde será necessário efetuar o estorno da liquidação de uma parcela de cambio, esta será enviada através da mensagem única “REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de estorno de liquidação.

Sequencia 011 – Alteração dos eventos de principal (700) e juros (710) – Pre-Pagamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Selecione uma parcela de principal (700) ou juros(710) e em Outras Ações clique em Alterar.
   
   Observação: Para eventos de principal ou juros do tipo de contrato PRÉ-PAGAMENTO ( 700 ou 710 ) que integram título a pagar para o ERP Externo, somente em caso de alteração dos campos: Data do evento(EF3_DT_EVE), Moeda do contrato(EF3_MOEDA), Valor em moeda(EF3_VL_MOE), Taxa em reais(EF3_TX_MOE) e Fornecedor do contrato(EF3_FORN) é que será disparada a mensagem de integração para alteração do título.
   
   
4. Informe os dados de liquidação e clique em Salvar.
5. Retornando ao browser de dados e parcelas do contrato, Clique em Salvar.
6. Neste momento, o sistema irá processar as alterações no contrato e havendo alterações em campos (conforme observação acima) de uma ou mais parcelas de juros que possuam título associado existente no ERP Externo, o sistema processará as integrações da seguinte maneira:
    - irá integrar uma mensagem do tipo ACCOUNTPAYABLEDOCUMENT  em modo de DELETE para estornar o título a pagar associado ao evento no ERP Externo com informações antigas.
    - irá integrar uma mensagem do tipo ACCOUNTPAYABLEDOCUMENT  em modo de UPSERT para incluir o título a pagar associado ao evento no ERP Externo com as novas informações.
    
    Observação: Em cenários onde ocorra sucesso na mensagem de estorno do título antigo e alguma falha na inclusão do novo título, ao acessar o contrato novamente em modo de alteração e apenas gravar, o sistema detectará a falta de título para este evento e executará a integraçao da mensagem ACCOUNTPAYABLEDOCUMENT  em modo de UPSERT para incluir o título a pagar associado ao evento no ERP Externo com as novas informações.
   
   

Sequencia 012 – Liquidação de juros vinculado – Pre-Pagamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Selecione a parcela de juros e em Outras Ações clique em Liquidar.
   
4. Informe os dados de liquidação e clique em Salvar.
   
5. Clique em Salvar.
   
6. Neste momento, a liquidação de principal será enviada através da mensagem única “ACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de liquidação.
   
7. Em cenários onde será necessário efetuar o estorno da liquidação de uma parcela de juros, esta será enviada através da mensagem única “REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de estorno de liquidação.

Sequencia 013 – Contabilização – Pre-Pagamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Miscelanea/Lctos para Contab (EFFEX103).
2. Na tela de parâmetros informe a data para lançamento
3. O sistema inicia a contabilização dos registros.
4. O sistema retorna status de processamento completo, com a conclusão de integração de dados ao ERP Externo.

Sequencia 014 – Tranferência de Saldo – ACC/ACE para Pre-Pagamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão Alterar.
3. Selecione a parcela do evento 100 e em Outras Ações clique em Liquidar.
4. Informe a data de encerramento do contrato e clique no botão Salvar.
5. O sistema irá gerar os  eventos relativos ao encerramento do contrato. Verifique que os eventos 180 e 670 foram gerados.
6. Clique no botão Salvar. O sistema irá processar a gravação dos dados e disparar as integrações financeiras para o ERP Externo.
7. Posicione sobre o contrato alterado no browser e clique no botão Alterar. Repare que  a data de encerramento de contrato foi preenchida automaticamente pelo sistema e os  eventos 180 e 670 foram integrados ao ERP Externo para geração de título uma vez que o parâmetro MV_EFF0009 está ativo e estes eventos possuem o número de título Financeiro gerado no ERP Externo e gravado conforme retorno das mensagens financeiras por este ERP.
8. Posicione sobre o evento 180 e clique no botão Liquidar contido em Outras Ações, informe os dados da liquidação e confirme.
9. Posicione sobre o evento  670 e clique no botão Liquidar contido em Outras Ações, informe os dados da liquidação e confirme.
10. Clique no botão Salvar para concluir a liquidação. O sistema irá gravar os dados da operação e disparar as mensagens de integração ao ERP Externo.
11. Posicione de cada vez sobre o evento 180 e 670 e clique no botão Estorno da liquidação para estornar a compensação dos títulos no ERP Externo.
12. Após efetuar o procedimento de estorno para os dois eventos (180 e 670) clique no botão Salvar para concluir a transação. Os sistema irá gravar os dados da  operação e disparar as mensagens de estorno da compensação dos  títulos gerados no ERP Externo
13. Posicione sobre o contrato alterado no browser e clique no botão Alterar. Repare que  os  eventos não possuem mais dados de liquidação e consequentemente os  títulos referentes no ERP Externo estão em aberto novamente.
14. Retire a data de encerramento do contrato e clique no botão Salvar. Desta vez a operação será realizada visto que os títulos relativos aos eventos estão em aberto.
    
15. Ao confirmar a exclusão dos eventos  180 e 670 o sistema estornará os eventos do Browser.
    
16. Clique no botão Salvar para que o sistema efetive a operação. O sistema irá processar a gravação dos dados e disparar as mensagens de estorno dos títulos para o o ERP Externo.
    
17. Ao final do processamento o sistema irá exibir o processo gravado no Browser.
    

Sequencia 015 – Alteração de encargos dos contratos – ACC/ACE/Pre-Pagamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Selecione uma parcela de principal (700) ou juros(710) e em Outras Ações clique em Alterar.
   
   Observação: Para eventos de encargos de contratos ( iniciados em 3 ou 4 ) dos tipos de contrato ACC \ ACE \ PRÉ-PAGAMENTO e que integram título a pagar para o ERP Externo, somente em caso de alteração dos campos: Data do evento(EF3_DT_EVE), Moeda do contrato(EF3_MOEDA), Valor em moeda(EF3_VL_MOE), Taxa em reais(EF3_TX_MOE) e Fornecedor do contrato(EF3_FORN) é que será disparada a mensagem de integração para alteração do título.
   
   
4. Informe os dados de liquidação e clique em Salvar.
5. Retornando ao browser de dados e parcelas do contrato, Clique em Salvar.
6. Neste momento, o sistema irá processar as alterações no contrato e havendo alterações em campos (conforme observação acima) de uma ou mais parcelas de juros que possuam título associado existente no ERP Externo, o sistema processará as integrações da seguinte maneira:
    - irá integrar uma mensagem do tipo ACCOUNTPAYABLEDOCUMENT  em modo de DELETE para estornar o título a pagar associado ao evento no ERP Externo com informações antigas.
    - irá integrar uma mensagem do tipo ACCOUNTPAYABLEDOCUMENT  em modo de UPSERT para incluir o título a pagar associado ao evento no ERP Externo com as novas informações.
    
    Observação: Em cenários onde ocorra sucesso na mensagem de estorno do título antigo e alguma falha na inclusão do novo título, ao acessar o contrato novamente em modo de alteração e apenas gravar, o sistema detectará a falta de título para este evento e executará a integraçao da mensagem ACCOUNTPAYABLEDOCUMENT  em modo de UPSERT para incluir o título a pagar associado ao evento no ERP Externo com as novas informações.

Sequencia 016 – Liquidação de encargos de contratos -  ACC/ACE/Pre-Pagamento

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Exportação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Selecione a parcela de encargo e em Outras Ações clique em Liquidar.
   
4. Informe os dados de liquidação e clique em Salvar.
   
5. Clique em Salvar.
   
6. Neste momento, a liquidação do encargo será enviada através da mensagem única “ACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com as informações de liquidação.
   
7. Em cenários onde será necessário efetuar o estorno da liquidação de uma parcela de juros, esta será enviada através da mensagem única “REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de estorno de liquidação.

Sequencia 017 – Vinculação de Contrato – FINIMP

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações / Importação / Manut. Contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão “Alterar”
3. Em Outras Ações clique em Vincular.
4. Selecione a parcela de cambio para vinculação.
5. Clique em Salvar.
6. São calculados e gerados os eventos de variação cambial da parcela principal e dos juros.
7. Clique em Salvar.
8. O registro é gravado com sucesso.

Sequencia 018 – Liquidação de cambio vinculado – FINIMP

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações/ Importação/Cambio (EICAP100).
2. No browser de cambio, selecione o registro e Outras Ações clique em Liquidação.
3. Selecione a parcela que encontra-se vinculada e em Outras Ações clique em Liquidar.
4. Selecione a parcela de cambio para vinculação.
5. Informe os dados de liquidação e clique em Salvar.
6. Neste momento, a liquidação de principal será enviada através da mensagem única “ACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de liquidação.
7. Em cenários onde será necessário efetuar o estorno da liquidação de uma parcela de cambio, esta será enviada através da mensagem única “REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de estorno de liquidação.

Sequencia 019 – Inclusão de parcelas principais e juros – FINIMP

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações/ Importação/Manut. contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão Alterar.
3. Informe a data de inicio de juros.
4. As parcelas de principal e juros são geradas.
5. Clique em Salvar para finalizar.
6. Neste momento, o contrato será enviado através da mensagem única "BANKTRANSACTION" ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com a taxa alterada.
7. O registro é gravado com sucesso.

Sequencia 020 – Liquidação de principal vinculado – FINIMP

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações/ Importação/Manut. contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão Alterar.
3. Selecione a parcela de principal e em Outras Ações clique em Liquidar.
4. Informe os dados de liquidação e clique em Salvar.
5. Clique em Salvar.
6. Neste momento, a liquidação de principal será enviada através da mensagem única “ACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de liquidação.
7. Em cenários onde será necessário efetuar o estorno da liquidação de uma parcela de principal, esta será enviada através da mensagem única “REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de estorno de liquidação.

Sequencia 021 – Liquidação de juros vinculado – FINIMP

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Atualizações/ Importação/Manut. contrato (EFFEX401).
2. No browser de contratos, selecione o contrato pré requisitado e clique no botão Alterar.
3. Selecione a parcela de juros e em Outras Ações clique em Liquidar.
4. Informe os dados de liquidação e clique em Salvar.
5. Clique em Salvar.
6. Neste momento, a liquidação de juros será enviada através da mensagem única “ACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de liquidação.
7. Em cenários onde será necessário efetuar o estorno da liquidação de uma parcela de juros, esta será enviada através da mensagem única “REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE” ao ERP externo. Confirme no ERP externo que a mensagem foi enviada com com as informações de estorno de liquidação.

Sequencia 022 – Encerramento de contrato

1. No módulo SIGAEFF, acesse o Menu Atualizações/Exportação/Manut. Contrato (EFFEX401).
2. , posicione sobre o registro do contrato requisitado no browser e clique no botão Alterar.
3. Posicione sobre o evento ‘100’ do contrato e em seguida selecione e clique sobre o botão ‘Liquidar’ contido no botão ‘Outras Ações’.
4. O sistema exibirá a tela de encerramento de contrato.
5. Informe a data de encerramento do contrato e clique no botão Confirmar.
6. O sistema irá gerar os  eventos relativos ao encerramento do contrato.
7. Verifique que os eventos 180 e 670 foram gerados.
8. Clique no botão Confirmar.
9. O sistema irá processar a gravação dos dados e disparar as integrações financeiras para o ERP Externo.
10. Posicione sobre o contrato alterado no browser e clique no botão Alterar.
11. Repare que  a data de encerramento de contrato foi preenchida automaticamente pelo sistema e os  eventos 180 e 670 foram integrados ao ERP Externo para geração de título uma vez que o parâmetro MV_EFF0009 está ativo e estes eventos possuem o número de título Financeiro gerado no ERP Externo e gravado conforme retorno das mensagens financeiras por este ERP.
12. Posicione sobre o evento 180 e clique no botão Liquidar contido em Outras Ações, informe os dados da liquidação e confirme.
13. Posicione sobre o evento 670 e clique no botão Liquidar contido em Outras Ações, informe os dados da liquidação e confirme.
14. Clique no botão Confirmar para concluir a liquidação.
15. O sistema irá gravar os dados da operação e disparar as mensagens de integração ao ERP Externo.
16. Posicione sobre o contrato alterado no browser e clique no botão Alterar.
17. Repare que  os  eventos estão liquidados e consequentemente os títulos gerados pelos mesmos foram compensados no ERP Externo.
18. Caso tentar tirar a data de encerramento quando os títulos referente aos  eventos estiverem compensados no ERP Externor, o sistema não permitira a operação.
19. Pressione a tecla ESC do teclado para sair do campo.
20. Clique no botão Fechar para sair da rotina e retorne novamente.
21. Agora posicione de cada vez sobre o evento 180 e 670 e clique no botão Estorno da liquidação para estornar a compensação dos títulos no ERP Externo.
22. Após efetuar o procedimento de estorno para os dois eventos (180 e 670) clique no botão Confirmar para concluir a transação.
23. Os sistema irá gravar os dados da  operação e disparar as mensagens de estorno da compensação dos  títulos gerados no ERP Externo.
24. Posicione sobre o contrato alterado no browser e clique no botão Alterar.
25. Repare que  os  eventos não possuem mais dados de liquidação e consequentemente os  títulos referentes no ERP Externo estão em aberto novamente.
26. Retire a data de encerramento do contrato e clique no botão Confirmar.
27. Desta vez a operação será realizada visto que os títulos relativos aos eventos estão em aberto.
28. Ao confirmar a exclusão dos eventos  180 e 670 o sistema estornará os eventos do Browse.
29. Clique no botão Confirmar para que o sistema efetive a operação.
30. O sistema irá processar a gravação dos dados e disparar as mensagens de estorno dos títulos para o o ERP Externo.
31. Ao final do processamento o sistema irá exibir o processo gravado no Browse.

Sequencia 023 – Contabilização – FINIMP

1. No módulo Easy Financing Controle (SIGAEFF), Clicar em Miscelanea/Lctos para Contab (EFFEX103).
2. Na tela de parâmetros informe a data para lançamento
3. O sistema inicia a contabilização dos registros.
4. O sistema retorna status de processamento completo, com a conclusão de integração de dados ao ERP Externo.