---
title: "Consulta de información del comprobante electrónico en la DIAN"
method: GET
path: "/get-by-trackid"
tags: ["Dian"]
---

# Consulta de información del comprobante electrónico en la DIAN

`GET /get-by-trackid`

Retorna la información del comprobante electrónico asociado al trackId proporcionado (CUFE, CUNE, CUDE del documento a consultar). Incluye el estado del documento en la DIAN, las notificaciones recibidas, las notas crédito y eventos asociados, así como el XML original enviado.

## Query parameters

- `trackId` string, required

## Response `200`

Respuesta exitosa con información completa del documento consultado por Track ID

- object
  - `trackId` string — Track ID del documento consultado
  - `dianStatus` 'AUTHORIZED' | 'IN_PROCESS' | 'VALIDATION_ERROR' | 'TEST_SET_ERROR' | 'ERROR_89' | 'RETRY_AGAIN' — Estado actual del documento en la DIAN
  - `document` object — Información del documento
    - `documentDate` string — Fecha de emisión del documento
    - `documentNumber` string — Número del documento
    - `statusDescription` string — Descripción del estado del documento
    - `statusMessage` string — Mensaje detallado del estado
    - `currency` string — Moneda del documento
    - `subtotal` number — Subtotal del documento (sin impuestos)
    - `taxTotal` number — Total de impuestos del documento
    - `total` number — Total del documento (incluyendo impuestos)
  - `notifications` object[] — Lista de notificaciones o errores del documento
    - `message` string — Mensaje de la notificación
  - `notes` object — Información de notas de crédito asociadas
    - `errors` string[]
    - `message` string — Mensaje descriptivo del resultado
    - `data` object[] — Lista de notas de crédito
      - `type` string — Tipo de respuesta de la nota
      - `fullNumber` string — Número completo de la nota
      - `cude` string — CUDE de la nota
      - `description` string — Descripción de la nota
      - `date` string — Fecha de la nota
  - `events` object — Información de eventos asociados al documento
    - `errors` string[]
    - `message` string — Mensaje descriptivo del resultado
    - `data` object[] — Lista de eventos
      - `type` string — Tipo de respuesta del evento
      - `fullNumber` string — Número completo del evento
      - `cude` string — CUDE del evento
      - `description` string — Descripción del evento
      - `date` string — Fecha del evento
  - `xmlDocument` object — Documento XML en formato base64 (solo si está disponible)
    - `format` 'base64' — Formato del documento
    - `content` string — Contenido del documento en base64

## Other responses

- `400` — Objeto que representa una respuesta de error por validaciones
- `404` — Respuesta cuando el Track ID no es encontrado en la DIAN
- `500` — Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

---

[API](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/revisions/5fcb0d90e251/schema)
