CT-e

Cancel CT-e

Registers cancellation event 110111 on an authorized CT-e, within 168 hours after authorization.

DELETE/openapi/v2/empresas/{empresaId}/cte/{cteId}

Requires the token, timestamp and sign signature headers, see Authentication.

The body is optional. Event 110111 is registered synchronously and the event object is returned. Constraints: the document must be Autorizada (10017040), within 168 hours after authorization (10017041), and a CT-e with a registered correction letter cannot be cancelled (10017048, MOC CT-e rule); a SEFAZ rejection returns 10017043. Because this DELETE may carry a body, sign the raw JSON with CR/LF removed; with no body, sign with the empty string.

Parameters

Path parameters

empresaIdstringrequired
Company (carrier) identifier returned at registration.
Example: 1934811222334455
cteIdstringrequired
The id sent at CT-e issuance.
Example: CTE-ORD-1

Request body

motivostringoptional
Cancellation reason (xJust), 15 to 255 characters; a fixed default text is used when omitted.
Example: Erro de digitacao no documento

Responses

200

Event registered with SEFAZ. The event object is returned synchronously.

chaveAcessostring
44-digit access key of the CT-e the event was linked to.
tipostring
Event type.
Values:CancelamentoCartaCorrecaoComprovanteEntregaCancelamentoComprovanteEntregaInsucessoEntregaCancelamentoInsucessoEntregaPrestacaoDesacordoCancelamentoPrestacaoDesacordoEpec
codigostring
SEFAZ event code (tpEvento): 110111, 110110, 110113, 110180, 110181, 110190, 110191, 610110, 610111.
sequenciainteger
Sequence number of the event within its type (the correction letter auto-increments).
statusstring
cStat returned by SEFAZ; 135 means the event was registered and linked.
motivostring
xMotivo returned by SEFAZ.
protocolostring
Event protocol number; use it as protocoloEvento to cancel the event.
datastring
Event registration date and time, ISO-8601 in UTC.
linkXmlstring
Download link of the event XML (procEvento). See File download.

Errors

Code	HTTP
CTe0001	404	`cteId` not found or not owned by the company. Check the id and the `empresaId`.
10003000	404	`empresaId` not found.
10017040	400	The document status does not allow the event; the CT-e must be `Autorizada`.
10017041	400	Cancellation window exceeded (168 hours after authorization).
10017042	400	Invalid event text (length out of range after sanitization).
10017043	400	SEFAZ rejected the event; `mensagem` carries the cStat and the reason.
10017048	400	Cancellation blocked: the CT-e already has a registered correction letter.
10001001	400	Request field validation failed (one entry per field); fix per `mensagem`.

APP_SECRET='<APP_SECRET>'

API_PATH='/openapi/v2/empresas/{empresaId}/cte/{cteId}'

TIMESTAMP=$(date +%s)

BODY='{ "motivo": "Erro de digitacao no documento" }'

SIGN=$(printf '%s%s%s%s' "$APP_SECRET" "$API_PATH" "$(printf '%s' "$BODY" | tr -d '\r\n')" "$TIMESTAMP" | md5sum | cut -d' ' -f1)

curl -sS -X DELETE "https://api.v2.tffiscal.com${API_PATH}" \

-H "Content-Type: application/json" \

-H "token: $APP_SECRET" -H "timestamp: $TIMESTAMP" -H "sign: $SIGN" \

--data-binary "$BODY"

{

"chaveAcesso": "35260940673061000134570010000000011000000010",

"tipo": "Cancelamento",

"codigo": "110111",

"sequencia": 1,

"status": "135",

"motivo": "Evento registrado e vinculado ao CT-e",

"protocolo": "135260000000099",

"data": "2026-09-06T13:00:00Z",

"linkXml": "https://.../openapi/files/xml/12?token=..."

}