Cenários de erro 400 (BadRequest) na emissão de NFS-e
Catálogo dos cenários em que a API de NFS-e retorna HTTP 400 (BadRequest) na emissão e nas operações da nota, com a regra violada e como corrigir.
Catálogo dos cenários em que a API de NFS-e retorna HTTP 400 (BadRequest) na emissão e nas operações da nota, com a regra violada e como corrigir.
Distinção entre os dois contextos de eventCode no NFS-e Inbound: XSD tpEvento (webhook) vs EventCode do CSV de bulk export analítico.
Referência dos códigos HTTP retornados pela API, formato de erro, headers de rate limit e estratégia de retry com backoff exponencial.
Esquema completo, coluna a coluna, do CSV analítico de NFS-e recebidas (resource company-nfse-inbound-analytical-csv).
Como usar externalId (idempotência) e RPS na emissão de NFS-e.
Cenários do grupo IBS/CBS da Reforma Tributária na emissão de NFS-e.
Cenários de retenção na emissão de NFS-e: IRRF, ISS retido, PIS/COFINS/CSLL, INSS e retenção plena.
Cenários de emissão de NFS-e por regime tributário do prestador (MEI, Simples, Lucro Presumido, Lucro Real) e por tipo de tomador.
Cenários por tipo de atividade na emissão de NFS-e: evento, construção, locação, comércio exterior, substituição, intermediário.
Cenários de tributação do ISS (cálculo manual, isento, imune, suspenso) e local de prestação na emissão de NFS-e.
Referência curada dos endpoints REST da recepção de NFS-e: empresas, documentos, downloads, manifestação e manutenção.
Referência dos endpoints da API para CT-e: metadados, XML, reprocessamento de webhooks e consolidação de batch.
Referência dos endpoints da API para NF-e: buscar metadados, baixar XML/PDF, eventos, manifestação e reprocessamento de webhook.
Códigos de status HTTP retornados pela API de recepção de NFS-e, formato do corpo de erro e como reagir a cada um.
Perguntas frequentes sobre o NFe/CTe Inbound — técnico (API, NSU, rate limit) e funcional (cobertura, fraude, sincronia, NFC-e).
Perguntas frequentes sobre a recepção automática de NFS-e: certificado, webhook, manifestação e exportação.
Definições dos termos técnicos e fiscais usados no NFe/CTe Inbound (NSU, DANFE, AN, IBS, CBS, EFD, manifestação, etc.).
Onde vivem as peças transversais do NFS-e Inbound: HMAC, polling ADN, signed URLs, auth, rate limiting. Referência rápida para consultar contrato técnico e abrir ticket no time certo.
Índice dos 26 cenários de emissão de NFS-e, com o payload base e o guia de cada eixo.
Documentação de referência do NFe/CTe Inbound: endpoints NF-e e CT-e, webhook events com HMAC, tipos e enums, códigos HTTP, FAQ e glossário.
Catálogos canônicos do NFS-e Inbound: eventos do webhook, códigos de evento (XSD vs CSV) e tabela de troubleshooting com HTTP codes, cStat SEFIN e deactivationReason.
Todos os campos do corpo (POST) de emissão de NFS-e, com tipo, obrigatoriedade e descrição.
Referência dos enums usados na API NFe/CTe Inbound: EnvironmentSEFAZ, OperationType, MetadataResourceType, EntityStatus.
Enumerações do domínio de recepção de NFS-e: tipo de documento, status, status de webhook, manifestação e notificações.
Sinais de problema na recepção de NF-e/CT-e e como diagnosticar: NSU travado, empresa desativada, webhooks não chegando, rate limit.
Diferença entre as versões v1 e v2 do payload de webhook de NFS-e e como cada empresa é versionada.
Catálogo dos eventos do webhook NFe/CTe Inbound (product_invoice_inbound, transportation_invoice_inbound), payload e contrato de validação HMAC-SHA1 (x-hub-signature).