CT-e
Consultar CT-e
Devolve status, dados do documento, links de XML / DACTE e a lista de eventos.
GET
/openapi/v2/empresas/{empresaId}/cte/{cteId}Requer os cabeçalhos de assinatura
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
200
Documento encontrado.
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 |
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. |