DC-e Content Declaration · TF Fiscal API

Note

DC-e — Electronic Content Declaration

The DC-e API (model 99, layout 1.00) lets you issue, consult, cancel and obtain the PDF (DACE) of electronic content declarations. The DC-e is the fiscal document that covers the transport of goods or merchandise when there is no obligation to issue an invoice — for example, shipments involving ICMS non-taxpayers. The issuer is always a legal entity (CNPJ); the recipient may be a legal entity (CNPJ) or an individual (CPF). The business data goes in the /create body; the technical access-key fields (cDC, cDV, cUF, dhEmi, mod) are calculated automatically by the server.

Endpoint	Method	Description
`/api/dce/create`	POST	Issue DC-e
`/api/dce/consult`	POST	Consult the status of the DC-e
`/api/dce/cancel`	POST	Cancel an authorized DC-e
`/api/dce/pdf`	POST	Obtain the DACE (PDF) of the DC-e

The DC-e is routed to the authorizer of the issuer's state (UF). The ide.cUF field must be consistent with the UF informed in emit.enderEmit.UF — tax authority rejects with cStat=220 when they diverge; if omitted, cUF is derived from that UF.

POST/api/dce/create

Issue DC-e

Issues a DC-e from the submitted body. The client sends only the business data; the technical access-key identification fields are calculated by the server (see the note below the ide table). Credit is debited only in production (tpAmb=1) and when the DC-e is authorized.

Required headers

Header	Type	Description
token	string	Token of the issuing company
sign	string	MD5 signature: `MD5(token + path + body + timestamp)`
timestamp	string	Unix timestamp in seconds (5-minute window)

Body — root

Field	Type	Description
ide *	object	DC-e identification
emit *	object	Issuer/sender data (CNPJ; or CPF via Marketplace — see below)
dest *	object	Recipient data
det *	array	Declared items/goods — minimum 1
total *	object	Declaration totalizer
transp	object	Transport data
marketplace	object	Marketplace data (only when `ide.tpEmit=1`)
fisco	object	Tax authority body data (only when `ide.tpEmit=0`)
autXML	array	CNPJs/CPFs authorized to access the XML
infAdic	object	Additional information

Required fields in the request: ide.tpAmb; emit.CNPJ (14 digits) or emit.CPF (11 digits, individual sender via Marketplace — see the note under emit), emit.xNome and emit.enderEmit (xLgr, nro, xBairro, cMun, xMun, CEP with 8 digits, UF); dest with CNPJ or CPF, dest.xNome and dest.enderDest (same address fields); at least 1 item in det with xProd, NCM (2 or 8 digits), qCom > 0 and vProd > 0; and total.vDC > 0. All other fields are optional.

ide — Identification

Field	Type	Description
tpAmb *	int	Environment: `1`=production, `2`=staging. The only truly required field of `ide`.
tpEmit	int	Issuer type: `0`=Tax Authority Application, `1`=Marketplace, `2`=Own issuer. Optional — default: `2`
cUF	int	IBGE code of the issuer's UF (2 digits). Optional — derived from `emit.enderEmit.UF` when omitted. If sent, it must be consistent with that UF (tax authority rejects with `cStat=220` in case of divergence)
serie	int	Fiscal document series (3 digits of the access key) — identifies the DC-e numbering set. Optional — default: DC-e series registered for the company
nDC	long	Sequential DC-e number (part of the access key). Optional — auto-incremented by the server when omitted or `0`
nSiteAutoriz	int	Identification of the authorizer site that processed the DC-e (1 digit of the access key). Usually `0` (primary site). Optional — default: `0`
tpEmis	int	Issuance method: `1`=Normal, `9`=Contingency. Optional — default: `1`

Filled in automatically by the server — you do not need to send them: mod (fixed at 99) and cDV (key check digit) are always set by the server; cDC (6-digit numeric code), dhEmi (issuance date/time) and verProc (process version) are generated when omitted. The serie, nDC and cUF fields in the table above are also filled in automatically when omitted.

emit — Issuer / Sender

Field	Type	Description
CNPJ ⚠	string	Issuer's CNPJ (14 digits). Filled in with the CNPJ of the token's company when omitted
CPF ⚠	string	CPF of the individual sender (11 digits). Only allowed for issuance via Marketplace — see note below
xNome *	string	Issuer's/sender's name or company name
enderEmit *	object	Issuer's address (see structure below)

Individual sender (CPF): by the tax authority rules, a CPF cannot be its own issuer (tpEmit=2 requires a CNPJ). To issue with a CPF as the sender, just send emit.CPF (without emit.CNPJ): the server automatically sets tpEmit=1 (Marketplace), uses your company's CNPJ (from the token) as the authorized issuer in the access key, and fills the marketplace block with the company's data. The CPF you provide appears as the sender in emit.

dest — Recipient

