Partager via


eBay (Éditeur indépendant) (préversion)

eBay est une entreprise de commerce électronique multinationale américaine qui facilite les ventes de consommateurs à consommateurs et d’entreprises à consommateurs par le biais de son site web.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Artesian Software Technologies LLP
URL https://artesian.io
Messagerie électronique amit.sharma@artesian.io
Métadonnées du connecteur
Éditeur Artesian Software Technologies LLP
Site internet https://www.ebay.com/
Politique de confidentialité https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260
Catégories Commerce; Ventes et CRM

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
ID client - Votre id client eBay ficelle Entrez l’ID client. Vrai
Clé secrète client securestring Entrez la clé secrète client. Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Créer ou remplacer un élément d’inventaire

Cet appel crée un enregistrement d’élément d’inventaire ou remplace un enregistrement d’élément d’inventaire existant.

Créer un emplacement d’inventaire

Utilisez cet appel pour créer un emplacement d’inventaire. Pour créer et publier une offre, un vendeur doit avoir au moins un emplacement d’inventaire, car chaque offre doit être associée à un emplacement.

Créer une offre

Cet appel crée une offre pour un élément d’inventaire spécifique sur une place de marché eBay spécifique.

GET Inventory Item

Cet appel récupère l’enregistrement d’élément d’inventaire pour une référence SKU donnée.

Mettre à jour l’offre

Cet appel met à jour une offre existante qui peut être publiée ou dans un état non publié.

Obtenir des aspects d’élément pour la catégorie

Cet appel retourne une liste d’aspects appropriés ou nécessaires pour décrire avec précision les éléments de la catégorie feuille spécifiée. Chaque aspect identifie un attribut d’élément (par exemple, couleur) pour lequel le vendeur sera requis ou encouragé à fournir une valeur (ou des valeurs de variante) lors de l’offre d’un élément dans cette catégorie sur eBay.

Obtenir des emplacements d’inventaire

Cet appel récupère tous les détails définis pour chaque emplacement d’inventaire associé au compte du vendeur.

Obtenir des stratégies de paiement

Cette méthode récupère toutes les stratégies de paiement configurées pour la Place de marché que vous spécifiez à l’aide du paramètre de requête marketplace_id.

Obtenir des stratégies de traitement

Cette méthode récupère toutes les stratégies de traitement configurées pour la Place de marché que vous spécifiez à l’aide du paramètre de requête marketplace_id.

Obtenir des suggestions de catégorie

Cet appel retourne un tableau de nœuds feuilles d’arbre de catégorie dans l’arborescence de catégorie spécifiée qui sont considérés par eBay pour correspondre le plus étroitement à la requête.

Obtenir des éléments d’inventaire

Cet appel récupère tous les enregistrements d’éléments d’inventaire définis pour le compte du vendeur.

Obtenir la stratégie de paiement

Cette méthode récupère les détails complets d’une stratégie de paiement. Indiquez l’ID de la stratégie que vous souhaitez récupérer à l’aide du paramètre de chemin d’accès paymentPolicyId.

Obtenir la stratégie de retour

Cette méthode récupère les détails complets de la stratégie de retour spécifiée par le paramètre de chemin returnPolicyId.

Obtenir la stratégie de traitement

Cette méthode récupère les détails complets d’une stratégie de traitement. Indiquez l’ID de la stratégie que vous souhaitez récupérer à l’aide du paramètre de chemin d’accès fulfillmentPolicyId.

Obtenir les stratégies de condition d’élément

Cette méthode retourne les métadonnées de condition d’élément sur une, plusieurs ou toutes les catégories eBay sur une place de marché eBay.

Obtenir les stratégies de retour

Cette méthode récupère toutes les stratégies de retour configurées pour la Place de marché que vous spécifiez à l’aide du paramètre de requête marketplace_id.

Obtenir l’emplacement de l’inventaire

Cet appel récupère tous les détails définis de l’emplacement d’inventaire spécifié par le paramètre de chemin d’accès merchantLocationKey.

Obtenir l’TreeId de catégorie par défaut

Une place de marché eBay donnée peut utiliser plusieurs arborescences de catégories, mais l’un de ces arbres est considéré comme étant la valeur par défaut pour cette place de marché. Cet appel récupère une référence à l’arborescence de catégories par défaut associée à l’ID de place de marché eBay spécifié.

Offre GET

Cet appel récupère une offre publiée ou non publiée spécifique.

Offres GET

Cet appel récupère toutes les offres existantes pour la valeur de référence SKU spécifiée. Le vendeur a la possibilité de limiter les offres récupérées à une place de marché eBay spécifique ou à un format de référencement.

Publier une offre

Cet appel est utilisé pour convertir une offre non publiée en offre publiée ou en annonce eBay en direct. L’identificateur unique de l’offre (offerId) est transmis à la fin de l’URI d’appel.

Retirer l’offre

Cet appel est utilisé pour mettre fin à une liste à variante unique associée à l’offre spécifiée.

Supprimer l’offre

Cet appel supprime définitivement l’offre

Créer ou remplacer un élément d’inventaire

Cet appel crée un enregistrement d’élément d’inventaire ou remplace un enregistrement d’élément d’inventaire existant.

Paramètres

Nom Clé Obligatoire Type Description
Référence (SKU)
sku True string

Valeur définie par le vendeur pour l’élément d’inventaire.

Langue du contenu
Content-Language True string

L’en-tête définit le langage naturel qui sera utilisé dans les valeurs de champ de la charge utile de la requête.

Type
availabilityType string

État de disponibilité de l’article d’inventaire dans le magasin physique du commerçant.

Unité
unit string

Unité de temps utilisée pour spécifier l’heure de traitement.

Valeur
value integer

Valeur de temps de traitement.

Clé d’emplacement du marchand
merchantLocationKey string

ID unique du magasin du marchand où In-Store'élément d’inventaire de prise en charge est actuellement situé ou est envoyé à.

Quantité
quantity integer

Quantité d’articles d’inventaire disponibles pour In-Store enlèvement.

Unité
unit string

Unité de temps utilisée pour spécifier l’heure de traitement.

Valeur
value integer

Valeur de temps de traitement.

Clé d’emplacement du marchand
merchantLocationKey string

ID unique du magasin du marchand dans lequel In-Store'article d’inventaire de prise en charge est actuellement situé, ou auquel il sera envoyé.

Quantité
quantity integer

Quantité de l’élément d’inventaire disponible à cet emplacement d’inventaire.

Quantité
quantity integer

Quantité totale d’articles d’inventaire « ship-to-home » qui seront disponibles pour l’achat via une ou plusieurs offres publiées.

Condition
condition string

Condition de l’élément.

Condition Description
conditionDescription string

Description de condition d’un élément d’inventaire.

Hauteur
height number

Hauteur réelle du colis d’expédition.

Length
length number

Longueur réelle du colis d’expédition.

Unité
unit string

Unité de mesure utilisée pour spécifier les dimensions d’un colis d’expédition.

Largeur
width number

Largeur réelle du colis d’expédition.

Type de paquet
packageType string

Valeur du package d’expédition utilisée pour expédier l’article d’inventaire.

Unité
unit string

Unité de mesure utilisée pour spécifier le poids d’un colis d’expédition.

Valeur
value number

Poids réel du colis d’expédition.

Aspects
aspects object

Il s’agit d’une collection de paires nom-valeur spécifiques d’élément qui fournissent plus d’informations sur le produit et peuvent faciliter la recherche des acheteurs.

Marque
brand string

Marque du produit.

Descriptif
description string

Description du produit.

Éléments EAN
ean array of string

EAN

ePID
epid string

Identificateur de produit eBay pour le produit.

URL d’image
imageUrls array of string

URL d’image

Éléments ISBN
isbn array of string

Code ISBN

MPN
mpn string

Numéro de partie fabricant d’un produit.

Sous-titre
subtitle string

Fonctionnalité de référencement facultative qui permet au vendeur de fournir plus d’informations sur le produit, y compris éventuellement des mots clés susceptibles d’aider à obtenir des résultats de recherche.

Titre
title string

Le titre d’un élément d’inventaire peut être ajouté ou modifié.

Éléments UPC
upc array of string

Upc

ID de vidéo
videoIds array of string

videoIds

Retours

Nom Chemin d’accès Type Description
Avertissements
warnings array of object

Ce conteneur est retourné dans une charge utile de réponse aux appels si un ou plusieurs avertissements ou erreurs sont déclenchés.

Catégorie
warnings.category string

Cette valeur de chaîne indique la catégorie d’erreur.

Domain
warnings.domain string

Nom du domaine dans lequel l’erreur ou l’avertissement s’est produit.

ID d’erreur
warnings.errorId integer

Code unique qui identifie l’erreur ou l’avertissement particulier qui s’est produit.

inputRefIds
warnings.inputRefIds array of string

Tableau d’un ou plusieurs ID de référence qui identifient le ou les éléments de requête spécifiques les plus étroitement associés à l’erreur ou à l’avertissement, le cas échéant.

Long Message
warnings.longMessage string

Description détaillée de la condition qui a provoqué l’erreur ou l’avertissement et des informations sur ce qu’il faut faire pour corriger le problème.

Message
warnings.message string

Description de la condition qui a provoqué l’erreur ou l’avertissement.

outputRefIds
warnings.outputRefIds array of string

Tableau d’un ou plusieurs ID de référence qui identifient le ou les éléments de réponse spécifiques les plus étroitement associés à l’erreur ou à l’avertissement, le cas échéant.

parameters
warnings.parameters array of object

Différents messages d’avertissement et d’erreur retournent une ou plusieurs variables qui contiennent des informations contextuelles sur l’erreur ou l’avertissement.

nom
warnings.parameters.name string

nom

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain object

Description de la condition qui a provoqué l’erreur ou l’avertissement.

Créer un emplacement d’inventaire

Utilisez cet appel pour créer un emplacement d’inventaire. Pour créer et publier une offre, un vendeur doit avoir au moins un emplacement d’inventaire, car chaque offre doit être associée à un emplacement.

Paramètres

Nom Clé Obligatoire Type Description
Clé d’emplacement du marchand
merchantLocationKey True string

Clé définie par un marchand unique pour un emplacement d’inventaire.

Ligne d’adresse 1
addressLine1 string

Première ligne d’une adresse postale.

Ligne d’adresse 2
addressLine2 string

Deuxième ligne d’une adresse postale.

Ville
city string

Ville où réside l’emplacement d’inventaire.

Pays
country string

Code de pays dans lequel réside l’adresse.

Commune
county string

Comté dans lequel réside l’adresse.

Code postal
postalCode string

Code postal/postal de l’adresse.

État ou province
stateOrProvince string

État/province dans lequel réside l’emplacement de l’inventaire.

Latitude
latitude string

Composant Latitude de la coordonnée géographique.

Longitude
longitude string

Composant longitude de la coordonnée géographique.

Informations supplémentaires sur l’emplacement
locationAdditionalInformation string

Informations supplémentaires sur un emplacement d’inventaire.

Instructions d’emplacement
locationInstructions string

Instructions de collecte spéciales pour un emplacement d’inventaire des magasins.

locationTypes
locationTypes array of string

Types d’emplacement

URL web d’emplacement
locationWebUrl string

Adresse du site web associée à l’emplacement d’inventaire.

État de l’emplacement du marchand
merchantLocationStatus string

L’état de l’emplacement de l’inventaire peut être activé ou désactivé.

Nom
name string

Nom de l’emplacement de l’inventaire.

Jour de la semaine
dayOfWeekEnum string

Le jour où l’emplacement du magasin a des heures de fonctionnement régulières.

close
close string

Durée de fermeture du magasin.

ouvrir
open string

Stocker l’heure d’ouverture.

Téléphone
phone string

Numéro de téléphone d’un emplacement d’inventaire de magasin.

Date
date string

Valeur de date spécifique que l’emplacement du magasin a des heures d’exploitation spéciales.

close
close string

Durée de fermeture du magasin.

ouvrir
open string

Stocker l’heure d’ouverture.

Retours

response
string

Créer une offre

Cet appel crée une offre pour un élément d’inventaire spécifique sur une place de marché eBay spécifique.

Paramètres

Nom Clé Obligatoire Type Description
Quantité disponible
availableQuantity integer

