Scrive Connector: Was die stündliche Aufgabe zur Abfrage ausstehender Dokumente tut

Was diese Aufgabe ist und wann sie läuft

Die Aufgabe Scrive: ausstehende Signaturdokumente abfragen ist in allen veröffentlichten Versionen enthalten (Odoo 17, 18, 19 und 20), läuft stündlich und ist nach der Installation aktiv. In Odoo 17 ist sie so konfiguriert, dass sie sich unbegrenzt wiederholt.

Sie ist eine Absicherung. Laut Code dient sie dazu, Benachrichtigungen von Scrive nachzuholen, die nicht angekommen sind: Scrive empfiehlt Benachrichtigungen als Hauptweg, und die Abfrage bleibt maßvoll, um die Limits von Scrive einzuhalten. Bei einem Dokument, das direkt auf der Scrive-Website erstellt wurde und keine Odoo-Benachrichtigungsadresse hat, ist die Abfrage der einzige Weg zur Aktualisierung.

Was sie bei jedem Durchlauf tut

1. Sie prüft, ob ein FlexigoTech-Cloud-Dienst vorhanden ist. Ist keiner vorhanden, ruft sie Scrive nicht auf und markiert nichts: Die Dokumente behalten ihren Platz in der Warteschlange.
2. Sie wählt die infrage kommenden Dokumente aus, bis zu 50 pro Durchlauf.
3. Für jedes Dokument fragt sie Scrive nach dem Dokument, sperrt dessen Datensatz, synchronisiert es und vermerkt, dass die Abfrage erfolgreich war.
4. In der Produktivumgebung bestätigt sie die Änderungen Dokument für Dokument, sodass ein fehlerhafter Datensatz den Stapel nicht abbricht.
5. Sie hält an, wenn ihr Zeitbudget aufgebraucht ist. Was sie nicht mehr abfragen konnte, bleibt in der Warteschlange, geordnet nach dem Datum der nächsten Abfrage, für den nächsten Durchlauf.

Wen sie abfragt

Infrage kommen Dokumente, die eine Scrive-Dokument-ID haben (schreibgeschützt auf der Karte der Signaturdokumente), nicht im Papierkorb liegen und deren Abfrage nicht verschoben ist. Zwei Warteschlangen teilen sich das Kontingent:

• Zuerst die Dokumente, deren Signaturstatus sich noch ändern kann: ausstehende, auf den Start wartende, Entwürfe mit Scrive-ID (falls die Antwort auf den Start verloren ging) und fehlerhafte.
• Danach die abgeschlossenen, deren versiegeltes PDF nie angekommen ist: ohne Markierung als heruntergeladen und ohne signierten Anhang. Würde die erste Warteschlange das Kontingent allein ausfüllen, wird für diese mindestens ein Platz reserviert.

Die Reihenfolge richtet sich nach der nächsten Abfrage (Dokumente ohne Datum zuerst) und dann nach der Kennung.

Was sich beim Synchronisieren ändert

Je nach Antwort von Scrive aktualisiert das Dokument seinen Status (sofern die Änderung erlaubt ist), seine Daten und den Titel. Meldet Scrive, dass es versiegelt ist, wird das markiert. Wird das Dokument abgeschlossen, setzt es das Signaturdatum auf das der letzten Signatur und lädt das versiegelte PDF herunter, falls Scrive es bereits hat und noch kein Anhang vorhanden ist.

Abgeschlossene Dokumente, die über den Import aus dem Scrive-Archiv kommen, laden das PDF nicht sofort herunter: Die stündliche Aufgabe holt es später nach.

Wenn etwas nicht klappt

• Fehler bei Scrive (Scrive nicht erreichbar, Dokument verschwunden, Konto falsch konfiguriert): Das Dokument vermerkt den Fehler, zählt die Versuche und verschiebt seine nächste Abfrage. Die Verzögerung verdoppelt sich mit jedem aufeinanderfolgenden Fehler bis zu einem Maximum. Der Durchlauf geht mit den übrigen weiter.
• Dokument belegt: Wenn gerade eine Benachrichtigung von Scrive genau dieses Dokument synchronisiert, lässt die Aufgabe es für den nächsten Durchlauf liegen. Das zählt nicht als Fehler.
• Pause von FlexigoTech Cloud: Reicht der Dienst den Aufruf nicht weiter, wird nichts markiert und der Durchlauf hält dort an.

Wenn eine Abfrage gelingt, springt der Fehlerzähler auf null. Antwortet Scrive, aber das Dokument bleibt fehlerhaft, bleibt es mit einer Abfrage pro Tag in der Warteschlange, damit es das Kontingent der ausstehenden nicht belegt.

Ein anschauliches Beispiel, vom normalen Durchlauf bis zur Pause

