ERP próprio
A empresa tem o sistema interno e quer que o faturamento emita a nota sem ninguém abrir portal.
- Uma chamada por pedido
- Status de volta no pedido
- PDF e XML para o cliente
Para ERP
Seu ERP fatura. A Emitfy emite.
O pedido nasce no seu ERP e uma chamada à API vira NF-e, NFC-e ou NFS-e. A Emitfy fala com a SEFAZ e com a prefeitura, refaz o que falhar e devolve o resultado por webhook, com PDF e XML.
- Seu ERPPedido 8812 faturado · R$ 935,00
2 itens · frete por conta do emitente
- API EmitfyNa filaPOST /v1/companies/{id}/nfe
Idempotency-Key = id do pedido
- WebhookEntreguenfe.authorized
Chave de acesso, PDF e XML no payload
Ilustração do fluxo na Emitfy. Nomes e valores de exemplo.
Para quem é
O ERP é seu. O fiscal fica com a gente.
A Emitfy não é um ERP: não tem estoque, financeiro nem PDV. Ela é a camada de emissão que o seu sistema chama.
Software house de ERP
Você oferece emissão aos seus clientes sem manter integração com cada SEFAZ e cada prefeitura.
- Empresas criadas pela API
- Certificado A1 enviado pela API
- Status fiscal por empresa
Grupo com vários CNPJs
Matriz, filiais e empresas do grupo emitindo do mesmo ERP, cada uma com a própria configuração fiscal.
- De 3 a 50 CNPJs por assinatura
- Uma credencial de API para todas
- Notas separadas por empresa
O que a API cobre
Do pedido à entrada de mercadoria.
Documentos
NF-e e NFS-e, além de NFC-e, CT-e, CT-e OS e MDF-e conforme a habilitação da empresa.
Ciclo completo da NF-e
Cancelamento, carta de correção (CC-e), inutilização de faixa e XML da rejeição para depurar.
Empresas e certificado
Crie e atualize empresas, envie o certificado A1 e consulte o status fiscal de cada uma.
Produtos e clientes
Cadastre o produto com NCM, CFOP e tributos uma vez e emita pelo sku. Clientes ficam salvos para a próxima nota.
Notas recebidas
Sincronize as NF-e emitidas contra o CNPJ, baixe o XML e registre a manifestação do destinatário.
Consultas fiscais
Busca de NCM, NBS, CFOP, CNAE, CEST e códigos de serviço para montar o cadastro sem planilha.
Na prática
Um pedido, uma chamada.
- Use o ID do pedido como Idempotency-Key: se o job de faturamento rodar duas vezes, a nota não duplica (a chave é única por empresa).
- O POST só enfileira. A autorização chega pelo webhook nfe.authorized, ou nfe.rejected com o motivo para corrigir e reprocessar.
- Com o produto cadastrado em /products, o item vai só com sku, quantidade e valor. Também dá para mandar NCM, CFOP e CST no próprio item.
- SDKs oficiais em Node.js/TypeScript, PHP, Python, .NET e Java.
const response = await fetch(
'https://api.emitfy.com/v1/companies/' + companyId + '/nfe',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Api-Key': process.env.EMITFY_API_KEY,
'X-Api-Secret': process.env.EMITFY_API_SECRET,
// id do pedido no ERP: refaturar não duplica a nota
'Idempotency-Key': pedido.id,
},
body: JSON.stringify({
externalId: pedido.id,
operationNature: 'Venda de mercadoria',
recipient: {
taxId: '12345678000190',
name: 'Cliente Ltda',
email: '[email protected]',
address: {
street: 'Rua das Flores', number: '100', district: 'Centro',
city: 'Campinas', state: 'SP', zipcode: '13010000',
},
},
// sku do catálogo: NCM, CFOP e tributos vêm do produto
items: [
{
sku: 'CAD-001',
description: 'Cadeira de escritório',
quantity: 2,
unitValue: 450,
},
],
transport: { freightModality: 'bySender', value: 35 },
}),
},
);
// NF-e na fila. O resultado chega no webhook
// nfe.authorized (ou nfe.rejected, com o motivo).Mapa da integração
Cada tela do ERP tem a sua rota.
As rotas ficam sob /v1/companies/{id}. A referência completa está na documentação.
| No ERP | Na API | O que volta |
|---|---|---|
| Cadastro do cliente-emitente | POST /companies · POST …/certificate | Empresa pronta para emitir |
| Faturar o pedido | POST …/nfe (ou …/nfce, …/nfse) | Nota na fila e webhook de status |
| Corrigir dado sem cancelar | POST …/nfe/{id}/correction | CC-e protocolada |
| Cancelar a venda | DELETE …/nfe/{id} | Webhook nfe.cancelled |
| Pular numeração | POST …/nfe/inutilizations | Faixa inutilizada |
| Entrada de mercadoria | POST …/received-nfes/sync · …/manifest | NF-e destinadas ao CNPJ, com XML |
Como integrar
Da primeira chamada à primeira nota.
Gere as credenciais
Crie a conta e gere a chave e o segredo da API no painel. As 10 notas grátis já vêm com a API liberada.
Cadastre as empresas
Pela API ou pelo painel: CNPJ, regime, endereço e o certificado A1 de cada emitente.
Ligue o faturamento
No evento de faturar, o ERP chama a rota do documento com o id do pedido como Idempotency-Key.
Assine os webhooks
Cadastre a URL que recebe autorização, rejeição e cancelamento, e atualize o pedido no ERP.
Planos com API
Escolha pelo volume e pelos CNPJs.
Todos com API REST, webhooks e MCP. Sem taxa de adesão.
| Plano | Mensal | Notas por mês | CNPJs |
|---|---|---|---|
| Emerald | R$ 187 | 800 | 3 |
| Amethyst | R$ 247 | 2.000 | 5 |
| Diamond | R$ 397 | 5.000 | 15 |
| Sapphire | R$ 697 | 10.000 | 50 |
Perguntas frequentes
Dúvidas de quem integra ERP.
A Emitfy é um ERP?
Não. A Emitfy é a camada de emissão: recebe o pedido pela API, emite a nota e devolve o resultado. Estoque, financeiro e PDV continuam no seu ERP.
Quais documentos o ERP consegue emitir?
NF-e e NFS-e, e também NFC-e, CT-e, CT-e OS e MDF-e conforme a habilitação de cada empresa. Todos pela mesma API, com rotas por documento.
Consigo cadastrar os meus clientes (emitentes) pela API?
Sim. Dá para criar e atualizar empresas, enviar o certificado A1 e consultar o status fiscal de cada uma pela API. O número de CNPJs depende do plano: de 3 no Emerald a 50 no Sapphire.
Como evito nota duplicada se o faturamento rodar duas vezes?
Envie o cabeçalho Idempotency-Key com o id do pedido. A chave é única por empresa: uma segunda chamada com a mesma chave não cria outra nota.
Tem ambiente de homologação?
Não há sandbox público: a API emite sempre em produção. A conta nova tem 10 notas grátis com a API liberada para validar a integração.
O ERP recebe as NF-e de fornecedores?
Sim. A rota de notas recebidas sincroniza as NF-e emitidas contra o CNPJ, entrega o XML e registra a manifestação do destinatário (confirmação, desconhecimento ou operação não realizada).
API Emitfy
Pedido faturado, nota emitida.
Crie a conta sem cartão, gere as credenciais e emita as 10 notas grátis direto do seu ERP.
