---
title: "Endpoint para consultar una nota crédito electrónica"
method: GET
path: "/credit-notes/{id}"
tags: ["Notas Crédito electrónicas"]
---

# Endpoint para consultar una nota crédito electrónica

`GET /credit-notes/{id}`

Retorna toda la información asociada a la nota crédito electrónica enviada como parámetro

## Path parameters

- `id` string, required

## Response `200`

Objeto que representa la respuesta cuando se envía una nota crédito electrónica a la DIAN

- object
  - `creditNote` object
    - `id` string — Id de nota crédito electrónica
    - `date` string, date-time — Fecha de emisión de nota crédito electrónica
    - `status` 'REGISTERED' | 'WAITING_RESPONSE' | 'FAILED' | 'SENT' — Estado de la nota crédito electrónica
    - `legalStatus` 'ACCEPTED' | 'ACCEPTED_WITH_OBSERVATIONS' | 'REJECTED' — Estado legal de la nota crédito electrónica ante la DIAN
    - `companyIdentification` string — Identificación de la empresa empleadora
    - `customerIdentification` string — Identificación del empleado
    - `cude` string — Código único de nota crédito electrónica asignado para el documento
    - `prefix` string — Prefijo de nota crédito electrónica
    - `number` number, double — Número de nota crédito electrónica
    - `fullNumber` string — Número de nota crédito electrónica (Incluye prefijo y número)
    - `governmentResponse` object — Objeto con información de la respuesta de la DIAN
      - `code` string — Código de respuesta de la DIAN
      - `message` string — Mensaje de respuesta de la DIAN
      - `errorMessages` string[] — Array con mensajes de error devueltos por la DIAN
    - `xmlFileName` string — Nombre del archivo XML que se envió a la DIAN
    - `zipFileName` string — Nombre del archivo Zip que se envió a la DIAN
    - `qrCodeContent` string — Contenido para la construcción del Código QR
    - `errors` object[] — Array con mensajes de error generados en el sistema
      - `code` string — Código de error
      - `message` string — Mensaje de error
  - `files` object
    - `xml` string — Link de descarga a el XML que se envia a la DIAN. Este enlace solo dura por 60 minutos, para renovar el link solicite nuevamente el documento.
    - `attachedDocument` string — Link de descarga a el AttachedDocument obetenido como respuesta de al DIAN al enviar el archivo XML. Este campo solo se añade al tener una respuesta de la DIAN. Este enlace solo dura por 60 minutos, para renovar el link solicite nuevamente el documento.
    - `zip` string — Link de descarga a el Zip obetenido como respuesta de al DIAN al enviar el archivo XML. Este campo solo se añade al tener una respuesta de la DIAN, es generado de forma asincrona, puede tardar hasta 1 minuto en estar disponible. Este enlace solo dura por 60 minutos, para renovar el link solicite nuevamente el documento.

## Other responses

- `400` — Objeto que representa una respuesta de error por validaciones
- `404` — Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder
- `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/versions/5fcb0d90e251/schema)