Schémas de données
Adresse de livraison
AddressData · Schéma · Schémas de données: Commandes
address_line_1Chaîne nullObligatoirePremière ligne d'adresse.
address_line_2Chaîne nullObligatoireComplément d'adresse.
cityChaîne nullObligatoireVille ou localité.
country_codeChaîne nullObligatoireCode du pays.
first_nameChaîne nullObligatoirePrénom.
house_numberChaîne nullObligatoireNuméro de bâtiment.
last_nameChaîne nullObligatoireNom de famille.
phoneChaîne nullObligatoireNuméro de téléphone.
postal_codeChaîne nullObligatoireCode postal.
regionChaîne nullObligatoireRégion administrative.
streetChaîne nullObligatoireNom de rue.
Champs supplémentaires: Non
ApiResponse_OrderFileListData_
ApiResponse_OrderFileListData_ · Champs, types et contraintes des données acceptées ou renvoyées par l’API. Transmettez les fichiers en multipart/form-data après la création de upload_id, puis associez-les au produit. Le téléchargement exige un jeton Bearer et le droit correspondant à category ; la réponse contient les octets, sans adresse publique ni mot de passe. Pour mode=period, choisissez days (1–3650) ou l’ancien months, jamais les deux. Les conditions sont enregistrées à l’achat ; le remboursement retire uniquement l’accès à la ligne remboursée.
dataOrderFileListDataObligatoireDonnées d'une réponse réussie.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatoireMétadonnées de la réponse.
Champs supplémentaires: Non
ApiResponse_OrderReleaseListData_
ApiResponse_OrderReleaseListData_ · Champs, types et contraintes des données acceptées ou renvoyées par l’API. Transmettez les fichiers en multipart/form-data après la création de upload_id, puis associez-les au produit. Le téléchargement exige un jeton Bearer et le droit correspondant à category ; la réponse contient les octets, sans adresse publique ni mot de passe. Pour mode=period, choisissez days (1–3650) ou l’ancien months, jamais les deux. Les conditions sont enregistrées à l’achat ; le remboursement retire uniquement l’accès à la ligne remboursée.
dataOrderReleaseListDataObligatoireDonnées d'une réponse réussie.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatoireMétadonnées de la réponse.
Champs supplémentaires: Non
Lister — Commandes — Réponse
ApiResponse_list_OrderSummaryData__ · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
dataTableau <OrderSummaryData> ObligatoireExemple de réponse · ApiResponse_list_OrderSummaryData__.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatoireMétadonnées de la réponse.
Champs supplémentaires: Non
Obtenir — Commandes — Réponse
ApiResponse_OrderDetailData_ · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
dataOrderDetailDataObligatoireExemple de réponse · OrderDetailData.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatoireMétadonnées de la réponse.
Champs supplémentaires: Non
CurrentReleaseData
CurrentReleaseData · Champs, types et contraintes des données acceptées ou renvoyées par l’API. Transmettez les fichiers en multipart/form-data après la création de upload_id, puis associez-les au produit. Le téléchargement exige un jeton Bearer et le droit correspondant à category ; la réponse contient les octets, sans adresse publique ni mot de passe. Pour mode=period, choisissez days (1–3650) ou l’ancien months, jamais les deux. Les conditions sont enregistrées à l’achat ; le remboursement retire uniquement l’accès à la ligne remboursée.
acquiredBooléenObligatoireAccès après achat (true / false)
changelogChaîneObligatoireDescription des modifications
covered_by_purchaseBooléenObligatoireAccès après achat (true / false)
idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée.
published_atChaîneObligatoirePublier la version · UTC
format:"date-time"requires_new_purchaseBooléenObligatoireAucun accès aux fichiers ajoutés après achat · requires_new_purchase
sequenceEntierObligatoirePosition dans la collection ordonnée.
version_labelChaîneObligatoireVersion
Champs supplémentaires: Non
Données du client enregistrées pour cette ressource
CustomerData · Schéma · Schémas de données: Commandes
emailChaîneObligatoireAdresse e-mail.
first_nameChaîne nullObligatoirePrénom.
last_nameChaîne nullObligatoireNom de famille.
phoneChaîne nullObligatoireNuméro de téléphone.
Champs supplémentaires: Non
DeliveryContentDeletion
DeliveryContentDeletion · Effacez définitivement le contenu en conservant son historique. Le code ne revient pas dans le stock vendable.
expected_versionEntierObligatoireVersion lue avant l'écriture ; une différence entraîne le rejet de la modification.
minimum:1reasonChaîneObligatoireMotif enregistré pour la modification.
minLength:1maxLength:500
Champs supplémentaires: Non
Dates d’expédition et de livraison
DeliveryDatesData · La liste et le détail des commandes incluent delivery.dates. Les dates YYYY-MM-DD sont prévues et ne confirment pas l’expédition. Les dates actuelles sont prioritaires ; les anciennes commandes utilisent l’estimation enregistrée. Les valeurs effacées ou inconnues sont null. Le détail inclut aussi toutes les lignes et images des produits.
dispatch_timezoneChaîne nullObligatoireFuseau horaire d’expédition (IANA; null).
estimated_delivery_fromChaîne nullObligatoireDébut de livraison estimé (YYYY-MM-DD; null).
Chaîne:format:"date"estimated_delivery_toChaîne nullObligatoireFin de livraison estimée (YYYY-MM-DD; null).
Chaîne:format:"date"planned_dispatch_onChaîne nullObligatoireDate d’expédition prévue (YYYY-MM-DD; null).
Chaîne:format:"date"
Champs supplémentaires: Non
DeliveryReplacement
DeliveryReplacement · Choisissez une unité libre existante. Le remplacement ne relance pas le délai de conservation.
expected_unit_versionEntierObligatoireVersion actuelle de l’unité libre de remplacement.
minimum:1expected_versionEntierObligatoireVersion lue avant l'écriture ; une différence entraîne le rejet de la modification.
minimum:1reasonChaîneObligatoireMotif enregistré pour la modification.
minLength:1maxLength:500replacement_unit_idChaîneObligatoireIdentifiant d’une unité libre existante de remplacement.
format:"uuid"
Champs supplémentaires: Non
DeliveryPickupPointData
DeliveryPickupPointData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
addressPickupPointAddressDataObligatoireAdresse de livraison.
codeChaîneObligatoireCode stable lisible par une machine.
Contraintes
pattern"^[A-Za-z0-9_-]{1,63}$"
coordinatesPickupPointCoordinatesDatanullObligatoireValeur décrite par le schéma environnant.
country_codeChaîneObligatoireCode du pays.
Contraintes
pattern"^[A-Z]{2}$"
environmentChaîneObligatoireInformations d'environnement associées à l'enregistrement.
Contraintes
enum["live", "sandbox"]
kindChaîneObligatoireVariante de la structure de données définie par les valeurs autorisées.
Contraintes
enum["locker", "pickup_point"]
location_descriptionChaîne nullObligatoireDescription dans la langue sélectionnée.
Chaîne:maxLength:1000nameChaîneObligatoireNom de la ressource dans le contexte concerné.
minLength:1maxLength:160opening_hoursChaîne nullObligatoireOpening hours
Chaîne:maxLength:500operatorChaîneObligatoireNom de la ressource dans le contexte concerné.
minLength:1maxLength:63verified_atChaîneObligatoireDate et heure de la dernière modification.
format:"date-time"
Champs supplémentaires: Non
ApiResponse[list[DeliveryData]]
shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_DeliveryData____1 · Consultez les unités attribuées sans révéler leurs codes. Un remboursement retire l’accès aux seules lignes concernées.
dataTableau <shopently_engine__domains__orders__adapters__public_http__digital_deliveries__schemas__DeliveryData> ObligatoireDonnées d'une réponse réussie.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatoireMétadonnées de la réponse.
Champs supplémentaires: Non
DeliveryData
shopently_engine__domains__orders__adapters__public_http__digital_deliveries__schemas__DeliveryData · Consultez les unités attribuées sans révéler leurs codes. Un remboursement retire l’accès aux seules lignes concernées.
can_downloadBooléenObligatoireTélécharger (true / false)
content_stateChaîneObligatoireÉtat du contenu : present / deleting / deleted.
delete_due_atChaîne nullObligatoireSuppression du fichier prévue ; null la désactive.
Chaîne:format:"date-time"filenameChaîne nullObligatoireFichier
first_available_atChaîne nullObligatoirePremier accès de cet achat ; le remplacement ne relance pas le délai.
Chaîne:format:"date-time"generationEntierObligatoireGénération de l’attribution, incrémentée lors du remplacement.
idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée.
format:"uuid"kindChaîne nullObligatoireVariante de la structure de données définie par les valeurs autorisées.
line_idChaîneObligatoireIdentifiant stable de la ligne de commande.
order_idChaîneObligatoireIdentifiant de la commande associée.
payload_idChaîneObligatoireIdentifiant du contenu, pas une URL publique de téléchargement.
format:"uuid"product_idChaîneObligatoireIdentifiant du produit.
reasonChaîneObligatoireMotif enregistré pour la modification.
size_bytesEntier nullObligatoireTaille en octets
stateChaîneObligatoireStatut
unit_idChaîneObligatoireIdentifiant d’un code ou fichier individuel.
format:"uuid"unit_ordinalEntierObligatoireNuméro de l’unité achetée dans la ligne de commande.
variant_idChaîne nullObligatoireIdentifiant de la variante du produit.
versionEntierObligatoireVersion de ressource utilisée pour le contrôle de concurrence.
Champs supplémentaires: Non
Informations de facturation
InvoiceData · Schéma · Schémas de données: Commandes
address_line_1Chaîne nullObligatoirePremière ligne d'adresse.
address_line_2Chaîne nullObligatoireComplément d'adresse.
cityChaîne nullObligatoireVille ou localité.
company_nameChaîne nullObligatoireNom de l'entreprise.
country_codeChaîne nullObligatoireCode du pays.
house_numberChaîne nullObligatoireNuméro de bâtiment.
postal_codeChaîne nullObligatoireCode postal.
regionChaîne nullObligatoireRégion administrative.
streetChaîne nullObligatoireNom de rue.
tax_identifierChaîne nullObligatoireNuméro d'identification fiscale.
tax_schemeChaîne nullObligatoireSchéma de calcul des taxes.
Champs supplémentaires: Non
Montant net / Montant de taxe / Montant brut
OrderAmountBreakdownData · Les montants et taux proviennent de la commande enregistrée, corrections de lignes comprises. Les données historiques manquantes valent null et ne sont pas remplacées par les taux actuels du catalogue. Les montants restent des chaînes décimales.
grossMoneyDataObligatoireMontant brut · Après remises; Inconnu : null ; zéro connu : 0.
netMoneyDatanullObligatoireMontant net · Après remises; Inconnu : null ; zéro connu : 0.
taxMoneyDatanullObligatoireMontant de taxe · Après remises; Inconnu : null ; zéro connu : 0.
Champs supplémentaires: Non
Livraison · Remises
OrderDeliveryDiscountData · Les montants et taux proviennent de la commande enregistrée, corrections de lignes comprises. Les données historiques manquantes valent null et ne sont pas remplacées par les taux actuels du catalogue. Les montants restent des chaînes décimales.
amountMoneyDataObligatoireMontant brut · Livraison · Remises.
campaign_idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée.
codeChaîne nullObligatoireCode stable lisible par une machine.
kindChaîneObligatoireVariante de la structure de données définie par les valeurs autorisées.
Contraintes
enum["coupon", "promotion"]
nameChaîneObligatoireNom de la ressource dans le contexte concerné.
sequenceEntier nullObligatoirePosition dans la collection ordonnée.
versionEntierObligatoireVersion de ressource utilisée pour le contrôle de concurrence.
Champs supplémentaires: Non
Obtenir — Commandes — Réponse
OrderDetailData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
created_atChaîneObligatoireDate et heure de création.
format:"date-time"customerCustomerDataObligatoireDonnées du client enregistrées pour cette ressource.
deliveryShippingDetailDataObligatoireMode de livraison et informations associées.
discount_amountMoneyDataObligatoireMontant décimal sous forme de chaîne JSON ; null uniquement lorsque cela est autorisé.
discountsTableau <OrderDiscountData> ObligatoireRéductions
idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée. (OrderDetailData).
invoiceInvoiceDatanullObligatoireInformations de facturation.
invoice_requestedBooléenObligatoireIndique si une facture a été demandée.
lifecycle_stateOrderLifecycleStateObligatoireÉtat du cycle de vie métier.
linesTableau <OrderLineData> ObligatoireInstantanés des lignes de commande.
localeChaîneObligatoireLangue sélectionnée pour cette requête.
market_idChaîneObligatoireIdentifiant de marché renvoyé par le point d'accès au contexte.
numberChaîneObligatoireNuméro de commande ou de demande visible par l'utilisateur.
paymentPaymentDataObligatoireDétails du paiement enregistrés pour la commande.
pickup_pointPickupPointDatanullObligatoirePoint de retrait
prices_include_taxBooléenObligatoireIndique si les prix de la liste comprennent les taxes.
shipping_addressAddressDatanullObligatoireAdresse de livraison.
shipping_discount_amountMoneyDataObligatoireMontant décimal sous forme de chaîne JSON ; null uniquement lorsque cela est autorisé.
statusOrderStatusDataObligatoireStatut accepté par cette opération précise.
subtotalMoneyDataObligatoireMontant avant les composantes supplémentaires indiquées dans la réponse.
taxMoneyDataObligatoireInformations sur les taxes.
tax_breakdownOrderTaxBreakdownDataObligatoireGroupes de taxes · source + tax_rate; unallocated_tax.
tax_country_codeChaîne nullObligatoirePays fiscal · Données enregistrées de la commande · ISO 3166-1 alpha-2; null.
totalMoneyDataObligatoireMontant total.
totalsOrderTotalsDataObligatoireTotaux · net / tax / gross; Avant remises / Après remises.
Champs supplémentaires: Non
OrderFileData
OrderFileData · Champs, types et contraintes des données acceptées ou renvoyées par l’API. Transmettez les fichiers en multipart/form-data après la création de upload_id, puis associez-les au produit. Le téléchargement exige un jeton Bearer et le droit correspondant à category ; la réponse contient les octets, sans adresse publique ni mot de passe. Pour mode=period, choisissez days (1–3650) ou l’ancien months, jamais les deux. Les conditions sont enregistrées à l’achat ; le remboursement retire uniquement l’accès à la ligne remboursée.
can_downloadBooléenObligatoireTélécharger (true / false)
categoryFileCategoryObligatoireCatégorie de fichier: internal / customer_document / digital
filenameChaîneObligatoireFichier
idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée.
labelChaîneObligatoireNom de la ressource dans le contexte concerné.
line_idChaîneObligatoireIdentifiant stable de la ligne de commande.
mime_typeChaîneObligatoireType de contenu du média.
product_idChaîneObligatoireIdentifiant du produit.
purchase_idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée. · purchase_id
reasonChaîneObligatoireMotif enregistré pour la modification.
sha256ChaîneObligatoireSHA-256 (hex, 64)
size_bytesEntierObligatoireTaille en octets
minimum:1maximum:262144000source_file_idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée. · source_file_id
source_version_idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée. · source_version_id
source_version_numberEntierObligatoireVersion
minimum:1stateChaîneObligatoireStatut
Champs supplémentaires: Non
OrderFileListData
OrderFileListData · Champs, types et contraintes des données acceptées ou renvoyées par l’API. Transmettez les fichiers en multipart/form-data après la création de upload_id, puis associez-les au produit. Le téléchargement exige un jeton Bearer et le droit correspondant à category ; la réponse contient les octets, sans adresse publique ni mot de passe. Pour mode=period, choisissez days (1–3650) ou l’ancien months, jamais les deux. Les conditions sont enregistrées à l’achat ; le remboursement retire uniquement l’accès à la ligne remboursée.
filesTableau <OrderFileData> ObligatoireFichiers du produit
updates_pendingBooléenObligatoireAccès aux futurs fichiers après achat · updates_pending
Champs supplémentaires: Non
Métadonnées et URL de l'image
OrderImageData · Schéma · Schémas de données: Commandes
altChaîne nullObligatoireTexte alternatif de l'image.
sourceChaîneFacultatifSource de l'activité enregistrée.
const:"current_catalog"urlChaîneObligatoireURL de la ressource.
Champs supplémentaires: Non
État du cycle de vie métier
OrderLifecycleState · Schéma · Schémas de données: Commandes
ChaîneContraintes
enum["placed", "cancelled", "fulfilled", "returned"]
Champs supplémentaires: Oui
Instantanés des lignes de commande
OrderLineData · Schéma · Schémas de données: Commandes
discount_amountMoneyDataObligatoireMontant décimal sous forme de chaîne JSON ; null uniquement lorsque cela est autorisé.
discount_grossMoneyDataObligatoireMontant brut · Remises; Inconnu : null ; zéro connu : 0.
discount_netMoneyDatanullObligatoireMontant net · Remises; Inconnu : null ; zéro connu : 0.
discount_taxMoneyDatanullObligatoireMontant de taxe · Remises; Inconnu : null ; zéro connu : 0.
discountsTableau <OrderDiscountData> ObligatoireRemises · net / tax / gross.
identifiersObjetChamps supplémentaires: ChaîneObligatoireCodes d'identification du produit.
imageOrderImageDatanullObligatoireMétadonnées et URL de l'image.
line_idChaîneObligatoireIdentifiant stable de la ligne de commande.
manual_discountOrderManualDiscountDatanullObligatoireRemise manuelle; null.
nameChaîneObligatoireNom de la ressource dans le contexte concerné.
original_totalMoneyDataObligatoireMontant total.
original_total_grossMoneyDataObligatoireMontant brut · Produits · Avant remises; Inconnu : null ; zéro connu : 0.
original_total_netMoneyDatanullObligatoireMontant net · Produits · Avant remises; Inconnu : null ; zéro connu : 0.
original_total_taxMoneyDatanullObligatoireMontant de taxe · Produits · Avant remises; Inconnu : null ; zéro connu : 0.
positionEntierObligatoirePosition dans la collection ordonnée.
product_idChaîneObligatoireIdentifiant du produit.
quantityEntierObligatoireNombre d'unités.
skuChaîneObligatoireCode de l'unité de gestion des stocks.
taxMoneyDatanullObligatoireMontant de taxe · Une unité · Données enregistrées de la commande; tax ≠ unit_tax; Inconnu : null ; zéro connu : 0.
tax_category_idChaîne nullObligatoireIdentifiant de catégorie fiscale · Données enregistrées de la commande; null.
tax_category_nameChaîne nullObligatoireNom enregistré de la catégorie fiscale; null.
tax_rateChaîne nullObligatoiretax_rate · Données enregistrées de la commande: "0.23" = 23%; "0" ≠ null.
totalMoneyDataObligatoireMontant total.
total_grossMoneyDataObligatoireMontant brut · Produits · Après remises; Inconnu : null ; zéro connu : 0.
total_netMoneyDatanullObligatoireMontant net · Produits · Après remises; Inconnu : null ; zéro connu : 0.
total_taxMoneyDatanullObligatoireMontant de taxe · Produits · Après remises · Données enregistrées de la commande; Inconnu : null ; zéro connu : 0.
unit_grossMoneyDataObligatoireMontant brut · Une unité · Avant remises; Inconnu : null ; zéro connu : 0.
unit_netMoneyDatanullObligatoireMontant net · Une unité · Avant remises; Inconnu : null ; zéro connu : 0.
unit_priceMoneyDataObligatoirePrix unitaire.
unit_taxMoneyDatanullObligatoireMontant de taxe · Une unité · Avant remises; Inconnu : null ; zéro connu : 0.
variant_idChaîne nullObligatoireIdentifiant de la variante du produit.
variant_optionsTableau <shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData> ObligatoireOptions de variante associées au produit ou à l'instantané enregistré.
Champs supplémentaires: Non
Remise manuelle
OrderManualDiscountData · Les montants et taux proviennent de la commande enregistrée, corrections de lignes comprises. Les données historiques manquantes valent null et ne sont pas remplacées par les taux actuels du catalogue. Les montants restent des chaînes décimales.
amountMoneyDataObligatoireMontant brut · Remise manuelle · Données enregistrées de la commande.
kindChaîneObligatoireType de remise: percentage / fixed.
Contraintes
enum["percentage", "fixed"]
valueChaîneObligatoireValeur configurée: percentage "10" = 10%; fixed = Montant brut.
Champs supplémentaires: Non
Statut accepté par cette opération précise
OrderPaymentStatus · Schéma · Schémas de données: Commandes
ChaîneContraintes
enum["unpaid", "paid", "failed", "refunded"]
Champs supplémentaires: Oui
OrderReleaseData
OrderReleaseData · Champs, types et contraintes des données acceptées ou renvoyées par l’API. Transmettez les fichiers en multipart/form-data après la création de upload_id, puis associez-les au produit. Le téléchargement exige un jeton Bearer et le droit correspondant à category ; la réponse contient les octets, sans adresse publique ni mot de passe. Pour mode=period, choisissez days (1–3650) ou l’ancien months, jamais les deux. Les conditions sont enregistrées à l’achat ; le remboursement retire uniquement l’accès à la ligne remboursée.
access_reasonChaîneObligatoireAccès après achat · Motif enregistré pour la modification.
access_stateChaîneObligatoireAccès après achat · Statut
current_releaseCurrentReleaseDatanullObligatoireVersions numériques · current_release
grant_reasonChaîneObligatoireAccès après achat · Motif enregistré pour la modification.
granted_atChaîneObligatoireAccès après achat · UTC
format:"date-time"idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée.
line_idChaîneObligatoireIdentifiant stable de la ligne de commande.
manifest_sha256ChaîneObligatoireVersions numériques · SHA-256
product_idChaîneObligatoireIdentifiant du produit.
published_atChaîneObligatoirePublier la version · UTC
format:"date-time"purchase_idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée. · purchase_id
release_idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée. · release_id
release_sequenceEntierObligatoireVersions numériques · Position dans la collection ordonnée.
update_daysEntier nullObligatoireNombre de jours (days; null)
update_modeChaîneObligatoireAccès aux futurs fichiers après achat: none / period / unlimited
update_monthsEntier nullObligatoireMois (months; null)
updates_untilChaîne nullObligatoireAccès aux futurs fichiers après achat · UTC
Chaîne:format:"date-time"version_labelChaîneObligatoireVersion
Champs supplémentaires: Non
OrderReleaseListData
OrderReleaseListData · Champs, types et contraintes des données acceptées ou renvoyées par l’API. Transmettez les fichiers en multipart/form-data après la création de upload_id, puis associez-les au produit. Le téléchargement exige un jeton Bearer et le droit correspondant à category ; la réponse contient les octets, sans adresse publique ni mot de passe. Pour mode=period, choisissez days (1–3650) ou l’ancien months, jamais les deux. Les conditions sont enregistrées à l’achat ; le remboursement retire uniquement l’accès à la ligne remboursée.
releasesTableau <OrderReleaseData> ObligatoireVersions numériques
updates_pendingBooléenObligatoireAccès aux futurs fichiers après achat · updates_pending
Champs supplémentaires: Non
Statut accepté par cette opération précise
OrderStatusData · Schéma · Schémas de données: Commandes
idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée. (OrderStatusData).
nameChaîneObligatoireNom de la ressource dans le contexte concerné.
updated_atChaîneObligatoireDate et heure de la dernière modification.
format:"date-time"versionEntierObligatoireVersion de ressource utilisée pour le contrôle de concurrence.
Champs supplémentaires: Non
Lister · Statuts — Commandes — Réponse
shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
created_atChaîneObligatoireDate et heure de création.
format:"date-time"idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée. (shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData).
is_initialBooléenObligatoireIndique s'il s'agit du statut initial.
nameChaîneObligatoireNom de la ressource dans le contexte concerné.
positionEntierObligatoirePosition dans la collection ordonnée.
Champs supplémentaires: Non
Lister · Statuts — Commandes — Réponse
shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1 · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
dataTableau <shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData> ObligatoireExemple de réponse · shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1.
metaContextPageMetaContextMetaPageMetaRequestMetaObligatoireMétadonnées de la réponse.
Champs supplémentaires: Non
Modifier · Statut — Commandes — Corps de la requête
OrderStatusUpdate · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
expected_versionEntierObligatoireVersion lue avant l'écriture ; une différence entraîne le rejet de la modification.
minimum:1maximum:9223372036854775807status_idChaîneObligatoireIdentifiant obtenu dans le répertoire de statuts correspondant.
Contraintes
pattern"^[a-z0-9][a-z0-9_-]{0,62}$"
Champs supplémentaires: Non
Lister — Commandes — Réponse
OrderSummaryData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
created_atChaîneObligatoireDate et heure de création.
format:"date-time"customerCustomerDataObligatoireDonnées du client enregistrées pour cette ressource.
deliveryShippingDataObligatoireMode de livraison et informations associées.
discount_amountMoneyDataObligatoireMontant décimal sous forme de chaîne JSON ; null uniquement lorsque cela est autorisé.
idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée. (OrderSummaryData).
lifecycle_stateOrderLifecycleStateObligatoireÉtat du cycle de vie métier.
localeChaîneObligatoireLangue sélectionnée pour cette requête.
market_idChaîneObligatoireIdentifiant de marché renvoyé par le point d'accès au contexte.
numberChaîneObligatoireNuméro de commande ou de demande visible par l'utilisateur.
paymentPaymentDataObligatoireDétails du paiement enregistrés pour la commande.
prices_include_taxBooléenObligatoireIndique si les prix de la liste comprennent les taxes.
shipping_discount_amountMoneyDataObligatoireMontant décimal sous forme de chaîne JSON ; null uniquement lorsque cela est autorisé.
statusOrderStatusDataObligatoireStatut accepté par cette opération précise.
subtotalMoneyDataObligatoireMontant avant les composantes supplémentaires indiquées dans la réponse.
taxMoneyDataObligatoireInformations sur les taxes.
tax_country_codeChaîne nullObligatoirePays fiscal · Données enregistrées de la commande · ISO 3166-1 alpha-2; null.
totalMoneyDataObligatoireMontant total.
Champs supplémentaires: Non
Commande · Groupes de taxes
OrderTaxBreakdownData · Les montants et taux proviennent de la commande enregistrée, corrections de lignes comprises. Les données historiques manquantes valent null et ne sont pas remplacées par les taux actuels du catalogue. Les montants restent des chaînes décimales.
groupsTableau <OrderTaxGroupData> ObligatoireGroupes de taxes · source + tax_rate; Inconnu : null ; zéro connu : 0.
unallocated_taxMoneyDataObligatoireTaxe non affectée = order.tax − Σ groups.tax; ±.
Champs supplémentaires: Non
Groupes de taxes
OrderTaxGroupData · Les montants et taux proviennent de la commande enregistrée, corrections de lignes comprises. Les données historiques manquantes valent null et ne sont pas remplacées par les taux actuels du catalogue. Les montants restent des chaînes décimales.
grossMoneyDataObligatoireMontant brut · Après remises; Inconnu : null ; zéro connu : 0.
netMoneyDatanullObligatoireMontant net · Après remises; Inconnu : null ; zéro connu : 0.
sourceChaîneObligatoireSource: products (Produits), shipping (Livraison).
Contraintes
enum["products", "shipping"]
taxMoneyDatanullObligatoireMontant de taxe · Après remises; Inconnu : null ; zéro connu : 0.
tax_rateChaîne nullObligatoiretax_rate · Données enregistrées de la commande: "0.23" = 23%; "0" ≠ null.
Champs supplémentaires: Non
Commande · Totaux
OrderTotalsData · Les montants et taux proviennent de la commande enregistrée, corrections de lignes comprises. Les données historiques manquantes valent null et ne sont pas remplacées par les taux actuels du catalogue. Les montants restent des chaînes décimales.
before_discountsOrderAmountBreakdownDataObligatoireCommande · Avant remises · net / tax / gross.
discountsOrderAmountBreakdownDataObligatoireRemises · net / tax / gross.
orderOrderAmountBreakdownDataObligatoireCommande · Après remises · net / tax / gross.
product_discountsOrderAmountBreakdownDataObligatoireProduits · Remises · net / tax / gross.
productsOrderAmountBreakdownDataObligatoireProduits · Après remises · net / tax / gross.
products_before_discountsOrderAmountBreakdownDataObligatoireProduits · Avant remises · net / tax / gross.
shippingOrderAmountBreakdownDataObligatoireLivraison · Après remises · net / tax / gross.
shipping_before_discountsOrderAmountBreakdownDataObligatoireLivraison · Avant remises · net / tax / gross.
shipping_discountsOrderAmountBreakdownDataObligatoireLivraison · Remises · net / tax / gross.
Champs supplémentaires: Non
Options de variante associées au produit ou à l'instantané enregistré
shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData · Schéma · Schémas de données: Commandes
nameChaîneObligatoireNom de la ressource dans le contexte concerné.
valueChaîneObligatoireValeur décrite par le schéma environnant.
Champs supplémentaires: Non
OrderDiscountData
OrderDiscountData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
amountMoneyDataObligatoireMontant brut · Produits · Remises.
campaign_idChaîneObligatoireIdentifiant de ressource ; conserver la valeur renvoyée.
codeChaîne nullObligatoireCode stable lisible par une machine.
kindChaîneObligatoireVariante de la structure de données définie par les valeurs autorisées.
Contraintes
enum["coupon", "promotion"]
nameChaîneObligatoireNom de la ressource dans le contexte concerné.
sequenceEntier nullFacultatifOrdre d’application; null.
shipping_amountMoneyDatanullFacultatifMontant brut · Livraison · Remises; null.
versionEntierObligatoireVersion de ressource utilisée pour le contrôle de concurrence.
Champs supplémentaires: Non
Détails du paiement enregistrés pour la commande
PaymentData · Schéma · Schémas de données: Commandes
amountMoneyDataObligatoirepayment.amount est le total de la commande. Le statut du paiement ne détermine pas les montants payés, remboursés ou restant dus.
environmentChaîneObligatoireInformations d'environnement associées à l'enregistrement.
Contraintes
enum["live", "sandbox"]
method_codeChaîne nullObligatoireCode du mode de livraison ou de paiement.
method_nameChaîne nullObligatoireNom du mode de livraison ou de paiement.
paid_atChaîne nullObligatoireDate et heure du passage au statut payé.
Chaîne:format:"date-time"statusOrderPaymentStatusObligatoireStatut accepté par cette opération précise.
updated_atChaîneObligatoireDate et heure de la dernière modification.
format:"date-time"versionEntierObligatoireVersion de ressource utilisée pour le contrôle de concurrence.
Champs supplémentaires: Non
Modifier · Statut du paiement — Commandes — Corps de la requête
PaymentStatusUpdate · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
expected_versionEntierObligatoireVersion lue avant l'écriture ; une différence entraîne le rejet de la modification.
minimum:0maximum:9223372036854775807reasonChaîneObligatoireMotif enregistré pour la modification.
minLength:1maxLength:500statusPaymentStatusObligatoireStatut accepté par cette opération précise. unpaid: non payé; paid: payé; failed: paiement échoué; refunded: remboursé.
Champs supplémentaires: Non
Statut accepté par cette opération précise
PaymentStatus · Schéma · Schémas de données: Commandes
ChaîneContraintes
enum["unpaid", "paid", "failed", "refunded"]
Champs supplémentaires: Oui
PickupPointAddressData
PickupPointAddressData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
address_line_1ChaîneObligatoirePremière ligne d'adresse.
minLength:1maxLength:240cityChaîneObligatoireVille ou localité.
minLength:1maxLength:160postal_codeChaîneObligatoireCode postal.
minLength:1maxLength:32
Champs supplémentaires: Non
PickupPointCoordinatesData
PickupPointCoordinatesData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
latitudeNombreObligatoireWGS84 φ (°)
minimum:-90.0maximum:90.0longitudeNombreObligatoireWGS84 λ (°)
minimum:-180.0maximum:180.0
Champs supplémentaires: Non
PickupPointData
PickupPointData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
address_line1ChaîneObligatoirePremière ligne d'adresse.
cityChaîneObligatoireVille ou localité.
codeChaîneObligatoireCode stable lisible par une machine.
country_codeChaîneObligatoireCode du pays.
kindChaîneObligatoireVariante de la structure de données définie par les valeurs autorisées.
Contraintes
enum["locker", "pickup_point"]
latitudeNombre nullObligatoireWGS84 φ (°)
location_descriptionChaîne nullObligatoireDescription dans la langue sélectionnée.
longitudeNombre nullObligatoireWGS84 λ (°)
nameChaîneObligatoireNom de la ressource dans le contexte concerné.
opening_hoursChaîne nullObligatoireOpening hours
operatorChaîneObligatoireNom de la ressource dans le contexte concerné.
postal_codeChaîneObligatoireCode postal.
Champs supplémentaires: Non
PickupPointSummaryData
PickupPointSummaryData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
codeChaîneObligatoireCode stable lisible par une machine.
Contraintes
pattern"^[A-Za-z0-9_-]{1,63}$"
country_codeChaîneObligatoireCode du pays.
Contraintes
pattern"^[A-Z]{2}$"
environmentChaîneObligatoireInformations d'environnement associées à l'enregistrement.
Contraintes
enum["live", "sandbox"]
kindChaîneObligatoireVariante de la structure de données définie par les valeurs autorisées.
Contraintes
enum["locker", "pickup_point"]
operatorChaîneObligatoireNom de la ressource dans le contexte concerné.
minLength:1maxLength:63
Champs supplémentaires: Non
Données du client enregistrées pour cette ressource
RequestCustomerData · Schéma · Schémas de données: Commandes
emailChaîneObligatoireAdresse e-mail.
nameChaîneObligatoireNom de la ressource dans le contexte concerné.
Champs supplémentaires: Non
Mode de livraison et informations associées
ShippingData · Schéma · Schémas de données: Commandes
amountMoneyDataObligatoireMontant TTC de la livraison enregistré dans la commande sous forme de MoneyData. Les modifications fiscales ultérieures ne changent pas ce montant historique.
datesDeliveryDatesDataObligatoireDates d’expédition et de livraison. La liste et le détail des commandes incluent delivery.dates. Les dates YYYY-MM-DD sont prévues et ne confirment pas l’expédition. Les dates actuelles sont prioritaires ; les anciennes commandes utilisent l’estimation enregistrée. Les valeurs effacées ou inconnues sont null. Le détail inclut aussi toutes les lignes et images des produits.
method_codeChaîne nullObligatoireCode du mode de livraison ou de paiement.
method_nameChaîne nullObligatoireNom du mode de livraison ou de paiement.
pickup_pointPickupPointSummaryDatanullObligatoirePoint de retrait
recipient_modeChaîneObligatoireVariante de la structure de données définie par les valeurs autorisées.
Contraintes
enum["full_address", "pickup_contact", "address_only", "name_contact", "contact_only"]
Champs supplémentaires: Non
ShippingDetailData
ShippingDetailData · Champs, types et contraintes des données acceptées ou renvoyées par l’API.
amountMoneyDataObligatoireMontant TTC de la livraison enregistré dans la commande sous forme de MoneyData. Les modifications fiscales ultérieures ne changent pas ce montant historique.
datesDeliveryDatesDataObligatoireDates d’expédition et de livraison. La liste et le détail des commandes incluent delivery.dates. Les dates YYYY-MM-DD sont prévues et ne confirment pas l’expédition. Les dates actuelles sont prioritaires ; les anciennes commandes utilisent l’estimation enregistrée. Les valeurs effacées ou inconnues sont null. Le détail inclut aussi toutes les lignes et images des produits.
discount_grossMoneyDataObligatoireMontant brut · Remises; Inconnu : null ; zéro connu : 0.
discount_netMoneyDatanullObligatoireMontant net · Remises; Inconnu : null ; zéro connu : 0.
discount_taxMoneyDatanullObligatoireMontant de taxe · Remises; Inconnu : null ; zéro connu : 0.
discountsTableau <OrderDeliveryDiscountData> nullObligatoireLivraison · Remises; []: 0; null: Inconnu : null ; zéro connu : 0.
grossMoneyDataObligatoireMontant brut · Après remises; Inconnu : null ; zéro connu : 0.
method_codeChaîne nullObligatoireCode du mode de livraison ou de paiement.
method_nameChaîne nullObligatoireNom du mode de livraison ou de paiement.
netMoneyDatanullObligatoireMontant net · Après remises; Inconnu : null ; zéro connu : 0.
original_grossMoneyDataObligatoireMontant brut · Livraison · Avant remises; Inconnu : null ; zéro connu : 0.
original_netMoneyDatanullObligatoireMontant net · Livraison · Avant remises; Inconnu : null ; zéro connu : 0.
original_taxMoneyDatanullObligatoireMontant de taxe · Livraison · Avant remises; Inconnu : null ; zéro connu : 0.
pickup_pointDeliveryPickupPointDatanullObligatoirePoint de retrait
recipient_modeChaîneObligatoireVariante de la structure de données définie par les valeurs autorisées.
Contraintes
enum["full_address", "pickup_contact", "address_only", "name_contact", "contact_only"]
taxMoneyDatanullObligatoireMontant de taxe · Après remises; Inconnu : null ; zéro connu : 0.
tax_category_idChaîne nullObligatoireIdentifiant de catégorie fiscale · Données enregistrées de la commande; null.
tax_category_nameChaîne nullObligatoireNom enregistré de la catégorie fiscale; null.
tax_rateChaîne nullObligatoiretax_rate · Données enregistrées de la commande: "0.23" = 23%; "0" ≠ null.
Champs supplémentaires: Non