Le tableau ci-dessous décrit les propriétés possibles dans une requête de synchronisation standard, comme indiqué dans Synchroniser les données de commande par l'API.
Éléments liés à la requête
Propriété | Description | Obligatoire/facultatif | Exemple |
---|---|---|---|
gtin | Il s'agit du code permettant d'identifier le produit dans la commande. | Obligatoire | 9891998566P |
id | Ceci est l'identifiant de la commande dans le système du détaillant. S'il n'est pas fourni, CitrusAd en générera un. | Facultatif. | 3h30e938-c158-4d78-a0af-b48bbwfrcss4 |
orderDate | Il s'agit de la date ou de la date et l'heure de la commande. Elle doit suivre le format ISO-8601 et être précise et complète, par exemple : 2019-03-14T15:06:17+10:00. Doit être en heure UTC, ou fuseau horaire ajusté selon l'exemple ci-dessus. | Obligatoire | 2021-12-02T15:00:00Z |
catalogId | L'ID de catalogue pour lequel vous synchronisez les commandes. Ceci est utile pour la synchronisation de plusieurs détaillants via l'API. Non applicable à la synchronisation des fichiers. | Facultatif | 6adb93d0-7he4-4d4e-9b47-e5d3714c976a |
orderItems | Un tableau de tous les éléments soumis dans la commande. | Obligatoire | [ { "gtin": "9891998566P", "quantity": 3, "regularUnitPrice": "1.00", "totalOrderItemPriceAfterDiscounts": "3.00" } ] |
quantity | La quantité de produits commandés | Obligatoire | 3 |
regularUnitPrice | Il s'agit du prix unitaire normal du produit dans la commande. | Facultatif | 2.99 |
sessionId | Ceci est un identifiant généré et contrôlé par vous-même, qui sert à identifier la session d'un utilisateur. CitrusAd peut l'utiliser pour l'attribution des achats. | Requis dans le cas d'une intégration standard | 5cat7-9964-4f |
totalOrderItemPriceAfterDiscounts | Il s'agit du prix total des produits, remises comprises. Par exemple, si une commande contient 3 articles avec un prix unitaire de 2,00, la valeur sera 6.00 . | Facultatif | 5.98 |
sellerId | ID unique du vendeur. Cet identifiant est uniquement requis pour l'onboarding de vendeurs Marketplace. Il n'a pas besoin d'être renseigné pour la vente de produits en dehors de Marketplace. Des exigences supplémentaires sont requises pour intégrer seller_ids. Consultez Marketplace SellerID pour plus d'informations. | Facultatif | 73nns-32sxr-32ss Personnalisation par intégration |