Envoyer des données vers un parapheur externe

La configuration se fait par instance

• Initialisation
• Activer un parapheur externe
• Configurer les informations parapheur
  • MaarchParapheur
  • IxBus
  • iParapheur (SOAP)
  • iParapheur via Pastell (REST)
  • Fast-Parapheur
  • xParapheur
• Configurer l'action d'envoi
• Fonctionnement
  • MaarchParapheur
  • IxBus
  • iParapheur (SOAP)
  • iParapheur via Pastell (REST)
  • Fast-Parapheur
    • OTP - One Time Password
  • xParapheur

Initialisation

Copier le fichier de configuration pour votre custom :

cp modules/visa/xml/remoteSignatoryBooks.xml.default custom/MY_CUSTOM/modules/visa/xml/remoteSignatoryBooks.xml

Activer un parapheur externe

Dans le fichier remoteSignatoryBooks.xml de votre custom, saisissez l'identifiant du parapheur cible.

ex :

<?xml version="1.0" encoding="utf-8"?>
<root>
    <signatoryBookEnabled>maarchParapheur</signatoryBookEnabled>
    ...

UN SEUL parapheur distant à la fois peut être activé sur une instance donnée.

Configurer les informations parapheur

MaarchParapheur

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

    ...
    <signatoryBook>
        <id>maarchParapheur</id>
        <userId>jjane@maarch.com</userId>
        <password>maarch</password>
        <url>http://10.2.95.58/MaarchParapheur</url>
    </signatoryBook>
    ...

L'url doit être la véritable ip du serveur où est installée Maarch Parapheur, et non pas "localhost" ou "127.0.0.1"*

IxBus

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

    ...
    <signatoryBook>
        <id>ixbus</id>
        <tokenAPI></tokenAPI>
        <url>https://parapheur.ville.fr</url>
    </signatoryBook>
    ...

iParapheur (SOAP)

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

    ...
    <signatoryBook>
        <id>iParapheur</id>
        <userId></userId>
        <password></password>
        <url>https://parapheur.ville.fr</url>
        <certPath></certPath>
        <certPass></certPass>
        <certType>pem</certType>
        <defaultType></defaultType>
        <defaultSousType></defaultSousType>
        <errorCode>KO</errorCode>
        <visaState>Vise</visaState>
        <signState>Signe</signState>
        <refusedVisa>RejetVisa</refusedVisa>
        <refusedSign>RejetSignataire</refusedSign>
    </signatoryBook>
    ...

iParapheur via Pastell (REST)

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

    ...
    <signatoryBook>
        <id>pastell</id>
        <login></login>
        <password></password>
        <url>https://pastell.partenaire.libriciel.fr/api/v2</url>
        <entityId>193</entityId>
        <connectorId>776</connectorId>
        <documentType>ls-document-pdf</documentType>
        <iParapheurType>XELIANS COURRIER</iParapheurType>
        <iParapheurSousType>courrier</iParapheurSousType>
        <errorCode>KO</errorCode>
        <visaState>CachetOK</visaState>
        <signState>Signe</signState>
        <refusedVisa>RejetVisa</refusedVisa>
        <refusedSign>RejetSignataire</refusedSign>
        <postAction></postAction>
    </signatoryBook>
    ...

Fast-Parapheur

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>
            <type>
                <id>BUREAUTIQUE_XML</id>
                <label>Signature XADES détaché</label>
            </type>
            <type>
                <id>HELIOS_AVEC_TELETRANSMISSION</id>
                <label>Signature PES avec télétransmission vers la DGFIP</label>
            </type>
            <type>
                <id>HELIOS_SANS_TELETRANSMISSION</id>
                <label>Signature PES sans télétransmission</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>
    ...

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

xParapheur

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

    ...
    <signatoryBook>
        <id>xParaph</id>
        <url>https://parapheur.ville.fr</url>
        <userGeneric>
            <siret></siret>
            <login></login>
            <password></password>
        </userGeneric>
        <docutype>254</docutype>
        <docustype>100</docustype>
    </signatoryBook>
    ...

Configurer l'action d'envoi

1. Naviguer : Administrations > Actions > Ajouter
2. Sélectionner dans le champ Action système : "Envoyer des données vers un parapheur externe"

À noter qu'il existe une action spécifique à Maarch Parapheur : "Envoyer des courriers à annoter dans Maarch Parapheur"

Fonctionnement

Les pièces jointes envoyées au parapheur passent au statut FRZ et ne sont plus modifiable tant qu'elles ne sont pas revenues du parapheur distant.

Le courrier passe dans le statut qui a été défini lors de la création de l'action

MaarchParapheur

IxBus

L'affichage de la modale peut prendre du temps en fonction de la connexion et du nombre de circuits de visa totaux paramétrés dans Ixbus

Toutes les pièces jointes pour lesquelles il est coché Intégrer au parapheur seront envoyées dans IxBus.

Chaque pièce jointe représente un dossier dans IxBus.

Le courrier arrivé sera placé en tant que pièce jointe dans le dossier Ixbus.

iParapheur (SOAP)

Les pièces jointes ne nécessitant PAS de signature seront ajoutées en tant qu'annexes.

Le document principal ne nécessitant PAS de signature sera ajouté en tant qu'annexe.

iParapheur via Pastell (REST)

Fast-Parapheur

Si le paramètre integratedWorkflow est à false :

Si le paramètre integratedWorkflow est à true :

Les pièces jointes ne nécessitant PAS de signature seront ajoutées en tant qu'annexes.

Le document principal ne nécessitant PAS de signature sera ajouté en tant qu'annexe.

OTP - One Time Password

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

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

Utilisateur externe recevra un email avec une url fast pour signer électroniquement ou refuser le document.

xParapheur

Toutes les pièces jointes pour lesquelles il est coché Intégrer au parapheur seront envoyées dans xParapheur.

Chaque pièce jointe représente un document dans xParapheur.