Quantité disponible d’inventaire pour l’achat.

ID de catégorie
categoryId string

ID de catégorie unique eBay sous lequel le produit sera répertorié.

ID de la charité
charityId string

ID unique attribué par eBay d’une organisation caritative qui recevra un pourcentage de produits de vente.

Pourcentage de dons
donationPercentage string

Pourcentage de prix d’achat que l’organisme de bienfaisance recevra pour chaque vente générée.

ID du produit producteur
producerProductId string

Identificateur unique du producteur lié à l’élément.

ID du package de produit
productPackageId string

ID unique du producteur d’emballages de produits ajouté par le vendeur.

ID du package d’expédition
shipmentPackageId string

ID unique du producteur d’un emballage utilisé par le vendeur pour expédier l’article.

ID de documentation du produit
productDocumentationId string

Identificateur unique du producteur d’un papier ajouté au colis de l’article par le vendeur.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Format
format string

Mise en liste du format de l’offre.

Masquer les détails de l’acheteur
hideBuyerDetails boolean

Ce champ est inclus si le vendeur souhaite créer une description privée.

Inclure les détails du produit du catalogue
includeCatalogProductDetails boolean

Indique si les détails du catalogue de produits eBay sont appliqués à une description.

Description de la description
listingDescription string

Description de la description eBay.

Durée de la liste
listingDuration string

Nombre de jours pendant lesquels la liste sera active.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Meilleure offre activée
bestOfferEnabled boolean

Indique si la fonctionnalité Best Offer est activée ou non pour la description.

eBay Plus Si éligible
eBayPlusIfEligible boolean

Ce champ est inclus dans une offre si un vendeur Top-Rated est choisi dans le programme eBay Plus.

ID de stratégie de traitement
fulfillmentPolicyId string

L’identificateur unique indique la stratégie d’entreprise de traitement qui sera utilisée une fois qu’une offre est publiée et convertie en liste eBay.

ID de stratégie de paiement
paymentPolicyId string

L’identificateur unique indique la stratégie d’entreprise de paiement qui sera utilisée une fois qu’une offre est publiée et convertie en liste eBay.

ID de stratégie de conformité des produits
productCompliancePolicyIds array of string

Ce champ contient un tableau d’un maximum de cinq ID spécifiant les stratégies de conformité créées par le vendeur pour la description.

ID de stratégie de retour
returnPolicyId string

Retournez un ID unique de stratégie d’entreprise qui sera utilisé une fois qu’une offre est publiée et convertie en description eBay.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Priority
priority integer

La valeur entière entrée dans ce champ, ainsi que la valeur shippingServiceType, définit l’option de service d’expédition nationale ou internationale dans la stratégie de traitement sera modifiée avec les coûts d’expédition mis à jour.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Service Type
shippingServiceType string

Cette valeur indique si le service d’expédition spécifié dans le champ de priorité est une option de service d’expédition national ou international.

Reprendre l’ID de stratégie
takeBackPolicyId string

ID vendeur qui a créé une stratégie de reprise d’accès.

Date de début de la liste
listingStartDate string

Ce champ peut être utilisé si le vendeur souhaite spécifier une heure à l’avenir que la description deviendra active sur eBay.

Taille du lot
lotSize integer

Ce champ s’applique uniquement si la description est beaucoup list. La valeur entière passée dans ce champ est le nombre total d’éléments du lot.

ID de la Place de marché
marketplaceId string

ID unique du site eBay pour lequel l’offre sera mise à disposition.

Clé d’emplacement du marchand
merchantLocationKey string

Identificateur unique de l’emplacement d’inventaire d’un marchand

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Initialement vendu pour le prix de vente au détail on
originallySoldForRetailPriceOn string

Ce champ est nécessaire si la fonctionnalité de tarification Strikethrough sera utilisée dans l’offre. Ce champ indique que le produit a été vendu pour le prix dans le champ RetailPrice d’origine sur un site eBay, ou vendu pour ce prix par un détaillant tiers

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Visibilité des prix
pricingVisibility string

Ce champ est nécessaire si la fonctionnalité Prix annoncé minimal sera utilisée dans l’offre.

Limite de quantité par acheteur
quantityLimitPerBuyer integer

Ce champ est applicable uniquement et défini si le vendeur souhaite définir une restriction sur la quantité d’achat par vendeur.

ID de catégorie secondaire
secondaryCategoryId string

ID de catégorie secondaire unique et applicable si le vendeur décide de répertorier l’élément sous deux catégories.

Référence (SKU)
sku string

Valeur de référence SKU définie par le vendeur du produit qui sera répertoriée sur le site eBay.

Noms des catégories de magasin
storeCategoryNames array of string

Nom de la catégorie de magasin

Appliquer la taxe
applyTax boolean

Ce conteneur s’applique uniquement et est utilisé si une table de taxe sur les ventes, un taux d’imposition Value-Added ou un code de catégorie d’exception fiscale sera appliqué à l’offre.

Catégorie fiscale tierce
thirdPartyTaxCategory string

Code de catégorie d’exception fiscale. Si ce champ est utilisé, la taxe de vente s’applique également à un service/frais, et pas seulement au prix de l’article.

Pourcentage de TVA
vatPercentage number

Cette valeur est le taux de TVA pour l’élément, le cas échéant. Lorsqu’un pourcentage de TVA est spécifié, les informations de TVA de l’élément s’affichent sur la page Afficher l’élément de la liste.

Retours

Nom Chemin d’accès Type Description
ID de l’offre
offerId string

Identificateur unique de l’offre

Avertissements
warnings array of object

Ce conteneur retourne lorsqu’un appel est effectué, et des erreurs et/ou des avertissements se produisent.

Catégorie
warnings.category string

Cette valeur de chaîne indique la catégorie d’erreur

Domain
warnings.domain string

Nom de domaine dans lequel l’erreur ou l’avertissement s’est produit.

ID d’erreur
warnings.errorId integer

Code unique qui identifie l’erreur ou l’avertissement particulier qui s’est produit.

inputRefIds
warnings.inputRefIds array of string

Tableau d’un ou plusieurs ID de référence qui identifient le ou les éléments de requête spécifiques les plus étroitement associés à l’erreur ou à l’avertissement, le cas échéant.

Long Message
warnings.longMessage string

Description détaillée de la condition qui a provoqué l’erreur ou l’avertissement et des informations sur ce qu’il faut faire pour corriger le problème.

Message
warnings.message string

Description de la condition qui a provoqué l’erreur ou l’avertissement.

outputRefIds
warnings.outputRefIds array of string

Tableau d’un ou plusieurs ID de référence qui identifient le ou les éléments de réponse spécifiques les plus étroitement associés à l’erreur ou à l’avertissement, le cas échéant.

parameters
warnings.parameters array of object

Différents messages d’avertissement et d’erreur retournent une ou plusieurs variables qui contiennent des informations contextuelles sur l’erreur ou l’avertissement.

nom
warnings.parameters.name string

nom

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nom du sous-domaine dans lequel l’erreur ou l’avertissement s’est produit.

GET Inventory Item

Cet appel récupère l’enregistrement d’élément d’inventaire pour une référence SKU donnée.

Paramètres

Nom Clé Obligatoire Type Description
Référence (SKU)
sku True string

Valeur définie par le vendeur du produit dont vous souhaitez récupérer l’enregistrement d’élément d’inventaire.

Retours

Nom Chemin d’accès Type Description
PickupAtLocationAvailability
availability.pickupAtLocationAvailability array of object

Ce conteneur se compose d’un tableau de magasins physiques de marchands où l’article d’inventaire est disponible pour la prise en magasin.

Type de disponibilité
availability.pickupAtLocationAvailability.availabilityType string

Ce champ indique l’état de disponibilité de l’article d’inventaire dans le magasin physique du commerçant.

Unité
availability.pickupAtLocationAvailability.fulfillmentTime.unit string

La valeur indique l’unité de temps utilisée pour spécifier l’heure de traitement

Valeur
availability.pickupAtLocationAvailability.fulfillmentTime.value integer

La valeur entière de ce champ, ainsi que l’unité de temps dans le champ d’unité, indique l’heure de traitement.

Clé d’emplacement du marchand
availability.pickupAtLocationAvailability.merchantLocationKey string

Identificateur unique du magasin du marchand dans lequel se trouve actuellement l’élément d’inventaire In-Store Enlèvement, ou à lequel il sera envoyé.

Quantité
availability.pickupAtLocationAvailability.quantity integer

Cette valeur entière indique la quantité de l’élément d’inventaire disponible pour In-Store enlèvement

Vente aux enchères
availability.shipToLocationAvailability.allocationByFormat.auction integer

Cette valeur entière indique la quantité de l’élément d’inventaire réservé aux offres de format d’enchères publiées de la référence SKU.

Prix fixe
availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

Cette valeur entière indique la quantité de l’élément d’inventaire disponible pour les offres à prix fixe de la référence SKU.

AvailabilityDistributions
availability.shipToLocationAvailability.availabilityDistributions array of object

Ce conteneur est utilisé pour définir la quantité disponible de l’élément d’inventaire à un ou plusieurs emplacements d’entrepôt.

Unité
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

La valeur indique l’unité de temps utilisée pour spécifier l’heure de traitement

Valeur
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

La valeur entière de ce champ, ainsi que l’unité de temps dans le champ d’unité, indique l’heure de traitement.

Clé d’emplacement du marchand
availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

Identificateur unique d’un emplacement d’inventaire où la quantité est disponible pour l’élément d’inventaire.

Quantité
availability.shipToLocationAvailability.availabilityDistributions.quantity integer

Quantité de l’élément d’inventaire disponible à cet emplacement d’inventaire.

Quantité
availability.shipToLocationAvailability.quantity integer

Ce conteneur est utilisé pour définir la quantité totale de « navire à domicile » de l’article d’inventaire qui sera disponible pour l’achat via une ou plusieurs offres publiées.

Condition
condition string

Cette valeur indique la condition de l’élément

Condition Description
conditionDescription string

Ce champ de chaîne est utilisé par le vendeur pour décrire plus clairement la condition des éléments utilisés ou des éléments qui ne sont pas « Nouveau », « Nouveau avec des étiquettes » ou « Nouveau dans la zone ».

identifiants de groupe
groupIds array of string
inventoryItemGroupKeys
inventoryItemGroupKeys array of string

Ce tableau est retourné si l’élément d’inventaire est associé à un ou plusieurs groupes d’éléments d’inventaire.

Paramètres régionaux
locale string

Ce champ retourne le langage naturel fourni dans les valeurs de champ de la charge utile de la requête

Hauteur
packageWeightAndSize.dimensions.height number

Hauteur réelle du colis d’expédition.

Length
packageWeightAndSize.dimensions.length number

Longueur réelle du colis d’expédition.

Unité
packageWeightAndSize.dimensions.unit string

Unité de mesure utilisée pour spécifier les dimensions d’un colis d’expédition.

Largeur
packageWeightAndSize.dimensions.width number

Largeur réelle du colis d’expédition.

Type de paquet
packageWeightAndSize.packageType string

Cette valeur indique le type de package d’expédition utilisé pour expédier l’article d’inventaire.

Unité
packageWeightAndSize.weight.unit string

Unité de mesure utilisée pour spécifier le poids d’un colis d’expédition.

Valeur
packageWeightAndSize.weight.value number

Poids réel du colis d’expédition.

Aspects
product.aspects object

Il s’agit d’une collection de paires nom-valeur spécifiques d’élément qui fournissent plus d’informations sur le produit et peuvent faciliter la recherche des acheteurs.

Marque
product.brand string

La marque du produit.

Descriptif
product.description string

Description du produit.

Ean
product.ean array of string

Numéro d’article européen/Numéro d’article international (EAN) pour le produit.

ePID
product.epid string

Identificateur de produit eBay (ePID) du produit.

imageUrls
product.imageUrls array of string

Tableau d’un ou plusieurs liens vers des images pour le produit.

code ISBN
product.isbn array of string

Valeur du numéro de livre standard international pour le produit.

MPN
product.mpn string

Numéro de partie fabricant (MPN) d’un produit.

Sous-titre
product.subtitle string

Un sous-titre est une fonctionnalité de référencement facultative qui permet au vendeur de fournir plus d’informations sur le produit, y compris éventuellement des mots clés susceptibles d’aider à obtenir des résultats de recherche.

