Subir el certificado .p12 a FinMova
Una vez que tienes el archivo .p12 y su contraseña (ver
Obtener el certificado digital),
el siguiente paso es cargarlos en FinMova. Esto se hace una sola
vez por empresa y queda activo hasta que el certificado expire.
Regla #1 inquebrantable de FinMova. Ni el archivo
.p12ni su contraseña vuelven jamás al navegador después de subirlos, y no se registran en logs. La validación ocurre en el servidor; el certificado vive en almacenamiento privado y la contraseña se cifra con AES-256-GCM antes de guardarse.
Antes de empezar
Asegúrate de tener:
- El archivo
.p12descargado de Viafirma (o equivalente). - La contraseña del certificado.
- La cuenta de FinMova con rol owner o admin (otros roles no pueden cargar el certificado).
- Decidido el ambiente:
- Certificación — para hacer las pruebas obligatorias antes de facturar real. Es donde siempre se empieza.
- Producción — solo después de que DGII apruebe tu set de pruebas (ver Proceso de certificación con DGII).
Paso a paso
1 · Ve a la sección de DGII
En el menú lateral, abre DGII. Verás el wizard de onboarding que detecta automáticamente en qué punto estás:
- Si no has cargado nada, aparece la Ruta A ("No tengo nada") con los enlaces a Viafirma.
- Si ya pasaste por Viafirma, salta a la Ruta B ("Ya tengo mi .p12") con el formulario de carga.
Cuidado. Si te encuentras en Ruta A, no avances hasta tener el
.p12y la contraseña; la Ruta B requiere ambos.
2 · Sube el archivo y escribe la contraseña
En la Ruta B verás dos campos:
- Archivo
.p12— botón "Seleccionar archivo". - Contraseña del certificado — campo de texto enmascarado.
Cuidado. Esta contraseña es la que definiste en Viafirma (Paso 4 de Obtener el certificado digital), no la contraseña de tu cuenta FinMova ni la del portal DGII.
Pulsa Subir y validar.
3 · FinMova valida del lado del servidor
Mientras esperas (típicamente 2 – 5 segundos), el servidor:
- Confirma que el
.p12abre con la contraseña que escribiste. - Verifica que el certificado no está vencido.
- Lee y muestra a quién pertenece (nombre del titular) y cuándo expira.
Si algo falla:
- "Contraseña incorrecta" — vuelve a Viafirma y verifica la contraseña que definiste en su día.
- "Certificado vencido" — necesitas renovarlo en Viafirma antes de continuar.
- "El titular no coincide con la persona autorizada por DGII" — este aviso es heurístico; pasa al siguiente paso pero confirma la asignación de roles en la Oficina Virtual DGII.
4 · Elige el ambiente
| Ambiente | Cuándo usar |
|---|---|
| Certificación (CerteCF) | Siempre al inicio, para ejecutar el set de pruebas obligatorio. |
| Producción (eCF) | Solo después de que DGII apruebe tu certificación. |
Importante. No saltes a Producción "para probar". Los comprobantes emitidos en producción son legales y entran al 606/607 de tus contrapartes; un e-CF emitido por error en producción es difícil de revertir (hay que emitir una NC 34 referenciándolo).
5 · Listo
Una vez confirmado, FinMova guarda:
- El archivo
.p12en almacenamiento privado del servidor. - La contraseña cifrada con AES-256-GCM (
@finmova/cryptoconDGII_CERT_MASTER_KEY) endgii_config.certificate_password_encrypted. - Información pública del titular (nombre, fecha de expiración) para mostrar en la UI.
A partir de aquí puedes empezar el proceso de certificación con DGII o, si ya estás certificado, emitir e-CF en producción.
¿Qué pasa si vuelvo a cargar otro .p12?
FinMova reemplaza el anterior. La contraseña vieja se descarta. Esto es útil para:
- Renovar el certificado anual.
- Cambiar la persona autorizada (por ejemplo, cambio de representante legal).
Buena práctica. No reemplaces el certificado a mitad de día con emisiones en curso; espera a un momento sin tráfico de facturación para evitar emisiones a medias.
Quién puede ver / cargar el certificado
| Rol | Puede ver datos del cert. | Puede subir nuevo | Puede ver el archivo |
|---|---|---|---|
| owner | ✅ | ✅ | ❌ (nadie puede; vive en el servidor) |
| admin | ✅ | ✅ | ❌ |
| accountant | ✅ (nombre del titular, expiración) | ❌ | ❌ |
| sales | ❌ | ❌ | ❌ |
| viewer | ❌ | ❌ | ❌ |
Solución de problemas
- "No me deja seleccionar el archivo" → Verifica que la extensión
sea
.p12o.pfx. Si Viafirma te dio otro formato, hubo error en la solicitud. - "Subo el archivo pero nada pasa" → Revisa la consola del
navegador. Si el archivo es muy grande (> 5 MB), no es un
.p12real. - "DGII rechaza todos los e-CF después de subir el cert" → Probablemente falta asignar la persona autorizada en la Oficina Virtual de DGII. Ver El certificado no funciona.
Siguientes pasos
- Proceso de certificación con DGII — obligatorio antes de emitir en producción.
- Emitir un e-CF — el flujo del día a día.
Manifiesto de capturas
assets/dgii/10-wizard-ruta-a.png— wizard mostrando Ruta A ("No tengo nada") con enlaces a Viafirma.assets/dgii/11-wizard-ruta-b-form.png— formulario de carga (archivo + contraseña + ambiente).assets/dgii/12-wizard-cert-cargado.png— tras carga exitosa: nombre del titular y fecha de expiración.
Última actualización: