English
Català
Deutsch
Français
Português
Italiano
Nederlands
PolskiQué es esta tarea y cada cuánto corre
¿Qué es y cómo viene configurada?
Es una tarea programada del módulo de VeriFactu que trabaja sobre la cola de envío a la AEAT. Viene activa al instalar y corre cada minuto. Está en las ramas publicadas para Odoo 17.0, 18.0, 19.0 y 20.0; en 17.0 lleva configurado que se repite sin fin.
¿Envía a la AEAT cada minuto?
La tarea se ejecuta cada minuto, pero eso no significa una petición por minuto. Cada respuesta de la AEAT trae TiempoEsperaEnvio, los segundos hasta el siguiente envío. Según el código de Odoo 20.0, el módulo guarda esa hora para la empresa y no le envía nada antes de que llegue (con una excepción que verás más abajo).
¿Dónde veo las entradas que procesa?
En el menú Verifactu / SIF › Envío a AEAT › Cola de Envío (Verifactu / SIF › AEAT Submission › Submission Queue). Cada tramo del menú pide permisos y, si no tienes uno, no ves ese tramo. El tramo Envío a AEAT pide Contable (Accountant), Auditor (solo lectura) (Auditor (read-only)) o Gestor SIF (SIF Manager). El tramo Verifactu / SIF pide alguno de estos: Contable, Operador de Asesoría (Asesoría Operator), Auditor (solo lectura), Responsable de Privacidad (Privacy Officer) o Gestor SIF. El campo Referencia (Reference) de cada entrada se ve en su ficha, la de Errores AEAT (AEAT Errors), dentro del grupo Entrada de la Cola (Queue Entry), y también en la lista.
Qué hace en cada pasada
¿A qué empresas atiende y cuándo se salta una?
Solo recorre las empresas que tienen VeriFactu activado. Para cada una mira dos horas guardadas, una de ellas la del tiempo de espera de la última respuesta de la AEAT. Si todavía no ha llegado alguna de esas horas, salta la empresa en esta pasada y lo anota en el log del servidor. La excepción es la espera de la última respuesta: si hay 1.000 entradas o más esperando (pendientes o en reintento), la empresa no espera por ella.
¿Qué hace con las entradas de una empresa?
Pide el lote de la cola de esa empresa y, si no hay nada, termina con ella sin más. Las entradas que no tienen ni registro ni anulación enlazados las marca como fallidas. El resto las ordena por número de registro, porque cada registro nombra a su predecesor en el encadenamiento. Después prepara cada una como alta o como anulación y las manda juntas en una sola petición a la AEAT. Según la AEAT, un envío lleva de 1 a 1.000 registros.
¿Qué pasa con la respuesta, o con el fallo?
Si la AEAT responde, el módulo aplica a cada entrada su resultado. La respuesta trae EstadoEnvio (Correcto, ParcialmenteCorrecto o Incorrecto) y un estado por registro (Correcto, AceptadoConErrores o Incorrecto). Si trae tiempo de espera, el módulo guarda la hora hasta la que esa empresa no vuelve a enviar. Si la petición falla con un 429, el módulo la trata por un camino distinto al del resto de errores. Con cualquier otro error, pasa cada entrada por el tratamiento de error HTTP y, si alguna entrada queda descartada, lanza una sola alerta para todo el lote en vez de una por factura. Al final de la empresa, pide a su cadena un único recálculo para todas las entradas.
¿Reenvía lo que la AEAT ya aceptó?
Un registro duplicado vuelve de la AEAT con el código 3000. Si ya consta como correcto o aceptado con errores, no hay que reenviarlo.
Si parece que no hace nada
¿Qué compruebo primero?
Comprueba que la tarea sigue activa (viene activa al instalar), que la empresa tiene VeriFactu activado y que la lista de Cola de Envío tiene entradas. Mira también si la empresa está en una espera: tras una respuesta de la AEAT aguarda el tiempo que esta indicó, y esa pasada queda anotada en el log del servidor. Una pasada con el lote vacío termina sin enviar nada. Si el problema está en el certificado, la AEAT redirige sin certificado a la página de error 4033 («no se detecta certificado») y con un certificado que no valida, a la 4011.
¿Un error en una empresa bloquea a las demás?
Según el código, no. Cada empresa se procesa dentro de su propio control de errores: si falla, el error queda en el log del servidor con el nombre de la empresa y la tarea sigue con la siguiente.
¿Qué es el resumen de salud del final?
Cuando termina con todas las empresas, y solo si algo falló durante la pasada, la tarea prepara un resumen de salud para FlexigoTech Cloud con fines de monitorización. No lo manda en cada pasada, sino a intervalos mínimos entre informes. Lleva el número de entradas pendientes o en reintento y de las descartadas, y los errores agrupados por tipo, código y cuántas veces salieron.
Ayuda con tu implantación
Si estás implantando Odoo y quieres revisar cómo queda esta cola con tus empresas, en FlexigoTech implantamos Odoo 17, 18, 19 y 20 y desarrollamos conectores e integraciones a medida.
Sigue leyendo
Comprobado en el código del módulo (versión 17.0 y 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigo_spain_verifactu 20.0 (1fdc980f): data/verifactu_crons.xml
- Código del módulo: flexigo_spain_verifactu 17.0 (8d43d727): data/verifactu_crons.xml
- Código del módulo: flexigo_spain_verifactu 20.0 (1fdc980f): models/verifactu_cola_envio.py
- apps.odoo.com/apps/modules/20.0/flexigo_spain_verifactu
- prewww2.aeat.es/static_files/common/internet/dep/aplicaciones/es/aeat/tikeV1.0/cont/ws/Sis
- sede.agenciatributaria.gob.es/Sede/errores/erro4033.html
- flexigotech.com/en/services.html