DOCS

Order details

/

Détails de la commande

Découvrez comment fonctionne le point de terminaison des détails de la commande.

Le point de terminaison orderDetail est utilisé pour récupérer en toute sécurité les détails de la commande et le statut d'une commande effectuée via le Zonos Checkout.

Point de terminaison 

Remarque : Les clés de réponse peuvent être modifiées et/ou des clés supplémentaires peuvent être ajoutées. Si vous utilisez le point de terminaison, veuillez configurer votre code pour prendre en compte ces possibilités.

POST | https://api.iglobalstores.com/v2/orderDetail

Requête HTTPS

champnotes
Méthode HTTPPOST
Point de terminaisonhttps://api.iglobalstores.com/v2/orderDetail
ProtocoleHTTPS
Format du messageJSON
En-tête HTTP AcceptAccepter : application/json
En-tête HTTP Content-TypeContent-Type : application/json

Paires clé/valeur JSON dans le corps de la requête

champnotes
orderId FACULTATIF, si le paramètre referenceId est passéL'identifiant de commande Zonos peut être passé avec ou sans l'identifiant de votre magasin et le trait d'union (Exemple : 123-45678 ou 45678). Remarque : Après la finalisation de la commande et le paiement, le client sera redirigé vers une page de confirmation de commande / page de remerciement hébergée sur votre domaine. L'URL contiendra un paramètre de chaîne de requête "orderId" qui contiendra cette valeur. entier / chaîne de caractères
referenceId FACULTATIF, si le paramètre "orderId" est passéCe paramètre est utilisé pour rechercher les données d'une commande par l'identifiant de référence unique passé dans le point de terminaison du service API createTempCart. Ce paramètre doit être omis ou nul lorsqu'on souhaite rechercher les détails de la commande en fonction du paramètre orderId. chaîne de caractères
secret REQUISGUID secret de l'API fourni par Zonos chaîne de caractères
storeId REQUISIdentifiant de magasin fourni par Zonos entier

Réponses d'erreur HTTP

Code d'erreurmessagesignification
415Type de support non pris en chargeEntité HTML. L'en-tête HTTP "Content-Type" est invalide.
406Non acceptableEntité HTML. L'en-tête HTTP "Accept" est invalide.
400Requête incorrecte"error": "orderId: 999-99999 n'est pas un identifiant de commande valide" "error": "Impossible de trouver une commande avec l'identifiant de commande : 999-99999" "error": "Informations d'identification de sécurité invalides" "error": "Corps de message invalide" "error": "Le paramètre orderId ou referenceId est requis" "error": "Impossible de spécifier à la fois les paramètres orderId et referenceId" "error": "Aucune commande trouvée avec l'identifiant de commande : 999-99999" "error": "Paramètre de magasin requis" "error": "Aucune commande trouvée avec referenceId : 999999 pour storeId : 999" "error": "referenceId : 999999 pour storeId : 999 a été dupliqué" "error": "Impossible de récupérer la commande avec referenceId : 999999"
500Erreur interne du serveur"error": "Impossible de traiter les détails de la commande"

Définitions JSON de réponse

