Autenticação (padrão)
Toda chamada autenticada envia X-Api-Key e X-Api-Secret. A empresa emissora vai no path (:companyId ULID).
Exemplo ilustrativo de headers: X-Api-Key: ek_xxx X-Api-Secret: es_xxx Idempotency-Key: ulid-ou-uuid-da-sua-operacao Content-Type: application/json
Emissão NFS-e (ilustrativo)
POST https://api.emitfy.com/v1/companies/{companyId}/nfse
O body inclui tomador, serviço e valores conforme o schema da documentação. Em erro de validação, a API retorna 422 com fields[] — mapeie para o formulário do seu sistema.
Para o JSON canônico e campos avançados, use https://docs.emitfy.com/reference/nfse ou o espelho .md / OpenAPI — esta página não duplica o contrato para não divergir.
Emissão NF-e (ilustrativo)
POST https://api.emitfy.com/v1/companies/{companyId}/nfe
Inclua itens com NCM/CFOP e destinatário. Consulte a referência NF-e para o payload atual.
Emissão CT-e (ilustrativo)
POST https://api.emitfy.com/v1/companies/{companyId}/cte
Use para transporte de cargas quando sua operação exige CT-e no mesmo stack da NFS-e/NF-e. Consulte a referência CT-e na documentação para o payload atual.
Recebimento de NF-e por API
Além de emitir, a API Emitfy permite receber e consultar NF-e de entrada — útil para ERPs que conciliam compras e estoque sem trocar de emissor.
Detalhes do contrato ficam na documentação de recebimento/NF-e inbound em api.emitfy.com.
Erros que você vai tratar
- 401/403 — key inválida ou company fora do escopo
- 422 — validação de campos fiscais
- 409/idempotência — replay da mesma operação
- 5xx — retry com backoff e mesma Idempotency-Key
Perguntas frequentes
Onde acho exemplos oficiais?
Documentação humana, botão “Copiar página” em Markdown, OpenAPI e llms-full.txt no host api.emitfy.com.
Posso usar no ChatGPT/Cursor?
Sim — comece por https://docs.emitfy.com/for-ai e https://api.emitfy.com/llms-full.txt.
Automatize a emissão fiscal com a Emitfy
Conecte sua plataforma ou use a API REST. 10 notas grátis, sem cartão. Garantia de 7 dias se o produto não atender às expectativas.
Começar grátis