Titre
product.title string

Le titre d’un élément d’inventaire peut être ajouté ou modifié avec un appel createOrReplaceInventoryItem.

Upc
product.upc array of string

Valeur du numéro de livre standard international pour le produit.

videoIds
product.videoIds array of string

Tableau d’une ou plusieurs valeurs VideoId pour le produit.

Référence (SKU)
sku string

Unité Stock-Keeping définie par le vendeur (SKU) de l’élément d’inventaire. Le vendeur doit avoir une valeur de référence SKU unique pour chaque produit qu’il vend.

Mettre à jour l’offre

Cet appel met à jour une offre existante qui peut être publiée ou dans un état non publié.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’offre
offerId True string

Identificateur unique de l’offre que vous souhaitez mettre à jour.

Quantité disponible
availableQuantity integer

Quantité disponible d’inventaire pour l’achat.

ID de catégorie
categoryId string

ID de catégorie unique eBay sous lequel le produit sera répertorié.

ID de la charité
charityId string

ID unique attribué par eBay d’une organisation caritative qui recevra un pourcentage de produits de vente.

Pourcentage de dons
donationPercentage string

Pourcentage de prix d’achat que l’organisme de bienfaisance recevra pour chaque vente générée.

ID du produit producteur
producerProductId string

Identificateur unique du producteur lié à l’élément.

ID du package de produit
productPackageId string

ID unique du producteur d’emballages de produits ajouté par le vendeur.

ID du package d’expédition
shipmentPackageId string

ID unique du producteur d’un emballage utilisé par le vendeur pour expédier l’article.

ID de documentation du produit
productDocumentationId string

Identificateur unique du producteur d’un papier ajouté au colis de l’article par le vendeur.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Masquer les détails de l’acheteur
hideBuyerDetails boolean

Ce champ est inclus si le vendeur souhaite créer une description privée.

Inclure les détails du produit du catalogue
includeCatalogProductDetails boolean

Indique si les détails du catalogue de produits eBay sont appliqués à une description.

Description de la description
listingDescription string

Description de la description eBay.

Durée de la liste
listingDuration string

Nombre de jours pendant lesquels la liste sera active.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Meilleure offre activée
bestOfferEnabled boolean

Indique si la fonctionnalité Best Offer est activée ou non pour la description.

eBay Plus Si éligible
eBayPlusIfEligible boolean

Ce champ est inclus dans une offre si un vendeur Top-Rated est choisi dans le programme eBay Plus.

ID de stratégie de traitement
fulfillmentPolicyId string

L’identificateur unique indique la stratégie d’entreprise de traitement qui sera utilisée une fois qu’une offre est publiée et convertie en liste eBay.

ID de stratégie de paiement
paymentPolicyId string

L’identificateur unique indique la stratégie d’entreprise de paiement qui sera utilisée une fois qu’une offre est publiée et convertie en liste eBay.

ID de stratégie de conformité des produits
productCompliancePolicyIds array of string

Ce champ contient un tableau d’un maximum de cinq ID spécifiant les stratégies de conformité créées par le vendeur pour la description.

ID de stratégie de retour
returnPolicyId string

Retournez un ID unique de stratégie d’entreprise qui sera utilisé une fois qu’une offre est publiée et convertie en description eBay.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Priority
priority integer

La valeur entière entrée dans ce champ, ainsi que la valeur shippingServiceType, définit l’option de service d’expédition nationale ou internationale dans la stratégie de traitement sera modifiée avec les coûts d’expédition mis à jour.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Service Type
shippingServiceType string

Cette valeur indique si le service d’expédition spécifié dans le champ de priorité est une option de service d’expédition national ou international.

Reprendre l’ID de stratégie
takeBackPolicyId string

ID vendeur qui a créé une stratégie de reprise d’accès.

Date de début de la liste
listingStartDate string

Ce champ peut être utilisé si le vendeur souhaite spécifier une heure à l’avenir que la description deviendra active sur eBay.

Taille du lot
lotSize integer

Ce champ s’applique uniquement si la description est beaucoup list. La valeur entière passée dans ce champ est le nombre total d’éléments du lot.

Clé d’emplacement du marchand
merchantLocationKey string

Identificateur unique de l’emplacement d’inventaire d’un marchand

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Initialement vendu pour le prix de vente au détail on
originallySoldForRetailPriceOn string

Ce champ est nécessaire si la fonctionnalité de tarification Strikethrough sera utilisée dans l’offre. Ce champ indique que le produit a été vendu pour le prix dans le champ RetailPrice d’origine sur un site eBay, ou vendu pour ce prix par un détaillant tiers

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Visibilité des prix
pricingVisibility string

Ce champ est nécessaire si la fonctionnalité Prix annoncé minimal sera utilisée dans l’offre.

Limite de quantité par acheteur
quantityLimitPerBuyer integer

Ce champ est applicable uniquement et défini si le vendeur souhaite définir une restriction sur la quantité d’achat par vendeur.

ID de catégorie secondaire
secondaryCategoryId string

ID de catégorie secondaire unique et applicable si le vendeur décide de répertorier l’élément sous deux catégories.

Noms des catégories de magasin
storeCategoryNames array of string

Noms des catégories de magasin

Appliquer la taxe
applyTax boolean

Ce conteneur s’applique uniquement et est utilisé si une table de taxe sur les ventes, un taux d’imposition Value-Added ou un code de catégorie d’exception fiscale sera appliqué à l’offre.

Catégorie fiscale tierce
thirdPartyTaxCategory string

Code de catégorie d’exception fiscale. Si ce champ est utilisé, la taxe de vente s’applique également à un service/frais, et pas seulement au prix de l’article.

Pourcentage de TVA
vatPercentage number

Cette valeur est le taux de TVA pour l’élément, le cas échéant. Lorsqu’un pourcentage de TVA est spécifié, les informations de TVA de l’élément s’affichent sur la page Afficher l’élément de la liste.

Retours

Nom Chemin d’accès Type Description
ID de l’offre
offerId string

Identificateur unique de l’offre

Avertissements
warnings array of object

Ce conteneur retourne lorsqu’un appel est effectué, et des erreurs et/ou des avertissements se produisent.

Catégorie
warnings.category string

Cette valeur de chaîne indique la catégorie d’erreur

Domain
warnings.domain string

Nom de domaine dans lequel l’erreur ou l’avertissement s’est produit.

ID d’erreur
warnings.errorId integer

Code unique qui identifie l’erreur ou l’avertissement particulier qui s’est produit.

inputRefIds
warnings.inputRefIds array of string

Tableau d’un ou plusieurs ID de référence qui identifient le ou les éléments de requête spécifiques les plus étroitement associés à l’erreur ou à l’avertissement, le cas échéant.

Long Message
warnings.longMessage string

Description détaillée de la condition qui a provoqué l’erreur ou l’avertissement et des informations sur ce qu’il faut faire pour corriger le problème.

Message
warnings.message string

Description de la condition qui a provoqué l’erreur ou l’avertissement.

outputRefIds
warnings.outputRefIds array of string

Tableau d’un ou plusieurs ID de référence qui identifient le ou les éléments de réponse spécifiques les plus étroitement associés à l’erreur ou à l’avertissement, le cas échéant.

parameters
warnings.parameters array of object

Différents messages d’avertissement et d’erreur retournent une ou plusieurs variables qui contiennent des informations contextuelles sur l’erreur ou l’avertissement.

nom
warnings.parameters.name string

nom

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nom du sous-domaine dans lequel l’erreur ou l’avertissement s’est produit.

Obtenir des aspects d’élément pour la catégorie

Cet appel retourne une liste d’aspects appropriés ou nécessaires pour décrire avec précision les éléments de la catégorie feuille spécifiée. Chaque aspect identifie un attribut d’élément (par exemple, couleur) pour lequel le vendeur sera requis ou encouragé à fournir une valeur (ou des valeurs de variante) lors de l’offre d’un élément dans cette catégorie sur eBay.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’arborescence des catégories
category_tree_id True string

ID unique de l’arborescence de catégories eBay à partir duquel les aspects de la catégorie spécifié sont demandés.

ID de catégorie
category_id True string

Identificateur unique de catégorie feuille pour lequel les aspects sont demandés.

Retours

Nom Chemin d’accès Type Description
Aspects
aspects array of object

Liste des aspects d’élément appropriés pour décrire des éléments dans une catégorie feuille particulière

Aspect applicable à
aspects.aspectConstraint.aspectApplicableTo array of string

Cette valeur indique si l’aspect identifié par le champ aspects.localizedAspectName est un aspect produit ou un aspect élément/instance, qui est un aspect dont la valeur varie en fonction d’une instance particulière du produit.

Type de données Aspect
aspects.aspectConstraint.aspectDataType string

Type de données aspect.

Aspect activé pour les variantes
aspects.aspectConstraint.aspectEnabledForVariations boolean

La valeur true indique que cet aspect peut être utilisé pour aider à identifier les variantes d’élément.

Format d’aspect
aspects.aspectConstraint.aspectFormat string

Retourné uniquement si la valeur d’aspectDataType identifie un type de données qui nécessite une mise en forme spécifique.

Longueur maximale de l’aspect
aspects.aspectConstraint.aspectMaxLength integer

Longueur maximale de la valeur de l’élément.

Aspect Mode
aspects.aspectConstraint.aspectMode string

Manière dont les valeurs de cet aspect doivent être spécifiées par le vendeur.

Aspect requis
aspects.aspectConstraint.aspectRequired boolean

La valeur true indique que cet aspect est requis lors de l’offre d’éléments dans la catégorie spécifiée.

Utilisation des aspects
aspects.aspectConstraint.aspectUsage string

La valeur indique si l’aspect correspondant est recommandé ou facultatif.

Attendu par date
aspects.aspectConstraint.expectedRequiredByDate string

Date attendue après laquelle l’aspect sera requis.

Élément vers la cardinalité d’aspect
aspects.aspectConstraint.itemToAspectCardinality string

Indique si cet aspect peut accepter des valeurs uniques ou multiples pour les éléments de la catégorie spécifiée.

aspectValues
aspects.aspectValues array of object

Liste des valeurs valides ainsi que toutes les contraintes pour cet aspect.

localizedValue
aspects.aspectValues.localizedValue string

Valeur localisée de cet aspect.

valueConstraints
aspects.aspectValues.valueConstraints array of object

Contient une liste des dépendances qui identifient quand la valeur du champ localizedValue est disponible pour l’aspect actuel.

applicableForLocalizedAspectName
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName string

Nom de l’aspect de contrôle sur lequel dépend la valeur d’aspect actuelle.

applicableForLocalizedAspectValues
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues array of string

Contient une liste des valeurs de l’aspect du contrôle sur lequel dépend la valeur de cet aspect.

Nom de l’aspect localisé
aspects.localizedAspectName string

Nom localisé de cet aspect.

Nombre de recherches
aspects.relevanceIndicator.searchCount integer

Nombre de recherches récentes pour l’aspect.

Obtenir des emplacements d’inventaire

Cet appel récupère tous les détails définis pour chaque emplacement d’inventaire associé au compte du vendeur.

Paramètres

Nom Clé Obligatoire Type Description
Décalage
offset string

Spécifie le nombre d’emplacements à ignorer dans le jeu de résultats avant de retourner le premier emplacement.

Limit
limit string

Nombre maximal d’enregistrements à retourner par page de données.

Retours

Nom Chemin d’accès Type Description
Href
href string

URI de la page actuelle des résultats du jeu de résultats.

Limit
limit integer

Nombre d’éléments retournés sur une seule page du jeu de résultats.

Next
next string

URI pour la page de résultats suivante.

Décalage
offset string

Nombre de résultats ignorés dans le jeu de résultats avant de répertorier le premier résultat retourné.

Prev
prev string

URI de la page précédente des résultats.

Total
total integer

Nombre total d’éléments récupérés dans le jeu de résultats.

lieux
locations array of object

Tableau d’un ou plusieurs emplacements d’inventaire du marchand.

Ligne d’adresse 1
locations.location.address.addressLine1 string

Première ligne d’une adresse postale.

Ligne d’adresse 2
locations.location.address.addressLine2 string

