Seguridad y continuidad del servicio API e-CF
Cómo protegemos tu certificado digital, tus comprobantes y tu cuenta, y qué pasa si la DGII o nuestros sistemas fallan. Es un resumen: no publicamos detalles técnicos que puedan facilitar un ataque. Actualizado el 18 de noviembre de 2026.
1. Tu certificado digital
- Eres el titular del certificado y de su clave privada. Lo cargas tú en el portal, o lo cargamos nosotros si nos lo encargas, con tu autorización expresa y revocable (Términos del servicio, sección 5).
- Antes de guardarlo comprobamos su contraseña y que esté vigente.
- Guardamos el archivo y su contraseña cifrados con AES-256-GCM. La clave de cifrado se guarda fuera de la base de datos.
- Solo se descifra en memoria, en el momento de firmar un comprobante que tú ordenas, y nunca se escribe en disco.
- Firmamos según el instructivo de firmado de e-CF de la DGII (XMLDSig con RSA-SHA256).
2. Acceso a tu cuenta y a la API
- El personal de Villar JA entra a la administración con contraseña y un segundo factor obligatorio.
- En el portal puedes activar la verificación en dos pasos con una app de autenticación. Te recomendamos hacerlo, sobre todo si eres quien carga el certificado.
- Cada empresa ve solo sus datos: la base de datos los aísla por empresa y la API comprueba la empresa en cada solicitud.
- Las claves de API se guardan solo como huella (hash SHA-256). La clave completa la ves una sola vez, al crearla, y cada ambiente tiene sus propias claves.
- Limitamos la cantidad de solicitudes para frenar abusos e intentos de adivinar contraseñas.
3. Tus datos, en tránsito y guardados
- Todas las conexiones usan HTTPS (TLS). Con la DGII verificamos, además, el certificado de sus servidores.
- La base de datos está cifrada en reposo, y el certificado lleva además nuestro propio cifrado.
- Validamos cada XML con los esquemas oficiales (XSD) de la DGII antes de enviarlo, y verificamos la firma de los e-CF que recibes.
- Los webhooks van firmados con HMAC-SHA256 para que compruebes que vienen de nosotros.
4. Registros y auditoría
- Registramos las acciones hechas en el portal y en la administración sobre empresas, certificados, claves de API y configuración, con su fecha y su dirección IP.
- Registramos también cada solicitud a la API. Los registros técnicos se conservan hasta 12 meses; los comprobantes, 10 años.
- Cada cambio del software queda en un historial de versiones y pasa por revisión y pruebas automáticas antes de publicarse. Ninguna prueba envía comprobantes reales a la DGII.
5. Infraestructura en la nube
El servicio funciona sobre proveedores de nube que operan sus centros de datos con sus propios controles de seguridad:
- Supabase: base de datos y autenticación, en Estados Unidos.
- Render: servidores de la API.
- Vercel: portal.
- Cloudflare: villarja.com y la verificación antirrobots.
- Microsoft 365: correo de avisos y de soporte.
Villar JA no tiene hoy certificaciones de seguridad propias, como ISO 27001, y no muestra sellos que no tenga.
6. Si la DGII no responde
- Si los servicios de la DGII no responden o devuelven un error temporal, el comprobante ya firmado queda en una cola y lo reenviamos solos, con esperas crecientes y sin límite de intentos, hasta transmitirlo.
- Respetamos las esperas que pide la DGII y aplazamos los envíos mientras su servicio está en mantenimiento.
- Si un comprobante lleva 72 horas en cola, te avisamos por webhook y lo seguimos intentando.
- Si declaras contingencia, queda registrado cuándo entras y cuándo sales de ella.
- Cuando un proveedor te envía un e-CF bien formado, respondemos siempre con el acuse de recibo (ARECF).
7. Si fallan nuestros sistemas
- La cola de envíos vive en la base de datos: si la API se reinicia, retoma los envíos pendientes al volver.
- Si el portal no está disponible, la API sigue emitiendo para tus integraciones.
- La base de datos tiene copias de seguridad automáticas, y el código está en un repositorio privado con todo su historial.
- Ante una interrupción imputable a Villar JA te avisamos por correo y en el portal al empezar, mientras dure y al cerrarla.
- Si el que falla es tu sistema, te guiamos para emitir según el Instructivo de Contingencia de la DGII.
8. Incidentes de seguridad
Ante un incidente revocamos las claves o sesiones afectadas, suspendemos el acceso comprometido y cambiamos los secretos que haga falta.
Si confirmamos una brecha que afecte a tus datos o a tu certificado, te avisamos por el correo de tu cuenta en un máximo de 72 horas, con lo que sepamos y lo que debes hacer. Si sospechamos que tu certificado quedó expuesto, te pediremos que lo revoques ante la entidad que lo emitió.
9. Cómo reportar un problema de seguridad
Si encuentras una vulnerabilidad, escríbenos a soporte@villarja.com con el asunto «Seguridad» y los pasos para reproducirla. No pruebes la seguridad del servicio sin nuestro permiso por escrito (Términos del servicio, sección 11).
- Correo de soporte
- soporte@villarja.com
10. Contacto
- Correo de soporte
- soporte@villarja.com
- +1-829-204-0510
- Asuntos legales y de datos
- legal@villarja.com