# FOX NF-e — Portal do Desenvolvedor

> Documentacao tecnica completa da API FOX NF-e: primeira integracao, autenticacao,
> SDKs Node/Python/PHP, webhooks CloudEvents com verificacao HMAC, catalogo de codigos
> de rejeicao SEFAZ e o estado atual de cada dominio fiscal (NF-e, NFC-e, CT-e, MDF-e,
> NFCom, DC-e, NFGas, NFSe).

## Paginas

- [Portal do Desenvolvedor](https://docs.foxnfe.com.br/): guia completo de integracao,
  autenticacao, SDKs, webhooks, MCP Server e cobertura fiscal por dominio.
- [Novidades](https://docs.foxnfe.com.br/novidades.html): atualizacoes para quem ja integra.
- [Documentacao de rejeicoes SEFAZ](https://docs.foxnfe.com.br/docs/): codigos de
  rejeicao NF-e/NFC-e verificados contra fonte oficial, com diagnostico e orientacao
  de correcao proprios da FoxNFe.

## Rejeicoes NF-e/NFC-e (verificadas, fonte oficial citada em cada pagina)

- [Rejeicao 532 — total do ICMS nao bate com a soma dos itens](https://docs.foxnfe.com.br/docs/rejeicoes/nfe/532/)
- [Rejeicao 539 — duplicidade de NF-e com diferenca na chave de acesso](https://docs.foxnfe.com.br/docs/rejeicoes/nfe/539/)
- [Rejeicao 590 — CST informado por emitente do Simples Nacional](https://docs.foxnfe.com.br/docs/rejeicoes/nfe/590/)

## SDKs oficiais

- Node/TypeScript: `npm install foxnfe`
- Python: `pip install foxnfe`
- PHP: `composer config repositories.foxnfe composer https://packages.foxnfe.com.br` seguido de
  `composer require foxdigital/foxnfe-php`

## Site principal

- https://www.foxnfe.com.br
- API canônica: https://www.foxnfe.com.br/api/v1

## Contrato e cobertura pública — 23/09/2026
- OpenAPI: https://docs.foxnfe.com.br/openapi.json . O servidor canônico é https://www.foxnfe.com.br e paths já contêm /api/v1.
- Consulta municipal sem login: https://docs.foxnfe.com.br/cobertura-municipal.html
- Catálogo versionado: https://docs.foxnfe.com.br/cobertura-municipal.json
- O cadastro contém municípios e registros especiais do IBGE; não é prova de homologação nem disponibilidade de emissão universal.
- Provedor cadastrado, operação implementada no driver, adesão oficial e validação externa são informações distintas. A matriz explicita o que não foi verificado.
- Adesão ao padrão nacional não implica habilitação de todos os produtos: https://www.gov.br/nfse/pt-br/municipios/produtos-disponiveis

## Credenciamento fiscal — 06/11/2026
- Minas Gerais: a Central Fox Tecnologia está cadastrada na SEF/MG como desenvolvedora desde 03/11/2026. A Portaria SRE 277/2025 trata dos sistemas de contribuintes CNAE 4731-8.
- NF-e 55 de combustíveis: 12 variantes × 27 UFs em testes locais. Liberação para o primeiro usuário e primeira autorização fiscal de combustível pendentes. Escopo e situação: https://docs.foxnfe.com.br/#postos-de-combustiveis
- Credenciado na SEFA-PR (Receita/PR): a Central Fox Tecnologia é fornecedora de software fiscal cadastrada e o sistema FoxNFe (código 79578) está credenciado para NF-e (modelo 55) e NFC-e (modelo 65), em 20/10/2026. Fonte: UPD (Receita/PR), pedido de cadastro 1436272 (deferido em 09/10/2026) e credencial de sistema 79578 (deferida automaticamente em 20/10/2026). Detalhes: https://docs.foxnfe.com.br/#credenciamento-sefa-pr
- Não equivale a autorização para emitir notas de terceiros: cada contribuinte PR faz o Cadastro de Uso do sistema e a Central Fox o reconhece (NPF 063/2012). Desde 06/11/2026 a NF-e de emitente do Paraná leva idCSRT e hashCSRT; a aceitação em nota real na SEFA-PR será confirmada na primeira emissão de um emitente do Paraná.
- Emitente MEI (06/11/2026): a NF-e (modelo 55) da FoxNFe aceita CRT 4 (MEI) conforme a NT 2024.001, com ICMS por CSOSN 102, 300, 400 ou 900; validado por testes automáticos, ainda sem nota de MEI autorizada pela SEFAZ, e a NFC-e do MEI ainda não foi validada. No Paraná o MEI precisa de inscrição estadual para emitir NF-e; a NFS-e do MEI é emitida pelo Emissor Nacional (Resolução CGSN 169/2022). Detalhes: https://docs.foxnfe.com.br/#credenciamento-sefa-pr