Deuxième ligne d’une adresse postale.

Ville
locations.location.address.city string

Ville où réside l’emplacement de l’inventaire.

Pays
locations.location.address.country string

Code de pays dans lequel réside l’adresse.

Commune
locations.location.address.county string

Comté dans lequel réside l’adresse.

Code postal
locations.location.address.postalCode string

Code postal/postal de l’adresse.

État ou province
locations.location.address.stateOrProvince string

État/province où réside l’emplacement de l’inventaire.

Latitude
locations.location.geoCoordinates.latitude string

Composant Latitude de la coordonnée géographique.

Longitude
locations.location.geoCoordinates.longitude string

Composant longitude de la coordonnée géographique.

ID d’emplacement
locations.location.locationId string

ID unique attribué à eBay pour l’emplacement.

Informations supplémentaires sur l’emplacement
locations.locationAdditionalInformation string

Ce champ fournit des informations supplémentaires sur un emplacement d’inventaire.

Instructions d’emplacement
locations.locationInstructions string

Ce champ est utilisé par le commerçant pour fournir des instructions spéciales de prise en charge pour l’emplacement du magasin.

locationTypes
locations.locationTypes array of string

Ce conteneur définit la fonction de l’emplacement d’inventaire.

URL web d’emplacement
locations.locationWebUrl string

Ce champ affiche l’adresse du site web associée à l’emplacement d’inventaire.

Clé d’emplacement du marchand
locations.merchantLocationKey string

Identificateur unique de l’emplacement d’inventaire.

État de l’emplacement du marchand
locations.merchantLocationStatus string

Ce champ indique si l’emplacement d’inventaire est activé ou désactivé.

Nom
locations.name string

Nom de l’emplacement d’inventaire.

operatingHours
locations.operatingHours array of object

Ce conteneur affiche les heures d’exploitation régulières d’un emplacement de magasin pendant les jours de la semaine.

dayOfWeekEnum
locations.operatingHours.dayOfWeekEnum string

dayOfWeekEnum

Intervalles
locations.operatingHours.intervals array of object

Ce conteneur est utilisé pour définir les heures d’ouverture/fermeture d’une journée de travail d’un magasin.

close
locations.operatingHours.intervals.close string

close

ouvrir
locations.operatingHours.intervals.open string

ouvrir

Téléphone
locations.phone string

Numéro de téléphone d’un emplacement d’inventaire.

specialHours
locations.specialHours array of object

Ce conteneur affiche les heures d’exploitation spéciales d’un emplacement de magasin à une date ou à des dates spécifiques.

date
locations.specialHours.date string

date

Intervalles
locations.specialHours.intervals array of object

Ce conteneur est utilisé pour définir les heures d’ouverture et de fermeture d’un magasin à une date spécifique.

close
locations.specialHours.intervals.close string

close

ouvrir
locations.specialHours.intervals.open string

ouvrir

Obtenir des stratégies de paiement

Cette méthode récupère toutes les stratégies de paiement configurées pour la Place de marché que vous spécifiez à l’aide du paramètre de requête marketplace_id.

Paramètres

Nom Clé Obligatoire Type Description
ID de la Place de marché
marketplace_id string

ID de la Place de marché eBay des stratégies que vous souhaitez récupérer.

Retours

Nom Chemin d’accès Type Description
Href
href string

Ce champ est destiné à une utilisation ultérieure.

Limit
limit integer

Ce champ est destiné à une utilisation ultérieure.

Next
next string

Ce champ est destiné à une utilisation ultérieure.

Décalage
offset integer

Ce champ est destiné à une utilisation ultérieure.

paymentPolicies
paymentPolicies array of object

Liste des stratégies commerciales de paiement du vendeur définies pour la Place de marché spécifiée.

categoryTypes
paymentPolicies.categoryTypes array of object

Ce conteneur indique si la politique de traitement s’applique aux véhicules automobiles ou aux listes de véhicules non automobiles.

par défaut
paymentPolicies.categoryTypes.default boolean

par défaut

nom
paymentPolicies.categoryTypes.name string

nom

Monnaie
paymentPolicies.deposit.amount.currency string

Devise de base appliquée au champ valeur pour établir un montant monétaire.

Valeur
paymentPolicies.deposit.amount.value string

Montant monétaire dans la devise spécifiée.

Unité
paymentPolicies.deposit.dueIn.unit string

Ces valeurs représentent l’unité de mesure de temps, telle que DAY.

Valeur
paymentPolicies.deposit.dueIn.value integer

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

Descriptif
paymentPolicies.description string

Description définie par le vendeur de la stratégie de paiement.

Unité
paymentPolicies.fullPaymentDueIn.unit string

Unité de mesure de temps, telle que DAY.

Valeur
paymentPolicies.fullPaymentDueIn.value integer

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

Paiement immédiat
paymentPolicies.immediatePay boolean

Si ce champ est retourné comme vrai, le paiement immédiat est requis par l’acheteur

ID de la Place de marché
paymentPolicies.marketplaceId string

ID de la Place de marché eBay auquel la stratégie d’entreprise de paiement s’applique.

Nom
paymentPolicies.name string

Nom défini par le vendeur pour cette stratégie de traitement.

Instructions de paiement
paymentPolicies.paymentInstructions string

Bien que ce champ puisse être retourné pour certaines stratégies d’entreprise de paiement plus anciennes, les instructions de paiement ne sont plus prises en charge par les stratégies d’entreprise de paiement. Si ce champ est retourné, il peut être ignoré et ces instructions de paiement n’apparaissent pas dans les descriptions qui utilisent la stratégie métier correspondante.

paymentMethods
paymentPolicies.paymentMethods array of object

Ce conteneur est retourné pour afficher les modes de paiement acceptés pour la stratégie d’entreprise de paiement.

paymentMethodType
paymentPolicies.paymentMethods.paymentMethodType string

Type de mode de paiement

ID de stratégie de paiement
paymentPolicies.paymentPolicyId string

ID unique attribué par eBay pour une stratégie d’entreprise de paiement.

Prev
prev string

Ce champ est destiné à une utilisation ultérieure.

Total
total integer

Nombre total de stratégies d’entreprise de paiement récupérées dans le jeu de résultats.

Obtenir des stratégies de traitement

Cette méthode récupère toutes les stratégies de traitement configurées pour la Place de marché que vous spécifiez à l’aide du paramètre de requête marketplace_id.

Paramètres

Nom Clé Obligatoire Type Description
ID de la Place de marché
marketplace_id True string

ID de la Place de marché eBay des stratégies que vous souhaitez récupérer.

Retours

Nom Chemin d’accès Type Description
fulfillmentPolicies
fulfillmentPolicies array of object

Liste des stratégies de traitement du vendeur définies pour la Place de marché spécifiée.

Types de catégories
fulfillmentPolicies.categoryTypes array of object

Ce conteneur indique si la politique de traitement s’applique aux listes de véhicules automobiles ou non automobiles.

nom
fulfillmentPolicies.categoryTypes.name string

Type de catégorie auquel la stratégie s’applique

Descriptif
fulfillmentPolicies.description string

Description définie par le vendeur de la stratégie de traitement.

Expédition de marchandises
fulfillmentPolicies.freightShipping boolean

S’il est retourné comme vrai, le vendeur propose l’expédition de marchandises pour les gros articles de plus de 150 lb.

ID de stratégie de traitement
fulfillmentPolicies.fulfillmentPolicyId string

ID unique attribué par eBay pour la stratégie de traitement.

Expédition mondiale
fulfillmentPolicies.globalShipping boolean

S’il est retourné comme vrai, eBay’s Global Shipping Program sera utilisé par le vendeur pour expédier des articles vers des emplacements internationaux.

Unité
fulfillmentPolicies.handlingTime.unit string

Unité de mesure de temps, telle que DAY.

Valeur
fulfillmentPolicies.handlingTime.value integer

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

Enlèvement local
fulfillmentPolicies.localPickup boolean

Si la valeur est true, la prise locale est disponible pour cette stratégie.

ID de la Place de marché
fulfillmentPolicies.marketplaceId string

ID de la place de marché eBay à laquelle cette stratégie de traitement s’applique.

Nom
fulfillmentPolicies.name string

Nom défini par le vendeur pour cette stratégie de traitement. Les noms doivent être uniques pour les stratégies affectées au même marketplace.

Dépôt de prise en charge
fulfillmentPolicies.pickupDropOff boolean

Si la valeur est true, le vendeur propose l’option « Cliquer et collecter ».

shippingOptions
fulfillmentPolicies.shippingOptions array of object

Le tableau fournit des informations détaillées sur les options d’expédition nationales et internationales disponibles pour la politique.

Type de coût
fulfillmentPolicies.shippingOptions.costType string

Ce champ définit si le modèle de coût d’expédition est FLAT_RATE ou CALCULATED

Monnaie
fulfillmentPolicies.shippingOptions.insuranceFee.currency string

Devise de base appliquée au champ valeur pour établir un montant monétaire.

Valeur
fulfillmentPolicies.shippingOptions.insuranceFee.value string

Montant monétaire dans la devise spécifiée.

optionType
fulfillmentPolicies.shippingOptions.optionType string

optionType

monnaie
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency string

monnaie

value
fulfillmentPolicies.shippingOptions.packageHandlingCost.value string

value

rateTableId
fulfillmentPolicies.shippingOptions.rateTableId string

rateTableId

shippingServices
fulfillmentPolicies.shippingOptions.shippingServices array of object

shippingServices

monnaie
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency string

monnaie

value
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value string

value

buyerResponsibleForPickup
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup boolean

buyerResponsibleForPickup

buyerResponsibleForShipping
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping boolean

buyerResponsibleForShipping

monnaie
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency string

monnaie

value
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value string

value

freeShipping
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping boolean

freeShipping

shippingCarrierCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode string

shippingCarrierCode

monnaie
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency string

monnaie

value
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.value string

value

shippingServiceCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingServiceCode string

shippingServiceCode

regionExcluded
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regionExcluded

regionName
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

regionName

regionType
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType

regionIncluded
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regionIncluded

regionName
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

regionName

regionType
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType

sortOrder
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder integer

sortOrder

monnaie
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency string

monnaie

value
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value string

value

Région exclue
fulfillmentPolicies.shipToLocations.regionExcluded array of object

Tableau de valeurs regionName qui spécifient les zones vers lesquelles un vendeur n’est pas expédié.

regionName
fulfillmentPolicies.shipToLocations.regionExcluded.regionName string

regionName

regionType
fulfillmentPolicies.shipToLocations.regionExcluded.regionType string

regionType

Région incluse
fulfillmentPolicies.shipToLocations.regionIncluded array of object

Tableau de champs regionName qui spécifient les zones où un vendeur est livré.

regionName
fulfillmentPolicies.shipToLocations.regionIncluded.regionName string

regionName

regionType
fulfillmentPolicies.shipToLocations.regionIncluded.regionType string

regionType

Href
href string

Ce champ est destiné à une utilisation ultérieure.

Limit
limit integer

Ce champ est destiné à une utilisation ultérieure.

Next
next string

Ce champ est destiné à une utilisation ultérieure.

Décalage
offset integer

Ce champ est destiné à une utilisation ultérieure.

Prev
prev string

Ce champ est destiné à une utilisation ultérieure.

Total
total integer

Nombre total de stratégies de traitement récupérées dans le jeu de résultats.

Obtenir des suggestions de catégorie

Cet appel retourne un tableau de nœuds feuilles d’arbre de catégorie dans l’arborescence de catégorie spécifiée qui sont considérés par eBay pour correspondre le plus étroitement à la requête.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’arborescence des catégories
category_tree_id True string

Identificateur unique de l’arborescence des catégories eBay pour laquelle les nœuds suggérés sont demandés.

Terme de recherche
q True string

Terme de recherche qui décrit l’article en cours de vente.

Retours

Nom Chemin d’accès Type Description
categorySuggestions
categorySuggestions array of object

Contient des détails sur une ou plusieurs catégories suggérées qui correspondent aux mots clés fournis.

ID de catégorie
categorySuggestions.category.categoryId string

Identificateur unique de la catégorie eBay dans son arborescence de catégories.

Nom de catégorie
categorySuggestions.category.categoryName string

Nom de la catégorie identifiée par categoryId.

