Como integrar antecipação de recebíveis compatível com ERP

Última atualização: 6 de agosto de 2026

Principais lições deste artigo

• Integração via API REST e webhooks permite automatizar títulos, simular taxas e registrar baixa automática no ERP.

• Os cinco cenários mais comuns de ERP (TOTVS, Omie, Sankhya, SAP e ERPs genéricos) seguem padrões de campos que facilitam o mapeamento de recebíveis.

• Uso de sandbox com OAuth 2.0 e ambiente de testes reduz riscos antes da entrada em produção.

• Monitoramento contínuo com alertas e reconciliação diária preserva a integridade das operações de antecipação.

• A Celcoin atua como provedora neutra de infraestrutura tecnológica para empresas que desejam ofertar produtos de crédito aos seus clientes. Veja como a Celcoin pode viabilizar sua oferta de crédito.

Passos para realizar a integração

1. Verificar as capacidades do ERP: antes de iniciar a integração, confirmar se o ERP expõe endpoints REST ou SOAP para contas a receber, notas fiscais e movimentos financeiros, e se suporta envio ou recebimento de webhooks. Sem esses recursos, será necessário usar uma camada de middleware, como descrito na seção de ERPs genéricos.

2. Configurar OAuth 2.0: com os endpoints confirmados, garantir autenticação segura. Registrar a aplicação na plataforma de crédito, obter client_id e client_secret, implementar o fluxo de token com refresh automático e armazenar credenciais em cofre seguro, como HashiCorp Vault ou AWS Secrets Manager.

3. Mapear títulos e campos: identificar os campos obrigatórios, como número do título, CNPJ do sacado, valor nominal, data de vencimento e chave da NF-e vinculada, e criar a tabela de correspondência entre o modelo de dados do ERP e o payload da API de antecipação. Esses campos mapeados serão enviados na requisição de antecipação e retornarão nos webhooks de status.

4. Configurar webhooks: com o mapeamento de campos definido, registrar a URL de callback na plataforma de crédito para receber eventos de status, como agendado, creditado, cancelado e vencido. Implementar idempotência usando o campo id do evento para evitar processamento duplicado em caso de reentrega.

5. Executar testes em sandbox: usar o ambiente de homologação com tokens OAuth de teste, simular o ciclo completo de antecipação e validar a baixa automática no ERP sem afetar dados de produção.

6. Promover para produção com rollout faseado: iniciar com um subconjunto de títulos de baixo risco, monitorar logs e alertas por 72 horas e ampliar o volume gradualmente após validar estabilidade e conciliação.

Comece sua integração com a infraestrutura de crédito da Celcoin.

Como integrar na TOTVS?

O TOTVS expõe serviços REST nativos no módulo Financeiro (Protheus) que permitem listar, detalhar e baixar títulos a receber. Os quatro endpoints a seguir cobrem o ciclo completo de antecipação, da consulta de títulos elegíveis à baixa e conciliação bancária.

Endpoint	Método	Função	Campo-chave
/api/fin/v1/receivables	GET	Listar títulos a receber	E1_NUM, E1_VENCTO
/api/fin/v1/receivables/{id}	GET	Detalhar título	E1_VALOR, E1_CLIENTE
/api/fin/v1/receivables/{id}/settlement	POST	Registrar baixa	E1_NUMBCO, E1_DTBAIXA
/api/fin/v1/bankstatements	GET	Conciliação bancária	E5_DATA, E5_VALOR

Campos de mapeamento: E1_NUM (número do título), E1_CLIENTE (código do sacado), E1_VENCTO (vencimento), E1_VALOR (valor nominal), E1_NUMBCO (número do banco para baixa).

Exemplo de webhook para baixa automática:

{ "event": "RECEIVABLE_ANTICIPATION_CREDITED", "id": "evt_abc123", "anticipation": { "titleId": "E1_NUM_00123", "netValue": 9700.00, "anticipationDate": "2026-08-06" } } 

