# 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.

Véase: [Conservación de comprobantes](https://villarja.com/ecf/conservacion.md).

## 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.

Véase: [Qué datos trata cada proveedor: Privacidad del servicio](https://villarja.com/ecf/privacidad.md).

## 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](mailto:soporte@villarja.com?subject=Seguridad)

## 10. Contacto

- **Correo de soporte:** [soporte@villarja.com](mailto:soporte@villarja.com)
- **WhatsApp:** [+1-829-204-0510](https://wa.me/18292040510)
- **Asuntos legales y de datos:** [legal@villarja.com](mailto:legal@villarja.com)

Otras páginas del servicio: [API e-CF](https://villarja.com/ecf.md) · [Términos del servicio e-CF](https://villarja.com/ecf/terminos.md) · [Privacidad del servicio e-CF](https://villarja.com/ecf/privacidad.md) · [Reembolsos y cancelación del e-CF](https://villarja.com/ecf/reembolsos.md) · [Soporte del e-CF](https://villarja.com/ecf/soporte.md) · [Seguridad y continuidad del e-CF](https://villarja.com/ecf/seguridad.md) · [Conservación de comprobantes](https://villarja.com/ecf/conservacion.md).