Ancêtres des nœuds d’arborescence de catégorie
categorySuggestions.categoryTreeNodeAncestors array of object

Tableau de références de catégorie ordonnée qui décrit l’emplacement de la catégorie suggérée dans l’arborescence de catégories spécifiée.

categoryId
categorySuggestions.categoryTreeNodeAncestors.categoryId string

Identificateur unique de la catégorie ancêtre eBay.

categoryName
categorySuggestions.categoryTreeNodeAncestors.categoryName string

Nom de la catégorie ancêtre identifiée par categoryId.

categorySubtreeNodeHref
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref string

Partie href de l’appel getCategorySubtree qui récupère la sous-arborescence sous le nœud de catégorie ancêtre.

categoryTreeNodeLevel
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel integer

Niveau absolu du nœud de catégorie ancêtre dans la hiérarchie de son arborescence de catégories.

Niveau du nœud d’arborescence de catégorie
categorySuggestions.categoryTreeNodeLevel integer

Niveau absolu du nœud de catégorie ancêtre dans la hiérarchie de son arborescence de catégories.

Pertinence
categorySuggestions.relevancy string

Ce champ est réservé pour une utilisation interne ou ultérieure.

ID de l’arborescence des catégories
categoryTreeId string

Identificateur unique de l’arborescence de catégorie eBay à partir de laquelle les suggestions sont retournées.

Version de l’arborescence des catégories
categoryTreeVersion string

Version de l’arborescence de catégories identifiée par categoryTreeId.

Obtenir des éléments d’inventaire

Cet appel récupère tous les enregistrements d’éléments d’inventaire définis pour le compte du vendeur.

Paramètres

Nom Clé Obligatoire Type Description
Limit
limit string

Nombre maximal d’enregistrements à retourner par page de données.

Décalage
offset string

Numéro de page à récupérer.

Retours

Nom Chemin d’accès Type Description
Href
href string

Il s’agit de l’URL de la page active des éléments d’inventaire.

inventoryItems
inventoryItems array of object

Ce conteneur est un tableau d’un ou plusieurs éléments d’inventaire.

pickupAtLocationAvailability
inventoryItems.availability.pickupAtLocationAvailability array of object

Ce conteneur se compose d’un tableau de magasins physiques de marchands où l’article d’inventaire est disponible pour la prise en magasin.

availabilityType
inventoryItems.availability.pickupAtLocationAvailability.availabilityType string

État de disponibilité de l’élément d’inventaire

unité
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit string

Unité de temps utilisée pour spécifier l’heure de traitement

value
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value integer

La valeur entière de ce champ, ainsi que l’unité de temps dans le champ d’unité, indique l’heure de traitement.

merchantLocationKey
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey string

Identificateur unique du magasin du marchand où se trouve actuellement l’élément d’inventaire In-Store enlèvement, ou à lequel il sera envoyé.

quantité
inventoryItems.availability.pickupAtLocationAvailability.quantity integer

quantité

Vente aux enchères
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction integer

Cette valeur entière indique la quantité de l’élément d’inventaire réservé aux offres de format d’enchères publiées de la référence SKU.

Prix fixe
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

Cette valeur indique la quantité de l’élément d’inventaire disponible pour les offres à prix fixe de la référence SKU.

availabilityDistributions
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions array of object

Ce conteneur est utilisé pour définir la quantité disponible de l’élément d’inventaire à un ou plusieurs emplacements d’entrepôt.

unité
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

unité

value
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

value

merchantLocationKey
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

merchantLocationKey

quantité
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity integer

quantité

Quantité
inventoryItems.availability.shipToLocationAvailability.quantity integer

Ce conteneur est utilisé pour définir la quantité totale de l’article d’inventaire qui sera disponible pour l’achat via une ou plusieurs offres publiées

Condition
inventoryItems.condition string

Cette valeur indique la condition de l’élément.

Condition Description
inventoryItems.conditionDescription string

Ce champ de chaîne est utilisé par le vendeur pour décrire plus clairement la condition des éléments

identifiants de groupe
inventoryItems.groupIds array of string

Ce tableau est retourné si l’élément d’inventaire est associé à un ou plusieurs groupes d’éléments d’inventaire.

inventoryItemGroupKeys
inventoryItems.inventoryItemGroupKeys array of string

Ce tableau est retourné si l’élément d’inventaire est associé à un ou plusieurs groupes d’éléments d’inventaire.

Paramètres régionaux
inventoryItems.locale string

Ce champ retourne le langage naturel fourni dans les valeurs de champ de la charge utile de la requête.

Hauteur
inventoryItems.packageWeightAndSize.dimensions.height number

Hauteur réelle du colis d’expédition.

Length
inventoryItems.packageWeightAndSize.dimensions.length number

Longueur réelle du colis d’expédition.

Unité
inventoryItems.packageWeightAndSize.dimensions.unit string

Unité de mesure utilisée pour spécifier les dimensions d’un colis d’expédition.

Largeur
inventoryItems.packageWeightAndSize.dimensions.width number

Largeur réelle du colis d’expédition.

Largeur
inventoryItems.packageWeightAndSize.packageType string

Type de package d’expédition utilisé pour expédier l’article d’inventaire.

Unité
inventoryItems.packageWeightAndSize.weight.unit string

Unité de mesure utilisée pour spécifier le poids d’un colis d’expédition.

Valeur
inventoryItems.packageWeightAndSize.weight.value number

Poids réel du colis d’expédition.

Aspects
inventoryItems.product.aspects object

Il s’agit d’une collection de paires nom-valeur spécifiques d’élément qui fournissent plus d’informations sur le produit et peuvent faciliter la recherche des acheteurs.

Marque
inventoryItems.product.brand string

La marque du produit. Ce champ est souvent associé au champ mpn pour identifier un produit spécifique par numéro de pièce de fabrication.

Descriptif
inventoryItems.product.description string

Description du produit.

Ean
inventoryItems.product.ean array of string

Numéro d’article européen/Numéro d’article international pour le produit.

ePID
inventoryItems.product.epid string

Identificateur de produit eBay (ePID) du produit.

imageUrls
inventoryItems.product.imageUrls array of string

Tableau d’un ou plusieurs liens vers des images pour le produit.

code ISBN
inventoryItems.product.isbn array of string

Valeur du numéro de livre standard international pour le produit.

MPN
inventoryItems.product.mpn string

Numéro de partie fabricant d’un produit.

Sous-titre
inventoryItems.product.subtitle string

Un sous-titre est une fonctionnalité de référencement facultative qui permet au vendeur de fournir plus d’informations sur le produit, y compris éventuellement des mots clés susceptibles d’aider à obtenir des résultats de recherche.

Titre
inventoryItems.product.title string

Le titre d’un élément d’inventaire peut être ajouté ou modifié

Upc
inventoryItems.product.upc array of string

Valeur du code de produit universel pour le produit.

videoIds
inventoryItems.product.videoIds array of string

Tableau d’une ou plusieurs valeurs VideoId pour le produit.

Référence (SKU)
inventoryItems.sku string

Unité Stock-Keeping définie par le vendeur de l’élément d’inventaire.

Limit
limit integer

Nombre d’éléments d’inventaire qui seront affichés sur chaque page de résultats.

Next
next string

URL de la page suivante des éléments d’inventaire.

Prev
prev string

URL de la page précédente des éléments d’inventaire.

Taille
size integer

Nombre total de pages de résultats disponibles.

Total
total integer

Nombre total d’articles d’inventaire qui existent pour le compte du vendeur.

Obtenir la stratégie de paiement

Cette méthode récupère les détails complets d’une stratégie de paiement. Indiquez l’ID de la stratégie que vous souhaitez récupérer à l’aide du paramètre de chemin d’accès paymentPolicyId.

Paramètres

Nom Clé Obligatoire Type Description
ID de stratégie de paiement
payment_policy_id True string

ID de stratégie de paiement que vous souhaitez récupérer.

Retours

Nom Chemin d’accès Type Description
categoryTypes
categoryTypes array of object

Ce conteneur indique si la politique de traitement s’applique aux véhicules automobiles ou aux listes de véhicules non automobiles.

Nom
categoryTypes.name string

Type de catégorie auquel la stratégie s’applique.

Monnaie
deposit.amount.currency string

Devise de base appliquée au champ valeur pour établir un montant monétaire.

Valeur
deposit.amount.value string

Montant monétaire dans la devise spécifiée.

Unité
deposit.dueIn.unit string

Unité de mesure de temps, telle que DAY.

Valeur
deposit.dueIn.value integer

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

Descriptif
description string

Description définie par le vendeur de la stratégie de paiement.

Unité
fullPaymentDueIn.unit string

Unité de mesure de temps, telle que DAY.

Valeur
fullPaymentDueIn.value integer

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

Paiement immédiat
immediatePay boolean

Si ce champ est retourné comme vrai, le paiement immédiat est requis par l’acheteur

ID de la Place de marché
marketplaceId string

ID de la Place de marché eBay à laquelle la stratégie d’entreprise de paiement s’applique.

Nom
name string

ID de la Place de marché eBay à laquelle la stratégie d’entreprise de paiement s’applique.

Instructions de paiement
paymentInstructions string

Bien que ce champ puisse être retourné pour certaines stratégies d’entreprise de paiement plus anciennes, les instructions de paiement ne sont plus prises en charge par les stratégies d’entreprise de paiement

paymentMethods
paymentMethods array of object

Ce conteneur est retourné pour afficher les modes de paiement acceptés pour la stratégie d’entreprise de paiement.

Type de mode de paiement
paymentMethods.paymentMethodType string

Type de mode de paiement pour la prise en charge hors connexion

ID de stratégie de paiement
paymentPolicyId string

ID unique attribué par eBay pour une stratégie d’entreprise de paiement.

Obtenir la stratégie de retour

Cette méthode récupère les détails complets de la stratégie de retour spécifiée par le paramètre de chemin returnPolicyId.

Paramètres

Nom Clé Obligatoire Type Description
ID de stratégie de retour
return_policy_id True string

Retourne l’ID de stratégie que vous souhaitez récupérer.

Retours

Nom Chemin d’accès Type Description
categoryTypes
categoryTypes array of object

Ce conteneur indique le groupe de catégories auquel la stratégie de retour s’applique.

Nom
categoryTypes.name string

Type de catégorie auquel la stratégie s’applique

Descriptif
description string

Description définie par le vendeur de la stratégie d’entreprise de retour.

Return, méthode
internationalOverride.returnMethod string

Ce champ définit/indique si le vendeur propose des articles de remplacement à l’acheteur en cas de retour international.

Unité
internationalOverride.returnPeriod.unit string

Unité de mesure de temps, telle que DAY.

Valeur
internationalOverride.returnPeriod.value integer

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

Retourne accepté
internationalOverride.returnsAccepted boolean

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

Paiement du coût d’expédition de retour
internationalOverride.returnShippingCostPayer string

Ce champ indique qui est responsable du paiement des frais d’expédition pour les articles retournés.

ID de la Place de marché
marketplaceId string

ID de la Place de marché eBay à laquelle cette stratégie d’entreprise de retour s’applique.

Nom
name string

Nom défini par le vendeur pour cette stratégie d’entreprise de paiement.

Méthode de remboursement
refundMethod string

Si un vendeur indique qu’il accepte les retours de l’acheteur, cette valeur est définie sur MONEY_BACK.

Instructions de retour
returnInstructions string

Ce champ textuel fournit plus de détails sur les instructions de retour spécifiées par le vendeur. Ce champ n’est retourné que si la stratégie d’entreprise de retour est définie.

Return, méthode
returnMethod string

Ce champ n’est retourné que si le vendeur est prêt à offrir un article de remplacement comme alternative à ' Money Back'

Unité
returnPeriod.unit string

Unité de mesure de temps, telle que DAY.

Valeur
returnPeriod.value integer

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

ID de stratégie de retour
returnPolicyId string

ID unique attribué par eBay pour une stratégie d’entreprise de retour. Cet ID est généré lors de la création de la stratégie.

Retourne accepté
returnsAccepted boolean

Si ce champ est retourné comme vrai, le vendeur accepte les retours.

Paiement du coût d’expédition de retour
returnShippingCostPayer string

