Partager via


Etsy (Éditeur indépendant)

Ce connecteur utilise votre clé API pour accéder à différentes fonctionnalités de Etsy.com. Il prend en charge les actions pour l’inventaire, les commandes commerciales et la gestion des magasins. Toutes les actions sont basées sur l’API Etsy Open v3 qui a des points de terminaison qui sont toujours en version bêta. Si des actions utilisent l’API bêta, l’action avec inclure bêta dans le titre et retourne un code de réponse 501.

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 Troy Taylor
URL https://www.hitachisolutions.com
Messagerie électronique ttaylor@hitachisolutions.com
Métadonnées du connecteur
Éditeur Troy Taylor, Hitachi Solutions
Site internet https://www.etsy.com/
Politique de confidentialité https://www.etsy.com/legal/privacy/
Catégories Commerce

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
Clé API securestring Clé API pour cette API Vrai

Limitations

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

Actions

Charger un fichier de référencement

Charge un nouveau fichier pour une description numérique ou associe un fichier existant à une description spécifique. Vous devez fournir l’ID de fichier de référencement d’un fichier existant, ou les données de nom et de fichier binaire pour qu’un fichier soit chargé. L’association d’un fichier existant à une liste physique convertit la liste physique en liste numérique, ce qui supprime tous les coûts d’expédition et toutes les variations de produit et d’inventaire.

Charger une image de référencement

Charge ou affecte une image à une description identifiée par un ID de magasin avec un ID de référencement. Pour charger une nouvelle image, définissez le fichier image comme valeur pour le paramètre d’image. Vous pouvez affecter une image précédemment supprimée à une description à l’aide de l’ID d’image supprimé dans le paramètre d’ID d’image de liste. Lorsqu’une requête contient des valeurs de paramètre d’ID d’image et de liste, le point de terminaison charge l’image uniquement dans le paramètre d’image.

Créer un brouillon de liste

Crée un brouillon physique de produit de référencement dans un magasin sur le canal Etsy.

Créer un profil d’expédition

Crée un profil d’expédition. Vous pouvez passer un code ISO de pays ou une région lors de la création d’un profil d’expédition, mais pas les deux. Une seule est requise. Vous devez passer un ID de transporteur d’expédition et une classe de courrier, ou les jours de livraison min et max.

Créer un reçu d’expédition

Envoie les informations de suivi d’un reçu de magasin, ce qui crée une entrée de reçu de magasin pour l’ID de reçu donné. Chaque fois que vous envoyez des informations de suivi, Etsy envoie un e-mail de notification à l’utilisateur acheteur. Lorsque l’envoi de cci est vrai, Etsy envoie également des notifications d’expédition au vendeur. Lorsque le code de suivi et le nom du transporteur ne sont pas envoyés, le reçu est marqué comme étant expédié uniquement.

Créer une destination de profil d’expédition

Crée une destination d’expédition qui définit le coût d’expédition, le transporteur et la classe d’une destination dans un profil d’expédition. Cela affecte des coûts à l’aide de la devise de la boutique associée. Définissez la destination à l’aide de l’ISO ou de la région de destination du pays de destination ; l’ISO du pays de destination et la région de destination s’excluent mutuellement : définissez l’un ou l’autre. La définition des deux déclencheurs génère l’erreur 400. Si la requête ne définit ni l’ISO du pays de destination ni la région de destination, la destination par défaut est partout. Vous devez également affecter à la fois un ID de transporteur d’expédition et une classe de courrier ou des jours de livraison min et des jours de livraison maximum.

Créer une mise à niveau de profil d’expédition

Crée une mise à niveau de profil d’expédition, qui peut établir un prix pour une option d’expédition, telle qu’un autre transporteur ou une livraison plus rapide.

Créer une section de magasin

Crée une section dans un magasin spécifique.

Créer une traduction de référencement

Crée une traduction de liste en listant l’ID et la langue.

Magasins de recherche

Retourne une liste de magasins portant le nom correspondant.

Mettre à jour les images de variante d’une liste

Crée des images de variantes sur une liste.

Mettre à jour l’inventaire d’une liste

Met à jour l’inventaire d’une liste identifiée par un ID de liste. La mise à jour échoue si les valeurs fournies pour la référence SKU du produit, l’offre de quantité et/ou le prix sont incompatibles avec les valeurs dans les champs de propriété. Lors de la définition d’un prix, affectez un float égal à un montant divisé par diviseur tel que spécifié dans la ressource monétaire.

Mettre à jour un magasin

Mettez à jour un magasin. Suppose que tous les paramètres de chaîne sont fournis dans la langue principale de la boutique.

Mettre à jour un profil d’expédition

Modifie les paramètres d’un profil d’expédition.

Mettre à jour une destination de profil d’expédition

Met à jour une destination d’expédition existante, qui peut définir ou réaffecter le coût d’expédition, le transporteur et la classe d’une destination.

Mettre à jour une liste

Met à jour une description, identifiée par un ID de référencement, pour un magasin spécifique identifié par un ID de magasin.

Mettre à jour une mise à niveau d’un profil d’expédition

Met à jour une mise à niveau d’un profil d’expédition et met à jour les listes qui utilisent le profil d’expédition.

Mettre à jour une propriété de référencement

Met à jour ou remplit la liste des propriétés définissant les offres de produits pour une description. Chaque offre nécessite à la fois une valeur et un ID de valeur valides pour un ID d’échelle affecté à la description ou que vous affectez à la description avec cette demande.

Mettre à jour une traduction de référencement

Met à jour une traduction de liste en listant l’ID et la langue.

Obtenir des adresses utilisateur

Récupérez une liste d’adresses utilisateur.

Obtenir des annonces actives par magasin

Récupère une liste de toutes les annonces actives sur Etsy dans un magasin spécifique, paginé par date de création de liste.

Obtenir des annonces par boutique

Retourne les annonces qui appartiennent à un magasin. Les listings peuvent être filtrés à l’aide du paramètre d’état.

Obtenir des annonces par reçu de la boutique

Obtient toutes les listes associées à un reçu.

Obtenir des annonces proposées par magasin

Récupère les annonces associées à un magasin qui sont proposés.

Obtenir des avis

Récupère les avis d’un magasin en fonction de son ID.

Obtenir des descriptions par ID

Permet d’interroger plusieurs ID de liste à la fois. Limitez 100 ID maximum par requête.

Obtenir des descriptions par ID de section boutique

Récupère toutes les descriptions de la section d’un magasin spécifique.

Obtenir des destinations de profil par profil d’expédition

Récupère une liste d’objets de destination d’expédition associés à un profil d’expédition.

Obtenir des listes actives

Liste de toutes les listes actives sur Etsy paginés par leur date de création. Sans liste d’ordre de tri, les annonces seront retournées la plus récente par défaut.

Obtenir des mises à niveau de profil d’expédition

Récupère la liste des mises à niveau de profil d’expédition affectées à un profil d’expédition spécifique.

Obtenir des nœuds de taxonomie vendeur

Récupère l’arborescence de hiérarchie complète des nœuds de taxonomie vendeur.

Obtenir des profils d’expédition

Récupère une liste de profils d’expédition disponibles dans la boutique Etsy spécifique identifiée par son ID de magasin.

Obtenir des reçus

Demande les reçus d’un magasin spécifique, non filtrés ou filtrés par plage d’ID de reçu, décalage, date, paiement et/ou achats expédiés.

Obtenir des sections de magasin

Récupère la liste des sections de magasin dans un magasin spécifique identifié par ID de magasin.

Obtenir des transporteurs d’expédition

Récupère une liste des transporteurs d’expédition disponibles et les classes de courrier associées pour un pays donné.

Obtenir la liste des paiements

Récupère la liste des paiements d’un magasin identifié par ID de magasin. Vous pouvez également filtrer les résultats à l’aide d’une liste d’ID de paiement.

Obtenir la propriété d’une description (bêta)

Récupère la propriété d’une description. Le développement pour ce point de terminaison est en cours. Elle retourne uniquement une réponse 501.

Obtenir la traduction d’une description

Retourne la traduction d’une liste dans la langue donnée.

Obtenir la transaction d’un magasin

Récupère la liste des transactions associées à un magasin.

Obtenir la transaction d’un reçu

Récupère la liste des transactions associées à un reçu spécifique.

Obtenir le produit d’une description

Récupérez un produit de référencement par ID.

Obtenir les entrées d’un compte de paiement d’un magasin

Récupérez les entrées du registre du compte de paiement d’un magasin.

Obtenir les images de variantes de la liste

Obtient toutes les images de variante sur une liste.

Obtenir les images d’une description

Récupère toutes les ressources d’image de référencement pour une description avec un ID de référencement spécifique.

Obtenir les propriétés du produit par ID de taxonomie

Récupère une liste de propriétés de produit, avec des échelles et des valeurs applicables, prises en charge pour un ID de taxonomie vendeur spécifique.

Obtenir les propriétés d’une liste

Retourne une liste des propriétés d’une liste.

Obtenir l’achat par ID de propriétaire

Récupère l’atelier identifié par l’ID d’utilisateur du propriétaire du magasin.

Obtenir l’adresse de l’utilisateur

Récupère l’adresse de l’utilisateur. Le développement pour ce point de terminaison est en cours. Elle retourne uniquement une réponse 501.

Obtenir l’inventaire d’une liste

Récupère l’enregistrement d’inventaire d’une description. Les listings que vous n’avez pas modifiés à l’aide des outils d’inventaire Etsy.com n’ont pas d’enregistrements d’inventaire. Ce point de terminaison retourne des données de référence SKU si vous êtes le propriétaire des enregistrements d’inventaire récupérés.

Obtenir l’offre d’une annonce

Obtenez une offre pour une liste.

Obtenir tous les fichiers de référencement

Récupère tous les fichiers associés à la liste numérique donnée. La demande de fichiers à partir d’une liste physique retourne un résultat vide.

Obtenir un fichier à partir d’une liste

Récupère un seul fichier associé à la liste numérique donnée. La demande d’un fichier à partir d’une liste physique retourne un résultat vide.

Obtenir un paiement à partir d’un ID d’entrée de registre de compte de paiement

Obtenez un paiement à partir d’un ID d’entrée de registre de compte de paiement, le cas échéant.

Obtenir un paiement à partir d’un reçu spécifique

Récupère un paiement à partir d’un reçu spécifique, identifié par ID de reçu, à partir d’un magasin spécifique, identifié par ID de magasin.

Obtenir un profil d’expédition

Récupère un profil d’expédition référencé par l’ID de profil d’expédition.

Obtenir un reçu

Récupère un reçu, identifié par un ID de reçu, à partir d’un magasin Etsy.

Obtenir un utilisateur

Retourne le profil utilisateur pour l’utilisateur identifié par un ID d’utilisateur.

Obtenir une image de référencement

Récupère les références et métadonnées d’une image de liste avec un ID d’image spécifique.

Obtenir une liste

Récupère un enregistrement de référencement par ID de liste.

Obtenir une transaction

Récupère une transaction par ID de transaction.

Ping

Vérifiez la connectivité à l’API Etsy avec une application.

Récupérer les transactions d’une liste

Récupère la liste des transactions associées à une liste.

Section Obtenir un magasin

Récupère une section de magasin, référencée par ID de section et ID de magasin.

Supprimer un fichier de la liste

Lorsque vous supprimez le fichier final d’une description numérique, la liste est convertie en liste physique. La réponse à une demande de suppression retourne une liste des enregistrements de fichiers restants associés à la liste donnée.

Supprimer un profil d’expédition

Supprime un profil d’expédition par ID donné.

Supprimer une destination de profil d’expédition

Supprime une destination d’expédition et supprime l’option de destination de chaque description qui utilise le profil d’expédition associé. Un profil d’expédition nécessite au moins une destination d’expédition. Ce point de terminaison ne peut donc pas supprimer la destination finale de l’expédition pour tout profil d’expédition. Pour supprimer la destination d’expédition finale d’un profil d’expédition, vous devez supprimer l’intégralité du profil d’expédition.

Supprimer une image de référencement

Supprime une image de référencement. Une copie du fichier reste sur nos serveurs, et une image supprimée peut donc être re-associée à la liste sans recharger l’image d’origine.

Supprimer une liste

Cette action supprime une description des magasins. Une liste ne peut être supprimée que si l’état est l’un des éléments suivants : SOLD_OUT, DRAFT, EXPIRÉ, INACTIF, ACTIF et is_available ou ACTIVE et a des indicateurs vendeurs : SUPRESSED (figé), VACATION, CUSTOM_SHOPS (modèle), SELL_ON_FACEBOOK

Supprimer une mise à niveau du profil d’expédition

Supprime une mise à niveau du profil d’expédition et supprime l’option de mise à niveau de chaque description qui utilise le profil d’expédition associé.

Supprimer une propriété de référencement

Supprime une propriété d’une liste.

Charger un fichier de référencement

Charge un nouveau fichier pour une description numérique ou associe un fichier existant à une description spécifique. Vous devez fournir l’ID de fichier de référencement d’un fichier existant, ou les données de nom et de fichier binaire pour qu’un fichier soit chargé. L’association d’un fichier existant à une liste physique convertit la liste physique en liste numérique, ce qui supprime tous les coûts d’expédition et toutes les variations de produit et d’inventaire.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

ID de fichier de liste
listing_file_id integer

ID numérique unique d’un fichier associé à une liste numérique.

Fichier
file True string

Fichier binaire à charger.

Nom
name string

Chaîne de nom de fichier d’un fichier à charger

Classement
rank integer

Position numérique positive non nulle dans les images affichées dans une liste, avec les images de rang 1 apparaissant dans la position la plus à gauche d’une liste.

Retours

Fichier associé à une liste numérique.

ShopListingFile
ShopListingFile

Charger une image de référencement

Charge ou affecte une image à une description identifiée par un ID de magasin avec un ID de référencement. Pour charger une nouvelle image, définissez le fichier image comme valeur pour le paramètre d’image. Vous pouvez affecter une image précédemment supprimée à une description à l’aide de l’ID d’image supprimé dans le paramètre d’ID d’image de liste. Lorsqu’une requête contient des valeurs de paramètre d’ID d’image et de liste, le point de terminaison charge l’image uniquement dans le paramètre d’image.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Image
image string

Chaîne de nom de fichier d’un fichier à charger.

ID d’image de liste
listing_image_id integer

ID numérique de l’image de liste principale pour cette transaction.

Classement
rank integer

Position numérique positive non nulle dans les images affichées dans une liste, avec les images de rang 1 apparaissant dans la position la plus à gauche d’une liste.

