Modifier les réglages hérités du modèle
Changer, pour cet envoi seulement, le nom du parcours, sa durée de validité, ses relances ou son mode d'essai.
curl -X POST "https://staging-api.docage.com/Transactions/CreateFullTransaction" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
-F "TemplateId=aaaaaaaa-0000-4000-8000-000000000001" \
-F "Client=00000000-0000-4000-8000-000000000201" \
-F 'Transaction={"Name":"Contrat de prestation – Atelier Lumière","DaysBeforeEnding":10,"Reminder":2,"MaximumReminders":3}'La clé Transaction porte les propriétés qui changent ; les autres restent celles du modèle.
| Propriété | Ce qu'elle règle |
|---|---|
Name |
Le nom du parcours, 255 caractères au plus : celui des emails et des documents téléchargés. |
DaysBeforeEnding |
Sa durée de validité, en jours, de 1 à 30 (30 d'office) : le parcours expire ce nombre de jours après son envoi. EndDate, une date UTC, la fixe à la place. |
Reminder |
Ses relances automatiques : 0 aucune, 1 chaque jour, 2 tous les deux jours, 7 chaque semaine, 14 toutes les deux semaines, 30 chaque mois. |
MaximumReminders |
Le nombre de relances automatiques, de 1 à 5. |
IsTest |
true : un parcours d'essai, sans consommation de crédits, aux documents filigranés et sans valeur probante. |
ExternalId |
Votre propre référence, 128 caractères au plus — le numéro du dossier dans votre outil. |
Les pièges
- Une valeur qui ne se lit pas est ignorée, sans erreur : un nombre hors bornes, un nom de propriété mal écrit. Relisez le parcours rendu.
DaysBeforeEndingn'est pas contrôlé par cette route : restez entre1et30.- Une organisation qui n'est pas encore en production crée toujours des parcours d'essai, quel que soit
IsTest. MailSettingsremplace tous les réglages d'emails du modèle, pas seulement ceux que vous envoyez : voir Personnaliser l'email d'invitation à signer.- Les réglages d'un participant se changent sous son identifiant convivial : voir Changer le mode de signature d'un participant.