Operativa en modalidad Veri*Factu

Descripción

Esta modalidad se caracteriza por remitir a la AEAT los registros de facturación casi de inmediato a su emisión, y también por que estos registros no requieren ser firmados digitalmente con un certificado.

Flujo

Para facturar en esta modalidad, es necesario haber registrado la empresa con el campo workAsVeriFactu como true o actualizar este campo en caso ya haya sido registrada.

CONSIDERACIONES:
El cambio a modalidad Veri*Factu está permitido en cualquier momento del ejercicio fiscal (Del 1 de enero al 31 de diciembre).

Limitaciones impuestas por el servicio de la AEAT

Para entender por qué nuestra API opera de esta forma, es necesario conocer las limitaciones que impone la Agencia Tributaria (AEAT) en el envío de documentos:

• 🕒 Rate limit por sucursal:
  Cada sucursal (identificada por su installationNumber en el SIF / Sistema Informático) solo puede enviar 1 operación por minuto (cooldown).
• 📦 Agrupación de registros:
  Una misma operación puede contener hasta 1.000 registros (altas o bajas) en caso de llegar a los 1000 registros puede emitirse sin cooldown.
• Si se supera este límite o no hay cooldown activo, se envía automáticamente.

Estas restricciones nos llevan a proporcionar 2 modelos de emisión:

1. Modelo Asíncrono

✔ Emite registros indidividualmente.

¿Cómo funciona?

1. Se consume el endpoint deseado dentro de los disponibles en la sección de Veri*Factu / Registros de facturación.
2. Nuestro API:
   • Valida el documento.
   • Lo agrupa con otros registros de la misma sucursal.
   • Espera a cumplir 1.000 registros o el cooldown de 1 minuto.
3. Finalmente, se envía la operación a la AEAT y te notificamos el resultado vía webhook.

✅ VENTAJAS

• Sin preocupaciones por los tiempos de envío.
• Optimizado para evitar rechazos por rate limiting.

2. Modelo Síncrono

✔ Emite registros de facturación por lotes de hasta 1,000 registros por request.

¿Cómo funciona?

1. Construyes y envías la operación completa (1-1000 registros), consumiendo los endpoints de la sección Veri*Factu / Operaciones de facturación.
2. La API envía inmediatamente la solicitud a la AEAT.
3. Recibes la respuesta al finalizar la request de consumo del endpoint (éxito o error).

⚠ CONSIDERACIONES

Debes controlar manualmente:

• El cooldown de 1 minuto entre operaciones de la misma sucursal.
• No superar 1,000 registros / operación para evitar rechazos.