---
title: "Endpoint para consultar el progreso de una habilitación inteligente"
method: GET
path: "/test-sets/intelligent/{id}"
tags: ["Sets de pruebas"]
---

# Endpoint para consultar el progreso de una habilitación inteligente

`GET /test-sets/intelligent/{id}`

## Request

- Base URL: `https://sandbox-api.alegra.com/e-provider/col/v1`
- URL: `https://sandbox-api.alegra.com/e-provider/col/v1/test-sets/intelligent/{id}`
- Auth: HTTP bearer

Retorna el estado del proceso de habilitación: alcance, plan de ejecución y estado por documento. Un proceso de otra compañía responde 404, indistinguible de un id inexistente. Nunca devuelve material del token DIAN.

## Path parameters

- `id` string, required

## Response `200`

Progreso del proceso

- object
  - `processId` string
  - `status` 'IN_PROCESS' | 'FINISHED' | 'FAILED'
  - `selectionMode` 'defaultAll' | 'explicit'
  - `requestedDocuments` string[]
  - `attempt` integer
  - `errorCode` string, nullable: Código del error global del proceso (p. ej. DIAN_TOKEN_EXPIRED) cuando falla antes de llegar a algún documento; null en otro caso. Los errores de cada documento van en executionPlan[].errorCode.
  - `errorMessage` string, nullable: Detalle del error global del proceso: el paso que falló y, si aplica, evidencia sanitizada; null en otro caso.
  - `executionPlan` object[]
    - `documentType` 'invoices' | 'supportDocuments' | 'payrolls' | 'pos'
    - `requested` boolean
    - `requiredBy` string, nullable
    - `status` 'PENDING' | 'IN_PROCESS' | 'AUTHORIZED' | 'REJECTED' | 'FAILED'
    - `testSetId` string, nullable: Siempre null para supportDocuments (se habilita por proceso, sin set de pruebas propio).
    - `testSetInitiatedAt` string, nullable: Momento en que el set de pruebas del documento fue enviado al webservice de la DIAN; null mientras no se haya enviado o para supportDocuments.
    - `errorCode` string, nullable
    - `errorMessage` string, nullable
  - `createdAt` string
  - `updatedAt` string
  - `finishedAt` string, nullable

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

## Changes

- **2026-11-03** `2bc52ab55c2b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/changes/test-sets/intelligent/:id/get.md)

---

[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)