---
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`

## Request

- Base URL: `https://sandbox-api.alegra.com/e-provider/col/v1`
- URL: `https://sandbox-api.alegra.com/e-provider/col/v1/get-by-trackid`
- Auth: HTTP bearer

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.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) - [All operations](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/revisions/2bc52ab55c2b?raw)