Docs/NFS-e
NFS-e — Nota Fiscal de Serviços Eletrônica
Endpoints para emissão, consulta e cancelamento de notas fiscais de serviço.
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
serviceDescription
stringobrigatórioDescrição do serviço prestado.
serviceCode
stringopcionalCódigo do serviço municipal (ex.: 01.05).
amount
numberobrigatórioValor do serviço em reais.
issueDate
string (ISO 8601)opcionalData de competência. Padrão: data atual.
externalId
stringopcionalIdentificador externo para idempotência.
borrower
objectobrigatórioDados do tomador do serviço.
taxId
stringopcionalCPF ou CNPJ do tomador.
name
stringobrigatórioNome do tomador.
E-mail do tomador.
curl -X POST "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/nfse" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
-H "Idempotency-Key: pedido-001" \
-H "Content-Type: application/json" \
-d '{
"serviceDescription": "Desenvolvimento de software sob demanda",
"serviceCode": "01.05",
"amount": 2500.00,
"borrower": {
"taxId": "12.345.678/0001-90",
"name": "Empresa Cliente LTDA",
"email": "[email protected]"
}
}'{
"ok": true,
"data": {
"id": "018f6e3b-0000-0000-0000-000000000000",
"saleId": "018f6e3b-1111-1111-1111-111111111111",
"status": "processing",
"type": "nfse",
"externalId": "pedido-001",
"amount": 2500.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
page
numberopcionalPágina atual. Padrão: 1.
pageSize
numberopcionalItens por página. Padrão: 20.
status
stringopcionalFiltra por status (processing, authorized, rejected, canceled).
curl -X GET "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/nfse?page=1&pageSize=20" \
-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": "nfse",
"amount": 2500.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 NFS-e.
curl -X GET "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/nfse/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",
"saleId": "018f6e3b-1111-1111-1111-111111111111",
"status": "processing",
"type": "nfse",
"externalId": "pedido-001",
"amount": 2500.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 NFS-e.
curl -X DELETE "https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/nfse/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": "nfse"
}
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}