Vous devez avoir des compétences avancées en programmation pour utiliser la plateforme de l’API Commerce électronique Lightspeed (série E). Si vous avez besoin d’aide en matière de développement, consultez l’article sur l’équipe en charge du développement personnalisé pour Commerce électronique Lightspeed (série E).

Les champs de commande supplémentaires (lien en anglais) vous permettent d’enregistrer des renseignements supplémentaires dans les commandes. Lors de la procédure de paiement, les acheteurs peuvent ajouter des données personnalisées qui apparaîtront ensuite dans les détails des commandes dans votre arrière-boutique Commerce électronique Lightspeed (série E). Vous pouvez choisir de masquer ou afficher ces champs pour les clients.

Parmi les autres outils permettant de se servir des champs de commande supplémentaires, vous pouvez utiliser deux fonctions et un tableau d’objets : getOrderExtraFieldValue("key"), getOrderExtraField("key") et order.extraFields.

Structure des champs de commande supplémentaires

${order.extraFields}

• <#list order.extrafields="order.extraFields" as="as" extrafield="extraField"> </#list> : affiche la liste des champs de commande supplémentaires.
• ${extraField.key} : affiche la clé d’un champ supplémentaire.
• ${extraField.value} : affiche la valeur d’un champ supplémentaire.
• ${extraField.title} : affiche le titre d’un champ supplémentaire.
• ${extraField.orderDisplaySection} : définit la section de la commande dans laquelle les valeurs du champ supplémentaire sont affichées.
• ${extraField.type} : affiche le type de champ supplémentaire.

Exemples de champs de commande supplémentaires

Afficher tous les champs de commande supplémentaires qui doivent être visibles dans les détails des commandes (vous avez spécifié des valeurs pour title et orderDisplaySection) :

<#list order.extraFields as extraField>
<#if extraField.title?has_content && extraField.orderDisplaySection?has_content>
${extraField.title}: ${extraField.value}
</#if>
</#list>

Imprimer la valeur d’un champ de commande supplémentaire spécifique (askHowYouFoundUsApp est utilisé comme clé du champ de commande supplémentaire) :

<#assign myExtraFieldValue = getOrderExtraFieldValue("askHowYouFoundUsApp")>
<#if myExtraFieldValue?has_content>
${myExtraFieldValue}
</#if>

Imprimer des champs spécifiques associés à un champ de commande supplémentaire spécifique (vous avez retiré les champs à masquer et askHowYouFoundUsApp est la clé de votre champ de commande supplémentaire) :

<#assign myExtraField = getOrderExtraField("askHowYouFoundUsApp")>
${myExtraField.key}
${myExtraField.value}
${myExtraField.type}
${myExtraField.orderDisplaySection}
${myExtraField.title}

Prochaines étapes