Documentação da API
Integre o Emissor de Nota Fiscal em seus sistemas com nossa API RESTful. Documentação técnica completa com exemplos de código.
Introdução
A API RESTful do Emissor de Nota Fiscal permite que você integre a emissão de notas fiscais diretamente em seus sistemas, aplicações web ou mobiles.
Com nossa API você pode:
- Emitir NF-e, NFS-e, NFC-e, CT-e e MDF-e programaticamente
- Consultar o status de notas fiscais
- Cancelar notas quando necessário
- Integrar com ERPs, e-commerces e sistemas de gestão
- Automatizar fluxos de faturamento
A API está disponível apenas nos planos **Profissional** e **Enterprise**. Entre em contato para solicitar credenciais de acesso.
Autenticação
Toda requisição à API deve incluir o token de autenticação no header `Authorization`.
Formato:
Authorization: Bearer YOUR_API_TOKEN
Como obter seu token:
1. Acesse as configurações da sua conta
2. Vá para "Integrações" → "API"
3. Clique em "Gerar Token"
4. Copie o token e guarde com segurança
Importante: Nunca compartilhe seu token com terceiros. Se suspeitar de vazamento, regenere um novo token imediatamente.
Authorization: Bearer YOUR_API_TOKEN
Endpoints Principais
Base URL:
https://api.emitirnotafiscaleletronica.com.br/v1
1. Emitir NF-e
- **Método:** POST
- **Rota:** `/notas-fiscais/nfe`
- **Descrição:** Cria e emite uma nova NF-e na SEFAZ
2. Consultar Nota Fiscal
- **Método:** GET
- **Rota:** `/notas-fiscais/:id`
- **Descrição:** Retorna informações de uma nota fiscal emitida
3. Cancelar Nota Fiscal
- **Método:** POST
- **Rota:** `/notas-fiscais/:id/cancelar`
- **Descrição:** Cancela uma NF-e junto à SEFAZ
4. Listar Notas Fiscais
- **Método:** GET
- **Rota:** `/notas-fiscais?limit=10&offset=0`
- **Descrição:** Lista todas as notas fiscais com paginação
Códigos de Resposta:
- `200`: Sucesso
- `400`: Erro de validação
- `401`: Não autorizado (token inválido)
- `404`: Recurso não encontrado
- `500`: Erro interno do servidor
https://api.emitirnotafiscaleletronica.com.br/v1
Exemplo de Requisição
JavaScript/Node.js:
const axios = require('axios');
const API_URL = 'https://api.emitirnotafiscaleletronica.com.br/v1';
const API_TOKEN = 'seu_token_aqui';
async function emitirNotaFiscal() {
try {
const response = await axios.post(
`${API_URL}/notas-fiscais/nfe`,
{
cliente: {
cnpj: '12345678000190',
razaoSocial: 'Cliente LTDA',
},
itens: [
{
descricao: 'Produto A',
quantidade: 1,
valorUnitario: 100.00,
ncm: '1234567890',
},
],
naturezaOperacao: 'VENDA',
totalizadores: {
baseCalculo: 100.00,
valorIcms: 18.00,
valorTotal: 118.00,
},
},
{
headers: {
'Authorization': `Bearer ${API_TOKEN}`,
'Content-Type': 'application/json',
},
}
);
console.log('NF-e emitida:', response.data);
} catch (error) {
console.error('Erro:', error.response.data);
}
}
emitirNotaFiscal();
const API_TOKEN = 'seu_token_aqui';
const response = await axios.post(
'https://api.emitirnotafiscaleletronica.com.br/v1/notas-fiscais/nfe',
{...}
);Pronto para integrar?
A API completa está disponível nos planos Profissional e Enterprise. Entre em contato para solicitar acesso e documentação detalhada.