Ce champ indique qui est responsable du paiement des frais d’expédition pour les articles retournés.

Obtenir la stratégie de traitement

Cette méthode récupère les détails complets d’une stratégie de traitement. Indiquez l’ID de la stratégie que vous souhaitez récupérer à l’aide du paramètre de chemin d’accès fulfillmentPolicyId.

Paramètres

Nom Clé Obligatoire Type Description
ID de stratégie de traitement
fulfillmentPolicyId True string

ID de stratégie de traitement que vous souhaitez récupérer

Retours

Nom Chemin d’accès Type Description
categoryTypes
categoryTypes array of object

Ce conteneur indique si la politique de traitement s’applique aux listes de véhicules automobiles ou aux listes de véhicules non automobiles.

Nom
categoryTypes.name string

Nom du type de catégorie auquel la stratégie s’applique.

Descriptif
description string

Description définie par le vendeur de la stratégie de traitement. Cette description est uniquement destinée à l’utilisation du vendeur et n’est exposée sur aucune page eBay.

Expédition de marchandises
freightShipping boolean

S’il est retourné comme vrai, le vendeur propose l’expédition de marchandises.

PolicyId de traitement
fulfillmentPolicyId string

ID unique attribué par eBay pour la stratégie de traitement.

Expédition mondiale
globalShipping boolean

S’il est retourné comme vrai, eBay’s Global Shipping Program sera utilisé par le vendeur pour expédier des articles vers des emplacements internationaux.

Unité
handlingTime.unit string

Un intervalle de temps est défini lorsque vous appliquez la valeur spécifiée dans le champ valeur à la valeur spécifiée pour l’unité.

Valeur
handlingTime.value integer

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

Enlèvement local
localPickup boolean

Si la valeur est true, la prise locale est disponible pour cette stratégie.

ID de la Place de marché
marketplaceId string

ID de la Place de marché eBay auquel cette stratégie de traitement s’applique.

Nom
name string

Nom unique défini par le vendeur pour cette stratégie de traitement.

Dépôt de prise en charge
pickupDropOff boolean

Si la valeur est true, le vendeur propose l’option « Cliquer et collecter ».

shippingOptions
shippingOptions array of object

Ce tableau est utilisé pour fournir des informations détaillées sur les options d’expédition nationales et internationales disponibles pour la politique.

Type de coût
shippingOptions.costType string

Ce champ définit si le modèle de coût d’expédition est FLAT_RATE ou CALCULATED

Type d’option
shippingOptions.optionType string

Ce champ est utilisé pour indiquer si les options de service d’expédition correspondantes sont nationales ou internationales.

Monnaie
shippingOptions.packageHandlingCost.currency string

Devise de base appliquée au champ valeur pour établir un montant monétaire.

Valeur
shippingOptions.packageHandlingCost.value string

Montant monétaire dans la devise spécifiée.

ID de la table de taux
shippingOptions.rateTableId string

Ce champ est utilisé si le vendeur souhaite associer une table de taux d’expédition nationale ou internationale à la stratégie d’entreprise de traitement.

shippingServices
shippingOptions.shippingServices array of object

Ce tableau se compose des options de services de transport nationaux ou internationaux définies pour la politique.

monnaie
shippingOptions.shippingServices.additionalShippingCost.currency string

monnaie

value
shippingOptions.shippingServices.additionalShippingCost.value string

value

buyerResponsibleForPickup
shippingOptions.shippingServices.buyerResponsibleForPickup boolean

Ce champ doit être inclus pour une liste de véhicules automobiles s’il incombe à l’acheteur de récupérer le véhicule automobile acheté une fois le paiement total effectué.

buyerResponsibleForShipping
shippingOptions.shippingServices.buyerResponsibleForShipping boolean

Ce champ doit être inclus pour une liste de véhicules automobiles s’il incombe à l’acheteur d’organiser l’expédition d’un véhicule automobile acheté une fois le paiement total effectué

monnaie
shippingOptions.shippingServices.cashOnDeliveryFee.currency string

monnaie

value
shippingOptions.shippingServices.cashOnDeliveryFee.value string

value

freeShipping
shippingOptions.shippingServices.freeShipping boolean

Ce champ est inclus si le vendeur offre une option d’expédition gratuite à l’acheteur.

shippingCarrierCode
shippingOptions.shippingServices.shippingCarrierCode string

Ce champ définit/indique le transporteur d’expédition.

monnaie
shippingOptions.shippingServices.shippingCost.currency string

monnaie

value
shippingOptions.shippingServices.shippingCost.value string

value

shippingServiceCode
shippingOptions.shippingServices.shippingServiceCode string

Ce champ définit/indique l’option de service d’expédition national ou international.

regionExcluded
shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regionExcluded

regionName
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

regionName

regionType
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType

regionIncluded
shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regionIncluded

regionName
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

regionName

regionType
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType

sortOrder
shippingOptions.shippingServices.sortOrder integer

La valeur entière définie dans ce champ contrôle l’ordre du service d’expédition.

regionExcluded
shipToLocations.regionExcluded array of object

Tableau de valeurs regionName qui spécifient les zones vers lesquelles un vendeur n’est pas expédié.

Nom de la région
shipToLocations.regionExcluded.regionName string

Chaîne qui indique le nom d’une région, telle que définie par eBay.

Type de région
shipToLocations.regionExcluded.regionType string

Réservé pour une utilisation ultérieure.

regionIncluded
shipToLocations.regionIncluded array of object

Tableau de champs regionName qui spécifient les zones où un vendeur est livré.

Nom de la région
shipToLocations.regionIncluded.regionName string

Chaîne qui indique le nom d’une région, telle que définie par eBay.

Type de région
shipToLocations.regionIncluded.regionType string

Réservé pour une utilisation ultérieure.

Obtenir les stratégies de condition d’élément

Cette méthode retourne les métadonnées de condition d’élément sur une, plusieurs ou toutes les catégories eBay sur une place de marché eBay.

Paramètres

Nom Clé Obligatoire Type Description
ID de la Place de marché
marketplace_id True string

ID de la Place de marché eBay pour lequel les informations de stratégie sont récupérées.

Filter
filter string

Limite la réponse en retournant des informations de stratégie uniquement pour les sections sélectionnées de l’arborescence des catégories.

Retours

Nom Chemin d’accès Type Description
itemConditionPolicies
itemConditionPolicies array of object

Liste des ID de catégorie et des stratégies permettant d’indiquer la condition d’un élément dans chacune des catégories répertoriées.

ID de catégorie
itemConditionPolicies.categoryId string

ID de catégorie auquel la stratégie de condition d’élément s’applique.

ID de l’arborescence des catégories
itemConditionPolicies.categoryTreeId string

Valeur qui indique le nœud racine de l’arborescence de catégories utilisée pour le jeu de réponses.

Condition d’élément requise
itemConditionPolicies.itemConditionRequired boolean

Cet indicateur indique si vous devez ou non répertorier la condition d’élément dans une liste pour la catégorie spécifiée.

itemConditions
itemConditionPolicies.itemConditions array of object

Valeurs de condition d’élément autorisées dans la catégorie.

conditionDescription
itemConditionPolicies.itemConditions.conditionDescription string

Étiquette lisible par l’homme pour la condition.

conditionId
itemConditionPolicies.itemConditions.conditionId string

Valeur d’ID de la condition d’élément sélectionnée.

usage
itemConditionPolicies.itemConditions.usage string

usage

Avertissements
warnings array of object

Liste d’avertissements générée à la suite de la demande.

Catégorie
warnings.category string

Type de catégorie pour cette erreur ou cet avertissement.

Domain
warnings.domain string

Nom de domaine contenant le service ou l’application.

ID d’erreur
warnings.errorId integer

Entier positif qui identifie de manière unique la condition d’erreur spécifique qui s’est produite.

inputRefIds
warnings.inputRefIds array of string

Identifie des éléments de requête spécifiques associés à l’erreur, le cas échéant. La réponse d’inputRefId est spécifique au format.

Long Message
warnings.longMessage string

Une version développée du message qui doit comporter environ 100 à 200 caractères, mais qui n’est pas nécessaire pour être telle.

Message
warnings.message string

Message indépendant de l’appareil indépendant de l’utilisateur final et de l’application pour les développeurs.

outputRefIds
warnings.outputRefIds array of string

Identifie des éléments de réponse spécifiques associés à l’erreur, le cas échéant.

parameters
warnings.parameters array of object

Différents messages d’avertissement et d’erreur retournent une ou plusieurs variables qui contiennent des informations contextuelles sur l’erreur ou l’avertissement.

nom
warnings.parameters.name string

nom

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nom du sous-système ou de la sous-division du domaine.

Obtenir les stratégies de retour

Cette méthode récupère toutes les stratégies de retour configurées pour la Place de marché que vous spécifiez à l’aide du paramètre de requête marketplace_id.

Paramètres

Nom Clé Obligatoire Type Description
ID de la Place de marché
marketplace_id True string

ID de la place de marché eBay de la stratégie que vous souhaitez récupérer.

Retours

Nom Chemin d’accès Type Description
Href
href string

Ce champ est destiné à une utilisation ultérieure.

Limit
limit integer

Ce champ est destiné à une utilisation ultérieure.

Next
next string

Ce champ est destiné à une utilisation ultérieure.

Décalage
offset integer

Ce champ est destiné à une utilisation ultérieure.

Prev
prev string

Ce champ est destiné à une utilisation ultérieure.

returnPolicies
returnPolicies array of object

Liste des stratégies métier de retour du vendeur définies pour la Place de marché spécifiée.

categoryTypes
returnPolicies.categoryTypes array of object

Ce conteneur indique le groupe de catégories auquel la stratégie de retour s’applique.

nom
returnPolicies.categoryTypes.name string

nom

Descriptif
returnPolicies.description string

Description définie par le vendeur de la stratégie d’entreprise de retour.

Return, méthode
returnPolicies.internationalOverride.returnMethod string

Ce champ définit/indique si le vendeur propose des articles de remplacement à l’acheteur en cas de retour international.

Unité
returnPolicies.internationalOverride.returnPeriod.unit string

Ces valeurs d’énumération représentent l’unité de mesure de temps, telle que DAY.

Valeur
returnPolicies.internationalOverride.returnPeriod.value integer

Unité de mesure de temps, telle que DAY.

Retourne accepté
returnPolicies.internationalOverride.returnsAccepted boolean

Si la valeur est true, le vendeur accepte les retours internationaux.

Paiement du coût d’expédition de retour
returnPolicies.internationalOverride.returnShippingCostPayer string

Ce champ indique qui est responsable du paiement des frais d’expédition pour les articles retournés.

ID de la Place de marché
returnPolicies.marketplaceId string

ID de la Place de marché eBay auquel cette stratégie d’entreprise de retour s’applique.

Nom
returnPolicies.name string

Nom défini par le vendeur pour cette stratégie d’entreprise de paiement.

Méthode de remboursement
returnPolicies.refundMethod string

Si un vendeur indique qu’il accepte les retours de l’acheteur, cette valeur est définie sur MONEY_BACK.

Instructions de retour
returnPolicies.returnInstructions string

Ce champ textuel fournit plus de détails sur les instructions de retour spécifiées par le vendeur.

Return, méthode
returnPolicies.returnMethod string

Ce champ n’est retourné que si le vendeur est prêt à offrir un article de remplacement comme alternative à « Money Back ».

Unité
returnPolicies.returnPeriod.unit string

Unité de mesure de temps, telle que DAY.

Valeur
returnPolicies.returnPeriod.value integer

Valeur de l’unité de mesure temporelle spécifiée dans le champ d’unité.

ID de stratégie de retour
returnPolicies.returnPolicyId string

ID unique attribué par eBay pour une stratégie d’entreprise de retour.

Retour accepté
returnPolicies.returnsAccepted boolean

Si ce champ est retourné comme vrai, le vendeur accepte les retours.

Paiement du coût d’expédition de retour
returnPolicies.returnShippingCostPayer string

Ce champ indique qui est responsable du paiement des frais d’expédition pour les articles retournés.

Total
total integer

Nombre total de stratégies métier de retour récupérées dans le jeu de résultats.

Obtenir l’emplacement de l’inventaire

Cet appel récupère tous les détails définis de l’emplacement d’inventaire spécifié par le paramètre de chemin d’accès merchantLocationKey.

