Linha de Produto: | Microsiga Protheus | ||||||||||
Segmento: | Manufatura | ||||||||||
Módulo: | Easy Financing Control | ||||||||||
Rotina: |
| ||||||||||
Cadastros Iniciais: | Aplicar atualização dos programas avgeral.prw, AvIntProv.prw, AvUpdate01.PRW, AvUpdate02.prw, Easyinteai.prw, Easymessage.prw, EasyMsgBusiness.prw, EasyMVCAuto.prw, eic.prw, IntegLogixFunc.prw, EECAF200.PRW, EECAF217.PRW, EECAF218.prw, effaf200.prw, EFFEX101.prw, EFFEX102.prw, EFFEX103.prw, EFFEX104.PRW, EFFEX400.prw, EFFEX401.PRW, EECAF224.PRW, EECAF225.PRW. | ||||||||||
Chamados Relacionados | TVKT10 | ||||||||||
País(es): | Brasil | ||||||||||
Banco(s) de Dados: | Todos | ||||||||||
Tabelas Utilizadas: | EC6 - Contas ECF - Eventos Pagamento Antec/Adiant EEQ - Itens de Câmbio de Exportação EF1 - Capa do Financiamento EF3 - Detalhe do Financiamento EF7 - Tipos de Financiamento EFA - Linhas de Crédito SWB - Itens de Câmbio de Importação SWG - Cabeçalho Financiamento | ||||||||||
Sistema(s) Operacional(is): | Windows/Linux |
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:
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.
Itens/Pastas | Descrição |
Nome: | MV_EFF |
Tipo: | Lógico |
Cont. Por.: | .T. |
Descrição: | Parametro logico que define se e usado o modulo de Financiamento para Exportacao. |
Itens/Pastas | Descrição |
Nome: | MV_EEC_EFF |
Tipo: | Lógico |
Cont. Por.: | .T. |
Descrição: | Parametro logico que define se existe integracao dos modulos SigaEEC e SigaEFF. |
Itens/Pastas | Descrição |
Nome: | MV_EECI010 |
Tipo: | Lógico |
Cont. Por.: | .T. |
Descrição: | Habilita integração do Módulo SIGAEEC X LOGIX via Mensagem Unica. |
Itens/Pastas | Descrição |
Nome: | MV_EAIPORT |
Tipo: | Caracter |
Cont. Por.: | RECEIVEMESSAGE |
Descrição: | Indica qual a porta de entrada dos Mapas do ESB |
Itens/Pastas | Descrição |
Nome: | MV_EAIMETH |
Tipo: | Caracter |
Cont. Por.: | RECEIVEMESSAGE |
Descrição: | Informe o metodo de envio do EAI para envio a outro EAI |
Itens/Pastas | Descrição |
Nome: | MV_EAIURL2 |
Tipo: | Caracter |
Cont. Por.: | http:// IP + Porta /Nome do Web Service/EAISERVICE.apw |
Descrição: | Informe o nome do canal configurado no EAI para outro EAI |
Itens/Pastas | Descrição |
Nome: | MV_EAIWS |
Tipo: | Caracter |
Cont. Por.: | WSFWWSEAI |
Descrição: | Informe o nome do Client WebService do EAI para envio a outro EAI |
Itens/Pastas | Descrição |
Nome: | MV_EAIXSD |
Tipo: | Caracter |
Cont. Por.: | Informe o diretorio dos XSD usados na validação do EAI |
Descrição: | \xsd\totvsmessage |
CONFIGURAÇÃO DE AGENTE DO SCHEDULER DO PROTHEUS
CONFIGURAÇÃO DE WEB SERVICE PROTHEUS
CONFIGURAÇÃO DE JOB DO SCHEDULER DO PROTHEUS
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) |
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) |
CONFIGURAÇÃO DA TAREFA DE PROCESSAMENTO DE INTEGRAÇÕES ASSINCRONAS DO SCHEDULER DO PROTHEUS
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) |
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”.
CONFIGURAÇÃO DO APPSERVER 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.
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 |
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:
Grupo | Descrição |
001 | Código de Cliente/Fornecedor |
030 | Tamanho do Produto |
089 | Código de empresa / despachante |
Para integração Protheus X ERP Logix, será necessário efetuar os ajustes abaixo, manualmente, no Configurador (SIGACFG).
Grupo | Descrição | Tamanho |
001 | Código de Cliente/Fornecedor | 15 |
030 | Tamanho do Produto | 30 |
089 | Codigo Empresa Export / Despac | 15 |
Tabela | Campo | Tamanho |
SA1 | A1_NOME | 60 |
SA6 | A4_COD | 15 |
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:
Acesse a opção Incluir e informe os dados do adater, conforme as opções que seguem:
Itens/pastas | Descrição |
Rotina | EECAF217 |
Mensagem | BANKTRANSACTIONS |
Descrição | CONTRATO DE FINANCIAMENTO-INC |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.001 |
Itens/pastas | Descrição |
Rotina | EECAF225 |
Mensagem | ACCOUNTINGENTRY |
Descrição | CONTABILIZAÇÃO DOS CONTRATOS |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF218 |
Mensagem | ACCOUNTPAYABLEDOCUMENT |
Descrição | TIT. A PAGAR (SIGAEFF) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF226 |
Mensagem | ACCOUNTPAYABLEDOCUMENTDISCHARGE |
Descrição | BAIXA TIT. A PAGAR (SIGAEFF) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF228 |
Mensagem | ACCOUNTPAYABLEDOCUMENTDISCHARGE |
Descrição | CONTAB. CONTRATOS EXCLUÍDOS |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF229 |
Mensagem | REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE |
Descrição | EST.BAIXA TIT.A PAGAR (SIGAEFF) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
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:
Sequencia 001 – Cadastro de tipos de financiamento
Sequencia 002 – Inclusão de Contrato – ACC/ACE
Sequencia 003 – Vinculação de Contrato – ACC/ACE
Sequencia 004 – Liquidação de cambio vinculado – ACC/ACE
Sequencia 005 – Liquidação de juros vinculado – ACC/ACE
Sequencia 006 – Contabilização – ACC/ACE
Sequencia 007 – Inclusão de Contrato – Pre-Pagamento
Sequencia 008 – Vinculação de Contrato – Pre-Pagamento
Sequencia 009 – Liquidação de cambio vinculado – Pre-Pagamento
Sequencia 010 – Liquidação de juros vinculado – Pre-Pagamento
Sequencia 011 – Contabilização – Pre-Pagamento
Sequencia 012 – Tranferência de Saldo – ACC/ACE para Pre-Pagamento
Sequencia 013 – Vinculação de Contrato – FINIMP
Sequencia 014 – Liquidação de cambio vinculado – FINIMP
Sequencia 015 – Inclusão de parcelas principais e juros – FINIMP
Sequencia 016 – Liquidação de principal vinculado – FINIMP
Sequencia 017 – Liquidação de juros vinculado – FINIMP
Sequencia 018 – Encerramento de contrato
Sequencia 019 – Contabilização – FINIMP