Field	Type	Description
CNPJ ⚠	string	Recipient's CNPJ (14 digits)
CPF ⚠	string	Recipient's CPF (11 digits)
xNome *	string	Recipient's name or company name
enderDest *	object	Recipient's address (see structure below)

enderEmit / enderDest — Address

Field	Type	Description
xLgr *	string	Street
nro *	string	Number
xCpl	string	Complement
xBairro *	string	Neighborhood
cMun *	long	IBGE municipality code (7 digits)
xMun *	string	Municipality name
CEP *	string	Postal code (8 digits)
UF *	string	State abbreviation (2 letters)
cPais	int	Country code. Default: `1058` (Brazil)
xPais	string	Country name. Default: `BRASIL`
fone	string	Phone
email	string	E-mail

det[] — Declared items

Field	Type	Description
nItem	int	Sequential item number
xProd *	string	Description of the declared good/merchandise
NCM *	string	NCM code (2 or 8 digits)
qCom *	decimal	Quantity (> 0)
vUnCom	decimal	Unit value
vProd *	decimal	Total item value (> 0)
infAdProd	string	Additional item information

total — Totalizer

Field	Type	Description
vDC *	decimal	Total declared value (> 0)

transp — Transport

Field	Type	Description
modTrans	int	Transport mode: `0`=Postal service, `1`=own, `2`=carrier. Default: `2`
CNPJTransp	string	Carrier's CNPJ

marketplace — Marketplace (only `tpEmit=1`)

Field	Type	Description
CNPJ	string	Marketplace's CNPJ
xNome	string	Marketplace name
Site	string	Marketplace website

fisco — Tax authority body (only `tpEmit=0`)

Field	Type	Description
CNPJ	string	Body's CNPJ
xOrgao	string	Body name
UF	string	Body's UF

autXML[] — Authorized for XML

Field	Type	Description
CNPJ	string	CNPJ authorized to consult/download the XML
CPF	string	CPF authorized to consult/download the XML

infAdic — Additional information

Field	Type	Description
infAdFisco	string	Information of interest to the tax authority
infCpl	string	Supplementary information of interest to the taxpayer
infAdMarketPlace	string	Additional marketplace information

* Required field. ⚠ In the issuer and in the recipient, at least one of CNPJ or CPF is required.

# sign = md5(token + path + body + timestamp)
# Template generated from the endpoint path; replace the placeholders
curl -X POST "https://api.tffiscal.com/api/dce/create" \
  -H "Content-Type: application/json" \
  -H "token: $TOKEN" \
  -H "timestamp: $TIMESTAMP" \
  -H "sign: $SIGN" \
  -d @body.json

        {
          "ide": {
            "tpAmb": 2,
            "tpEmit": 2
          },
          "emit": {
            "CNPJ": "12345678000199",
            "xNome": "EMPRESA EXEMPLO LTDA",
            "enderEmit": {
              "xLgr": "RUA EXEMPLO",
              "nro": "100",
              "xBairro": "CENTRO",
              "cMun": 4106902,
              "xMun": "CURITIBA",
              "CEP": "80010000",
              "UF": "PR"
            }
          },
          "dest": {
            "CPF": "12345678909",
            "xNome": "JOAO DA SILVA",
            "enderDest": {
              "xLgr": "AVENIDA DESTINO",
              "nro": "500",
              "xBairro": "JARDIM",
              "cMun": 4113700,
              "xMun": "LONDRINA",
              "CEP": "86010000",
              "UF": "PR"
            }
          },
          "det": [
            {
              "nItem": 1,
              "xProd": "LIVROS DIVERSOS",
              "NCM": "49019900",
              "qCom": 3,
              "vUnCom": 50.00,
              "vProd": 150.00
            }
          ],
          "total": {
            "vDC": 150.00
          }
        }

        {
          "ide": {
            "tpAmb": 2,
            "tpEmit": 2,
            "cUF": 41,
            "serie": 1,
            "nSiteAutoriz": 0
          },
          "emit": {
            "CNPJ": "12345678000199",
            "xNome": "EMPRESA EXEMPLO LTDA",
            "enderEmit": {
              "xLgr": "RUA EXEMPLO",
              "nro": "100",
              "xCpl": "SALA 2",
              "xBairro": "CENTRO",
              "cMun": 4106902,
              "xMun": "CURITIBA",
              "CEP": "80010000",
              "UF": "PR",
              "cPais": 1058,
              "xPais": "BRASIL",
              "fone": "4133334444",
              "email": "contato@exemplo.com"
            }
          },
          "dest": {
            "CNPJ": "98765432000188",
            "xNome": "DESTINATARIO EXEMPLO LTDA",
            "enderDest": {
              "xLgr": "AVENIDA DESTINO",
              "nro": "500",
              "xCpl": "GALPAO 3",
              "xBairro": "JARDIM",
              "cMun": 4113700,
              "xMun": "LONDRINA",
              "CEP": "86010000",
              "UF": "PR",
              "cPais": 1058,
              "xPais": "BRASIL",
              "fone": "4333335555",
              "email": "destino@exemplo.com"
            }
          },
          "autXML": [
            { "CNPJ": "11222333000144" },
            { "CPF": "98765432100" }
          ],
          "det": [
            {
              "nItem": 1,
              "xProd": "LIVROS DIVERSOS",
              "NCM": "49019900",
              "qCom": 3,
              "vUnCom": 50.00,
              "vProd": 150.00,
              "infAdProd": "Caixa 1 de 2"
            },
            {
              "nItem": 2,
              "xProd": "MATERIAL DE ESCRITORIO",
              "NCM": "48201000",
              "qCom": 10,
              "vUnCom": 8.00,
              "vProd": 80.00,
              "infAdProd": "Caixa 2 de 2"
            }
          ],
          "total": {
            "vDC": 230.00
          },
          "transp": {
            "modTrans": 2,
            "CNPJTransp": "55666777000188"
          },
          "infAdic": {
            "infAdFisco": "Operacao nao sujeita a emissao de nota fiscal",
            "infCpl": "Remessa de bens entre filiais"
          }
        }

        {
          "success": true,
          "message": "DC-e autorizada",
          "data": {
            "chave": "41250612345678000199990010000000011201234564",
            "serie": 1,
            "number": 1,
            "cStat": "100",
            "xMotivo": "Autorizado o uso do DC-e",
            "nProt": "141250000123456",
            "xml": "https://storage.../dce/41250612345678000199990010000000011201234564.xml",
            "dace": "https://storage.../dce/41250612345678000199990010000000011201234564.pdf"
          }
        }

        {
          "success": false,
          "message": "DC-e rejeitada: Rejeicao: ...",
          "data": {
            "chave": "41250612345678000199990010000000011201234564",
            "serie": 1,
            "number": 1,
            "cStat": "225",
            "xMotivo": "Rejeicao: Falha no Schema XML",
            "nProt": "",
            "xml": "",
            "dace": ""
          }
        }

