DSNE: 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 prepara documentos; administrador gestiona configuración; PO custodia secretos y ejecuta cualquier envío fuera de este encargo. 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:
- Documentos NIE
- Notas de ajuste (NIA)
- Mapeo concepto → elemento
- Elementos XSD
- Consolidar documento NIE
- Configuración DSNE
- Certificados DIAN
- Vault de secretos
- Validar material PKCS#12
- Pre-envíos DIAN (habilitación)
- Respuestas DIAN (local)
- Perfiles certificados WS-Security
- Politica de firma XAdES
- Candidatos de firma XAdES
- Envíos DIAN (habilitación)
- Boletos de consentimiento (habilitació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.
DSNE¶
Ruta: Nómina BPS → DSNE.
Es un contenedor de navegación, no genera un registro ni calcula importes. Ábralo y elija la opción según la tarea:
- DSNE BPS — submenú
- Consolidar documento NIE
- Firmante DIAN BPS — submenú
Ejemplo: para consultar Consolidar documento NIE, 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.
Consolidar documento NIE¶
Ruta: Nómina BPS → DSNE → Consolidar documento NIE.
Para qué sirve: Consolidar documento DSNE (NIE) del periodo.
Ejemplo explicado: Selecciona trabajador, período y política requerida del ejemplo; solo consolida desde el recibo finalizado, no firma ni transmite.
Entrada y pasos:
- Abra la ruta anterior y revise el título Consolidar documento DSNE de la ventana.
- 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.
- 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.
- 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 |
|---|---|---|
| Trabajador | Obligatorio | Trabajador cuyo documento DSNE se consolida. Se elige sobre el modelo PUBLICO de trabajador, que es el mecanismo estandar de Odoo para quien no administra RR. HH. La compania se toma de su ficha, igual que hace el servicio. |
| Periodo | Obligatorio | Periodo del documento. Es una propuesta editable. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Politica D-5 | Obligatorio | Politica D-5 del documento. No tiene valor por defecto: el servicio exige elegirla explicitamente. |
| Origen | Obligatorio | Del recibo productivo finalizado sale el DSNE local (HU-083B). El puente por preliquidacion (HU-079A) se conserva para los gates M11 y NO genera XML local. |
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 |
|---|---|
| Consolidar | 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ú: Operador de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_dsne.menu_bps_dsne_documento_consolidar. - Acción:
bps_nomina_dsne.action_bps_dsne_documento_consolidar; modelobps.dsne.documento.consolidar.wizard. - Fuentes del menú/acción: dsne_consolidar_wizard_views.xml, bps_nomina_app_menus.xml.
- Vistas: dsne_consolidar_wizard_views.xml.
- Datos: dsne_consolidar_wizard.py.
DSNE BPS¶
Ruta: Nómina BPS → DSNE → DSNE BPS.
Es un contenedor de navegación, no genera un registro ni calcula importes. Ábralo y elija la opción según la tarea:
- Documentos NIE
- Notas de ajuste (NIA)
- Mapeo concepto → elemento
- Elementos XSD
- Politica de firma XAdES
- Candidatos de firma XAdES
Ejemplo: para consultar Documentos NIE, 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: dsne_views.xml, bps_nomina_app_menus.xml.
Candidatos de firma XAdES¶
Ruta: Nómina BPS → DSNE → DSNE BPS → Candidatos de firma XAdES.
Para qué sirve: Candidato de firma XAdES-EPES DSNE (habilitacion, no enviado).
Ejemplo explicado: Consulta el estado de un candidato autorizado y su hash sin firmar material nuevo. Una firma local válida no acredita recepción externa.
Entrada y pasos:
- Abra la ruta y verifique Candidatos de firma XAdES. Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Compania | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Documento DSNE (NIE) | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Ambiente | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Estado | Calculado / lectura | CANDIDATO_HABILITACION_NO_ENVIADO mientras no exista aceptacion DIAN real. |
| Verificacion | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Politica oficial | Calculado / lectura | Casilla de lectura: comprobar la condición calculada por el proceso. |
| Firmado el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SigningTime XAdES | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Responsable | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| SHA-256 XML firmado | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA-256 XML origen | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Huella cert (SHA-256) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Serial certificado | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Emisor certificado | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Politica (URI) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Nombre ZIP | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA-256 ZIP | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| ZIP candidato | Calculado / lectura | Solo soporte sintético autorizado; nunca secretos ni datos personales reales. |
| Detalle verificacion | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Certificado publico (PEM) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| XML firmado candidato | 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 |
|---|---|
| Preparar expediente DIAN | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. |
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
- Menú:
bps_nomina_firmante.menu_bps_dsne_firma_candidato. - Acción:
bps_nomina_firmante.action_bps_dsne_firma_candidato; modelobps.dsne.firma.candidato. - Fuentes del menú/acción: firma_candidato_views.xml.
- Vistas: firma_candidato_views.xml, dsne_habilitacion_conector_views.xml.
- Datos: dsne_documento_firma.py, dsne_firma_candidato.py, dsne_transmision_boleto.py.
Documentos NIE¶
Ruta: Nómina BPS → DSNE → DSNE BPS → Documentos NIE.
Para qué sirve: Documento tecnico NIE mensual.
Ejemplo explicado: Cuando exista el recibo, revisa documento, devengos/deducciones, FondoSP, prestaciones y validaciones locales. No pulses firma, envío ni consulta DIAN.
Entrada y pasos:
- Abra la ruta y verifique Documentos NIE (DSNE). Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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. |
| Estado | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| DevengadosTotal | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| DeduccionesTotal | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| ComprobanteTotal | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Validacion XSD | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Compania | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Politica D-5 | Calculado / lectura | Politica devengo/pago POR COMPANIA (D-5). REQUIERE validacion contable-tributaria del cliente; no tiene default silencioso. |
| Recibo productivo origen | Calculado / lectura | Fuente productiva-local de los devengos por concepto. Debe estar finalizado. |
| Liquidacion definitiva origen | Calculado / lectura | Liquidacion definitiva cerrada consumida por DSNE local. Solo se leen valores persistidos (total final, indemnizacion art. 64 y moratoria art. 65 aprobada). |
| Preliquidacion origen | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| DSNE productivo pendiente | Calculado / lectura | PENDIENTE_DSNE: documento TECNICO; NO genera XML, CUNE, firma, SOAP, envio ni aceptacion DIAN. |
| Version XSD usada | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA-256 XML tecnico | Calculado / lectura | Huella SHA-256 del XML local validado. Es evidencia tecnica local; no es CUNE. |
| Devengados salariales | Calculado / lectura | Devengados cuyo concepto es SALARIAL (art. 127 CST) al consolidar. |
| Devengados no salariales | Calculado / lectura | Devengados cuyo concepto es no salarial por naturaleza o pactado (art. 128 CST) al consolidar. |
| Devengados sin naturaleza resuelta | Calculado / lectura | Devengados que NO se clasifican en ninguno de los dos ejes: conceptos MIXTOS y componentes de liquidacion (art. 64/65), que mapean por clave tecnica y no por concepto. Se declaran aparte en vez de asignarlos a un lado sin fuente. |
| Total final liquidacion origen | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Indemnizacion art. 64 origen | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Moratoria art. 65 aprobada origen | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Lineas | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Errores tecnicos | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Errores XSD | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| XSD oficial (completo) | Calculado / lectura | Resultado de validar el XML local contra el XSD oficial INTEGRO (con imports UBL de la Caja de Herramientas DIAN). 'Valido local' NO significa aceptacion DIAN: solo habilita el siguiente gate tecnico local. Se espera 'Invalido' para el XML tecnico actual (sin CUNE/UBLExtensions/firma): los errores listan exactamente lo que falta para el XML completo. NO envia a DIAN. |
| Tipo detectado | Calculado / lectura | Tipo por raiz del XML: nie (NominaIndividual) o nia (NominaIndividualDeAjuste). |
| Validado (oficial) el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Validado (oficial) por | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| SHA-256 del XSD usado | Calculado / lectura | Huella del XSD oficial local usado (trazabilidad contra la Caja oficial). |
| Errores XSD oficial | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| XML tecnico (evidencia) | Calculado / lectura | XML local tecnico generado y validado contra sub-esquema XSD local. NO es XML productivo: sin CUNE, firma, ProveedorXML, ZIP, SOAP ni envio. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Estado DSNE DIAN | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Vector CUNE DIAN | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Ambiente DIAN | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Preflight DIAN | Calculado / lectura | Resultado del preflight de habilitacion DIAN. 'listo_tecnico_no_transmisible' significa: todo lo tecnico-local disponible, pero SIN vector CUNE reproducible, SIN firma XAdES real y SIN SOAP/aceptacion DIAN (razones visibles como items). 'pendiente_vector' es un contrato futuro: aplicara cuando firma/ZIP/SOAP esten implementados y solo falte el vector oficial. |
| EncripCUNE | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Numero XML DIAN | Calculado / lectura | NumNE usado para el CUNE: prefijo + consecutivo de la nomina. |
| FechaGen DIAN | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. |
| HoraGen DIAN | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| TipoXML DIAN | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| CUNE | Calculado / lectura | CUNE tecnico-local calculado con SHA-384 segun Anexo Tecnico V1.0 numeral 8.1. No implica CUNE productivo definitivo, firma, ZIP, SOAP ni aceptacion DIAN. |
| Detalle vector CUNE | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Bloqueos DIAN | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Preflight XAdES | Calculado / lectura | Verdicto del preflight de firma XAdES-EPES offline. HOY siempre 'no_firmable': falta la libreria de firma XML y la politica de firma oficial DIAN (PENDIENTE_POLITICA_FIRMA_DIAN). 'firmable_offline' es un CONTRATO FUTURO declarado e inalcanzable en esta entrega; NUNCA implica firmado, ZIP, SOAP, envio ni aceptacion DIAN. |
| Preflight XAdES el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Digest C14N pre-firma | Calculado / lectura | SHA-256 del XML local validado tras canonicalizacion C14N 1.0 exclusiva: insumo tecnico VERIFICABLE de una futura firma XML-DSig/XAdES. NO es el DigestValue oficial DIAN ni una firma; solo evidencia local reproducible. |
| Metodo del digest | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Detalle preflight XAdES | Calculado / lectura | Matriz accionable: que esta listo (XML, material, vault, CUNE tecnico) y por que NO se puede firmar aun (libreria, perfil, politica, vector). Sin secretos. |
| Preflight SOAP DIAN | Calculado / lectura | Verdicto del preflight de transmision SOAP DIAN. HOY siempre 'no_transmisible': el WSDL/contrato tecnico vigente, el endpoint del catalogo DIAN y las credenciales de habilitacion son fuentes externas por obtener (registro de bloqueos del proyecto) y la firma XAdES real sigue pendiente. 'envelope_local' es un CONTRATO FUTURO (envelope tecnico local NO ENVIABLE construido desde el WSDL oficial archivado) inalcanzable en esta entrega. NUNCA implica envio, TrackId ni aceptacion/rechazo DIAN. |
| Preflight SOAP el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Detalle preflight SOAP | Calculado / lectura | Matriz accionable de transmision: cadena local (XML, CUNE, firma, ZIP), configuracion/ambiente y los gates externos (endpoint, credenciales, contrato SOAP, envio). Sin secretos; sin URLs inventadas. |
| Ambiente del preflight | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Preflight evaluacion N. | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fecha del preflight | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Resumen del preflight | Calculado / lectura | Resumen humano de la ultima evaluacion: que esta listo, que bloquea, que falta y el siguiente paso. Sin secretos. |
| Items del preflight | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Paquete local DSNE | Calculado / lectura | Estado del paquete ZIP tecnico-local. Nunca representa envio, ZIP firmado ni aceptacion DIAN. |
| Ambiente paquete local | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Fecha paquete local | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Nombre ZIP local | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA-256 paquete local | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA-256 manifest paquete local | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| ZIP local NO enviable | Calculado / lectura | ZIP tecnico con XML local, manifest y preflight. NO es ZIP firmado DIAN. |
| Resumen paquete local | Calculado / lectura | Resumen humano del paquete local. Declara limites y pendientes; sin secretos. |
| Manifest tecnico paquete local | Calculado / lectura | Manifest JSON persistido fuera del ZIP con hashes SHA-256 de evidencias y del propio ZIP local. NO contiene secretos ni habilita transmision. |
| Pre-envio DIAN (ultimo) | Calculado / lectura | Estado del pre-envio mas reciente del documento (informativo). |
| Pre-envios DIAN | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Respuesta DIAN (ultima) | Calculado / lectura | Estado de la respuesta local mas reciente del documento (informativo). 'sin_respuesta' cuando aun no se ha registrado ninguna. |
| Respuestas DIAN (local) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Candidatos de firma XAdES | 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 |
|---|---|
| Validar XML local contra XSD DIAN | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. Valida el XML local contra el XSD oficial INTEGRO (imports UBL de la Caja de Herramientas DIAN). NO envía a DIAN y NO reemplaza la aceptación DIAN. Para el XML técnico actual se espera 'Invalido': los errores listan lo que falta para el XML completo (CUNE/UBLExtensions/firma). |
| Validar documento | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. Aplica las validaciones de negocio (HU-080A) y pasa el documento a validado. Si hay hallazgos, bloquea y los enumera: el documento no avanza. |
| Preflight firma XAdES | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. Evidencia accionable de la firma XAdES-EPES offline: que esta listo (XML, material, vault, CUNE tecnico) y por que NO se puede firmar aun (libreria, perfil, politica DIAN). Calcula el digest C14N tecnico. NO firma, NO descifra secretos, NO envia. |
| Exportar evidencia TXT | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. Adjunta la matriz del preflight XAdES como TXT local. Sin secretos; no es XML firmado ni paquete DIAN. |
| Preflight SOAP DIAN | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. Evidencia accionable de la transmision: cadena local (XML, CUNE, firma, ZIP) y gates externos (endpoint, credenciales, contrato SOAP, envio). NO envia nada, NO consulta DIAN, NO genera envelope sin fuente. |
| Exportar evidencia TXT | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. Adjunta la matriz del preflight SOAP como TXT local. Sin secretos; no es envelope ni paquete DIAN. |
| Ejecutar preflight DIAN | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Consolida que esta listo y que falta para poder firmar/ transmitir. NO envia, NO firma, NO genera CUNE. El auditor solo consulta el resultado. |
| Generar paquete local | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Genera ZIP tecnico local con XML, manifest y preflight. NO firma, NO envia, NO declara aceptacion DIAN. |
| Preparar pre-envío DIAN habilitación | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Consolida config de habilitación (modo, TestSetID, endpoint, certificado, vault), XSD oficial, CUNE técnico, ZIP local y estado de firma en una matriz de gates + evidencia con SHA-256. NO envía. |
| Registrar respuesta DIAN local | No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Administrador BPS. Importa el archivo de respuesta (XML/SOAP, JSON o TXT) como evidencia con SHA-256 y lo interpreta localmente. NO envía, NO consulta GetStatus/TrackId real. |
| Firmar candidato XAdES | No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Administrador BPS. Produce y VERIFICA un XML firmado XAdES-EPES real y un ZIP candidato NO ENVIADO. Requiere politica de firma configurada (fail-closed si falta). NO envia ni declara aceptacion DIAN. |
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
- Menú:
bps_nomina_dsne.menu_bps_dsne_documento. - Acción:
bps_nomina_dsne.action_bps_dsne_documento; modelobps.dsne.documento. - Fuentes del menú/acción: dsne_views.xml.
- Vistas: dsne_views.xml, dsne_consolidar_wizard_views.xml, firmante_views.xml, firma_candidato_views.xml.
- Datos: dsne_documento.py, dsne_documento_firma.py, dsne_preenvio.py, dsne_preflight.py, dsne_respuesta.py, nie_oficial.py.
Elementos XSD¶
Ruta: Nómina BPS → DSNE → DSNE BPS → Elementos XSD.
Para qué sirve: Elemento del XSD DSNE (catalogo, HU-078A).
Ejemplo explicado: Consulta nombre, ruta y condición del elemento XML reclamado por una validación; no modifiques el catálogo oficial para aceptar un XML propio.
Entrada y pasos:
- Abra la ruta y verifique Elementos XSD (DSNE). Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Codigo (elemento XSD) | Obligatorio | Nombre del elemento tal cual en el XSD (p. ej. Basico, HED, Salud). |
| Grupo | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Ruta XSD | No marcado obligatorio en esta declaración | Ruta del elemento dentro del documento (XPath tecnico). |
| minOccurs | No marcado obligatorio en esta declaración | Tomado del XSD. |
| maxOccurs | No marcado obligatorio en esta declaración | Tomado del XSD. |
| Exige Porcentaje por registro | No marcado obligatorio en esta declaración | El elemento exige el atributo Porcentaje en cada registro (HU-078A CA-4; horas extra/recargos). Tomado del XSD. |
| Version XSD | 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 No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_dsne.menu_bps_dsne_elemento. - Acción:
bps_nomina_dsne.action_bps_dsne_elemento; modelobps.dsne.elemento. - Fuentes del menú/acción: dsne_views.xml.
- Vistas: dsne_views.xml.
- Datos: dsne_elemento.py.
Mapeo concepto → elemento¶
Ruta: Nómina BPS → DSNE → DSNE BPS → Mapeo concepto → elemento.
Para qué sirve: Mapeo concepto BPS -> elemento DSNE con vigencia.
Ejemplo explicado: Busca salario básico y verifica su elemento de destino y vigencia; un concepto sin mapeo no se convierte en otro para pasar la validación.
Entrada y pasos:
- Abra la ruta y verifique Mapeo concepto → elemento (DSNE). Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Concepto | No marcado obligatorio en esta declaración | Concepto BPS productivo. Exclusivo con la clave tecnica. |
| Clave tecnica | No marcado obligatorio en esta declaración | Naturaleza de linea de preliquidacion (lado trabajador). Exclusivo con el concepto. |
| Elemento DSNE | Obligatorio | Seleccionar la referencia correcta, no escribir un identificador inventado. |
| 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. |
| 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ú: Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_dsne.menu_bps_dsne_mapeo. - Acción:
bps_nomina_dsne.action_bps_dsne_mapeo; modelobps.dsne.mapeo.concepto. - Fuentes del menú/acción: dsne_views.xml.
- Vistas: dsne_views.xml.
- Datos: dsne_mapeo.py.
Notas de ajuste (NIA)¶
Ruta: Nómina BPS → DSNE → DSNE BPS → Notas de ajuste (NIA).
Para qué sirve: Fundacion tecnica de Nota de Ajuste NIA.
Ejemplo explicado: Consulta una nota sintética vinculada al documento origen y su causa. Su presencia no acredita disponibilidad de transmisión ni aceptación DIAN.
Entrada y pasos:
- Abra la ruta y verifique Notas de ajuste (NIA técnica). Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Documento NIE original | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Empleado | Calculado / lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| Período | Calculado / 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. |
| Tipo de ajuste | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| NIA oficial | Calculado / lectura | 'Valido' significa SOLO estructura oficial local contra el XSD integro NominaIndividualDeAjuste V1.0.6. NO es firma, ZIP, envio ni aceptacion DIAN. |
| Soporte | Calculado / lectura | Referencia de soporte operativo de la decision NIA local. No se serializa como elemento DSNE si el XSD no lo exige; queda como trazabilidad gobernada. |
| NIA productiva pendiente | Calculado / lectura | PENDIENTE_NIA: fundacion tecnica; NO genera XML NIA productivo, CUNE, firma ni transmision; NO declara contenido completo (HU-084 productivo). |
| Validacion XSD NIA | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Compania | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Version XSD usada | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Motivo | Obligatorio en la traza; lectura | Contrastar con la fuente; no sobrescribir. |
| Errores XSD NIA | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| XML NIA tecnico (evidencia) | Calculado / lectura | XML local tecnico NIA validado contra sub-esquema XSD local. NO es NIA productiva: sin CUNE, firma, ZIP, SOAP ni transmision. |
| Ambiente NIA | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Numero NIA | Calculado / lectura | NumeroSecuenciaXML/@Numero de la propia nota de ajuste (prefijo + consecutivo). |
| FechaGen NIA | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. |
| HoraGen NIA | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| TipoXML NIA | Calculado / lectura | Codigo de la tabla 5.5.7 del Anexo Tecnico: 103 = NominaIndividualDeAjuste. |
| EncripCUNE NIA | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| NumeroPred | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| CUNEPred | Calculado / lectura | CUNE REAL del documento predecesor, leido de su evidencia persistida. No es una referencia local ni un identificador inventado. |
| FechaGenPred | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. |
| Fuente numeracion NIA | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA-256 del XSD usado | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA-256 fuentes NIA | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| CUNE NIA | Calculado / lectura | CUNE propio de la nota de ajuste (numeral 8.1.1.4). Tecnico-local mientras el vector oficial DIAN siga sin reproducirse. |
| SHA-256 NIA oficial | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente CUNE NIA | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente SoftwareSecurityCode NIA | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Avisos NIA oficial | Calculado / lectura | Limites DECLARADOS de esta nota: estado del vector oficial del CUNE y, en la rama Reemplazar, la procedencia del cuerpo. No son errores de generacion: son lo que la nota NO puede afirmar todavia. |
| XML NIA oficial | Calculado / lectura | XML NIA completo validado contra el XSD oficial integro. Sin firma XAdES, sin ZIP, sin SOAP y sin transmision. |
| Fuente | 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
- Menú:
bps_nomina_dsne.menu_bps_dsne_nota_ajuste. - Acción:
bps_nomina_dsne.action_bps_dsne_nota_ajuste; modelobps.dsne.nota.ajuste. - Fuentes del menú/acción: dsne_views.xml.
- Vistas: dsne_views.xml.
- Datos: dsne_nota_ajuste.py, nia_oficial.py, nia_firma.py.
Politica de firma XAdES¶
Ruta: Nómina BPS → DSNE → DSNE BPS → Politica de firma XAdES.
Para qué sirve: Politica de firma XAdES-EPES DIAN (configurable con fuente).
Ejemplo explicado: Consulta la política y su fuente; no alteres la raíz, prefijos ni parámetros de firma para conseguir una pantalla verde.
Entrada y pasos:
- Abra la ruta y verifique Politica de firma XAdES. Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Compania | Obligatorio | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Ambiente | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Identificador (URI politica) | Obligatorio | URI de la politica de firma oficial DIAN (SigPolicyId/Identifier). |
| Politica oficial confirmada | No marcado obligatorio en esta declaración | Marque solo cuando el identificador y el digest correspondan a la politica oficial DIAN verificada. Una politica NO oficial solo habilita candidatos de habilitacion, nunca produccion. |
| Estado | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Descripcion politica | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Digest politica (SHA-256 base64) | Obligatorio | Hash SHA-256 (base64) del documento de politica de firma (SigPolicyHash). |
| Metodo digest | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Fuente oficial | Obligatorio | Cita de la fuente oficial DIAN de la politica (documento, version, pagina). Obligatoria: la politica no se inventa. |
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
- Menú:
bps_nomina_firmante.menu_bps_dsne_firma_politica. - Acción:
bps_nomina_firmante.action_bps_dsne_firma_politica; modelobps.dsne.firma.politica. - Fuentes del menú/acción: firma_candidato_views.xml.
- Vistas: firma_candidato_views.xml.
- Datos: dsne_firma_politica.py.
Firmante DIAN BPS¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS.
Es un contenedor de navegación, no genera un registro ni calcula importes. Ábralo y elija la opción según la tarea:
- Configuración DSNE
- Certificados DIAN
- Perfiles certificados WS-Security
- Vault de secretos
- Validar material PKCS#12
- Pre-envíos DIAN (habilitación)
- Envíos DIAN (habilitación)
- Boletos de consentimiento (habilitación)
- Respuestas DIAN (local)
Ejemplo: para consultar Configuración DSNE, 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: Administrador BPS / Auditor de nómina Fuente: firmante_views.xml, bps_nomina_app_menus.xml.
Boletos de consentimiento (habilitación)¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS → Boletos de consentimiento (habilitación).
Para qué sirve: Boleto de consentimiento por documento para transmision DIAN (habilitacion).
Ejemplo explicado: Consulta metadatos no sensibles y estado del consentimiento autorizado; no emitas ni consumas un boleto para hacer el ejemplo.
Entrada y pasos:
- Abra la ruta y verifique Boletos de consentimiento DIAN. Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Estado | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Vigente | Calculado / lectura | Emitido y sin expirar. Un boleto consumido, revocado o expirado no es vigente y no autoriza ningun envio. |
| Referencia autorizacion PO | Obligatorio en la traza; lectura | Referencia externa de la orden explicita del PO para ESTE documento. Nunca es un secreto. |
| Candidato XAdES (documento) | Obligatorio en la traza; lectura | Documento EXACTO (candidato de firma NIE o NIA) que autoriza este boleto. Un boleto no sirve para otro documento. |
| Emitido el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Expira el | Obligatorio en la traza; lectura | Vencimiento del consentimiento. Un boleto no usado antes de esta fecha expira y deja de autorizar el envio. |
| Consumido el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Expediente que lo consumio | Calculado / lectura | Expediente cuyo intento de envio consumio este boleto. Vacio mientras no se use. |
| Compañía | Calculado / lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Ambiente | Obligatorio en la traza; lectura | Solo habilitacion: produccion permanece segregada y no se autoriza desde aqui. |
| Emitido por | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Consumido por | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Motivo de revocacion | 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ú: Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_firmante.menu_bps_dsne_transmision_boleto. - Acción:
bps_nomina_firmante.action_bps_dsne_transmision_boleto; modelobps.dsne.transmision.boleto. - Fuentes del menú/acción: transmision_boleto_views.xml.
- Vistas: transmision_boleto_views.xml.
- Datos: dsne_transmision_boleto.py.
Certificados DIAN¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS → Certificados DIAN.
Para qué sirve: Metadata del certificado DIAN por compania/ambiente.
Ejemplo explicado: Consulta exclusivamente metadatos no secretos y vigencia del certificado. Nunca captures P12, PIN, clave privada ni contraseña.
Entrada y pasos:
- Abra la ruta y verifique Certificados DIAN (metadata). Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Ambiente | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Subject | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Valido desde | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Valido hasta | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Vigencia | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Dias para vencer | 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. |
| Issuer | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Serial | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Huella SHA-256 | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Vault PKCS#12 pendiente | Calculado / lectura | PENDIENTE_PKCS12_VAULT: no se almacena el .p12 ni la llave; el firmante real requiere custodia segura del PKCS#12 (responsabilidad del cliente, D-6). |
| Fuente | 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
- Menú:
bps_nomina_firmante.menu_bps_dsne_certificado. - Acción:
bps_nomina_firmante.action_bps_dsne_certificado; modelobps.dsne.certificado. - Fuentes del menú/acción: firmante_views.xml.
- Vistas: firmante_views.xml.
- Datos: dsne_certificado.py.
Configuración DSNE¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS → Configuración DSNE.
Para qué sirve: Configuracion DSNE por compania/ambiente.
Ejemplo explicado: Revisa compañía y ambiente Habilitación; consulta el resultado de Evaluar habilitación DIAN local sin cargar certificados ni mostrar secretos.
Entrada y pasos:
- Abra la ruta y verifique Configuración DSNE. Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Ambiente | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| SoftwareID | No marcado obligatorio en esta declaración | Identificador del software ante la DIAN (no es un secreto). |
| Estado | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Modo de operacion | No marcado obligatorio en esta declaración | Modo de operacion registrado ante la DIAN para el envio de DSNE (B15-R009): software propio, proveedor tecnologico o servicio gratuito. Su cambio queda auditado; no interrumpe la numeracion de documentos (B15-C010/B14-C013). |
| Habilitacion DIAN (local) | Calculado / lectura | Resultado de la evaluacion LOCAL de habilitacion. 'lista_tecnica_no_transmisible' significa: configuracion completa y valida, pero SIN set de pruebas DIAN ejecutado ni respuesta DIAN externa (razones visibles como items). 'habilitable_local' es un contrato futuro: aplicara cuando solo falte ejecutar el set de pruebas ante la DIAN. Nunca declara habilitacion oficial DIAN. |
| Compania | Obligatorio | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| TestSetID (set de pruebas) | No marcado obligatorio en esta declaración | Identificador del set de pruebas de habilitacion que entrega el portal DIAN al registrar el software (HU-089). Solo aplica al ambiente de habilitacion; NO es un secreto y NO se inventa: sin el dato real de la DIAN queda PENDIENTE_DATO_DIAN_TESTSETID. Registrarlo NO ejecuta ni aprueba el set de pruebas. |
| Endpoint del ambiente | No marcado obligatorio en esta declaración | URL del servicio DIAN para este ambiente, tomada del WSDL/contrato tecnico oficial (fuente obligatoria). No se inventa; configurarla NO abre conexion, NO envia ni habilita SOAP real (PENDIENTE_SOAP_REAL). |
| Fuente del endpoint | No marcado obligatorio en esta declaración | Fuente oficial exacta del endpoint (WSDL/contrato tecnico DIAN, documento y fecha). Obligatoria cuando hay endpoint configurado. |
| Certificado vigente (metadata) | Calculado / lectura | Certificado DIAN vigente registrado para la compania/ambiente (solo metadata; la llave PKCS#12 vive unicamente en el vault cifrado). Campo informativo calculado: la fuente de verdad es el registro de certificados. |
| Fuente / nota | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Pais generacion NIE | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Departamento generacion NIE | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Municipio generacion NIE | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Fuente ubicacion NIE | No marcado obligatorio en esta declaración | Referencia verificable para los codigos territoriales del emisor. |
| Habilitacion evaluacion N. | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fecha de la evaluacion | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA-256 de la evidencia | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Resumen de habilitacion | Calculado / lectura | Resumen humano de la ultima evaluacion: que esta listo, que falta, que bloquea y el siguiente paso. Sin secretos. |
| Items de habilitacion | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Evidencia tecnica (JSON) | Calculado / lectura | Evidencia canonica de la ultima evaluacion (estado + items), SIN secretos, verificable contra su huella SHA-256. |
| Espera máxima SOAP (segundos) | Obligatorio | 'Límite técnico gobernado para SendNominaSync y GetStatus en este ambiente. Debe estar entre %s y %s segundos; un timeout no infiere estado ni habilita reenviar el ZIP: la recuperación sigue siendo GetStatus. El máximo reserva %s s del presupuesto limit_time_real de referencia para preflight, ZIP y persistencia; el entorno debe conservar ese margen operativo.' % (TIEMPO_ESPERA_SOAP_MINIMO, TIEMPO_ESPERA_SOAP_MAXIMO, MARGEN_OPERATIVO_SOAP) |
| Naturaleza del participante DIAN | Obligatorio | La ruta de envio de habilitacion solo opera para persona juridica. Este campo no infiere la condicion desde un NIT o desde company_type: exige declaracion y fuente administrativa verificable por la compania. |
| Fuente de naturaleza del participante | No marcado obligatorio en esta declaración | Referencia no secreta de la evidencia administrativa que respalda la declaracion de persona juridica. Sin ella la ruta de envio falla cerrada. |
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 |
|---|---|
| Evaluar habilitación DIAN local | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Evalua LOCALMENTE la configuracion de habilitacion. NO envia a DIAN, NO ejecuta ni reemplaza el set de pruebas DIAN, NO declara aceptacion ni habilitacion oficial. |
| Cargar certificado al vault | No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Administrador BPS. Abre el formulario HTTPS administrado. El PKCS#12, sus contrasenas y el PIN se cifran directamente en el vault; nunca se guardan en campos, adjuntos ni mensajes de Odoo. SoftwareSecurityCode se calcula por documento. |
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
- Menú:
bps_nomina_firmante.menu_bps_dsne_config. - Acción:
bps_nomina_firmante.action_bps_dsne_config; modelobps.dsne.config. - Fuentes del menú/acción: firmante_views.xml.
- Vistas: firmante_views.xml, dsne_habilitacion_conector_views.xml.
- Datos: dsne_config.py, dsne_habilitacion.py, nie_oficial.py.
Envíos DIAN (habilitación)¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS → Envíos DIAN (habilitación).
Para qué sirve: Expediente de envio DIAN de habilitacion DSNE.
Ejemplo explicado: Consulta únicamente estado ya existente sin pulsar Emitir boleto, Enviar a DIAN o Consultar estado DIAN. El envío es exclusivo del PO.
Entrada y pasos:
- Abra la ruta y verifique Envíos DIAN habilitación. Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| estado | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Operacion DIAN | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Candidato XAdES | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Boleto de consentimiento vigente | Calculado / lectura | Boleto de consentimiento por documento emitido y sin expirar. Se exige y consume en el envio real; sin boleto vigente no hay POST. |
| CUNE de consulta | Calculado / lectura | Para nomina DSNE el Anexo Tecnico V1.0 exige GetStatus por CUNE/XmlDocumentKey; no se inventa un ZipKey de factura. |
| Contraste CUNE externo | Calculado / lectura | El CUNE local no se declara valido por esta marca: se contrasta con la respuesta externa cuando DIAN informa XmlDocumentKey. |
| Contraste SoftwareSecurityCode | Calculado / lectura | No certifica un vector aislado. Solo refleja si la respuesta DIAN persistida acepta o rechaza el documento que contiene el SoftwareSecurityCode calculado. |
| Fecha de inicio de intento real | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Compañía | Calculado / lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Ambiente | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Nombre del paquete | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA-256 del paquete | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Intento real DIAN iniciado | Calculado / lectura | Marca inmutable: bloquea reenvios y cualquier simulacion posterior. |
| Origen de respuesta | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Aceptacion externa DIAN confirmada | Calculado / lectura | Solo puede ser true tras una respuesta DIAN real valida persistida; un replay, timeout o preflight local nunca la activan. |
| Fase del ultimo error de transporte | Calculado / lectura | Un timeout permite consultar estado del mismo intento; nunca habilita reenviar el ZIP, ni en el contrato nominal ni en la evidencia legada. |
| SHA-256 solicitud SOAP | Calculado / lectura | Huella de la solicitud SOAP emitida, sin persistir el sobre ni la cabecera WS-Security. |
| SHA-256 respuesta DIAN | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fecha de respuesta/consulta | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Errores redactados | Calculado / lectura | Error tecnico redactado; la ausencia de respuesta nunca equivale a aceptacion. |
| Intercambios SOAP | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Solicitud enviada el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Respuesta DIAN normalizada | Calculado / lectura | Solo campos publicados del WSDL, sin SOAP crudo, cabeceras ni secretos. |
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 |
|---|---|
| Emitir boleto de consentimiento | No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Administrador BPS. Emite el consentimiento POR DOCUMENTO (un solo uso) con la referencia PO. Sin boleto vigente no hay envío. |
| Enviar a DIAN habilitación | No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Administrador BPS. |
| Consultar estado DIAN | No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Administrador BPS. |
| Descargar resultado | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. |
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
- Menú:
bps_nomina_firmante.menu_bps_dsne_habilitacion_envio. - Acción:
bps_nomina_firmante.action_bps_dsne_habilitacion_envio; modelobps.dsne.habilitacion.envio. - Fuentes del menú/acción: dsne_habilitacion_conector_views.xml.
- Vistas: dsne_habilitacion_conector_views.xml.
- Datos: dsne_habilitacion_envio.py.
Perfiles certificados WS-Security¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS → Perfiles certificados WS-Security.
Para qué sirve: Perfil de certificado aceptado para WS-Security DIAN.
Ejemplo explicado: Consulta metadatos, algoritmos admitidos y fuente del perfil; compatibilidad local no equivale a aceptación DIAN.
Entrada y pasos:
- Abra la ruta y verifique Perfiles certificados WS-Security. Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Perfil esperado | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| OID Certificate Policies | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Exige suscriptor persona natural | No marcado obligatorio en esta declaración | Cuando aplica, el Subject debe declarar nombre, apellido e identificacion del suscriptor; un NIT corporativo por si solo no satisface este requisito. |
| ECD emisora esperada | Obligatorio | Entidad de certificacion a la que se remite el cliente para obtener el perfil. |
| 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. |
| Version de la fuente | 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. |
| Fuente externa | Obligatorio | FAQ DIAN, DPC de la ECD u otra fuente verificable. No se inventan OIDs. |
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 / Operador de nómina / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_firmante.menu_bps_dsne_perfil_certificado_wss. - Acción:
bps_nomina_firmante.action_bps_dsne_perfil_certificado_wss; modelobps.dsne.perfil.certificado.wss. - Fuentes del menú/acción: dsne_perfil_certificado_views.xml.
- Vistas: dsne_perfil_certificado_views.xml.
- Datos: dsne_perfil_certificado.py.
Pre-envíos DIAN (habilitación)¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS → Pre-envíos DIAN (habilitación).
Para qué sirve: Pre-envio DIAN de habilitacion por documento/ambiente (NO envia).
Ejemplo explicado: Consulta el expediente de preparación y su estado. Un pre-envío no transmite ni prueba aceptación de la DIAN.
Entrada y pasos:
- Abra la ruta y verifique Pre-envíos DIAN (habilitación). Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Documento DSNE | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Ambiente | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Pre-envio DIAN | Calculado / lectura | Resultado de la preparacion LOCAL del set de pruebas. 'listo_local_no_enviable' es el maximo: todo lo local disponible, pero SIN firma XAdES real, ZIP firmado, credenciales DIAN reales ni SOAP: no se envia. |
| Preparacion N. | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fecha de preparacion | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Compañía | Calculado / lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| SHA-256 de la evidencia | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Resumen del pre-envio | Calculado / lectura | Resumen humano: que esta listo, que falta, que bloquea, por que NO se envia y el siguiente paso. Sin secretos. |
| Items del pre-envio | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Evidencia tecnica (JSON) | Calculado / lectura | Evidencia canonica (estado + matriz + hashes), SIN secretos, verificable contra su huella SHA-256. |
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
- Menú:
bps_nomina_firmante.menu_bps_dsne_preenvio. - Acción:
bps_nomina_firmante.action_bps_dsne_preenvio; modelobps.dsne.preenvio. - Fuentes del menú/acción: firmante_views.xml.
- Vistas: firmante_views.xml.
- Datos: dsne_preenvio.py.
Respuestas DIAN (local)¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS → Respuestas DIAN (local).
Para qué sirve: Respuesta DIAN local por documento/ambiente (NO envia, NO consulta).
Ejemplo explicado: Consulta un registro de respuesta que tenga evidencia real de origen; no inventes ni registres un Accepted para ilustrar un resultado.
Entrada y pasos:
- Abra la ruta y verifique Respuestas DIAN (local). Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Documento DSNE | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Ambiente | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Respuesta DIAN (local) | Calculado / lectura | Interpretacion LOCAL de la evidencia importada. Nunca representa envio ni aceptacion/rechazo productivo DIAN. |
| Formato detectado | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| TrackId (local) | Calculado / lectura | TrackId leido de la evidencia. Es un dato LEIDO, no consultado ni confirmado por DIAN. |
| Evaluacion N. | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fecha de registro | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Compañía | Calculado / lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Pre-envio relacionado | Calculado / lectura | Pre-envio de habilitacion al que responde esta evidencia (si existe). Debe corresponder al mismo documento y ambiente. |
| Responsable | Calculado / lectura | Usuario que registro la evidencia de respuesta. |
| SHA-256 de la evidencia | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Codigo de respuesta (local) | Calculado / lectura | Codigo/estado leido de la evidencia, verbatim. No se interpreta contra una tabla normativa (no se inventan codigos DIAN). |
| SHA-256 del archivo | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Tamano (bytes) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Mensaje de respuesta (local) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Archivo de respuesta DIAN | Calculado / lectura | Evidencia importada tal cual se recibio (XML/SOAP, JSON o TXT). NO se transmite; solo se conserva y se interpreta localmente. |
| Nombre del archivo | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Motivo / soporte | Calculado / lectura | Justificacion del registro (de donde proviene la respuesta, tramite, soporte). Obligatorio. Sin secretos. |
| Errores / validaciones | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Resumen de la respuesta | Calculado / lectura | Resumen humano: que se recibio, como se interpreto localmente, que falta y el siguiente paso. Sin secretos. |
| Evidencia tecnica (JSON) | Calculado / lectura | Evidencia canonica (estado + interpretacion + hash del archivo), SIN secretos, verificable contra su huella SHA-256. |
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
- Menú:
bps_nomina_firmante.menu_bps_dsne_respuesta. - Acción:
bps_nomina_firmante.action_bps_dsne_respuesta; modelobps.dsne.respuesta. - Fuentes del menú/acción: firmante_views.xml.
- Vistas: firmante_views.xml.
- Datos: dsne_respuesta.py.
Validar material PKCS#12¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS → Validar material PKCS#12.
Para qué sirve: Validar material PKCS#12 custodiado en el vault.
Ejemplo explicado: El PO custodia el material. Documenta selección autorizada y resultado de preflight sin abrir/descargar el certificado ni fotografiar secretos.
Entrada y pasos:
- Abra la ruta anterior y revise el título Validar material PKCS#12 de la ventana.
- 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.
- 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.
- 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. |
| Ambiente | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Veredicto | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Validado el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Detalle | 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 |
|---|---|
| Validar material PKCS#12 | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. |
| Cerrar | 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
- Menú:
bps_nomina_firmante.menu_bps_dsne_pkcs12_validar. - Acción:
bps_nomina_firmante.action_bps_dsne_pkcs12_validar_wizard; modelobps.dsne.pkcs12.validar.wizard. - Fuentes del menú/acción: firmante_views.xml.
- Vistas: firmante_views.xml.
- Datos: dsne_secreto.py.
Vault de secretos¶
Ruta: Nómina BPS → DSNE → Firmante DIAN BPS → Vault de secretos.
Para qué sirve: Custodia (vault) de secretos DSNE por compania/ambiente/tipo (DA-027).
Ejemplo explicado: Solo se documenta el propósito de custodia y el límite de acceso. Las imágenes deben ser de acceso seguro y estado sin valores secretos; no abrir contenido ni aportar credenciales de ejemplo.
Entrada y pasos:
- Abra la ruta y verifique Vault de secretos DSNE. Revise filtros iniciales antes de concluir que falta un registro.
- 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.
- 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.
- 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 |
|---|---|---|
| Tipo de secreto | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Ambiente | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Backend | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Estado | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Referencia externa | Calculado / lectura | Puntero/alias a la custodia del secreto por el cliente (NO es el secreto): p. ej. ruta o alias en el vault del cliente. No debe contener el secreto. |
| Compania | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Material PKCS#12 validado | Calculado / lectura | Veredicto de la ultima validacion del PKCS#12 del vault. No expone material. |
| Fecha validacion PKCS#12 | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Detalle de validacion PKCS#12 | Calculado / lectura | Resumen humano de la ultima validacion (huella, vigencia, llave). Sin secretos. |
| Fuente / nota | 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ú: Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_firmante.menu_bps_dsne_secreto. - Acción:
bps_nomina_firmante.action_bps_dsne_secreto; modelobps.dsne.secreto. - Fuentes del menú/acción: firmante_views.xml.
- Vistas: firmante_views.xml.
- Datos: dsne_secreto.py.