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

Tipos e enums — NFS-e Inbound

Os valores canônicos vêm da referência gerada da API. O resumo abaixo cobre os mais usados.

Tipo de documento​

Enum interno: None, Dps, EventRegistrationRequest, Nfse, Event, Cnc, Unknown. No payload (wire), Nfse serializa como serviceInvoice, Event como serviceInvoiceEvent (v2), e Unknown como unknown.

Filtro × resposta

No filtro de listagem o tipo da NFS-e é Nfse; na resposta o campo aparece como serviceInvoice. Atente a essa assimetria ao montar filtros.

Status do documento​

Received, Processed, Failed, PdfPending, PdfFailed, Reprocessed.

Status de webhook​

Pending, Delivered, Retrying, DefinitivelyFailed.

Manifestação (tomador)​

  • Códigos de evento: 203202 (Confirmação) e 203206 (Rejeição).
  • Status: Pending → Accepted / Rejected / Failed.

Ambiente​

environment (na empresa e no documento): três valores distintos, case-insensitive — Production, Development e Homologation. A normalização retorna o valor canônico exato (não há mapeamento de Homologation para Development). Quando omitido, o padrão é Production. Verificado no código.

Motivo de desativação (deactivationReason)​

Preenchido quando a empresa é desativada automaticamente. Conjunto definido no código: CertificateNotFound, CertificateExpired, CertificateRejected, CompanyNotAuthorized. (Observado em produção: CertificateNotFound.)

Campos do documento (detalhe REST)​

O GET .../inbound/nfse/{id} retorna metadados — accessKey, nsu, provider/borrower (cada um com federalTaxNumber, name, cityCode), servicesAmount, serviceCode, issueCityCode, accrualOn, generatedOn, status, type, webhookStatus, hasPdf, xmlSizeBytes, failureReason, reprocessCount, webhookAttempts.

REST × webhook

O detalhe REST não traz os grupos de tributos (taxes/amounts) — esses só aparecem no payload do webhook (incluindo IBS/CBS). Veja Reforma Tributária (RTC).

Notificações de manutenção​

  • Severidade: Info, Warning, Critical.
  • Tipo: falhas definitivas de documento/lote/webhook e desativação automática de empresa.
Alguns valores em validação

Detalhes finos de alguns enums (ex.: estados intermediários de status) estão sendo confirmados — ver issue #210. Em caso de dúvida, a fonte de verdade é a referência gerada.

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.