Dica útil, compliance: a Resolução BCB nº 304/2023 exige rastreabilidade de ativos financeiros registrados. Manter o número de protocolo de registro do recebível em cada baixa no TOTVS facilita auditoria e reconciliação com a infraestrutura de crédito.

Como integrar na Omie?

Enquanto o TOTVS utiliza endpoints REST com OAuth 2.0, a API do Omie adota autenticação baseada em App Key e App Secret, obtidos pelo administrador do sistema, em chamadas POST com payload JSON estruturado.

Endpoint	Método (call)	Função	Campo-chave
https://app.omie.com.br/api/v1/financas/contareceber/	ListarContasReceber	Listar títulos	nCodTitulo, dDtVenc
https://app.omie.com.br/api/v1/financas/contareceber/	LancarRecebimento	Registrar recebimento	nCodBaixa, dDtCredito
https://app.omie.com.br/api/v1/financas/contareceber/	ConciliarRecebimento	Conciliar título	dDtConcilia, status
https://app.omie.com.br/api/v1/financas/mf/	ListarMovimentos	Movimentos financeiros	nCodBaixa, dDtCredito

Essas chamadas compartilham a mesma URL base e variam apenas pelo método lógico informado no campo call, o que simplifica a padronização do conector.

Campos de mapeamento: nCodTitulo, dDtVenc (formato DD/MM/AAAA), nValorTitulo, status (EMABERTO, RECEBIDO, ATRASADO). Para extração incremental, utilizar os filtros dDtIncDe e pagina com limite de 500 registros por página.

Exemplo de webhook para baixa automática:

{ "event": "RECEIVABLE_ANTICIPATION_CREDITED", "id": "evt_omie_456", "anticipation": { "nCodTitulo": "78901", "netValue": 4850.00, "dDtCredito": "06/08/2026" } } 

Dica útil, erros comuns de mapeamento: o fluxo de antecipação no Omie requer a criação de uma conta corrente de compensação, como uma conta garantida, para registrar o desconto. Essa configuração evita duplicidade de eventos de caixa. Não utilizar a conta operacional padrão para o lançamento da antecipação.

Como integrar na Sankhya?

A integração com Sankhya W segue um padrão de gateway único, em que todos os serviços REST passam pelo mesmo endpoint service.sbr com parâmetros diferentes. Esse modelo facilita o roteamento e o controle de sessão.

Endpoint	Método	Função	Campo-chave
/mge/service.sbr?serviceName=CRUDServiceProvider.loadRecords	POST	Listar títulos (TGFFIN)	NUFIN, DTVENC
/mge/service.sbr?serviceName=CRUDServiceProvider.saveRecords	POST	Baixar título	NUFIN, DTNEG, VLRDESDOB
/mge/service.sbr?serviceName=SessionService.login	POST	Autenticação	token (retorno)
/mge/service.sbr?serviceName=SessionService.logout	POST	Encerrar sessão	token

Campos de mapeamento: NUFIN (número único financeiro), CODPARC (código do parceiro ou sacado), DTVENC (vencimento), VLRDESDOB (valor do desdobramento), RECDESP (1 para receber).

Exemplo de webhook para baixa automática:

{ "event": "RECEIVABLE_ANTICIPATION_CREDITED", "id": "evt_snk_789", "anticipation": { "NUFIN": "334455", "netValue": 12300.00, "DTNEG": "2026-08-06" } } 

Dica útil, segurança: tokens de sessão do Sankhya têm tempo de expiração configurável. Implementar renovação automática antes do vencimento e armazenar o token em memória segura, nunca em logs ou variáveis de ambiente expostas. Utilizar TLS 1.2 ou superior em todas as chamadas, prática alinhada a sistemas financeiros.

Como integrar na SAP?

O SAP S/4HANA utiliza OData services e APIs REST expostas pelo SAP API Business Hub para o módulo de Contas a Receber, o que exige atenção a metadados e modelos de entidade. Os serviços abaixo cobrem consulta de documentos, itens a receber, baixa e conciliação.

