Provedores de NF-e

O sistema abstrai a comunicação com provedores de NF-e através de uma interface comum.

Provedores Disponíveis

NFe.io (nfe_io)

Integração com a plataforma NFe.io para emissão de NFS-e.

• API: https://api.nfe.io
• Documentação: https://nfe.io/docs/desenvolvedores/rest-api/
• Suporte: NFS-e (serviços)

Mapeamento de Status:

Status NFe.io	Status interno
Created, WaitingCalculateTaxes, WaitingSend, WaitingReturn, WaitingDownload	processing
Issued	issued
Cancelled	canceled
Error	error

Kobana NF-e (kobana)

Integração com o serviço interno de NF-e da Kobana.

• API: https://nfe.kobana.com.br (configurável)
• Versão: /api/v1
• Suporte: Emissão e cancelamento

Mock (mock)

Provedor de desenvolvimento que simula emissões com dados fictícios.

• Sem chamadas externas
• Armazenamento em memória
• Gera chaves e códigos de verificação realistas

Interface Comum

Todos os provedores implementam:

Operação	Descrição
issue	Emitir uma NF-e
cancel	Cancelar uma NF-e emitida
query	Consultar status de uma NF-e
downloadXml	Baixar XML da nota
downloadPdf	Baixar PDF (DANFE)