Renseigner les champs personnalisés du parcours

Votre organisation peut ajouter ses propres champs aux parcours : un numéro de contrat, une agence, des options… Leurs noms techniques se lisent dans CustomFields d'un parcours (GET https://staging-api.docage.com/Transactions/{id}). Leurs valeurs s'écrivent à la création, dans la clé Transaction :

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={"CustomFieldsUserData":[{"Name":"NumeroContrat","UserData":["C-20810"]},{"Name":"Options","UserData":["Éclairage","Vitrine"]}]}'

CustomFieldsUserData porte une entrée par champ : son nom technique (Name) et ses valeurs (UserData), toujours en texte, une entrée par valeur choisie.

Avec un modèle, un champ se nomme aussi comme une propriété du parcours :

Transaction={"NumeroContrat":"C-20810","Options":["Éclairage","Vitrine"]}

Les valeurs du modèle sont gardées pour les champs que vous ne nommez pas.

Les pièges

• Un nom technique qui ne correspond à aucun champ défini n'est pas refusé : vérifiez son orthographe sur le parcours rendu.
• Les champs personnalisés d'un contact s'écrivent de même, dans le contact en JSON : voir Champs personnalisés.
• Un champ personnalisé se filtre dans une liste par CustomFields. suivi de son nom : voir Rechercher des parcours.