Tag: Webhook

A integração fiscal não termina quando o sistema envia uma requisição. Nas APIs assíncronas da apuração da Contribuição sobre Bens e Serviços (CBS), a abertura de uma consulta inicia um processo que pode ser concluído mais tarde, com um arquivo de retorno obtido em etapa própria. Essa distinção é importante para quem mantém ERPs em Delphi e para profissionais contábeis que dependem da consistência dos dados recebidos pelo sistema.

Em 14 de outubro de 2026, a Receita Federal registrou a versão 1.1 das Regras Comuns de Solicitação e Retorno das APIs assíncronas. A revisão atualizou o conteúdo da notificação enviada ao webhook e o fluxo de obtenção e download do arquivo de retorno por meio de urlAssinada. Não se trata, portanto, de apenas trocar uma URL: a implementação precisa separar claramente a abertura, o acompanhamento, a autorização temporária de download e a leitura do arquivo.

Este artigo percorre o fluxo confirmado na documentação oficial, explica seus efeitos operacionais, delimita o que vale especificamente para débitos e créditos e propõe um roteiro de implementação e testes. Também aponta divergências entre páginas oficiais que merecem tratamento defensivo no código.

Este roteiro complementa o guia de integração da apuração assistida ao ERP. Para contextualizar a evolução dos ambientes, consulte também o anúncio inicial das APIs da CBS; os contratos a implementar são os da documentação oficial atual, não os de versões anteriores.

A Receita Federal publicou, em setembro de 2026, uma nova documentação técnica para as interfaces de programação de aplicações, as APIs, ligadas à apuração da Contribuição sobre Bens e Serviços (CBS). A notícia chama atenção pelos serviços de consulta a débitos, créditos, pagamentos e recolhimentos, mas a mudança mais importante para quem desenvolve ERP está na forma de integração: os dados serão entregues de maneira assíncrona e incremental, em arquivos gerados após a solicitação, e não como uma resposta completa e imediata a cada chamada.

Essa diferença parece pequena até imaginarmos a rotina de uma empresa com milhares de documentos fiscais. O ERP precisa solicitar o processamento, guardar um tíquete, receber ou recuperar o resultado, baixar um arquivo temporário, importar apenas as alterações e preservar evidências para conciliação. Neste artigo, vou explicar o que a Receita disponibilizou, como o fluxo técnico funciona e quais decisões de arquitetura evitam perda de dados, duplicidade e exposição de credenciais. O objetivo não é fornecer um conector pronto, porque credenciais e ambientes dependem do enquadramento de cada contribuinte, mas transformar a documentação oficial em um plano de implementação verificável.