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.

POST/openapi/v2/empresas/{empresaId}/cte/{cteId}/cancelar

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

Cancelar es dejar sin efecto un CT-e ya autorizado; el documento no desaparece, pasa a constar como cancelado en la SEFAZ. 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); un rechazo de la SEFAZ devuelve 10017043. Como este POST puede llevar cuerpo, firme el JSON bruto sin CR/LF; sin cuerpo, firme con la cadena vacía.

Parámetros de ruta

`empresaId*`	string	Identificador de la empresa
`cteId*`	string	Identificador del documento

* Campo obligatorio

Cuerpo de la petición

motivo

string

Motivo de la cancelación

* Campo obligatorio

200

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

`chaveAcesso`	string	Clave de acceso
`tipo`	string	Tipo del evento
`codigo`	string	Código del evento
`sequencia`	int	Secuencia
`status`	string	Código de retorno
`motivo`	string	Motivo
`protocolo`	string	Protocolo
`data`	string	Fecha del registro
`linkXml`	string	Enlace del XML del evento

`tipo`Tipo del evento

Valores	Significado
Cancelamento	Cancelación del CT-e; código 110111
CartaCorrecao	Carta de corrección; código 110110
Epec	Autorización previa en contingencia EPEC, registrada por la plataforma; código 110113
ComprovanteEntrega	Comprobante de entrega; código 110180
CancelamentoComprovanteEntrega	Cancelación del comprobante de entrega; código 110181
InsucessoEntrega	Insuceso en la entrega; código 110190
CancelamentoInsucessoEntrega	Cancelación del insuceso en la entrega; código 110191
PrestacaoDesacordo	Prestación en desacuerdo; código 610110
CancelamentoPrestacaoDesacordo	Cancelación de la prestación en desacuerdo; código 610111

`codigo`Código del evento

Valores	Significado
110111	Cancelación del CT-e (`Cancelamento`)
110110	Carta de corrección (`CartaCorrecao`)
110113	Autorización previa en contingencia EPEC, registrada por la plataforma (`Epec`)
110180	Comprobante de entrega (`ComprovanteEntrega`)
110181	Cancelación del comprobante de entrega (`CancelamentoComprovanteEntrega`)
110190	Insuceso en la entrega (`InsucessoEntrega`)
110191	Cancelación del insuceso en la entrega (`CancelamentoInsucessoEntrega`)
610110	Prestación en desacuerdo (`PrestacaoDesacordo`)
610111	Cancelación de la prestación en desacuerdo (`CancelamentoPrestacaoDesacordo`)

`status`Código de retorno del registro

La plataforma solo devuelve 200 con uno de estos códigos; cualquier otro retorno de la SEFAZ se convierte en 10017043.

Valores	Significado
134	Evento registrado; la SEFAZ lo trata como éxito
135	Evento registrado y vinculado al CT-e
136	Evento registrado, pero no vinculado al CT-e

Código	HTTP
10017003	404	`cteId` no encontrado o no pertenece a la empresa. Verifique el id y el `empresaId`.
10003000	404	`empresaId` no encontrado.
10017004	400	La empresa no está en condición de emitir: deshabilitada o certificado no disponible. Registrar eventos también exige el certificado; reactive la empresa o vincule un certificado válido.
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 su código de retorno 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}/cancelar'

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 POST "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": "35260940673061000134570010000000011000000016",

"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=..."

}

Cancelar CT-e

Parámetros

Parámetros de ruta

Cuerpo de la petición

Respuestas

Enumeraciones3 tablas

tipoTipo del evento

codigoCódigo del evento

statusCódigo de retorno del registro

Errores9 ítems

`tipo`Tipo del evento

`codigo`Código del evento

`status`Código de retorno del registro