Treeunfe API B2C home pagelight logo
  1. NFS-e
  2. Emitir NFS-e
POST
/nfse
curl --request POST \
     --url https://api.treeunfe.com.br/api/v1/nfse \
     --header 'x-api-key: <api-key>' \
     --header 'x-api-key: <x_api_key>' \
     --header 'Content-Type: application/json' \
     --data '{
  "cTribNac": "<string>",
  "vServ": 123.45,
  "cNbs": "<string>",
  "tomadorCnpj": "<string>",
  "cTribMun": "<string>",
  "descricao": "<string>"
}'

Emite uma NFS-e de forma síncrona para a empresa dona da API Key. Envie o código do serviço e o valor; os dados do prestador e a tributação vêm do cadastro e das regras de tributação da empresa.

Veja o guia Emissão de NFS-e.

​
Autenticação

x-api-key
required
string

API Key da empresa.

​
Body

application/json

cTribNac
required
string

Código nacional do serviço (6 dígitos). Veja Códigos de serviço.

vServ
required
number

Valor do serviço.

cNbs
string

Código NBS (9 dígitos). Obrigatório quando o CRT da empresa é NORMAL.

tomadorCnpj
string

CNPJ ou CPF do tomador, só com números.

cTribMun
string

Código de tributação municipal.

descricao
string

Descrição do serviço.

​
Respostas

StatusDescrição
200NFS-e processada. Confira outcome; em sucesso, retorna nfseId e status.
400Payload inválido ou erro na emissão. Veja a lista errors.
401x-api-key ausente ou inválida.
429Limite de requisições excedido.
curl -X POST "https://api.treeunfe.com.br/api/v1/nfse" \
  -H "x-api-key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tomadorCnpj": "12345678000195",
    "cTribNac": "010501",
    "cNbs": "115011000",
    "cTribMun": "001",
    "descricao": "Licenciamento de software - mensalidade",
    "vServ": 230
  }'

{
  "success": true,
  "nfseId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "AUTHORIZED"
}