Verifactu: wat de taak doet die waarschuwingen naar een melding in de app escaleert

Wat de taak bij elke run doet

De taak heet Verifactu: Alert Escalation to In-App Banner. Ze draait elke vijf minuten en staat actief na installatie. Ze bestaat in alle gepubliceerde branches van de module: Odoo 17, 18, 19 en 20. De volgorde van een run is volgens de gepubliceerde code van Odoo 20 als volgt:

1. Ze berekent een drempel: de huidige tijd in UTC min vijf minuten.
2. Ze zoekt de gebeurtenissen van het type verzonden waarschuwing waarvan het tijdstempel gelijk is aan of vroeger ligt dan die drempel. De zoekopdracht gebruikt precies die twee voorwaarden: het type van de gebeurtenis en de ouderdom ervan.
3. Ze loopt die gebeurtenissen een voor een af en stuurt voor elke gebeurtenis een melding naar het kanaal van de gebruiker onder wie de methode wordt uitgevoerd. De melding is blijvend, van het type waarschuwing, en heeft als titel Verifactu Compliance Alert (Escalated).
4. Als tekst van de melding gebruikt ze de beschrijving van de gebeurtenis. Heeft de gebeurtenis geen beschrijving, dan gebruikt ze een algemene tekst die uitnodigt om de e-mail en de activiteiten te bekijken.
5. Mislukt het verzenden van een melding, dan schrijft ze een waarschuwing in het technische logboek van Odoo met de identificatie van de gebeurtenis en de reden, en gaat ze verder met de volgende gebeurtenis. Een mislukte melding onderbreekt de run niet.

Waar de gebeurtenissen staan die ze afloopt

De gebeurtenissen waar de taak naar kijkt, open je via het menu Verifactu / SIF › Audit Trail › Event Log. Elk deel van het menu vraagt rechten en als je er geen van heeft, zie je dat deel niet:

• Het deel Audit Trail vraagt Accountant, Auditor (read-only), Privacy Officer of SIF Manager.
• Het deel Verifactu / SIF vraagt Accountant, Asesoría Operator, Auditor (read-only), Privacy Officer of SIF Manager.

De tekst van de melding komt uit het veld Description van de gebeurtenis. Je ziet het op het formulier van All Events (Asesoría), in de groep Description. Op het scherm staat het zonder label: je ziet alleen de inhoud. Het verschijnt ook in de lijst van All Events (Asesoría).

Een voorbeeld: de melding die niemand zag

Voorbeeld Fictief geval: het bedrijf en de cijfers zijn verzonnen om de werkwijze uit te leggen.

Stel je een verzonnen bedrijf voor, Distribuciones Mirlo. Marta heeft de rol SIF Manager en een collega vertelt haar dat hij een Verifactu-melding op zijn scherm kreeg. Zij heeft er geen gekregen en wil begrijpen waarom.

Eerst opent ze het Libro de Eventos en zoekt een gebeurtenis van een verzonden waarschuwing. Op het formulier leest ze de inhoud van de groep Description: dat is precies de tekst van de melding. Was het veld leeg geweest, dan zou de melding met de algemene tekst verschijnen die naar de e-mail en de activiteiten verwijst. Een melding met die tekst is dus geen fout.

Daarna denkt ze aan het tijdstip. De gebeurtenis moet vijf minuten oud zijn vanaf het tijdstempel en de taak draait elke vijf minuten, dus de melding komt bij de eerste run na die drempel, niet op het moment zelf waarop de waarschuwing wordt geregistreerd.

Tot slot noteert ze een vraag voor wie de server beheert: de code stuurt de melding naar het kanaal van de gebruiker onder wie de methode wordt uitgevoerd en ze wil weten wie dat is. Ze vraagt ook om het technische logboek van Odoo na te kijken op waarschuwingen over een niet verzonden melding met de identificatie van die gebeurtenis.

Wat het voorbeeld leert: de taak laat zich uitleggen met drie vragen. Is er een waarschuwingsgebeurtenis die oud genoeg is? Welke tekst bevat ze? En naar welke gebruiker gaat de melding?

Wat je nakijkt als de taak niets doet

• Dat de gebeurtenis bestaat. Zijn er geen gebeurtenissen van een verzonden waarschuwing die minstens vijf minuten oud zijn, dan vindt de zoekopdracht niets en wordt er geen enkele melding verzonden.
• Dat de taak actief blijft. Ze staat actief na installatie. Vraag aan de beheerder van Odoo om te bevestigen dat de taak met die naam nog actief is.
• De tekst van de melding. Een melding met de algemene tekst betekent dat de gebeurtenis geen beschrijving had. Bekijk de beschrijving van de gebeurtenis op het formulier van All Events (Asesoría), in de groep Description.
• Het technische logboek. Als het verzenden van een melding mislukt, blijft er een waarschuwing achter met de identificatie van de gebeurtenis en de reden, en gaat de taak verder met de rest.
• De ontvangende gebruiker. De melding gaat naar het kanaal van de gebruiker onder wie de methode wordt uitgevoerd. Wie dit nakijkt, moet daar rekening mee houden voordat hij concludeert dat de melding niet is verzonden.

Per versie

De taak zit in alle gepubliceerde branches van de module (17.0, 18.0, 19.0 en 20.0) en de module is voor die vier gepubliceerd in Odoo Apps. In Odoo 17.0 is de taak ingesteld om zich eindeloos te herhalen. Het detail van de run dat je hebt gelezen, komt uit de code van Odoo 20.

Zo helpt FlexigoTech

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Als je de module implementeert en samen wilt nakijken wie de meldingen ontvangt en hoe de gebeurtenissen worden gelezen, kun je ons schrijven. De module staat op de Odoo Apps-pagina.

Lees verder

Gecontroleerd in de broncode van de module (versie 17.0 en 20.0) en in de gelinkte bronnen

Bronnen

• Broncode van de module: flexigo_spain_verifactu 20.0 (1fdc980f): data/verifactu_crons.xml
• Broncode van de module: flexigo_spain_verifactu 17.0 (8d43d727): data/verifactu_crons.xml
• Broncode van de module: 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