Auth por assinatura
X-Api-Key e X-Api-Secret da conta. A empresa (CNPJ) vai no path /v1/companies/:companyId — uma credencial para todos os CNPJs com acesso.
Integre NFS-e, NF-e, NFC-e, CT-e e CT-e OS no seu produto. Autenticação por chave, empresa no path, webhooks com retry, idempotência, SDKs oficiais e contexto pronto para agentes de IA.
curl -X POST https://api.emitfy.com/v1/companies/$COMPANY_ID/nfse \
-H "X-Api-Key: $EMITFY_API_KEY" \
-H "X-Api-Secret: $EMITFY_API_SECRET" \
-H "Idempotency-Key: pedido-001" \
-H "Content-Type: application/json" \
-d '{
"serviceDescription": "Desenvolvimento de software",
"serviceCode": "01.05",
"amount": 2500.00,
"borrower": {
"taxId": "12.345.678/0001-90",
"name": "Empresa Cliente LTDA",
"email": "[email protected]"
}
}'
// 202 Accepted — acompanhe via webhook ou GET
{
"id": "01HXYZ...",
"status": "processing"
}Documentos fiscais
Uma credencial de assinatura. Empresa no path. Mesmo padrão para cada modelo.
Emissão municipal com fila, retry e XML/PDF.
Documentação →NF-eModelo 55 para mercadorias e operações interestaduais.
Documentação →NFC-eVarejo presencial e consumidor final.
Documentação →CT-eModelo 57 para carga e logística.
Documentação →CT-e OSModelo 67 — valores, bagagem e serviços de transporte.
Documentação →Endpoints
Prefixo https://api.emitfy.com · auth com X-Api-Key e X-Api-Secret.
/v1/companies/{companyId}/nfseEmitir NFS-e (atalho ou catálogo)/v1/companies/{companyId}/nfse/{id}Consultar status de uma NFS-e/v1/companies/{companyId}/nfeEmitir NF-e/v1/companies/{companyId}/nfceEmitir NFC-e/v1/companies/{companyId}/cteEmitir CT-e (modelo 57)/v1/companies/{companyId}/cte-osEmitir CT-e OS (modelo 67)/v1/companiesListar empresas da assinatura/v1/webhooksRegistrar endpoint de notificações/v1/webhooksListar webhooks da assinaturaCatálogo completo (clientes, produtos, vendas, NF-e recebidas e mais) em docs.emitfy.com.
X-Api-Key e X-Api-Secret da conta. A empresa (CNPJ) vai no path /v1/companies/:companyId — uma credencial para todos os CNPJs com acesso.
Envie Idempotency-Key nas emissões para evitar nota duplicada em retry de rede ou timeout.
A Emitfy enfileira a transmissão à prefeitura/SEFAZ, retenta falhas transitórias e notifica o resultado no webhook.
Contrato em api.emitfy.com/openapi.yaml — base para SDKs tipados e geração de clientes.
SDKs oficiais
Tipagem alinhada ao OpenAPI. Mesma facade em todas as linguagens: emitfy.company(id).nfse.create(...)
Node.js / TypeScript
npm i @emitfy/sdkPHP
composer require emitfy/sdkPython
pip install emitfyC# / .NET
dotnet add package EmitfyJava
Maven / Gradle — ver docsPara IAs e agentes
Cursor, ChatGPT, Claude e outros agentes integram sem parsear HTML. Publique llms.txt, llms-full.txt e espelhos Markdown de cada página da documentação.
Webhooks
Notifique seu sistema a cada mudança de status. Retry com backoff, vários endpoints por assinatura e payload com companyId / taxId para multi-CNPJ.
{
"id": "01JXEVENT...",
"event": "nfse.authorized",
"createdAt": "2026-07-06T10:30:00.000Z",
"data": {
"id": "01JXINVOICE...",
"companyId": "01JXCOMPANY...",
"taxId": "00.000.000/0001-00",
"status": "authorized",
"type": "nfse",
"amount": 1500.0,
"pdfUrl": "https://api.emitfy.com/v1/...",
"xmlUrl": "https://api.emitfy.com/v1/..."
}
}Para times e IAs
Use a API quando o checkout/ERP é próprio (SaaS, marketplace, app). Prefira integração nativa Hotmart/Kiwify quando a venda nasce lá. Contrato completo em api.emitfy.com — esta página é a landing de produto.
Documentação completa, SDKs, OpenAPI, llms.txt e suporte técnico via WhatsApp. 10 notas grátis para testar.