Paso a producción
El paso a producción con set de pruebas gasta consecutivos reales ante la DIAN: el documento de prueba que se envía consume un número de tu numeración y no se recupera. Al terminar, la empresa deja de facturar en pruebas y cada documento que emita será una factura de verdad. El ambiente se puede devolver a Habilitación, pero lo que la DIAN ya validó en Producción no se deshace.
Este manual se queda en Habilitación: las capturas son del formulario antes de enviar nada. Lee esta página para entender el proceso, no la uses como una lista para ir pulsando botones. El paso real se hace una sola vez, con la empresa ya revisada, el certificado vigente, el software registrado y las resoluciones de producción en la mano.
Qué es y cuándo toca
Mientras la empresa está en Habilitación, todo lo que emite viaja a un entorno de pruebas de la DIAN: sirve para comprobar que la facturación funciona, pero no tiene valor fiscal. Para facturar de verdad, la DIAN pide superar un set de pruebas: te entrega un identificador, tú le envías un documento con él, ella lo valida y entonces te habilita en producción.
El asistente del panel hace ese recorrido por ti. Está en Empresas → ⋮ → Documentos Electrónicos → la pestaña del tipo de documento → Paso a Producción, y cada tipo de documento tiene el suyo: pasar la factura electrónica a producción no pasa la nómina ni el documento soporte.
Antes de empezar necesitas tener listo:
- el certificado digital cargado y vigente;
- el ID y el PIN del software que la DIAN te asignó;
- el TestSetId (identificador del set de pruebas) que la DIAN te entrega;
- las resoluciones de producción ya expedidas por la DIAN.
Si algo de eso falta, lo encuentras en Completar la configuración y en Resoluciones y plantillas.
De dónde sale cada dato en la DIAN
Es donde más se atasca la gente: el asistente pide datos que no están en el panel, sino en el portal de la DIAN.
| Dato | De dónde sale | Dónde se registra |
|---|---|---|
| Certificado digital | Lo emite una entidad certificadora, no la DIAN. También se puede comprar desde el panel. | Empresas → ⋮ → Configuración, paso 1. |
| ID y PIN del software | Portal de habilitación de la DIAN: Configurar modos de operación, modo Software propio. | Paso 1 del asistente. |
| TestSetId | El mismo listado de la DIAN: icono del ojo en la fila del software. | No se guarda: se pega en el paso del set de pruebas. |
| Resolución de numeración | La autoriza la DIAN a la empresa y luego se asocia al software en el portal de producción. | Botón Consultar del último paso. |
| Clave técnica (solo factura) | La entrega la DIAN junto con la resolución, ya en producción. | Llega sola con el botón Consultar. |
Por dónde se entra
Todo empieza en dian.gov.co, bloque Temas de interés → Factura Electrónica. Hay dos enlaces y es fácil confundirlos:

- Habilitación es el portal de pruebas. Aquí se crea el software y se ven el ID, el PIN y el TestSetId, también los de nómina, documento soporte y documentos equivalentes.
- Facturando Electrónicamente es el portal de producción. Solo se usa al final, para asociar el prefijo al software.
El ID y el PIN del software
-
Ya dentro de Habilitación (arriba dice Ambiente de Habilitación), abre el menú Registro y habilitación → Documentos electrónicos.

-
Elige la tarjeta del documento: Factura electrónica, Nómina electrónica, Documento para no obligados a facturar (documento soporte) o Documentos equivalentes (POS). Cada uno tiene su propio software, salvo el documento soporte, que usa el de factura.

-
Pulsa Configurar modos de operación.

-
En Seleccione el modo de operación elige Software propio, escribe un Nombre del software y un Pin del SW de 5 dígitos, y pulsa Asociar. El software queda en el Listado de modos de operación asociados: el ID y el PIN son las columnas Id y Pin de su fila.