Paramètres

Nom Clé Obligatoire Type Description
Clé d’emplacement du marchand
merchantLocationKey True string

Clé définie par un marchand unique (ID) pour un emplacement d’inventaire.

Retours

Nom Chemin d’accès Type Description
Ligne d’adresse 1
location.address.addressLine1 string

Première ligne d’une adresse postale.

Ligne d’adresse 2
location.address.addressLine2 string

Deuxième ligne d’une adresse postale.

Ville
location.address.city string

Ville où réside l’emplacement de l’inventaire.

Pays
location.address.country string

Code de pays dans lequel réside l’adresse

Commune
location.address.county string

Comté dans lequel réside l’adresse.

Code postal
location.address.postalCode string

Code postal/postal de l’adresse.

État ou province
location.address.stateOrProvince string

État/province où réside l’emplacement de l’inventaire.

Latitude
location.geoCoordinates.latitude string

Composant Latitude de la coordonnée géographique.

Longitude
location.geoCoordinates.longitude string

Composant longitude de la coordonnée géographique.

ID d’emplacement
location.locationId string

ID unique attribué à eBay pour l’emplacement.

Informations supplémentaires sur l’emplacement
locationAdditionalInformation string

Ce champ de texte fournit des informations supplémentaires sur un emplacement d’inventaire.

Instructions d’emplacement
locationInstructions string

Le champ est utilisé par le commerçant pour fournir des instructions spéciales de prise en charge pour l’emplacement du magasin.

locationTypes
locationTypes array of string

Ce conteneur définit la fonction de l’emplacement d’inventaire.

URL web d’emplacement
locationWebUrl string

Le champ affiche l’adresse du site web associée à l’emplacement d’inventaire.

Clé d’emplacement du marchand
merchantLocationKey string

Identificateur unique de l’emplacement d’inventaire.

État de l’emplacement du marchand
merchantLocationStatus string

Le champ indique si l’emplacement d’inventaire est activé ou désactivé

Nom
name string

Nom de l’emplacement d’inventaire.

operatingHours
operatingHours array of object

Ce conteneur affiche les heures d’exploitation régulières d’un emplacement de magasin pendant les jours de la semaine.

Énumération de semaine
operatingHours.dayOfWeekEnum string

Une valeur est requise pour chaque jour de la semaine où l’emplacement du magasin a des heures d’exploitation régulières.

Intervalles
operatingHours.intervals array of object

Ce conteneur est utilisé pour définir les heures d’ouverture/fermeture d’une journée de travail d’un magasin.

close
operatingHours.intervals.close string

close

ouvrir
operatingHours.intervals.open string

ouvrir

Téléphone
phone string

Numéro de téléphone d’un emplacement d’inventaire.

SpecialHours
specialHours array of object

Ce conteneur affiche les heures d’exploitation spéciales d’un emplacement de magasin à une date ou à des dates spécifiques.

Date
specialHours.date string

Une valeur de date est requise pour chaque date spécifique que l’emplacement du magasin a des heures d’exploitation spéciales.

Intervalles
specialHours.intervals array of object

Ce conteneur est utilisé pour définir les heures d’ouverture/fermeture d’un magasin à une date spécifique.

close
specialHours.intervals.close string

close

ouvrir
specialHours.intervals.open string

ouvrir

Obtenir l’TreeId de catégorie par défaut

Une place de marché eBay donnée peut utiliser plusieurs arborescences de catégories, mais l’un de ces arbres est considéré comme étant la valeur par défaut pour cette place de marché. Cet appel récupère une référence à l’arborescence de catégories par défaut associée à l’ID de place de marché eBay spécifié.

Paramètres

Nom Clé Obligatoire Type Description
ID de la Place de marché
marketplace_id True string

ID de la Place de marché eBay pour lequel l’ID d’arborescence de catégorie est demandé.

Accept-Language
Accept-Language True string

En-tête utilisé pour indiquer le langage naturel que le vendeur préfère pour la réponse.

Retours

Nom Chemin d’accès Type Description
ID de l’arborescence des catégories
categoryTreeId string

ID d’arborescence de catégorie unique eBay pour la Place de marché spécifiée.

Version de l’arborescence des catégories
categoryTreeVersion string

Version de l’arborescence de catégories identifiée par categoryTreeId.

Offre GET

Cet appel récupère une offre publiée ou non publiée spécifique.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’offre
offerId True string

Identificateur unique de l’offre à récupérer.

Retours

Nom Chemin d’accès Type Description
Quantité disponible
availableQuantity integer

Quantité de l’article d’inventaire qui sera disponible pour l’achat par les acheteurs.

ID de catégorie
categoryId string

Identificateur unique de la catégorie eBay principale sous laquelle l’élément d’inventaire est répertorié.

ID de la charité
charity.charityId string

Identificateur unique attribué par eBay de l’organisme de bienfaisance qui recevra un pourcentage des recettes de vente.

Pourcentage de dons
charity.donationPercentage string

Pourcentage de prix d’achat que l’organisme de bienfaisance recevra pour chaque vente que la description génère.

ID du produit producteur
extendedProducerResponsibility.producerProductId string

Identificateur unique du producteur lié à l’élément.

ID du package de produit
extendedProducerResponsibility.productPackageId string

ID unique du producteur de tout emballage lié au produit ajouté par le vendeur.

ID du package d’expédition
extendedProducerResponsibility.shipmentPackageId string

Identificateur unique du producteur de tout emballage utilisé par le vendeur pour expédier l’article.

ID de documentation du produit
extendedProducerResponsibility.productDocumentationId string

Identificateur unique du producteur d’un papier ajouté au colis de l’article par le vendeur.

Monnaie
extendedProducerResponsibility.ecoParticipationFee.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
extendedProducerResponsibility.ecoParticipationFee.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Format
format string

Format de référencement de l’offre

Masquer les détails de l’acheteur
hideBuyerDetails boolean

Ce champ est retourné comme true si la fonctionnalité de référencement privé a été activée pour l’offre.

Inclure les détails du produit du catalogue
includeCatalogProductDetails boolean

Ce champ indique si les détails du catalogue de produits eBay sont appliqués à une description.

ID de liste
listing.listingId string

Identificateur unique de la description eBay associée à l’offre publiée.

État de la liste
listing.listingStatus string

État de liste associé à l’offre publiée.

Quantité vendue
listing.soldQuantity integer

Quantité de produits vendus pour l’offre publiée.

Description de la description
listingDescription string

Description de la description d’eBay

Durée de la liste
listingDuration string

Ce champ indique le nombre de jours pendant lesquels la liste sera active.

Monnaie
listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
listingPolicies.bestOfferTerms.autoAcceptPrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
listingPolicies.bestOfferTerms.autoDeclinePrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Meilleure offre activée
listingPolicies.bestOfferTerms.bestOfferEnabled boolean

Ce conteneur est utilisé si le vendeur souhaite prendre en charge la fonctionnalité Best Offer sur son référencement.

eBay Plus Si éligible
listingPolicies.eBayPlusIfEligible boolean

Ce champ est inclus dans une offre si un vendeur Top-Rated est choisi dans le programme eBay Plus.

ID de stratégie de traitement
listingPolicies.fulfillmentPolicyId string

L’identificateur unique indique la stratégie d’entreprise de traitement qui sera utilisée une fois qu’une offre est publiée et convertie en liste eBay.

ID de stratégie de paiement
listingPolicies.paymentPolicyId string

L’identificateur unique indique la stratégie d’entreprise de paiement qui sera utilisée une fois qu’une offre est publiée et convertie en liste eBay.

productCompliancePolicyIds
listingPolicies.productCompliancePolicyIds array of string

Ce champ contient un tableau d’un maximum de cinq ID spécifiant les stratégies de conformité créées par le vendeur pour la description.

ID de stratégie de retour
listingPolicies.returnPolicyId string

L’identificateur unique indique la stratégie d’entreprise de retour qui sera utilisée une fois qu’une offre est publiée et convertie en description eBay.

shippingCostOverrides
listingPolicies.shippingCostOverrides array of object

Ce conteneur est utilisé si le vendeur souhaite remplacer les coûts d’expédition pour une ou plusieurs options de service d’expédition nationaux ou internationaux définies dans la stratégie de référencement de traitement.

Monnaie
listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
listingPolicies.shippingCostOverrides.additionalShippingCost.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Priority
listingPolicies.shippingCostOverrides.priority integer

La valeur entière entrée dans ce champ, ainsi que la valeur shippingServiceType, définit l’option de service d’expédition nationale ou internationale dans la stratégie de traitement sera modifiée avec les coûts d’expédition mis à jour.

Monnaie
listingPolicies.shippingCostOverrides.shippingCost.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
listingPolicies.shippingCostOverrides.shippingCost.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Type de service d’expédition
listingPolicies.shippingCostOverrides.shippingServiceType string

Cette valeur indique si le service d’expédition est une option de service d’expédition national ou international.

Reprendre l’ID de stratégie
listingPolicies.takeBackPolicyId string

L’ID vendeur a créé une stratégie de reprise.

Date de début de la liste
listingStartDate string

Cet horodatage est la date/heure définie par le vendeur pour la description planifiée.

Taille du lot
lotSize integer

Ce champ s’applique uniquement si la description est beaucoup list. Une liste de lot est une liste qui a plusieurs quantités du même produit.

ID de la Place de marché
marketplaceId string

Identificateur unique du site eBay sur lequel l’offre est disponible ou sera mis à disposition.

Clé d’emplacement du marchand
merchantLocationKey string

Identificateur unique de l’emplacement d’inventaire.

ID de l’offre
offerId string

Identificateur unique de l’offre.

Monnaie
pricingSummary.auctionReservePrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
pricingSummary.auctionReservePrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
pricingSummary.auctionStartPrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
pricingSummary.auctionStartPrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
pricingSummary.minimumAdvertisedPrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
pricingSummary.minimumAdvertisedPrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Initialement vendu pour le prix de vente au détail on
pricingSummary.originallySoldForRetailPriceOn string

Ce champ est nécessaire si la fonctionnalité de tarification Strikethrough sera utilisée dans l’offre. Ce champ indique que le produit a été vendu pour le prix dans le champ RetailPrice d’origine sur un site eBay, ou vendu pour ce prix par un détaillant tiers.

Monnaie
pricingSummary.originalRetailPrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
pricingSummary.originalRetailPrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
pricingSummary.price.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
pricingSummary.price.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Visibilité des prix
pricingSummary.pricingVisibility string

Ce champ est nécessaire si la fonctionnalité Prix annoncé minimal sera utilisée dans l’offre.

Limite de quantité par acheteur
quantityLimitPerBuyer integer

Ce champ s’applique uniquement si le vendeur souhaite définir une restriction sur la quantité d’achat d’un article d’inventaire par vendeur.

ID de catégorie secondaire
secondaryCategoryId string

Identificateur unique pour une catégorie secondaire et applicable si le vendeur décide de répertorier l’élément sous deux catégories.

Référence (SKU)
sku string

Valeur de référence SKU définie par le vendeur du produit dans l’offre.

Statut
status string

La valeur spécifie l’état de l’offre.

Noms des catégories de magasin
storeCategoryNames array of string

Nom de la catégorie de magasin

Appliquer la taxe
tax.applyTax boolean

Ce champ sera inclus si le vendeur souhaite référencer sa taxe de vente au niveau du compte

Catégorie fiscale tierce
tax.thirdPartyTaxCategory string

Code de catégorie d’exception fiscale. Si ce champ est utilisé, la taxe de vente s’applique également à un service/frais, et pas seulement au prix de l’article.

Pourcentage de TVA
tax.vatPercentage number

Cette valeur est le taux de TVA pour l’élément, le cas échéant. Lorsqu’un pourcentage de TVA est spécifié, les informations de TVA de l’élément s’affichent sur la page Afficher l’élément de la liste.

Offres GET

Cet appel récupère toutes les offres existantes pour la valeur de référence SKU spécifiée. Le vendeur a la possibilité de limiter les offres récupérées à une place de marché eBay spécifique ou à un format de référencement.

Paramètres

Nom Clé Obligatoire Type Description
Référence (SKU)
sku True string

Valeur de référence SKU définie par le vendeur

