Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Versionamento do payload de webhook — NFS-e

O formato do payload de webhook de NFS-e é versionado por empresa, no campo webhookVersion da configuração.

v1 × v2​

Aspectov1v2 (padrão atual)
Campo typedentro de documentna raiz do envelope (alinha com NF-e/CT-e)
Tributoscampo monolítico taxBreakdownreorganizado em federalServiceCode, municipalServiceCode, amounts e taxes (com IBS/CBS)

O valor de type (serviceInvoice, serviceInvoiceEvent, unknown) é o mesmo em v1 e v2 — só a posição do campo no envelope muda entre as versões.

Como cada empresa é versionada​

  • Empresas novas são criadas em v2.
  • Empresas anteriores ao versionamento (webhookVersion = 0, ex.: integrações legadas) permanecem em v1 — não há migração automática. Para migrar, recrie a configuração.
  • Documento órfão (sem empresa configurada) cai em v1 por segurança.
webhookVersion não é exposto na API

Verificamos na plataforma que o GET .../inbound/nfse/details não retorna o campo webhookVersion — ele é um atributo interno por empresa. Para saber em qual versão sua empresa está (ou migrar para v2), trate pela forma do payload recebido ou confirme com o suporte. Empresas criadas recentemente já nascem em v2.

Veja também​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.