POST/api/dce/consult

Consult the status of the DC-e

Consults the current status of the DC-e at the tax authority from the access key. When the DC-e is canceled, the response reflects the cancellation data (the local database is the source of truth about cancellation).

Required headers

Header	Type	Description
token	string	Token of the issuing company
sign	string	MD5 signature
timestamp	string	Unix timestamp in seconds

Body

Field	Type	Description
chDCe *	string	DC-e access key (44 digits)

* Required field.

# sign = md5(token + path + body + timestamp)
# Template generated from the endpoint path; replace the placeholders
curl -X POST "https://api.tffiscal.com/api/dce/consult" \
  -H "Content-Type: application/json" \
  -H "token: $TOKEN" \
  -H "timestamp: $TIMESTAMP" \
  -H "sign: $SIGN" \
  -d @body.json

        {
          "chDCe": "41250612345678000199990010000000011201234564"
        }

        {
          "success": true,
          "message": "Autorizado o uso do DC-e",
          "data": {
            "chDCe": "41250612345678000199990010000000011201234564",
            "status": "Success",
            "cStat": "100",
            "xMotivo": "Autorizado o uso do DC-e",
            "nProt": "141250000123456",
            "xml": "https://storage.../dce/41250612345678000199990010000000011201234564.xml",
            "dace": "https://storage.../dce/41250612345678000199990010000000011201234564.pdf"
          }
        }

        {
          "success": true,
          "message": "DC-e Cancelada",
          "data": {
            "chDCe": "41250612345678000199990010000000011201234564",
            "status": "Canceled",
            "cStat": "101",
            "xMotivo": "Cancelamento de DCe homologado",
            "nProt": "141250000123457",
            "xml": "https://storage.../dce/41250612345678000199990010000000011201234564.xml",
            "xmlCancel": "https://storage.../dce/41250612345678000199990010000000011201234564-110111-01.xml",
            "dhEventoCancel": "2026-06-11T11:00:00-03:00"
          }
        }

POST/api/dce/cancel

Cancel DC-e

Cancels an authorized DC-e (event 110111). Requires that the DC-e has been authorized (has a protocol) and is not yet canceled. Each DC-e allows a single cancellation.

Required headers

Header	Type	Description
token	string	Token of the issuing company
sign	string	MD5 signature
timestamp	string	Unix timestamp in seconds

Body

Field	Type	Description
chDCe *	string	DC-e access key (44 digits)
xJust *	string	Cancellation justification (minimum 15 characters as required by the tax authority)
nProt	string	Authorization protocol. Optional: when omitted, uses the protocol registered at issuance

* Required field.

