Récupérer des documents envoyés au parapheur distant

Prérequis : avoir configuré le fichier de paramétrage comme indiqué ici.

Un batch permet de regarder si les documents ont été signés ou refusés dans le parapheur distant.

1) Paramétrage xml

La configuration se trouve dans le fichier apps/maarch_entreprise/xml/config.json

{
    "config": {
        ...
        "maarchDirectory" : "/var/www/html/MaarchCourrier/",
        "customID" : "",
        "maarchUrl" : "http://preview.maarchcourrier.com/"
    },
    ...
    "signatureBook": {
        "userWS": "superadmin",
        "passwordWS": "superadmin",
        "validatedStatus": "EENV",
        "validatedStatusOnlyVisa": "EENV",
        "refusedStatus": "REJ_SIGN",
        "validatedStatusAnnot": "COU",
        "refusedStatusAnnot": "RET"
    }
}

• MaarchDirectory : Chemin absolu vers votre application Maarch courrier
• customID : Identifiant de votre custom
• MaarchUrl : Url de votre aplication Maarch Courrier. NE PAS METTRE localhost NI 127.0.0.1
• validatedStatus : Statut dans lequel sera le courrier principal lorsque la pièce jointe aura été signée (visible dans la table status de la base de données Maarch Courrier)
• validatedStatusOnlyVisa : Statut dans lequel sera le courrier principal lorsque la pièce jointe aura été validée sans signature (utilisable uniquement avec xParaph)
• refusedStatus : Statut dans lequel sera le courrier principal lorsque la pièce jointe aura été refusée (visible dans la table status de la base de données Maarch Courrier)
• validatedStatusAnnot : Statut dans lequel sera le courrier principal lorsque le document aura été annoté et validé (visible dans la table status de la base de données Maarch Courrier)
• refusedStatusAnnot : Statut dans lequel sera le courrier principal lorsque le document aura été annoté et refusé (visible dans la table status de la base de données Maarch Courrier)
• userWS : Identifiant d'un utilisateur de votre application Maarch Courrier. Il est recommandé d'utiliser un compte de webservice
• passwordWS : Mot de passe de l'utilisateur ci-dessus

2) Batch

Copier le fichier bin/signatureBook/scripts/retrieveMailFromExternalSignatoryBook.sh.default en bin/signatureBook/scripts/retrieveMailFromExternalSignatoryBook.sh
Adapter les chemins selon votre environnement.

Ce batch doit être mis en tâche planifiée afin d'être exécuté régulièrement.

Dans le cas où FAST-Parapheur est connecté, l'éditeur du parapheur recommande de lancer le script toutes les 30 minutes maximum, à des heures décalées (Exemple : 10h23, 11h48, ...)

3) Fonctionnement

Le batch regarde :

• toutes les pièces jointes qui ont été envoyées au parapheur pour signature, et qui ne sont pas revenues.
• tous les documents qui ont été envoyées au parapheur pour annotation, et qui ne sont pas revenus On vérifie si le document a été refusé ou signé dans le parapheur.

Si la pièce jointe a été signée, on l'a récupère, et on l'ajoute en tant que pièce jointe signée. On passe le courier au statut défini dans la balise validatedStatus
Si la pièce jointe a été refusée, on récupère la note de refus, et on l'ajoute en tant que note au document dans Maarch Courrier. On passe le courier au statut défini dans la balise refusedStatus

Cas particulier MaarchParapheur :
Si la pièce jointe a été refusée, on la récupère, et on l'ajoute en tant que pièce jointe. On passe le courier au statut défini dans la balise refusedStatus
Si le document a été annoté et validé, on le récupère, et on l'ajoute en tant que pièce jointe annotée. On passe le courier au statut défini dans la balise validatedStatusAnnot
Si le document a été annoté et refusé, on le récupère, et on l'ajoute en tant que pièce jointe annotée. On passe le courier au statut défini dans la balise refusedStatusAnnot

Cas particulier : Si plusieurs pièces jointes d'un même courrier ont été envoyées dans un parapheur distant, on passe le courrier au statut validatedStatus seulement si toutes les pièces jointes sont revenues signées

	Si vous avez plusieurs instances de Maarch Courrier connecté à un parapheur externe, vous pouvez configurer la récupération des données en configurant un fichier retrieveMailFromExternalSignatoryBook.sh pour chaque custom.