CT-e
Consultar CT-e
Devolve status, dados do documento, links de XML / DACTE e a lista de eventos.
/openapi/v2/empresas/{empresaId}/cte/{cteId}token, timestamp e sign, veja Autenticação.É por aqui que se acompanha o que aconteceu com o documento depois do envio. Consulta pelo id enviado na emissão. Os links de download são tokens de curta duração, válidos por 10 minutos e reemitidos a cada consulta.
Parâmetros de caminho
empresaId* | string | Identificador da empresa |
cteId* | string | Identificador do documento |
* Campo obrigatório
id | string | Identificador do documento |
status | string | Status do documento |
motivoStatus | string | Motivo do status |
numero | int | Número do documento |
serie | int | Série |
chaveAcesso | string | Chave de acesso |
numeroProtocolo | string | Protocolo de autorização |
dataEmissao | string | Momento da emissão |
dataAutorizacao | string | Momento da autorização |
tipoEmissao | string | Via de emissão |
protocoloEpec | string | Protocolo EPEC |
linkXml | string | Link do XML autorizado |
linkDacte | string | Link do DACTE |
cte | object | Eco da requisição |
| array | Eventos registrados |
statusStatus do documento
| Valores | Significado |
|---|---|
| Pendente | Aceito, na fila ou em envio |
| Autorizada | Autorizado pela SEFAZ; linkXml é o original legal e linkDacte o PDF do DACTE |
| Negada | Rejeitado pela SEFAZ; motivoStatus traz o código e o motivo |
| Cancelada | Cancelado pelo evento 110111 |
| Contingencia | SEFAZ indisponível; documento aguardando reenvio |
| Falha | Falha terminal da tarefa; motivoStatus explica e o mesmo id pode ser reenviado |
tipoEmissaoVia de emissão
A plataforma troca de via sozinha quando o autorizador do estado está fora do ar.
| Valores | Significado |
|---|---|
| Normal | Autorizador do próprio estado |
| Epec | Contingência EPEC: autorização prévia do evento |
| Fsda | Contingência FS-DA: formulário de segurança |
| SvcRs | Contingência SVC-RS: autorizador virtual do Rio Grande do Sul |
| SvcSp | Contingência SVC-SP: autorizador virtual de São Paulo |
cte.ambienteEmissaoAmbiente de emissão
| Valores | Significado |
|---|---|
| Homologacao | Ambiente de teste da SEFAZ; o documento não tem validade |
| Producao | Ambiente oficial |
cte.tipoTipo do documento
| Valores | Significado |
|---|---|
| Normal | Emissão comum |
| Complementar | Completa valores de CT-e já autorizados; exige ctesComplementados e dispensa documentos |
| Substituto | Substitui e corrige um CT-e anterior; exige cteSubstituido |
cte.tipoServicoTipo de serviço
| Valores | Significado |
|---|---|
| Normal | Frete contratado diretamente com esta transportadora |
| Subcontratacao | Outra transportadora contratou esta para todo o percurso; exige documentosAnteriores |
| Redespacho | Recebe a carga de outra transportadora para concluir o trajeto; exige documentosAnteriores |
| RedespachoIntermediario | Faz um trecho no meio do trajeto; exige documentosAnteriores |
| VinculadoMultimodal | Frete vinculado a um operador multimodal |
cte.modalModal
Só Rodoviario é aceito na fase um; os demais valores são reconhecidos mas retornam 10017018.
| Valores | Significado |
|---|---|
| Rodoviario | Transporte rodoviário |
| Aereo | Transporte aéreo; ainda não suportado |
| Aquaviario | Transporte aquaviário; ainda não suportado |
| Ferroviario | Transporte ferroviário; ainda não suportado |
| Dutoviario | Transporte dutoviário; ainda não suportado |
| Multimodal | Transporte multimodal; ainda não suportado |
cte.tomadorTomador do serviço
| Valores | Significado |
|---|---|
| Remetente | Quem despacha a mercadoria; exige remetente |
| Expedidor | Quem entrega a carga a esta transportadora no redespacho; exige expedidor |
| Recebedor | Quem recebe a carga desta transportadora para seguir viagem; exige recebedor |
| Destinatario | Quem recebe a mercadoria no fim do trajeto; exige destinatario |
| Outros | Alguém fora dos quatro participantes; exige tomadorOutros |
cte.indicadorIeTomadorSituação do tomador perante o ICMS
| Valores | Significado |
|---|---|
| Contribuinte | Contribuinte do ICMS; o tomador precisa de inscricaoEstadual numérica |
| Isento | Isento de inscrição estadual |
| NaoContribuinte | Não contribuinte, como consumidor final; em serviço interestadual exige impostos.icmsUfFim |
cte.carga.quantidades[].unidadeUnidade de medida da carga
| Valores | Significado |
|---|---|
| M3 | Metro cúbico |
| Kg | Quilograma |
| Ton | Tonelada |
| Unidade | Unidade ou volume |
| Litros | Litro |
| MMBTU | Milhão de BTU, unidade de energia usada para gás |
cte.documentos.nf[].modeloModelo da nota em papel
A plataforma só confere os 2 dígitos; outro valor não passa na validação do leiaute antes do envio à SEFAZ.
| Valores | Significado |
|---|---|
| 01 | Nota fiscal modelo 1 ou 1A, inclusive a avulsa |
| 04 | Nota fiscal de produtor rural |
cte.documentos.outros[].tipoTipo de outro documento
| Valores | Significado |
|---|---|
| Declaracao | Declaração de conteúdo |
| Dutoviario | Documento de transporte dutoviário |
| CfeSat | Cupom fiscal eletrônico emitido por equipamento SAT |
| Nfce | Nota fiscal de consumidor eletrônica |
| Outros | Qualquer outro documento; exige descricao |
cte.documentosAnteriores[].ufEstado do transportador anterior
Também vale para cte.rodoviario.ordensColeta[].emitente.uf. A plataforma só confere as 2 letras; sigla fora da lista não passa na validação do leiaute.
| Valores | Significado |
|---|---|
| AC | Acre |
| AL | Alagoas |
| AP | Amapá |
| AM | Amazonas |
| BA | Bahia |
| CE | Ceará |
| DF | Distrito Federal |
| ES | Espírito Santo |
| GO | Goiás |
| MA | Maranhão |
| MT | Mato Grosso |
| MS | Mato Grosso do Sul |
| MG | Minas Gerais |
| PA | Pará |
| PB | Paraíba |
| PR | Paraná |
| PE | Pernambuco |
| PI | Piauí |
| RJ | Rio de Janeiro |
| RN | Rio Grande do Norte |
| RS | Rio Grande do Sul |
| RO | Rondônia |
| RR | Roraima |
| SC | Santa Catarina |
| SP | São Paulo |
| SE | Sergipe |
| TO | Tocantins |
| EX | Exterior, para operação com o exterior |
cte.documentosAnteriores[].papeis[].tipoTipo de documento anterior em papel
A plataforma só confere os 2 dígitos; código fora da lista não passa na validação do leiaute antes do envio à SEFAZ.
| Valores | Significado |
|---|---|
| 07 | ATRE |
| 08 | DTA, despacho de trânsito aduaneiro |
| 09 | Conhecimento aéreo internacional |
| 10 | Conhecimento carta de porte internacional |
| 11 | Conhecimento avulso |
| 12 | TIF, transporte internacional ferroviário |
| 13 | BL, bill of lading |
cte.impostos.icms.situacaoTributariaCST do ICMS
Empresa do Simples Nacional só envia SN; regime normal nunca envia SN (10017022).
| Valores | Significado |
|---|---|
| 00 | Tributação integral |
| 20 | Tributação com redução da base de cálculo; exige percentualReducaoBase |
| 40 | Isenta |
| 41 | Não tributada |
| 51 | Diferida para etapa posterior |
| 60 | ICMS já retido anteriormente por substituição tributária; exige stRetido |
| 90 | Outras situações |
| 90-OutraUF | ICMS devido a outro estado; aceita outraUf |
| SN | Empresa do Simples Nacional; não envie baseCalculo nem valor |
cte.entrega.tipoDataPrazo de entrega por data
Omitido vale SemData.
| Valores | Significado |
|---|---|
| SemData | Sem data combinada |
| NaData | Num dia exato; exige data |
| AteData | Até um dia limite; exige data |
| APartirDe | A partir de um dia; exige data |
| NoPeriodo | Dentro de um intervalo; exige dataInicial e dataFinal |
cte.entrega.tipoHoraPrazo de entrega por hora
Omitido vale SemHora.
| Valores | Significado |
|---|---|
| SemHora | Sem hora combinada |
| NaHora | Numa hora exata; exige hora |
| AteHora | Até uma hora limite; exige hora |
| APartirDe | A partir de uma hora; exige hora |
| NoIntervalo | Dentro de uma faixa; exige horaInicial e horaFinal |
eventos[].tipoTipo do evento
| Valores | Significado |
|---|---|
| Cancelamento | Cancelamento do CT-e; código 110111 |
| CartaCorrecao | Carta de correção; código 110110 |
| Epec | Autorização prévia em contingência EPEC, registrada pela plataforma; código 110113 |
| ComprovanteEntrega | Comprovante de entrega; código 110180 |
| CancelamentoComprovanteEntrega | Cancelamento do comprovante de entrega; código 110181 |
| InsucessoEntrega | Insucesso na entrega; código 110190 |
| CancelamentoInsucessoEntrega | Cancelamento do insucesso na entrega; código 110191 |
| PrestacaoDesacordo | Prestação do serviço em desacordo; código 610110 |
| CancelamentoPrestacaoDesacordo | Cancelamento da prestação em desacordo; código 610111 |
eventos[].codigoCódigo do evento
| Valores | Significado |
|---|---|
| 110111 | Cancelamento do CT-e (Cancelamento) |
| 110110 | Carta de correção (CartaCorrecao) |
| 110113 | Autorização prévia em contingência EPEC, registrada pela plataforma (Epec) |
| 110180 | Comprovante de entrega (ComprovanteEntrega) |
| 110181 | Cancelamento do comprovante de entrega (CancelamentoComprovanteEntrega) |
| 110190 | Insucesso na entrega (InsucessoEntrega) |
| 110191 | Cancelamento do insucesso na entrega (CancelamentoInsucessoEntrega) |
| 610110 | Prestação do serviço em desacordo (PrestacaoDesacordo) |
| 610111 | Cancelamento da prestação em desacordo (CancelamentoPrestacaoDesacordo) |
eventos[].statusCódigo de retorno do registro
A plataforma só devolve 200 com um destes códigos; qualquer outro retorno da SEFAZ vira 10017043.
| Valores | Significado |
|---|---|
| 134 | Evento registrado; a SEFAZ o trata como sucesso |
| 135 | Evento registrado e vinculado ao CT-e |
| 136 | Evento registrado, mas não vinculado ao CT-e |
| Código | HTTP | |
|---|---|---|
| 10017003 | 404 | cteId não encontrado ou não pertence à empresa. Verifique o id e o empresaId. |
| 10003000 | 404 | empresaId não encontrado. |
