Saltar a contenido

Retención: opción por opción

Volver a Todos los menús · Guía del proceso

Estado: PARCIAL. Referencia de acciones, vistas y campos del código fusionado 067ec7a21cf049451cd349ae473e872883f98e77. Los ejemplos de esta página son propuestas sintéticas, no ejecuciones ni resultados obtenidos. La sesión actual no permite comprobar todos estos menús. No confundir esta referencia con un tutorial visual ya terminado.

Responsabilidades: Operador consulta fuentes; administración y revisión contable atienden los controles que les corresponden. La restricción que se muestra por nodo no reemplaza la comprobación de permisos del usuario ni autoriza a concedérselos.

Cómo seguir un ejemplo

Ir directamente a una opción:

Use exclusivamente Development y la compañía InfoCenter Ejemplo Colombia, con Ana (salario mínimo) y Luis (3.500.000 COP), agosto de 2026, como se prepara en Mi primera nómina. Los casos especiales (retiro, incapacidad, compensación, litigio) son ejemplos separados: no altere el mes ordinario para fabricarlos. Si falta el dato o la sesión, no pulse acciones para rellenar la guía.

En cada ficha, datos obligatorios de lectura significa que los exige el artefacto, no que deban teclearse. La tabla muestra campos declarados en modelos/vistas BPS; no certifica todas las validaciones de negocio ni resuelve la interfaz nativa o heredada completa. Los botones pueden depender del estado, grupos y vista seleccionada: se enumeran para reconocerlos, no como permiso de ejecución.

Ruta: Nómina BPS → Retención.

Es un contenedor de navegación, no genera un registro ni calcula importes. Ábralo y elija la opción según la tarea:

Ejemplo: para consultar Retención BPS, despliegue esta ruta y siga la ficha enlazada. Si no aparece, el PO comprueba sesión y compañía; no se cambia el rol para fotografiar el menú.

Dos imágenes requeridas — pendientes: A, contenedor expandido con sus opciones; B, siguiente nivel o pantalla de destino con la ruta reconocible. No contar dos tamaños de la misma imagen como dos etapas.

Acceso declarado: Operador de nómina / Administrador BPS / Auditor de nómina Fuente: bps_nomina_app_menus.xml.

Ruta: Nómina BPS → Retención → Retención BPS.

Es un contenedor de navegación, no genera un registro ni calcula importes. Ábralo y elija la opción según la tarea:

Ejemplo: para consultar Depuraciones (Proc. 1), despliegue esta ruta y siga la ficha enlazada. Si no aparece, el PO comprueba sesión y compañía; no se cambia el rol para fotografiar el menú.

Dos imágenes requeridas — pendientes: A, contenedor expandido con sus opciones; B, siguiente nivel o pantalla de destino con la ruta reconocible. No contar dos tamaños de la misma imagen como dos etapas.

Acceso declarado: Operador de nómina / Administrador BPS / Auditor de nómina Fuente: retencion_views.xml, bps_nomina_app_menus.xml.

Ruta: Nómina BPS → Retención → Retención BPS → Activar calendario Proc. 2.

Para qué sirve: Activar el calendario legal mensual del Procedimiento 2 (ET art. 386).

Ejemplo explicado: Prepara la compañía y vigencia del calendario; la activación debe ser del administrador autorizado y no sustituye la historia necesaria para calcularlo.

Entrada y pasos:

  1. Abra la ruta anterior y revise el título Activar calendario Proc. 2 de la ventana.
  2. Compruebe compañía/alcance y complete los datos de entrada que se indican abajo. No sustituya referencias inexistentes por otras de un período distinto.
  3. Lea los controles declarados y las precondiciones de la guía del proceso antes de confirmar. Si corresponde a secretos, aprobación, pago o acción externa, deténgase.
  4. Solo después de una ejecución local autorizada, revise el resultado o bloqueo y conserve su identificador. En esta ficha ese resultado sigue sin ejecutar.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Compania Obligatorio InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
Ano gravable Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Fuente normativa Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.

Controles que puede encontrar

Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.

Control Restricción / lectura segura
Activar calendario Revisar precondiciones y estado en la guía; no ejecutado por esta ficha.
Cancelar Salir del asistente sin ejecutar su operación.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ventana de entrada con campos y alcance; B, resultado o bloqueo posterior con explicación. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Acumulado anual.

Para qué sirve: Control anual acumulado tecnico de retencion.

Ejemplo explicado: Revisa el año 2026 y meses incluidos de Luis. Un acumulado de un mes no demuestra que todo el año esté conciliado.

