Treeunfe API NF-e B2C home pagelight logo
  1. NF-e
  2. Emitir NF-e
POST
/nfe
curl --request POST \
     --url https://api.treeunfe.com.br/api/v1/nfe \
     --header 'x-api-key: <api-key>' \
     --header 'x-api-key: <x_api_key>' \
     --header 'Content-Type: application/json' \
     --data '{
  "calculateTaxes": true,
  "externalId": "<string>",
  "NFe": "<value>"
}'

Emite uma NF-e modelo 55 para a empresa dona da API Key.

  • Com cálculo de tributos (calculateTaxes omitido ou true, o padrão): a Treeunfe calcula os tributos dos itens e os totalizadores pelas regras de emissão configuradas no emissor.
  • Sem cálculo (calculateTaxes: false): a nota é transmitida com os valores exatamente como enviados.

O ambiente da nota (homologação ou produção) vem da API Key. Não informe o ambiente no payload.

Com cálculo, cada item leva só prod, sem imposto. ide.serie e ide.nNF são opcionais: sem eles, vale a numeração das configurações de NF-e do emissor. Veja o guia de emissão.

​
Autenticação

Envie o header x-api-key.

x-api-key
string

API Key da empresa.

​
Body

application/json

calculateTaxes
boolean

true faz a Treeunfe calcular os tributos dos itens e os totalizadores (ICMS, ST, DIFAL, FCP, IPI, PIS, COFINS, IBS e CBS) pelas regras de emissão configuradas no emissor. false usa exatamente os valores enviados. Padrão: true.

externalId
string

Identificador da nota no seu sistema.

NFe
required
object
  • infNFe (object) (obrigatório): Grupos da NF-e, com as mesmas tags do leiaute oficial (MOC).

​
Respostas

StatusDescrição
200Processada pela SEFAZ. Confira outcome.
400Body inválido (campo obrigatório ausente, formato incorreto ou campo não permitido).
401Credencial ausente, inválida ou expirada.
402Emissão bloqueada por plano ou saldo da conta.
403Credencial sem permissão para o recurso, ou empresa inativa (Organization is inactive).
422Nota rejeitada (validação ou rejeição da SEFAZ).
503SEFAZ indisponível. Tente de novo mais tarde.
curl -X POST "https://api.treeunfe.com.br/api/v1/nfe" \
  -H "x-api-key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "calculateTaxes": true,
    "externalId": "pedido-1234",
    "NFe": {
      "infNFe": {
        "ide": {
          "cUF": 41,
          "natOp": "Venda",
          "dhEmi": "2026-11-10T10:00:00-03:00",
          "dhSaiEnt": "2026-11-10T10:00:00-03:00",
          "tpNF": 1,
          "idDest": 2,
          "cMunFG": 4115200,
          "tpImp": 1,
          "tpEmis": 1,
          "finNFe": 1,
          "indFinal": 0,
          "indPres": 1,
          "indIntermed": 0
        },
        "emit": {
          "CNPJCPF": "12345678000195",
          "xNome": "EMPRESA EXEMPLO LTDA",
          "xFant": "EMPRESA EXEMPLO",
          "enderEmit": {
            "xLgr": "Avenida Exemplo",
            "nro": "5145",
            "xBairro": "Zona 07",
            "cMun": 4115200,
            "xMun": "MARINGA",
            "UF": "PR",
            "CEP": "87020035",
            "cPais": 1058,
            "xPais": "Brasil",
            "fone": "44999990000"
          },
          "IE": "9071311225",
          "CRT": 3
        },
        "dest": {
          "CNPJCPF": "11222333000181",
          "xNome": "CLIENTE EXEMPLO LTDA",
          "enderDest": {
            "xLgr": "Rua 115",
            "nro": "942",
            "xBairro": "Setor Sul",
            "cMun": 5208707,
            "xMun": "Goiania",
            "UF": "GO",
            "CEP": "74085325",
            "cPais": 1058,
            "xPais": "BRASIL"
          },
          "indIEDest": 1,
          "IE": "107753936"
        },
        "det": [
          {
            "prod": {
              "cProd": "PROD-001",
              "cEAN": "SEM GTIN",
              "xProd": "PRODUTO EXEMPLO",
              "NCM": "85176241",
              "CFOP": 6102,
              "uCom": "UNID",
              "qCom": 1,
              "vUnCom": "1000.00",
              "vProd": "1000.00",
              "cEANTrib": "SEM GTIN",
              "uTrib": "UNID",
              "qTrib": 1,
              "vUnTrib": "1000.00",
              "indTot": 1
            }
          }
        ],
        "total": {
          "ICMSTot": {
            "vBC": "0.00",
            "vICMS": "0.00",
            "vICMSDeson": "0.00",
            "vFCP": "0.00",
            "vBCST": "0.00",
            "vST": "0.00",
            "vFCPST": "0.00",
            "vFCPSTRet": "0.00",
            "vProd": "1000.00",
            "vFrete": "0.00",
            "vSeg": "0.00",
            "vDesc": "0.00",
            "vII": "0.00",
            "vIPI": "0.00",
            "vIPIDevol": "0.00",
            "vPIS": "0.00",
            "vCOFINS": "0.00",
            "vOutro": "0.00",
            "vNF": "1000.00"
          }
        },
        "transp": {
          "modFrete": 9
        },
        "pag": {
          "detPag": {
            "indPag": "0",
            "tPag": "90",
            "vPag": "0.00"
          }
        }
      }
    }
  }'