ID de la Place de marché
marketplace_id string

Identificateur unique de la Place de marché eBay.

Format
format string

Format de référencement de l’offre.

Limit
limit string

Nombre maximal d’enregistrements à retourner par page de données.

Décalage
offset string

Numéro de page à récupérer.

Retours

Nom Chemin d’accès Type Description
Href
href string

URL de la page active des offres.

Limit
limit integer

Nombre d’offres qui seront affichées sur chaque page de résultats.

Next
next string

URL de la page suivante des offres.

offers
offers array of object

Ce conteneur est un tableau d’une ou plusieurs offres de vendeur pour la valeur de la référence SKU.

Quantité disponible
offers.availableQuantity integer

Quantité d’articles d’inventaire qui seront disponibles pour l’achat.

ID de catégorie
offers.categoryId string

ID unique de catégorie eBay sous lequel l’élément d’inventaire est répertorié.

ID de la charité
offers.charity.charityId string

Identificateur unique attribué par eBay à l’organisme de bienfaisance qui recevra un pourcentage des recettes de vente.

Pourcentage de dons
offers.charity.donationPercentage string

Pourcentage de prix d’achat que l’organisme de bienfaisance recevra pour chaque vente.

ID du produit producteur
offers.extendedProducerResponsibility.producerProductId string

Identificateur unique du producteur lié à l’élément.

ID du package de produit
offers.extendedProducerResponsibility.productPackageId string

ID unique du produit empaqueté ajouté par le vendeur.

ID du package d’expédition
offers.extendedProducerResponsibility.shipmentPackageId string

Identificateur unique du producteur de tout emballage utilisé par le vendeur pour expédier l’article.

ID de documentation du produit
offers.extendedProducerResponsibility.productDocumentationId string

Identificateur unique du producteur d’un papier ajouté au colis de l’article par le vendeur.

Monnaie
offers.extendedProducerResponsibility.ecoParticipationFee.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
offers.extendedProducerResponsibility.ecoParticipationFee.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Format
offers.format string

Cette valeur définit le format de référencement de l’offre

Masquer les détails de l’acheteur
offers.hideBuyerDetails boolean

Ce champ est retourné comme true si la fonctionnalité de référencement privé a été activée pour l’offre.

Inclure les détails du produit du catalogue
offers.includeCatalogProductDetails boolean

Ce champ indique si les détails du catalogue de produits eBay sont appliqués à une description.

ID de liste
offers.listing.listingId string

Identificateur unique de la description eBay associée à l’offre publiée.

État de la liste
offers.listing.listingStatus string

État de liste associé à l’offre publiée.

Quantité vendue
offers.listing.soldQuantity integer

Quantité de produit qui a été vendue pour l’offre publiée.

Description de la description
offers.listingDescription string

Description de la description de la description eBay.

Durée de la liste
offers.listingDuration string

Indique le nombre de jours pendant lesquels la liste sera active.

Monnaie
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Meilleure offre activée
offers.listingPolicies.bestOfferTerms.bestOfferEnabled boolean

Ce champ indique si la fonctionnalité Best Offer est activée ou non pour la description.

eBay Plus Si éligible
offers.listingPolicies.eBayPlusIfEligible boolean

Ce champ est inclus dans une offre et défini sur true si un vendeur Top-Rated est choisi dans le programme eBay Plus

ID de stratégie de traitement
offers.listingPolicies.fulfillmentPolicyId string

L’identificateur unique indique la stratégie d’entreprise de traitement qui sera utilisée une fois qu’une offre est publiée et convertie en liste eBay.

ID de stratégie de paiement
offers.listingPolicies.paymentPolicyId string

L’identificateur unique indique la stratégie d’entreprise de paiement qui sera utilisée une fois qu’une offre est publiée et convertie en liste eBay.

productCompliancePolicyIds
offers.listingPolicies.productCompliancePolicyIds array of string

Ce champ contient un tableau d’un maximum de cinq ID spécifiant les stratégies de conformité créées par le vendeur pour la description.

ID de stratégie de retour
offers.listingPolicies.returnPolicyId string

L’identificateur unique indique la stratégie d’entreprise de retour qui sera utilisée une fois qu’une offre est publiée et convertie en description eBay.

shippingCostOverrides
offers.listingPolicies.shippingCostOverrides array of object

Ce conteneur est utilisé si le vendeur souhaite remplacer les frais d’expédition ou la surcharge pour une ou plusieurs options de service d’expédition nationaux ou internationaux définies dans la politique de référencement de traitement.

monnaie
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

monnaie

value
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value string

value

priority
offers.listingPolicies.shippingCostOverrides.priority integer

priority

monnaie
offers.listingPolicies.shippingCostOverrides.shippingCost.currency string

monnaie

value
offers.listingPolicies.shippingCostOverrides.shippingCost.value string

value

shippingServiceType
offers.listingPolicies.shippingCostOverrides.shippingServiceType string

shippingServiceType

Reprendre l’ID de stratégie
offers.listingPolicies.takeBackPolicyId string

ID vendeur qui a créé une stratégie de reprise d’accès.

Date de début de la liste
offers.listingStartDate string

Date/heure définie par le vendeur pour la description planifiée.

Taille du lot
offers.lotSize integer

Ce champ est applicable uniquement et retourné si la description est beaucoup list.

ID de la Place de marché
offers.marketplaceId string

Identificateur unique du site eBay sur lequel l’offre est disponible ou sera mis à disposition.

Clé d’emplacement du marchand
offers.merchantLocationKey string

Identificateur unique de l’emplacement d’inventaire.

ID de l’offre
offers.offerId string

Identificateur unique de l’offre.

Monnaie
offers.pricingSummary.auctionReservePrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
offers.pricingSummary.auctionReservePrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
offers.pricingSummary.auctionStartPrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
offers.pricingSummary.auctionStartPrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
offers.pricingSummary.minimumAdvertisedPrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
offers.pricingSummary.minimumAdvertisedPrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Initialement vendu pour le prix de vente au détail on
offers.pricingSummary.originallySoldForRetailPriceOn string

Ce champ est nécessaire si la fonctionnalité de tarification Strikethrough sera utilisée dans l’offre. Ce champ indique que le produit a été vendu pour le prix dans le champ RetailPrice d’origine sur un site eBay, ou vendu pour ce prix par un détaillant tiers.

Monnaie
offers.pricingSummary.originalRetailPrice.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
offers.pricingSummary.originalRetailPrice.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Monnaie
offers.pricingSummary.price.currency string

Valeur de chaîne à trois chiffres représentant le type monétaire.

Valeur
offers.pricingSummary.price.value string

Représentation sous forme de chaîne d’une valeur dollar exprimée dans le champ monétaire.

Visibilité des prix
offers.pricingSummary.pricingVisibility string

Ce champ est nécessaire si la fonctionnalité Prix annoncé minimal sera utilisée dans l’offre.

Limite de quantité par acheteur
offers.quantityLimitPerBuyer integer

Ce champ est applicable uniquement et défini si le vendeur souhaite définir une restriction sur la quantité d’achat d’un élément d’inventaire par vendeur.

ID de catégorie secondaire
offers.secondaryCategoryId string

Identificateur unique pour une catégorie secondaire.

Référence (SKU)
offers.sku string

Valeur de référence SKU définie par le vendeur du produit dans l’offre.

Statut
offers.status string

La valeur spécifie l’état de l’offre.

storeCategoryNames
offers.storeCategoryNames array of string

Ce conteneur est retourné si le vendeur a choisi de placer l’article d’inventaire dans une ou deux catégories de magasin eBay que le vendeur a configurés pour son magasin eBay

Appliquer la taxe
offers.tax.applyTax boolean

Ce champ sera inclus si le vendeur souhaite référencer son tableau des taxes de vente au niveau du compte pour calculer la taxe de vente pour une commande.

Catégorie fiscale tierce
offers.tax.thirdPartyTaxCategory string

Code de catégorie d’exception fiscale.

Pourcentage de TVA
offers.tax.vatPercentage number

Valeur de taxe sur la valeur ajoutée (TVA) de l’élément, le cas échéant.

Prev
prev string

URL de la page précédente des offres.

Taille
size integer

Nombre d’offres affichées sur la page actuelle des résultats.

Total
total integer

Nombre total d’offres qui existent pour la valeur de référence SKU spécifiée.

Publier une offre

Cet appel est utilisé pour convertir une offre non publiée en offre publiée ou en annonce eBay en direct. L’identificateur unique de l’offre (offerId) est transmis à la fin de l’URI d’appel.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’offre
offerId True string

Identificateur unique de l’offre à publier.

Retours

Nom Chemin d’accès Type Description
ID de liste
listingId string

Identificateur unique de la description eBay nouvellement créée.

Avertissements
warnings array of object

Ce conteneur est retourné s’il y a eu un ou plusieurs avertissements associés à la tentative de retrait de l’offre.

Catégorie
warnings.category string

Cette valeur de chaîne indique la catégorie d’erreur.

Domain
warnings.domain string

Nom du domaine dans lequel l’erreur ou l’avertissement s’est produit.

ID d’erreur
warnings.errorId integer

Code unique qui identifie l’erreur ou l’avertissement particulier qui s’est produit.

inputRefIds
warnings.inputRefIds array of string

Tableau d’un ou plusieurs ID de référence qui identifient le ou les éléments de requête spécifiques les plus étroitement associés à l’erreur ou à l’avertissement, le cas échéant.

Long Message
warnings.longMessage string

Description détaillée de la condition qui a provoqué l’erreur ou l’avertissement et des informations sur ce qu’il faut faire pour corriger le problème.

Message
warnings.message string

Description de la condition qui a provoqué l’erreur ou l’avertissement.

outputRefIds
warnings.outputRefIds array of string

Tableau d’un ou plusieurs ID de référence qui identifient le ou les éléments de réponse spécifiques les plus étroitement associés à l’erreur ou à l’avertissement, le cas échéant.

parameters
warnings.parameters array of object

Différents messages d’avertissement et d’erreur retournent une ou plusieurs variables qui contiennent des informations contextuelles sur l’erreur ou l’avertissement.

nom
warnings.parameters.name string

nom

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nom du sous-domaine dans lequel l’erreur ou l’avertissement s’est produit.

Retirer l’offre

Cet appel est utilisé pour mettre fin à une liste à variante unique associée à l’offre spécifiée.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’offre
offerId True string

Identificateur unique de l’offre à retirer.

Retours

Nom Chemin d’accès Type Description
ID de liste
listingId string

Identificateur unique de la description eBay associée à l’offre qui a été retirée.

Avertissements
warnings array of object

Ce conteneur est retourné s’il y a eu un ou plusieurs avertissements associés à la tentative de retrait de l’offre.

Catégorie
warnings.category string

Cette valeur de chaîne indique la catégorie d’erreur

Domain
warnings.domain string

Cette valeur de chaîne indique la catégorie d’erreur

ID d’erreur
warnings.errorId integer

Code unique qui identifie l’erreur ou l’avertissement particulier qui s’est produit.

inputRefIds
warnings.inputRefIds array of string

Tableau d’un ou plusieurs ID de référence qui identifient le ou les éléments de requête spécifiques les plus étroitement associés à l’erreur ou à l’avertissement, le cas échéant.

Long Message
warnings.longMessage string

Description détaillée de la condition qui a provoqué l’erreur ou l’avertissement et des informations sur ce qu’il faut faire pour corriger le problème.

Message
warnings.message string

Description de la condition qui a provoqué l’erreur ou l’avertissement.

outputRefIds
warnings.outputRefIds array of string

Ce conteneur est retourné s’il y a eu un ou plusieurs avertissements associés à la tentative de retrait de l’offre.

parameters
warnings.parameters array of object

Différents messages d’avertissement et d’erreur retournent une ou plusieurs variables qui contiennent des informations contextuelles sur l’erreur ou la waring.

nom
warnings.parameters.name string

nom

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nom du sous-domaine dans lequel l’erreur ou l’avertissement s’est produit.

Supprimer l’offre

Cet appel supprime définitivement l’offre

Paramètres

Nom Clé Obligatoire Type Description
ID de l’offre
offerId True string

Identificateur unique de l’offre à supprimer.

Retours

response
string

Définitions

ficelle

Il s’agit du type de données de base « string ».