Issuing NF-e - Treeunfe API

POST /nfe issues an NF-e model 55 for the organization that owns the x-api-key.

With or without tax calculation

With calculation (default)
Without calculation (calculateTaxes: false)

Treeunfe calculates the taxes for each item and the totals (ICMS, ST, DIFAL, FCP, IPI, PIS, COFINS, IBS, and CBS) using the organization’s issuing rules.

Use this when your system doesn’t have its own tax engine.

Body structure

{
  "calculateTaxes": true,
  "NFe": {
    "infNFe": {
      "ide": { },
      "emit": { },
      "dest": { },
      "autXML": [ ],
      "det": [ ],
      "total": { },
      "transp": { },
      "pag": { },
      "infRespTec": { }
    }
  }
}

Field	Description
`calculateTaxes`	`true` (default) to have Treeunfe calculate the taxes; `false` to send the taxes already calculated.
`NFe.infNFe`	The invoice groups, with the same tags as the official NF-e layout (MOC).

Tag names follow the SEFAZ layout. The only difference is CNPJCPF: send either the CNPJ or the CPF in this one field, digits only.

Main groups

Group	Contents
`ide`	Identification: state, series, number, dates, operation type, purpose.
`emit`	Issuer: CNPJ, legal name, address (`enderEmit`), state registration (IE), and `CRT`.
`dest`	Recipient: CNPJ/CPF, name, address (`enderDest`), `indIEDest`, email.
`autXML`	CNPJs/CPFs authorized to download the XML.
`det`	Items: `prod` (product) and `imposto` (taxes).
`total`	Totals: `ICMSTot` and `IBSCBSTot`.
`transp`	Shipping. `modFrete: 9` = no freight.
`pag`	Payment (`detPag`).
`infRespTec`	Technical contact responsible for the system.

The invoice’s environment comes from the API Key: a HOMOLOGACAO key issues in the sandbox and a PRODUCAO key in production. Do not send the environment in the payload.

Tax regime

The example below uses the normal regime (emit.CRT: 3, ICMS CST 00). For Simples Nacional, use emit.CRT: 1 and the ICMSSN groups with CSOSN (for example, ICMSSN102).

Full example

{
  "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"
      },
      "autXML": [{ "CNPJ": "12345678000195" }],
      "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"
      }
    }
  }
}

Response

When SEFAZ authorizes the invoice:

{
  "outcome": "SUCCESS",
  "chaveAcesso": "41261012345678000195554650000000101585524161",
  "protocolo": "141260000000000"
}

Response statuses

Status	Meaning
`200`	Invoice processed. Check `outcome`.
`400`	Invalid body.
`401`	`x-api-key` missing or invalid.
`402`	Issuing blocked by the account’s plan or balance.
`403`	Organization inactive, or the key lacks the `nfe:emit` scope.
`422`	Invoice rejected during validation or by SEFAZ.
`503`	SEFAZ unavailable. Try again later.

​With or without tax calculation

With calculation (default)

Without calculation (calculateTaxes: false)

​Body structure

​Main groups

​Tax regime

​Full example

​Response

​Response statuses