La DIAN no asigna el PIN: lo escribes al crear el software, y tiene que ser de exactamente 5 dígitos. Si el software ya aparece en el listado, no crees otro: usa el Id y el Pin que muestra su fila.
El software se crea dentro de la cuenta DIAN del NIT que va a facturar, en modo Software propio. El de un proveedor tecnológico con el que la empresa facturaba en otra plataforma no sirve: hay que asociar uno propio, que tiene su propio estado y su propio set de pruebas. Un software recién creado queda En proceso hasta que se envía su set de pruebas.
En el panel, el paso 1 de cada asistente y la pantalla Completar la configuración tienen un enlace que despliega estos mismos pasos con las capturas.
El TestSetId
Está en el mismo Listado de modos de operación asociados, un poco más abajo en esa pantalla. Ubica la fila de tu software y mira primero su columna Estado:
| Estado | Qué significa | Qué haces |
|---|---|---|
| En proceso | Falta enviar el set de pruebas de ese software. | Abres el set de pruebas, copias el TestSetId y lo pegas en el asistente. |
| Aceptado | La DIAN ya aprobó el set de pruebas. | No hay TestSetId que enviar: pasas directo a Producción. |

El icono del ojo de la columna Acciones abre la pantalla Set de pruebas. Mientras el software está En proceso, el TestSetId aparece en el aviso amarillo ¡Importante! de arriba. Cópialo completo:

Cuando la DIAN ya lo aprobó, el aviso es verde, dice Su empresa ha superado satisfactoriamente las pruebas de validación de su set de pruebas y ya no muestra ningún TestSetId:

En ese caso sigue en Si la DIAN ya aprobó el set de pruebas.
El TestSetId y el Id del software tienen la misma forma (letras y números separados por guiones) y salen del mismo listado, pero el TestSetId solo aparece en la pantalla Set de pruebas. Si pegas el ID del software en el campo del set de pruebas, el asistente te avisa y no envía nada.
El set de pruebas de factura queda aprobado con un solo documento aceptado: la pantalla lo dice en Total de documentos aceptados requeridos (1 factura electrónica, 0 notas débito y 0 notas crédito). Esa factura es la que envía el asistente; no hay que enviar nada más.

Cada software tiene su propio TestSetId, y el panel no lo guarda: solo viaja en el envío del documento de prueba. Esa misma pantalla trae, más abajo, la resolución de pruebas (prefijo SETP, número 18760000001) y, en Información del software, la Identificación (el ID), la Clave técnica y el Pin: sirven para comprobar lo que registraste en el panel.
En nómina electrónica el recorrido cambia
La nómina no pasa por Configurar modos de operación. Al elegir la tarjeta Nómina electrónica se abre Participantes: ahí va Emisor, no Proveedor de servicios tecnológicos.

Después el software se crea en Asociar modo de operación:

| Factura electrónica | Nómina electrónica | |
|---|---|---|
| Columnas del listado | Id y Pin | ID y PIN del SW |
| Estado mientras falta el set de pruebas | En proceso | En pruebas |
| Estado cuando la DIAN ya lo aprobó | Aceptado | Habilitado |
| Documentos aceptados que pide el set | 1 factura | 8: 4 nóminas y 4 nóminas de ajuste |
| Cómo se ve el set ya aprobado | Aviso verde, sin TestSetId | El aviso sigue amarillo y con el TestSetId, pero dice se encuentra Aceptado |
El icono del ojo de la fila abre Emisor de Nómina Electrónica y Nómina de Ajuste. Ahí, el botón Set de pruebas lleva al set de ese software:

El TestSetId está en el aviso amarillo de arriba:

En nómina esa pantalla no cambia a verde cuando la DIAN aprueba el set: sigue amarilla y con el TestSetId. Lo que cambia es el texto, de el set de pruebas se encuentra En proceso a se encuentra Aceptado. Si dice Aceptado (y el listado, Habilitado), no hay nada que enviar.

En la pestaña Nómina electrónica el paso a producción es el selector Estado del Ambiente.
Cambiarlo no reemplaza el set de pruebas: mientras el software siga En pruebas, la DIAN rechaza
lo que se envíe a producción. El set se envía por el API, agregando el TestSetId al final de la
ruta: POST /api/ubl2.1/payroll/{TestSetId} para las nóminas y
POST /api/ubl2.1/payroll-adjust-note/{TestSetId} para las de ajuste. Cuando el software pase a
Habilitado, pon el selector en Producción.
En documento soporte se usa el software de la factura
En la tarjeta Documento para no obligados a facturar no se elige participante: se llega directo a Asociar modo de operación. Ahí eliges Software Propio y pulsas Asociar, y la DIAN asocia sola los software que ya están habilitados para factura electrónica. Por eso el documento soporte lleva el mismo ID y el mismo PIN que la factura: regístralos así en el paso 1 de la pestaña Documento soporte del panel.
Para asociar el documento soporte, la empresa necesita antes un software de factura habilitado en la DIAN (su set de pruebas superado, estado Aceptado): la asociación toma esos software, y sin uno habilitado no hay qué asociar. Si la empresa todavía no lo tiene, haz primero el paso a producción de la factura.

