Âncoras - Integração Plugin Monkey

O processo de filtragem das notas fiscais ocorre diretamente no SAP ERP, por meio de um plugin desenvolvido pela Monkey. Esse componente é responsável por aplicar as regras de negócio previamente definidas para selecionar os documentos fiscais aptos à antecipação. As informações são extraídas em formato XML, seguindo a estrutura padrão para integração no SAP, e são transmitidas para a plataforma Monkey por meio do integrador nativo, SAP PI (Process Integration) ou SAP CPI (Cloud Platform Integration). Na camada intermediária, os dados são transformados para o formato JSON, em conformidade com os padrões exigidos pelas APIs da Monkey. Após a análise e processamento na plataforma, eventuais antecipações realizadas são reportadas de volta ao SAP ERP, permitindo a atualização dos dados financeiros de forma automatizada e auditável.

Áreas do Ambiente SAP para Configuração

ABAP: Para que o plugin seja devidamente instalado no ambiente ERP SAP, é necessário realizar a importação dos pacotes fornecidos pela equipe da Monkey. Esses pacotes contêm os componentes essenciais para o funcionamento do plugin, incluindo objetos de desenvolvimento e artefatos técnicos específicos.

CPI/PI: A configuração da comunicação e integração entre o SAP e a plataforma Monkey garante que os dados transitem de forma segura, confiável e em conformidade com os requisitos técnicos e funcionais definidos no projeto.

FI (Financial Accounting): Ajustes e parametrizações específicas são aplicadas no módulo FI, conforme as regras de negócio acordadas com o cliente, assegurando que o plugin opere em total alinhamento com os processos financeiros da empresa.

Metodologia Utilizada: ASAP

ASAP (Accelerated SAP) é uma metodologia utilizada para incrementar a probabilidade de sucesso em projetos SAP. A abordagem foca na implementação rápida e eficaz, com o objetivo de minimizar o tempo entre a instalação e o início da produção.

Etapas:

• Preparação do projeto, com verificação de requisitos técnicos;
• Realização do projeto com customizações e testes de integração;
• Preparação final com aplicação efetiva;
• Início da produção com suporte e otimização da performance.

---

O primeiro passo é a importação dos objetos ABAP e a customização do plugin, com a instalação dos pacotes necessários para configuração de filtros, tabelas de controle, entre outros.

Configurações Gerais

O produto apresenta a transação de Configurações Gerais para o usuário definir algumas regras de negócio que servirão de base para a seleção de dados no SAP.

A extração de títulos de fornecedores para posterior envio a Plataforma da Monkey utiliza estas regras.

• Transação: ZMKYSPT0002

Configurações do Extrator de Dados

O produto apresenta a transação de Configurações do Extrator de Dados para o usuário definir alguns cadastros que servirão de base para a seleção de dados no SAP. A extração de títulos de fornecedores para posterior envio à Plataforma da Monkey, utiliza este cadastro como base.

• Transação: ZMKYSPT0001

Configurações para Compensação

O produto apresenta a transação de Configurações para Compensação, onde o usuário irá definir alguns cadastros que servirão de base para o procedimento de compensação de títulos no SAP após a confirmação da antecipação da fatura do fornecedor na Plataforma de Monkey. O produto possui duas formas de negociação:

• Compensação – Criando uma contrapartida para o banco vencedor e compensando o documento original.

• Fornecedor Alternativo – Após a negociação na plataforma, é atribuído o recebedor alternativo no documento contábil.

• Transação: ZMKYSPT0005

Monitor de Antecipação de Títulos

O monitor do cockpit irá utilizar como base as informações provenientes da extração de dados do SAP de faturas de fornecedores que serão integradas com a Plataforma da MONKEY para antecipação (Risco Sacado). O monitor do cockpit também será preenchido com dados de retorno da integração da Plataforma da MONKEY com o SAP quando tivermos a realização de antecipação de fornecedores ou outros movimentos previstos na integração. Esta parte do produto está dividida em dois itens. Primeiro teremos a tela de seleção com as opções de filtros de dados para serem definidos pelo usuário. Na segunda parte temos o monitor com o resultado de dados a partir das definições da tela de seleção.

• Transação: ZMKYSP_MONITOR

Extrator de Títulos para Antecipação

A integração do SAP com a Monkey para a subida de títulos de fornecedores para antecipação ocorrerá por meio desta transação. Essa solução poderá ser executada automaticamente por meio de um job, processado em um intervalo definido pelo usuário (podendo ocorrer diversas vezes ao dia ou apenas uma vez, conforme o fluxo de documentos criados na base do cliente), enviando os novos títulos de fornecedores para a plataforma da Monkey.

A solução também poderá ser executada manualmente, conforme a necessidade do cliente.

• Transação: ZMKYSPT0003

Relatório de Log de Processamento

O produto oferece a solução de relatório de log de processamento para acompanhamento da execução das integrações do SAP com a Plataforma da Monkey.

• Transação: ZMKYSPT0004

Compensação de Títulos de Fornecedores

Existe na solução uma etapa do processo que não é visível para o usuário que é exatamente a compensação do título (fatura) do fornecedor. No momento da confirmação da Antecipação do título do fornecedor, a Plataforma da Monkey irá disparar um webhook para o SAP, neste webhook o SAP irá localizar o título e efetivar a sua compensação no Contas a Pagar (FI-AP), com a compensação do título original, um novo título será criado para o Banco parceiro responsável pela Antecipação da fatura ou será atribuído o recebedor alternativo. O banco parceiro precisa estar criado no SAP para a localização do código do BP, esta identificação irá ocorrer a partir do CNPJ do banco que será enviado na integração da Plataforma da Monkey com o SAP.

