Integrador TOTVS PROTHEUS x COBMAIS

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.

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”.

Abaixo a relação de rotinas do Integrador para inclusão em MENU PROTHEUS:
ROTINA | DESCRIÇÃO | TIPO | TABELAS |
---|---|---|---|
COB_SPT | Envia Clientes | Função de Usuário | SA1 SA3 |
COB_SRC | Envia Recebiveis | Função de Usuário | SA1 SA3 SE1 |
COB_SSI | Envia Notas* | Função de Usuário | SA1 SA3 SF2 |
COB_SSIC | Envia Notas Canceladas* | Função de Usuário | SA1 SA3 SF2 SF3 |
COB_SCR | Envia Devolucoes* | Função de Usuário | SA1 SA3 SF1 |
COB_SDP | Envia Adiantamentos* | Função de Usuário | SA1 SA3 SE1 |
COB_SBOE | Envia Boletos* | Função de Usuário | SA1 SA3 SE1 SEA SEE |
COB_SIP | Envia Baixas | Função de Usuário | SA1 SA3 FK1 |
COB_GAG | Captura Acordos | Função de Usuário | SA1 SE1 FO0 FO1 FO2 |
COB_GCAG | Captura QuebrasAcordo* | Função de Usuário | SA1 SE1 FO0 FO1 FO2 |
COB_GPY | Captura Baixas | Função de Usuário | SA1 SE1 FK1 |
Abaixo a relação de rotinas do Integrador para inclusão no SCHEDULE PROTHEUS:
ROTINA | DESCRIÇÃO | EMPRESA/FILIAL | RECORRÊNCIA |
---|---|---|---|
U_COBSSPT() | Envia Clientes | 01/01; | Cliente define |
U_COBSSRC() | Envia Titulos | 01/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 Baixas | 01/01; | Cliente define |
U_COBSGAG() | Captura Acordos | 01/01; | Cliente define |
U_COBSGCAG() | Captura QuebrasAcordo* | 01/01; | Cliente define |
U_COBSGPY() | Captura Baixas | 01/01; | Cliente define |
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.

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:
- ERP SAP Business One integração com Cobmais-Renegociação de títulos
- Integração CobMais e SAP Business One – Renegociação de Títulos