Treeunfe API 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,
  "NFe": "<value>"
}'

Emite uma NF-e modelo 55 para a organization 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 da organization.
  • Sem cálculo (calculateTaxes: false): a nota é transmitida com os valores exatamente como enviados.

O ambiente da nota vem da API Key: uma chave de HOMOLOGACAO emite em homologação e uma de PRODUCAO, em produção. Não informe o ambiente no payload.

​
Autenticação

Envie o header x-api-key.

x-api-key
string

API Key da organization (rawKey).

​
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 da organization. false usa exatamente os valores enviados. Padrão: true.

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 organization 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: RAW_KEY_DA_ORGANIZATION" \
  -H "Content-Type: application/json" \
  -d '{
    "calculateTaxes": true,
    "NFe": {
      "infNFe": {
        "ide": {
          "cUF": 41,
          "natOp": "Venda",
          "serie": "1",
          "nNF": 10,
          "dhEmi": "2026-10-20T15:24:48-03:00",
          "dhSaiEnt": "2026-10-20T15:24:48-03:00",
          "tpNF": 1,
          "idDest": 1,
          "cMunFG": 4115200,
          "tpImp": 1,
          "tpEmis": 1,
          "finNFe": 1,
          "indFinal": 1,
          "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": "12345678909",
          "xNome": "Consumidor Exemplo",
          "enderDest": {
            "xLgr": "Rua das Flores",
            "nro": "652",
            "xBairro": "Centro",
            "cMun": 4115200,
            "xMun": "MARINGA",
            "UF": "PR",
            "CEP": "87025500",
            "cPais": 1058,
            "xPais": "BRASIL",
            "fone": "44999991111"
          },
          "indIEDest": 9,
          "email": "consumidor@exemplo.com.br"
        },
        "det": [
          {
            "prod": {
              "cProd": "30880297",
              "cEAN": "SEM GTIN",
              "xProd": "BARRA CHATA AC 2 X 1/4 A-36",
              "NCM": "72149100",
              "CFOP": 5102,
              "uCom": "M",
              "qCom": 1,
              "vUnCom": "16.3100000000",
              "vProd": "16.31",
              "cEANTrib": "SEM GTIN",
              "uTrib": "M",
              "qTrib": 1,
              "vUnTrib": "16.3100000000",
              "indTot": 1
            },
            "imposto": {
              "vTotTrib": "3.23",
              "ICMS": {
                "ICMS00": {
                  "orig": 5,
                  "CST": "00",
                  "modBC": 0,
                  "vBC": "16.31",
                  "pICMS": "19.00",
                  "vICMS": "3.10",
                  "pFCP": "2.00",
                  "vFCP": "0.33"
                }
              },
              "IPI": {
                "cEnq": "999",
                "IPINT": {
                  "CST": "53"
                }
              },
              "PIS": {
                "PISNT": {
                  "CST": "07"
                }
              },
              "COFINS": {
                "COFINSNT": {
                  "CST": "07"
                }
              },
              "IBSCBS": {
                "CST": "000",
                "cClassTrib": "000001",
                "gIBSCBS": {
                  "vBC": "13.21",
                  "gIBSUF": {
                    "pIBSUF": "0.10",
                    "vIBSUF": "0.01"
                  },
                  "gIBSMun": {
                    "pIBSMun": "0.00",
                    "vIBSMun": "0.00"
                  },
                  "vIBS": "0.01",
                  "gCBS": {
                    "pCBS": "0.90",
                    "vCBS": "0.12"
                  }
                }
              }
            }
          }
        ],
        "total": {
          "ICMSTot": {
            "vBC": "16.31",
            "vICMS": "3.10",
            "vICMSDeson": "0.00",
            "vFCP": "0.33",
            "vBCST": "0.00",
            "vST": "0.00",
            "vFCPST": "0.00",
            "vFCPSTRet": "0.00",
            "vProd": "16.31",
            "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": "16.31",
            "vTotTrib": "3.23"
          },
          "IBSCBSTot": {
            "vBCIBSCBS": "13.21",
            "gIBS": {
              "gIBSUF": {
                "vDif": "0.00",
                "vDevTrib": "0.00",
                "vIBSUF": "0.01"
              },
              "gIBSMun": {
                "vDif": "0.00",
                "vDevTrib": "0.00",
                "vIBSMun": "0.00"
              },
              "vIBS": "0.01",
              "vCredPres": "0.00",
              "vCredPresCondSus": "0.00"
            },
            "gCBS": {
              "vDif": "0.00",
              "vDevTrib": "0.00",
              "vCBS": "0.12",
              "vCredPres": "0.00",
              "vCredPresCondSus": "0.00"
            }
          }
        },
        "transp": {
          "modFrete": 9
        },
        "pag": {
          "detPag": {
            "indPag": "0",
            "tPag": "90",
            "vPag": "0.00"
          }
        },
        "infRespTec": {
          "CNPJ": "12345678000195",
          "xContato": "Responsavel Tecnico",
          "email": "suporte@sua-software-house.com.br",
          "fone": "4430000000"
        }
      }
    }
  }'

{
  "outcome": "SUCCESS",
  "chaveAcesso": "string",
  "protocolo": "string"
}