champnotes
errorCe paramètre n'est présent que lorsqu'une erreur s'est produite et contiendra une description de l'erreur.chaîne de caractères
orderIl s'agit d'une carte des détails de la commande.chaîne de caractères JSON
order.billingZipAdresse de facturation pour la commande - les valeurs ont été saisies dans le Zonos Checkout.chaîne de caractères
orderboxCountCe champ décrit les boîtes qui seront utilisées pour expédier la commande, transmises dans la demande createTempCart .chaîne de caractères
order.carrierAccountNumberNuméro de compte de transporteur propre au visiteur; utilisé lorsque les comptes de transporteur des visiteurs sont activéschaîne de caractères
order.carrierAccountShippingMethodLa méthode d'expédition sélectionnée sur le compte de transporteur propre au visiteur; utilisée lorsque les comptes de transporteur des visiteurs sont activéschaîne de caractères
order.cslListMatchCorrespondance avec la liste de contrôle consolidée (CSL). Un booléen qui indique si les informations du client ont produit une correspondance dans la liste de contrôle consolidée des États-Unis et doivent être examinées pour une éventuelle affiliation à des parties refusées.booléen
order.customerSelectedShippingNameNom d'affichage de l'option d'expédition à l'intérieur du Zonos Checkoutchaîne de caractères
order.dutyTaxesBreakdownUne carte de la répartition des droits/taxesRemarque - Si applicable, les frais de traitement international (IPF) ne sont pas inclus.chaîne de caractères JSON
order.dutyTaxesBreakdown.brokerageFeeMontant des frais de courtage en USD; nombre flottant positif, deux décimalesentier
order.dutyTaxesBreakdown.dispursementFeeMontant des frais de décaissement en USD; nombre flottant positif, deux décimalesentier
order.dutyTaxesBreakdown.dutyMontant des droits en USD; nombre flottant positif, deux décimalesentier
order.dutyTaxesBreakdown.prepaymentFeeMontant des frais de prépaiement en USD; nombre flottant positif, deux décimalesentier
order.dutyTaxesBreakdown.vatOnDispursementFeeMontant de la TVA/taxe sur les frais de décaissement en USD; nombre flottant positif, deux décimalesentier
order.dutyTaxesBreakdown.vatTaxMontant de la TVA/taxe en USD, ne comprend pas la TVA/taxe sur les frais de décaissement; nombre flottant positif, deux décimalesentier
order.dutyTaxesTotalTotal des droits et taxes en USD; nombre flottant positif, deux décimalesentier
order.foreignCurrencyCodeLe code de devise dans lequel le paiement de la commande a été effectué.chaîne de caractères
remittance_amountLe montant d'argent qui doit être remis à un pays spécifique (par exemple, la TVA britannique).décimal
order.grandTotalTotal général en USD; nombre flottant positif, deux décimalesentier
order.grandTotalForeignTotal général dans la devise réglée; nombre flottant positif, deux décimalesentier
order.itemsUne liste de cartes d'articlesLa carte d'article contient des détails sur l'article qui ont été transmis au Zonos Checkout lors de la création du panier temporairePour plus de détails sur les propriétés des articles, veuillez consulter la documentation de l'API createTempCart chaîne de caractères JSON
order.itemsCountNombre d'articles de ligne de commandeentier
order.itemsTotalTotal des articles/produits en USD; nombre flottant positif, deux décimalesentier
order.itemsTotalForeignTotal des articles/produits dans la devise réglée; nombre flottant positif, deux décimalesentier
order.items[index].heightNombre flottant positif, deux décimalesentier
order.items[index].itemNonShippablebooléen
order.items[index].lengthNombre flottant positif, deux décimalesentier
order.items[index].quantityentier
order.items[index].weightNombre flottant positif, deux décimales entier
order.items[index].widthNombre flottant positif, deux décimales entier
order.items[index].unitPriceNombre flottant positif, deux décimales entier
order.merchantOrderIdMerchantOrderId associé à la commande via le point de terminaison du service API updateMerchantOrderId. chaîne de caractères
order.misc1Valeur supplémentaire associée à la commande via le point de terminaison du service API createTempCart. chaîne de caractères
order.misc2Valeur supplémentaire associée à la commande via le point de terminaison du service API createTempCart. chaîne de caractères
order.misc3Valeur supplémentaire associée à la commande via le point de terminaison du service API createTempCart. chaîne de caractères
order.misc4Valeur supplémentaire associée à la commande via le point de terminaison du service API createTempCart. chaîne de caractères
order.misc5Valeur supplémentaire associée à la commande via le point de terminaison du service API createTempCart. chaîne de caractères
order.misc6Valeur supplémentaire associée à la commande via le point de terminaison du service API createTempCart. chaîne de caractères
order.nationalIdentifierInformations supplémentaires sur l'adresse de facturation internationale de la commande lorsque nécessaire. Les valeurs ont été saisies dans le Zonos Checkout. chaîne de caractères
order.notesUne liste de cartes de notes; la carte de notes contient des détails sur la note de commande. chaîne JSON
order.notes[index].createdByUserchaîne de caractères
order.notes[index].customerNoteUn booléen indiquant s'il s'agit d'une note créée par le client concernant la commande, l'expédition, etc. booléen
order.notes[index].dateCreatedmillis
order.notes[index].dateCreatedStringchaîne de caractères
order.notes[index].flaggedUn booléen indiquant si cette note a été signalée comme importante
order.notes[index].noteContenu de la note chaîne de caractères
order.optInEmailIndique que le client a sélectionné la case à cocher "s'inscrire à notre newsletter" dans l'application Zonos Checkout. Applicable uniquement si vous avez choisi d'afficher cette case à cocher sur la page de checkout. booléen
order.orderIdNuméro d'identification de la commande dans le système Zonos. chaîne de caractères
order.orderDateHorodatage de création de la commande en millisecondes en UTC/GMT. millis
order.orderDateStringChaîne de caractères de l'horodatage de création de la commande en UTC/GMT. chaîne de caractères
order.orderStatusÉtat de la commande dans le système Zonos. Pour plus de détails sur l'utilisation de orderStatus, veuillez consulter le document de récupération de commande ici. Des informations supplémentaires sur les statuts de commande peuvent être trouvées dans le document de mise à jour de commande ici. chaîne de caractères
order.orderStatusDateHorodatage en millisecondes en UTC/GMT du changement le plus récent de orderStatus dans le système Zonos. millis
order.orderStatusDateStringChaîne de caractères de l'horodatage du changement le plus récent de orderStatus dans le système Zonos. chaîne de caractères
order.paymentProcessingUn ensemble de détails de paymentProcessing. Certains paramètres peuvent ne pas être applicables à votre compte et seront exclus de la réponse. chaîne JSON
order.paymentProcessing.captureDateDate de capture du paiement en millisecondes, si disponible. Si Zonos traite le paiement, ce nœud est exclu de la réponse. millis
order.paymentProcessing.captureDateStringDate de capture du paiement en tant que chaîne, si disponible. Si Zonos traite le paiement, ce nœud est exclu de la réponse. chaîne de caractères
order.paymentProcessing.cardTypeMarque de carte de crédit. Si Zonos traite le paiement, ce nœud est exclu de la réponse. chaîne de caractères
order.paymentProcessing.lastFourLes quatre derniers chiffres du numéro de carte de crédit de facturation. Si Zonos traite le paiement, ce nœud est exclu de la réponse.string
order.paymentProcessing.paymentGatewayNom de la passerelle de paiement. Si Zonos traite le paiement, indiquera “iGlobal_CC” ou “iGlobal_PayPal”.string
order.paymentProcessing.transactionTypeIndique le type de transaction “AUTH_CAPTURE” ou “AUTH_ONLY”. Si Zonos traite le paiement, ce nœud est exclu de la réponse.string
order.poNumberUn numéro de bon de commande pour la commande spécifiée dans le Zonos Checkout; utilisé lorsque les bons de commande sont activés.string
order.quotedDutyTaxesDroits et taxes indiqués dans le Zonos Checkout, affichés en USD; point flottant positif, deux décimales.integer
order.quotedDutyTaxesForeignDroits et taxes indiqués dans le Zonos Checkout. Affichés dans la devise réglée; point flottant positif, deux décimales.integer
order.referenceIdreferenceId unique associé à la commande via le point de terminaison du service API createTempCart.string
order.shipCompleteIndique si la commande doit être expédiée en plusieurs parties.boolean
order.shippingCarrierServiceLevelIdentifiant du transporteur et du niveau de service pour l'option d'expédition sélectionnée.string
order.shippingInstructionsInstructions personnalisables pour le niveau de service d'expédition.string
order.shippingTotalTotal des frais d'expédition en USD; point flottant positif, deux décimales.integer
order.shippingTotalForeignTotal des frais d'expédition dans la devise réglée; point flottant positif, deux décimales.integer
order.testOrderIndique si la commande est une commande de test.boolean
order.trackingNumberNuméro de suivi généré pour l'expédition, le cas échéant.string
order.zipAdresse de destination / d'expédition pour la commande - les valeurs ont été saisies dans le Zonos Checkout ou ont été transmises à la commande via la redirection vers le Zonos Checkout.string

Types de données supplémentaires :

  • order.address1
  • order.address2
  • order.address3
  • order.altPhone
  • order.billingAddress1
  • order.billingAddress2
  • order.billingAddress3
  • order.billingAltPhone
  • order.billingCity
  • order.birthDate
  • order.billingCompany
  • order.billingCountryCode
  • order.billingCountryName
  • order.billingEmail
  • order.billingName
  • order.billingPhone
  • order.billingState
  • order.city
  • order.company
  • order.countryCode
  • order.countryName
  • order.email
  • order.items[index].countryOfOrigin
  • order.items[index].description
  • order.items[index].imageURL
  • order.items[index].itemBrand
  • order.items[index].itemCategory
  • order.items[index].itemColor
  • order.items[index].itemCustomization
  • order.items[index].itemDescriptionDetailed
  • order.items[index].itemDescriptionLong
  • order.items[index].itemFabricContent
  • order.items[index].itemHSCode
  • order.items[index].itemLtlClass
  • order.items[index].itemMaterial
  • order.items[index].itemURL
  • order.items[index].productId
  • order.items[index].sku
  • order.items[index].productId
  • order.items[index].weightUnits
  • order.name
  • order.phone
  • order.state

Cette page était-elle utile?


Des questions ?

Contactez-nous.