Entrada y pasos:

  1. Abra la ruta y verifique Acumulado anual (retención). Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. No se localizó una ficha de detalle BPS independiente para esta acción; se debe confirmar la vista efectiva.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio en la traza; lectura Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Ano Obligatorio en la traza; lectura Contrastar con la fuente; no sobrescribir.
Meses acumulados Calculado / lectura Contrastar con la fuente; no sobrescribir.
Deducciones acumuladas (art. 387) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Rentas exentas acumuladas Calculado / lectura Contrastar con la fuente; no sobrescribir.
Base gravable acumulada Calculado / lectura Contrastar con la fuente; no sobrescribir.
Retencion acumulada Calculado / lectura Contrastar con la fuente; no sobrescribir.
Control productivo real pendiente Calculado / lectura Este acumulador SUMA las trazas del anio, pero el control productivo real (comparar contra el tope anual y LIMITAR el periodo siguiente) depende del motor de recibo, que NO existe: PENDIENTE. No se aplica recorte aqui.
Compania Obligatorio en la traza; lectura InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Sin restricción adicional en este nodo; siguen aplicando ancestros, ACL y reglas. No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Acumulados F220.

Para qué sirve: Acumulado anual por concepto Formulario 220.

Ejemplo explicado: Rastrea el acumulado de una casilla a sus conceptos del año; distingue cobertura incompleta de un cero probado.

Entrada y pasos:

  1. Abra la ruta y verifique Acumulados por concepto F220. Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Compañía Obligatorio en la traza; lectura InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
Empleado Obligatorio en la traza; lectura Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
anio Obligatorio en la traza; lectura Contrastar con la fuente; no sobrescribir.
version Obligatorio en la traza; lectura Contrastar con la fuente; no sobrescribir.
estado Obligatorio en la traza; lectura Valor de lectura: comprobar el estado o clasificación que dejó el proceso.
fuente estado Obligatorio en la traza; lectura Valor de lectura: comprobar el estado o clasificación que dejó el proceso.
hash fuente Calculado / lectura Contrastar con la fuente; no sobrescribir.
soporte id Obligatorio en la traza; lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
fuente detalle Calculado / lectura Contrastar con la fuente; no sobrescribir.
linea ids Calculado / lectura Contrastar con la fuente; no sobrescribir.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Aplicaciones mensuales.

Para qué sirve: Aplicacion mensual tecnica de retencion.

Ejemplo explicado: Busca Ana/Luis y agosto de 2026 y abre su traza, incluso si el valor es cero. H-8 mantiene bloqueada la creación mensual por interfaz en el corte documentado; no hay botón Nuevo que la sustituya.

Entrada y pasos:

  1. Abra la ruta y verifique Aplicaciones mensuales (retención). Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio en la traza; lectura Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Periodo Obligatorio en la traza; lectura Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige.
Procedimiento aplicado Obligatorio en la traza; lectura Valor de lectura: comprobar el estado o clasificación que dejó el proceso.
Base aplicada Calculado / lectura Contrastar con la fuente; no sobrescribir.
Porcentaje aplicado (%) Calculado / lectura Solo en Procedimiento 2: porcentaje fijo del corte aplicado a la base.
Retencion aplicada Calculado / lectura Contrastar con la fuente; no sobrescribir.
Compania Obligatorio en la traza; lectura InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
Depuracion del mes Calculado / lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
Porcentaje fijo (Proc.2) Calculado / lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
Calendario Proc.2 sin resolver Calculado / lectura True cuando una aplicacion Proc.2 no tiene calendario legal mensual activo/vigente, no pudo resolver el corte gobernante o falta el Proc.2 de ese corte. False cuando el calendario resolvio el corte; en Proc.1 no aplica.
Pago/recibo pendiente Calculado / lectura Esta traza NO afecta el pago ni crea linea de recibo: es capa tecnica.
Motivo del procedimiento Calculado / lectura Por que se aplica este procedimiento (el determinado en el contrato).
Fuente / memoria Calculado / lectura Contrastar con la fuente; no sobrescribir.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Sin restricción adicional en este nodo; siguen aplicando ancestros, ACL y reglas. No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Beneficios tributarios.

Para qué sirve: Beneficio tributario del empleado para retencion.

Ejemplo explicado: Revisa un beneficio sintético con soporte, vigencia y límite; no crees un dependiente real ni datos de salud para enseñar el formulario.

Entrada y pasos:

  1. Abra la ruta y verifique Beneficios tributarios. Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. Revise los datos de la ficha. La presencia de un formulario no acredita permiso para crear/modificar: siga el flujo de la guía del proceso y la sesión autorizada.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Tipo Obligatorio Elegir una opción del catálogo de la pantalla.