Endpoint (OData/REST)	Método	Função	Campo-chave
/sap/opu/odata/sap/API_CUSTOMER_DOCUMENT_SRV	GET	Listar documentos de cliente	CompanyCode, Customer
/sap/opu/odata/sap/API_OPLACCTGDOCITEMCUBE_SRV	GET	Itens contábeis a receber	AccountingDocument, NetDueDate
/sap/opu/odata/sap/API_FINANCIALPLANDATA_SRV	POST	Registrar baixa ou liquidação	ClearingDocument, PostingDate
/sap/opu/odata/sap/API_BANK_STATEMENT_SRV	GET	Extrato bancário para conciliação	BankStatementID, ValueDate

Campos de mapeamento: AccountingDocument (número do documento), Customer (código do sacado), NetDueDate (vencimento líquido), AmountInTransactionCurrency (valor), ClearingDocument (documento de compensação).

Exemplo de webhook para baixa automática:

{ "event": "RECEIVABLE_ANTICIPATION_CREDITED", "id": "evt_sap_321", "anticipation": { "AccountingDocument": "1800045678", "netValue": 28500.00, "PostingDate": "2026-08-06" } } 

Dica útil, compliance: o SAP Cloud ERP mantém controles de identidade, acesso e conformidade regulatória integrados. Ao conectar uma plataforma de antecipação, restringir o perfil de autorização da conta de serviço às transações FI-AR, aplicando o princípio de menor privilégio.

Como integrar em ERPs genéricos?

Se o ERP da sua empresa não está entre os quatro sistemas descritos acima ou não expõe APIs REST ou SOAP nativas, a integração exige uma camada intermediária. ERPs sem conectores nativos para antecipação de recebíveis podem ser integrados por middleware iPaaS, como MuleSoft, Boomi ou Azure Logic Apps, ou por um API gateway customizado.

Camada	Componente	Função	Padrão recomendado
Extração	API REST ou SOAP do ERP	Exportar títulos e notas fiscais	Polling incremental ou CDC
Transformação	Middleware ou iPaaS	Mapear campos para payload da API de crédito	Canonical data model
Envio	API de antecipação	Submeter títulos para antecipação	REST e OAuth 2.0
Retorno	Webhook listener	Receber status e acionar baixa no ERP	HTTPS e idempotência

Essa arquitetura em camadas separa extração, transformação, envio e retorno, o que facilita manutenção e evolução da integração ao longo do tempo.

Campos mínimos obrigatórios no payload genérico: document_number, debtor_tax_id (CNPJ), face_value, due_date, invoice_key (chave NF-e).

Exemplo de webhook para baixa automática:

{ "event": "RECEIVABLE_ANTICIPATION_CREDITED", "id": "evt_gen_654", "anticipation": { "document_number": "DOC-2026-0089", "netValue": 7200.00, "creditedAt": "2026-08-06T14:30:00Z" } } 

Dica útil, segurança: utilizar contas de serviço dedicadas com permissões restritas ao escopo da integração, nunca credenciais administrativas. Rotacionar API keys em intervalo definido, revogar conexões inativas e criptografar todos os dados em trânsito com TLS 1.2 ou superior.

Simplifique sua integração de crédito com as APIs modulares da Celcoin.

Sandbox e testes

O uso de sandbox permite validar o ciclo completo de antecipação antes da produção, com o mesmo fluxo de OAuth 2.0 e credenciais isoladas. Esse ambiente reduz riscos de inconsistências contábeis e falhas de mapeamento.

1. Solicitar token: POST https://sandbox.api.celcoin.com.br/v5/token com grant_type=client_credentials, client_id e client_secret de teste. Esse token autentica todas as chamadas subsequentes à API.

2. Com o token obtido, usar o access_token no header Authorization: Bearer {token} em todas as chamadas subsequentes.

3. Submeter títulos de teste ao endpoint POST https://sandbox.api.celcoin.com.br/v1/anticipation/receivables, respeitando o schema definido.

4. Simular eventos de webhook disparando manualmente os status SCHEDULED, PENDING e CREDITED para validar o fluxo de retorno.

