Integrador TOTVS PROTHEUS x COBMAIS

Por Rafael Ogeda em

O Integrador TOTVS PROTHEUS x COBMAIS é um pacote de rotinas PROTHEUS ADVPL, executadas no Ambiente PROTHEUS do cliente, que de tempos em tempos sincronizam os dados de Contas a Receber entre o ERP TOTVS PROTHEUS e a Plataforma COBMAIS.

De modo automatizado todas as informações de cobrança estarão sempre “batendo” entre o ERP PROTHEUS e o COBMAIS.

Entre alguns diferenciais do Integrador TOTVS PROTHEUS x COBMAIS podemos destacar o foco em Segurança, Monitoramento e Escalabilidade:

  • Além dos controles de acesso aos dados e LGPD inerentes ao Integrador, sempre utilizamos para as gravações no ERP PROTHEUS o recurso PROTHEUS de “Execução Automática” (ExecAuto), o que garante o correto processamento de todas as customizações e regras específicas do cliente.
  • Além disso, todos os processos do Integrador são registrados em tabelas de log no banco de dados, sendo disponibilizados através de um Portal de Monitoramento web responsivo.
  • O Integrador permite facilmente incluir tratamento para campos de usuário, bem como modificar alguma regra de negócio específica caso necessário. Tudo de modo ágil, garantindo a escalabilidade do Integrador.

Instalação em Ambiente TOTVS PROTHEUS

O Integrador TOTVS PROTHEUS x COBMAIS é uma solução fracamente acoplada, e é basicamente composto de 2 componentes instalados no Ambiente PROTHEUS do cliente: API REST customizada (instalada em APPSERVER PROTHEUS REST – agente passivo) e RPA cobmaisRPA (instalado no SCHEDULE/Menu PROTHEUS – agente ativo).

Abaixo o check-list de Pré-Requisitos do Ambiente PROTHEUS do cliente:

  • Configurar APPSERVER REST (usa licença TOTVS I, o server deve ser liberado para 3 IP INTERGATE)
  • Instalar pacotes/patches INTERGATE (ConectorGate + salesAPI + finAPI + cobmaisRPA)
  • Aplicar ponto de entrada FINA460A_PE.PRW (para tratar multa/juros em Liquidação)
  • Criar campos default I_N_S_D_T_ e S_T_A_M_P_ (tabelas SA1, SF1, SF2, SF3, SE1, SEA, FK1, FO0)
  • Criar 4 campos de usuário usados pelo Integrador (3x SE1 + 1x FK1)
  • Configurar SCHEDULE (para execuções automáticas) e/ou MENU (para execuções manuais)

Projeto de Implantação

O Projeto de Implantação do Integrador TOTVS PROTHEUS x COBMAIS é realizado em algumas poucas etapas, visando essencialmente validar Regras de Negócio e homologar as rotinas de carga e atualização do Integrador:

  • BBP/Regras de Negócio: nesta etapa as regras de negócio do Integrados são validadas em relação à operação usual do ERP TOTVS PROTHEUS pelo cliente. Entre as principais regras a serem revisadas estão: DE-PARA de filiais x credores, DE-PARA de dados bancários, campos de usuário no ERP e no COBMAIS, e chaves primárias para contratos/parcelas que serão utilizadas. Como o padrão de Acordos no COBMAIS envolve o pagamento/baixa da 1a parcela, então esta também é uma regra importante a revisar.
  • Homologação: nesta etapa os processos do Integrador são validados pelo cliente. Basicamente temos a Homologação da Carga de Dados (com validação quali e quantitativa da carga de dados realizada entre PROTHEUS e COBMAIS), e a Homologação dos Testes Unitários (com validação dos processos usuais e diários realizados no PROTHEUS e no COBMAIS, e que devem refletir no outro sistema).
  • Cutover/Golive: nesta etapa, realizada após Aceite da Homologação, o ambiente TOTVS PROTHEUS de Produção é preparado, a carga de dados full entre PROTHEUS e COBMAIS é realizada e o Integrador é ativado no SCHEDULE do PROTHEUS.
Integrador PROTHEUS x COBMAIS - Projeto de Implantação - BBP > Homologação > Cutover/Golive

Processos do Integrador

As rotinas do integrador podem ser configuradas em algum MENU PROTHEUS (para execução manual), ou podem ser configuradas no SCHEDULE PROTHEUS (para execução automática).

Basicamente podemos dividir os Processos do Integrador em 2 fluxos: PROTHEUS para COBMAIS, e COBMAIS para PROTHEUS.

  • No fluxo do ERP para o COBMAIS temos 3 processos: Clientes (com saldo), Recebíveis (NF, NCC, RA, etc) e Baixas (com ou sem movimento bancário). Há ainda processos opcionais que podem ou não ser ativados: Notas, Notas Canceladas, Adiantamentos, Devoluções e Boletos.
  • No fluxo do COBMAIS para o ERP temos também 3 processos: Acordos (Parcelamento/Liquidação, Prorrogação ou Renegociação), Quebras de Acordo e Baixas. O processo Quebras de Acordo somente será implementado se o COBMAIS não for configurado para “1a parcela paga”.