El icono del ojo de la fila abre Pruebas de aceptación, y su botón Set de pruebas muestra el TestSetId y la resolución de pruebas del documento soporte: prefijo SEDS, resolución 18760000001, rango 984000000 a 985000000. Es la que va en el paso 2 Resolución de Habilitación del panel mientras estés en Habilitación.

Como en nómina, cuando el software figura Habilitado en ese listado se pasa a producción con el selector Estado del Ambiente del paso 3.
En documentos equivalentes (POS)
La tarjeta Documentos equivalentes abre directo Asociar modo de operación, sin elegir participante. Ahí se crea un software propio, distinto del de la factura: su ID y su PIN del SW son los del paso 1 de la pestaña Documentos equivalentes del panel. Los estados son los de nómina: En pruebas (falta el set) y Habilitado (aprobado).

El ojo abre Pruebas de aceptación. Antes de nada, en Tipo de documento elige Documentos equivalentes POS: hasta elegirlo, los botones están apagados. Después, Set de pruebas:

El set trae el TestSetId en el aviso amarillo y la resolución de pruebas del POS: prefijo EPOS, resolución 18760000001, rango 1 a 1000000 (no el de la factura). Pide 1 documento aceptado, que es el que envía el asistente.

En el paso 2 Resolución de Habilitación del POS, el panel trae precargada esa resolución de pruebas mientras estés en Habilitación: basta pulsar Guardar. Si falta, Iniciar Paso a Producción te lo avisa sin enviar nada a la DIAN.
Como en nómina, el set aprobado sigue amarillo y con el TestSetId, pero dice Aceptado. En ese caso no lo reenvíes: usa Pasar a Producción sin set de pruebas.
Si la empresa es de un cliente y no tienes su acceso a la DIAN
Esos datos no se pueden sacar de otro lado. Al portal entra el representante legal de la empresa (o la persona natural), y la DIAN le envía el enlace de ingreso al correo registrado en el RUT. Pídele que siga los pasos de arriba y te envíe:
- el Id y el Pin del software;
- el TestSetId, o la confirmación de que el set de pruebas ya figura aprobado;
- la resolución de numeración;
- el certificado digital con su contraseña.
El asistente, paso por paso

Arriba ves la barra de los tres pasos: 1 Configuración de Software, 2 Paso a Producción y 3 Resoluciones de Producción. Los botones Volver y Siguiente de abajo solo te mueven entre pasos dentro de la pantalla; no envían nada a la DIAN. Lo que sí envía es el botón de cada paso.
Fíjate en que el badge de la cabecera sigue diciendo Ambiente: Habilitación. Mientras ponga eso, la empresa está en pruebas.
Paso 1 · Configuración de Software
Dos campos: ID Software y PIN Software, los que la DIAN te dio al registrar tu software. Si la empresa ya los tiene, el panel muestra un aviso verde Ya tienes un software configurado con los valores cargados, y el botón pasa a llamarse Actualizar Software en vez de Crear Software. En ese caso no hay nada que hacer aquí: pulsa Siguiente.
No lo compartas ni lo dejes a la vista en capturas. En este manual aparece oculto.
Paso 2 · El set de pruebas
Es el corazón del proceso y el único punto que gasta consecutivos.