5. Validar a baixa automática no ERP de homologação, garantindo que nenhum dado real seja afetado.

Checklist de validação em sandbox:

• Token OAuth obtido e renovado corretamente antes da expiração.

• Payload de título aceito sem erros de validação de schema.

• Webhook recebido na URL de callback com resposta HTTP 200.

• Idempotência verificada, com reenvio do mesmo evento sem gerar duplicidade contábil.

• Baixa registrada no ERP com o número de protocolo da antecipação.

• Logs de auditoria gerados com timestamp e identificador do evento.

Validação e monitoramento

Após a entrada em produção, o monitoramento contínuo garante que o fluxo de antecipação permaneça íntegro. Combinar webhooks em tempo real com polling agendado como fallback reduz o risco de perda de eventos de status em caso de indisponibilidade temporária do endpoint de callback.

Práticas recomendadas de observabilidade:

• Configurar alertas para falhas consecutivas de entrega de webhook, por exemplo, três tentativas sem resposta HTTP 2xx, para identificar problemas de comunicação rapidamente.

• Monitorar diariamente a fila de exceções de reconciliação, pois títulos antecipados sem baixa correspondente no ERP indicam falha de integração que precisa de correção manual.

• Manter logs imutáveis com timestamp NTP, retidos pelo período regulatório mínimo de cinco anos, para atender exigências de auditoria de operações financeiras.

• Implementar dashboard de status com métricas de latência de webhook, taxa de sucesso de baixa automática e volume de títulos processados por período, o que facilita a identificação de gargalos.

• Executar reconciliação diária comparando o extrato da plataforma de antecipação com os movimentos registrados no ERP, garantindo alinhamento entre as duas bases.

Funcionalidades da Celcoin

A integração técnica descrita acima é suportada pela infraestrutura modular da Celcoin. A tabela a seguir resume as funcionalidades da plataforma que dão suporte a cada etapa do fluxo de antecipação, desde as APIs que aceleram a integração até os controles de risco e compliance que protegem a operação.

Funcionalidade da Celcoin	Benefício para sua empresa
APIs modulares	Integrações mais rápidas, com redução de custos e prazos de desenvolvimento.
Experiência e suporte ao desenvolvedor	Documentação, SDKs e sandboxes que reduzem ciclos de integração e esforço de engenharia.
Capacidade de lançamento rápido	Módulos pré-construídos e entrega via SaaS aceleram lançamentos, melhorando o tempo para geração de receita.
Distribuição white-label e embutida	Suporte a produtos financeiros com marca própria, integrados à jornada do seu cliente.
Escalabilidade com confiabilidade	Infraestrutura em nuvem com alta disponibilidade mantém serviços funcionando mesmo com altos volumes.
Cobertura de diversas possibilidades de pagamentos, incluindo crédito	Oferta combinada de pagamentos e crédito aumenta conversão, ARPU e fidelização.
Acesso a dados e personalização	Dados e análises via Open Finance permitem ofertas personalizadas, com impacto em conversão e retenção.
Compliance e conformidade como princípio	KYC, AML e relatórios integrados reduzem risco regulatório e encurtam ciclos de vendas.
Prevenção de fraude e controles de risco	Monitoramento baseado em IA e autenticação robusta reduzem estornos, perdas e exposição regulatória.
Força do ecossistema de parceiros da Celcoin	Parcerias e integrações com bancos, redes e fintechs ampliam cobertura e velocidade de entrada no mercado.

A Celcoin não oferece nenhum tipo de empréstimo para consumidores. A Celcoin fornece a infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes.

Para ERPs, varejistas, fintechs de crédito e correspondentes bancários, a solução de crédito da Celcoin abrange toda a jornada, da originação e simulação de taxas à formalização via CCB, gestão da carteira e cobrança. A integração com o ERP existente ocorre via APIs modulares, sem necessidade de reconstruir a lógica bancária internamente.