Valor mensual No marcado obligatorio en esta declaración Valor mensual solicitado (en pesos).
Vigente desde Obligatorio Fecha coherente con el hecho o vigencia del registro.
Vigente hasta No marcado obligatorio en esta declaración Fecha coherente con el hecho o vigencia del registro.
Soporte No marcado obligatorio en esta declaración Adjunto de soporte (metadato). Obligatorio: la DIAN puede exigirlo al agente retenedor. No se almacena informacion sensible adicional.
Activo No marcado obligatorio en esta declaración No marcar la casilla sin cumplir y demostrar su condición.
Compania Obligatorio InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
Fuente / nota No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Sin restricción adicional en este nodo; siguen aplicando ancestros, ACL y reglas. No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Calendario Proc. 2 (art. 386).

Para qué sirve: Calendario legal mensual del Procedimiento 2 (ET art. 386).

Ejemplo explicado: Revisa los cortes y períodos del calendario activo, distinguiendo cálculo del porcentaje y aplicación mensual.

Entrada y pasos:

  1. Abra la ruta y verifique Calendario Proc. 2 (art. 386). Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Ano gravable Obligatorio en la traza; lectura Contrastar con la fuente; no sobrescribir.
Vigente Calculado / lectura Casilla de lectura: comprobar la condición calculada por el proceso.
Meses de corte Calculado / lectura Meses de corte semestral leidos del catalogo fuenteado al activar (ET art. 386): tipicamente 6 (junio) y 12 (diciembre).
Meses de aplicacion Calculado / lectura Numero de meses siguientes a los que se aplica el porcentaje del corte (ET art. 386: seis).
Activado el Calculado / lectura Contrastar con la fuente; no sobrescribir.
Compania Obligatorio en la traza; lectura InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
Activado por Calculado / lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
Fuente normativa Obligatorio en la traza; lectura Fuente con la que la compania adopta el calendario del Proc.2 para el ano gravable (ET art. 386 y su reglamentacion). Obligatoria: sin fuente no se activa.

Controles que puede encontrar

Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.

Control Restricción / lectura segura
Desactivar calendario Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Revoca el calendario (motivo obligatorio, auditado HU-002). Sin calendario vigente la retención del Proc.2 vuelve a fail-closed (no consumible).
Reactivar calendario Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Reactiva el calendario declarando de nuevo la fuente; se revalidan los parámetros del art. 386 (fail-closed).

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Sin restricción adicional en este nodo; siguen aplicando ancestros, ACL y reglas. No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Catálogo casillas Formulario 220.

Para qué sirve: Catalogo oficial de casillas Formulario 220.

Ejemplo explicado: Busca una casilla por número y año/formato, y lee su definición antes de asignarle un concepto.

Entrada y pasos:

  1. Abra la ruta y verifique Catálogo oficial Formulario 220. Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Casilla Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Nombre oficial Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Seccion Obligatorio Elegir una opción del catálogo de la pantalla.
Modelo fuente Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Campo/fuente Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Cobertura local Obligatorio Elegir una opción del catálogo de la pantalla.
Pagina/seccion Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
activo No marcado obligatorio en esta declaración No marcar la casilla sin cumplir y demostrar su condición.
Version Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Tipo de dato Obligatorio Elegir una opción del catálogo de la pantalla.
Condicion Obligatorio Elegir una opción del catálogo de la pantalla.
Obligatoria en el borrador No marcado obligatorio en esta declaración Ausencia del dato bloquea la cobertura local cuando la casilla aplica.
Redondear al millar No marcado obligatorio en esta declaración Aplica el redondeo del instructivo oficial a valores monetarios.
Codigo de fuente BPS Obligatorio Clave tecnica resuelta por el evaluador. No contiene un valor normativo.
Periodo Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Dominio oficial No marcado obligatorio en esta declaración Valores oficiales separados por coma. Vacio cuando no aplica dominio.
Mapeo fuente -> valor oficial No marcado obligatorio en esta declaración Pares fuente:oficial separados por coma. Permite transformar una clave tecnica Odoo con datos fuenteados, sin quemar el dominio en Python.
Vigente desde Obligatorio Fecha coherente con el hecho o vigencia del registro.
Formula / regla Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Fuente normativa Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
URL oficial Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Control anual de retención.

Para qué sirve: Control anual acumulado real de retencion.

Ejemplo explicado: Compara el control del año con las aplicaciones mensuales y sus diferencias. No apruebes el cierre interno si quedan meses sin justificar.

Entrada y pasos:

  1. Abra la ruta y verifique Control anual de retención. Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio en la traza; lectura Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Ano gravable Obligatorio en la traza; lectura Contrastar con la fuente; no sobrescribir.
