DOCAPOSTESEND Workflow Application

Overview

The DOCAPOSTESEND workflow application lets you send one or more documents to Docaposte for electronic signature.

How it works

  • The DOCAPOSTESEND application creates a single envelope and sends it to one or more signers.

  • You can specify one or more files per DOCAPOSTESEND action. To do this, use the FILEx parameter, where x is the file number (e.g.: FILE1). At least one file is required.

  • You can specify one or more signers. To do this, use the combination of SIGNER_FIRSTNAME_LIST, SIGNER_LASTNAME_LIST, and SIGNER_EMAIL_LIST. You can also use SIGNER_FIRSTNAMEx, SIGNER_LASTNAMEx, and SIGNER_EMAILx, where x is the number of the signer.

  • You can specify one type of signature per recipient. To do this, depending on the method you use to specify signers (with or without _LIST), you can use SIGNATURE_TYPE_LIST or SIGNATURE_TYPEx, where x is the signer number. Possible values: OTP (default), PAD, TOKEN, CONSENT_PROOF or IDENTITY.

  • Application logs are available. These can be specified by setting the value of the DocaposteSendLogLevel parameter in the web.config file to 0 to disable logging, 1 for error logs, 2 for information logs, or 3 for debug logs; The default value is 0.

Required parameters

You can use one of the following two configurations: with a list of signers or with signer numbers.

With a list of signers

Parameter

Type

Direction

Description

SIGNER_FIRSTNAME_LIST

TEXT

IN

First names of signers, separated by the value defined in the DATA_SEPARATOR parameter

SIGNER_LASTNAME_LIST

TEXT

IN

Last names of signers, separated by the value defined in the DATA_SEPARATOR parameter

SIGNER_EMAIL_LIST

TEXT

IN

Email addresses of the signers, separated by the value defined in the DATA_SEPARATOR parameter

FILEx

FILE

IN

File(s) to send, where x is the file number; you can add one or more files

With signer numbers

Parameter

Type

Direction

Description

SIGNER_FIRSTNAMEx

TEXT

IN

First name(s) of the signer(s), where x corresponds to the signer number; you can add one or more signers

SIGNER_LASTNAMEx

TEXT

IN

Last name(s) of the signer(s), where x corresponds to the signer number; you can add one or more signers

SIGNER_EMAILx

TEXT

IN

Email address(es) of the signer(s), where x is the signer's number; you can add one or more signers

FILEx

FILE

IN

File(s) to send, where x is the file number; you can add one or more files

Optional parameters

Docaposte configuration

Parameters

Type

Direction

Description

DOCAPOSTE_USERNAME

TEXT

IN

Docaposte username By default, this value comes from the DocaposteUsername parameter in the web.config file.

DOCAPOSTE_PASSWORD

TEXT

IN

Docaposte password By default, this value comes from the DocapostePassword parameter in the web.config file.

DOCAPOSTE_HOST_SERVER

TEXT

IN

Docaposte host server

By default, this value comes from the DocaposteHostServer parameter in the web.config file.

DOCAPOSTE_OFFER_CODE

TEXT

IN

Docaposte offer code

By default, this value comes from the DocaposteOfferCode parameter in the web.config file.

DOCAPOSTE_ORGANIZATIONAL_UNIT_CODE

TEXT

IN

Docaposte organizational unit code

By default, this value comes from the DocaposteOrganizationalUnitCode parameter in the web.config file.

General

Parameters

Type

Direction

Description

DATA_SEPARATOR

TEXT

IN

Separator used to separate the contents of SIGNERS_FIRSTNAME_LIST,SIGNERS_LASTNAME_LIST, SIGNERS_EMAIL_LIST, and SIGNER_TYPE_LIST Default : , (comma)

SIGNER_TYPE_LIST

TEXT

IN

Signature type of signers, separated by the value defined in the DATA_SEPARATOR parameter Possible values:

  • OTP(default)

  • PAD

  • TOKEN

  • CONSENT_PROOF

  • IDENTITY

SIGNER_TYPEX

TEXT

IN

Signature type of signer(s), where x corresponds to the signer number; you can add one or more signers

Possible values:

  • OTP(default)

  • PAD

  • TOKEN

  • CONSENT_PROOF

  • IDENTITY

CUSTOM_REFERENCE

TEXT

IN

Provider reference

The content of this parameter can allow the provider to identify the transaction on its end with; for example, a value specific to its business domain (e.g. customer file number). Default:WorkflowGen

TEST_MODE

TEXT

IN

Indicates whether the transaction is a TEST transaction (Y or N)

Default: N

EMAIL_SUBJECT

TEXT

IN

Subject of the email that will be sent to signers

Default: Please sign the document sent from WorkflowGen

EMAIL_FROM

TEXT

IN

Domain name of the email address that will be used to send the email to signers

Default : do-not-reply

EMAIL_BODY

FILE

IN

Content of the email to send to signers (see the Customizing the body of the email section)

Return parameters

Parameter

Type

Direction

Description

DOCAPOSTE_TRANSACTION_ID`

TEXT

OUT

Contains the Docaposte transaction ID; you can use this ID in the DOCAPOSTCHECK workflow application

DOCAPOSTE_DOCUMENT_NAMES

TEXT

OUT

Contains the names of the documents sent to Docaposte; you can use these values in the DOCAPOSTECHECK workflow application

Customizing the body of the email

You can customize the content of the body of the email to be sent to the signer. The template must contain the <DOCAPOSTE_SIGN_URL> tag, which will be replaced by the link allowing the signer to add their signature.

Default value:

<!DOCTYPE html>
<html lang=""en"" xmlns=""http://www.w3.org/1999/xhtml"">
<head>
    <meta charset=""utf-8"" />
</head>
<body>
    <p>Hello {firstname} {lastname},</p>
    <p>
        Please sign the document sent from WorkflowGen.
        <br />
        <a href=""<DOCAPOSTE_SIGN_URL>"">Click here to sign on Docaposte</a>
    </p>
    <p>Regards,</p>
    <p>WorkflowGen</p>
</body>
</html>

Examples

With a list of signers

Parameter

Type

Direction

Value

SIGNER_FIRSTNAME_LIST

TEXT

IN

John,Bernard

SIGNER_LASTNAME_LIST

TEXT

IN

Smith,Martin

SIGNER_EMAIL_LIST

TEXT

IN

john.smith@email.com,bernard.martin@email.com

SIGNER_TYPE_LIST

TEXT

IN

PAD,OTP

FILE1

FILE

IN

contract.pdf

DOCAPOSTE_TRANSACTION_ID

TEXT

OUT

xxxxx-xxxxx-xxxxx-xxxxx

DOCAPOSTE_DOCUMENT_NAMES

TEXT

OUT

contract.pdf

With signer numbers

Parameter

Type

Direction

Value

SIGNER_LASTNAME1

TEXT

IN

Smith

SIGNER_LASTNAME2

TEXT

IN

Martin

SIGNER_FIRSTNAME1

TEXT

IN

John

SIGNER_FIRSTNAME1

TEXT

IN

Bernard

SIGNER_EMAIL1

TEXT

IN

john.smith@email.com

SIGNER_EMAIL2

TEXT

IN

bernard.martin@email.com

SIGNER_TYPE1

TEXT

IN

PAD

SIGNER_TYPE2

TEXT

IN

TOKEN

FILE1

FILE

IN

contract.pdf

DOCAPOSTE_TRANSACTION_ID

TEXT

OUT

xxxxx-xxxxx-xxxxx-xxxxx

DOCAPOSTE_DOCUMENT_NAMES

TEXT

OUT

contract.pdf

Last updated