Consultar una resolución por prefijo

Permite consultar una resolución específica y obtener la información correspondiente a un prefijo determinado.

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

Endpoint

Dato	Valor
Método HTTP	GET
Operación	ConsultarResolucionPrefijo

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
NumeroResolucion	string	Sí	Número de la resolución que se desea consultar.
GuidEmpresa	string	Sí	Identificador único de la empresa que realiza la consulta.
Prefijo	string	Sí	Prefijo asociado a la resolución que se desea consultar.

Ejemplo de solicitud

Ambiente: demostración.

GET https://micro.conexusit.com/corp/demo/api/Service.svc/ConsultarResolucionPrefijo/18764041258740/3408859dc7cc426991edcb70220bbfb6/FEV

Consultar resolución por prefijo 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

{
  "ConsultarResolucionPrefijoResult": {
    "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.