CT-e

Cancelar CT-e

Registra el evento de cancelación 110111 en un CT-e autorizado, dentro de las 168 horas posteriores a la autorización.

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

Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

El cuerpo es opcional. El evento 110111 se registra de forma síncrona y se devuelve el objeto del evento. Restricciones: el documento debe estar Autorizada (10017040), dentro de las 168 horas posteriores a la autorización (10017041), y un CT-e con carta de corrección registrada no puede cancelarse (10017048, regla del MOC CT-e); un rechazo de la SEFAZ devuelve 10017043. Como este DELETE puede llevar cuerpo, firme el JSON bruto sin CR/LF; sin cuerpo, firme con la cadena vacía.

Parámetros

Parámetros de ruta

empresaIdstringobligatorio
Identificador de la empresa (transportista) devuelto en el registro.
Ejemplo: 1934811222334455
cteIdstringobligatorio
El id enviado en la emisión del CT-e.
Ejemplo: CTE-ORD-1

Cuerpo de la petición

motivostringopcional
Motivo de la cancelación (xJust), de 15 a 255 caracteres; si se omite, se usa un texto fijo por defecto.
Ejemplo: Erro de digitacao no documento

Respuestas

200

Evento registrado en la SEFAZ. El objeto del evento se devuelve de forma síncrona.

chaveAcessostring
Clave de acceso de 44 dígitos del CT-e al que se vinculó el evento.
tipostring
Tipo del evento.
Valores:CancelamentoCartaCorrecaoComprovanteEntregaCancelamentoComprovanteEntregaInsucessoEntregaCancelamentoInsucessoEntregaPrestacaoDesacordoCancelamentoPrestacaoDesacordoEpec
codigostring
Código del evento en la SEFAZ (tpEvento): 110111, 110110, 110113, 110180, 110181, 110190, 110191, 610110, 610111.
sequenciainteger
Número secuencial del evento dentro de su tipo (la carta de corrección se incrementa automáticamente).
statusstring
cStat devuelto por la SEFAZ; 135 significa evento registrado y vinculado.
motivostring
xMotivo devuelto por la SEFAZ.
protocolostring
Número de protocolo del evento; úselo como protocoloEvento para cancelar el evento.
datastring
Fecha y hora del registro del evento, ISO-8601 en UTC.
linkXmlstring
Enlace de descarga del XML del evento (procEvento). Vea Descarga de archivos.

Errores

Código	HTTP
CTe0001	404	`cteId` no encontrado o no pertenece a la empresa. Verifique el id y el `empresaId`.
10003000	404	`empresaId` no encontrado.
10017040	400	El estado del documento no permite el evento; el CT-e debe estar `Autorizada`.
10017041	400	Ventana de cancelación excedida (168 horas tras la autorización).
10017042	400	Texto del evento inválido (longitud fuera del rango tras la sanitización).
10017043	400	La SEFAZ rechazó el evento; `mensagem` trae el cStat y el motivo.
10017048	400	Cancelación bloqueada: el CT-e ya tiene una carta de corrección registrada.
10001001	400	Falló la validación de campos (una entrada por campo); corrija según `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=..."

}