Quiero preparar nómina electrónica DSNE¶
Recorrido del corte fusionado — 2026-09-13¶
PARCIAL, SHA 067ec7a21cf049451cd349ae473e872883f98e77 de BPSPayrollE/dev-fase3. Empiece por Preparar la habilitación de nómina electrónica: contiene configuración, responsabilidades privadas del PO, evaluación local, códigos de bloqueo, NIE/NIA, candidato, expediente y respuestas. Separa las acciones implementadas de las ejecutadas.
Se abrió por interfaz, con Operador UAT en D-19, DSNE → Consolidar documento NIE. El formulario muestra Trabajador, Periodo, Politica D-5 y Origen, y aclara que la consolidación local no firma ni transmite. No se pulsó Consolidar porque falta el recibo finalizado del caso nuevo. Notas de ajuste (NIA) ofrece consulta; sus vistas no habilitan creación manual. No indicar que se registra una nota pulsando Nuevo.
La guía anterior no describía el conector fusionado: ahora se documentan Preparar expediente DIAN, consentimiento por documento y las acciones externas Enviar a DIAN habilitación / Consultar estado DIAN, reservadas al PO y no ejecutadas. No se certifica habilitación conseguida. La configuración/resultado administrativo y las capturas nuevas de DSNE siguen pendientes de la sesión autorizada.
Referencia histórica conservada¶
Revisar FondoSP y prestaciones en el NIE local vigente¶
Contraste de código en 067ec7a21cf049451cd349ae473e872883f98e77; todavía no es una emisión del ejemplo. BPSPayrollE PR #11 (7032cd42, c4c23993) conserva las subcuentas FSP. PR #14 (94ca2aaa, bc3d0f35) enlaza prestaciones y tasa con sus fuentes.
- Revisor: cotejar Solidaridad y Subsistencia contra las líneas persistidas de FSP; no basta con que cuadre el total. El NIE transporta Porcentaje/DeduccionSP y PorcentajeSub/DeduccionSub por separado, sin recalcular el reparto.
- Si aparece
PENDIENTE_REPARTO_FSP_DSNE, identificar si faltan subcuentas o si no cuadran porcentajes/importes. La traza histórica es inmutable y el mensaje no ofrece corrección/supersesión del período: detener ese documento y escalar, no editar ni reenviar. - Para prima, revisar referencia de prestación, días causados, importe, trabajador y período. La prima proporcional usa la referencia productiva del retiro; no asignar días por calendario ni tratar todo pago como cierre semestral.
- Para cesantías e intereses, cotejar principal, evidencia de consignación y líneas del recibo con las trazas. Porcentaje no equivale a PagoIntereses: si no hubo pago de intereses, la tasa se lee del catálogo vigente, positiva y fuenteada a la fecha de causación; no se fabrica un pago para completar el XML.
- Ante
PENDIENTE_TRAZA_PRIMA_DSNE,PENDIENTE_TRAZA_CESANTIAS_DSNEoPENDIENTE_TASA_CESANTIAS_DSNE, conservar código y referencia; RR. HH./administrador revisa origen, catálogo y soporte. No llenar valores inventados ni modificar trazas inmutables.
Faltan capturas Odoo de insumos, resultado por concepto y recuperación, además del XML local efectivamente generado. Código contrastado. Ningún control local acredita envío o aceptación.
El contenido y las capturas siguientes corresponden al corte de agosto de su ficha, no a una equivalencia visual verificada en septiembre. Para rutas y límites actuales prevalece la guía de habilitación enlazada arriba.
Para qué sirve¶
Preparar localmente el documento, el paquete, la firma candidata, validación XSD, preflight de habilitación y evidencia de la respuesta DIAN/TrackId cuando se importe de forma gobernada. El objetivo actual es llegar a una prueba asistida real sin simular que DIAN ya aceptó algo.
Listado real de preenvíos en una base limpia: explica las columnas que se llenarán durante habilitación. No contiene una transmisión ni una respuesta DIAN real.
Ruta exacta¶
Aplicación: Nómina BPS → contenedor: DSNE
| Lo que necesitas | Opción de menú | Cómo se ejecuta |
|---|---|---|
| Consolidar el documento de nómina electrónica | DSNE BPS > Consolidar documento NIE | Asistente |
| Ver los documentos | DSNE BPS > Documentos NIE | Lista |
| Registrar una nota de ajuste | DSNE BPS > Notas de ajuste (NIA) | Lista |
| Revisar mapeo y estructura | DSNE BPS > Mapeo concepto → elemento, Elementos XSD | Listas |
| Revisar la firma | DSNE BPS > Política de firma XAdES, Candidatos de firma XAdES | Listas |
| Configurar el firmante | Firmante DIAN BPS > Configuración DSNE, Certificados DIAN | Listas |
| Comprobar el material criptográfico | Firmante DIAN BPS > Validar material PKCS#12 | Asistente |
| Revisar habilitación y respuestas | Firmante DIAN BPS > Pre-envíos DIAN (habilitación), Respuestas DIAN (local) | Listas |
El vault de secretos no se abre para mirar
Firmante DIAN BPS > Vault de secretos custodia material criptográfico. No copie, exporte ni capture su contenido, y no registre PIN ni contraseñas en un ticket, un correo ni en esta wiki.
Antes de empezar¶
| Elemento | Dónde se controla | Nunca hacer |
|---|---|---|
| Emisor y software por cliente | Habilitación DIAN del cliente | Reutilizar credenciales de otro cliente. |
| Certificado P12/PFX y contraseña | Vault/custodia autorizada | Pegarlo en capturas, notas o campos libres. |
| Software ID, PIN, TestSetID y entorno | Configuración gobernada por compañía | Exponer secretos en la wiki o un PR. |
| Datos del recibo | Nómina/contrato revisados | Firmar una estructura con información incompleta. |
| Responsable DIAN | Rol y proceso de habilitación | Convertir un preflight local en aceptación DIAN. |
Flujo recomendado¶
- Parta de un recibo y datos internos revisados.
- Abra el documento DSNE y ejecute los controles de estructura/preflight locales permitidos.
- Revise la validación XSD, hashes, referencias y gates de firma/habilitación.
- Genere evidencia local/no transmisible solo cuando el estado lo permita.
- Para una prueba DIAN real, use el software propio del cliente, el ambiente de habilitación y los secretos desde custodia autorizada.
- Importe/acople la respuesta o TrackId mediante el flujo gobernado; no escriba resultados manuales como si vinieran de DIAN.
Resultado esperado¶
Una cadena de evidencia local: documento estructurado, validaciones, estado de firmas candidatas, manifiesto/hash y preflight. Si no existe una condición real para envío, debe aparecer un gate explícito y el proceso debe detenerse.
Estados comunes¶
| Estado/gate | Significado | Siguiente acción |
|---|---|---|
| Material PKCS#12 inválido o no verificado | No se puede comprobar que el material sea utilizable | Revisar en vault con responsable autorizado. |
| PENDIENTE_LIBRERIA/PERFIL_XADES | La capacidad de firma real no está disponible o confirmada | No declarar documento firmado; resolver dependencia técnica. |
| Habilitación/configuración pendiente | Falta configuración real por compañía | Completar proceso DIAN de software propio. |
| Respuesta/TrackId local | Evidencia importada, no consulta remota | Conservar adjunto, origen y responsable. |
Si algo falla¶
| Síntoma | Causa probable | Recuperación correcta |
|---|---|---|
| XML no valida localmente | Datos, mapeo o estructura incompletos | Corrija el origen/mapeo, vuelva a validar y preserve el diagnóstico. |
| Material o firma no verificable | Certificado, contraseña custodiada o perfil técnico pendiente | Revisar únicamente con el responsable y vault autorizados; no copiar secretos. |
| Preenvío bloqueado | Habilitación, entorno o configuración por compañía incompletos | Completar el proceso DIAN de software propio y repetir la prueba asistida. |
| No hay respuesta/TrackId | Aún no ocurrió una transmisión real o no se importó evidencia | Mantener el estado local como pendiente; no inventar aceptación. |
Cobertura legal y límites¶
La preparación local no equivale a transmisión ni aceptación DIAN. Aún requieren prueba real: certificado válido por cliente, software propio habilitado, TestSetID/servicio apropiado, firma XAdES interoperable, SOAP real, TrackId/estado real y aceptación/rechazo DIAN. No se declara CUNE productivo definitivo hasta que la cadena externa esté evidenciada.
Ficha de verificación¶
| Dato | Valor |
|---|---|
| Versión de la guía | V1.1 — texto reanclado; capturas todavía V1.0 |
| Fecha de verificación | 2026-08-10 |
| Código observado | 4b0f549dd72d6d61dd1eb181d165dbe48459480f |
| Rama | dev-fase3 de xdiegob/PayrollBPS |
| Entorno | Odoo.sh xdiegob-payrollbps, Development, build 36201289, Test: Success |
| Alcance verificado | Rutas de menú, roles que las ven y existencia de asistentes, por consulta de solo lectura |
| No verificado | Recorrido funcional con rol real y datos de nómina sembrados |
| Estado externo | No aplica: esta guía no afirma aceptación de ningún tercero |