In case of rejection, the response returns success=false, the cStat/xMotivo of the refusal and an additional field xmlEnviadoDebug with the XML that was sent, for diagnosis.

# sign = md5(token + path + body + timestamp)
# Template generated from the endpoint path; replace the placeholders
curl -X POST "https://api.tffiscal.com/api/dce/cancel" \
  -H "Content-Type: application/json" \
  -H "token: $TOKEN" \
  -H "timestamp: $TIMESTAMP" \
  -H "sign: $SIGN" \
  -d @body.json

        {
          "chDCe": "41250612345678000199990010000000011201234564",
          "xJust": "Cancelamento por erro no preenchimento dos dados da declaracao"
        }

        {
          "success": true,
          "message": "DC-e cancelada",
          "data": {
            "chDCe": "41250612345678000199990010000000011201234564",
            "cStat": "135",
            "xMotivo": "Evento registrado e vinculado a DC-e",
            "nProtCancel": "141250000123457",
            "xmlCancel": "https://storage.../dce/41250612345678000199990010000000011201234564-110111-01.xml"
          }
        }

POST/api/dce/pdf

Get DC-e PDF

Returns the URL of the DACE — the PDF representation of the DC-e. When the PDF does not yet exist in storage, it is generated on demand and uploaded. If storage is unavailable, the PDF is returned as base64 in the response body itself.

Required headers

Header	Type	Description
token	string	Token of the issuing company
sign	string	MD5 signature
timestamp	string	Unix timestamp in seconds

Body

Field	Type	Description
chDCe *	string	DC-e access key (44 digits)

* Required field.

# sign = md5(token + path + body + timestamp)
# Template generated from the endpoint path; replace the placeholders
curl -X POST "https://api.tffiscal.com/api/dce/pdf" \
  -H "Content-Type: application/json" \
  -H "token: $TOKEN" \
  -H "timestamp: $TIMESTAMP" \
  -H "sign: $SIGN" \
  -d @body.json

        {
          "chDCe": "41250612345678000199990010000000011201234564"
        }

        {
          "success": true,
          "message": "DACE disponível",
          "data": {
            "chave": "41250612345678000199990010000000011201234564",
            "dace": "https://storage.../dce/41250612345678000199990010000000011201234564.pdf"
          }
        }

        {
          "success": true,
          "message": "DACE disponível",
          "data": {
            "chave": "41250612345678000199990010000000011201234564",
            "pdfBase64": "JVBERi0xLjcKJ...",
            "pdfSize": 84213
          }
        }

GET/api/dce/get_list

List DC-e (paginated)

Lists the company's DC-e with pagination. Parameters are passed via query string (not in the body). The time filter is optional, but if used, both start_create_time and end_create_time are required.

Required headers

Header	Type	Description
token	string	Issuing company token
sign	string	MD5 signature (path includes the query string)
timestamp	string	Unix timestamp in seconds

Query string

Parameter	Type	Description
page *	int	Page number (≥ 1)
page_size *	int	Page size (1–50)
start_create_time	long	Unix timestamp in milliseconds — start (requires `end_create_time`)
end_create_time	long	Unix timestamp in milliseconds — end
status	string	Filter by status. Values: `"Success"` (authorized), `"Canceled"` (canceled), `"Processing"` (processing), `"Failed"` (failed), `"Unknown"` (unknown)

* Required field.

# sign = md5(token + path + body + timestamp)
# Template generated from the endpoint path; replace the placeholders
curl -X GET "https://api.tffiscal.com/api/dce/get_list" \
  -H "Content-Type: application/json" \
  -H "token: $TOKEN" \
  -H "timestamp: $TIMESTAMP" \
  -H "sign: $SIGN"

GET /api/dce/get_list?page=1&page_size=20&status=Success

        {
          "success": true,
          "data": {
            "list": [
              {
                "chave": "35260112345678000190990010000000011000000013",
                "serie": 1,
                "number": 1,
                "status": "Success",
                "create": "2026-01-10T10:30:00Z",
                "issue_time": "2026-01-10T10:31:00Z"
              }
            ],
            "page": 1,
            "total": 142,
            "total_pages": 8
          }
        }

DC-e — Electronic Content Declaration

Issue DC-e

Required headers

Body — root

ide — Identification

emit — Issuer / Sender

dest — Recipient

enderEmit / enderDest — Address

det[] — Declared items

total — Totalizer

transp — Transport

marketplace — Marketplace (only tpEmit=1)

fisco — Tax authority body (only tpEmit=0)

autXML[] — Authorized for XML

infAdic — Additional information

Consult the status of the DC-e

Required headers

Body

Cancel DC-e

Required headers

Body

Get DC-e PDF

Required headers

Body

List DC-e (paginated)

Required headers

Query string

marketplace — Marketplace (only `tpEmit=1`)

fisco — Tax authority body (only `tpEmit=0`)