Configurações do Integrador CPI

Assim que o plugin estiver instalado e configurado, teremos à disposição alguns métodos para nos comunicar com a plataforma através do Service Consumer, que é responsável por consumir serviços externos dentro do SAP ERP e é ele que será utilizado para realizar a comunicação com a plataforma nos moldes que são necessários.

O primeiro passo para viabilizar a integração com a plataforma Monkey consiste na configuração dos parâmetros de autenticação no ambiente SAP. Essa autenticação é realizada por meio da chamada ao serviço SECURITY_TOKEN_OUT_S, responsável por gerar e fornecer o token de segurança necessário para consumo das APIs da plataforma. Esse token será utilizado em todas as requisições subsequentes, garantindo a integridade e a autenticação das chamadas via protocolo HTTPS, conforme os padrões OAuth 2.0 adotados pela Monkey.

Após a geração e validação do token de autenticação, torna-se possível consumir os demais serviços disponibilizados pela plataforma Monkey. Um dos principais é o serviço TITULOS_UPLOAD_OUT_S, responsável por estruturar e transmitir os títulos elegíveis, previamente selecionados com base em filtros e parâmetros configurados no plugin. Esses critérios de seleção são definidos conforme as regras de negócio estabelecidas pelo cliente e podem incluir atributos como data de vencimento, status da nota fiscal, código do cliente, entre outros.

O serviço TITULOS_UPLOAD_OUT_S agrupa os documentos filtrados, converte-os no formato adequado e os envia à plataforma Monkey por meio de uma requisição autenticada, assegurando a rastreabilidade e integridade das informações transacionadas.

Da mesma forma, a integração também contempla a funcionalidade de consulta de títulos, por meio do serviço TITULOS_LIST_OUT_S. Esse serviço permite recuperar, a partir da plataforma Monkey, a lista de títulos previamente enviados ou processados.

A integração também oferece suporte à remoção de títulos diretamente a partir do SAP ERP, utilizando o serviço TITULOS_DELETE_OUT_S. Esse serviço permite que o usuário, a partir do ambiente SAP, solicite a exclusão de títulos previamente enviados à plataforma Monkey.

Service Provider

O Service Provider define os serviços que o SAP ERP disponibiliza para outros sistemas e será ele o responsável por receber nosso webhook de retorno para realizar as atualizações necessárias no SAP, caso aconteça alguma antecipação. Neste caso, a integração com o Plataforma exige a configuração dos seguintes serviços:

• WebHook Payables: Este serviço permite que o SAP ERP receba informações de pagamentos vindas do Monkey.

• WebHook Payables Response: Trata respostas de erro nos uploads e títulos deletados.

Configurações do Integrador PI

Assim como na opção de integração via SAP CPI, é possível realizar a comunicação com a Plataforma Monkey por meio do módulo SAP PI (Process Integration). O fluxo de dados e as chamadas realizadas seguem o mesmo padrão técnico, utilizando os mesmos serviços e endpoints, conforme descrito anteriormente.

Enterprise Services Builder

No Enterprise Services Builder são definidos os objetos de integração, como mensagens, interfaces e mapeamentos necessários para que a comunicação entre o SAP ERP e a plataforma Monkey ocorra de forma estruturada. É nesta etapa que são criadas as interfaces de entrada e saída, com base nos formatos XML extraídos do SAP e os formatos JSON exigidos pelas APIs da Monkey.

Integration Builder

A configuração do Integration Builder consiste na criação dos canais de comunicação, onde são definidos os protocolos de transporte, os parâmetros de autenticação, e os endereços dos serviços disponibilizados pela Monkey. Esta camada é responsável por garantir a entrega das mensagens de forma segura, confiável e compatível com os requisitos da integração.

Canais de Comunicação

Serviço	URL	Canal SAP
Gerar Token	https://monkey.tech/API/SecurityToken	CC_SecurityToken_REST_RCV
Exclusão de Títulos	https://monkey.tech/API/Titulos/Delete	CC_TitulosDelete_REST_RCV
Listagem de Títulos	https://monkey.tech/API/Titulos/Listar	CC_TitulosListar_REST_RCV
Upload de Títulos	https://monkey.tech/API/Titulos/Upload	CC_TitulosUpload_REST_RCV

Webhook de Títulos em Caso de Falha no Upload ou Deleção de Títulos

Caso ocorra algum erro durante o envio de títulos à plataforma Monkey, será acionado um webhook de erro. Esse webhook deverá estar configurado no SAP como um serviço receptor via Service Provider, e terá como função registrar a falha no sistema SAP para posterior tratamento. A recepção dessas informações permite a rastreabilidade completa do processo e facilita a auditoria e correção de falhas operacionais.

Webhook de Retorno dos Títulos Negociados

Uma vez que a antecipação do título for concluída na plataforma Monkey, será enviada uma notificação automática para o SAP por meio do Webhook Payables. Esse evento inclui as informações necessárias para realizar a compensação no módulo FI (Contas a Pagar) do SAP. Esse retorno garante que o SAP esteja sempre sincronizado com as operações concluídas na plataforma, eliminando a necessidade de ações manuais e mitigando riscos contábeis.