Connecteur FAST Parapheur (Docaposte)¶

Transmets puis récupère des documents soumis à visa / signature dans des circuits prédéfinis (identifiant utilisateur) ou des circuits créés à la demande (comptes utilisateurs liés).

Ce connecteur dispose depuis juin 2023 du label de conformité technique de l'éditeur


Lien circuits externes	Création à la demande de circuits ou via identifiant signataire (2 modes)
Lien utilisateurs Courrier	Par liaison de compte à compte via le profil de l'utilisateur (circuits à la demande)
Formats de fichiers	PDF
Prépositionnement de griffe	Oui (circuits à la demande)
OTP (utilisateurs externes)	Oui (circuits à la demande)

A. Paramétrage technique¶

Modifier les informations situées dans la balise <signatoryBook> avec <id>fastParapheur</id> :

    ...
    <signatoryBook>
        <id>fastParapheur</id>
        <subscriberId></subscriberId>
        <url>https://parapheur.ville.fr</url>
        <integratedWorkflow>true</integratedWorkflow>
        <optionOtp>false</optionOtp>
        <signatureModes>
            <mode>
                <id>visa</id>
                <label>Visa</label>
            </mode>
            <mode>
                <id>signature</id>
                <label>Signataire</label>
            </mode>
            <mode>
                <id>serverSignature</id>
                <label>Signature Serveur</label>
            </mode>
        </signatureModes>
        <workflowTypes>
            <type>
                <id>BUREAUTIQUE_PDF</id>
                <label>Signature PADES</label>
            </type>
        </workflowTypes>
        <certPath></certPath>
        <certPass></certPass>
        <certType>P12</certType>
        <validatedState>Signé</validatedState>
        <refusedState>Refusé</refusedState>
        <validatedVisaState>Visa approuvé</validatedVisaState>
        <refusedVisaState>Visa désapprouvé</refusedVisaState>
    </signatoryBook>
    ...


id	(NE PAS MODIFIER) Identifiant technique.
subscriberId	ID par défaut permettant de se connecter pour l'envoi des documents à FAST (Le subscriberId spécifique doit être renseigné dans le champ "Identifiant Fast-Parapheur" de l'entité primaire du signataire dans Maarch)
url	Url du parapheur. Ex : https://parapheur.ville.fr
signatureModes	Les modes de signatures
workflowTypes	Une liste de type circuit autorisé pour l'envoi à la volée. Par défaut : BUREAUTIQUE_PDF
integratedWorkflow	Paramètre qui définit si l'action d'envoi peut être effectuée avec le circuit de visa défini dans Maarch Courrier ou non ; prend une valeur booléenne (true ou false)
optionOtp	Paramètre qui active le mot de passe à usage unique (One Time Password). (Cette fonctionnalité nécessite que integratedWorkflow soit activé (true))
certPath	Chemin vers le certificat
certPass	Mot de passe du certificat
certType	Type du certificat (p12, pem etc..)
validatedState	Statut d'un document validé en visa
refusedState	Statut d'un document refusé en visa
validatedVisaState	Message du statut d'un document validé en visa
refusedVisaState	Message du statut d'un document refusé en visa

Les types de circuit autorisés dans workflowTypes sont :

BUREAUTIQUE_PDF : Signature PADES

BUREAUTIQUE_XML : Signature XADES détaché

HELIOS_AVEC_TELETRANSMISSION : Signature PES avec télétransmission vers la DGFIP

HELIOS_SANS_TELETRANSMISSION : Signature PES sans télétransmission

Le parapheur peut être paramétré selon 2 modes :

le mode "Circuit prédéfini" (Identifiant du signataire lié à un identifiant de circuit FAST)
le mode "Circuit à la demande" (Paramètre integratedWorkflow positionné à "true" )
Ce mode permet à l'utilisateur de composer le circuit à partir de l'interface Maarch Courrier ou bien d'utiliser un circuit prédéfini par l'administrateur fonctionnel pour l'entité
Ce mode permet d'adresser des utilisateurs externes (Option Fonctionnalité OTP)
Ce mode permet le pré-positionnement des signatures sur les documents

B. Paramétrage fonctionnel¶

Associer aux bannettes cibles l'action système "Envoyer des données vers un parapheur externe"

Documents transmis au parapheur externe	pour visa / signature	en annexe non signable
Pièces jointes de type signable marquées comme intégrées au Parapheur	Oui	-
Pièces jointes de type non signable marquées comme intégrées au Parapheur	-	Oui
Fiche de liaison du courrier	-	Oui (si absence de membre externe dans le circuit via le mode OTP)
Document principal d'un courrier "Arrivée"	-	Oui
Document principal	Oui si marqué comme "intégré au parapheur pour visa / signature"

Modale d'action d'envoi au parapheur FAST pour un circuit à la demande

sendToExternalSignatoryBook

Cas d'un signataire via OTP - One Time Password¶

L'activation de l'OTP s'effectue par deux paramètres integratedWorkflow et optionOtp.

Ce service doit être activé chez l'éditeur.

Depuis la modale, ajoutez un utilisateur externe à l'aide du champ d'autocomplétion :

sendToExternalSignatoryBook

Utilisateur externe recevra un email avec une url fast pour signer électroniquement via un code reçu par SMS