Consultar el listado de resoluciones

Permite consultar el listado de resoluciones registradas, configuradas y asignadas al emisor en el portal de la DIAN, sin especificar previamente un número de resolución.

GET https://micro.conexusit.com/corp/demo/api/Service.svc/ConsultarResolucionList/{guidEmpresa}

Endpoint

Dato	Valor
Método HTTP	GET
Operación	ConsultarResolucionList

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
GuidEmpresa	string	Sí	Identificador único de la empresa cuyas resoluciones se desean consultar.

Ejemplo de solicitud

Ambiente: demostración.

GET https://micro.conexusit.com/corp/demo/api/Service.svc/ConsultarResolucionList/3408859dc7cc426991edcb70220bbfb6

Consultar listado de resoluciones en el ambiente de demostración

Estructura de la respuesta

La respuesta contiene el estado de la operación, el detalle del resultado y la lista de resoluciones obtenidas.

Ejemplo de respuesta

{
  "ConsultarResolucionListResult": {
    "Estado": "OK",
    "DetalleEstado": "Operación completada con Éxito.",
    "Resoluciones": [
      {
        "NumResolucion": "18764097270819",
        "FechaRes": "2025-08-20",
        "Prefijo": "PRP",
        "NumeracionDesde": 700758200,
        "NumeracionHasta": 749999999,
        "ValidaDesde": "2025-08-20",
        "ValidaHasta": "2027-02-20",
        "ClaveTecnica": "<clave técnica de la resolución>"
      }
    ]
  }
}

Campos de la respuesta

Campo	Descripción
Estado	Código del estado de la consulta: OK (consulta exitosa) o Error (error en la consulta).
DetalleEstado	Mensaje descriptivo del resultado de la operación o del error presentado.
Resoluciones	Lista de resoluciones encontradas. Puede venir vacía cuando no hay resultados.

Detalle de las resoluciones

Campo	Descripción
NumResolucion	Número de la resolución DIAN.
FechaRes	Fecha de expedición de la resolución, en formato YYYY-MM-DD.
Prefijo	Prefijo asociado a la resolución.
NumeracionDesde	Número inicial del rango de numeración autorizado.
NumeracionHasta	Número final del rango de numeración autorizado.
ValidaDesde	Fecha de inicio de vigencia de la resolución, en formato YYYY-MM-DD.
ValidaHasta	Fecha de finalización de la vigencia de la resolución, en formato YYYY-MM-DD.
ClaveTecnica	Clave técnica asociada a la resolución, cuando aplica. Es un dato sensible.

Casos de uso

Los métodos de consulta de resoluciones permiten realizar las siguientes operaciones:

• Consultar una resolución específica: verificar la información asociada a un número de resolución.
• Consultar las resoluciones de una empresa: obtener el listado de resoluciones registradas para el emisor.
• Validar un prefijo: consultar la información de una resolución relacionada con un prefijo determinado.
• Verificar rangos de numeración: identificar los límites de numeración autorizados.
• Validar la vigencia: comprobar las fechas de inicio y finalización de la resolución antes de emitir documentos.
• Obtener la clave técnica: recuperar la clave asociada a una resolución cuando sea requerida por el proceso de generación de documentos electrónicos.

Consideraciones importantes

• Identificador de empresa: se debe enviar el GuidEmpresa correspondiente a la empresa que realiza la consulta.
• Resoluciones sin resultados: cuando no existan registros que coincidan con los parámetros enviados, la lista Resoluciones puede venir vacía.
• Vigencia: se recomienda validar las fechas ValidaDesde y ValidaHasta antes de utilizar una resolución para emitir documentos electrónicos.
• Clave técnica: este dato es sensible y debe protegerse, evitando su exposición en registros, mensajes o documentación pública.