Créer depuis un modèle, en brouillon
Créer le parcours sans l'envoyer, pour le vérifier ou le compléter, puis le lancer.
curl -X POST "https://staging-api.docage.com/Transactions/CreateFullTransaction?launchTransaction=false" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
-F "TemplateId=aaaaaaaa-0000-4000-8000-000000000001" \
-F "Client=00000000-0000-4000-8000-000000000201"launchTransaction=false crée le parcours sans l'envoyer : la réponse est le parcours, en brouillon (GlobalStatus à 0). Personne
n'est invité, et rien n'est consommé : seul l'envoi d'un parcours est compté.
Ensuite
Un brouillon se complète avant l'envoi :
- ses réglages :
PUT https://staging-api.docage.com/Transactions/{id}; - un participant :
POST https://staging-api.docage.com/TransactionMembers— voir Ajouter un participant au modèle — un contact existant ; - un document :
POST https://staging-api.docage.com/TransactionFiles— voir Ajouter un document au modèle ; - un emplacement de signature :
POST https://staging-api.docage.com/TransactionFields, ouPUT https://staging-api.docage.com/TransactionFields/{id}pour en déplacer un.
Puis il s'envoie :
POST https://staging-api.docage.com/Transactions/LaunchTransaction/cccccccc-0000-4000-8000-000000000003
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…curl -X POST "https://staging-api.docage.com/Transactions/LaunchTransaction/cccccccc-0000-4000-8000-000000000003" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…"using HttpClient client = new();
using HttpRequestMessage request = new(HttpMethod.Post, "https://staging-api.docage.com/Transactions/LaunchTransaction/cccccccc-0000-4000-8000-000000000003");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
using HttpResponseMessage response = await client.SendAsync(request);
string result = await response.Content.ReadAsStringAsync();
if (!response.IsSuccessStatusCode)
throw new HttpRequestException(result);const response = await fetch("https://staging-api.docage.com/Transactions/LaunchTransaction/cccccccc-0000-4000-8000-000000000003", {
method: "POST",
headers: {
Authorization: `Bearer ${token}`
}
});
const text = await response.text();
if (!response.ok) throw new Error(text);
const result = text ? JSON.parse(text) : null;Voir Lancer le parcours pour ce que vérifie l'envoi.
Les pièges
- Écrivez
falseen toutes lettres : sans le paramètre, la création envoie aussitôt. - Un brouillon qui ne sert plus se met à la corbeille par
DELETE https://staging-api.docage.com/Transactions/BatchDelete(une liste d'identifiants), puis se supprime parDELETE https://staging-api.docage.com/Transactions/BatchDefinitivelyDelete.