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

FAQ — NFS-e Inbound

Preciso de certificado digital para receber NFS-e?​

Sim. A recepção de NFS-e acessa o ADN usando o certificado da empresa via mTLS — sem certificado válido, a captura é desativada (deactivationReason de certificado). Veja Certificado digital.

Como sou notificado de cada NFS-e?​

Por webhook (POST assinado com HMAC-SHA1, header x-hub-signature). Veja Webhook — eventos.

Qual o tamanho da chave de acesso da NFS-e?​

50 dígitos (modelo 56). O DPS tem 42 dígitos. Veja NSU, chaves e modelos.

Como manifesto como tomador?​

Pelos códigos 203202 (Confirmação) e 203206 (Rejeição), de forma assíncrona (202). Veja Manifestação do tomador.

Como exporto muitos documentos de uma vez?​

Use a exportação em massa (XML, PDF ou CSV) por período.

Como sei em qual versão de payload minha empresa está?​

O webhookVersion não é exposto na API. Trate pela forma do payload recebido (empresas novas nascem em v2) ou confirme com o suporte. Veja Versionamento de webhook.

Preciso pagar por cada documento recebido?​

A recepção é bilhetada por SKU (ex.: ServiceInvoiceInbound). Consulte seu plano comercial para os valores.

Documentos emitidos antes da ativação aparecem?​

Para NF-e/CT-e, a SEFAZ disponibiliza ~90 dias de histórico (use startFromNsu/startFromDate). Para NFS-e, a captura parte do momento da ativação no ADN.

Listagem em lote: há custo, limite de requisições ou ordenação fixa?​

A listagem segue paginação por NSU em ordem ascendente. Para grandes volumes, prefira a exportação em massa (job assíncrono) em vez de paginar manualmente. Documentos que chegarem durante a iteração entram com NSU maior — continue do último NSU lido.

Qual a diferença entre NFS-e e NF-e?​

NF-e (modelo 55) documenta mercadorias/produtos; NFS-e (modelo 56) documenta serviços. São produtos de recepção distintos — veja a visão geral.

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.