CT-e
Consultar CT-e
Devuelve estado, datos del documento, enlaces de XML / DACTE y la lista de eventos.
/openapi/v2/empresas/{empresaId}/cte/{cteId}token, timestamp y sign, vea Autenticación.Por aquí se sigue qué pasó con el documento después del envío. Consulta por el id enviado en la emisión. Los enlaces de descarga son tokens de corta duración, válidos por 10 minutos y reemitidos en cada consulta.
Parámetros de ruta
empresaId* | string | Identificador de la empresa |
cteId* | string | Identificador del documento |
* Campo obligatorio
id | string | Identificador del documento |
status | string | Estado del documento |
motivoStatus | string | Motivo del estado |
numero | int | Número del documento |
serie | int | Serie |
chaveAcesso | string | Clave de acceso |
numeroProtocolo | string | Protocolo de autorización |
dataEmissao | string | Momento de la emisión |
dataAutorizacao | string | Momento de la autorización |
tipoEmissao | string | Vía de emisión |
protocoloEpec | string | Protocolo EPEC |
linkXml | string | Enlace del XML autorizado |
linkDacte | string | Enlace del DACTE |
cte | object | Eco de la solicitud |
| array | Eventos registrados |
statusEstado del documento
| Valores | Significado |
|---|---|
| Pendente | Aceptado, en cola o en envío |
| Autorizada | Autorizado por la SEFAZ; linkXml es el original legal y linkDacte el PDF del DACTE |
| Negada | Rechazado por la SEFAZ; motivoStatus trae el código y el motivo |
| Cancelada | Cancelado por el evento 110111 |
| Contingencia | SEFAZ no disponible; documento pendiente de reenvío |
| Falha | Fallo terminal de la tarea; motivoStatus explica y el mismo id puede reenviarse |
tipoEmissaoVía de emisión
La plataforma cambia de vía sola cuando el autorizador del estado está caído.
| Valores | Significado |
|---|---|
| Normal | Autorizador del propio estado |
| Epec | Contingencia EPEC: autorización previa del evento |
| Fsda | Contingencia FS-DA: formulario de seguridad |
| SvcRs | Contingencia SVC-RS: autorizador virtual de Rio Grande do Sul |
| SvcSp | Contingencia SVC-SP: autorizador virtual de São Paulo |
cte.ambienteEmissaoAmbiente de emisión
| Valores | Significado |
|---|---|
| Homologacao | Ambiente de prueba de la SEFAZ; el documento no tiene validez |
| Producao | Ambiente oficial |
cte.tipoTipo del documento
| Valores | Significado |
|---|---|
| Normal | Emisión común |
| Complementar | Completa importes de CT-e ya autorizados; exige ctesComplementados y dispensa documentos |
| Substituto | Sustituye y corrige un CT-e anterior; exige cteSubstituido |
cte.tipoServicoTipo de servicio
| Valores | Significado |
|---|---|
| Normal | Flete contratado directamente con este transportista |
| Subcontratacao | Otro transportista contrató a este para todo el recorrido; exige documentosAnteriores |
| Redespacho | Recibe la carga de otro transportista para concluir el trayecto; exige documentosAnteriores |
| RedespachoIntermediario | Hace un tramo intermedio del trayecto; exige documentosAnteriores |
| VinculadoMultimodal | Flete vinculado a un operador multimodal |
cte.modalModal
Solo Rodoviario se acepta en la fase uno; los demás valores se reconocen pero devuelven 10017018.
| Valores | Significado |
|---|---|
| Rodoviario | Transporte por carretera |
| Aereo | Transporte aéreo; aún no soportado |
| Aquaviario | Transporte acuático; aún no soportado |
| Ferroviario | Transporte ferroviario; aún no soportado |
| Dutoviario | Transporte por ducto; aún no soportado |
| Multimodal | Transporte multimodal; aún no soportado |
cte.tomadorTomador del servicio
| Valores | Significado |
|---|---|
| Remetente | Quien despacha la mercancía; exige remetente |
| Expedidor | Quien entrega la carga a este transportista en el redespacho; exige expedidor |
| Recebedor | Quien recibe la carga de este transportista para seguir viaje; exige recebedor |
| Destinatario | Quien recibe la mercancía al final del trayecto; exige destinatario |
| Outros | Alguien fuera de los cuatro participantes; exige tomadorOutros |
cte.indicadorIeTomadorSituación del tomador ante el ICMS
| Valores | Significado |
|---|---|
| Contribuinte | Contribuyente del ICMS; el tomador necesita inscricaoEstadual numérica |
| Isento | Exento de inscripción estatal |
| NaoContribuinte | No contribuyente, como consumidor final; en servicio interestatal exige impostos.icmsUfFim |
cte.carga.quantidades[].unidadeUnidad de medida de la carga
| Valores | Significado |
|---|---|
| M3 | Metro cúbico |
| Kg | Kilogramo |
| Ton | Tonelada |
| Unidade | Unidad o bulto |
| Litros | Litro |
| MMBTU | Millón de BTU, unidad de energía usada para gas |
cte.documentos.nf[].modeloModelo de la factura en papel
La plataforma solo verifica los 2 dígitos; otro valor no pasa la validación del diseño antes del envío a la SEFAZ.
| Valores | Significado |
|---|---|
| 01 | Factura modelo 1 o 1A, incluida la avulsa emitida por la autoridad fiscal |
| 04 | Factura de productor rural |
cte.documentos.outros[].tipoTipo de otro documento
| Valores | Significado |
|---|---|
| Declaracao | Declaración de contenido |
| Dutoviario | Documento de transporte por ducto |
| CfeSat | Cupón fiscal electrónico emitido por equipo SAT |
| Nfce | Factura electrónica al consumidor |
| Outros | Cualquier otro documento; exige descricao |
cte.documentosAnteriores[].ufEstado del transportista anterior
También vale para cte.rodoviario.ordensColeta[].emitente.uf. La plataforma solo verifica las 2 letras; una sigla fuera de la lista no pasa la validación del diseño.
| 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 operaciones con el exterior |
cte.documentosAnteriores[].papeis[].tipoTipo de documento anterior en papel
La plataforma solo verifica los 2 dígitos; un código fuera de la lista no pasa la validación del diseño antes del envío a la SEFAZ.
| Valores | Significado |
|---|---|
| 07 | ATRE |
| 08 | DTA, despacho de tránsito aduanero |
| 09 | Conocimiento aéreo internacional |
| 10 | Conocimiento carta de porte internacional |
| 11 | Conocimiento suelto |
| 12 | TIF, transporte internacional ferroviario |
| 13 | BL, bill of lading |
cte.impostos.icms.situacaoTributariaCST del ICMS
Una empresa del Simples Nacional solo envía SN; el régimen normal nunca envía SN (10017022).
| Valores | Significado |
|---|---|
| 00 | Tributación integral |
| 20 | Tributación con reducción de la base; exige percentualReducaoBase |
| 40 | Exenta |
| 41 | No gravada |
| 51 | Diferida a una etapa posterior |
| 60 | ICMS ya retenido anteriormente por sustitución tributaria; exige stRetido |
| 90 | Otras situaciones |
| 90-OutraUF | ICMS debido a otro estado; acepta outraUf |
| SN | Empresa del Simples Nacional; no envíe baseCalculo ni valor |
cte.entrega.tipoDataPlazo de entrega por fecha
Omitido vale SemData.
| Valores | Significado |
|---|---|
| SemData | Sin fecha pactada |
| NaData | En un día exacto; exige data |
| AteData | Hasta un día límite; exige data |
| APartirDe | A partir de un día; exige data |
| NoPeriodo | Dentro de un intervalo; exige dataInicial y dataFinal |
cte.entrega.tipoHoraPlazo de entrega por hora
Omitido vale SemHora.
| Valores | Significado |
|---|---|
| SemHora | Sin hora pactada |
| NaHora | A una hora exacta; exige hora |
| AteHora | Hasta una hora límite; exige hora |
| APartirDe | A partir de una hora; exige hora |
| NoIntervalo | Dentro de una franja; exige horaInicial y horaFinal |
eventos[].tipoTipo del evento
| Valores | Significado |
|---|---|
| Cancelamento | Cancelación del CT-e; código 110111 |
| CartaCorrecao | Carta de corrección; código 110110 |
| Epec | Autorización previa en contingencia EPEC, registrada por la plataforma; código 110113 |
| ComprovanteEntrega | Comprobante de entrega; código 110180 |
| CancelamentoComprovanteEntrega | Cancelación del comprobante de entrega; código 110181 |
| InsucessoEntrega | Insuceso en la entrega; código 110190 |
| CancelamentoInsucessoEntrega | Cancelación del insuceso en la entrega; código 110191 |
| PrestacaoDesacordo | Prestación en desacuerdo; código 610110 |
| CancelamentoPrestacaoDesacordo | Cancelación de la prestación en desacuerdo; código 610111 |
eventos[].codigoCódigo del evento
| Valores | Significado |
|---|---|
| 110111 | Cancelación del CT-e (Cancelamento) |
| 110110 | Carta de corrección (CartaCorrecao) |
| 110113 | Autorización previa en contingencia EPEC, registrada por la plataforma (Epec) |
| 110180 | Comprobante de entrega (ComprovanteEntrega) |
| 110181 | Cancelación del comprobante de entrega (CancelamentoComprovanteEntrega) |
| 110190 | Insuceso en la entrega (InsucessoEntrega) |
| 110191 | Cancelación del insuceso en la entrega (CancelamentoInsucessoEntrega) |
| 610110 | Prestación en desacuerdo (PrestacaoDesacordo) |
| 610111 | Cancelación de la prestación en desacuerdo (CancelamentoPrestacaoDesacordo) |
eventos[].statusCódigo de retorno del registro
La plataforma solo devuelve 200 con uno de estos códigos; cualquier otro retorno de la SEFAZ se convierte en 10017043.
| Valores | Significado |
|---|---|
| 134 | Evento registrado; la SEFAZ lo trata como éxito |
| 135 | Evento registrado y vinculado al CT-e |
| 136 | Evento registrado, pero no vinculado al CT-e |
| Código | HTTP | |
|---|---|---|
| 10017003 | 404 | cteId no encontrado o no pertenece a la empresa. Verifique el id y el empresaId. |
| 10003000 | 404 | empresaId no encontrado. |
