Scrive Connector: què fa cada hora la tasca que sondeja documents pendents

Què és aquesta tasca i quan corre

La tasca Scrive: poll pending signature documents és a totes les branques publicades (Odoo 17, 18, 19 i 20), corre cada hora i ve activa en instal·lar. A Odoo 17 porta configurat que es repeteixi sense fi.

És un reforç. Segons el codi, serveix per recuperar avisos de Scrive que no han arribat: Scrive recomana els avisos com a via principal i el sondeig es manté moderat per respectar els seus límits. Per a un document creat a la mateixa web de Scrive, sense adreça d'avís d'Odoo, el sondeig és l'única via d'actualització.

Què fa a cada passada

1. Comprova que hi ha servei de FlexigoTech Cloud. Si no n'hi ha, no crida Scrive ni marca res: els documents conserven el seu lloc a la cua.
2. Tria els documents candidats, fins a 50 per passada.
3. Per a cadascun pregunta a Scrive pel document, bloqueja el seu registre, el sincronitza i deixa anotat que la consulta ha anat bé.
4. En producció confirma els canvis document a document, de manera que un registre que falli no avorta el lot.
5. S'atura si esgota el seu pressupost de temps. El que no ha arribat a consultar continua a la cua, ordenat per la data de la propera consulta, per a la passada següent.

A qui pregunta

Entren els documents que tenen Scrive Document ID (només lectura a la fitxa de Signature Documents), no són a la paperera i no tenen la consulta ajornada. Hi ha dues cues que comparteixen el cupo:

• Primer, els documents l'estat de signatura dels quals encara pot canviar: pendents, en espera d'inici, en esborrany amb ID de Scrive (per si es va perdre la resposta de l'inici) i en error.
• Després, els tancats el PDF segellat dels quals mai no ha arribat: sense marca de descarregat i sense adjunt signat. Si la primera cua ompliria ella sola el cupo, es reserva almenys un lloc per a aquesta.

L'ordre és per propera consulta (els que no tenen data, primer) i després per identificador.

Què canvia en sincronitzar

Segons el que retorna Scrive, el document actualitza el seu estat (si el canvi és permès), les seves dates i el títol. Si Scrive indica que està segellat, el marca. Si el document queda tancat, fixa la data de signatura amb la de l'última signatura i, si Scrive ja té el PDF segellat i encara no hi ha adjunt, el descarrega.

Els documents tancats que arriben amb la importació de l'arxiu de Scrive no descarreguen el PDF en aquell moment: la tasca horària el porta després.

Quan alguna cosa no va bé

• Error amb Scrive (Scrive caigut, document desaparegut, compte mal configurat): el document anota l'error, compta els intents i ajorna la seva propera consulta. El retard es duplica amb cada error seguit fins a un màxim. La passada continua amb els altres.
• Document ocupat: si un avís de Scrive està sincronitzant aquest mateix document, la tasca el deixa per a la passada següent. No compta com a error.
• Pausa de FlexigoTech Cloud: si el servei no passa la crida, no es marca res i la passada s'atura aquí.

Quan una consulta surt bé, el comptador d'errors torna a zero. Si Scrive respon però el document continua en error, es queda a la cua amb una consulta al dia perquè no ocupi el cupo dels pendents.

Un cas il·lustratiu, de la passada normal a la pausa

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

Mobiliario Costa Norte és una empresa inventada que fa servir Scrive Connector.

Dilluns: un contracte creat a Scrive

Un comercial crea un contracte directament a la web de Scrive. Com que no té adreça d'avís d'Odoo, el sondeig és l'única cosa que el mantindrà al dia. El porta a Odoo amb Import from Scrive Archive i apareix a Scrive › Signature Documents. Cada hora la tasca l'inclou entre els candidats mentre el seu estat de signatura pugui canviar.

Quan el client signa i Scrive dona el document per tancat, la passada següent el tanca (si el canvi d'estat és permès), fixa la data de signatura i, si Scrive ja té el PDF segellat, el descarrega.

Dimarts: Scrive no respon

Un document falla en la consulta. La tasca no s'atura: el document anota l'error, ajorna el seu proper intent i els altres es sincronitzen. Quan Scrive torna, una consulta correcta posa a zero el comptador d'errors.

Dimecres: un avís arriba alhora

Scrive avisa d'una signatura just quan la tasca consulta aquest document. La tasca el dona per ocupat i no compta error. L'avís fa la feina i la passada següent no trobarà res pendent.

Dijous: la subscripció se suspèn

El servei de FlexigoTech Cloud queda suspès. La tasca continua corrent cada hora, però no crida Scrive ni marca res, i els documents esperen a la cua. Amb el servei suspès s'atura el que dona la subscripció i les dades es queden al teu Odoo.

Què mirar si la tasca no fa res

• La tasca continua activa. Ve activa en instal·lar; comprova que ningú no l'ha desactivada.
• El servei de FlexigoTech Cloud. Sense servei, la passada acaba sense consultar. El mòdul és de pagament únic per versió i necessita la subscripció: el pla Connector costa 49 €/mes o 490 €/any sense IVA.
• La fitxa del document. Ha de tenir Scrive Document ID i el Account esperat, visible també a la llista.
• L'estat. Només entren els estats descrits a dalt i els tancats sense PDF segellat. Un de tancat amb el seu PDF ja descarregat no es consulta.
• Errors anteriors. Després de diversos errors seguits, la propera consulta pot quedar lluny.
• El cupo. Fins a 50 per passada, amb els pendents primer. Si Scrive triga, el pressupost de temps talla la passada i la resta espera.
• El registre del servidor. Recull cada passada: pausa per manca de servei, documents actualitzats, fallits, ocupats i els que queden per a la següent.

Què aprendre del cas

La tasca no deixa que un document problemàtic bloquegi la cua, i una pausa de FlexigoTech Cloud no compta com a error de Scrive. Si una versió et genera dubtes, mira què canvia entre branques.

Com ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Pots veure el mòdul a la seva pàgina.

Continua llegint

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

Fonts

• Codi del mòdul: flexigobe_scrive_connector 20.0 (21b3b940): data/ir_cron.xml
• Codi del mòdul: flexigobe_scrive_connector 17.0 (b9f2fc7f): data/ir_cron.xml
• Codi del mòdul: flexigobe_scrive_connector 20.0 (21b3b940): models/scrive_document.py
• flexigotech.com/precios.html
• flexigotech.com/en/services.html