Écraser
overwrite boolean

Lorsque la valeur est true, cette requête remplace l’image existante à un rang donné.

Est filigrane
is_watermarked boolean

Lorsque la valeur est true, indique que l’image chargée a un filigrane.

Retours

Url de référence et métadonnées d’une image associée à une description spécifique. Le url_fullxfull paramètre contient l’URL du fichier image binaire de taille complète.

ListingImage
ListingImage

Créer un brouillon de liste

Crée un brouillon physique de produit de référencement dans un magasin sur le canal Etsy.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Quantité
quantity True integer

Nombre positif non nul de produits disponibles pour l’achat dans la liste.

Titre
title True string

Chaîne de titre de la liste. Les chaînes de titre valides contiennent uniquement des lettres, des chiffres, des marques de ponctuation, des symboles mathématiques, des espaces blancs, , ™ © et ® . (regex : /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Vous ne pouvez utiliser que les %, :, et + caractères une fois chacun.

Descriptif
description True string

Chaîne de description du produit à vendre dans la description.

Prix
price True float

Prix positif non nul du produit. (Les référencements de produits vendus sont privés) Remarque : Le prix est le prix minimum possible.

Qui a fait
who_made True string

Chaîne inidcatée qui a fait le produit. Aide les acheteurs à localiser la description sous le titre Handmade. Nécessite « is_supply » et « when_made ».

Quand il est fait
when_made string

Chaîne pour l’ère dans laquelle le fabricant a fait le produit dans cette liste. Aide les acheteurs à localiser la description sous l’en-tête Vintage. Nécessite « is_supply » et « who_made ».

ID de taxonomie
taxonomy_id True integer

ID de taxonomie numérique de la liste. Le vendeur gère la description des ID de taxonomie pour leur magasin.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

Materials
materials string

Tableau de chaînes de matériaux pour les matériaux utilisés dans le produit. Les chaînes de matériaux valides contiennent uniquement des lettres, des chiffres et des espaces blancs. (regex : /[^\p{L}\p{Nd}\p{Zs}]/u)

ID de section magasin
shop_section_id integer

ID numérique de la section magasin pour cette description.

Traitement minimal
processing_min integer

Nombre minimal de jours requis pour traiter cette liste.

Traitement maximal
processing_max integer

Nombre maximal de jours requis pour traiter cette liste.

Étiquettes
tags string

Tableau de chaînes d’étiquettes pour la liste. Les chaînes d’étiquettes valides contiennent uniquement des lettres, des chiffres, des espaces blancs, -, ', ™ , © et ® . (regex : /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)

Recipient
recipient string

Chaîne indiquant une personne pour laquelle ce produit ferait un cadeau approprié.

Occasion
occasion string

Chaîne indiquant une occasion pour laquelle ce produit ferait un cadeau approprié.

Styles
styles string

Tableau de chaînes de style pour cette liste, chacune étant une chaîne de texte de forme libre, telle que Formal ou Steampunk. Une description peut avoir jusqu’à deux styles. Les chaînes de style valides contiennent uniquement des lettres, des chiffres et des espaces blancs. (regex : /[^\p{L}\p{Nd}\p{Zs}]/u)

Poids de l’élément
item_weight float

Poids numérique du produit mesuré en unités définies dans l’unité de poids d’élément.

Longueur de l’élément
item_length integer

Longueur numérique du produit mesuré en unités définies dans l’unité de dimensions d’élément.

Largeur de l’élément
item_width float

Largeur numérique du produit mesuré en unités définies dans « unité de dimensions d’élément ».

Hauteur de l’élément
item_height float

Hauteur numérique du produit mesuré en unités définies dans « unité de dimensions d’élément ».

Unité de poids d’élément
item_weight_unit string

Chaîne définissant les unités utilisées pour mesurer le poids du produit.

Unité dimensions d’élément
item_dimensions_unit string

Chaîne définissant les unités utilisées pour mesurer les dimensions du produit.

Est personalisable
is_personalizable boolean

Lorsque la valeur est true, cette liste est personnalisable.

ID d’image
image_ids string

Tableau d’ID d’image numérique des images dans une liste, qui peut inclure jusqu’à 10 images.

Est-ce que l’approvisionnement
is_supply boolean

Lorsque la valeur est true, étiquette la description en tant que produit d’approvisionnement, sinon indique qu’il s’agit d’un produit fini. Aide les acheteurs à localiser la description sous l’en-tête Fournitures. Nécessite « qui a fait » et 'quand fait'.

Est personnalisable
is_customizable boolean

Lorsqu’il est vrai, un acheteur peut contacter le vendeur pour une commande personnalisée. La valeur par défaut est true lorsqu’un magasin accepte des commandes personnalisées. Ne s’applique pas aux magasins qui n’acceptent pas de commandes personnalisées.

Est imposable
is_taxable boolean

Si la valeur est true, les taux d’imposition applicables s’appliquent à cette liste lors de la caisse.

Retours

Description d’un magasin, qui contient une quantité de produit, un titre, une description, un prix, etc.

ShopListing
ShopListing

Créer un profil d’expédition

Crée un profil d’expédition. Vous pouvez passer un code ISO de pays ou une région lors de la création d’un profil d’expédition, mais pas les deux. Une seule est requise. Vous devez passer un ID de transporteur d’expédition et une classe de courrier, ou les jours de livraison min et max.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Titre
title True string

Chaîne de nom de ce profil d’expédition.

ISO du pays d’origine
origin_country_iso True string

Code ISO du pays à partir duquel la liste est fournie.

Coût principal
primary_cost True float

Coût de l’expédition vers ce pays/région seul, mesuré dans la devise par défaut du magasin.

Coût secondaire
secondary_cost True float

Coût de l’expédition vers ce pays/région avec un autre article, mesuré dans la devise par défaut du magasin.

Temps de traitement minimal
min_processing_time True integer

Délai minimal nécessaire pour traiter les descriptions avec ce profil d’expédition.

Durée de traitement maximale
max_processing_time True integer

Délai de traitement maximal nécessaire à l’expédition de la liste.

Unité de temps de traitement
processing_time_unit string

Unité utilisée pour représenter la durée d’un traitement. Une semaine équivaut à 5 jours ouvrables.

ISO du pays de destination
destination_country_iso string

Code ISO du pays auquel la liste est fournie. Si la valeur est Null, la requête définit la destination vers la région de destination.

Région de destination
destination_region string

Code de la région à laquelle la liste est fournie. Une région représente un ensemble de pays. Les régions prises en charge sont l’Union européenne et l’Union non-Europe (pays d’Europe non dans l’UE). Si ce n’est pas le cas, la demande définit la destination vers l’ISO du pays de destination ou partout si l’ISO du pays de destination est également null.

Code postal d’origine
origin_postal_code string

Chaîne de code postal (pas nécessairement un nombre) pour l’emplacement à partir duquel la liste est fournie.

ID du transporteur d’expédition
shipping_carrier_id integer

ID unique d’un transporteur maritime pris en charge, utilisé pour calculer une date de livraison estimée.

Mail, classe
mail_class string

Chaîne d’ID unique de la classe de messagerie d’un transporteur maritime, utilisée pour calculer une date de livraison estimée.

Jours de livraison minimum
min_delivery_days integer

Le nombre minimal de jours ouvrables qu’un acheteur peut s’attendre à recevoir son article acheté une fois qu’il a été expédié.

Nombre maximal de jours de livraison
max_delivery_days integer

Le nombre maximal de jours ouvrables qu’un acheteur peut s’attendre à recevoir son article acheté une fois qu’il a été expédié.

Retours

Représente un profil utilisé pour définir les informations d’expédition d’une liste. Notez qu’il n’est pas possible de créer des modèles d’expédition calculés via l’API. Toutefois, vous pouvez associer des profils d’expédition calculés créés à partir de Shop Manager à des descriptions à l’aide de l’API.

ShopShippingProfile
ShopShippingProfile

Créer un reçu d’expédition

Envoie les informations de suivi d’un reçu de magasin, ce qui crée une entrée de reçu de magasin pour l’ID de reçu donné. Chaque fois que vous envoyez des informations de suivi, Etsy envoie un e-mail de notification à l’utilisateur acheteur. Lorsque l’envoi de cci est vrai, Etsy envoie également des notifications d’expédition au vendeur. Lorsque le code de suivi et le nom du transporteur ne sont pas envoyés, le reçu est marqué comme étant expédié uniquement.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de reçu
receipt_id True integer

Reçu pour lequel envoyer le suivi.

Code de suivi
tracking_code string

Code de suivi de ce reçu.

Nom de l’opérateur
carrier_name string

Nom du transporteur pour ce reçu.

Envoyer un cci
send_bcc boolean

Si la valeur est true, la notification d’expédition est également envoyée au vendeur.

Retours

L’enregistrement d’un achat auprès d’un magasin. Les reçus des magasins affichent des valeurs monétaires à l’aide de la devise du magasin.

ShopReceipt
ShopReceipt

Créer une destination de profil d’expédition

Crée une destination d’expédition qui définit le coût d’expédition, le transporteur et la classe d’une destination dans un profil d’expédition. Cela affecte des coûts à l’aide de la devise de la boutique associée. Définissez la destination à l’aide de l’ISO ou de la région de destination du pays de destination ; l’ISO du pays de destination et la région de destination s’excluent mutuellement : définissez l’un ou l’autre. La définition des deux déclencheurs génère l’erreur 400. Si la requête ne définit ni l’ISO du pays de destination ni la région de destination, la destination par défaut est partout. Vous devez également affecter à la fois un ID de transporteur d’expédition et une classe de courrier ou des jours de livraison min et des jours de livraison maximum.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

Coût principal
primary_cost True float

Coût de l’expédition vers ce pays/région seul, mesuré dans la devise par défaut du magasin.

Coût secondaire
secondary_cost True string

Coût de l’expédition vers ce pays/région avec un autre article, mesuré dans la devise par défaut du magasin.

destination_country_iso
destination_country_iso string

destination_country_iso

destination_region
destination_region string

destination_region

shipping_carrier_id
shipping_carrier_id integer

shipping_carrier_id

mail_class
mail_class string

mail_class

min_delivery_days
min_delivery_days integer

min_delivery_days

max_delivery_days
max_delivery_days integer

max_delivery_days

Retours

Représente une destination d’expédition affectée à un profil d’expédition.

ShopShippingProfileDestination
ShopShippingProfileDestination

Créer une mise à niveau de profil d’expédition

Crée une mise à niveau de profil d’expédition, qui peut établir un prix pour une option d’expédition, telle qu’un autre transporteur ou une livraison plus rapide.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

Type
type True string

Type de mise à niveau de l’expédition. National (0) ou international (1).

Nom de la mise à niveau
upgrade_name True string

Nom de la mise à niveau de l’expédition affichée aux acheteurs lors de l’achat, par exemple la priorité USPS.

Prix
price True float

Coût supplémentaire d’ajout de la mise à niveau d’expédition.

Prix secondaire
secondary_price True float

Coût supplémentaire d’ajout de la mise à niveau d’expédition pour chaque élément supplémentaire.

ID du transporteur d’expédition
shipping_carrier_id integer

ID unique d’un transporteur maritime pris en charge, utilisé pour calculer une date de livraison estimée.

Mail, classe
mail_class string

Chaîne d’ID unique de la classe de messagerie d’un transporteur maritime, utilisée pour calculer une date de livraison estimée.

Jours de livraison minimum
min_delivery_days integer

min_delivery_days

Nombre maximal de jours de livraison
max_delivery_days integer

Le nombre maximal de jours ouvrables qu’un acheteur peut s’attendre à recevoir son article acheté une fois qu’il a été expédié.

Retours

Représentation d’une option de mise à niveau de profil d’expédition.

ShopShippingProfileUpgrade
ShopShippingProfileUpgrade

Créer une section de magasin

Crée une section dans un magasin spécifique.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Titre
title True string

Chaîne de titre d’une section de magasin.

Retours

Section d’une boutique dans laquelle un utilisateur peut trier les listes.

ShopSection
ShopSection

Créer une traduction de référencement

Crée une traduction de liste en listant l’ID et la langue.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Language
language True string

Balise de langue IETF pour la langue de cette traduction. Ex : de, en, es, fr, it, ja, nl, pl, pt, ru.

Titre
title True string

Titre de la description de cette traduction.

Descriptif
description True string

Description de la description de cette traduction.

Étiquettes
tags string

Balises de la description de cette traduction.

Retours

Représente les données de traduction d’une description.

ListingTranslation
ListingTranslation

Magasins de recherche

Retourne une liste de magasins portant le nom correspondant.

Paramètres

Nom Clé Obligatoire Type Description
Nom de l’atelier
shop_name True string

Chaîne de nom de la boutique.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Retours

Ensemble d’enregistrements shop.

Magasins
Shops

Mettre à jour les images de variante d’une liste

Crée des images de variantes sur une liste.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Images de variantes
variation_images True string

Tableau de données d’image de variante.

Retours

Représente plusieurs images de variantes de liste.

ListingVariationImages
ListingVariationImages

Mettre à jour l’inventaire d’une liste

Met à jour l’inventaire d’une liste identifiée par un ID de liste. La mise à jour échoue si les valeurs fournies pour la référence SKU du produit, l’offre de quantité et/ou le prix sont incompatibles avec les valeurs dans les champs de propriété. Lors de la définition d’un prix, affectez un float égal à un montant divisé par diviseur tel que spécifié dans la ressource monétaire.

Paramètres

Nom Clé Obligatoire Type Description
ID de liste
listing_id True string

ID numérique de la liste associée à cette transaction.

Produits
products True string

Tableau JSON de produits disponibles dans une liste, même s’il n’y a qu’un seul produit. Tous les noms de champs dans les objets blob JSON sont en minuscules.

Prix sur la propriété
price_on_property string

Tableau d’entiers d’ID de propriété de référencement unique pour les propriétés qui modifient les prix du produit, le cas échéant. Par exemple, si vous facturez des prix spécifiques pour différents produits de taille dans la même liste, ce tableau contient l’ID de propriété pour la taille.

Quantity on Property
quantity_on_property string

Tableau d’entiers d’ID de propriété de liste unique pour les propriétés qui modifient la quantité des produits, le cas échéant. Par exemple, si vous stockez des quantités spécifiques de produits colorés différents dans la même liste, ce tableau contient l’ID de propriété pour la couleur.

Référence SKU sur la propriété
sku_on_property string

Tableau d’entiers d’ID de propriété de liste unique pour les propriétés qui modifient la référence SKU du produit, le cas échéant. Par exemple, si vous utilisez des références SKU spécifiques pour différents produits colorés dans la même liste, ce tableau contient l’ID de propriété pour la couleur.

Retours

Représentation de l’enregistrement d’inventaire d’une liste unique.

ListingInventory
ListingInventory

Mettre à jour un magasin

Mettez à jour un magasin. Suppose que tous les paramètres de chaîne sont fournis dans la langue principale de la boutique.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Titre
title string

Une brève chaîne de titre pour la page principale du magasin.

Annonce
announcement string

Chaîne d’annonce aux acheteurs qui s’affichent sur la page d’accueil du magasin.

Message de vente
sale_message string

Chaîne de message envoyée aux utilisateurs qui effectuent un achat à partir de cette boutique.

Message de vente numérique
digital_sale_message string

Chaîne de message envoyée aux utilisateurs qui achètent un article numérique à partir de cette boutique.

Retours

Un magasin créé par un utilisateur Etsy.

Shop
Shop

Mettre à jour un profil d’expédition

Modifie les paramètres d’un profil d’expédition.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

Titre
title string

Chaîne de nom de ce profil d’expédition.

ISO du pays d’origine
origin_country_iso string

Code ISO du pays à partir duquel la liste est fournie.

Temps de traitement minimal
min_processing_time integer

Délai minimal nécessaire pour traiter les descriptions avec ce profil d’expédition.

Durée de traitement maximale
max_processing_time integer

Délai de traitement maximal nécessaire à l’expédition de la liste.

Unité de temps de traitement
processing_time_unit string

Unité utilisée pour représenter la durée d’un traitement. Une semaine équivaut à 5 jours ouvrables. Si aucun n’est fourni, l’unité est définie sur business_days.

Code postal d’origine
origin_postal_code string

Chaîne de code postal (pas nécessairement un nombre) pour l’emplacement à partir duquel la liste est fournie.

Retours

Représente un profil utilisé pour définir les informations d’expédition d’une liste. Notez qu’il n’est pas possible de créer des modèles d’expédition calculés via l’API. Toutefois, vous pouvez associer des profils d’expédition calculés créés à partir de Shop Manager à des descriptions à l’aide de l’API.

ShopShippingProfile
ShopShippingProfile

Mettre à jour une destination de profil d’expédition

Met à jour une destination d’expédition existante, qui peut définir ou réaffecter le coût d’expédition, le transporteur et la classe d’une destination.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True string

ID numérique du profil d’expédition associé à la liste.

ID de destination du profil d’expédition
shipping_profile_destination_id True string

ID numérique de la destination du profil d’expédition associé à la liste.

primary_cost
primary_cost string

primary_cost

secondary_cost
secondary_cost string

secondary_cost

destination_country_iso
destination_country_iso string

destination_country_iso

destination_region
destination_region string

destination_region

shipping_carrier_id
shipping_carrier_id integer

shipping_carrier_id

mail_class
mail_class string

mail_class

min_delivery_days
min_delivery_days integer

min_delivery_days

max_delivery_days
max_delivery_days integer

max_delivery_days

Retours

Représente une destination d’expédition affectée à un profil d’expédition.

ShopShippingProfileDestination
ShopShippingProfileDestination

Mettre à jour une liste

Met à jour une description, identifiée par un ID de référencement, pour un magasin spécifique identifié par un ID de magasin.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Quantité
quantity integer

Nombre positif non nul de produits disponibles pour l’achat dans la liste.

Titre
title string

Chaîne de titre de la liste. Les chaînes de titre valides contiennent uniquement des lettres, des chiffres, des marques de ponctuation, des symboles mathématiques, des espaces blancs, , ™ © et ® . (regex : /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Vous ne pouvez utiliser que les %, :, et + caractères une fois chacun.

Descriptif
description string

Chaîne de description du produit à vendre dans la description.

Prix
price float

Prix positif non nul du produit. (Les référencements de produits vendus sont privés) Remarque : Le prix est le prix minimum possible.

Qui a fait
who_made string

Chaîne inidcatée qui a fait le produit. Aide les acheteurs à localiser la description sous le titre Handmade. Nécessite « is_supply » et « when_made ».

Quand il est fait
when_made string

Chaîne pour l’ère dans laquelle le fabricant a fait le produit dans cette liste. Aide les acheteurs à localiser la description sous l’en-tête Vintage. Nécessite « is_supply » et « who_made ».

ID de taxonomie
taxonomy_id integer

ID de taxonomie numérique de la liste. Le vendeur gère la description des ID de taxonomie pour leur magasin.

ID du profil d’expédition
shipping_profile_id integer

ID numérique du profil d’expédition associé à la liste.

Materials
materials string

Tableau de chaînes de matériaux pour les matériaux utilisés dans le produit. Les chaînes de matériaux valides contiennent uniquement des lettres, des chiffres et des espaces blancs. (regex : /[^\p{L}\p{Nd}\p{Zs}]/u)

ID de section magasin
shop_section_id integer

ID numérique de la section magasin pour cette description.

Traitement minimal
processing_min integer

Nombre minimal de jours requis pour traiter cette liste.

Traitement maximal
processing_max integer

Nombre maximal de jours requis pour traiter cette liste.

Étiquettes
tags string

Tableau de chaînes d’étiquettes pour la liste. Les chaînes d’étiquettes valides contiennent uniquement des lettres, des chiffres, des espaces blancs, -, ', ™ , © et ® . (regex : /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)

Recipient
recipient string

Chaîne indiquant une personne pour laquelle ce produit ferait un cadeau approprié.

Occasion
occasion string

Chaîne indiquant une occasion pour laquelle ce produit ferait un cadeau approprié.

Styles
styles string

Tableau de chaînes de style pour cette liste, chacune étant une chaîne de texte de forme libre, telle que Formal ou Steampunk. Une description peut avoir jusqu’à deux styles. Les chaînes de style valides contiennent uniquement des lettres, des chiffres et des espaces blancs. (regex : /[^\p{L}\p{Nd}\p{Zs}]/u)

Poids de l’élément
item_weight float

Poids numérique du produit mesuré en unités définies dans l’unité de poids d’élément.

Longueur de l’élément
item_length integer

Longueur numérique du produit mesuré en unités définies dans l’unité de dimensions d’élément.

Largeur de l’élément
item_width float

Largeur numérique du produit mesuré en unités définies dans « unité de dimensions d’élément ».

Hauteur de l’élément
item_height float

Hauteur numérique du produit mesuré en unités définies dans « unité de dimensions d’élément ».

Unité de poids d’élément
item_weight_unit string

Chaîne définissant les unités utilisées pour mesurer le poids du produit.

Unité dimensions d’élément
item_dimensions_unit string

Chaîne définissant les unités utilisées pour mesurer les dimensions du produit.

Est personalisable
is_personalizable boolean

Lorsque la valeur est true, cette liste est personnalisable.

ID d’image
image_ids string

Tableau d’ID d’image numérique des images dans une liste, qui peut inclure jusqu’à 10 images.

Est-ce que l’approvisionnement
is_supply boolean

Lorsque la valeur est true, étiquette la description en tant que produit d’approvisionnement, sinon indique qu’il s’agit d’un produit fini. Aide les acheteurs à localiser la description sous l’en-tête Fournitures. Nécessite « qui a fait » et 'quand fait'.

Est personnalisable
is_customizable boolean

Lorsqu’il est vrai, un acheteur peut contacter le vendeur pour une commande personnalisée. La valeur par défaut est true lorsqu’un magasin accepte des commandes personnalisées. Ne s’applique pas aux magasins qui n’acceptent pas de commandes personnalisées.

Est imposable
is_taxable boolean

Si la valeur est true, les taux d’imposition applicables s’appliquent à cette liste lors de la caisse.

Classement recommandé
featured_ rank integer

Position numérique positive non nulle dans les annonces proposées de la boutique avec classement 1 référencements apparaissant dans la position la plus à gauche dans la description proposée sur la page d’accueil d’un magasin.

Doit être renouvelé automatiquement
should_auto_renew boolean

Lorsque la valeur est true, renouvelle une liste pendant quatre mois après l’expriation. Si la valeur est true auparavant false, etsy.com renouvelle la liste avant son expiration, mais la période de renouvellement commence de manière immidiate au lieu d’étendre la date d’expiration de la liste. Tout temps inutilisé restant sur la liste est perdu. Les renouvellements entraînent des frais pour la facture d’un utilisateur.

Type
type string

Indique si la description est physique ou numérique.

Canaux
channels string

Tableau de chaînes d’ID de canal énumérées. Un canal est un lieu pour que les vendeurs atteignent les acheteurs afin de faire des ventes.

Retours

Description d’un magasin, qui contient une quantité de produit, un titre, une description, un prix, etc.

ShopListing
ShopListing

Mettre à jour une mise à niveau d’un profil d’expédition

Met à jour une mise à niveau d’un profil d’expédition et met à jour les listes qui utilisent le profil d’expédition.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

ID de mise à niveau
upgrade_id True integer

ID numérique associé à une mise à niveau d’expédition

Type
type string

Type de mise à niveau de l’expédition. National (0) ou international (1).

Nom de la mise à niveau
upgrade_name string

Nom de la mise à niveau de l’expédition affichée aux acheteurs lors de l’achat, par exemple la priorité USPS.

Prix
price float

Coût supplémentaire d’ajout de la mise à niveau d’expédition.

Prix secondaire
secondary_price float

Coût supplémentaire d’ajout de la mise à niveau d’expédition pour chaque élément supplémentaire.

ID du transporteur d’expédition
shipping_carrier_id integer

ID unique d’un transporteur maritime pris en charge, utilisé pour calculer une date de livraison estimée.

Mail, classe
mail_class string

Chaîne d’ID unique de la classe de messagerie d’un transporteur maritime, utilisée pour calculer une date de livraison estimée.

Jours de livraison minimum
min_delivery_days integer

min_delivery_days

Nombre maximal de jours de livraison
max_delivery_days integer

Le nombre maximal de jours ouvrables qu’un acheteur peut s’attendre à recevoir son article acheté une fois qu’il a été expédié.

Retours

Représentation d’une option de mise à niveau de profil d’expédition.

ShopShippingProfileUpgrade
ShopShippingProfileUpgrade

Mettre à jour une propriété de référencement

Met à jour ou remplit la liste des propriétés définissant les offres de produits pour une description. Chaque offre nécessite à la fois une valeur et un ID de valeur valides pour un ID d’échelle affecté à la description ou que vous affectez à la description avec cette demande.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

ID de propriété
property_id True integer

ID unique d’une propriété de référencement Etsy.

ID de valeur
value_ids True integer

ID numérique d’une échelle de mesure Etsy.com unique.

Valeurs
values True string

Tableau de chaînes de valeur pour plusieurs valeurs de liste Etsy.

ID de mise à l’échelle
scale_id integer

ID numérique d’une échelle de mesure Etsy.com unique.

Retours

Représentation des valeurs de données structurées.

ListingPropertyValue
ListingPropertyValue

Mettre à jour une traduction de référencement

Met à jour une traduction de liste en listant l’ID et la langue.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Language
language True string

Balise de langue IETF pour la langue de cette traduction. Ex : de, en, es, fr, it, ja, nl, pl, pt, ru.

Titre
title True string

Titre de la description de cette traduction.

Descriptif
description True string

Description de la description de cette traduction.

Étiquettes
tags string

Balises de la description de cette traduction.

Retours

Représente les données de traduction d’une description.

ListingTranslation
ListingTranslation

Obtenir des adresses utilisateur

Récupérez une liste d’adresses utilisateur.

Paramètres

Nom Clé Obligatoire Type Description
Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Retours

Représente plusieurs enregistrements UserAddress.

UserAddresses
UserAddresses

Obtenir des annonces actives par magasin

Récupère une liste de toutes les annonces actives sur Etsy dans un magasin spécifique, paginé par date de création de liste.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Includes
keywords string

Terme ou expression de recherche qui doit apparaître dans tous les résultats.

Retours

Ensemble de ressources de référencement des magasins.

ShopListings
ShopListings

Obtenir des annonces par boutique

Retourne les annonces qui appartiennent à un magasin. Les listings peuvent être filtrés à l’aide du paramètre d’état.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

État
State string

Chaîne énumérée de l’un des éléments suivants : actif ou inactif.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Trier sur
Sort On string

Valeur sur laquelle trier un résultat de recherche de listes.

Ordre de tri
Sort Order string

Ordre croissant(vers le haut) ou décroissant(vers le bas) pour trier les listes par.

Retours

Ensemble de ressources de référencement des magasins.

ShopListings
ShopListings

Obtenir des annonces par reçu de la boutique

Obtient toutes les listes associées à un reçu.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique de la réception associée à cette transaction.

ID de reçu
receipt_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Retours

Ensemble de ressources de référencement des magasins.

ShopListings
ShopListings

Obtenir des annonces proposées par magasin

Récupère les annonces associées à un magasin qui sont proposés.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Retours

Ensemble de ressources de référencement des magasins.

ShopListings
ShopListings

Obtenir des avis

Récupère les avis d’un magasin en fonction de son ID.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Retours

Ensemble d’enregistrements de révision des transactions laissés par les utilisateurs.

TransactionReviews
TransactionReviews

Obtenir des descriptions par ID

Permet d’interroger plusieurs ID de liste à la fois. Limitez 100 ID maximum par requête.

Paramètres

Nom Clé Obligatoire Type Description
Liste des ID
listing_ids True string

Tableau d’ID numériques pour les descriptions dans une boutique Etsy spécifique.

Includes
includes string

Chaîne énumérée qui attache une association valide.

Retours

Ensemble de ressources de référencement des magasins avec des associations.

ShopListingsWithAssociations
ShopListingsWithAssociations

Obtenir des descriptions par ID de section boutique

Récupère toutes les descriptions de la section d’un magasin spécifique.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de section boutique
shop_section_ids True string

Tableau d’ID numériques pour toutes les sections d’une boutique Etsy spécifique.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Trier sur
sort_on string

Valeur sur laquelle trier un résultat de recherche de listes.

Ordre de tri
sort_order string

Ordre croissant(vers le haut) ou décroissant(vers le bas) pour trier les listes par.

Retours

Ensemble de ressources de référencement des magasins.

ShopListings
ShopListings

Obtenir des destinations de profil par profil d’expédition

Récupère une liste d’objets de destination d’expédition associés à un profil d’expédition.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Retours

Représente une liste d’objets de destination d’expédition.

ShopShippingProfileDestinations
ShopShippingProfileDestinations

Obtenir des listes actives

Liste de toutes les listes actives sur Etsy paginés par leur date de création. Sans liste d’ordre de tri, les annonces seront retournées la plus récente par défaut.

Paramètres

Nom Clé Obligatoire Type Description
Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Includes
keywords string

Terme ou expression de recherche qui doit apparaître dans tous les résultats.

Trier sur
sort_on string

Valeur sur laquelle trier un résultat de recherche de listes. REMARQUE : le tri ne fonctionne que lorsqu’il est combiné à l’une des options de recherche (mots clés, région, etc.).

Ordre de tri
sort_order string

Ordre croissant(vers le haut) ou décroissant(vers le bas) pour trier les listes par. REMARQUE : sort_order fonctionne uniquement lorsqu’elle est combinée à l’une des options de recherche (mots clés, région, etc.).

Prix minimum
min_price float

Prix minimal des référencements à renvoyer par un résultat de recherche.

Prix maximal
max_price float

Prix maximal des référencements à renvoyer par un résultat de recherche.

ID de taxonomie
taxonomy_id integer

ID de taxonomie numérique de la liste. Le vendeur gère la description des ID de taxonomie pour leur magasin.

Emplacement de l’achat
shop_location string

Filtre par emplacement de magasin. Si l’emplacement ne peut pas être analysé, Etsy répond avec une erreur.

Retours

Ensemble de ressources de référencement des magasins.

ShopListings
ShopListings

Obtenir des mises à niveau de profil d’expédition

Récupère la liste des mises à niveau de profil d’expédition affectées à un profil d’expédition spécifique.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

Retours

Liste des options de mise à niveau d’expédition.

ShopShippingProfileUpgrades
ShopShippingProfileUpgrades

Obtenir des nœuds de taxonomie vendeur

Récupère l’arborescence de hiérarchie complète des nœuds de taxonomie vendeur.

Retours

Liste des nœuds de taxonomie de l’arborescence de taxonomie vendeur.

SellerTaxonomyNodes
SellerTaxonomyNodes

Obtenir des profils d’expédition

Récupère une liste de profils d’expédition disponibles dans la boutique Etsy spécifique identifiée par son ID de magasin.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Retours

Représente un profil utilisé pour définir les informations d’expédition d’une liste. Notez qu’il n’est pas possible de créer des modèles d’expédition calculés via l’API. Toutefois, vous pouvez associer des profils d’expédition calculés créés à partir de Shop Manager à des descriptions à l’aide de l’API.

ShopShippingProfile
ShopShippingProfile

Obtenir des reçus

Demande les reçus d’un magasin spécifique, non filtrés ou filtrés par plage d’ID de reçu, décalage, date, paiement et/ou achats expédiés.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Minimum créé
min_created integer

Horodatage unix le plus ancien pour lequel un enregistrement a été créé.

Nombre maximal de créations
max_created integer

Horodatage unix le plus récent pour lequel un enregistrement a été créé.

Dernière modification
min_last_modified integer

Horodatage unix le plus ancien pour lequel un enregistrement a été modifié pour la dernière fois.

Dernière modification
max_last_modified integer

Horodatage unix le plus récent pour lequel un enregistrement a été modifié pour la dernière fois.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

A été payé
was_paid boolean

Lorsque la valeur est true, le vendeur a reçu le paiement du ou des produits dans ce reçu.

A été expédié
was_shipped boolean

Lorsque la valeur est true, le vendeur a expédié le ou les produits dans ce reçu.

Retours

Les reçus d’un magasin spécifique.

ShopReceipts
ShopReceipts

Obtenir des sections de magasin

Récupère la liste des sections de magasin dans un magasin spécifique identifié par ID de magasin.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Retours

Toutes les sections d’un magasin sprecific.

ShopSections
ShopSections

Obtenir des transporteurs d’expédition

Récupère une liste des transporteurs d’expédition disponibles et les classes de courrier associées pour un pays donné.

Paramètres

Nom Clé Obligatoire Type Description
ISO du pays d’origine
origin_country_iso True string

Code ISO du pays à partir duquel la liste est fournie.

Retours

Représente plusieurs ShippingCarriers.

ShippingCarriers
ShippingCarriers

Obtenir la liste des paiements

Récupère la liste des paiements d’un magasin identifié par ID de magasin. Vous pouvez également filtrer les résultats à l’aide d’une liste d’ID de paiement.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de paiement
payment-ids True string

Tableau séparé par des virgules de numéros d’ID de paiement.

Retours

Représente plusieurs paiements effectués avec Etsy Payments. Tous les montants monétaires sont en centimes USD, sauf indication contraire.

Paiements
Payments

Obtenir la propriété d’une description (bêta)

Récupère la propriété d’une description. Le développement pour ce point de terminaison est en cours. Elle retourne uniquement une réponse 501.

Paramètres

Nom Clé Obligatoire Type Description
ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

ID de propriété
property_id True integer

ID unique d’une propriété de référencement Etsy.

Retours

Représentation des valeurs de données structurées.

ListingPropertyValue
ListingPropertyValue

Obtenir la traduction d’une description

Retourne la traduction d’une liste dans la langue donnée.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Language
language True string

Balise de langue IETF pour la langue de cette traduction. Ex : de, en, es, fr, it, ja, nl, pl, pt, ru.

Retours

Représente les données de traduction d’une description.

ListingTranslation
ListingTranslation

Obtenir la transaction d’un magasin

Récupère la liste des transactions associées à un magasin.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Retours

Ensemble de ressources de transaction de confirmation de magasin

ShopReceiptTransactions
ShopReceiptTransactions

Obtenir la transaction d’un reçu

Récupère la liste des transactions associées à un reçu spécifique.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de reçu
receipt_id True integer

ID numérique de la réception associée à cette transaction.

Retours

Ensemble de ressources de transaction de confirmation de magasin

ShopReceiptTransactions
ShopReceiptTransactions

Obtenir le produit d’une description

Récupérez un produit de référencement par ID.

Paramètres

Nom Clé Obligatoire Type Description
ID de liste
listing_id True integer

Liste pour laquelle retourner un produit de référencement.

Identifiant du produit
product_id True integer

ID numérique d’un produit spécifique acheté à partir d’une description.

Retours

Représentation d’un produit pour une description.

ListingInventoryProduct
ListingInventoryProduct

Obtenir les entrées d’un compte de paiement d’un magasin

Récupérez les entrées du registre du compte de paiement d’un magasin.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Minimum créé
min_created True integer

Horodatage unix le plus ancien pour lequel un enregistrement a été créé.

Nombre maximal de créations
max_created True integer

Horodatage unix le plus récent pour lequel un enregistrement a été créé.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Retours

Ensemble de ressources d’entrée de registre de compte de paiement

PaymentAccountLedgerEntries
PaymentAccountLedgerEntries

Obtenir les images de variantes de la liste

Obtient toutes les images de variante sur une liste.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Retours

Représente plusieurs images de variantes de liste.

ListingVariationImages
ListingVariationImages

Obtenir les images d’une description

Récupère toutes les ressources d’image de référencement pour une description avec un ID de référencement spécifique.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Retours

Représente une liste de ressources d’image de liste, chacune contenant les URL de référence et les métadonnées d’une image.

ListingImages
ListingImages

Obtenir les propriétés du produit par ID de taxonomie

Récupère une liste de propriétés de produit, avec des échelles et des valeurs applicables, prises en charge pour un ID de taxonomie vendeur spécifique.

Paramètres

Nom Clé Obligatoire Type Description
ID de taxonomie
taxonomy_id True string

ID numérique unique d’un nœud de taxonomie Etsy, qui est une catégorie de métadonnées pour les descriptions organisées dans l’arborescence de hiérarchie de taxonomie vendeur.

Retours

Liste des définitions de propriétés de produit.

TaxonomyNodeProperties
TaxonomyNodeProperties

Obtenir les propriétés d’une liste

Retourne une liste des propriétés d’une liste.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Retours

Représente plusieurs valeurs de propriétés de référencement.

ListingPropertyValues
ListingPropertyValues

Obtenir l’achat par ID de propriétaire

Récupère l’atelier identifié par l’ID d’utilisateur du propriétaire du magasin.

Paramètres

Nom Clé Obligatoire Type Description
ID d’utilisateur
user_id True string

ID d’utilisateur numérique de l’utilisateur propriétaire de cette boutique.

Retours

Un magasin créé par un utilisateur Etsy.

Shop
Shop

Obtenir l’adresse de l’utilisateur

Récupère l’adresse de l’utilisateur. Le développement pour ce point de terminaison est en cours. Elle retourne uniquement une réponse 501.

Paramètres

Nom Clé Obligatoire Type Description
ID d’adresse utilisateur
user_address_id True integer

ID numérique de l’adresse de l’utilisateur.

Retours

Représente l’adresse d’un utilisateur.

UserAddress
UserAddress

Obtenir l’inventaire d’une liste

Récupère l’enregistrement d’inventaire d’une description. Les listings que vous n’avez pas modifiés à l’aide des outils d’inventaire Etsy.com n’ont pas d’enregistrements d’inventaire. Ce point de terminaison retourne des données de référence SKU si vous êtes le propriétaire des enregistrements d’inventaire récupérés.

Paramètres

Nom Clé Obligatoire Type Description
ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Includes
includes string

Chaîne énumérée qui joint une association valide.

Retours

Représentation de l’enregistrement d’inventaire d’une liste unique avec des associations

ListingInventoryWithAssociations
ListingInventoryWithAssociations

Obtenir l’offre d’une annonce

Obtenez une offre pour une liste.

Paramètres

Nom Clé Obligatoire Type Description
ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Identifiant du produit
product_id True integer

ID numérique du produit associé à cette transaction.

ID de l’offre de produit
product_offering_id True integer

ID numérique de l’offre de produit associée à cette transaction.

Retours

Représentation d’une offre pour une description.

ListingInventoryProductOffering
ListingInventoryProductOffering

Obtenir tous les fichiers de référencement

Récupère tous les fichiers associés à la liste numérique donnée. La demande de fichiers à partir d’une liste physique retourne un résultat vide.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique de la liste associée à cette transaction.

ID de liste
listing_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Retours

Représente plusieurs ShopListingFiles.

ShopListingFiles
ShopListingFiles

Obtenir un fichier à partir d’une liste

Récupère un seul fichier associé à la liste numérique donnée. La demande d’un fichier à partir d’une liste physique retourne un résultat vide.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

ID de fichier de liste
listing_file_id True integer

ID numérique unique d’un fichier associé à une liste numérique.

Retours

Fichier associé à une liste numérique.

ShopListingFile
ShopListingFile

Obtenir un paiement à partir d’un ID d’entrée de registre de compte de paiement

Obtenez un paiement à partir d’un ID d’entrée de registre de compte de paiement, le cas échéant.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID d’entrée de registre
ledger_entry_ids True string

Tableau d’entiers.

Retours

Représente plusieurs paiements effectués avec Etsy Payments. Tous les montants monétaires sont en centimes USD, sauf indication contraire.

Paiements
Payments

Obtenir un paiement à partir d’un reçu spécifique

Récupère un paiement à partir d’un reçu spécifique, identifié par ID de reçu, à partir d’un magasin spécifique, identifié par ID de magasin.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de reçu
receipt_id True string

ID numérique de la réception associée à cette transaction.

Retours

Représente plusieurs paiements effectués avec Etsy Payments. Tous les montants monétaires sont en centimes USD, sauf indication contraire.

Paiements
Payments

Obtenir un profil d’expédition

Récupère un profil d’expédition référencé par l’ID de profil d’expédition.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

Obtenir un reçu

Récupère un reçu, identifié par un ID de reçu, à partir d’un magasin Etsy.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de reçu
receipt_id True integer

ID numérique de la réception associée à cette transaction.

Retours

L’enregistrement d’un achat auprès d’un magasin. Les reçus des magasins affichent des valeurs monétaires à l’aide de la devise du magasin.

ShopReceipt
ShopReceipt

Obtenir un utilisateur

Retourne le profil utilisateur pour l’utilisateur identifié par un ID d’utilisateur.

Paramètres

Nom Clé Obligatoire Type Description
ID d’utilisateur
user_id True integer

ID numérique unique positif non nul pour un utilisateur.

Retours

Représente un seul utilisateur du site

Utilisateur
User

Obtenir une image de référencement

Récupère les références et métadonnées d’une image de liste avec un ID d’image spécifique.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

ID d’image de liste
listing_image_id True integer

ID numérique de l’image de liste principale pour cette transaction.

Retours

Url de référence et métadonnées d’une image associée à une description spécifique. Le url_fullxfull paramètre contient l’URL du fichier image binaire de taille complète.

ListingImage
ListingImage

Obtenir une liste

Récupère un enregistrement de référencement par ID de liste.

Paramètres

Nom Clé Obligatoire Type Description
ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Includes
includes string

Chaîne énumérée qui attache une association valide. Les entrées acceptables sont « shop », « images » et « user ».

Obtenir une transaction

Récupère une transaction par ID de transaction.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

Transaction ID
transaction_id True integer

ID numérique unique pour une transaction.

Retours

Objet de transaction associé à un reçu de magasin. Etsy génère une transaction par référencement acheté comme enregistré sur le reçu de la commande.

ShopReceiptTransaction
ShopReceiptTransaction

Ping

Vérifiez la connectivité à l’API Etsy avec une application.

Retours

Confirmation que l’application actuelle a accès à l’API Open

Puanteur
Pong

Récupérer les transactions d’une liste

Récupère la liste des transactions associées à une liste.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Limit
limit integer

Nombre maximal de résultats à retourner.

Décalage
offset integer

Nombre d’enregistrements à ignorer avant de sélectionner le premier résultat.

Retours

Ensemble de ressources de transaction de confirmation de magasin

ShopReceiptTransactions
ShopReceiptTransactions

Section Obtenir un magasin

Récupère une section de magasin, référencée par ID de section et ID de magasin.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de section magasin
shop_section_id True integer

ID numérique d’une section dans un magasin Etsy spécifique.

Retours

Section d’une boutique dans laquelle un utilisateur peut trier les listes.

ShopSection
ShopSection

Supprimer un fichier de la liste

Lorsque vous supprimez le fichier final d’une description numérique, la liste est convertie en liste physique. La réponse à une demande de suppression retourne une liste des enregistrements de fichiers restants associés à la liste donnée.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

ID de fichier de liste
listing_file_id True integer

ID numérique unique d’un fichier associé à une liste numérique.

Supprimer un profil d’expédition

Supprime un profil d’expédition par ID donné.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

Retours

Représente un profil utilisé pour définir les informations d’expédition d’une liste. Notez qu’il n’est pas possible de créer des modèles d’expédition calculés via l’API. Toutefois, vous pouvez associer des profils d’expédition calculés créés à partir de Shop Manager à des descriptions à l’aide de l’API.

ShopShippingProfile
ShopShippingProfile

Supprimer une destination de profil d’expédition

Supprime une destination d’expédition et supprime l’option de destination de chaque description qui utilise le profil d’expédition associé. Un profil d’expédition nécessite au moins une destination d’expédition. Ce point de terminaison ne peut donc pas supprimer la destination finale de l’expédition pour tout profil d’expédition. Pour supprimer la destination d’expédition finale d’un profil d’expédition, vous devez supprimer l’intégralité du profil d’expédition.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition associé à la liste.

ID de destination du profil d’expédition
shipping_profile_destination_id True integer

ID numérique de la destination du profil d’expédition dans le profil d’expédition associé à la description.

Supprimer une image de référencement

Supprime une image de référencement. Une copie du fichier reste sur nos serveurs, et une image supprimée peut donc être re-associée à la liste sans recharger l’image d’origine.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

ID d’image de liste
listing_image_id True integer

ID numérique de l’image de liste principale pour cette transaction.

Supprimer une liste

Cette action supprime une description des magasins. Une liste ne peut être supprimée que si l’état est l’un des éléments suivants : SOLD_OUT, DRAFT, EXPIRÉ, INACTIF, ACTIF et is_available ou ACTIVE et a des indicateurs vendeurs : SUPRESSED (figé), VACATION, CUSTOM_SHOPS (modèle), SELL_ON_FACEBOOK

Paramètres

Nom Clé Obligatoire Type Description
ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

Supprimer une mise à niveau du profil d’expédition

Supprime une mise à niveau du profil d’expédition et supprime l’option de mise à niveau de chaque description qui utilise le profil d’expédition associé.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID du profil d’expédition
shipping_profile_id True integer

ID numérique du profil d’expédition.

ID de mise à niveau
upgrade_id True integer

ID numérique associé à une mise à niveau d’expédition

Supprimer une propriété de référencement

Supprime une propriété d’une liste.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’atelier
shop_id True integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de liste
listing_id True integer

ID numérique de la liste associée à cette transaction.

ID de propriété
property_id True integer

ID unique d’une propriété de référencement Etsy.

Définitions

ShopListing

Description d’un magasin, qui contient une quantité de produit, un titre, une description, un prix, etc.

Nom Chemin d’accès Type Description
ID de liste
listing_id integer

ID numérique de la liste associée à cette transaction.

ID d’utilisateur
user_id integer

ID numérique de l’utilisateur qui publie la description.

ID de l’atelier
shop_id integer

ID numérique positif unique non nul pour un magasin Etsy.

Titre
title string

Chaîne de titre de la liste. Les chaînes de titre valides contiennent uniquement des lettres, des chiffres, des marques de ponctuation, des symboles mathématiques, des espaces blancs, , ™ © et ® . (regex : /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Vous ne pouvez utiliser que les %, :, et + caractères une fois chacun.

Descriptif
description string

Chaîne de description du produit à vendre dans la description.

État
state State

Chaîne énumérée de l’un des éléments suivants : actif ou inactif. Remarque : la définition d’un brouillon de liste sur active publiera également la description sur etsy.com.

Horodatage de création
creation_timestamp integer

Heure de création de la liste, en secondes d’époque.

Horodatage de fin
ending_timestamp integer

Heure d’expiration de la liste, en secondes d’époque.

Horodatage de création d’origine
original_creation_timestamp integer

Heure de création de la liste, en secondes d’époque.

Horodatage modifié
last_modified_timestamp integer

Heure de la dernière mise à jour de la liste, en secondes d’époque.

Horodatage du dernier changement d’état
state_timestamp integer

Date et heure du dernier changement d’état de cette liste.

Quantité
quantity integer

Nombre positif non nul de produits disponibles pour l’achat dans la liste. Remarque : la quantité de listes correspond à la somme des quantités d’offres disponibles. Vous pouvez demander les quantités d’offres individuelles à partir de la ressource ListingInventory à l’aide du point de terminaison d’inventaire get listing.

ID de section magasin
shop_section_id integer

ID numérique d’une section dans un magasin Etsy spécifique.

Classement recommandé
featured_rank integer

Position numérique positive non nulle dans les annonces proposées de la boutique, avec le classement 1 figurant dans la position la plus à gauche dans la description recommandée sur la page d’accueil d’un magasin.

URL
url string

URL complète de la page de la liste sur Etsy.

Nombre de favoris
num_favorers integer

Nombre d’utilisateurs qui ont marqué cette liste comme favori.

Non imposable
non_taxable boolean

Si la valeur est true, les taux d’imposition applicables des magasins ne s’appliquent pas à cette description lors de la caisse.

Est personnalisable
is_customizable boolean

Lorsqu’il est vrai, un acheteur peut contacter le vendeur pour une commande personnalisée. La valeur par défaut est true lorsqu’un magasin accepte des commandes personnalisées. Ne s’applique pas aux magasins qui n’acceptent pas de commandes personnalisées.

Is Peronalizable
is_personalizable boolean

Lorsque la valeur est true, cette liste est personnalisable. La valeur par défaut est null.

La personnalisation est requise
personalization_is_required boolean

Lorsque la valeur est true, cette description nécessite une personnalisation. La valeur par défaut est null.

Nombre maximal de caractères de personnalisation
personalization_char_count_max integer

Valeur entière représentant la longueur maximale du message de personnalisation entré par l’acheteur.

Instructions de personnalisation
personalization_instructions string

Lorsque la valeur est true, cette description nécessite une personnalisation. La valeur par défaut est null.

Type de liste
listing_type boolean

Chaîne de type énumérée qui indique si la description est physique ou numérique.

Étiquettes
tags array of string

Liste des chaînes d’étiquettes pour la liste. Les chaînes d’étiquettes valides contiennent uniquement des lettres, des chiffres, des espaces blancs, -, ', ™ , © et ® . (regex : /[^\p{L}\p{Nd}\p{Zs}\-'™©®]/u) La valeur par défaut est Null.

Materials
materials array of string

Liste des chaînes de matériaux pour les matériaux utilisés dans le produit. Les chaînes de matériaux valides contiennent uniquement des lettres, des chiffres et des espaces blancs. (regex : /[^\p{L}\p{Nd}\p{Zs}]/u) La valeur par défaut est Null.

ID du profil d’expédition
shipping_profile_id integer

ID numérique du profil d’expédition associé à la liste.

Jours de traitement minimum
processing_min integer

Nombre minimal de jours requis pour traiter cette liste. La valeur par défaut est Null.

Nombre maximal de jours de traitement
processing_max integer

Nombre maximal de jours requis pour traiter cette liste. La valeur par défaut est Null.

WhoMade
who_made WhoMade

Chaîne énumérée inidcatée qui a fait le produit. Aide les acheteurs à localiser la description sous le titre Handmade. Nécessite « is_supply » et « when_made ».

WhenMade
when_made WhenMade

Chaîne énumérée pour l’ère dans laquelle le fabricant a fait le produit dans cette liste. Aide les acheteurs à localiser la description sous l’en-tête Vintage. Nécessite « is_supply » et « who_made ».

Fournir un produit
is_supply boolean

Lorsque la valeur est true, étiquette la description en tant que produit d’approvisionnement, sinon indique qu’il s’agit d’un produit fini. Aide les acheteurs à localiser la description sous l’en-tête Fournitures. Nécessite « who_made » et « when_made ».

Poids de l’élément
item_weight double

Poids numérique du produit mesuré en unités définies dans l’unité de poids d’élément. La valeur par défaut est Null. Si elle est définie, la valeur doit être supérieure à 0.

ItemWeightUnit
item_weight_unit ItemWeightUnit

Chaîne définissant les unités utilisées pour mesurer le poids du produit. La valeur par défaut est Null.

Longueur de l’élément
item_length double

Longueur numérique du produit mesuré en unités définies dans l’unité de dimensions d’élément. La valeur par défaut est Null. Si elle est définie, la valeur doit être supérieure à 0.

Largeur de l’élément
item_width double

Largeur numérique du produit mesuré en unités définies dans l’unité de dimensions d’élément. La valeur par défaut est Null. Si elle est définie, la valeur doit être supérieure à 0.

Hauteur de l’élément
item_height double

Longueur numérique du produit mesuré en unités définies dans l’unité de dimensions d’élément. La valeur par défaut est Null. Si elle est définie, la valeur doit être supérieure à 0.

ItemDimensionsUnit
item_dimensions_unit ItemDimensionsUnit

Chaîne définissant les unités utilisées pour mesurer les dimensions du produit. La valeur par défaut est Null.

Est privé
is_private boolean

Quand c’est vrai, il s’agit d’une annonce privée intentionend pour un acheteur spécifique et masqué de la vue des magasins.

Recipient
recipient Recipient

Chaîne énumérée indiquant une personne pour laquelle ce produit ferait un cadeau approprié. La valeur par défaut est Null.

Occasion
occasion Occasion

Chaîne énumérée indiquant une occasion pour laquelle ce produit ferait un cadeau approprié. La valeur par défaut est Null.

Style
style array of string

Tableau de chaînes de style pour cette liste, chacune étant une chaîne de texte de forme libre, telle que Formal ou Steampunk. Une description peut avoir jusqu’à deux styles. Les chaînes de style valides contiennent uniquement des lettres, des chiffres et des espaces blancs. (regex : /[^\p{L}\p{Nd}\p{Zs}]/u) La valeur par défaut est Null.

Données de fichier
file_data string

Chaîne décrivant les fichiers attachés à une liste numérique.

A des variantes
has_variations boolean

Lorsque la valeur est true, la liste comporte des variantes.

Doit être renouvelé automatiquement
should_auto_renew boolean

Lorsque la valeur est true, renouvelle une liste pendant quatre mois après l’expriation. Si la valeur est true auparavant false, etsy.com renouvelle la liste avant son expiration, mais la période de renouvellement commence de manière immidiate au lieu d’étendre la date d’expiration de la liste. Tout temps inutilisé restant sur la liste est perdu. Les renouvellements entraînent des frais pour la facture d’un utilisateur.

Language
language string

Balise de langue IETF pour la langue par défaut de la liste. Ex : de, , esen, fr, itplrujanlpt.

Argent
price Money

Représentation d’un montant d’argent.

ID de taxonomie
taxonomy_id integer

ID de taxonomie numérique de la liste. Le vendeur gère la description des ID de taxonomie pour leur magasin. Pour plus d’informations, consultez la taxonomie des vendeurs.

Argent

Représentation d’un montant d’argent.

Nom Chemin d’accès Type Description
Montant
amount integer

Quantité de ces données représentée.

Diviseur
divisor integer

Diviseur pour afficher le montant.

Code monétaire
currency_code string

Code monétaire ISO pour ces données.

ShopListingFile

Fichier associé à une liste numérique.

Nom Chemin d’accès Type Description
ID de fichier de liste
listing_file_id integer

ID numérique unique d’un fichier associé à une liste numérique.

ID de liste
listing_id integer

ID numérique de la liste associée à cette transaction.

Classement
rank integer

Index numérique de la position de l’ordre d’affichage de ce fichier dans la liste, à partir de 1.

Filename
filename string

Chaîne de nom de fichier pour un fichier associé à une liste numérique.

Fichiers
filesize string

Chaîne de taille de format lisible par l’homme pour la taille d’un fichier.

Taille en octets
size_bytes integer

Nombre indiquant la taille d’un fichier, mesurée en octets.

Type de fichier
filetype string

Chaîne de type indiquant le type MIME d’un fichier.

Créer un horodatage
create_timestamp integer

Horodatage numérique unique d’un fichier associé à une liste numérique.

ShopListingFiles

Représente plusieurs ShopListingFiles.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de ShopListingFiles retournés..

Results
results array of ShopListingFile

Tableau de ressources ShopListingFile.

ShopListings

Ensemble de ressources de référencement des magasins.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de ressources de référencement des magasins trouvés.

Results
results array of ShopListing

La boutique répertorie les ressources trouvées.

Utilisateur

Représente un seul utilisateur du site

Nom Chemin d’accès Type Description
ID d’utilisateur
user_id integer

ID numérique d’un utilisateur. Ce numéro est également un ID de magasin valide pour la boutique de l’utilisateur.

Nom de connexion
login_name string

Chaîne de nom de connexion de l’utilisateur.

Adresse de messagerie principale
primary_email string

Chaîne d’adresse e-mail pour l’adresse e-mail principale de l’utilisateur.

Prénom
first_name string

Prénom de l’utilisateur.

Nom de famille
last_name string

Nom de famille de l’utilisateur.

Horodatage créé
create_timestamp integer

Date et heure à laquelle l’utilisateur a créé son compte, en secondes d’époque.

Référencé par l’ID d’utilisateur
referred_by_user_id integer

ID numérique de l’utilisateur qui a référencé cet utilisateur.

Utiliser de nouveaux points de terminaison d’inventaire
use_new_inventory_endpoints boolean

Deprecated. Toujours vrai.

Vendeur
is_seller boolean

True si l’utilisateur est vendeur.

Biographie
bio string

Biographie de l’utilisateur.

Gender
gender string

Le sexe de l’utilisateur.

Mois de naissance
birth_month string

Mois de naissance de l’utilisateur.

Anniversaire
birth_day string

Jour de naissance de l’utilisateur.

Acheter le nombre de transactions
transaction_buy_count integer

Nombre de transactions où l’utilisateur a acheté.

Nombre de transactions vendues
transaction_sold_count integer

Nombre de transactions où l’utilisateur a vendu.

Shop

Un magasin créé par un utilisateur Etsy.

Nom Chemin d’accès Type Description
ID de l’atelier
shop_id integer

ID numérique positif unique non nul pour un magasin Etsy.

ID d’utilisateur
user_id integer

ID d’utilisateur numérique de l’utilisateur propriétaire de cette boutique.

Nom de l’atelier
shop_name string

Chaîne de nom de la boutique.

Date de création
create_date integer

Date et heure de création de cette boutique, en secondes d’époque.

Titre
title string

Une brève chaîne de titre pour la page principale du magasin.

Annonce
announcement string

Chaîne d’annonce aux acheteurs qui s’affichent sur la page d’accueil du magasin.

Code monétaire
currency_code string

Code ISO (alphabétique) pour la devise du magasin. Le magasin affiche tous les prix de cette devise par défaut.

Est en vacances
is_vacation boolean

Quand c’est vrai, ce magasin n’accepte pas les achats.

Message de vacances
vacation_message string

La chaîne de message de la boutique s’affiche lorsque is_vacation a la valeur true.

Message de vente
sale_message string

Chaîne de message envoyée aux utilisateurs qui effectuent un achat à partir de cette boutique.

Message de vente numérique
digital_sale_message string

Chaîne de message envoyée aux utilisateurs qui achètent un article numérique à partir de cette boutique.

Date de mise à jour
update_date integer

Date et heure de la dernière mise à jour de la boutique, en secondes d’époque.

Nombre de listes actives
listing_active_count integer

Nombre de référencements actifs dans le magasin.

Nombre de listes numériques
digital_listing_count integer

Nombre de référencements numériques dans le magasin.

Nom de connexion
login_name string

Chaîne de nom de connexion du propriétaire du magasin.

Accepte les demandes personnalisées
accepts_custom_requests boolean

Lorsque la valeur est true, l’atelier accepte les demandes de personnalisation.

Stratégie d’accueil
policy_welcome string

Chaîne d’accueil de la stratégie du magasin (peut être vide).

Stratégie de paiement
policy_payment string

Chaîne de la stratégie de paiement du magasin (peut être vide).

Stratégie d’expédition
policy_shipping string

Chaîne de stratégie d’expédition du magasin (peut être vide).

Stratégie de remboursement
policy_refunds string

Chaîne de la stratégie de remboursement du magasin (peut être vide).

Stratégies supplémentaires
policy_additional string

Chaîne de stratégies supplémentaires de la boutique (peut être vide).

Informations sur le vendeur
policy_seller_info string

Chaîne d’informations sur le vendeur du magasin (peut être vide).

Date de mise à jour de la stratégie
policy_update_date integer

Date et heure de la dernière mise à jour des stratégies du magasin, en secondes d’époque.

Dispose d’une stratégie de reçu privé
policy_has_private_receipt_info boolean

Lorsque la valeur est true, les reçus de l’UE affichent des informations privées.

A des stratégies non structurées
has_unstructured_policies boolean

Lorsque la valeur est true, la boutique affiche des champs de stratégie non structurés supplémentaires.

Politique de confidentialité
policy_privacy string

Chaîne de politique de confidentialité du magasin (peut être vide).

Vacances Autoreply
vacation_autoreply string

La chaîne de réponse automatique de la boutique s’affiche dans les nouvelles conversations lorsque is_vacation est vraie.

URL
url string

Chaîne d’URL pour cette boutique.

URL de l’image de bannière
image_url_760x100 string

Chaîne d’URL pour l’image de bannière de cette boutique.

Nombre de favoris
num_favorers integer

Nombre d’utilisateurs qui ont marqué ce magasin comme favori.

Languages
languages array of string

Liste des chaînes de langue pour les langues inscrites au magasin.

URL de l’image d’icône
icon_url_fullxfull string

Chaîne d’URL de l’image d’icône de cette boutique.

Utilise des stratégies structurées
is_using_structured_policies boolean

Lorsque la valeur est true, le magasin a accepté à l’aide de stratégies structurées.

A des stratégies structurées intégrées
has_onboarded_structured_policies boolean

Lorsque la valeur est true, la boutique a accepté OU refusé après avoir consulté l’intégration de stratégies structurées.

Lien inclure le formulaire de litige
include_dispute_form_link boolean

Lorsqu’il est vrai, les politiques de cette boutique incluent un lien vers un formulaire de litige en ligne de l’UE.

Est l’extraction directe intégrée
is_direct_checkout_onboarded boolean

Quand c’est vrai, le magasin s’est intégré à Etsy Payments.

L’expédition calculée est éligible
is_calculated_eligible boolean

Lorsque la valeur est true, le magasin est lisible pour les profils d’expédition calculés. (Disponible uniquement aux États-Unis et au Canada)

Est choisi pour la promesse de l’acheteur
is_opted_in_to_buyer_promise boolean

Quand c’est vrai, le magasin a choisi de promettre l’acheteur.

Est basé aux États-Unis
is_shop_us_based boolean

Quand c’est vrai, le magasin est basé aux États-Unis.

Nombre de transactions commerciales
transaction_sold_count integer

Nombre total de transactions de vente pour ce magasin

Expédition à partir de country ISO
shipping_from_country_iso string

Le pays iso le magasin est l’expédition à partir de.

Iso de l’emplacement de l’achat
shop_location_country_iso string

Le pays iso où se trouve le magasin.

Nombre de révisions
review_count integer

Nombre de révisions de référencements de magasins au cours de l’année dernière.

Révision moyenne
review_average double

Évaluation moyenne basée sur les avis des référencements de magasins au cours de l’année dernière.

ListingImage

Url de référence et métadonnées d’une image associée à une description spécifique. Le url_fullxfull paramètre contient l’URL du fichier image binaire de taille complète.

Nom Chemin d’accès Type Description
ID de liste
listing_id integer

ID numérique de la liste associée à cette transaction.

ID d’image de liste
listing_image_id integer

ID numérique de l’image de liste principale pour cette transaction.

Code Hexadécimal
hex_code string

Chaîne webhex pour la couleur moyenne de l’image, en notation webhex.

Valeur rouge
red integer

Valeur rouge numérique égale à la valeur rouge moyenne de l’image, comprise entre 0 et 255 (couleur RVB).

Valeur verte
green integer

Valeur rouge numérique égale à la valeur rouge moyenne de l’image, comprise entre 0 et 255 (couleur RVB).

Valeur bleue
blue integer

Valeur rouge numérique égale à la valeur rouge moyenne de l’image, comprise entre 0 et 255 (couleur RVB).

Valeur Hue
hue integer

Teinte numérique égale à la teinte moyenne de l’image, de 0 à 360 (couleur HSV).

Valeur de saturation
saturation integer

Saturation numérique égale à la saturation moyenne de l’image, de 0 à 100 (couleur HSV).

Valeur de luminosité
brightness integer

La luminosité numérique est égale à la luminosité moyenne de l’image, de 0 à 100 (couleur HSV).

Est noir et blanc
is_black_and_white boolean

Lorsque la valeur est true, l’image est en noir et blanc.

Heure de création
creation_tsz integer

Heure de création de l’image de liste, en secondes d’époque.

Classement
rank integer

Position numérique positive non nulle dans les images affichées dans une liste, avec les images de rang 1 apparaissant dans la position la plus à gauche d’une liste.

URL de l’image 75 x 75
url_75x75 string

Chaîne d’URL pour une miniature de 75 x 75 pixels de l’image.

URL de l’image 170x135
url_170x135 string

Chaîne d’URL pour une miniature de 170 x 135 pixels de l’image.

URL de l’image 570xN
url_570xN string

Chaîne d’URL pour une miniature de l’image, pas plus de 570 pixels de large avec une hauteur variable.

URL de l’image de taille complète
url_fullxfull string

Chaîne d’URL pour l’image de taille complète, jusqu’à 3 000 pixels dans chaque dimension.

Hauteur de l’image de taille complète
full_height integer

Hauteur numérique, mesurée en pixels, de l’image de taille complète référencée dans url_fullxfull.

Largeur de l’image pleine taille
full_width integer

Largeur numérique, mesurée en pixels, de l’image de taille entière référencée dans url_fullxfull.

ListingImages

Représente une liste de ressources d’image de liste, chacune contenant les URL de référence et les métadonnées d’une image.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de résultats.

Results
results array of ListingImage

Liste des ressources demandées.

ListingInventoryWithAssociations

Représentation de l’enregistrement d’inventaire d’une liste unique avec des associations

Nom Chemin d’accès Type Description
Produits
products array of ListingInventoryProduct

Tableau JSON de produits disponibles dans une liste, même s’il n’y a qu’un seul produit. Tous les noms de champs dans les objets blob JSON sont en minuscules.

Prix sur les propriétés
price_on_property array of integer

Tableau d’entiers d’ID de propriété de référencement unique pour les propriétés qui modifient les prix du produit, le cas échéant. Par exemple, si vous facturez des prix spécifiques pour différents produits de taille dans la même liste, ce tableau contient l’ID de propriété pour la taille.

Quantité sur les propriétés
quantity_on_property array of integer

Tableau d’entiers d’ID de propriété de liste unique pour les propriétés qui modifient la quantité des produits, le cas échéant. Par exemple, si vous stockez des quantités spécifiques de produits colorés différents dans la même liste, ce tableau contient l’ID de propriété pour la couleur.

Référence SKU sur les propriétés
sku_on_property array of integer

Tableau d’entiers d’ID de propriété de liste unique pour les propriétés qui modifient la référence SKU du produit, le cas échéant. Par exemple, si vous utilisez des références SKU spécifiques pour différents produits colorés dans la même liste, ce tableau contient l’ID de propriété pour la couleur.

ShopListing
listing ShopListing

Description d’un magasin, qui contient une quantité de produit, un titre, une description, un prix, etc.

ListingInventoryProduct

Représentation d’un produit pour une description.

Nom Chemin d’accès Type Description
Identifiant du produit
product_id integer

ID numérique d’un produit spécifique acheté à partir d’une description.

Référence (SKU)
sku string

Chaîne de référence SKU pour le produit

Est supprimé
is_deleted boolean

Lorsque la valeur est true, quelqu’un a supprimé ce produit.

Offerings
offerings array of ListingInventoryProductOffering

Liste des entrées d’offre de produits pour ce produit.

Valeurs de propriété
property_values array of ListingPropertyValue

Liste des entrées de valeur de propriété pour ce produit.

ListingInventoryProductOffering

Représentation d’une offre pour une description.

Nom Chemin d’accès Type Description
ID d’offre
offering_id integer

ID de l’offre de produit

Quantité
quantity integer

Quantité de l’offre de produit

Est activé
is_enabled boolean

Indique si l’offre peut être présentée aux acheteurs ou non.

Est supprimé
is_deleted boolean

Indique si l’offre a été supprimée ou non.

Argent
price Money

Représentation d’un montant d’argent.

ListingPropertyValue

Représentation des valeurs de données structurées.

Nom Chemin d’accès Type Description
ID de propriété
property_id integer

ID numérique de la propriété.

Nom
property_name string

Nom de la propriété.

ID de mise à l’échelle
scale_id integer

ID numérique de l’échelle (le cas échéant).

Nom de mise à l’échelle
scale_name string

Étiquette utilisée pour décrire l’échelle choisie (le cas échéant).

ID de valeur
value_ids array of integer

ID numériques des valeurs de propriété

Valeurs
values array of string

Valeurs de propriété

ListingInventory

Représentation de l’enregistrement d’inventaire d’une liste unique.

Nom Chemin d’accès Type Description
Produits
products array of ListingInventoryProduct

Tableau JSON de produits disponibles dans une liste, même s’il n’y a qu’un seul produit. Tous les noms de champs dans les objets blob JSON sont en minuscules.

Prix sur les propriétés
price_on_property array of integer

Tableau d’entiers d’ID de propriété de référencement unique pour les propriétés qui modifient les prix du produit, le cas échéant. Par exemple, si vous facturez des prix spécifiques pour différents produits de taille dans la même liste, ce tableau contient l’ID de propriété pour la taille.

Quantité sur les propriétés
quantity_on_property array of integer

Tableau d’entiers d’ID de propriété de liste unique pour les propriétés qui modifient la quantité des produits, le cas échéant. Par exemple, si vous stockez des quantités spécifiques de produits colorés différents dans la même liste, ce tableau contient l’ID de propriété pour la couleur.

Référence SKU sur les propriétés
sku_on_property array of integer

Tableau d’entiers d’ID de propriété de liste unique pour les propriétés qui modifient la référence SKU du produit, le cas échéant. Par exemple, si vous utilisez des références SKU spécifiques pour différents produits colorés dans la même liste, ce tableau contient l’ID de propriété pour la couleur.

ShopListingsWithAssociations

Ensemble de ressources de référencement des magasins avec des associations.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de ressources de référencement des magasins trouvés.

Results
results array of ShopListing

La boutique répertorie les ressources trouvées.

ListingPropertyValues

Représente plusieurs valeurs de propriétés de référencement.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de ressources de référencement des magasins trouvés.

Results
results array of ListingPropertyValue

La boutique répertorie les ressources trouvées.

ShopReceiptTransactions

Ensemble de ressources de transaction de confirmation de magasin

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de ressources de transaction de confirmation de magasin trouvées.

Results
results array of ShopReceiptTransaction

Ressources de transaction de reçu de la boutique trouvées.

ShopReceiptTransaction

Objet de transaction associé à un reçu de magasin. Etsy génère une transaction par référencement acheté comme enregistré sur le reçu de la commande.

Nom Chemin d’accès Type Description
Transaction ID
transaction_id integer

ID numérique unique pour une transaction.

Titre
title string

Chaîne de titre de la description achetée dans cette transaction.

Descriptif
description string

Chaîne de description de la description achetée dans cette transaction.

ID d’utilisateur vendeur
seller_user_id integer

ID d’utilisateur numérique du vendeur dans cette transaction.

ID d’utilisateur de l’acheteur
buyer_user_id integer

ID d’utilisateur numérique de l’acheteur dans cette transaction.

Horodatage créé
create_timestamp integer

Date et heure de création de la transaction, en secondes d’époque.

Horodatage payant
paid_timestamp integer

Date et heure payantes de la transaction, en secondes d’époque.

Horodatage expédié
shipped_timestamp integer

Date et heure d’expédition de la transaction, en secondes d’époque.

Quantité
quantity integer

Quantité numérique de produits achetés dans cette transaction.

ID d’image de liste
listing_image_id integer

ID numérique de l’image de liste principale pour cette transaction.

ID de reçu
receipt_id integer

ID numérique de la réception associée à cette transaction.

Est numérique
is_digital boolean

Lorsque la valeur est true, la transaction a enregistré l’achat d’une description numérique.

Données de fichier
file_data string

Chaîne décrivant les fichiers achetés dans cette transaction.

ID de liste
listing_id integer

ID numérique de la liste associée à cette transaction.

Type de transaction
transaction_type string

Chaîne de type pour la transaction, généralement listant

Identifiant du produit
product_id integer

ID numérique d’un produit spécifique acheté à partir d’une description.

Argent
price Money

Représentation d’un montant d’argent.

Argent
shipping_cost Money

Représentation d’un montant d’argent.

ListingTranslation

Représente les données de traduction d’une description.

Nom Chemin d’accès Type Description
ID de liste
listing_id integer

ID numérique de la description.

Language
language string

Balise de langue IETF (par exemple, « fr ») pour la langue de cette traduction.

Titre
title string

Titre de la description de cette traduction.

Descriptif
description string

Description de la description de cette traduction.

Étiquettes
tags array of string

Balises de la description de cette traduction.

ListingVariationImages

Représente plusieurs images de variantes de liste.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre d’images de variantes.

Results
results array of ListingVariationImage

Résultats des images de variante.

ListingVariationImage

Représentation des associations de variantes et d’images sur une liste.

Nom Chemin d’accès Type Description
ID de propriété
property_id integer

ID numérique de la propriété.

ID de valeur
value_id integer

ID numérique de la valeur.

ID d’image
image_id integer

ID numérique de l’image.

PaymentAccountLedgerEntries

Ensemble de ressources d’entrée de registre de compte de paiement

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de ressources d’entrée de registre de compte de paiement trouvées.

Results
results array of PaymentAccountLedgerEntry

Ressources d’entrée du registre du compte de paiement trouvées.

PaymentAccountLedgerEntry

Représente une entrée dans le registre d’un magasin.

Nom Chemin d’accès Type Description
ID d’entrée
entry_id integer

ID numérique de l’entrée de registre.

ID de registre
ledger_id integer

ID numérique du registre.

Numéro de séquence
sequence_number integer

La séquence permet aux entrées de registre d’être triées chronologiquement. Plus la séquence est élevée, plus l’entrée est récente.

Montant
amount integer

Montant de l’argent crédité au registre.

Monnaie
currency string

Devise de l’entrée sur le registre.

Descriptif
description string

Détaille le type d’entrée du registre : paiement, remboursement, inversion d’un remboursement défaillant, déboursement, remboursement retourné, remboursement, crédit divers, débit divers ou paiement de facture.

Solde
balance integer

Montant de l’argent dans le registre du magasin le moment après l’application de cette entrée.

Date de création
create_date integer

Date et heure de création de l’entrée de registre en secondes d’époque.

Paiements

Représente plusieurs paiements effectués avec Etsy Payments. Tous les montants monétaires sont en centimes USD, sauf indication contraire.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de paiements dans la réponse.

Results
results array of Payment

Liste des paiements.

Paiement

Représente un paiement effectué avec Etsy Payments. Tous les montants monétaires sont en centimes USD, sauf indication contraire.

Nom Chemin d’accès Type Description
ID de paiement
payment_id integer

ID numérique unique pour un paiement à un magasin Etsy spécifique.

ID d’utilisateur de l’acheteur
buyer_user_id integer

ID numérique de l’utilisateur qui a payé l’achat.

ID de l’atelier
shop_id integer

ID numérique positif unique non nul pour un magasin Etsy.

ID de reçu
receipt_id integer

ID numérique de la réception associée à cette transaction.

Argent
amount_gross Money

Représentation d’un montant d’argent.

Argent
amount_fees Money

Représentation d’un montant d’argent.

Argent
amount_net Money

Représentation d’un montant d’argent.

Argent
posted_gross Money

Représentation d’un montant d’argent.

Argent
posted_fees Money

Représentation d’un montant d’argent.

Argent
posted_net Money

Représentation d’un montant d’argent.

Argent
adjusted_gross Money

Représentation d’un montant d’argent.

Argent
adjusted_fees Money

Représentation d’un montant d’argent.

Argent
adjusted_net Money

Représentation d’un montant d’argent.

Monnaie
currency string

Chaîne de code ISO (alphabétique) pour la devise du paiement.

Devise des magasins
shop_currency string

Code ISO (alphabétique) pour la devise du magasin. Le magasin affiche tous les prix de cette devise par défaut.

Devise de l’acheteur
buyer_currency string

Chaîne monétaire de l’acheteur.

ID d’expédition utilisateur
shipping_user_id integer

ID numérique de l’utilisateur auquel le vendeur envoie la commande.

ID d’adresse d’expédition
shipping_address_id integer

ID numérique identifiant l’adresse d’expédition.

ID d’adresse de facturation
billing_address_id integer

ID numérique identifiant l’adresse de facturation de l’acheteur.

Statut
status string

Chaîne indiquant l’état actuel du paiement, le plus souvent réglé ou authentification.

Horodatage expédié
shipped_timestamp integer

Date et heure d’expédition de la transaction, en secondes d’époque.

Horodatage créé
create_timestamp integer

Date et heure de création de la transaction, en secondes d’époque.

Mettre à jour l’horodatage
update_timestamp integer

Date et heure de la dernière modification de l’ajustement du paiement en secondes d’époque.

Ajustements de paiement
payment_adjustments array of PaymentAdjustment

Liste des objets de remboursement sur une transaction Etsy Payments. Tous les montants monétaires sont en centimes USD, sauf indication contraire.

PaymentAdjustment

Représente un remboursement, qui s’applique à un paiement Etsy antérieur. Tous les montants monétaires sont en centimes USD, sauf indication contraire.

Nom Chemin d’accès Type Description
ID d’ajustement du paiement
payment_adjustment_id integer

ID numérique d’un ajustement de paiement.

ID de paiement
payment_id integer

ID numérique unique pour un paiement à un magasin Etsy spécifique.

Statut
status string

Chaîne d’état de l’ajustement du paiement.

Réussite
is_success boolean

Lorsqu’il est vrai, l’ajustement du paiement a été ou est susceptible de se terminer correctement.

ID d’utilisateur
user_id integer

ID numérique de l’utilisateur (vendeur) qui répond à l’achat.

Code de raison
reason_code string

Chaîne lisible par l’homme décrivant la raison du remboursement.

Montant total de l’ajustement
total_adjustment_amount integer

Montant numérique total du remboursement dans la devise de paiement.

Montant total de l’ajustement de l’achat
shop_total_adjustment_amount integer

Montant numérique du remboursement dans la devise du magasin.

Montant total de l’ajustement
buyer_total_adjustment_amount integer

Montant numérique du remboursement dans la devise de l’acheteur.

Montant total de l’ajustement des frais
total_fee_adjustment_amount integer

Montant numérique des frais de traitement de carte associés à un ajustement de paiement.

Horodatage créé
create_timestamp integer

Date et heure de création de la transaction, en secondes d’époque.

Mettre à jour l’horodatage
update_timestamp integer

Date et heure de la dernière modification de l’ajustement du paiement en secondes d’époque.

Puanteur

Confirmation que l’application actuelle a accès à l’API Open

Nom Chemin d’accès Type Description
ID de l'application
application_id integer

ID de l’application authentifiée

ShopReceipt

L’enregistrement d’un achat auprès d’un magasin. Les reçus des magasins affichent des valeurs monétaires à l’aide de la devise du magasin.

Nom Chemin d’accès Type Description
ID de reçu
receipt_id integer

ID numérique de la réception associée à cette transaction.

Type de reçu
receipt_type integer

Valeur numérique pour le canal Etsy qui a servi l’achat : 0 pour Etsy.com, 1 pour un magasin Pattern.

ID d’utilisateur vendeur
seller_user_id integer

ID numérique de l’utilisateur (vendeur) qui répond à l’achat.

Adresse e-mail du vendeur
seller_email string

Chaîne d’adresse e-mail pour le vendeur de la description.

ID d’utilisateur de l’acheteur
buyer_user_id integer

ID numérique de l’utilisateur effectuant l’achat.

Adresse e-mail de l’acheteur
buyer_email string

Chaîne d’adresse e-mail pour l’acheteur de la description.

Nom
name string

Chaîne de nom pour le destinataire dans l’adresse d’expédition.

Première ligne d’adresse
first_line string

Première chaîne de ligne d’adresse pour le destinataire dans l’adresse d’expédition.

Deuxième ligne d’adresse
second_line string

Chaîne de ligne d’adresse secondaire facultative pour le destinataire dans l’adresse d’expédition.

Ville
city string

Chaîne de ville pour le destinataire dans l’adresse d’expédition.

État
state string

Chaîne d’état pour le destinataire dans l’adresse d’expédition.

Code postal
zip string

Chaîne de code postal (pas nécessairement un nombre) pour le destinataire dans l’adresse d’expédition.

Adresse mise en forme
formatted_address string

Chaîne d’adresse d’expédition mise en forme pour le destinataire dans l’adresse d’expédition.

ISO du code du pays
country_iso string

Chaîne de code pays ISO-3166 alpha-2 pour le destinataire dans l’adresse d’expédition.

Mode de paiement
payment_method string

Chaîne de mode de paiement identifiant le mode de paiement de l’acheteur, qui doit être l’un des suivants : 'cc' (carte de crédit), 'PayPal', 'check', 'mo' (money order), 'bt' (transfert bancaire), 'other', 'ideal', 'sofort', 'apple_pay', 'google', 'android_pay', 'google_pay', 'klarna', 'k_pay_in_4' (klarna) ou 'k_financing' (klarna).

Adresse e-mail de paiement
payment_email string

Chaîne d’adresse e-mail pour l’adresse e-mail à laquelle envoyer la confirmation de paiement

Message du vendeur
message_from_seller string

Chaîne de message facultative du vendeur.

Message de l’acheteur
message_from_buyer string

Chaîne de message facultative de l’acheteur.

Message du système de paiement
message_from_payment string

Chaîne d’accusé de réception générée par l’ordinateur à partir du système de paiement.

Est payé
is_paid boolean

Lorsque la valeur est true, l’acheteur a payé cet achat.

Est expédié
is_shipped boolean

Lorsqu’il est vrai, le vendeur a expédié les produits.

Horodatage créé
create_timestamp integer

Heure de création du reçu, en secondes d’époque.

Mettre à jour l’horodatage
update_timestamp integer

Heure de la dernière mise à jour de la réception, en secondes d’époque.

Message cadeau
gift_message string

Chaîne de message cadeau que l’acheteur demande remise avec le produit.

Argent
grandtotal Money

Représentation d’un montant d’argent.

Argent
subtotal Money

Représentation d’un montant d’argent.

Argent
total_price Money

Représentation d’un montant d’argent.

Argent
total_shipping_cost Money

Représentation d’un montant d’argent.

Argent
total_tax_cost Money

Représentation d’un montant d’argent.

Argent
total_vat_cost Money

Représentation d’un montant d’argent.

Argent
discount_amt Money

Représentation d’un montant d’argent.

Argent
gift_wrap_price Money

Représentation d’un montant d’argent.

Expéditions
shipments array of ShopReceiptShipment

Liste des relevés d’expédition pour ce reçu.

ShopReceiptShipment

Enregistrement d’un événement d’expédition pour un ShopReceipt. Un reçu peut avoir de nombreux enregistrements ShopReceiptShipment.

Nom Chemin d’accès Type Description
ID d’expédition des reçus
receipt_shipping_id integer

ID numérique unique d’un enregistrement d’expédition de reçu du magasin.

Horodatage de notification d’expédition
shipment_notification_timestamp integer

Heure à laquelle Etsy a informé l’acheteur de l’événement d’expédition, en secondes d’époque.

Nom de l’opérateur
carrier_name string

Chaîne de nom pour le transporteur/société responsable de la livraison de l’expédition.

Code de suivi
tracking_code string

Chaîne de code de suivi fournie par le transporteur/l’entreprise pour l’expédition.

ShopReceipts

Les reçus d’un magasin spécifique.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de reçus de magasin trouvés.

Results
results array of ShopReceipt

Liste des ressources de confirmation de la boutique trouvées, avec tous les champs reçus de la boutique pour chaque ressource.

TransactionReviews

Ensemble d’enregistrements de révision des transactions laissés par les utilisateurs.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de ressources TransactionReview trouvées.

Results
results array of TransactionReview

Ressources TransactionReview trouvées.

TransactionReview

Enregistrement de révision des transactions laissé par un utilisateur.

Nom Chemin d’accès Type Description
ID de l’atelier
shop_id integer

ID numérique du magasin.

ID de liste
listing_id integer

ID de la liste des magasins auxquels le TransactionReview appartient.

ID d’utilisateur de l’acheteur
buyer_user_id integer

ID numérique de l’utilisateur qui était l’acheteur dans cette transaction. Remarque : Ce champ peut être absent, en fonction des paramètres de confidentialité de l’acheteur.

Notation
rating integer

Valeur d’évaluation à l’échelle comprise entre 1 et 5

Passer en revue le message
review string

Message laissé par l’auteur, expliquant les commentaires.

Language
language string

Langue de TransactionReview

URL complète de l’image
image_url_fullxfull string

URL d’une photo fournie avec les commentaires, dimensions fullxfull. Remarque : Ce champ peut être absent, en fonction des paramètres de confidentialité de l’acheteur.

Horodatage créé
create_timestamp integer

Date et heure de création de TransactionReview en secondes d’époque.

Mettre à jour l’horodatage
update_timestamp integer

Date et heure de la mise à jour de TransactionReview en secondes d’époque.

SellerTaxonomyNodes

Liste des nœuds de taxonomie de l’arborescence de taxonomie vendeur.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de résultats.

Results
results array of SellerTaxonomyNode

Liste des ressources demandées.

SellerTaxonomyNode

Nœud de taxonomie dans l’arborescence de taxonomie vendeur.

Nom Chemin d’accès Type Description
ID
id integer

ID numérique unique d’un nœud de taxonomie Etsy, qui est une catégorie de métadonnées pour les descriptions organisées dans l’arborescence de hiérarchie de taxonomie vendeur. Par exemple, le nœud de taxonomie des chaussures (ID : 1429, niveau : 1) est plus élevé dans la hiérarchie que les chaussures des filles (ID : 1440, niveau : 2). Les nœuds de taxonomie affectés à une liste prennent en charge l’accès à des échelles et propriétés de produits standardisées spécifiques. Par exemple, les listes affectées aux chaussures de nœuds de taxonomie ou les chaussures de filles prennent en charge l’accès à l’échelle de la taille des chaussures de l’UE avec ses noms de propriété et ID associés pour les tailles de chaussures de l’UE, telles que la propriété value_id:1394 et name:38.

Level
level integer

Profondeur entière de ce nœud de taxonomie dans l’arborescence de taxonomie vendeur, avec des racines au niveau 0.

Nom
name string

Chaîne de nom pour ce nœud de taxonomie.

Parent ID
parent_id integer

ID de taxonomie numérique du parent de ce nœud.

Enfants
children array of SellerTaxonomyNode

Tableau de nœuds de taxonomie pour tous les enfants directs de ce nœud de taxonomie dans l’arborescence taxanomyie vendeur.

ID de chemin de taxonomie
full_path_taxonomy_ids array of integer

Tableau d’ID de taxonomie incluant ce nœud et tous ses parents directs dans l’arborescence de taxonomie vendeur jusqu’à un nœud racine. Ils sont répertoriés dans l’ordre de racine à feuille.

TaxonomyNodeProperties

Liste des définitions de propriétés de produit.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de résultats.

Results
results array of TaxonomyNodeProperty

Liste des ressources demandées.

TaxonomyNodeProperty

Définition de propriété de produit.

Nom Chemin d’accès Type Description
ID de propriété
property_id integer

ID numérique unique de cette propriété de produit.

Nom
name string

Chaîne de nom pour ce nœud de taxonomie.

Nom d’affichage
display_name string

Chaîne de nom de propriété de produit lisible par l’homme.

Balance
scales array of TaxonomyPropertyScale

Liste des échelles disponibles.

Est requis
is_required boolean

Lorsque la valeur est true, les ID de taxonomie éligibles attribués nécessitent cette propriété.

Prend en charge les attributs
supports_attributes boolean

Lorsque la valeur est true, vous pouvez utiliser cette propriété dans la liste des attributs.

Prend en charge les variantes
supports_variations boolean

Lorsque la valeur est true, vous pouvez utiliser cette propriété dans la liste des variantes.

Est multivalué
is_multivalued boolean

Lorsque la valeur est true, vous pouvez affecter plusieurs valeurs de propriété à cette propriété

Valeurs possibles
possible_values array of TaxonomyPropertyValue

Liste des chaînes de valeur de propriété prises en charge pour cette propriété.

Valeurs sélectionnées
selected_values array of TaxonomyPropertyValue

Liste des chaînes de valeur de propriété automatiquement et toujours sélectionnée pour la propriété donnée.

TaxonomyPropertyScale

Échelle défnining les incréments assignables pour les valeurs de propriété disponibles pour des propriétés de produit spécifiques.

Nom Chemin d’accès Type Description
ID de mise à l’échelle
scale_id integer

ID numérique unique d’une échelle.

Nom d’affichage
display_name string

Chaîne de nom pour une échelle.

Descriptif
description string

Chaîne de description d’une échelle.

TaxonomyPropertyValue

Valeur de propriété pour une propriété de produit spécifique, qui peut également utiliser une échelle spécifique.

Nom Chemin d’accès Type Description
ID de valeur
value_id integer

ID numérique de cette valeur de propriété.

Nom
name string

Chaîne de nom de cette valeur de propriété.

ID de mise à l’échelle
scale_id integer

ID d’échelle numérique de l’échelle à laquelle appartient cette valeur de propriété.

Égal à
equal_to array of integer

Une liste d’ID de valeur de propriété numérique est égale à (le cas échéant).

ShippingCarriers

Représente plusieurs ShippingCarriers.

Nom Chemin d’accès Type Description
count
count integer
results
results array of ShippingCarrier

ShippingCarrier

Un transporteur maritime pris en charge, utilisé pour calculer une date de livraison estimée.

Nom Chemin d’accès Type Description
ID du transporteur d’expédition
shipping_carrier_id integer

ID numérique de ce transporteur d’expédition.

Nom
name string

Nom de ce transporteur maritime.

Classes domestiques
domestic_classes array of ShippingCarrierMailClass

Ensemble de classes de courrier domestiques de ce transporteur maritime.

Classes internationales
international_classes array of ShippingCarrierMailClass

Ensemble de classes de courrier internationales de ce transporteur d’expédition.

ShippingCarrierMailClass

Classe de courrier d’un transporteur maritime, utilisée pour calculer une date de livraison estimée.

Nom Chemin d’accès Type Description
ID de classe de messagerie
mail_class_key string

Identificateur unique de cette classe de messagerie.

Nom
name string

Nom de cette classe de messagerie.

Magasins

Ensemble d’enregistrements shop.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre total de magasins

Results
results array of Shop

Ressources de la boutique.

ShopSection

Section d’une boutique dans laquelle un utilisateur peut trier les listes.

Nom Chemin d’accès Type Description
ID de section magasin
shop_section_id integer

ID numérique d’une section dans un magasin Etsy spécifique.

Titre
title string

Chaîne de titre d’une section de magasin.

Classement
rank integer

Position numérique positive non nulle de cette section dans l’ordre d’affichage de la section pour un magasin, avec le rang 1 sections apparaissant en premier.

ID d’utilisateur
user_id integer

ID numérique de l’utilisateur propriétaire de cette section de magasin.

Nombre de listes actives
active_listing_count integer

Nombre de référencements actifs dans une section d’une boutique Etsy spécifique.

ShopSections

Toutes les sections d’un magasin sprecific.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de résultats.

Results
results array of ShopSection

Liste des ressources demandées.

ShopShippingProfile

Représente un profil utilisé pour définir les informations d’expédition d’une liste. Notez qu’il n’est pas possible de créer des modèles d’expédition calculés via l’API. Toutefois, vous pouvez associer des profils d’expédition calculés créés à partir de Shop Manager à des descriptions à l’aide de l’API.

Nom Chemin d’accès Type Description
ID du profil d’expédition
shipping_profile_id integer

ID numérique du profil d’expédition.

Titre
title string

Chaîne de nom de ce profil d’expédition.

ID d’utilisateur
user_id integer

ID numérique de l’utilisateur propriétaire du profil d’expédition.

Jours de traitement minimum
min_processing_days integer

Nombre minimal de jours pour le traitement de la liste.

Nombre maximal de jours de traitement
max_processing_days integer

Nombre maximal de jours pour le traitement de la liste.

Étiquette de jours de traitement
processing_days_display_label string

Chaîne d’étiquette d’affichage traduite pour les jours de traitement.

ISO du pays d’origine
origin_country_iso string

Code ISO du pays à partir duquel la liste est fournie.

Est supprimé
is_deleted boolean

Lorsque la valeur est true, quelqu’un a supprimé ce profil d’expédition.

Destinations de profil d’expédition
shipping_profile_destinations array of ShopShippingProfileDestination

Liste des destinations de profil d’expédition disponibles pour ce profil d’expédition.

Mises à niveau de profil d’expédition
shipping_profile_upgrades array of ShopShippingProfileUpgrade

Liste des mises à niveau de profil d’expédition disponibles pour ce profil d’expédition.

Code postal d’origine
origin_postal_code string

Chaîne de code postal (pas nécessairement un nombre) pour l’emplacement à partir duquel la liste est fournie.

Type de Profil
profile_type ProfileType

ShopShippingProfileDestination

Représente une destination d’expédition affectée à un profil d’expédition.

Nom Chemin d’accès Type Description
ID de destination du profil d’expédition
shipping_profile_destination_id integer

ID numérique de la destination du profil d’expédition dans le profil d’expédition associé à la description.

ID du profil d’expédition
shipping_profile_id integer

ID numérique du profil d’expédition.

ISO du pays d’origine
origin_country_iso string

Code ISO du pays à partir duquel la liste est fournie.

ISO du pays de destination
destination_country_iso string

Code ISO du pays auquel la liste est fournie. Si la valeur est Null, la requête définit la destination sur destination_region

DestinationRegion
destination_region DestinationRegion

Code de la région à laquelle la liste est fournie. Une région représente un ensemble de pays. Les régions prises en charge sont l’Union européenne et l’Union non-Europe (pays d’Europe non dans l’UE). Si ce n’est pas le cas, la requête définit la destination sur destination_country_iso, ou partout si destination_country_iso est également null

Argent
primary_cost Money

Représentation d’un montant d’argent.

Argent
secondary_cost Money

Représentation d’un montant d’argent.

ID du transporteur d’expédition
shipping_carrier_id integer

ID unique d’un transporteur maritime pris en charge, utilisé pour calculer une date de livraison estimée.

Mail, classe
mail_class string

Chaîne d’ID unique de la classe de messagerie d’un transporteur maritime, utilisée pour calculer une date de livraison estimée.

Jours de livraison minimum
min_delivery_days integer

Le nombre minimal de jours ouvrables qu’un acheteur peut s’attendre à recevoir son article acheté une fois qu’il a été expédié.

Nombre maximal de jours de livraison
max_delivery_days integer

Le nombre maximal de jours ouvrables qu’un acheteur peut s’attendre à recevoir son article acheté une fois qu’il a été expédié.

ShopShippingProfileUpgrade

Représentation d’une option de mise à niveau de profil d’expédition.

Nom Chemin d’accès Type Description
ID du profil d’expédition
shipping_profile_id integer

ID numérique du profil d’expédition de base.

ID de mise à niveau
upgrade_id integer

ID numérique associé à une mise à niveau d’expédition

Nom de la mise à niveau
upgrade_name string

Nom de la mise à niveau de l’expédition affichée aux acheteurs lors de l’achat, par exemple la priorité USPS.

Type
type Type

Type de mise à niveau de l’expédition. National (0) ou international (1).

Classement
rank integer

Position numérique positive non nulle dans les images affichées dans une liste, avec les images de rang 1 apparaissant dans la position la plus à gauche d’une liste.

Language
language string

Balise de langue IETF pour la langue du profil d’expédition. Ex : de, en, es, fr, it, ja, nl, pl, pt, ru.

Argent
price Money

Représentation d’un montant d’argent.

Argent
secondary_price Money

Représentation d’un montant d’argent.

ID du transporteur d’expédition
shipping_carrier_id integer

ID unique d’un transporteur maritime pris en charge, utilisé pour calculer une date de livraison estimée.

Mail, classe
mail_class string

Chaîne d’ID unique de la classe de messagerie d’un transporteur maritime, utilisée pour calculer une date de livraison estimée.

Jours de livraison minimum
min_delivery_days integer

Le nombre minimal de jours ouvrables qu’un acheteur peut s’attendre à recevoir son article acheté une fois qu’il a été expédié.

Nombre maximal de jours de livraison
max_delivery_days integer

Le nombre maximal de jours ouvrables qu’un acheteur peut s’attendre à recevoir son article acheté une fois qu’il a été expédié.

ShopShippingProfileDestinations

Représente une liste d’objets de destination d’expédition.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de résultats.

Results
results array of ShopShippingProfileDestination

Liste des ressources demandées.

ShopShippingProfileUpgrades

Liste des options de mise à niveau d’expédition.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre de résultats.

Results
results array of ShopShippingProfileUpgrade

Liste des ressources demandées.

UserAddress

Représente l’adresse d’un utilisateur.

Nom Chemin d’accès Type Description
ID d’adresse utilisateur
user_address_id integer

ID numérique de l’adresse de l’utilisateur.

ID d’utilisateur
user_id integer

ID numérique de l’utilisateur.

Nom
name string

Nom de l’utilisateur pour cette adresse.

Première ligne d’adresse
first_line string

Première ligne de l’adresse de l’utilisateur.

Deuxième ligne d’adresse
second_line string

Deuxième ligne de l’adresse de l’utilisateur.

Ville
city string

Champ ville de l’adresse de l’utilisateur.

État
state string

Champ d’état de l’adresse de l’utilisateur.

Code postal
zip string

Champ de code postal de l’adresse de l’utilisateur.

ISO du code du pays
iso_country_code string

Code ISO du pays dans cette adresse.

Pays
country_name string

Nom du pays de l’utilisateur.

Adresse d’expédition par défaut
is_default_shipping_address boolean

Adresse d’expédition par défaut de l’utilisateur.

UserAddresses

Représente plusieurs enregistrements UserAddress.

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre d’enregistrements UserAddress retournés.

Results
results array of UserAddress

Tableau de ressources UserAddress.

DestinationRegion

Code de la région à laquelle la liste est fournie. Une région représente un ensemble de pays. Les régions prises en charge sont l’Union européenne et l’Union non-Europe (pays d’Europe non dans l’UE). Si ce n’est pas le cas, la requête définit la destination sur destination_country_iso, ou partout si destination_country_iso est également null

Code de la région à laquelle la liste est fournie. Une région représente un ensemble de pays. Les régions prises en charge sont l’Union européenne et l’Union non-Europe (pays d’Europe non dans l’UE). Si ce n’est pas le cas, la requête définit la destination sur destination_country_iso, ou partout si destination_country_iso est également null

DestinationRegion
string

ItemDimensionsUnit

Chaîne définissant les unités utilisées pour mesurer les dimensions du produit. La valeur par défaut est Null.

Chaîne définissant les unités utilisées pour mesurer les dimensions du produit. La valeur par défaut est Null.

ItemDimensionsUnit
string

ItemWeightUnit

Chaîne définissant les unités utilisées pour mesurer le poids du produit. La valeur par défaut est Null.

Chaîne définissant les unités utilisées pour mesurer le poids du produit. La valeur par défaut est Null.

ItemWeightUnit
string

Occasion

Chaîne énumérée indiquant une occasion pour laquelle ce produit ferait un cadeau approprié. La valeur par défaut est Null.

Chaîne énumérée indiquant une occasion pour laquelle ce produit ferait un cadeau approprié. La valeur par défaut est Null.

Occasion
string

Type de Profil

Type de Profil
string

Recipient

Chaîne énumérée indiquant une personne pour laquelle ce produit ferait un cadeau approprié. La valeur par défaut est Null.

Chaîne énumérée indiquant une personne pour laquelle ce produit ferait un cadeau approprié. La valeur par défaut est Null.

Recipient
string

État

Chaîne énumérée de l’un des éléments suivants : actif ou inactif. Remarque : la définition d’un brouillon de liste sur active publiera également la description sur etsy.com.

Chaîne énumérée de l’un des éléments suivants : actif ou inactif. Remarque : la définition d’un brouillon de liste sur active publiera également la description sur etsy.com.

État
integer

Type

Type de mise à niveau de l’expédition. National (0) ou international (1).

Type de mise à niveau de l’expédition. National (0) ou international (1).

Type
integer

WhenMade

Chaîne énumérée pour l’ère dans laquelle le fabricant a fait le produit dans cette liste. Aide les acheteurs à localiser la description sous l’en-tête Vintage. Nécessite « is_supply » et « who_made ».

Chaîne énumérée pour l’ère dans laquelle le fabricant a fait le produit dans cette liste. Aide les acheteurs à localiser la description sous l’en-tête Vintage. Nécessite « is_supply » et « who_made ».

WhenMade
string

WhoMade

Chaîne énumérée inidcatée qui a fait le produit. Aide les acheteurs à localiser la description sous le titre Handmade. Nécessite « is_supply » et « when_made ».

Chaîne énumérée inidcatée qui a fait le produit. Aide les acheteurs à localiser la description sous le titre Handmade. Nécessite « is_supply » et « when_made ».

WhoMade
string