| Control | Qué hace |
|---|---|
| Set de Pruebas DIAN | Aquí pegas el TestSetId que te entregó la DIAN. |
| ¿De dónde saco el TestSetId? | Despliega los pasos del portal de la DIAN, con capturas. |
| Iniciar Paso a Producción | Arranca el proceso completo. Es el botón que no conviene pulsar hasta estar seguro. |
| Pasar a Producción sin set de pruebas | Para cuando la DIAN ya aprobó el set de pruebas del software: cambia el ambiente sin enviar nada. Pide confirmación. |
| ZipKey entregado por la DIAN al enviar el set de pruebas | Una caja aparte para retomar un envío anterior, sin volver a enviar nada. |
| Consultar ZipKey | Retoma el proceso con el ZipKey que escribiste en esa caja. |
Al pulsar Iniciar Paso a Producción se despliegan tres sub-pasos y verás su estado en vivo:
- Enviar Factura de Prueba — el panel emite el documento del set de pruebas y lo manda a la DIAN. Aquí se consume un consecutivo. La DIAN responde con un ZipKey: el acuse de que recibió el envío.
- Consultar ZipKey — con ese código se le pregunta a la DIAN si ya validó el documento.
- Cambiar Ambiente a Producción — solo si la DIAN aprobó, el panel mueve la empresa a producción para ese tipo de documento.
Si la DIAN ya aprobó el set de pruebas
Pasa cuando la empresa ya había hecho las pruebas antes, en otra instalación o en otra época: en el portal de habilitación el software figura en estado Aceptado y, al abrir su set de pruebas, el aviso verde de la DIAN dice Su empresa ha superado satisfactoriamente las pruebas de validación de su set de pruebas y ya no muestra el TestSetId (las capturas están en El TestSetId). No hay nada que enviar ni TestSetId que buscar.
Debajo del botón Iniciar Paso a Producción está el desplegable ¿La DIAN ya aprobó el set de pruebas de este software?. Al abrirlo muestra cómo reconocer el caso, con las capturas de la DIAN, y el ID del software que tienes registrado en el panel:
- Comprueba que ese ID sea el del software que la DIAN muestra como Aceptado. Si el aprobado es otro, registra primero su Id y su Pin en el paso 1.
- Pulsa Pasar a Producción sin set de pruebas y confirma con Sí, pasar a Producción.
- El asistente pasa solo al último paso y la cabecera ya dice Ambiente: Producción, sin recargar la página. Trae las resoluciones con el botón Consultar.
El botón solo cambia el ambiente de ese documento a Producción en el panel: no se envía ningún
documento de prueba a la DIAN, así que no se gasta consecutivo, y no registra resoluciones. Por el API es
PUT /api/ubl2.1/config/environment con {"type_environment_id": 1} (1 es Producción y 2
Habilitación).
El selector de ambiente del último paso
El paso Resoluciones de Producción de Factura electrónica y de Documentos equivalentes empieza con el selector Ambiente (Habilitación o Producción). Hace lo mismo que los botones del paso del set de pruebas, con la misma confirmación, y los tres quedan siempre iguales.
Está ahí porque Consultar trae las resoluciones del ambiente en que está el documento. Si el software ya figura Aceptado en la DIAN pero en el panel la empresa quedó en Habilitación, un aviso amarillo lo dice y basta cambiar el selector para ver las resoluciones reales.
Volver a Habilitación
Cuando el documento ya está en Producción, el paso muestra un aviso verde y el botón Volver a Habilitación, que pide confirmación. Sirve si se pasó por error o si hay que repetir el set de pruebas. Los documentos que la DIAN ya validó en Producción son reales y no se deshacen: se anulan con nota crédito.
Qué es el ZipKey y por qué hay que esperar
La DIAN no valida en el momento: pone tu envío en una cola. Mientras tanto responde que el documento se encuentra en proceso de validación y pide consultar más tarde. Eso no es un error, es el funcionamiento normal, y la espera puede ser de minutos.
El ZipKey es el comprobante de ese envío. El panel lo guarda en tu navegador y vuelve a consultar solo, cada pocos segundos, mostrando el intento en el que va y cuánto lleva esperando. Cuando aparece el ZipKey, tienes tres botones:
| Botón | Qué hace |
|---|---|
| Consultar ahora | Fuerza una consulta inmediata en vez de esperar al siguiente reintento. |
| Detener | Para la consulta automática. El ZipKey se conserva. |
| Olvidar | Borra el ZipKey guardado. Úsalo solo si vas a empezar de cero. |
Si la DIAN tarda demasiado, el panel deja de reintentar y te avisa de que el ZipKey quedó guardado. No se perdió nada: el documento ya está en la DIAN.
Reenviarlo gasta otro consecutivo y no acelera nada. Si cerraste la página o te cansaste de esperar, vuelve más tarde, abre el desplegable ¿Ya tienes el ZipKey de un envío anterior? y pega ahí el ZipKey. Con Consultar ZipKey el asistente retoma desde el paso 2 sin enviar nada nuevo. Además, si al abrir la pantalla queda una consulta pendiente de una sesión anterior, el panel te lo dice y espera a que tú pulses Consultar ahora: no continúa solo, precisamente para no cambiarte el ambiente sin que lo pidas.
Si la DIAN rechaza el documento, el panel muestra los motivos concretos. Eso no se arregla reintentando: hay que corregir lo que señala y volver a enviar.
Es lo normal en este paso: abres el asistente, te vas al portal de la DIAN a sacar el software y el TestSetId, y vuelves mucho después. Mientras la pestaña siga abierta, el panel mantiene viva tu sesión solo, así que Iniciar Paso a Producción y Consultar ZipKey siguen funcionando sin volver a entrar.
Si la sesión sí se perdió (cerraste el navegador, se apagó el equipo), el panel ya no responde con un error técnico: muestra Tu sesión del panel expiró. Recarga la página (F5) e inicia sesión de nuevo para continuar. No se envió nada a la DIAN en este intento. Ese intento no gastó ningún consecutivo y el ZipKey queda guardado: después de entrar de nuevo, continúas con Consultar ahora.
Paso 3 · Resoluciones de producción
Una vez la empresa está en producción, este paso sirve para confirmar qué numeración le tiene asignada la DIAN. El botón Consultar trae las resoluciones asociadas a la empresa y el enlace Vista Previa abre una ayuda con imágenes de dónde encontrar esos datos en el portal de la DIAN.
Las resoluciones que aparezcan hay que registrarlas en el panel para poder emitir con ellas: el botón Crear de cada fila la registra con los datos que entregó la DIAN, incluida la clave técnica. El resto se hace en Resoluciones y plantillas.
Falta asociar el prefijo al software en el portal de Producción de la DIAN, o se asoció a un software distinto del que tienes registrado en el panel. En Configuración → Rangos de numeración, pantalla Gestionar Asociación de Prefijos, elige en Proveedor - Software el software de la empresa (el mismo Id del paso 1) y en Prefijo la numeración, y pulsa Agregar. Después vuelve a pulsar Consultar.