Beispiel Fiktiver Fall: Firma und Zahlen sind erfunden, um den Ablauf zu zeigen.

Mobiliario Costa Norte ist ein erfundenes Unternehmen, das Scrive Connector nutzt.

Montag: ein in Scrive erstellter Vertrag

Ein Vertriebsmitarbeiter erstellt einen Vertrag direkt auf der Scrive-Website. Da er keine Odoo-Benachrichtigungsadresse hat, hält ihn nur die Abfrage auf dem Laufenden. Er holt ihn mit Aus dem Scrive-Archiv importieren nach Odoo, und er erscheint unter Scrive › Signaturdokumente. Jede Stunde nimmt die Aufgabe ihn unter die infrage kommenden Dokumente auf, solange sich sein Signaturstatus ändern kann.

Sobald der Kunde unterschreibt und Scrive das Dokument als abgeschlossen meldet, schließt es der nächste Durchlauf (sofern der Statuswechsel erlaubt ist), setzt das Signaturdatum und lädt das versiegelte PDF herunter, falls Scrive es bereits hat.

Dienstag: Scrive antwortet nicht

Bei einem Dokument schlägt die Abfrage fehl. Die Aufgabe hält nicht an: Das Dokument vermerkt den Fehler, verschiebt seinen nächsten Versuch, und die übrigen werden synchronisiert. Sobald Scrive wieder erreichbar ist, setzt eine erfolgreiche Abfrage den Fehlerzähler auf null zurück.

Mittwoch: eine Benachrichtigung trifft gleichzeitig ein

Scrive meldet eine Signatur genau dann, wenn die Aufgabe dieses Dokument abfragt. Die Aufgabe betrachtet es als belegt und zählt keinen Fehler. Die Benachrichtigung erledigt die Arbeit, und der nächste Durchlauf findet nichts Ausstehendes.

Donnerstag: das Abonnement wird ausgesetzt

Der FlexigoTech-Cloud-Dienst wird ausgesetzt. Die Aufgabe läuft weiter stündlich, ruft aber Scrive nicht auf und markiert nichts, und die Dokumente warten in der Warteschlange. Bei ausgesetztem Dienst stoppt, was das Abonnement liefert, und die Daten bleiben in Ihrem Odoo.

Was Sie prüfen, wenn die Aufgabe nichts tut

• Die Aufgabe ist weiterhin aktiv. Sie ist nach der Installation aktiv; prüfen Sie, dass sie niemand deaktiviert hat.
• Der FlexigoTech-Cloud-Dienst. Ohne Dienst endet der Durchlauf ohne Abfrage. Das Modul ist eine Einmalzahlung pro Version und braucht das Abonnement: Der Plan Conector kostet 49 €/Monat oder 490 €/Jahr zzgl. MwSt.
• Die Dokumentenkarte. Sie muss eine Scrive-Dokument-ID und das erwartete Konto haben, auch in der Liste sichtbar.
• Der Status. Nur die oben beschriebenen Status und abgeschlossene Dokumente ohne versiegeltes PDF kommen infrage. Ein abgeschlossenes mit bereits heruntergeladenem PDF wird nicht abgefragt.
• Frühere Fehler. Nach mehreren aufeinanderfolgenden Fehlern kann die nächste Abfrage weit entfernt liegen.
• Das Kontingent. Bis zu 50 pro Durchlauf, die ausstehenden zuerst. Wenn Scrive langsam antwortet, beendet das Zeitbudget den Durchlauf, und der Rest wartet.
• Das Serverprotokoll. Es erfasst jeden Durchlauf: Pause wegen fehlendem Dienst, aktualisierte, fehlgeschlagene und belegte Dokumente sowie die, die für den nächsten Durchlauf bleiben.

Was Sie aus dem Fall lernen

Die Aufgabe lässt nicht zu, dass ein problematisches Dokument die Warteschlange blockiert, und eine Pause von FlexigoTech Cloud zählt nicht als Fehler von Scrive. Wenn Sie bei einer Version unsicher sind, sehen Sie nach, was sich zwischen den Versionen ändert.

Wie FlexigoTech hilft

FlexigoTech führt Odoo 17, 18, 19 und 20 ein und entwickelt Konnektoren und individuelle Integrationen. Das Modul finden Sie auf seiner Seite.

Weiterlesen

Geprüft im Quellcode des Connectors (Version 17.0 und 20.0) und in den verlinkten Quellen

Quellen

• Quellcode des Moduls: flexigobe_scrive_connector 20.0 (21b3b940): data/ir_cron.xml
• Quellcode des Moduls: flexigobe_scrive_connector 17.0 (b9f2fc7f): data/ir_cron.xml
• Quellcode des Moduls: flexigobe_scrive_connector 20.0 (21b3b940): models/scrive_document.py
• flexigotech.com/precios.html
• flexigotech.com/en/services.html