Docs/NF-e
NF-e — Nota Fiscal Eletrônica (produtos)
Endpoints para emissão, consulta e cancelamento de NF-e de produtos.
Ver requisitos de autenticaçãoHeaders
X-Api-Key
stringobrigatórioChave de API da conta (id do usuário).
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
Parâmetros do body
nature
stringopcionalNatureza da operação.
cfop
stringopcionalCFOP padrão dos itens.
items
arrayobrigatórioItens da nota.
description
stringobrigatórioDescrição do produto.
ncm
stringopcionalNCM do produto.
cfop
stringopcionalCFOP do item (sobrescreve a raiz).
quantity
numberobrigatórioQuantidade.
unitValue
numberobrigatórioValor unitário em reais.
recipient
objectobrigatórioDados do destinatário.
taxId
stringobrigatórioCPF ou CNPJ do destinatário.
name
stringobrigatórioNome do destinatário.
E-mail do destinatário.
externalId
stringopcionalIdentificador externo para idempotência.
curl -X POST "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/nfe" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
-H "Idempotency-Key: pedido-100" \
-H "Content-Type: application/json" \
-d '{
"nature": "Venda de mercadoria",
"items": [
{
"description": "Notebook modelo XYZ",
"ncm": "84713012",
"cfop": "5102",
"quantity": 2,
"unitValue": 3500.00
}
],
"recipient": {
"taxId": "123.456.789-00",
"name": "João Silva",
"email": "[email protected]"
}
}'{
"ok": true,
"data": {
"id": "018f6e3b-0000-0000-0000-000000000000",
"status": "processing",
"type": "nfe",
"externalId": "pedido-100",
"amount": 7000.00,
"createdAt": "2026-07-06T10:28:00.000Z"
}
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}Headers
X-Api-Key
stringobrigatórioChave de API da conta (id do usuário).
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
Query params
status
stringopcionalFiltra por status (processing, authorized, rejected, canceled).
page
numberopcionalPágina atual. Padrão: 1.
pageSize
numberopcionalItens por página. Padrão: 20.
curl -X GET "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/nfe?status=authorized" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
{
"ok": true,
"data": [
{
"id": "018f6e3b-0000-0000-0000-000000000000",
"status": "authorized",
"type": "nfe",
"amount": 7000.00,
"createdAt": "2026-07-06T10:28:00.000Z"
}
],
"pageInfo": {
"page": 1,
"pageSize": 20,
"total": 1
}
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}Headers
X-Api-Key
stringobrigatórioChave de API da conta (id do usuário).
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
Parâmetros de rota
id
string (UUID)obrigatórioIdentificador único da NF-e.
curl -X GET "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/nfe/018f6e3b-0000-0000-0000-000000000000" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
{
"ok": true,
"data": {
"id": "018f6e3b-0000-0000-0000-000000000000",
"status": "processing",
"type": "nfe",
"externalId": "pedido-100",
"amount": 7000.00,
"createdAt": "2026-07-06T10:28:00.000Z"
}
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}Headers
X-Api-Key
stringobrigatórioChave de API da conta (id do usuário).
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
Parâmetros de rota
id
string (UUID)obrigatórioIdentificador único da NF-e.
curl -X DELETE "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/nfe/018f6e3b-0000-0000-0000-000000000000" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
{
"ok": true,
"data": {
"id": "018f6e3b-0000-0000-0000-000000000000",
"status": "canceled",
"type": "nfe"
}
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}Tabelas de referência NF-e
GET /v1/nfe/ncm?search=...— consulta de NCMGET /v1/nfe/cfop?search=...— consulta de CFOPGET /v1/nfe/cest?search=...— consulta de CEST