v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

CTe Recebidas

Consultar

Quando a receita informa que um CT-e foi emitido contra a empresa, recebemos o XML completo deste CT-e e a receita poderá posteriormente notificar quando o CT-e recebe uma carta de correção ou quando ele for cancelado.

Por isso, os CT-es recebidos possuem um campo chamado versao que é único entre todos os documentos do mesmo CNPJ e que é atualizado a cada alteração neste CT-e. Isto facilita a busca apenas dos documentos que seu sistema ainda não conhece, sendo necessário que você armazene apenas um número por CNPJ.

Exemplo: Se você recebe um conhecimento de transporte, com versao = 60, e ele posteriormente receber uma carta de correção ou for cancelado, sua versão será atualizada para algum número maior que 60.

Este endpoint retorna os 100 primeiros CT-es encontrados. Para recuperar os demais CT-es você deverá fazer uma nova requisição alterando o parâmetro versao.

Para auxiliar o processo de consultar a API irá devolver os seguintes cabeçalhos HTTP:

X-Total-Count: O número total de registros (incluindo aqueles que não foram devolvidos pelo limite de 100 registros)
X-Max-Version: Valor máximo da versão dos documentos devolvidos. Utilize este cabeçalho para utilizar na próxima busca de versão, caso seja necessário.

Como retorno você receberá os campos descritos nos exemplos abaixo, de acordo com o status do CT-e.

get/ctes_recebidas

Query parameters

cnpjstring required

Example:12345678000123

CNPJ da empresa recebedora

versaonumber

Example:1

Busca apenas os documentos cuja versão seja maior que o parâmetro recebido. Utilize este parâmetro para buscar apenas as notas que seu sistema ainda não conhece.

Response

Requisição processada com sucesso

nome_emitentestring

Nome do emitente do conhecimento de transporte

documento_emitentestring

CNPJ ou CPF do emitente do conhecimento de transporte

cnpj_destinatariostring

CNPJ do destinatário do conhecimento de transporte (o CNPJ de sua empresa)

chave_ctestring

Chave do CT-e

valor_totalstring

Valor total do CT-e

data_emissaostring date-time

Data e hora de emissão do CT-e

situacao'autorizado' | 'cancelado' | 'denegado'

Situação do CT-e

tipo_cte'0' | '1' | '2' | '3'

Tipo do CT-e:

0: CT-e normal
1: CT-e de complementação de valores
2: CT-e de anulação
3: CT-e substituto

versaonumber

Versão do conhecimento de transporte. Este número irá mudar apenas se o conhecimento de transporte for alterado de alguma forma

digest_valuestring

Valor do resumo digital do XML do conhecimento

carta_correcaostring

Conteúdo da carta de correção, se houver

data_carta_correcaostring date-time

Data da carta de correção, se houver

data_cancelamentostring date-time

Data do cancelamento, se o documento estiver cancelado

justificativa_cancelamentostring

Justificativa do cancelamento, se o documento estiver cancelado

Example response

[
  {
    "nome_emitente": "EMPRESA TRANSPORTADORA LTDA",
    "documento_emitente": "123456780001233",
    "cnpj_destinatario": "123456780001234",
    "chave_cte": "35191008165642000152570020004201831004201839",
    "valor_total": "295.66",
    "data_emissao": "2019-10-07T23:44:00-03:00",
    "situacao": "autorizado",
    "tipo_cte": "0",
    "versao": 1709,
    "digest_value": "Xa/AO4zX/qSMh13ILIh1V7GTAQ3=",
    "carta_correcao": "Correção de dados do destinatário",
    "data_carta_correcao": "2019-10-08T10:30:00-03:00",
    "data_cancelamento": "2019-10-09T14:20:00-03:00",
    "justificativa_cancelamento": "Erro na emissão do documento"
  }
]