---
title: "Endpoint para iniciar la habilitación inteligente ante la DIAN"
method: POST
path: "/test-sets/intelligent"
tags: ["Sets de pruebas"]
---

# Endpoint para iniciar la habilitación inteligente ante la DIAN

`POST /test-sets/intelligent`

## 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`
- Auth: HTTP bearer

Recibe la URL de token del portal de habilitación DIAN y crea (o reanuda, según las reglas de alcance) un proceso que habilita los tipos de documento solicitados. Si se omite `documents` se habilitan los cuatro tipos. Responde 202 con el plan de ejecución resuelto; el token se trata como secreto y nunca se persiste ni se devuelve.

## Request body

- object
  - `tokenDIAN` string, uri, required: URL de AuthToken del portal de habilitación DIAN. Solo se acepta https://catalogo-vpfe-hab.dian.gov.co/User/AuthToken con los parámetros rk y token.
  - `documents` string[]: Tipos de documento a habilitar. Omitido = los cuatro tipos. No admite vacío, duplicados ni valores fuera del enum.
  - `companyId` string, required: Compañía objetivo del proceso de habilitación. Obligatorio.

## Response `202`

Proceso creado, reanudado o proceso activo idéntico devuelto

- object
  - `processId` string
  - `status` 'IN_PROCESS' | 'FINISHED' | 'FAILED'
  - `selectionMode` 'defaultAll' | 'explicit'
  - `requestedDocuments` string[]
  - `executionPlan` object[]
    - `documentType` 'invoices' | 'supportDocuments' | 'payrolls' | 'pos'
    - `requested` boolean
    - `requiredBy` string, nullable
  - `attempt` integer
  - `createdAt` string

## Other responses

- `400`: INVALID_DIAN_TOKEN_FORMAT, INVALID_DOCUMENTS o COMPANY_DIAN_MISMATCH
- `409`: CONCURRENT_ENABLEMENT o ENABLEMENT_SCOPE_CONFLICT (incluye activeProcessId)
- `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/post.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)