Verifactu: què fa la tasca que escala alertes a un avís a l'aplicació

Què fa la tasca a cada passada

La tasca es diu Verifactu: Escalat d'Alertes a Avís a l'Aplicació. Corre cada cinc minuts i ve activa en instal·lar. Existeix a totes les branques publicades del mòdul: Odoo 17, 18, 19 i 20. L'ordre d'una passada, segons el codi publicat d'Odoo 20, és aquest:

1. Calcula un tall: l'hora actual en UTC menys cinc minuts.
2. Cerca els esdeveniments de tipus alerta enviada la marca de temps dels quals sigui igual o anterior a aquest tall. La cerca es fa per aquestes dues condicions, el tipus de l'esdeveniment i la seva antiguitat.
3. Recorre aquests esdeveniments d'un en un i, per a cadascun, envia un avís al canal de l'usuari amb el qual s'executa el mètode. L'avís és persistent, de tipus advertència, i porta el títol Alerta de Compliment Verifactu (Escalada) (Verifactu Compliance Alert (Escalated)).
4. Com a text de l'avís fa servir la descripció de l'esdeveniment. Si l'esdeveniment no té descripció, fa servir un text genèric que convida a revisar el correu electrònic i les activitats.
5. Si l'enviament d'un avís falla, escriu una advertència al registre tècnic d'Odoo amb l'identificador de l'esdeveniment i el motiu, i continua amb el següent esdeveniment. Un avís que falla no talla la passada.

On són els esdeveniments que recorre

Els esdeveniments que mira la tasca són els que s'obren des del menú Verifactu / SIF › Registre d'Auditoria › Llibre d'Esdeveniments (Verifactu / SIF › Audit Trail › Event Log). Cada tram del menú demana permisos i, si no en tens un, no veus aquest tram:

• El tram Registre d'Auditoria (Audit Trail) demana Comptable (Accountant), Auditor (només lectura) (Auditor (read-only)), Responsable de Privadesa (Privacy Officer) o Gestor SIF (SIF Manager).
• El tram Verifactu / SIF demana Comptable, Operador d'Assessoria (Asesoría Operator), Auditor (només lectura), Responsable de Privadesa o Gestor SIF.

El text de l'avís surt del camp Descripció (Descripcion) de l'esdeveniment. El veus a la fitxa de Tots els Esdeveniments (Assessoria) (All Events (Asesoría)), dins del grup Descripció (Description). En pantalla va sense etiqueta: només es veu el seu contingut. També apareix a la llista de Tots els Esdeveniments (Assessoria).

Un cas il·lustratiu: l'avís que ningú va veure

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Imagina una empresa inventada, Distribuciones Mirlo. La Marta porta el rol Gestor SIF i un company li comenta que li ha saltat un avís de Verifactu en pantalla. A ella no li n'ha sortit cap i vol entendre per què.

Primer obre el Libro de Eventos i cerca un esdeveniment d'alerta enviada. En obrir-ne la fitxa llegeix el contingut del grup Descripció: aquest és just el text que porta l'avís. Si el camp estigués buit, l'avís sortiria amb el text genèric que remet al correu i a les activitats, així que un avís amb aquest text no seria un error.

Després pensa en el moment. L'esdeveniment ha d'haver complert cinc minuts des de la seva marca de temps, i la tasca corre cada cinc minuts, així que l'avís arriba a la primera passada posterior a aquest tall, no en el mateix instant en què es registra l'alerta.

Finalment s'apunta una pregunta per a qui administri el servidor: el codi envia l'avís al canal de l'usuari amb el qual s'executa el mètode, i vol saber quin és. Demana també que revisi el registre tècnic d'Odoo per si hi ha advertències d'avís no enviat amb l'identificador d'aquest esdeveniment.

El que aprèn el cas: la tasca s'explica amb tres preguntes, hi ha un esdeveniment d'alerta amb antiguitat suficient?, quin text porta? i a quin usuari s'envia l'avís?

Què mirar si la tasca no fa res

• Que existeixi l'esdeveniment. Si no hi ha esdeveniments d'alerta enviada amb almenys cinc minuts d'antiguitat, la cerca no troba res i no s'envia cap avís.
• Que la tasca continuï activa. Ve activa en instal·lar. Demana a qui administri Odoo que confirmi que la tasca amb aquest nom continua activa.
• El text de l'avís. Un avís amb el text genèric vol dir que l'esdeveniment no tenia descripció. Consulta la descripció de l'esdeveniment a la fitxa de Tots els Esdeveniments (Assessoria), dins del grup Descripció.
• El registre tècnic. Quan un avís falla en enviar-se, queda una advertència amb l'identificador de l'esdeveniment i el motiu, i la tasca continua amb els altres.
• L'usuari destinatari. L'avís s'envia al canal de l'usuari amb el qual s'executa el mètode. Qui ho revisi ha de tenir-ho en compte abans de concloure que l'avís no s'ha enviat.

Per versions

La tasca és a totes les branques publicades del mòdul (17.0, 18.0, 19.0 i 20.0), i el mòdul està publicat a Odoo Apps per a aquestes quatre. A Odoo 17.0, la tasca està configurada per repetir-se sense fi. El detall de la passada que has llegit és el del codi d'Odoo 20.

Com ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Si estàs implantant el mòdul i vols revisar amb nosaltres qui rep els avisos i com es llegeixen els esdeveniments, ens pots escriure. El mòdul és a la fitxa d'Odoo Apps.

Continua llegint

Comprovat al codi del mòdul (versió 17.0 i 20.0) i a les fonts enllaçades

Fonts

• Codi del mòdul: flexigo_spain_verifactu 20.0 (1fdc980f): data/verifactu_crons.xml
• Codi del mòdul: flexigo_spain_verifactu 17.0 (8d43d727): data/verifactu_crons.xml
• Codi del mòdul: flexigo_spain_verifactu 20.0 (1fdc980f): models/verifactu_evento.py
• apps.odoo.com/apps/modules/20.0/flexigo_spain_verifactu
• flexigotech.com/en/services.html