Estado Obligatorio en la traza; lectura preparado: evaluacion completa sin excedentes. con_advertencias: evaluacion con excedentes, conceptos no evaluables o meses sin traza. bloqueado_fuente: falta una clave/UVT vigente (no se inventa el tope). aprobado: cerrado por decision humana; totalmente inmutable.
Meses con depuracion Calculado / lectura Contrastar con la fuente; no sobrescribir.
Excedente anual total Calculado / lectura Suma de los excedentes sobre topes anuales detectados. Es el AJUSTE ESPERADO que la revision humana debe resolver antes del cierre: el control NO recalcula ni corrige retenciones.
Evaluacion completa Calculado / lectura True si TODOS los conceptos anuales quedaron evaluados contra su tope fuenteado (ninguno sin fuente ni sin desglose). Los excedentes NO la invalidan: son el hallazgo reportado.
Consumible para soporte anual Calculado / lectura True SOLO tras la aprobacion humana (H1 auditoria PR #105) de un control con evaluacion completa y sin bloqueo de fuente: los excedentes y advertencias exigen revision humana ANTES de que el soporte anual productivo (HU-071B) lo referencie. Un control recien generado o regenerable NUNCA es consumible. NO habilita el Procedimiento 2 por si mismo: la consumibilidad del Proc.2 la decide su calendario legal mensual (ET art. 386) segun este activo/vigente (DA-2026-06-20-018).
N. advertencias Calculado / lectura Contrastar con la fuente; no sobrescribir.
Compania Obligatorio en la traza; lectura InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
UVT del ano Calculado / lectura Contrastar con la fuente; no sobrescribir.
Generado/actualizado el Calculado / lectura Contrastar con la fuente; no sobrescribir.
Desglose AFC/25% disponible Calculado / lectura True si todas las depuraciones del ano con rentas exentas desglosan AFC vs 25% (trazas nuevas). Sin desglose, los conceptos 206-10 y 126 no son evaluables (depuraciones historicas).
Aplicaciones Proc.2 en el ano Calculado / lectura True si el ano tiene aplicaciones del Procedimiento 2. Este control NO habilita el Proc.2 por si mismo: su consumibilidad la decide el calendario legal mensual (ET art. 386) segun este activo/vigente (DA-2026-06-20-018).
Conceptos evaluados Calculado / lectura Contrastar con la fuente; no sobrescribir.
Ingresos del ano Calculado / lectura Contrastar con la fuente; no sobrescribir.
Ingreso neto del ano (tras INCR) Calculado / lectura Suma de max(ingresos - INCR, 0) de las depuraciones del ano: base anual del limite porcentual del art. 336.
Deducciones acumuladas (art. 387) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Rentas exentas acumuladas Calculado / lectura Contrastar con la fuente; no sobrescribir.
AFC/voluntarias acumuladas Calculado / lectura Contrastar con la fuente; no sobrescribir.
Renta exenta 25% acumulada Calculado / lectura Contrastar con la fuente; no sobrescribir.
Recorte mensual ya aplicado (art. 336) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Retencion acumulada Calculado / lectura Contrastar con la fuente; no sobrescribir.
Aprobado por Calculado / lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
Aprobado en Calculado / lectura Contrastar con la fuente; no sobrescribir.
Soporte de la aprobacion (referencia) Calculado / lectura Referencia documental interna (acta, radicado): no contenido sensible.
Motivo de la aprobacion Calculado / lectura Contrastar con la fuente; no sobrescribir.
Advertencias Calculado / lectura Excedentes, conceptos no evaluables, meses sin traza y limites declarados. Honestas: contextualizan la evaluacion para la revision humana.
Depuraciones incluidas Calculado / lectura Contrastar con la fuente; no sobrescribir.
Fuente / memoria Calculado / lectura Contrastar con la fuente; no sobrescribir.

Controles que puede encontrar

Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.

Control Restricción / lectura segura
Actualizar control Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Regenera la evaluacion desde las depuraciones persistidas del ano. Un control aprobado es inmutable.
Aprobar (cierre interno) Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Decision humana con motivo y soporte documental. Un control bloqueado por fuente no es aprobable. NO es el Formulario 220 oficial.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Datos gobernados F220.

Para qué sirve: Dato gobernado para casillas Formulario 220.

Ejemplo explicado: Revisa un dato anual que no llega automáticamente desde nómina, con fuente y responsable. No agregues una cantidad para hacer coincidir un certificado.

Entrada y pasos:

  1. Abra la ruta y verifique Datos gobernados F220. Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Compañía Obligatorio InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
Empleado No marcado obligatorio en esta declaración Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
anio Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Periodo certificacion desde No marcado obligatorio en esta declaración Fecha coherente con el hecho o vigencia del registro.
Periodo certificacion hasta No marcado obligatorio en esta declaración Fecha coherente con el hecho o vigencia del registro.
lugar retencion No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.
activo No marcado obligatorio en esta declaración No marcar la casilla sin cumplir y demostrar su condición.
vigencia desde Obligatorio Fecha coherente con el hecho o vigencia del registro.
vigencia hasta No marcado obligatorio en esta declaración Fecha coherente con el hecho o vigencia del registro.
version contrato id No marcado obligatorio en esta declaración Seleccionar la referencia correcta, no escribir un identificador inventado.
codigo dane departamento No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.
codigo dane municipio No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.
primer apellido agente No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.
segundo apellido agente No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.
primer nombre agente No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.
otros nombres agente No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.
fuente dato Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
fuente url Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
fuente dane divipola No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Depuraciones (Proc. 1).

Para qué sirve: Depuracion tecnica de retencion Procedimiento 1.

Ejemplo explicado: Consulta la depuración de un período y rastrea ingresos, deducciones, exenciones, UVT y tabla. No escribas retención cero para sortear una traza ausente.

Entrada y pasos:

  1. Abra la ruta y verifique Depuraciones de retención (Proc. 1). Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio en la traza; lectura Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Periodo Obligatorio en la traza; lectura Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige.
UVT del periodo Calculado / lectura Contrastar con la fuente; no sobrescribir.
Compania Obligatorio en la traza; lectura InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
Ingresos Calculado / lectura Contrastar con la fuente; no sobrescribir.
INCR (aportes trabajador) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Deducciones (art. 387) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Rentas exentas Calculado / lectura Contrastar con la fuente; no sobrescribir.
Recorte por limite global (art. 336) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Base gravable Calculado / lectura Contrastar con la fuente; no sobrescribir.
Base gravable (UVT) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Retencion Calculado / lectura Contrastar con la fuente; no sobrescribir.
Control anual acumulado pendiente Calculado / lectura El control anual acumulado de topes (206-10, 336, 126) por empleado queda PENDIENTE: depende del motor productivo de recibo (historico del ano).
Pasos Calculado / lectura Contrastar con la fuente; no sobrescribir.
Fuente Calculado / lectura Contrastar con la fuente; no sobrescribir.
Explicacion tecnica Calculado / lectura Explicacion SOLO LECTURA de los pasos, fuentes, beneficios aplicados/limitados y motivos de PENDIENTE de esta depuracion (HU-070A). No persiste datos adicionales: se deriva de la traza inmutable.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Sin restricción adicional en este nodo; siguen aplicando ancestros, ACL y reglas. No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Expedientes Formulario 220.

Para qué sirve: Expediente Formulario 220 para revision contable.

Ejemplo explicado: Revisa un borrador con su matriz de casillas y faltantes; la revisión contable y la expedición no se sustituyen por exportar un PDF.

Entrada y pasos:

  1. Abra la ruta y verifique Expedientes Formulario 220. Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio en la traza; lectura Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Ano gravable Obligatorio en la traza; lectura Contrastar con la fuente; no sobrescribir.
Gate del borrador Obligatorio en la traza; lectura Valor de lectura: comprobar el estado o clasificación que dejó el proceso.
Revision contable Obligatorio en la traza; lectura Valor de lectura: comprobar el estado o clasificación que dejó el proceso.
Casillas disponibles Calculado / lectura Contrastar con la fuente; no sobrescribir.
Pendientes de dato Calculado / lectura Contrastar con la fuente; no sobrescribir.
Pendientes de fuente/acumulado Calculado / lectura Contrastar con la fuente; no sobrescribir.
Diferencias Calculado / lectura Contrastar con la fuente; no sobrescribir.
Compania Obligatorio en la traza; lectura InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
Limite de alcance Calculado / lectura Contrastar con la fuente; no sobrescribir.
Soporte anual fuente Obligatorio en la traza; lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
Snapshot acumulado F220 Calculado / lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
Folio tecnico interno Calculado / lectura Identificador interno del expediente. No es ni llena la casilla 4 del Formulario 220 oficial.
Número de formulario Calculado / lectura Consecutivo local gobernado del certificado expedido por el empleador. Solo se asigna cuando las demás casillas aplicables ya están completas.
Version Formulario 220 Calculado / lectura Contrastar con la fuente; no sobrescribir.
Moneda Calculado / lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
Certificado oficial emitible Calculado / lectura Siempre False en HU-071F: la aprobacion del expediente no habilita el certificado oficial DIAN.
Casillas evaluadas Calculado / lectura Contrastar con la fuente; no sobrescribir.
Matriz de casillas Calculado / lectura Contrastar con la fuente; no sobrescribir.
Generado el Calculado / lectura Contrastar con la fuente; no sobrescribir.
Generado por Calculado / lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
SHA256 matriz Calculado / lectura Contrastar con la fuente; no sobrescribir.
Referencia de valores esperados Calculado / lectura Referencia de la hoja/validacion contable cuando se comparan valores externos. No contiene datos personales ni el archivo.
Fuente / memoria Calculado / lectura Contrastar con la fuente; no sobrescribir.
Aprobado por Calculado / lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
Aprobado el Calculado / lectura Contrastar con la fuente; no sobrescribir.
Soporte de aprobacion Calculado / lectura Referencia interna al acta/radicado de revision. No pegue datos sensibles.
Motivo de aprobacion Calculado / lectura Contrastar con la fuente; no sobrescribir.

Controles que puede encontrar

Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.

Control Restricción / lectura segura
Aprobar revisión contable Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Registra motivo, responsable y soporte. No habilita el certificado DIAN.
Exportar XLSX Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Expediente reproducible para revision. NO certificado oficial.
Exportar PDF Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Expediente reproducible para revision. NO certificado oficial.
Descargar certificado F220 No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Operador de nómina / Administrador BPS. Entrega local del empleador al trabajador. Solo aparece con todas las casillas aplicables completas y revisión contable aprobada.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Generar control anual.

Para qué sirve: Generar/actualizar control anual de retencion.

Ejemplo explicado: Selecciona año y alcance del ejemplo y revisa el control generado/actualizado, sin confundir actualización del informe con reparación de aplicaciones.

Entrada y pasos:

  1. Abra la ruta anterior y revise el título Generar control anual de la ventana.
  2. Compruebe compañía/alcance y complete los datos de entrada que se indican abajo. No sustituya referencias inexistentes por otras de un período distinto.
  3. Lea los controles declarados y las precondiciones de la guía del proceso antes de confirmar. Si corresponde a secretos, aprobación, pago o acción externa, deténgase.
  4. Solo después de una ejecución local autorizada, revise el resultado o bloqueo y conserve su identificador. En esta ficha ese resultado sigue sin ejecutar.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Ano gravable Obligatorio Ano gravable a evaluar (por defecto, el anterior).

Controles que puede encontrar

Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.

Control Restricción / lectura segura
Generar/actualizar Revisar precondiciones y estado en la guía; no ejecutado por esta ficha.
Cancelar Salir del asistente sin ejecutar su operación.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ventana de entrada con campos y alcance; B, resultado o bloqueo posterior con explicación. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Generar soporte anual.

Para qué sirve: Generar soporte anual productivo de retencion.

Ejemplo explicado: Selecciona trabajador, compañía y año en la ventana; genera el soporte interno y comprueba qué períodos se incluyeron.

Entrada y pasos:

  1. Abra la ruta anterior y revise el título Generar soporte anual de la ventana.
  2. Compruebe compañía/alcance y complete los datos de entrada que se indican abajo. No sustituya referencias inexistentes por otras de un período distinto.
  3. Lea los controles declarados y las precondiciones de la guía del proceso antes de confirmar. Si corresponde a secretos, aprobación, pago o acción externa, deténgase.
  4. Solo después de una ejecución local autorizada, revise el resultado o bloqueo y conserve su identificador. En esta ficha ese resultado sigue sin ejecutar.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Ano Obligatorio Ano gravable a consolidar (por defecto, el anterior).

Controles que puede encontrar

Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.

Control Restricción / lectura segura
Generar soporte Revisar precondiciones y estado en la guía; no ejecutado por esta ficha.
Cancelar Salir del asistente sin ejecutar su operación.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ventana de entrada con campos y alcance; B, resultado o bloqueo posterior con explicación. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Matriz de reglas F220.

Para qué sirve: Regla fuenteada por casilla Formulario 220.

Ejemplo explicado: Consulta la regla de una casilla y su fuente anual; no copies una regla del año anterior sin validar compatibilidad.

Entrada y pasos:

  1. Abra la ruta y verifique Matriz de reglas F220. Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
casilla id Obligatorio Seleccionar la referencia correcta, no escribir un identificador inventado.
tipo Obligatorio Elegir una opción del catálogo de la pantalla.
Concepto BPS No marcado obligatorio en esta declaración Seleccionar la referencia correcta, no escribir un identificador inventado.
Casilla relacionada No marcado obligatorio en esta declaración Seleccionar la referencia correcta, no escribir un identificador inventado.
fuente seccion Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
vigencia desde Obligatorio Fecha coherente con el hecho o vigencia del registro.
activo No marcado obligatorio en esta declaración No marcar la casilla sin cumplir y demostrar su condición.
Casillas fuente No marcado obligatorio en esta declaración Revisar etiqueta, formato y ejemplo antes de guardar.
vigencia hasta No marcado obligatorio en esta declaración Fecha coherente con el hecho o vigencia del registro.
version formulario Obligatorio en la traza; lectura Contrastar con la fuente; no sobrescribir.
fuente url Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
fuente normativa Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
motivo Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Porcentaje fijo (Proc. 2).

Para qué sirve: Porcentaje fijo de retencion Procedimiento 2.

Ejemplo explicado: Consulta la ventana histórica usada y la vigencia del porcentaje fijo. No aplique el procedimiento 2 a Ana si su contrato está en procedimiento 1.

Entrada y pasos:

  1. Abra la ruta y verifique Porcentaje fijo (Proc. 2). Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. No se localizó una ficha de detalle BPS independiente para esta acción; se debe confirmar la vista efectiva.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio en la traza; lectura Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Fecha de corte Obligatorio en la traza; lectura Fecha coherente con el hecho o vigencia del registro.
Meses promediados Calculado / lectura Contrastar con la fuente; no sobrescribir.
Base gravable promedio Calculado / lectura Contrastar con la fuente; no sobrescribir.
Porcentaje fijo (%) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Compania Obligatorio en la traza; lectura InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Sin restricción adicional en este nodo; siguen aplicando ancestros, ACL y reglas. No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Soporte técnico anual.

Para qué sirve: Soporte/resumen tecnico de retencion por ano.

Ejemplo explicado: Abre el soporte de 2026 y revisa cobertura y faltantes antes de exportar. Un PDF de soporte no es por sí mismo un Formulario 220 expedido.

Entrada y pasos:

  1. Abra la ruta y verifique Soporte técnico anual (retención). Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
  4. Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Empleado Obligatorio en la traza; lectura Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta.
Ano Obligatorio en la traza; lectura Contrastar con la fuente; no sobrescribir.
Origen del soporte Obligatorio en la traza; lectura Servicio que creo el soporte. TECNICO (preparar, HU-071A): resumen sin gates de consumibilidad ni cruce con recibos; queda CONSULTABLE pero NO aprobable como cierre anual. PRODUCTIVO (generar_productivo, HU-071B): paquete con gates, advertencias y cruce; es el unico aprobable. Los soportes historicos quedan tecnicos por default (upgrade-safe); NO se promueven automaticamente.
Estado Obligatorio en la traza; lectura preparado -> aprobado. Solo el soporte PRODUCTIVO (HU-071B) se aprueba; el APROBADO es totalmente inmutable (cierre anual interno del area de nomina). La aprobacion NO lo convierte en el Formulario 220 oficial.
Periodos incluidos Calculado / lectura Contrastar con la fuente; no sobrescribir.
Ingresos del ano (tecnico) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Aportes obligatorios trabajador (INCR) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Deducciones (art. 387) Calculado / lectura Contrastar con la fuente; no sobrescribir.
Rentas exentas Calculado / lectura Contrastar con la fuente; no sobrescribir.
Base aplicada total Calculado / lectura Contrastar con la fuente; no sobrescribir.
Retencion aplicada total Calculado / lectura Contrastar con la fuente; no sobrescribir.
N. advertencias Calculado / lectura Contrastar con la fuente; no sobrescribir.
Certificado oficial pendiente Calculado / lectura El catalogo oficial 4-60 esta normalizado, pero faltan acumuladores por concepto, datos gobernados, validacion contable y generacion oficial. Este soporte sigue siendo tecnico, no el certificado DIAN.
Compania Obligatorio en la traza; lectura InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.
Preparado el Calculado / lectura Contrastar con la fuente; no sobrescribir.
Fuente recibo disponible Calculado / lectura True si el modulo del recibo productivo (M12) esta instalado y se pudo cruzar la retencion aplicada contra los recibos FINALIZADOS del ano.
Recibos finalizados del ano Calculado / lectura Contrastar con la fuente; no sobrescribir.
Retencion en recibos finalizados Calculado / lectura Suma de la retencion descontada en los recibos FINALIZADOS del ano (fuente M12, solo lectura). Cruce informativo: no recalcula ni corrige.
Diferencia vs recibos Calculado / lectura Retencion aplicada (M07) menos retencion de recibos finalizados (M12). Una diferencia distinta de cero queda como advertencia para revision humana.
Advertencias de datos Calculado / lectura Datos faltantes o limites detectados al generar (meses sin aplicacion, control anual real pendiente, diferencias contra recibos y gate Formulario 220). Honestas: no bloquean lo consolidado, lo contextualizan.
Preflight Formulario 220 Calculado / lectura Disponibilidad TECNICA de los datos logicos de un certificado de ingresos y retenciones. 'Listo tecnico' NO significa certificado emitible: la matriz oficial conserva gates de datos/acumuladores y revision (DA-019).
Datos requeridos faltantes Calculado / lectura Contrastar con la fuente; no sobrescribir.
Matriz de campos (requerido vs disponible) Calculado / lectura Campos LOGICOS (no son las casillas oficiales del Formulario 220) requeridos para un certificado de ingresos y retenciones, con su fuente y si el dato esta disponible o falta.
Gate oficial Formulario 220 Calculado / lectura Ruta de generacion oficial del Formulario 220. En esta fase queda bloqueada por datos/acumuladores, validacion contable y salida oficial no habilitada.
Matriz oficial Formulario 220 Calculado / lectura Matriz de trazabilidad oficial: campo requerido, dato fuente BPS, estado, fuente normativa/documental e impacto en la generacion oficial.
Aplicaciones incluidas Calculado / lectura Contrastar con la fuente; no sobrescribir.
Beneficios del ano (con fuente) Calculado / lectura Beneficios tributarios del empleado con vigencia dentro del ano, con su soporte documental (HU-066A). Trazabilidad: las depuraciones ya los consumieron; aqui se referencian, no se recalculan.
Aprobado por Calculado / lectura Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí.
Aprobado en Calculado / lectura Contrastar con la fuente; no sobrescribir.
Soporte de la aprobacion (referencia) Calculado / lectura Referencia documental interna (acta, radicado): no contenido sensible.
Motivo de la aprobacion Calculado / lectura Contrastar con la fuente; no sobrescribir.
Fuente / memoria Calculado / lectura Contrastar con la fuente; no sobrescribir.

Controles que puede encontrar

Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.

Control Restricción / lectura segura
Aprobar (cierre interno) Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Aprobacion humana con motivo y soporte: SOLO para el paquete productivo (HU-071B). Un soporte tecnico (HU-071A) es consultable pero no aprobable. NO convierte el soporte en el Formulario 220 oficial.
Exportar XLSX Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Exportación técnica de la instantánea. NO es el Formulario 220.
Exportar PDF Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Exportación técnica de la instantánea. NO es el Formulario 220.
Preflight F220 (PDF) Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Matriz TECNICA de datos requeridos vs disponibles para un certificado de ingresos y retenciones. NO es el Formulario 220 oficial: el formato DIAN sigue PENDIENTE_FUENTE (DA-2026-06-20-019).
Preflight F220 (XLSX) Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Idem en XLSX. Evidencia tecnica, NO es el certificado oficial.
Generar borrador F220 Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. Congela el expediente para revisión contable. La descarga solo se habilita con la matriz completa.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Sin restricción adicional en este nodo; siguen aplicando ancestros, ACL y reglas. No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha

Ruta: Nómina BPS → Retención → Retención BPS → Tabla art. 383.

Para qué sirve: Rango de la tabla del art. 383 ET (retencion en la fuente).

Ejemplo explicado: Consulta la tabla y el tramo aplicable por vigencia. En pantalla estrecha comprueba el desplazamiento hasta ambos extremos, no solo si aparece una barra.

Entrada y pasos:

  1. Abra la ruta y verifique Tabla art. 383 (retención). Revise filtros iniciales antes de concluir que falta un registro.
  2. Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
  3. Revise los datos de la ficha. La presencia de un formulario no acredita permiso para crear/modificar: siga el flujo de la guía del proceso y la sesión autorizada.
  4. Contraste campos y evidencia de origen con el ejemplo. No se localizó una ficha de detalle BPS independiente para esta acción; se debe confirmar la vista efectiva.

Datos que se rellenan o se revisan

Campo Cómo se trata Qué comprobar
Vigente desde Obligatorio Fecha coherente con el hecho o vigencia del registro.
Vigente hasta No marcado obligatorio en esta declaración Fecha coherente con el hecho o vigencia del registro.
Desde (UVT) Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Hasta (UVT) No marcado obligatorio en esta declaración Vacio = en adelante (ultimo rango).
Tarifa marginal (%) Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
UVT a sumar (acumulado del rango) No marcado obligatorio en esta declaración Componente fijo en UVT que se suma al resultado marginal del rango (columna 'mas N UVT' de la tabla del art. 383).
Fuente Obligatorio Revisar etiqueta, formato y ejemplo antes de guardar.
Compania No marcado obligatorio en esta declaración InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso.

Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.

Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.

Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.

Acceso declarado en el menú: Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.

Referencia verificable de esta ficha