1. Cobertura de documentos fiscais
Hoje você emite NF-e. E quando abrir um PDV (NFC-e)? Prestar serviço (NFS-e)? Contratar frete próprio (CT-e e MDF-e)? Cada documento que a API não cobre é uma segunda integração, um segundo contrato e um segundo ponto de falha. Fornecedores que cobrem só um ou dois modelos empurram o problema para o futuro.
O que perguntar ao fornecedor
Quais modelos de documento a API cobre hoje: NF-e (55), NFC-e (65), NFS-e (padrão nacional e prefeituras), CT-e (57), MDF-e (58), DC-e? Todos no mesmo contrato e com o mesmo padrão de payload? Quantos municípios de NFS-e são suportados?
2. Modelo de preço: por nota emitida ou emissão ilimitada
Preço por nota parece barato no começo e vira imprevisível quando a operação cresce: Black Friday, sazonalidade e picos de venda inflam a fatura exatamente quando você mais fatura. Assinatura fixa com emissão ilimitada transforma o custo fiscal em linha previsível de orçamento. Faça a conta com o seu volume real, incluindo os meses de pico, não a média.
O que perguntar ao fornecedor
O preço é por nota, por faixa de volume ou fixo? O que acontece com a fatura no mês de pico? Notas rejeitadas, canceladas ou consultas também contam no volume cobrado? Há taxa de setup, fidelidade ou reajuste automático por volume?
Como a Brasil NFe atende
Assinatura mensal fixa por CNPJ com emissão ilimitada. O plano de NF-e/NFC-e custa R$ 49,90/mês cobrindo os dois modelos, sem cobrança por documento, sem taxa por rejeição e sem surpresa em mês de pico. Veja os planos em
preços.
3. Tempo de autorização na SEFAZ
No e-commerce e no PDV, o cliente espera a nota na tela. Uma API que leva 30 segundos para autorizar trava o checkout e a fila do caixa. O tempo total é a soma do processamento interno do fornecedor com o tempo da SEFAZ; fornecedores com filas internas longas ou processamento assíncrono obrigatório adicionam latência que a SEFAZ não exige.
O que perguntar ao fornecedor
Qual o tempo médio de autorização de ponta a ponta? A emissão é síncrona (resposta na mesma requisição) ou obriga polling? O XML assinado e o DANFE voltam na própria resposta ou exigem chamadas adicionais?
Como a Brasil NFe atende
Emissão síncrona com autorização típica de 1 a 3 segundos. A resposta da API já traz chave de acesso, protocolo, XML assinado (Base64Xml) e DANFE em PDF (Base64File), sem chamadas extras. Detalhes na
documentação.
4. SDKs oficiais e qualidade da documentação
Documentação vaga e ausência de SDK significam dias montando payloads por tentativa e erro. SDKs oficiais tipados reduzem erro de integração, e uma referência OpenAPI completa permite gerar clientes e validar contratos automaticamente. Verifique também se a documentação explica os conceitos fiscais (CFOP, CST, NCM) ou se assume que o desenvolvedor é contador.
O que perguntar ao fornecedor
Existem SDKs oficiais para as linguagens do meu stack? São mantidos pelo próprio fornecedor e publicados nos gerenciadores de pacote? A documentação tem spec OpenAPI pública, exemplos de requisição completos e explicação dos campos fiscais?
Como a Brasil NFe atende
SDKs oficiais para .NET (NuGet), PHP (Packagist), Node.js (npm) e Python (PyPI), mantidos em paridade com a API. A
documentação inclui referência OpenAPI completa, guias de conceitos fiscais e catálogo de rejeições SEFAZ com solução para cada código.
5. Webhooks e notificações de eventos
Nem tudo no ciclo fiscal é síncrono: cancelamentos, eventos de manifestação e processamentos em lote acontecem depois da requisição inicial. Sem webhooks, seu sistema precisa fazer polling, o que gasta rate limit e atrasa a reação a eventos. Uma API madura notifica seu endpoint quando o estado do documento muda.
O que perguntar ao fornecedor
Há webhooks para mudança de status de documentos? Quais eventos são cobertos? Existe retentativa automática com backoff quando meu endpoint está fora? Como valido a autenticidade da notificação?
Como a Brasil NFe atende
Webhooks configuráveis pelo painel notificam seu sistema sobre eventos dos documentos fiscais, com retentativas automáticas. O guia completo de configuração e payloads está na
documentação, na seção de webhooks.
6. Reforma Tributária: IBS/CBS já na emissão
Este é o critério mais 2026 da lista. Com o início da transição da Reforma Tributária, os documentos fiscais eletrônicos passam a carregar os grupos de IBS, CBS e Imposto Seletivo no XML. Uma API que ainda não aceita esses campos vai forçar você a esperar o fornecedor correr atrás, ou a migrar no pior momento possível. Escolher em 2026 uma API sem suporte a IBS/CBS é comprar dívida técnica de véspera.
O que perguntar ao fornecedor
A API já aceita o grupo IBSCBS na emissão de NF-e, NFC-e, NFS-e e CT-e? Os campos estão documentados na spec OpenAPI e nos SDKs? Qual o plano do fornecedor para acompanhar as notas técnicas do cronograma de transição até 2033?
Como a Brasil NFe atende
O grupo IBS/CBS já é aceito na emissão de NF-e, NFC-e, NFS-e e CT-e, documentado na referência da API e refletido nos SDKs oficiais. Acompanhe o cronograma e os detalhes no nosso guia da
Reforma Tributária.
7. MCP e integração com IA
Agentes de IA já emitem nota, consultam status e geram relatórios fiscais em linguagem natural. O MCP (Model Context Protocol) é o padrão aberto que conecta assistentes como Claude e outros LLMs a APIs. Um fornecedor com servidor MCP permite que seu ERP com copiloto, ou seu próprio agente interno, opere a emissão fiscal sem código de integração adicional. Não é obrigatório hoje, mas indica para onde o fornecedor está olhando.
O que perguntar ao fornecedor
Existe servidor MCP oficial? Quais operações fiscais ele expõe (emissão, consulta, cancelamento, relatórios)? A documentação é legível por LLMs (llms.txt, OpenAPI pública)?
Como a Brasil NFe atende
Servidor
MCP oficial (beta) com ferramentas de emissão e consulta para NF-e, NFC-e, NFS-e, CT-e, MDF-e e DC-e, além de cadastros e relatórios. A documentação publica llms.txt e a spec OpenAPI completa para consumo por agentes.
8. Contingência automática
A SEFAZ cai. Não é hipótese, é rotina: janelas de manutenção, instabilidade regional e lentidão em horário de pico. A legislação prevê modos de contingência justamente para isso. A diferença entre uma API madura e uma frágil é quem gerencia essa troca: se for você, prepare-se para escrever lógica de fallback fiscal; se for o fornecedor, sua emissão continua sem código extra.
O que perguntar ao fornecedor
A contingência (SVC-AN/SVC-RS para NF-e, offline para NFC-e) é acionada automaticamente ou preciso detectar a queda e mudar o payload? Como funciona a retransmissão quando a SEFAZ volta? Existe endpoint para consultar o status das SEFAZ?
Como a Brasil NFe atende
A API gerencia retentativas e contingência automaticamente quando a SEFAZ autorizadora está instável, sem mudança no seu payload. Há endpoint de consulta de status das SEFAZ para monitoramento, documentado na
documentação.
9. Segurança do certificado digital
O certificado A1 assina documentos em nome do seu CNPJ: quem o possui pode emitir nota pela sua empresa. Ele vai ficar armazenado na infraestrutura do fornecedor, então a pergunta certa não é "se" ele fica na nuvem, e sim como é protegido: criptografia em repouso, isolamento por cliente, controle de acesso e política clara de exclusão ao encerrar o contrato.
O que perguntar ao fornecedor
Como o certificado A1 é armazenado (criptografia, isolamento por tenant)? Quem da equipe do fornecedor tem acesso? O que acontece com o certificado e a senha quando encerro o contrato? Há aviso de expiração do certificado?
Como a Brasil NFe atende
O certificado A1 é armazenado criptografado, com acesso isolado por empresa e uso restrito à assinatura dos documentos do próprio CNPJ. Cada CNPJ tem token de API próprio, e as práticas de segurança estão descritas na
documentação e nas páginas
de privacidade.
10. LGPD e tratamento de dados
Documento fiscal carrega dado pessoal: CPF, nome, endereço do destinatário. Ao usar uma API fiscal, o fornecedor vira operador dos dados dos seus clientes, e a responsabilidade de escolher um operador adequado é sua, como controlador. Fornecedor sem política de privacidade clara, sem DPO nomeado e sem lista de subprocessadores é risco jurídico herdado.
O que perguntar ao fornecedor
Existe política de privacidade específica e DPO nomeado com canal de contato? A lista de subprocessadores (clouds, ferramentas) é pública? Como são tratados os pedidos de titulares e os incidentes de segurança? Onde os dados são armazenados?
11. Suporte que entende de fiscal
Quando a SEFAZ devolve "Rejeição 539: duplicidade de NF-e com diferença na chave de acesso", você precisa de alguém que saiba o que isso significa e como resolver, não de um chatbot genérico abrindo ticket. Suporte de API fiscal exige gente que entende de tributação e de código ao mesmo tempo. Teste o suporte antes de contratar: mande uma pergunta técnica real e cronometre a resposta.
O que perguntar ao fornecedor
Quais os canais e horários de suporte? Quem responde entende de rejeições SEFAZ e de tributação, ou só repassa para outro time? Há material público de troubleshooting (catálogo de rejeições, status page)?
Como a Brasil NFe atende
Suporte por WhatsApp e painel com equipe que une experiência contábil e de desenvolvimento. A
documentação mantém um catálogo público com centenas de rejeições SEFAZ explicadas com causa e solução, e há status page pública dos serviços.