CT-e

Prestación en desacuerdo

Registra el evento 610110 (prestación del servicio en desacuerdo) en un CT-e emitido por otra empresa.

POST/openapi/v2/empresas/{empresaId}/cte/{chaveAcesso}/desacordo

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

Esta empresa actúa como receptora / tomadora de un CT-e emitido por otra empresa: la ruta lleva la clave de acceso de 44 dígitos del documento ajeno y el evento se encamina a la SEFAZ del estado de ese documento. Enviado de forma síncrona; en caso de éxito se devuelve el objeto del evento. Guarde el protocolo: es el protocoloEvento usado en Cancelar prestación en desacuerdo.

Parámetros

Parámetros de ruta

empresaIdstringobligatorio
Identificador de la empresa (transportista) devuelto en el registro.
Ejemplo: 1934811222334455
chaveAcessostringobligatorio
Clave de acceso de 44 dígitos del CT-e emitido por otra empresa.
Ejemplo: 35260940673061000134570010000000011000000010

Cuerpo de la petición

observacaostringobligatorio
Descripción del desacuerdo (xObs), de 15 a 255 caracteres.
Ejemplo: Servico de transporte nao contratado por esta empresa

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
10003000	404	`empresaId` no encontrado.
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.
10001001	400	Falló la validación de campos (una entrada por campo); corrija según `mensagem`.

Sanitización de texto y coordenadas

Los campos de texto se sanitizan (acentos eliminados, espacios en blanco consolidados) antes de la validación de longitud; un texto que queda fuera del rango tras la sanitización devuelve 10017042. Las coordenadas se registran con seis decimales.

APP_SECRET='<APP_SECRET>'

API_PATH='/openapi/v2/empresas/{empresaId}/cte/{chaveAcesso}/desacordo'

TIMESTAMP=$(date +%s)

BODY='{ "observacao": "Servico de transporte nao contratado por esta empresa" }'

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": "35260940673061000134570010000000011000000010",

"tipo": "PrestacaoDesacordo",

"codigo": "610110",

"sequencia": 1,

"status": "135",

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

"protocolo": "135260000000103",

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

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

}