Lo que cambia en cada pestaña
Lo de arriba es la pestaña Factura electrónica. Las demás usan el mismo asistente, con estas diferencias:
| Pestaña | Cómo pasa a producción |
|---|---|
| Documentos equivalentes (POS) | Igual que la factura, con set de pruebas y ZipKey, y con los mismos botones Pasar a Producción sin set de pruebas y Volver a Habilitación. Es el paso 3 de su asistente, y el primer sub-paso se llama Enviar Documento POS de Prueba. |
| Nómina electrónica y Documento soporte | No tienen set de pruebas: su paso 3 es un selector Estado del Ambiente con Habilitación y Producción, que se aplica al instante y sin confirmación, como el de Eventos RADIAN. |
Todas las pestañas están en la misma pantalla, pero cada asistente es independiente: el set de pruebas, el ZipKey y el selector de ambiente que ves en una pestaña solo afectan a su tipo de documento. Antes, el asistente de Documentos equivalentes respondía Petición inválida al pulsar Iniciar Paso a Producción y el selector de Documento soporte cambiaba el ambiente de la nómina; las dos cosas ya están corregidas.
Igual que los de factura y nómina, el documento que arma el panel para el set de pruebas va con el correo desactivado: nadie recibe nada y un SMTP mal configurado ya no corta el envío antes de llegar a la DIAN.
Cómo saber que ya estás en producción
El badge de la cabecera pasa de Ambiente: Habilitación (amarillo) a Ambiente: Producción (verde), y los documentos nuevos salen marcados como de Producción en el listado.
Si junto al badge aparece uno rojo del tipo Envía a Habilitación, la marca de la empresa y la de su software no coinciden. Manda lo que diga el software. Antes de emitir nada, resuelve esa diferencia; está explicado en Documentos electrónicos.
El caso aparte: Eventos RADIAN
La pestaña Eventos RADIAN también tiene una sub-pestaña Paso a Producción, pero no es un asistente: los eventos no tienen set de pruebas ni un software aparte. Lo único que hay es un selector Estado del Ambiente con las opciones Habilitación y Producción.

No hay botón de confirmación: en cuanto cambias la opción, el cambio queda guardado. Y decide contra qué entorno de la DIAN trabaja el extractor de documentos de compra. No lo toques para mirar.