Novedades

Aquí se anotan los cambios de la API que afectan a quien integra. La versión vigente es v1.

Política de versiones

La versión mayor va en la ruta: /v1.
Dentro de v1 solo hay cambios compatibles: campos nuevos en las respuestas, campos opcionales nuevos en las solicitudes, endpoints nuevos, códigos de error nuevos y valores nuevos en enumeraciones de respuesta. Tu cliente debe tolerar campos y valores que no conoce.
Rompería el contrato, y por eso iría a /v2: quitar o renombrar campos, códigos o rutas; volver obligatorio algo opcional; cambiar tipos o formatos (por ejemplo, de los montos); cambiar el significado de un estado.
Un endpoint o campo que se retire se anuncia con las cabeceras Deprecation y Sunset (RFC 8594) y se mantiene al menos 6 meses.

El contrato de cada versión está en la referencia de la API v1, generada desde el código.

v1 (vigente)

Cambios de comportamiento

Cambios que no tocan la forma del contrato (v1 sigue siendo compatible) pero cambian lo que la API hace con los datos existentes.

El reenvío ya no conserva el escenario forzado del sandbox. Antes, corregir y reenviar un documento (POST .../resubmit) cuya emisión forzó un escenario con la cabecera Foliios-Sandbox-Scenario mantenía ese mismo escenario. Ahora el reenvío se reevalúa desde el contenido corregido (una nota [sandbox:<id>] o un comprador 999000NNN), igual que una emisión nueva. Para forzar un escenario en ese reenvío en particular, el cuerpo de resubmit acepta el campo opcional sandbox_scenario (nunca la cabecera, que un reenvío no lee). Fecha: sin fecha registrada. Ver rechazos y reenvío.
El correo de una factura ya no recuerda la aceptación tácita. El correo que recibe el comprador de una factura ya no trae el recordatorio del plazo de reclamo y de la aceptación tácita (art. 773 del Código de Comercio): la aceptación, los reclamos y su registro en RADIAN son del emisor y del comprador. Ver el marco normativo. 2026-11-05.

Cambios compatibles

Verificación de integración del sandbox. Endpoint nuevo GET /v1/companies/{company_id}/sandbox/integration-check, con la herramienta equivalente get_integration_check en el MCP. Calcula, desde los datos de la empresa, cuatro comprobaciones derivadas y dos declaradas. Solo para claves de sandbox. Ver verificación de integración. Noviembre de 2026.
Campos nuevos en el listado y en el documento. El listado de documentos (GET .../documents) incorpora type, payable_amount, currency, origin, actor y approved_by, y la respuesta de un documento incorpora origin, actor y approved_by. Los cuatro primeros del listado son null en documentos guardados antes de que el listado los llevara. Octubre de 2026.
Series propias de notas crédito y débito. Las notas se numeran con su propia serie (NC y ND) y la API ignora el resolution_id que llegue en ellas: ya no hace falta enviarlo. Si la serie de la empresa no está configurada, la emisión de esa nota responde 409 note_series_not_configured. Ver numeración y series. Fecha: sin fecha registrada.
Catálogo del sandbox versionado. GET /v1/sandbox/scenarios trae su version; la versión vigente del catálogo y de las reglas del sandbox es la del encabezado de la referencia de escenarios.

Sandbox: notificaciones de un documento aceptado

El sandbox devuelve, sin pedir ningún escenario, las notificaciones que la habilitación real de la DIAN dio a documentos aceptados (por ejemplo RUT01), para que un documento aceptado se vea igual en el sandbox y en habilitación. Ver escenarios. Noviembre de 2026.

Cómo enterarte de los cambios

Esta página se actualiza con cada cambio visible de la API.
Las páginas de la referencia generada siempre reflejan el código vigente.
Los agentes pueden leer llms.txt y los .md de cada página, que siempre son la versión actual.