TF Fiscal
Documentation

CT-e

List events

Returns every event registered on the CT-e.

GET/openapi/v2/empresas/{empresaId}/cte/{cteId}/eventos

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

Lists the registered events (cancellation, correction letters, delivery receipts and failures and their cancellations), each with type, sequence, cStat, protocol, date and XML link. The same list appears as eventos in the query.

Parameters

Path parameters

  • empresaIdstringrequired

    Company (carrier) identifier returned at registration.

    Example: 1934811222334455
  • cteIdstringrequired

    The id sent at CT-e issuance.

    Example: CTE-ORD-1

Responses

200

Array of event objects; empty when no event has been registered.

  • 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

CodeHTTP
CTe0001404

cteId not found or not owned by the company. Check the id and the empresaId.

10003000404

empresaId not found.

PreviousCancel service disagreementNextDC-e