Saltar al contenido principal

Paso a producción

Léelo entero antes de pulsar nada

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.

DatoDe dónde saleDónde se registra
Certificado digitalLo emite una entidad certificadora, no la DIAN. También se puede comprar desde el panel.Empresas → ⋮ → Configuración, paso 1.
ID y PIN del softwarePortal de habilitación de la DIAN: Configurar modos de operación, modo Software propio.Paso 1 del asistente.
TestSetIdEl 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ónLa 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:

Enlaces Habilitación y Facturando Electrónicamente en dian.gov.co, dentro de Temas de interés, Factura Electrónica

  • 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​

  1. Ya dentro de Habilitación (arriba dice Ambiente de Habilitación), abre el menú Registro y habilitación → Documentos electrónicos.

    Portal de habilitación de la DIAN con el menú Registro y habilitación, Documentos electrónicos

  2. 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.

    Portal de la DIAN con las tarjetas de cada tipo de documento electrónico

  3. Pulsa Configurar modos de operación.

    Portal de la DIAN con el botón Configurar modos de operación

  4. 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.

    Portal de la DIAN: formulario para crear el software y listado de modos de operación con las columnas Id y Pin

El PIN lo inventas tú

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.

Tiene que ser un software propio de la misma empresa

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:

EstadoQué significaQué haces
En procesoFalta enviar el set de pruebas de ese software.Abres el set de pruebas, copias el TestSetId y lo pegas en el asistente.
AceptadoLa DIAN ya aprobó el set de pruebas.No hay TestSetId que enviar: pasas directo a Producción.

Listado de modos de operación de la DIAN con un software En proceso y varios Aceptado, y el icono del ojo señalado

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:

Pantalla Set de pruebas de la DIAN con el aviso amarillo y el TestSetId señalado

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:

Pantalla Set de pruebas de la DIAN con el aviso verde de pruebas superadas, sin TestSetId

En ese caso sigue en Si la DIAN ya aprobó el set de pruebas.

No lo confundas con el ID del software

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.

Parte de abajo de la pantalla Set de pruebas: datos del software y documentos aceptados que exige la DIAN

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.

Pantalla Participantes de la DIAN con la tarjeta Emisor señalada

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

Pantalla Asociar modo de operación de nómina, con el listado de software y las columnas Estado, ID y PIN del SW señaladas

Factura electrónicaNómina electrónica
Columnas del listadoId y PinID y PIN del SW
Estado mientras falta el set de pruebasEn procesoEn pruebas
Estado cuando la DIAN ya lo aprobóAceptadoHabilitado
Documentos aceptados que pide el set1 factura8: 4 nóminas y 4 nóminas de ajuste
Cómo se ve el set ya aprobadoAviso verde, sin TestSetIdEl 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:

Pantalla Emisor de Nómina Electrónica y Nómina de Ajuste con el botón Set de pruebas señalado

El TestSetId está en el aviso amarillo de arriba:

Set de pruebas de nómina con el TestSetId y los 8 documentos aceptados requeridos

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.

Set de pruebas de nómina ya aprobado: el aviso dice Aceptado y sigue mostrando el TestSetId

El asistente de nómina no envía el set de pruebas

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.

Primero la factura

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.

Asociar modo de operación de documento soporte, con el aviso de la DIAN y el listado de software habilitados

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.

Set de pruebas de documento soporte con la resolución SEDS y los documentos requeridos

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

Listado de modos de operación de documentos equivalentes con los estados Habilitado y En pruebas

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:

Pruebas de aceptación con el selector Tipo de documento abierto y Documentos equivalentes POS señalado

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.

Set de pruebas del POS con el TestSetId, la resolución EPOS y un documento aceptado requerido

La resolución EPOS ya viene cargada

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​

Sub-pestaña Paso a Producción con el asistente de tres pasos y el badge Ambiente Habilitación

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.

El PIN del software es una credencial

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.

Paso 2 del asistente con el campo Set de Pruebas DIAN, el botón Iniciar Paso a Producción y la caja de ZipKey anterior

ControlQué hace
Set de Pruebas DIANAquí 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ónArranca el proceso completo. Es el botón que no conviene pulsar hasta estar seguro.
Pasar a Producción sin set de pruebasPara 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 pruebasUna caja aparte para retomar un envío anterior, sin volver a enviar nada.
Consultar ZipKeyRetoma 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:

  1. 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.
  2. Consultar ZipKey — con ese código se le pregunta a la DIAN si ya validó el documento.
  3. 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:

  1. 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.
  2. Pulsa Pasar a Producción sin set de pruebas y confirma con Sí, pasar a Producción.
  3. 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ónQué hace
Consultar ahoraFuerza una consulta inmediata en vez de esperar al siguiente reintento.
DetenerPara la consulta automática. El ZipKey se conserva.
OlvidarBorra 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.

Nunca reenvíes el documento de prueba para desatascar

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.

Si dejas la pantalla abierta horas

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.

Si Consultar no trae nada

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.

Portal de producción de la DIAN: Gestionar Asociación de Prefijos con los campos Proveedor - Software y Prefijo

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ñaCó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 soporteNo 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.
Cada pestaña va por su cuenta

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.

El documento POS de prueba no se envía por correo

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.

Revisa el aviso rojo

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.

Sub-pestaña Paso a Producción de Eventos RADIAN con el selector Estado del Ambiente y el aviso de que falta el software

Ese selector se aplica al instante

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.

Qué necesitas según lo que vayas a hacer​

Los eventos no tienen software propio: usan el software de facturación electrónica de la empresa. Pero no todo lo que hay en la pestaña lo necesita:

Lo que hacesQué necesita
Cambiar el Estado del Ambiente de los eventosNada más. Funciona aunque la empresa no tenga software registrado.
Consultar y descargar facturas recibidas (el extractor, la consulta por CUFE)Solo el certificado digital vigente.
Enviar eventos (acuse de recibo, recibo del bien o servicio, aceptación o rechazo)El ID y el PIN del software de facturación, además del certificado.

Por eso una empresa que factura con otro proveedor y solo usa la plataforma para traerse sus facturas de compra puede trabajar sin registrar software.

Si la empresa no lo tiene registrado, el selector muestra un aviso naranja: Esta empresa no tiene software de facturación configurado. Puede cambiar el ambiente y descargar facturas, pero para enviar eventos debe registrar el ID y el PIN en Ver configuración. El enlace lleva a Completar la configuración, a la pestaña Facturas.

Las demás pestañas sí piden el software

En Factura electrónica, Nómina electrónica, Documento soporte y Documentos equivalentes, cambiar el ambiente sin software sigue respondiendo La empresa no tiene software configurado. Configure el software antes de cambiar el ambiente: ahí la marca de la empresa y la URL de envío del software tienen que moverse juntas.