Integrador PROTHEUS x COBMAIS - Processos do Integrador

Abaixo a relação de rotinas do Integrador para inclusão em MENU PROTHEUS:

ROTINADESCRIÇÃOTIPOTABELAS
COB_SPTEnvia ClientesFunção de UsuárioSA1 SA3
COB_SRCEnvia RecebiveisFunção de UsuárioSA1 SA3 SE1
COB_SSIEnvia Notas*Função de UsuárioSA1 SA3 SF2
COB_SSICEnvia Notas Canceladas*Função de UsuárioSA1 SA3 SF2 SF3
COB_SCREnvia Devolucoes*Função de UsuárioSA1 SA3 SF1
COB_SDPEnvia Adiantamentos*Função de UsuárioSA1 SA3 SE1
COB_SBOEEnvia Boletos*Função de UsuárioSA1 SA3 SE1 SEA SEE
COB_SIPEnvia BaixasFunção de UsuárioSA1 SA3 FK1
COB_GAGCaptura AcordosFunção de UsuárioSA1 SE1 FO0 FO1 FO2
COB_GCAGCaptura QuebrasAcordo*Função de UsuárioSA1 SE1 FO0 FO1 FO2
COB_GPYCaptura BaixasFunção de UsuárioSA1 SE1 FK1
Rotinas do Integrador PROTHEUS x COBMAIS – Menu (* = opcional)

Abaixo a relação de rotinas do Integrador para inclusão no SCHEDULE PROTHEUS:

ROTINADESCRIÇÃOEMPRESA/FILIALRECORRÊNCIA
U_COBSSPT()Envia Clientes01/01;Cliente define
U_COBSSRC()Envia Titulos01/01;Cliente define
U_COBSSSI()Envia Notas*01/01;Cliente define
U_COBSSSIC()Envia Notas Canceladas*01/01;Cliente define
U_COBSSCR()Envia Devolucoes*01/01;Cliente define
U_COBSSDP()Envia Adiantamentos*01/01;Cliente define
U_COBSSBOE()Envia Boletos*01/01;Cliente define
U_COBSSIP()Envia Baixas01/01;Cliente define
U_COBSGAG()Captura Acordos01/01;Cliente define
U_COBSGCAG()Captura QuebrasAcordo*01/01;Cliente define
U_COBSGPY()Captura Baixas01/01;Cliente define
Rotinas do Integrador PROTHEUS x COBMAIS – Schedule (* = opcional)

Configuração do Integrador PROTHEUS x COBMAIS

Abaixo relacionamos os principais parâmetros (SX6) relacionados com a Configuração do Integrador PROTHEUS x COBMAIS:

  • API REST:
    • IG_APIPROT: API – Protocolo
    • IG_APIENDP: API – Endpoint
    • IG_APIUSER: API – User
    • IG_APIPASS: API – Password
  • APP COBMAIS:
    • IG_APPPROT: APP – Protocolo API
    • IG_APPENDP: APP – Endpoint API
    • IG_APPKEY: APP – Chave de acesso API (credor se for único)
    • IG_APPTOKE: APP – Token de acesso API
    • IG_APPUSER: PP – User de acesso API
  • Operação do Integrador:
    • IG_APPQTYP: Tipo de consulta utilizada pelo Integrador (full/incremental)
    • IG_APPDINC: Dias para retroceder na consulta incremental (normalmente igual a 0)
  • Campos de usuário:
    • IG_CBACID: Campo de usuario na SE1 para acordo_id COBMAIS
    • IG_CBCTID: Campo de usuario na SE1 para contrato COBMAIS
    • IG_CBPCID: Campo de usuario na SE1 para parcela COBMAIS
    • IG_CBPGID: Campo de usuario na FK1 para pagamento_id COBMAIS

Monitoramento

O Integrador PROTHEUS x COBMAIS conta com exclusivo sistema de monitoramento, através de Portal Web responsivo com os principais indicadores e rastreamento de processos e falhas. Além do monitoramento ativo dos processos de integração, alertas específicos podem ser implementados visando aumentar a eficiência.

Integrador PROTHEUS x COBMAIS - Execução manual via MENU ou automática via SCHEDULE - Monitoramento por Portal e Workflow

Conclusões

Com o Integrador PROTHEUS x COBMAIS todas as informações relacionadas com o Contas a Receber do ERP estarão sempre automaticamente sincronizadas com o COBMAIS, evitando intervenção humana e elevando muito a eficiência de sua cobrança.


Saiba mais: