Gestión de certificados digitales

🔐

Debes conocer que el certificado digital que se indique al registrar o actualizar una empresa, se utilizará para la autenticación con la AEAT y el firmado de documentos en facturación en modalidad No Veri*Factu; no obstante, existen ciertas diferencias entre ambientes que debes considerar:

• SANDBOX

Debes registrar NIF y Nombre / Razón social de prueba, NO los propios, sino los que te proporcionaremos, debido a que el ambiente de pruebas del servicio de Veri*Factu no admite datos reales.

Datos de prueba

# 🏢 Persona jurídica
nif="A39200019"
name="CERTIFICADO ENTIDAD PRUEBAS"
# 🧙🏼‍♂️ Persona física
nif="99999910G"
name="CERTIFICADO FISICA PRUEBAS"

Si no utilizas estos datos tendrás errores al facturar, debido a lo mencionado anteriormente.

Además, si deseas simular la facturación utilizando un certificado propio, estableciendo useAlegraCertificate en false, es requerido subir un certificado válido; sin embargo, este no será almacenado, por lo que no se usará en el proceso de autenticación (con el fin de probar si sus certificados pasan las validaciones implementadas). En su lugar, se empleará internamente un certificado de pruebas, dependiendo del tipo de persona (física o jurídica).

Por otro lado, si useAlegraCertificate se establece en true, no se utilizará el certificado de Alegra, sino uno de los certificados de prueba que tenemos disponibles.

• PRODUCCIÓN

Debes registrar los NIF y Nombre / Razón social que corresponda con normalidad (incluso serán validados contra la AEAT), y subir tu certificado digital en caso así lo desees, estableciendo el campo useAlegraCertificate en false, o en su defecto, en true, para que estos procesos se realicen con el certificado de Alegra.

Restricciones transversales

🚧

Para garantizar que tu integración funcione correctamente en Producción, el entorno Sandbox replica las mismas validaciones técnicas y normativas de la AEAT. Esto significa que:

• Evita números de serie duplicados (la API los rechazará, al igual que en el entorno real).
• No puedes anular facturas que no existan (simulamos el comportamiento real de la AEAT).
• No puedes anular facturas que ya fueron anuladas.
• No puedes referenciar facturas que no existan o no cumplan las reglas de negocio respectivas y especificadas en la documentación (para rectificación o sustitución de facturas).

También, requieres configuración previa:

• Primero debes registrar una empresa y una sucursal en nuestro sistema.
• Luego, ya podrás facturar con normalidad.

Sugerencias

👂

Pasos para migrar a PRODUCCIÓN:

• Valida tu integración en Sandbox con diferentes escenarios (aceptación, rechazo, etc.).
• Prepara tu certificado digital, ya que debes tener su contenido en base64 y disponer de su contraseña.
• Solicita acceso a PRODUCCIÓN para que todo funcione correctamente. Consulta la siguiente sección aquí.
• Monitoriza los envíos mediante webhooks para manejar posibles incidencias.

⚠️ NO USES el entorno de PRODUCCIÓN hasta haber completado las pruebas en SANDBOX, ya que los documentos emitidos aquí son vinculantes ante la AEAT.