A Celcoin atua como participante direta no Pix, possui licenças de Instituição de Pagamento e Sociedade de Crédito Direto e opera com neutralidade em relação às gestoras de fundos parceiras, o que permite que empresas acessem condições competitivas de crédito para seus clientes finais. A plataforma já medeia mais de R$ 30 bilhões em transações mensalmente, atendendo milhares de clientes em diferentes segmentos e portes.

Conheça em detalhes a solução de crédito da Celcoin.

Conclusão

Integrar um ERP a uma plataforma de antecipação de recebíveis envolve etapas técnicas bem definidas: verificação das capacidades do ERP, configuração de autenticação segura, mapeamento de campos, configuração de webhooks, testes em sandbox e entrada em produção com rollout faseado. Cada etapa reduz o risco de inconsistências contábeis e garante que o fluxo de baixa automática funcione de forma confiável.

Os cinco sistemas abordados neste artigo, TOTVS, Omie, Sankhya, SAP e ERPs genéricos, seguem padrões distintos de autenticação e estrutura de dados, mas compartilham os mesmos campos obrigatórios para a antecipação: número do título, CNPJ do sacado, valor nominal, data de vencimento e chave da NF-e. O mapeamento correto desses campos é o fator que mais impacta a estabilidade da integração ao longo do tempo.

O monitoramento contínuo após a entrada em produção, com alertas de falha de webhook e reconciliação diária, preserva a integridade das operações e facilita auditorias regulatórias. A infraestrutura modular da Celcoin suporta todo esse fluxo, da originação à cobrança, sem que a empresa precise construir a lógica bancária internamente. Conheça como a Celcoin pode viabilizar sua oferta de crédito.

Perguntas frequentes

Quais ERPs são compatíveis com a infraestrutura de antecipação de recebíveis da Celcoin?

A infraestrutura da Celcoin se comunica via API REST e webhooks, o que a torna compatível com qualquer ERP que exponha endpoints REST ou SOAP. TOTVS Protheus, Omie, Sankhya W e SAP S/4HANA possuem conectores nativos documentados. ERPs que não expõem APIs nativas podem ser integrados por meio de uma camada de middleware iPaaS, como MuleSoft, Boomi ou Azure Logic Apps.

É necessário ter uma equipe de desenvolvimento para realizar a integração?

Sim. A integração exige conhecimento de APIs REST, OAuth 2.0 e mapeamento de campos entre sistemas. A Celcoin disponibiliza documentação técnica, SDKs e um ambiente de sandbox para reduzir o esforço de engenharia, mas a implementação e os testes devem ser conduzidos por uma equipe técnica responsável pelo ERP e pela plataforma de crédito.

Quanto tempo leva para concluir a integração?

O prazo varia conforme a complexidade do ERP e o volume de customizações existentes. Integrações com ERPs que já expõem APIs REST tendem a ser mais rápidas. O uso do ambiente de sandbox e de um rollout faseado na entrada em produção contribui para reduzir retrabalho e encurtar o ciclo total de implementação.

O ambiente de sandbox está disponível para todos os clientes da Celcoin?

Sim. O sandbox utiliza o mesmo fluxo de OAuth 2.0 do ambiente de produção, com credenciais isoladas. Ele permite simular o ciclo completo de antecipação, incluindo envio de títulos, disparo manual de eventos de webhook e validação da baixa automática no ERP, sem afetar dados reais.

Como a baixa automática no ERP é acionada após a antecipação?

Quando a plataforma de antecipação credita o valor ao cedente, ela dispara um evento de webhook com o status RECEIVABLE_ANTICIPATION_CREDITED para a URL de callback registrada. O sistema receptor processa esse evento e aciona a API do ERP para registrar a baixa do título correspondente. A implementação de idempotência usando o campo id do evento evita registros duplicados em caso de reentrega do webhook.

A Celcoin oferece crédito diretamente para os consumidores finais?

Não. A Celcoin não oferece nenhum tipo de empréstimo para consumidores. A Celcoin fornece a infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes. O modelo de atuação é B2B, voltado a ERPs, varejistas, fintechs e correspondentes bancários que desejam disponibilizar produtos financeiros dentro de suas próprias plataformas.