Freigeben über


Publisher (Independent Publisher)

Dieser Connector verwendet Ihren API-Schlüssel, um auf verschiedene Etsy.com Features zuzugreifen. Es unterstützt Aktionen für Bestand, Verkaufsaufträge und Shopverwaltung. Alle Aktionen basieren auf der Api Für Die Offenen Api von Markup v3, die Endpunkte enthält, die sich noch in der Betaversion befinden. Wenn z. B. Aktionen die Beta-API verwenden, gibt die Aktion mit "Beta" in den Titel ein und gibt den Antwortcode 501 zurück.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Connectormetadaten
Herausgeber Troy Taylor, Hitachi Solutions
Webseite https://www.etsy.com/
Datenschutzrichtlinie https://www.etsy.com/legal/privacy/
Kategorien Handel

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
API-Schlüssel securestring Der API-Schlüssel für diese API Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen aller Eintragsdateien

Ruft alle Dateien ab, die dem angegebenen digitalen Eintrag zugeordnet sind. Das Anfordern von Dateien aus einer physischen Auflistung gibt ein leeres Ergebnis zurück.

Abrufen der Adresse des Benutzers

Ruft die Adresse des Benutzers ab. Die Entwicklung für diesen Endpunkt wird ausgeführt. Es wird nur eine 501-Antwort zurückgegeben.

Abrufen der Bilder eines Eintrags

Ruft alle Eintragsbildressourcen für eine Auflistung mit einer bestimmten Eintrags-ID ab.

Abrufen der Eigenschaft eines Eintrags (Beta)

Ruft die Eigenschaft eines Eintrags ab. Die Entwicklung für diesen Endpunkt wird ausgeführt. Es wird nur eine 501-Antwort zurückgegeben.

Abrufen der Eigenschaften eines Eintrags

Gibt eine Liste der Eigenschaften eines Eintrags zurück.

Abrufen der Einträge eines Shop-Zahlungskontos

Rufen Sie die Einträge des Zahlungskontos eines Shops ab.

Abrufen der Transaktion eines Belegs

Ruft die Liste der Transaktionen ab, die einem bestimmten Beleg zugeordnet sind.

Abrufen der Transaktion eines Shops

Ruft die Liste der Transaktionen ab, die einem Shop zugeordnet sind.

Abrufen der Transaktionen eines Eintrags

Ruft die Liste der Transaktionen ab, die mit einer Auflistung verknüpft sind.

Abrufen der Variationsbilder des Eintrags

Ruft alle Variationsbilder in einer Auflistung ab.

Abrufen der Übersetzung eines Eintrags

Gibt die Übersetzung für eine Auflistung in der angegebenen Sprache zurück.

Abrufen des Inventars eines Eintrags

Ruft den Bestandsdatensatz für einen Eintrag ab. Einträge, die Sie nicht mit den Etsy.com Bestandstools bearbeitet haben, weisen keine Bestandsdatensätze auf. Dieser Endpunkt gibt SKU-Daten zurück, wenn Sie der Besitzer der abgerufenen Bestandsdatensätze sind.

Abrufen einer Bestätigung

Ruft einen Beleg, der durch eine Beleg-ID identifiziert wird, aus einem Webshop ab.

Abrufen einer Datei aus einem Eintrag

Ruft eine einzelne Datei ab, die dem angegebenen digitalen Eintrag zugeordnet ist. Das Anfordern einer Datei aus einer physischen Auflistung gibt ein leeres Ergebnis zurück.

Abrufen einer Liste von Zahlungen

Ruft eine Liste der Zahlungen aus einem Shop ab, der durch die Shop-ID identifiziert wird. Sie können auch Ergebnisse mithilfe einer Liste von Zahlungs-IDs filtern.

Abrufen einer Transaktion

Ruft eine Transaktion nach Transaktions-ID ab.

Abrufen einer Zahlung aus einem bestimmten Beleg

Ruft eine Zahlung von einem bestimmten Beleg ab, der anhand der Beleg-ID identifiziert wird, aus einem bestimmten Shop, der durch die Shop-ID identifiziert wird.

Abrufen einer Zahlung aus einer Zahlungskonto-Eintrags-ID

Erhalten Sie bei Bedarf eine Zahlung aus einer Zahlungskonto-Eintrags-ID.

Abrufen eines Eintrags

Ruft einen Eintragsdatensatz nach Eintrags-ID ab.

Abrufen eines Eintragsbilds

Ruft die Verweise und Metadaten für ein Eintragsbild mit einer bestimmten Bild-ID ab.

Abrufen eines Versandprofils

Ruft ein Versandprofil ab, auf das anhand der Versandprofil-ID verwiesen wird.

Abrufen von Benutzeradressen

Dient zum Abrufen einer Liste von Benutzeradressen.

Abrufen von Bestätigungen

Fordert die Shopbestätigungen von einem bestimmten Shop an, ungefiltert oder gefiltert nach Beleg-ID-Bereich oder Offset, Datum, bezahlten und/oder versendeten Einkäufen.

Abrufen von Einträgen nach ID

Ermöglicht das Gleichzeitige Abfragen mehrerer Eintrags-IDs. Maximal 100 IDs pro Abfrage begrenzen.

Abrufen von Einträgen nach Shop-Abschnitts-ID

Ruft alle Einträge aus dem Abschnitt eines bestimmten Shops ab.

Abrufen von Einträgen nach Shopbestätigung

Ruft alle Auflistungen ab, die einem Beleg zugeordnet sind.

Abrufen von Produkteigenschaften nach Taxonomie-ID

Ruft eine Liste der Produkteigenschaften mit anwendbaren Skalierungen und Werten ab, die für eine bestimmte Verkäufertaxonomie-ID unterstützt werden.

Abrufen von Profilzielen nach Versandprofil

Ruft eine Liste der Versandzielobjekte ab, die einem Versandprofil zugeordnet sind.

Abrufen von Rezensionen

Ruft die Rezensionen aus einem Shop ab, der seine ID erhält.

Abrufen von Verkäufertaxonomieknoten

Ruft die vollständige Hierarchiestruktur der Verkäufertaxonomieknoten ab.

Abrufen von Versandprofilen

Ruft eine Liste von Versandprofilen ab, die in dem spezifischen Shop verfügbar sind, der durch seine Shop-ID identifiziert wird.

Abrufen von Versandprofilupgrades

Ruft die Liste der Versandprofilupgrades ab, die einem bestimmten Versandprofil zugewiesen sind.

Aktive Angebote nach Shop abrufen

Ruft eine Liste aller aktiven Auflistungen auf Listings in einem bestimmten Shop ab, paginiert nach Eintragserstellungsdatum.

Aktive Auflistungen abrufen

Eine Liste aller aktiven Auflistungen auf Paginierung nach ihrem Erstellungsdatum. Ohne Sortierreihenfolgenauflistungen wird standardmäßig die neueste Reihenfolge zurückgegeben.

Aktualisieren der Variationsbilder eines Eintrags

Erstellt Variationsbilder in einer Auflistung.

Aktualisieren des Inventars eines Eintrags

Aktualisiert den Bestand für einen Eintrag, der durch eine Eintrags-ID identifiziert wird. Das Update schlägt fehl, wenn die angegebenen Werte für die Produkt-SKU, das Angebot der Menge und/oder der Preis mit Werten in Eigenschaftsfeldern nicht kompatibel sind. Weisen Sie beim Festlegen eines Preises einen Gleitkommawert zu, der durch divisor divisor geteilt wird, wie in der Geldressource angegeben.

Aktualisieren einer Eintragseigenschaft

Aktualisiert oder füllt die Eigenschaftenliste auf, die Produktangebote für einen Eintrag definiert. Jedes Angebot erfordert sowohl einen Wert als auch eine Wert-ID, die für eine Skalierungs-ID gültig ist, die dem Eintrag zugewiesen ist oder sie mit dieser Anforderung dem Eintrag zuweisen.

Aktualisieren einer Eintragsübersetzung

Aktualisiert eine Eintragsübersetzung durch Eintrags-ID und Sprache.

Aktualisieren eines Eintrags

Aktualisiert einen Eintrag, der durch eine Eintrags-ID identifiziert wird, für einen bestimmten Shop, der durch eine Shop-ID identifiziert wird.

Aktualisieren eines Shops

Aktualisieren Sie einen Shop. Geht davon aus, dass alle Zeichenfolgenparameter in der primären Sprache des Shops bereitgestellt werden.

Aktualisieren eines Versandprofils

Ändert die Einstellungen in einem Versandprofil.

Aktualisieren eines Versandprofilupgrades

Aktualisiert ein Upgrade des Versandprofils und aktualisiert alle Einträge, die das Versandprofil verwenden.

Aktualisieren eines Versandprofilziels

Aktualisiert ein vorhandenes Versandziel, das die Versandkosten, den Netzbetreiber und die Klasse für ein Ziel festlegen oder neu zuweisen kann.

Angebot eines Eintrags abrufen

Erhalten Sie ein Angebot für einen Eintrag.

Angebote nach Shop abrufen

Gibt Angebote zurück, die zu einem Shop gehören. Auflistungen können mithilfe des Zustandsparameters gefiltert werden.

Benutzer abrufen

Gibt das Benutzerprofil für den von einer Benutzer-ID identifizierten Benutzer zurück.

Empfohlene Angebote nach Shop abrufen

Ruft Einträge ab, die einem Shop zugeordnet sind, der angeboten wird.

Erstellen einer Eintragsübersetzung

Erstellt eine Eintragsübersetzung durch Eintrags-ID und Sprache.

Erstellen eines Entwurfseintrags

Erstellt ein physisches Eintragsprodukt in einem Shop auf dem Channel von Aspx.

Erstellen eines Shopabschnitts

Erstellt einen neuen Abschnitt in einem bestimmten Shop.

Erstellen eines Versandbelegs

Übermittelt Nachverfolgungsinformationen für einen Shopbeleg, der einen Shopbestätigungseintrag für die angegebene Beleg-ID erstellt. Jedes Mal, wenn Sie Tracking-Informationen erfolgreich übermitteln, sendet Emails eine Benachrichtigungs-E-Mail an den Käuferbenutzer. Wenn das Senden von BCC zutrifft, sendet Gesendete Versandbenachrichtigungen auch an den Verkäufer. Wenn der Sendungsverfolgungscode und der Name des Netzbetreibers nicht gesendet werden, wird der Beleg nur als versendet markiert.

Erstellen eines Versandprofils

Erstellt ein neues Versandprofil. Sie können beim Erstellen eines Versandprofils einen ISO-Code oder eine Region des Landes übergeben, aber nicht beides. Nur eine ist erforderlich. Sie müssen entweder eine Versandträger-ID und eine E-Mail-Klasse oder min. und max. Liefertage übergeben.

Erstellen eines Versandprofilupgrades

Erstellt ein neues Versandprofilupgrade, das einen Preis für eine Versandoption festlegen kann, z. B. ein alternativer Versandunternehmen oder eine schnellere Lieferung.

Erstellen eines Versandprofilziels

Erstellt ein neues Versandziel, das die Versandkosten, den Versandunternehmen und die Klasse für ein Ziel in einem Versandprofil festlegt. Dies weist Kosten unter Verwendung der Währung des zugehörigen Shops zu. Legen Sie das Ziel entweder mithilfe von Zielland ISO oder Zielregion fest; Zielland ISO und Zielregion schließen sich gegenseitig aus – legen Sie eine oder die andere fest. Das Festlegen beider Trigger löst Fehler 400 aus. Wenn die Anforderung weder die Zielland-ISO noch die Zielregion festlegt, ist das Standardziel überall. Sie müssen entweder sowohl eine Versandträger-ID als auch eine E-Mail-Klasse oder min. Liefertage und max. Liefertage zuweisen.

Hochladen einer Eintragsdatei

Lädt eine neue Datei für einen digitalen Eintrag hoch oder ordnet eine vorhandene Datei einem bestimmten Eintrag zu. Sie müssen entweder die Eintragsdatei-ID einer vorhandenen Datei oder den Namen und die Binärdateidaten für eine Datei angeben, die hochgeladen werden soll. Durch das Zuordnen einer vorhandenen Datei zu einem physischen Eintrag wird die physische Auflistung in eine digitale Auflistung umgewandelt, wodurch alle Versandkosten und alle Produkt- und Bestandsvariationen entfernt werden.

Hochladen eines Eintragsbilds

Lädt ein Bild hoch oder weist es einem Eintrag zu, der durch eine Shop-ID mit einer Eintrags-ID identifiziert wird. Um ein neues Bild hochzuladen, legen Sie die Bilddatei als Wert für den Bildparameter fest. Sie können einem Eintrag mithilfe der Bild-ID des gelöschten Bilds im Parameter "Eintragsbild-ID" ein zuvor gelöschtes Bild zuweisen. Wenn eine Anforderung sowohl Bild- als auch Eintrags-ID-Parameterwerte enthält, lädt der Endpunkt das Bild nur in den Bildparameter hoch.

Laden nach Besitzer-ID abrufen

Ruft den Shop ab, der von der Benutzer-ID des Shopbesitzers identifiziert wird.

Ladenabschnitte abrufen

Ruft die Liste der Shopabschnitte in einem bestimmten Shop ab, der durch die Shop-ID identifiziert wird.

Löschen einer Datei aus der Auflistung

Wenn Sie die endgültige Datei für einen digitalen Eintrag löschen, wird der Eintrag in eine physische Auflistung konvertiert. Die Antwort auf eine Löschanforderung gibt eine Liste der verbleibenden Dateidatensätze zurück, die dem angegebenen Eintrag zugeordnet sind.

Löschen einer Eintragseigenschaft

Löscht eine Eigenschaft aus einer Auflistung.

Löschen eines Eintrags

Diese Aktion löscht einen Shopeintrag. Eine Auflistung kann nur gelöscht werden, wenn der Status eine der folgenden Ist: SOLD_OUT, ENTWURF, ABGELAUFEN, INACTIVE, ACTIVE und is_available oder ACTIVE und hat Verkäuferkennzeichnungen: SUPRESSED (fixiert), URLAUB, CUSTOM_SHOPS (Muster), SELL_ON_FACEBOOK

Löschen eines Eintragsbilds

Löscht ein Eintragsbild. Eine Kopie der Datei bleibt auf unseren Servern erhalten, sodass ein gelöschtes Bild dem Eintrag zugeordnet werden kann, ohne das ursprüngliche Bild erneut hochzuladen.

Löschen eines Versandprofils

Löscht ein Versandprofil anhand der angegebenen ID.

Löschen eines Versandprofilupgrades

Löscht ein Upgrade des Versandprofils und entfernt die Upgradeoption aus jeder Auflistung, die das zugeordnete Versandprofil verwendet.

Löschen eines Versandprofilziels

Löscht ein Versandziel und entfernt die Zieloption aus jedem Eintrag, der das zugeordnete Versandprofil verwendet. Ein Versandprofil erfordert mindestens ein Versandziel, sodass dieser Endpunkt das endgültige Versandziel für jedes Versandprofil nicht löschen kann. Um das endgültige Versandziel aus einem Versandprofil zu löschen, müssen Sie das gesamte Versandprofil löschen.

Ping

Überprüfen Sie, ob Sie die Verbindung mit der Api von Reiseroute mit einer Anwendung bestätigen.

Produkt eines Eintrags abrufen

Abrufen eines Eintragsprodukts nach ID.

Shop-Abschnitt abrufen

Ruft einen Shopabschnitt ab, auf den nach Abschnitts-ID und Shop-ID verwiesen wird.

Shops durchsuchen

Gibt eine Liste von Geschäften mit dem übereinstimmenden Namen zurück.

Versandunternehmen abrufen

Ruft eine Liste der verfügbaren Versandunternehmen und die ihnen zugeordneten E-Mail-Klassen für ein bestimmtes Land ab.

Abrufen aller Eintragsdateien

Ruft alle Dateien ab, die dem angegebenen digitalen Eintrag zugeordnet sind. Das Anfordern von Dateien aus einer physischen Auflistung gibt ein leeres Ergebnis zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eintrags-ID
listing_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Gibt zurück

Stellt mehrere ShopListingFiles dar.

ShopListingFiles
ShopListingFiles

Abrufen der Adresse des Benutzers

Ruft die Adresse des Benutzers ab. Die Entwicklung für diesen Endpunkt wird ausgeführt. Es wird nur eine 501-Antwort zurückgegeben.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzeradressen-ID
user_address_id True integer

Die numerische ID der Adresse des Benutzers.

Gibt zurück

Stellt die Adresse eines Benutzers dar.

UserAddress
UserAddress

Abrufen der Bilder eines Eintrags

Ruft alle Eintragsbildressourcen für eine Auflistung mit einer bestimmten Eintrags-ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Gibt zurück

Stellt eine Liste der Listenbildressourcen dar, die jeweils die Referenz-URLs und Metadaten für ein Bild enthalten.

ListingImages
ListingImages

Abrufen der Eigenschaft eines Eintrags (Beta)

Ruft die Eigenschaft eines Eintrags ab. Die Entwicklung für diesen Endpunkt wird ausgeführt. Es wird nur eine 501-Antwort zurückgegeben.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eigenschaften-ID
property_id True integer

Die eindeutige ID einer Auflistungseigenschaft von Listing.

Gibt zurück

Eine Darstellung strukturierter Datenwerte.

ListingPropertyValue
ListingPropertyValue

Abrufen der Eigenschaften eines Eintrags

Gibt eine Liste der Eigenschaften eines Eintrags zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Gibt zurück

Stellt mehrere Auflistungseigenschaftswerte dar.

ListingPropertyValues
ListingPropertyValues

Abrufen der Einträge eines Shop-Zahlungskontos

Rufen Sie die Einträge des Zahlungskontos eines Shops ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Mindestens erstellt
min_created True integer

Der früheste Unix-Zeitstempel für den Zeitpunkt der Erstellung eines Datensatzes.

Maximal erstellt
max_created True integer

Der neueste Unix-Zeitstempel für den Zeitpunkt der Erstellung eines Datensatzes.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Gibt zurück

Eine Reihe von Zahlungskonto-Eintragsressourcen

PaymentAccountLedgerEntries
PaymentAccountLedgerEntries

Abrufen der Transaktion eines Belegs

Ruft die Liste der Transaktionen ab, die einem bestimmten Beleg zugeordnet sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eingangskennung
receipt_id True integer

Die numerische ID für den Beleg, der dieser Transaktion zugeordnet ist.

Gibt zurück

Eine Reihe von Transaktionsressourcen für Den Shopbeleg

ShopReceiptTransactions
ShopReceiptTransactions

Abrufen der Transaktion eines Shops

Ruft die Liste der Transaktionen ab, die einem Shop zugeordnet sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Gibt zurück

Eine Reihe von Transaktionsressourcen für Den Shopbeleg

ShopReceiptTransactions
ShopReceiptTransactions

Abrufen der Transaktionen eines Eintrags

Ruft die Liste der Transaktionen ab, die mit einer Auflistung verknüpft sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Gibt zurück

Eine Reihe von Transaktionsressourcen für Den Shopbeleg

ShopReceiptTransactions
ShopReceiptTransactions

Abrufen der Variationsbilder des Eintrags

Ruft alle Variationsbilder in einer Auflistung ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Gibt zurück

Stellt mehrere Auflistungsvariationsbilder dar.

ListingVariationImages
ListingVariationImages

Abrufen der Übersetzung eines Eintrags

Gibt die Übersetzung für eine Auflistung in der angegebenen Sprache zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Language
language True string

Das IETF-Sprachtag für die Sprache dieser Übersetzung. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru.

Gibt zurück

Stellt die Übersetzungsdaten für einen Eintrag dar.

ListingTranslation
ListingTranslation

Abrufen des Inventars eines Eintrags

Ruft den Bestandsdatensatz für einen Eintrag ab. Einträge, die Sie nicht mit den Etsy.com Bestandstools bearbeitet haben, weisen keine Bestandsdatensätze auf. Dieser Endpunkt gibt SKU-Daten zurück, wenn Sie der Besitzer der abgerufenen Bestandsdatensätze sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Includes
includes string

Eine aufgezählte Zeichenfolge, die eine gültige Zuordnung anfügt.

Gibt zurück

Eine Darstellung des Bestandsdatensatzes eines einzelnen Eintrags mit Zuordnungen

ListingInventoryWithAssociations
ListingInventoryWithAssociations

Abrufen einer Bestätigung

Ruft einen Beleg, der durch eine Beleg-ID identifiziert wird, aus einem Webshop ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eingangskennung
receipt_id True integer

Die numerische ID für den Beleg, der dieser Transaktion zugeordnet ist.

Gibt zurück

Die Aufzeichnung eines Einkaufs aus einem Shop. Shopbestätigungen zeigen Geldwerte mithilfe der Währung des Shops an.

ShopReceipt
ShopReceipt

Abrufen einer Datei aus einem Eintrag

Ruft eine einzelne Datei ab, die dem angegebenen digitalen Eintrag zugeordnet ist. Das Anfordern einer Datei aus einer physischen Auflistung gibt ein leeres Ergebnis zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eintragsdatei-ID
listing_file_id True integer

Die eindeutige numerische ID einer Datei, die einem digitalen Eintrag zugeordnet ist.

Gibt zurück

Eine Datei, die einer digitalen Auflistung zugeordnet ist.

ShopListingFile
ShopListingFile

Abrufen einer Liste von Zahlungen

Ruft eine Liste der Zahlungen aus einem Shop ab, der durch die Shop-ID identifiziert wird. Sie können auch Ergebnisse mithilfe einer Liste von Zahlungs-IDs filtern.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Zahlungs-ID
payment-ids True string

Ein durch Trennzeichen getrenntes Array von Zahlungs-IDs.A comma-separated array of Payment IDs numbers.

Gibt zurück

Stellt mehrere Zahlungen dar, die mit Payment Payments getätigt wurden. Alle geldpolitischen Beträge sind in USD Pennies, sofern nicht anders angegeben.

Zahlungen
Payments

Abrufen einer Transaktion

Ruft eine Transaktion nach Transaktions-ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Buchungskennung
transaction_id True integer

Die eindeutige numerische ID für eine Transaktion.

Gibt zurück

Ein Transaktionsobjekt, das einer Shopbestätigung zugeordnet ist. Das Unternehmen generiert eine Transaktion pro Gekaufter Eintrag, wie er auf dem Bestelleingang erfasst wurde.

ShopReceiptTransaction
ShopReceiptTransaction

Abrufen einer Zahlung aus einem bestimmten Beleg

Ruft eine Zahlung von einem bestimmten Beleg ab, der anhand der Beleg-ID identifiziert wird, aus einem bestimmten Shop, der durch die Shop-ID identifiziert wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eingangskennung
receipt_id True string

Die numerische ID für den Beleg, der dieser Transaktion zugeordnet ist.

Gibt zurück

Stellt mehrere Zahlungen dar, die mit Payment Payments getätigt wurden. Alle geldpolitischen Beträge sind in USD Pennies, sofern nicht anders angegeben.

Zahlungen
Payments

Abrufen einer Zahlung aus einer Zahlungskonto-Eintrags-ID

Erhalten Sie bei Bedarf eine Zahlung aus einer Zahlungskonto-Eintrags-ID.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Ledger-Eintrags-IDs
ledger_entry_ids True string

Array von ganzzahligen Zahlen.

Gibt zurück

Stellt mehrere Zahlungen dar, die mit Payment Payments getätigt wurden. Alle geldpolitischen Beträge sind in USD Pennies, sofern nicht anders angegeben.

Zahlungen
Payments

Abrufen eines Eintrags

Ruft einen Eintragsdatensatz nach Eintrags-ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Includes
includes string

Eine aufgezählte Zeichenfolge, die eine gültige Zuordnung anfügt. Akzeptable Eingaben sind "Shop", "Bilder" und "Benutzer".

Abrufen eines Eintragsbilds

Ruft die Verweise und Metadaten für ein Eintragsbild mit einer bestimmten Bild-ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eintragsbild-ID
listing_image_id True integer

Die numerische ID des primären Eintragsbilds für diese Transaktion.

Gibt zurück

Referenz-URLs und Metadaten für ein Bild, das einer bestimmten Auflistung zugeordnet ist. Der url_fullxfull Parameter enthält die URL für die Binärbilddatei in voller Größe.

ListingImage
ListingImage

Abrufen eines Versandprofils

Ruft ein Versandprofil ab, auf das anhand der Versandprofil-ID verwiesen wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Abrufen von Benutzeradressen

Dient zum Abrufen einer Liste von Benutzeradressen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Gibt zurück

Stellt mehrere UserAddress-Einträge dar.

UserAddresses
UserAddresses

Abrufen von Bestätigungen

Fordert die Shopbestätigungen von einem bestimmten Shop an, ungefiltert oder gefiltert nach Beleg-ID-Bereich oder Offset, Datum, bezahlten und/oder versendeten Einkäufen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Mindestens erstellt
min_created integer

Der früheste Unix-Zeitstempel für den Zeitpunkt der Erstellung eines Datensatzes.

Maximal erstellt
max_created integer

Der neueste Unix-Zeitstempel für den Zeitpunkt der Erstellung eines Datensatzes.

Früheste letzte Änderung
min_last_modified integer

Der früheste Unix-Zeitstempel für den Zeitpunkt der letzten Änderung eines Datensatzes.

Letzte Änderung
max_last_modified integer

Der neueste Unix-Zeitstempel für den Zeitpunkt der letzten Änderung eines Datensatzes.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Wurde bezahlt
was_paid boolean

Wenn wahr, erhielt der Verkäufer die Zahlung für die Produkte in diesem Beleg.

Wurde ausgeliefert
was_shipped boolean

Wenn dies der Fall ist, hat der Verkäufer das Produkt(n) in diesem Beleg versandt.

Gibt zurück

Die Belege für einen bestimmten Shop.

ShopReceipts
ShopReceipts

Abrufen von Einträgen nach ID

Ermöglicht das Gleichzeitige Abfragen mehrerer Eintrags-IDs. Maximal 100 IDs pro Abfrage begrenzen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Auflisten von IDs
listing_ids True string

Das Array numerischer IDs für die Auflistungen in einem bestimmten Webshop.

Includes
includes string

Eine aufgezählte Zeichenfolge, die eine gültige Zuordnung anfügt.

Gibt zurück

Eine Reihe von Shopauflistungsressourcen mit Zuordnungen.

ShopListingsWithAssociations
ShopListingsWithAssociations

Abrufen von Einträgen nach Shop-Abschnitts-ID

Ruft alle Einträge aus dem Abschnitt eines bestimmten Shops ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Abschnitts-IDs
shop_section_ids True string

Ein Array numerischer IDs für alle Abschnitte in einem bestimmten Markup-Shop.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Sortieren nach
sort_on string

Der Wert, nach dem ein Suchergebnis von Auflistungen sortiert werden soll.

Sortierreihenfolge
sort_order string

Die Reihenfolge aufsteigend(oben) oder absteigend(unten) zum Sortieren von Auflistungen nach.

Gibt zurück

Eine Reihe von Shopauflistungsressourcen.

ShopListings
ShopListings

Abrufen von Einträgen nach Shopbestätigung

Ruft alle Auflistungen ab, die einem Beleg zugeordnet sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die numerische ID für den Beleg, der dieser Transaktion zugeordnet ist.

Eingangskennung
receipt_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Gibt zurück

Eine Reihe von Shopauflistungsressourcen.

ShopListings
ShopListings

Abrufen von Produkteigenschaften nach Taxonomie-ID

Ruft eine Liste der Produkteigenschaften mit anwendbaren Skalierungen und Werten ab, die für eine bestimmte Verkäufertaxonomie-ID unterstützt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Taxonomie-ID
taxonomy_id True string

Die eindeutige numerische ID eines Taxonomieknotens vom Typ "Taxonomie", bei dem es sich um eine Metadatenkategorie für Auflistungen handelt, die in der Hierarchiestruktur der Verkäufertaxonomie organisiert sind.

Gibt zurück

Eine Liste der Produkteigenschaftendefinitionen.

TaxonomyNodeProperties
TaxonomyNodeProperties

Abrufen von Profilzielen nach Versandprofil

Ruft eine Liste der Versandzielobjekte ab, die einem Versandprofil zugeordnet sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Gibt zurück

Stellt eine Liste der Zielobjekte des Versands dar.

ShopShippingProfileDestinations
ShopShippingProfileDestinations

Abrufen von Rezensionen

Ruft die Rezensionen aus einem Shop ab, der seine ID erhält.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Gibt zurück

Eine Gruppe von Transaktionsüberprüfungsdatensätzen, die von Benutzern hinterlassen werden.

TransactionReviews
TransactionReviews

Abrufen von Verkäufertaxonomieknoten

Ruft die vollständige Hierarchiestruktur der Verkäufertaxonomieknoten ab.

Gibt zurück

Eine Liste der Taxonomieknoten aus der Verkäufertaxonomiestruktur.

SellerTaxonomyNodes
SellerTaxonomyNodes

Abrufen von Versandprofilen

Ruft eine Liste von Versandprofilen ab, die in dem spezifischen Shop verfügbar sind, der durch seine Shop-ID identifiziert wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Gibt zurück

Stellt ein Profil dar, das zum Festlegen der Versandinformationen eines Eintrags verwendet wird. Bitte beachten Sie, dass es nicht möglich ist, berechnete Versandvorlagen über die API zu erstellen. Sie können jedoch berechnete Versandprofile, die von Shop Manager erstellt wurden, mit Auflistungen mithilfe der API verknüpfen.

ShopShippingProfile
ShopShippingProfile

Abrufen von Versandprofilupgrades

Ruft die Liste der Versandprofilupgrades ab, die einem bestimmten Versandprofil zugewiesen sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Gibt zurück

Eine Liste der Versandupgradeoptionen.

ShopShippingProfileUpgrades
ShopShippingProfileUpgrades

Aktive Angebote nach Shop abrufen

Ruft eine Liste aller aktiven Auflistungen auf Listings in einem bestimmten Shop ab, paginiert nach Eintragserstellungsdatum.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Includes
keywords string

Suchbegriff oder Ausdruck, der in allen Ergebnissen angezeigt werden muss.

Gibt zurück

Eine Reihe von Shopauflistungsressourcen.

ShopListings
ShopListings

Aktive Auflistungen abrufen

Eine Liste aller aktiven Auflistungen auf Paginierung nach ihrem Erstellungsdatum. Ohne Sortierreihenfolgenauflistungen wird standardmäßig die neueste Reihenfolge zurückgegeben.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Includes
keywords string

Suchbegriff oder Ausdruck, der in allen Ergebnissen angezeigt werden muss.

Sortieren nach
sort_on string

Der Wert, nach dem ein Suchergebnis von Auflistungen sortiert werden soll. HINWEIS: Die Sortierung funktioniert nur, wenn sie mit einer der Suchoptionen (Schlüsselwörter, Region usw.) kombiniert wird.

Sortierreihenfolge
sort_order string

Die Reihenfolge aufsteigend(oben) oder absteigend(unten) zum Sortieren von Auflistungen nach. HINWEIS: sort_order funktioniert nur in Kombination mit einer der Suchoptionen (Schlüsselwörter, Region usw.).

Mindestpreis
min_price float

Der Mindestpreis der Auflistungen, die von einem Suchergebnis zurückgegeben werden sollen.

Höchstpreis
max_price float

Der maximale Preis der Auflistungen, die von einem Suchergebnis zurückgegeben werden sollen.

Taxonomie-ID
taxonomy_id integer

Die numerische Taxonomie-ID des Eintrags. Der Verkäufer verwaltet die Listentaxonomie-IDs für seinen Shop.

Shopstandort
shop_location string

Filtert nach Shopstandort. Wenn der Standort nicht analysiert werden kann, antwortet Microsoft mit einem Fehler.

Gibt zurück

Eine Reihe von Shopauflistungsressourcen.

ShopListings
ShopListings

Aktualisieren der Variationsbilder eines Eintrags

Erstellt Variationsbilder in einer Auflistung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Variationsbilder
variation_images True string

Ein Array von Variationsbilddaten.

Gibt zurück

Stellt mehrere Auflistungsvariationsbilder dar.

ListingVariationImages
ListingVariationImages

Aktualisieren des Inventars eines Eintrags

Aktualisiert den Bestand für einen Eintrag, der durch eine Eintrags-ID identifiziert wird. Das Update schlägt fehl, wenn die angegebenen Werte für die Produkt-SKU, das Angebot der Menge und/oder der Preis mit Werten in Eigenschaftsfeldern nicht kompatibel sind. Weisen Sie beim Festlegen eines Preises einen Gleitkommawert zu, der durch divisor divisor geteilt wird, wie in der Geldressource angegeben.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eintrags-ID
listing_id True string

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Products
products True string

Ein JSON-Array von Produkten, die in einer Auflistung verfügbar sind, auch wenn nur ein Produkt vorhanden ist. Alle Feldnamen in den JSON-Blobs sind Kleinbuchstaben.

Preis für Eigenschaft
price_on_property string

Ein Array eindeutiger Auflistungseigenschaften-ID-Ganzzahlen für die Eigenschaften, die produktpreise ändern, falls vorhanden. Wenn Sie z. B. bestimmte Preise für produkte unterschiedlicher Größe in derselben Auflistung berechnen, enthält dieses Array die Eigenschafts-ID für die Größe.

Menge auf Eigenschaft
quantity_on_property string

Ein Array eindeutiger Auflistungseigenschaften-ID-Ganzzahlen für die Eigenschaften, die die Menge der Produkte ändern, falls vorhanden. Wenn Sie z. B. bestimmte Mengen verschiedener farbiger Produkte in derselben Auflistung auf lageren, enthält dieses Array die Eigenschafts-ID für Farbe.

SKU on-Eigenschaft
sku_on_property string

Ein Array eindeutiger Auflistungseigenschaften-ID-Ganzzahlen für die Eigenschaften, die die Produkt-SKU ändern, falls vorhanden. Wenn Sie z. B. bestimmte Skus für verschiedene farbige Produkte in derselben Auflistung verwenden, enthält dieses Array die Eigenschafts-ID für Farbe.

Gibt zurück

Eine Darstellung des Bestandsdatensatzes eines einzelnen Eintrags.

ListingInventory
ListingInventory

Aktualisieren einer Eintragseigenschaft

Aktualisiert oder füllt die Eigenschaftenliste auf, die Produktangebote für einen Eintrag definiert. Jedes Angebot erfordert sowohl einen Wert als auch eine Wert-ID, die für eine Skalierungs-ID gültig ist, die dem Eintrag zugewiesen ist oder sie mit dieser Anforderung dem Eintrag zuweisen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eigenschaften-ID
property_id True integer

Die eindeutige ID einer Auflistungseigenschaft von Listing.

Wert-IDs
value_ids True integer

Die numerische ID einer einzelnen Etsy.com Maßskala.

Werte
values True string

Ein Array von Wertzeichenfolgen für mehrere Auflistungseigenschaftswerte von Auflistungen von Auflistungseigenschaften.

Skalierungs-ID
scale_id integer

Die numerische ID einer einzelnen Etsy.com Maßskala.

Gibt zurück

Eine Darstellung strukturierter Datenwerte.

ListingPropertyValue
ListingPropertyValue

Aktualisieren einer Eintragsübersetzung

Aktualisiert eine Eintragsübersetzung durch Eintrags-ID und Sprache.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Language
language True string

Das IETF-Sprachtag für die Sprache dieser Übersetzung. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru.

Title
title True string

Der Titel der Auflistung dieser Übersetzung.

Description
description True string

Die Beschreibung der Auflistung dieser Übersetzung.

Stichwörter
tags string

Die Tags der Auflistung dieser Übersetzung.

Gibt zurück

Stellt die Übersetzungsdaten für einen Eintrag dar.

ListingTranslation
ListingTranslation

Aktualisieren eines Eintrags

Aktualisiert einen Eintrag, der durch eine Eintrags-ID identifiziert wird, für einen bestimmten Shop, der durch eine Shop-ID identifiziert wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Menge
quantity integer

Die positive Nicht-Null-Anzahl der Produkte, die im Eintrag erworben werden können.

Title
title string

Titelzeichenfolge des Eintrags. Gültige Titelzeichenfolgen enthalten nur Buchstaben, Zahlen, Satzzeichen, mathematische Symbole, Leerzeichen, ™ , , © und ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Sie können die zeichen %, :, & und + nur einmal verwenden.

Description
description string

Eine Beschreibungszeichenfolge des Produkts für den Verkauf in der Auflistung.

Preis
price float

Der positive Nicht-Null-Preis des Produkts. (Verkaufte Produktauflistungen sind privat) Hinweis: Der Preis ist der mindest mögliche Preis.

Wer gemacht hat
who_made string

Eine Zeichenfolge, die das Produkt erstellt hat. Hilft Käufern, den Eintrag unter der Handgemachten Überschrift zu finden. Erfordert "is_supply" und "when_made".

Wann gemacht
when_made string

Eine Zeichenfolge für die Ära, in der der Hersteller das Produkt in diesem Eintrag gemacht hat. Hilft Käufern, den Eintrag unter der Vintage-Überschrift zu finden. Erfordert "is_supply" und "who_made".

Taxonomie-ID
taxonomy_id integer

Die numerische Taxonomie-ID des Eintrags. Der Verkäufer verwaltet die Listentaxonomie-IDs für seinen Shop.

Versandprofil-ID
shipping_profile_id integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Materials
materials string

Eine Reihe von Materialzeichenfolgen für Materialien, die im Produkt verwendet werden. Gültige Materialzeichenfolgen enthalten nur Buchstaben, Zahlen und Leerzeichen. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)

Shopabschnitts-ID
shop_section_id integer

Die numerische ID des Shopabschnitts für diesen Eintrag.

Mindestverarbeitung
processing_min integer

Die mindeste Anzahl von Tagen, die zum Verarbeiten dieser Auflistung erforderlich sind.

Maximale Verarbeitung
processing_max integer

Die maximale Anzahl von Tagen, die zum Verarbeiten dieser Auflistung erforderlich sind.

Stichwörter
tags string

Ein Array von Tagzeichenfolgen für die Auflistung. Gültige Tagzeichenfolgen enthalten nur Buchstaben, Zahlen, Leerzeichen, -, ", ™ , © und ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)

Recipient
recipient string

Eine Zeichenfolge, die eine Person angibt, für die dieses Produkt ein geeignetes Geschenk machen würde.

Gelegenheit
occasion string

Eine Zeichenfolge, die eine Gelegenheit angibt, für die dieses Produkt ein geeignetes Geschenk machen würde.

Styles
styles string

Ein Array von Formatvorlagenzeichenfolgen für diese Auflistung, von denen jede Freiformtextzeichenfolge wie Formal oder Steampunk ist. Eine Auflistung kann bis zu zwei Formatvorlagen aufweisen. Gültige Formatvorlagenzeichenfolgen enthalten nur Buchstaben, Zahlen und Leerzeichen. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)

Elementgewichtung
item_weight float

Die numerische Gewichtung des Produkts, das in Einheiten gemessen wird, die in der Gewichtseinheit des Artikels festgelegt sind.

Elementlänge
item_length integer

Die numerische Länge des Produkts, das in Einheiten gemessen wird, die in elementdimensionseinheit festgelegt sind.

Elementbreite
item_width float

Die numerische Breite des Produkts, das in Einheiten gemessen wird, die in "Elementabmessungen Einheit" festgelegt sind.

Elementhöhe
item_height float

Die numerische Höhe des Produkts, das in Einheiten gemessen wird, die in "Elementdimensionseinheit" festgelegt sind.

Gewichtseinheit für Artikel
item_weight_unit string

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Gewichtung des Produkts verwendet werden.

Elementdimensionseinheit
item_dimensions_unit string

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Abmessungen des Produkts verwendet werden.

Ist personalisierbar
is_personalizable boolean

Wenn dies der Fall ist, ist diese Auflistung personalisierbar.

Bild-IDs
image_ids string

Ein Array numerischer Bild-IDs der Bilder in einer Auflistung, die bis zu 10 Bilder enthalten kann.

Is Supply
is_supply boolean

Wenn "true" ist, wird der Eintrag als Lieferprodukt markiert, andernfalls wird angegeben, dass es sich um ein fertiges Produkt ist. Hilft Käufern, den Eintrag unter der Überschrift "Lieferungen" zu finden. Erfordert "wer gemacht" und "wann gemacht".

Ist anpassbar
is_customizable boolean

Wenn dies der Fall ist, kann ein Käufer den Verkäufer für einen angepassten Auftrag kontaktieren. Der Standardwert ist true, wenn ein Shop benutzerdefinierte Bestellungen annimmt. Gilt nicht für Geschäfte, die keine benutzerdefinierten Bestellungen akzeptieren.

Steuerpflichtig
is_taxable boolean

Ist dies der Fall, gelten die anwendbaren Shopsteuersätze für diesen Eintrag beim Auschecken.

Empfohlene Rangfolge
featured_ rank integer

Die positive Nicht-Null-Numerische Position in den empfohlenen Auflistungen des Shops mit Rang 1 Auflistungen, die in der links meisten Position in der empfohlenen Auflistung auf der Startseite eines Shops angezeigt werden.

Sollte automatisch verlängert werden
should_auto_renew boolean

Wenn wahr, verlängert eine Auflistung für vier Monate nach Enteignung. Wenn dieser Wert auf "true" festgelegt ist, verlängert etsy.com den Eintrag, bevor er abläuft, aber der Verlängerungszeitraum beginnt unaufrichtig, anstatt das Ablaufdatum des Eintrags zu erweitern. Nicht verwendete Zeit für den Eintrag geht verloren. Verlängerungen führen zu Gebühren für die Rechnung eines Benutzers.

Typ
type string

Gibt an, ob es sich bei der Auflistung um einen physischen oder digitalen Download handelt.

Kanäle
channels string

Ein Array mit aufgezählten Kanal-ID-Zeichenfolgen. Ein Kanal ist ein Ort für Verkäufer, um Käufer zu erreichen, um Verkäufe zu tätigen.

Gibt zurück

Ein Eintrag aus einem Shop, der eine Produktmenge, Titel, Beschreibung, Preis usw. enthält.

ShopListing
ShopListing

Aktualisieren eines Shops

Aktualisieren Sie einen Shop. Geht davon aus, dass alle Zeichenfolgenparameter in der primären Sprache des Shops bereitgestellt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Title
title string

Eine kurze Überschriftenzeichenfolge für die Hauptseite des Shops.

Ankündigung
announcement string

Eine Ankündigungszeichenfolge für Käufer, die auf der Homepage des Shops angezeigt werden.

Verkaufsnachricht
sale_message string

Eine Nachrichtenzeichenfolge, die an Benutzer gesendet wird, die einen Kauf von diesem Shop abschließen.

Digitale Verkaufsnachricht
digital_sale_message string

Eine Nachrichtenzeichenfolge, die an Benutzer gesendet wird, die einen digitalen Artikel aus diesem Shop kaufen.

Gibt zurück

Ein Shop, der von einem Benutzer von Users erstellt wurde.

Shop
Shop

Aktualisieren eines Versandprofils

Ändert die Einstellungen in einem Versandprofil.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Title
title string

Die Namenszeichenfolge dieses Versandprofils.

Ursprungsland ISO
origin_country_iso string

Der ISO-Code des Landes, aus dem der Eintrag ausgeliefert wird.

Minimale Verarbeitungszeit
min_processing_time integer

Die mindeste Zeit, die erforderlich ist, um Einträge mit diesem Versandprofil zu versenden.

Maximale Verarbeitungszeit
max_processing_time integer

Die maximale Verarbeitungszeit, die die Auflistung versenden muss.

Verarbeitungszeiteinheit
processing_time_unit string

Die Einheit, die verwendet wird, um darzustellen, wie lange eine Verarbeitungszeit ist. Eine Woche entspricht 5 Werktagen. Wenn keine angegeben wird, wird die Einheit auf business_days festgelegt.

Origin Postleitzahl
origin_postal_code string

Die Postleitzahlenzeichenfolge (nicht unbedingt eine Zahl) für den Standort, von dem der Eintrag ausgeliefert wird.

Gibt zurück

Stellt ein Profil dar, das zum Festlegen der Versandinformationen eines Eintrags verwendet wird. Bitte beachten Sie, dass es nicht möglich ist, berechnete Versandvorlagen über die API zu erstellen. Sie können jedoch berechnete Versandprofile, die von Shop Manager erstellt wurden, mit Auflistungen mithilfe der API verknüpfen.

ShopShippingProfile
ShopShippingProfile

Aktualisieren eines Versandprofilupgrades

Aktualisiert ein Upgrade des Versandprofils und aktualisiert alle Einträge, die das Versandprofil verwenden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Upgrade-ID
upgrade_id True integer

Die numerische ID, die einem Versandupgrade zugeordnet ist

Typ
type string

Der Typ des Versandupgrades. Inland (0) oder international (1).

Upgradename
upgrade_name string

Name für das Versandupgrade, das käufern beim Auschecken angezeigt wird, z. B. USPS Priority.

Preis
price float

Zusätzliche Kosten für das Hinzufügen des Versandupgrades.

Sekundärer Preis
secondary_price float

Zusätzliche Kosten für das Hinzufügen des Versandupgrades für jeden zusätzlichen Artikel.

Versandnetzbetreiber-ID
shipping_carrier_id integer

Die eindeutige ID eines unterstützten Versandunternehmens, das zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Mail-Klasse
mail_class string

Die eindeutige ID-Zeichenfolge der E-Mail-Klasse eines Versandunternehmens, die zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Mindestzustelltage
min_delivery_days integer

min_delivery_days

Maximale Lieferzeit
max_delivery_days integer

Die maximale Anzahl von Werktagen, die ein Käufer erwarten kann, bis er seinen gekauften Artikel erhält, sobald er ausgeliefert wurde.

Gibt zurück

Eine Darstellung einer Upgradeoption für das Versandprofil.

ShopShippingProfileUpgrade
ShopShippingProfileUpgrade

Aktualisieren eines Versandprofilziels

Aktualisiert ein vorhandenes Versandziel, das die Versandkosten, den Netzbetreiber und die Klasse für ein Ziel festlegen oder neu zuweisen kann.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True string

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Ziel-ID des Versandprofils
shipping_profile_destination_id True string

Die numerische ID des Versandprofilziels, das der Auflistung zugeordnet ist.

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

Gibt zurück

Stellt ein Versandziel dar, das einem Versandprofil zugewiesen ist.

ShopShippingProfileDestination
ShopShippingProfileDestination

Angebot eines Eintrags abrufen

Erhalten Sie ein Angebot für einen Eintrag.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Produkt-ID
product_id True integer

Die numerische ID für das Produkt, das dieser Transaktion zugeordnet ist.

Produktangebots-ID
product_offering_id True integer

Die numerische ID für das Produktangebot, das dieser Transaktion zugeordnet ist.

Gibt zurück

Eine Darstellung eines Angebots für einen Eintrag.

ListingInventoryProductOffering
ListingInventoryProductOffering

Angebote nach Shop abrufen

Gibt Angebote zurück, die zu einem Shop gehören. Auflistungen können mithilfe des Zustandsparameters gefiltert werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Staat
State string

Eine aufgezählte Zeichenfolge aus einer von: aktiv oder inaktiv.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Sortieren nach
Sort On string

Der Wert, nach dem ein Suchergebnis von Auflistungen sortiert werden soll.

Sortierreihenfolge
Sort Order string

Die Reihenfolge aufsteigend(oben) oder absteigend(unten) zum Sortieren von Auflistungen nach.

Gibt zurück

Eine Reihe von Shopauflistungsressourcen.

ShopListings
ShopListings

Benutzer abrufen

Gibt das Benutzerprofil für den von einer Benutzer-ID identifizierten Benutzer zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer-ID
user_id True integer

Die eindeutige positive nicht null numerische ID für einen Benutzer.

Gibt zurück

Stellt einen einzelnen Benutzer der Website dar.

Benutzer
User

Empfohlene Angebote nach Shop abrufen

Ruft Einträge ab, die einem Shop zugeordnet sind, der angeboten wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Gibt zurück

Eine Reihe von Shopauflistungsressourcen.

ShopListings
ShopListings

Erstellen einer Eintragsübersetzung

Erstellt eine Eintragsübersetzung durch Eintrags-ID und Sprache.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Language
language True string

Das IETF-Sprachtag für die Sprache dieser Übersetzung. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru.

Title
title True string

Der Titel der Auflistung dieser Übersetzung.

Description
description True string

Die Beschreibung der Auflistung dieser Übersetzung.

Stichwörter
tags string

Die Tags der Auflistung dieser Übersetzung.

Gibt zurück

Stellt die Übersetzungsdaten für einen Eintrag dar.

ListingTranslation
ListingTranslation

Erstellen eines Entwurfseintrags

Erstellt ein physisches Eintragsprodukt in einem Shop auf dem Channel von Aspx.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Menge
quantity True integer

Die positive Nicht-Null-Anzahl der Produkte, die im Eintrag erworben werden können.

Title
title True string

Titelzeichenfolge des Eintrags. Gültige Titelzeichenfolgen enthalten nur Buchstaben, Zahlen, Satzzeichen, mathematische Symbole, Leerzeichen, ™ , , © und ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Sie können die zeichen %, :, & und + nur einmal verwenden.

Description
description True string

Eine Beschreibungszeichenfolge des Produkts für den Verkauf in der Auflistung.

Preis
price True float

Der positive Nicht-Null-Preis des Produkts. (Verkaufte Produktauflistungen sind privat) Hinweis: Der Preis ist der mindest mögliche Preis.

Wer gemacht hat
who_made True string

Eine Zeichenfolge, die das Produkt erstellt hat. Hilft Käufern, den Eintrag unter der Handgemachten Überschrift zu finden. Erfordert "is_supply" und "when_made".

Wann gemacht
when_made string

Eine Zeichenfolge für die Ära, in der der Hersteller das Produkt in diesem Eintrag gemacht hat. Hilft Käufern, den Eintrag unter der Vintage-Überschrift zu finden. Erfordert "is_supply" und "who_made".

Taxonomie-ID
taxonomy_id True integer

Die numerische Taxonomie-ID des Eintrags. Der Verkäufer verwaltet die Listentaxonomie-IDs für seinen Shop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Materials
materials string

Eine Reihe von Materialzeichenfolgen für Materialien, die im Produkt verwendet werden. Gültige Materialzeichenfolgen enthalten nur Buchstaben, Zahlen und Leerzeichen. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)

Shopabschnitts-ID
shop_section_id integer

Die numerische ID des Shopabschnitts für diesen Eintrag.

Mindestverarbeitung
processing_min integer

Die mindeste Anzahl von Tagen, die zum Verarbeiten dieser Auflistung erforderlich sind.

Maximale Verarbeitung
processing_max integer

Die maximale Anzahl von Tagen, die zum Verarbeiten dieser Auflistung erforderlich sind.

Stichwörter
tags string

Ein Array von Tagzeichenfolgen für die Auflistung. Gültige Tagzeichenfolgen enthalten nur Buchstaben, Zahlen, Leerzeichen, -, ", ™ , © und ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)

Recipient
recipient string

Eine Zeichenfolge, die eine Person angibt, für die dieses Produkt ein geeignetes Geschenk machen würde.

Gelegenheit
occasion string

Eine Zeichenfolge, die eine Gelegenheit angibt, für die dieses Produkt ein geeignetes Geschenk machen würde.

Styles
styles string

Ein Array von Formatvorlagenzeichenfolgen für diese Auflistung, von denen jede Freiformtextzeichenfolge wie Formal oder Steampunk ist. Eine Auflistung kann bis zu zwei Formatvorlagen aufweisen. Gültige Formatvorlagenzeichenfolgen enthalten nur Buchstaben, Zahlen und Leerzeichen. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)

Elementgewichtung
item_weight float

Die numerische Gewichtung des Produkts, das in Einheiten gemessen wird, die in der Gewichtseinheit des Artikels festgelegt sind.

Elementlänge
item_length integer

Die numerische Länge des Produkts, das in Einheiten gemessen wird, die in elementdimensionseinheit festgelegt sind.

Elementbreite
item_width float

Die numerische Breite des Produkts, das in Einheiten gemessen wird, die in "Elementabmessungen Einheit" festgelegt sind.

Elementhöhe
item_height float

Die numerische Höhe des Produkts, das in Einheiten gemessen wird, die in "Elementdimensionseinheit" festgelegt sind.

Gewichtseinheit für Artikel
item_weight_unit string

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Gewichtung des Produkts verwendet werden.

Elementdimensionseinheit
item_dimensions_unit string

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Abmessungen des Produkts verwendet werden.

Ist personalisierbar
is_personalizable boolean

Wenn dies der Fall ist, ist diese Auflistung personalisierbar.

Bild-IDs
image_ids string

Ein Array numerischer Bild-IDs der Bilder in einer Auflistung, die bis zu 10 Bilder enthalten kann.

Is Supply
is_supply boolean

Wenn "true" ist, wird der Eintrag als Lieferprodukt markiert, andernfalls wird angegeben, dass es sich um ein fertiges Produkt ist. Hilft Käufern, den Eintrag unter der Überschrift "Lieferungen" zu finden. Erfordert "wer gemacht" und "wann gemacht".

Ist anpassbar
is_customizable boolean

Wenn dies der Fall ist, kann ein Käufer den Verkäufer für einen angepassten Auftrag kontaktieren. Der Standardwert ist true, wenn ein Shop benutzerdefinierte Bestellungen annimmt. Gilt nicht für Geschäfte, die keine benutzerdefinierten Bestellungen akzeptieren.

Steuerpflichtig
is_taxable boolean

Ist dies der Fall, gelten die anwendbaren Shopsteuersätze für diesen Eintrag beim Auschecken.

Gibt zurück

Ein Eintrag aus einem Shop, der eine Produktmenge, Titel, Beschreibung, Preis usw. enthält.

ShopListing
ShopListing

Erstellen eines Shopabschnitts

Erstellt einen neuen Abschnitt in einem bestimmten Shop.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Title
title True string

Die Titelzeichenfolge für einen Shopabschnitt.

Gibt zurück

Ein Abschnitt in einem Shop, in den ein Benutzer Einträge sortieren kann.

ShopSection
ShopSection

Erstellen eines Versandbelegs

Übermittelt Nachverfolgungsinformationen für einen Shopbeleg, der einen Shopbestätigungseintrag für die angegebene Beleg-ID erstellt. Jedes Mal, wenn Sie Tracking-Informationen erfolgreich übermitteln, sendet Emails eine Benachrichtigungs-E-Mail an den Käuferbenutzer. Wenn das Senden von BCC zutrifft, sendet Gesendete Versandbenachrichtigungen auch an den Verkäufer. Wenn der Sendungsverfolgungscode und der Name des Netzbetreibers nicht gesendet werden, wird der Beleg nur als versendet markiert.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eingangskennung
receipt_id True integer

Der Beleg, für den die Nachverfolgung übermittelt werden soll.

Nachverfolgungscode
tracking_code string

Der Nachverfolgungscode für diesen Beleg.

Netzbetreibername
carrier_name string

Der Name des Netzbetreibers für diesen Beleg.

BCC senden
send_bcc boolean

Wenn wahr, wird auch die Versandbenachrichtigung an den Verkäufer gesendet.

Gibt zurück

Die Aufzeichnung eines Einkaufs aus einem Shop. Shopbestätigungen zeigen Geldwerte mithilfe der Währung des Shops an.

ShopReceipt
ShopReceipt

Erstellen eines Versandprofils

Erstellt ein neues Versandprofil. Sie können beim Erstellen eines Versandprofils einen ISO-Code oder eine Region des Landes übergeben, aber nicht beides. Nur eine ist erforderlich. Sie müssen entweder eine Versandträger-ID und eine E-Mail-Klasse oder min. und max. Liefertage übergeben.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Title
title True string

Die Namenszeichenfolge dieses Versandprofils.

Ursprungsland ISO
origin_country_iso True string

Der ISO-Code des Landes, aus dem der Eintrag ausgeliefert wird.

Primärkosten
primary_cost True float

Die Kosten des Versands allein nach diesem Land/dieser Region, gemessen in der Standardwährung des Stores.

Sekundäre Kosten
secondary_cost True float

Die Kosten für den Versand an dieses Land/diese Region mit einem anderen Artikel, gemessen in der Standardwährung des Stores.

Minimale Verarbeitungszeit
min_processing_time True integer

Die mindeste Zeit, die erforderlich ist, um Einträge mit diesem Versandprofil zu versenden.

Maximale Verarbeitungszeit
max_processing_time True integer

Die maximale Verarbeitungszeit, die die Auflistung versenden muss.

Verarbeitungszeiteinheit
processing_time_unit string

Die Einheit, die verwendet wird, um darzustellen, wie lange eine Verarbeitungszeit ist. Eine Woche entspricht 5 Werktagen.

Zielland ISO
destination_country_iso string

Der ISO-Code des Landes, in das der Eintrag ausgeliefert wird. Wenn NULL, legt die Anforderung das Ziel auf den Zielbereich fest.

Zielregion
destination_region string

Der Code der Region, in die der Eintrag ausgeliefert wird. Eine Region stellt eine Reihe von Ländern dar. Unterstützte Regionen sind die Europäische Union und die Nicht-Europäische Union (Länder in Europa, die nicht in der EU sind). Wenn keines vorhanden ist, legt die Anforderung das Ziel auf das Zielland ISO oder überall fest, wenn die Iso des Ziellandes ebenfalls NULL ist.

Origin Postleitzahl
origin_postal_code string

Die Postleitzahlenzeichenfolge (nicht unbedingt eine Zahl) für den Standort, von dem der Eintrag ausgeliefert wird.

Versandnetzbetreiber-ID
shipping_carrier_id integer

Die eindeutige ID eines unterstützten Versandunternehmens, das verwendet wird, um ein geschätztes Lieferdatum zu berechnen.

Mail-Klasse
mail_class string

Die eindeutige ID-Zeichenfolge der E-Mail-Klasse eines Versandunternehmens, die zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Mindestzustelltage
min_delivery_days integer

Die mindeste Anzahl von Werktagen, die ein Käufer erwarten kann, auf den Empfang seines gekauften Artikels zu warten, sobald er ausgeliefert wurde.

Maximale Lieferzeit
max_delivery_days integer

Die maximale Anzahl von Werktagen, die ein Käufer erwarten kann, bis er seinen gekauften Artikel erhält, sobald er ausgeliefert wurde.

Gibt zurück

Stellt ein Profil dar, das zum Festlegen der Versandinformationen eines Eintrags verwendet wird. Bitte beachten Sie, dass es nicht möglich ist, berechnete Versandvorlagen über die API zu erstellen. Sie können jedoch berechnete Versandprofile, die von Shop Manager erstellt wurden, mit Auflistungen mithilfe der API verknüpfen.

ShopShippingProfile
ShopShippingProfile

Erstellen eines Versandprofilupgrades

Erstellt ein neues Versandprofilupgrade, das einen Preis für eine Versandoption festlegen kann, z. B. ein alternativer Versandunternehmen oder eine schnellere Lieferung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Typ
type True string

Der Typ des Versandupgrades. Inland (0) oder international (1).

Upgradename
upgrade_name True string

Name für das Versandupgrade, das käufern beim Auschecken angezeigt wird, z. B. USPS Priority.

Preis
price True float

Zusätzliche Kosten für das Hinzufügen des Versandupgrades.

Sekundärer Preis
secondary_price True float

Zusätzliche Kosten für das Hinzufügen des Versandupgrades für jeden zusätzlichen Artikel.

Versandnetzbetreiber-ID
shipping_carrier_id integer

Die eindeutige ID eines unterstützten Versandunternehmens, das zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Mail-Klasse
mail_class string

Die eindeutige ID-Zeichenfolge der E-Mail-Klasse eines Versandunternehmens, die zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Mindestzustelltage
min_delivery_days integer

min_delivery_days

Maximale Lieferzeit
max_delivery_days integer

Die maximale Anzahl von Werktagen, die ein Käufer erwarten kann, bis er seinen gekauften Artikel erhält, sobald er ausgeliefert wurde.

Gibt zurück

Eine Darstellung einer Upgradeoption für das Versandprofil.

ShopShippingProfileUpgrade
ShopShippingProfileUpgrade

Erstellen eines Versandprofilziels

Erstellt ein neues Versandziel, das die Versandkosten, den Versandunternehmen und die Klasse für ein Ziel in einem Versandprofil festlegt. Dies weist Kosten unter Verwendung der Währung des zugehörigen Shops zu. Legen Sie das Ziel entweder mithilfe von Zielland ISO oder Zielregion fest; Zielland ISO und Zielregion schließen sich gegenseitig aus – legen Sie eine oder die andere fest. Das Festlegen beider Trigger löst Fehler 400 aus. Wenn die Anforderung weder die Zielland-ISO noch die Zielregion festlegt, ist das Standardziel überall. Sie müssen entweder sowohl eine Versandträger-ID als auch eine E-Mail-Klasse oder min. Liefertage und max. Liefertage zuweisen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Primärkosten
primary_cost True float

Die Kosten des Versands allein nach diesem Land/dieser Region, gemessen in der Standardwährung des Stores.

Sekundäre Kosten
secondary_cost True string

Die Kosten für den Versand an dieses Land/diese Region mit einem anderen Artikel, gemessen in der Standardwährung des Stores.

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

Gibt zurück

Stellt ein Versandziel dar, das einem Versandprofil zugewiesen ist.

ShopShippingProfileDestination
ShopShippingProfileDestination

Hochladen einer Eintragsdatei

Lädt eine neue Datei für einen digitalen Eintrag hoch oder ordnet eine vorhandene Datei einem bestimmten Eintrag zu. Sie müssen entweder die Eintragsdatei-ID einer vorhandenen Datei oder den Namen und die Binärdateidaten für eine Datei angeben, die hochgeladen werden soll. Durch das Zuordnen einer vorhandenen Datei zu einem physischen Eintrag wird die physische Auflistung in eine digitale Auflistung umgewandelt, wodurch alle Versandkosten und alle Produkt- und Bestandsvariationen entfernt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eintragsdatei-ID
listing_file_id integer

Die eindeutige numerische ID einer Datei, die einem digitalen Eintrag zugeordnet ist.

Datei
file True string

Eine hochzuladende Binärdatei.

Name
name string

Die Dateinamenzeichenfolge einer Datei, die hochgeladen werden soll

Rang
rank integer

Die positive numerische Position ungleich Null in den Bildern, die in einer Auflistung angezeigt werden, wobei die Rang 1-Bilder in der linken Position in einer Auflistung angezeigt werden.

Gibt zurück

Eine Datei, die einer digitalen Auflistung zugeordnet ist.

ShopListingFile
ShopListingFile

Hochladen eines Eintragsbilds

Lädt ein Bild hoch oder weist es einem Eintrag zu, der durch eine Shop-ID mit einer Eintrags-ID identifiziert wird. Um ein neues Bild hochzuladen, legen Sie die Bilddatei als Wert für den Bildparameter fest. Sie können einem Eintrag mithilfe der Bild-ID des gelöschten Bilds im Parameter "Eintragsbild-ID" ein zuvor gelöschtes Bild zuweisen. Wenn eine Anforderung sowohl Bild- als auch Eintrags-ID-Parameterwerte enthält, lädt der Endpunkt das Bild nur in den Bildparameter hoch.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Bild
image string

Die Dateinamenzeichenfolge einer hochzuladenden Datei.

Eintragsbild-ID
listing_image_id integer

Die numerische ID des primären Eintragsbilds für diese Transaktion.

Rang
rank integer

Die positive numerische Position ungleich Null in den Bildern, die in einer Auflistung angezeigt werden, wobei die Rang 1-Bilder in der linken Position in einer Auflistung angezeigt werden.

Überschreiben
overwrite boolean

Wenn dies der Fall ist, ersetzt diese Anforderung das vorhandene Bild in einer bestimmten Rangfolge.

Ist Wasserzeichen
is_watermarked boolean

Wenn true, gibt an, dass das hochgeladene Bild ein Wasserzeichen hat.

Gibt zurück

Referenz-URLs und Metadaten für ein Bild, das einer bestimmten Auflistung zugeordnet ist. Der url_fullxfull Parameter enthält die URL für die Binärbilddatei in voller Größe.

ListingImage
ListingImage

Laden nach Besitzer-ID abrufen

Ruft den Shop ab, der von der Benutzer-ID des Shopbesitzers identifiziert wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer-ID
user_id True string

Die numerische Benutzer-ID des Benutzers, der diesen Shop besitzt.

Gibt zurück

Ein Shop, der von einem Benutzer von Users erstellt wurde.

Shop
Shop

Ladenabschnitte abrufen

Ruft die Liste der Shopabschnitte in einem bestimmten Shop ab, der durch die Shop-ID identifiziert wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Gibt zurück

Alle Abschnitte in einem sprecific Shop.

ShopSections
ShopSections

Löschen einer Datei aus der Auflistung

Wenn Sie die endgültige Datei für einen digitalen Eintrag löschen, wird der Eintrag in eine physische Auflistung konvertiert. Die Antwort auf eine Löschanforderung gibt eine Liste der verbleibenden Dateidatensätze zurück, die dem angegebenen Eintrag zugeordnet sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eintragsdatei-ID
listing_file_id True integer

Die eindeutige numerische ID einer Datei, die einem digitalen Eintrag zugeordnet ist.

Löschen einer Eintragseigenschaft

Löscht eine Eigenschaft aus einer Auflistung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eigenschaften-ID
property_id True integer

Die eindeutige ID einer Auflistungseigenschaft von Listing.

Löschen eines Eintrags

Diese Aktion löscht einen Shopeintrag. Eine Auflistung kann nur gelöscht werden, wenn der Status eine der folgenden Ist: SOLD_OUT, ENTWURF, ABGELAUFEN, INACTIVE, ACTIVE und is_available oder ACTIVE und hat Verkäuferkennzeichnungen: SUPRESSED (fixiert), URLAUB, CUSTOM_SHOPS (Muster), SELL_ON_FACEBOOK

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Löschen eines Eintragsbilds

Löscht ein Eintragsbild. Eine Kopie der Datei bleibt auf unseren Servern erhalten, sodass ein gelöschtes Bild dem Eintrag zugeordnet werden kann, ohne das ursprüngliche Bild erneut hochzuladen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eintrags-ID
listing_id True integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eintragsbild-ID
listing_image_id True integer

Die numerische ID des primären Eintragsbilds für diese Transaktion.

Löschen eines Versandprofils

Löscht ein Versandprofil anhand der angegebenen ID.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Gibt zurück

Stellt ein Profil dar, das zum Festlegen der Versandinformationen eines Eintrags verwendet wird. Bitte beachten Sie, dass es nicht möglich ist, berechnete Versandvorlagen über die API zu erstellen. Sie können jedoch berechnete Versandprofile, die von Shop Manager erstellt wurden, mit Auflistungen mithilfe der API verknüpfen.

ShopShippingProfile
ShopShippingProfile

Löschen eines Versandprofilupgrades

Löscht ein Upgrade des Versandprofils und entfernt die Upgradeoption aus jeder Auflistung, die das zugeordnete Versandprofil verwendet.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Versandprofils.

Upgrade-ID
upgrade_id True integer

Die numerische ID, die einem Versandupgrade zugeordnet ist

Löschen eines Versandprofilziels

Löscht ein Versandziel und entfernt die Zieloption aus jedem Eintrag, der das zugeordnete Versandprofil verwendet. Ein Versandprofil erfordert mindestens ein Versandziel, sodass dieser Endpunkt das endgültige Versandziel für jedes Versandprofil nicht löschen kann. Um das endgültige Versandziel aus einem Versandprofil zu löschen, müssen Sie das gesamte Versandprofil löschen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Versandprofil-ID
shipping_profile_id True integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Ziel-ID des Versandprofils
shipping_profile_destination_id True integer

Die numerische ID des Versandprofilziels im Dem Eintrag zugeordneten Versandprofil.

Ping

Überprüfen Sie, ob Sie die Verbindung mit der Api von Reiseroute mit einer Anwendung bestätigen.

Gibt zurück

Eine Bestätigung, dass die aktuelle Anwendung Zugriff auf die Open-API hat

Stinken
Pong

Produkt eines Eintrags abrufen

Abrufen eines Eintragsprodukts nach ID.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eintrags-ID
listing_id True integer

Die Auflistung, für die ein Eintragsprodukt zurückgegeben werden soll.

Produkt-ID
product_id True integer

Die numerische ID für ein bestimmtes Produkt, das aus einer Auflistung erworben wurde.

Gibt zurück

Eine Darstellung eines Produkts für einen Eintrag.

ListingInventoryProduct
ListingInventoryProduct

Shop-Abschnitt abrufen

Ruft einen Shopabschnitt ab, auf den nach Abschnitts-ID und Shop-ID verwiesen wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shop-ID
shop_id True integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Shopabschnitts-ID
shop_section_id True integer

Die numerische ID eines Abschnitts in einem bestimmten Webshop.

Gibt zurück

Ein Abschnitt in einem Shop, in den ein Benutzer Einträge sortieren kann.

ShopSection
ShopSection

Shops durchsuchen

Gibt eine Liste von Geschäften mit dem übereinstimmenden Namen zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Shopname
shop_name True string

Die Namenszeichenfolge des Shops.

Limit
limit integer

Die maximale Anzahl der zurückzugebenden Ergebnisse.

Offset
offset integer

Die Anzahl der zu überspringenden Datensätze, bevor Das erste Ergebnis ausgewählt wird.

Gibt zurück

Eine Reihe von Shop-Datensätzen.

Geschäfte
Shops

Versandunternehmen abrufen

Ruft eine Liste der verfügbaren Versandunternehmen und die ihnen zugeordneten E-Mail-Klassen für ein bestimmtes Land ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ursprungsland ISO
origin_country_iso True string

Der ISO-Code des Landes, aus dem der Eintrag ausgeliefert wird.

Gibt zurück

Stellt mehrere ShippingCarriers dar.

ShippingCarriers
ShippingCarriers

Definitionen

ShopListing

Ein Eintrag aus einem Shop, der eine Produktmenge, Titel, Beschreibung, Preis usw. enthält.

Name Pfad Typ Beschreibung
Eintrags-ID
listing_id integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Benutzer-ID
user_id integer

Die numerische ID für den Benutzer, der den Eintrag veröffentlicht.

Shop-ID
shop_id integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Title
title string

Titelzeichenfolge des Eintrags. Gültige Titelzeichenfolgen enthalten nur Buchstaben, Zahlen, Satzzeichen, mathematische Symbole, Leerzeichen, ™ , , © und ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Sie können die zeichen %, :, & und + nur einmal verwenden.

Description
description string

Eine Beschreibungszeichenfolge des Produkts für den Verkauf in der Auflistung.

Staat
state State

Eine aufgezählte Zeichenfolge aus einer von: aktiv oder inaktiv. Hinweis: Wenn Sie einen Entwurfseintrag auf "aktiv" festlegen, wird die Auflistung auch auf etsy.com veröffentlicht.

Erstellungszeitstempel
creation_timestamp integer

Die Erstellungszeit des Eintrags in Epochen sekunden.

Endzeitstempel
ending_timestamp integer

Die Ablaufzeit des Eintrags in Epochen sekunden.

Zeitstempel der ursprünglichen Erstellung
original_creation_timestamp integer

Die Erstellungszeit des Eintrags in Epochen sekunden.

Zeitstempel der letzten Änderung
last_modified_timestamp integer

Die Uhrzeit der letzten Aktualisierung des Eintrags in Epochen sekunden.

Zeitstempel der letzten Zustandsänderung
state_timestamp integer

Das Datum und die Uhrzeit der letzten Statusänderung dieser Auflistung.

Menge
quantity integer

Die positive Nicht-Null-Anzahl der Produkte, die im Eintrag erworben werden können. Hinweis: Die Eintragsmenge ist die Summe der verfügbaren Angebotsmengen. Sie können die Mengen für einzelne Angebote über die ListingInventory-Ressource mithilfe des Endpunkts zum Abrufen des Eintragsbestands anfordern.

Shopabschnitts-ID
shop_section_id integer

Die numerische ID eines Abschnitts in einem bestimmten Webshop.

Empfohlene Rangfolge
featured_rank integer

Die positive Nicht-Null-Numerische Position in den empfohlenen Auflistungen des Shops, wobei die Rang 1-Einträge in der Linksposition des empfohlenen Eintrags auf der Startseite eines Shops angezeigt werden.

URL
url string

Die vollständige URL zur Seite des Eintrags auf Shape.

Anzahl der Favorer
num_favorers integer

Die Anzahl der Benutzer, die diesen Eintrag als Favoriten markiert haben.

Nichtsteuerpflichtig
non_taxable boolean

Wenn zutreffend, gelten die geltenden Shopsteuersätze nicht für diesen Eintrag beim Auschecken.

Ist anpassbar
is_customizable boolean

Wenn dies der Fall ist, kann ein Käufer den Verkäufer für einen angepassten Auftrag kontaktieren. Der Standardwert ist true, wenn ein Shop benutzerdefinierte Bestellungen annimmt. Gilt nicht für Geschäfte, die keine benutzerdefinierten Bestellungen akzeptieren.

Ist peronalizable
is_personalizable boolean

Wenn dies der Fall ist, ist diese Auflistung personalisierbar. Der Standardwert ist null.

Personalisierung ist erforderlich
personalization_is_required boolean

Wenn dies der Fall ist, erfordert diese Auflistung eine Personalisierung. Der Standardwert ist null.

Maximale Anzahl von Personalisierungszeichen
personalization_char_count_max integer

Dieser ganzzahlige Wert, der die maximale Länge für die vom Käufer eingegebene Personalisierungsnachricht darstellt.

Personalisierungsanweisungen
personalization_instructions string

Wenn dies der Fall ist, erfordert diese Auflistung eine Personalisierung. Der Standardwert ist null.

Eintragstyp
listing_type boolean

Eine aufgezählte Typzeichenfolge, die angibt, ob es sich bei der Auflistung um einen physischen oder digitalen Download handelt.

Stichwörter
tags array of string

Eine Liste der Tagzeichenfolgen für den Eintrag. Gültige Tagzeichenfolgen enthalten nur Buchstaben, Zahlen, Leerzeichen, -, ", ™ , © und ® . (regex: /[^\p{L}\p{Nd}\p{Zs}\-'™©®]/u) Der Standardwert ist NULL.

Materials
materials array of string

Eine Liste der Materialzeichenfolgen für materialien, die im Produkt verwendet werden. Gültige Materialzeichenfolgen enthalten nur Buchstaben, Zahlen und Leerzeichen. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Der Standardwert ist NULL.

Versandprofil-ID
shipping_profile_id integer

Die numerische ID des Dem Eintrag zugeordneten Versandprofils.

Mindestverarbeitungstage
processing_min integer

Die mindeste Anzahl von Tagen, die zum Verarbeiten dieser Auflistung erforderlich sind. Der Standardwert ist NULL.

Maximale Verarbeitungszeit
processing_max integer

Die maximale Anzahl von Tagen, die zum Verarbeiten dieser Auflistung erforderlich sind. Der Standardwert ist NULL.

WhoMade
who_made WhoMade

Eine aufgezählte Zeichenfolge, die das Produkt erstellt hat. Hilft Käufern, den Eintrag unter der Handgemachten Überschrift zu finden. Erfordert "is_supply" und "when_made".

WhenMade
when_made WhenMade

Eine aufgezählte Zeichenfolge für die Ära, in der der Hersteller das Produkt in diesem Eintrag gemacht hat. Hilft Käufern, den Eintrag unter der Vintage-Überschrift zu finden. Erfordert "is_supply" und "who_made".

Lieferprodukt
is_supply boolean

Wenn "true" ist, wird der Eintrag als Lieferprodukt markiert, andernfalls wird angegeben, dass es sich um ein fertiges Produkt ist. Hilft Käufern, den Eintrag unter der Überschrift "Lieferungen" zu finden. Erfordert "who_made" und "when_made".

Elementgewichtung
item_weight double

Die numerische Gewichtung des Produkts, das in Einheiten gemessen wird, die in der Gewichtseinheit des Artikels festgelegt sind. Der Standardwert ist NULL. Wenn dieser Wert festgelegt ist, muss der Wert größer als 0 sein.

ItemWeightUnit
item_weight_unit ItemWeightUnit

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Gewichtung des Produkts verwendet werden. Der Standardwert ist NULL.

Elementlänge
item_length double

Die numerische Länge des Produkts, das in Einheiten gemessen wird, die in elementdimensionseinheit festgelegt sind. Der Standardwert ist NULL. Wenn dieser Wert festgelegt ist, muss der Wert größer als 0 sein.

Elementbreite
item_width double

Die numerische Breite des Produkts, das in Einheiten gemessen wird, die in elementdimensionseinheit festgelegt sind. Der Standardwert ist NULL. Wenn dieser Wert festgelegt ist, muss der Wert größer als 0 sein.

Elementhöhe
item_height double

Die numerische Länge des Produkts, das in Einheiten gemessen wird, die in elementdimensionseinheit festgelegt sind. Der Standardwert ist NULL. Wenn dieser Wert festgelegt ist, muss der Wert größer als 0 sein.

ItemDimensionsUnit
item_dimensions_unit ItemDimensionsUnit

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Abmessungen des Produkts verwendet werden. Der Standardwert ist NULL.

Ist privat
is_private boolean

Wenn dies der Fall ist, ist dies ein privater Eintrag, der für einen bestimmten Käufer vorgesehen ist und aus der Shopansicht verborgen ist.

Recipient
recipient Recipient

Eine aufgezählte Zeichenfolge, die eine Person angibt, für die dieses Produkt ein geeignetes Geschenk machen würde. Der Standardwert ist NULL.

Gelegenheit
occasion Occasion

Eine aufgezählte Zeichenfolge, die eine Gelegenheit angibt, für die dieses Produkt ein geeignetes Geschenk machen würde. Der Standardwert ist NULL.

Stil
style array of string

Ein Array von Formatvorlagenzeichenfolgen für diese Auflistung, von denen jede Freiformtextzeichenfolge wie Formal oder Steampunk ist. Eine Auflistung kann bis zu zwei Formatvorlagen aufweisen. Gültige Formatvorlagenzeichenfolgen enthalten nur Buchstaben, Zahlen und Leerzeichen. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Der Standardwert ist NULL.

Dateidaten
file_data string

Eine Zeichenfolge, die die an eine digitale Auflistung angefügten Dateien beschreibt.

Hat Variationen
has_variations boolean

Bei "true" weist die Auflistung Variationen auf.

Sollte automatisch verlängert werden
should_auto_renew boolean

Wenn wahr, verlängert eine Auflistung für vier Monate nach Enteignung. Wenn dieser Wert auf "true" festgelegt ist, verlängert etsy.com den Eintrag, bevor er abläuft, aber der Verlängerungszeitraum beginnt unaufrichtig, anstatt das Ablaufdatum des Eintrags zu erweitern. Nicht verwendete Zeit für den Eintrag geht verloren. Verlängerungen führen zu Gebühren für die Rechnung eines Benutzers.

Language
language string

Das IETF-Sprachtag für die Standardsprache des Eintrags. Beispiel: de, , , en, esfr, jait, nl, pl, , . ptru

Geld
price Money

Eine Darstellung eines Geldbetrags.

Taxonomie-ID
taxonomy_id integer

Die numerische Taxonomie-ID des Eintrags. Der Verkäufer verwaltet die Listentaxonomie-IDs für seinen Shop. Weitere Informationen finden Sie unter Verkäufertaxonomie.

Geld

Eine Darstellung eines Geldbetrags.

Name Pfad Typ Beschreibung
Betrag
amount integer

Die Menge, die durch diese Daten dargestellt wird.

Divisor
divisor integer

Der Divisor zum Rendern des Betrags.

Währungscode
currency_code string

Der ISO-Währungscode für diese Daten.

ShopListingFile

Eine Datei, die einer digitalen Auflistung zugeordnet ist.

Name Pfad Typ Beschreibung
Eintragsdatei-ID
listing_file_id integer

Die eindeutige numerische ID einer Datei, die einem digitalen Eintrag zugeordnet ist.

Eintrags-ID
listing_id integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Rang
rank integer

Der numerische Index der Position der Anzeigereihenfolge dieser Datei in der Auflistung, beginnend bei 1.

Dateiname
filename string

Die Dateinamenzeichenfolge für eine Datei, die einer digitalen Auflistung zugeordnet ist.

Dateiengröße
filesize string

Eine lesbare Formatgrößenzeichenfolge für die Größe einer Datei.

Größe in Bytes
size_bytes integer

Eine Zahl, die die Größe einer Datei angibt, gemessen in Bytes.

Dateityp
filetype string

Eine Typzeichenfolge, die den MIME-Typ einer Datei angibt.

Zeitstempel erstellen
create_timestamp integer

Der eindeutige numerische Zeitstempel einer Datei, die einer digitalen Auflistung zugeordnet ist.

ShopListingFiles

Stellt mehrere ShopListingFiles dar.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der zurückgegebenen ShopListingFiles..

Ergebnisse
results array of ShopListingFile

Ein Array von ShopListingFile-Ressourcen.

ShopListings

Eine Reihe von Shopauflistungsressourcen.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der gefundenen Shopauflistungsressourcen.

Ergebnisse
results array of ShopListing

Die Gefundenen Ressourcen für die Shopauflistung.

Benutzer

Stellt einen einzelnen Benutzer der Website dar.

Name Pfad Typ Beschreibung
Benutzer-ID
user_id integer

Die numerische ID eines Benutzers. Diese Nummer ist auch eine gültige Shop-ID für den Shop des Benutzers.

Benutzername
login_name string

Die Anmeldenamenzeichenfolge des Benutzers.

Primäre E-Mail-Adresse
primary_email string

Eine E-Mail-Adresszeichenfolge für die primäre E-Mail-Adresse des Benutzers.

Vorname
first_name string

Der Vorname des Benutzers.

Nachname
last_name string

Der Nachname des Benutzers.

Erstellter Zeitstempel
create_timestamp integer

Das Datum und die Uhrzeit, zu dem der Benutzer sein Konto in Epochen sekunden erstellt hat.

Durch Benutzer-ID verwiesen
referred_by_user_id integer

Die numerische ID des Benutzers, der auf diesen Benutzer verwiesen hat.

Verwenden neuer Bestandsendpunkte
use_new_inventory_endpoints boolean

Deprecated. Immer wahr.

Verkäufer
is_seller boolean

True, wenn der Benutzer Verkäufer ist.

Biographie
bio string

Die Biografie des Benutzers.

Geschlecht
gender string

Das Geschlecht des Benutzers.

Geburtsmonat
birth_month string

Der Geburtsmonat des Benutzers.

Geburtstag
birth_day string

Der Geburtsdatum des Benutzers.

Transaktionsanzahl kaufen
transaction_buy_count integer

Die Anzahl der Transaktionen, bei denen der Benutzer gekauft hat.

Anzahl verkaufter Transaktionen
transaction_sold_count integer

Die Anzahl der Transaktionen, bei denen der Benutzer verkauft wurde.

Shop

Ein Shop, der von einem Benutzer von Users erstellt wurde.

Name Pfad Typ Beschreibung
Shop-ID
shop_id integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Benutzer-ID
user_id integer

Die numerische Benutzer-ID des Benutzers, der diesen Shop besitzt.

Shopname
shop_name string

Die Namenszeichenfolge des Shops.

Erstellt am
create_date integer

Das Datum und die Uhrzeit, zu dem dieser Shop in Epochen sekunden erstellt wurde.

Title
title string

Eine kurze Überschriftenzeichenfolge für die Hauptseite des Shops.

Ankündigung
announcement string

Eine Ankündigungszeichenfolge für Käufer, die auf der Homepage des Shops angezeigt werden.

Währungscode
currency_code string

Der ISO-Code (alphabetisch) für die Währung des Shops. Der Shop zeigt standardmäßig alle Preise in dieser Währung an.

Ist im Urlaub
is_vacation boolean

Wenn dies der Fall ist, akzeptiert dieser Shop keine Einkäufe.

Urlaubsnachricht
vacation_message string

Die Meldungszeichenfolge des Shops, die angezeigt wird, wenn is_vacation wahr ist.

Verkaufsnachricht
sale_message string

Eine Nachrichtenzeichenfolge, die an Benutzer gesendet wird, die einen Kauf von diesem Shop abschließen.

Digitale Verkaufsnachricht
digital_sale_message string

Eine Nachrichtenzeichenfolge, die an Benutzer gesendet wird, die einen digitalen Artikel aus diesem Shop kaufen.

Datum der Aktualisierung
update_date integer

Das Datum und die Uhrzeit der letzten Aktualisierung im Shop, in Epochen sekunden.

Aktive Auflistungsanzahl
listing_active_count integer

Die Anzahl der aktiven Angebote im Shop.

Anzahl digitaler Einträge
digital_listing_count integer

Die Anzahl der digitalen Angebote im Shop.

Benutzername
login_name string

Die Anmeldenamenzeichenfolge des Shopbesitzers.

Akzeptiert benutzerdefinierte Anforderungen
accepts_custom_requests boolean

Wenn dies der Fall ist, akzeptiert der Shop Anpassungsanforderungen.

Willkommensrichtlinie
policy_welcome string

Die Richtlinien-Willkommenszeichenfolge des Shops (kann leer sein).

Zahlungsrichtlinie
policy_payment string

Die Zahlungsrichtlinienzeichenfolge des Shops (kann leer sein).

Versandrichtlinie
policy_shipping string

Die Versandrichtlinienzeichenfolge des Shops (kann leer sein).

Rückerstattungsrichtlinie
policy_refunds string

Die Rückerstattungsrichtlinienzeichenfolge des Shops (kann leer sein).

Zusätzliche Richtlinien
policy_additional string

Die zusätzliche Richtlinienzeichenfolge des Shops (kann leer sein).

Verkäuferinformationen
policy_seller_info string

Die Verkäuferinformationszeichenfolge des Shops (kann leer sein).

Aktualisierungsdatum der Richtlinie
policy_update_date integer

Das Datum und die Uhrzeit der letzten Aktualisierung der Richtlinien des Shops in Epochen sekunden.

Verfügt über eine Private Belegrichtlinie
policy_has_private_receipt_info boolean

Wenn wahr, zeigen EU-Belege private Informationen an.

Weist unstrukturierte Richtlinien auf
has_unstructured_policies boolean

Wenn true, zeigt der Shop zusätzliche unstrukturierte Richtlinienfelder an.

Datenschutzrichtlinie
policy_privacy string

Die Datenschutzrichtlinienzeichenfolge des Shops (kann leer sein).

Urlaub autoreply
vacation_autoreply string

Die automatische Antwortzeichenfolge des Shops, die in neuen Unterhaltungen angezeigt wird, wenn is_vacation wahr ist.

URL
url string

Die URL-Zeichenfolge für diesen Shop.

Bannerbild-URL
image_url_760x100 string

Die URL-Zeichenfolge für das Bannerbild dieses Shops.

Anzahl der Favorer
num_favorers integer

Die Anzahl der Benutzer, die diesen Shop als Favoriten markiert haben.

Sprachen
languages array of string

Eine Liste der Sprachzeichenfolgen für die registrierten Sprachen des Shops.

Symbolbild-URL
icon_url_fullxfull string

Die URL-Zeichenfolge für das Symbolbild dieses Shops.

Verwendet strukturierte Richtlinien
is_using_structured_policies boolean

Wenn wahr, akzeptiert der Shop mit strukturierten Richtlinien.

Integrierte strukturierte Richtlinien
has_onboarded_structured_policies boolean

Wenn dies der Fall ist, hat der Shop nach dem Onboarding von strukturierten Richtlinien abgelehnt ODER abgelehnt.

Link "Streitformular einschließen"
include_dispute_form_link boolean

Wenn dies der Fall ist, enthalten die Richtlinien dieses Shops einen Link zu einem EU-Online-Streitbeilegungsformular.

Ist direct Checkout onboarded
is_direct_checkout_onboarded boolean

Wenn dies der Fall ist, hat der Shop auf Payments integriert.

Ist berechneter Versand berechtigt
is_calculated_eligible boolean

Wenn wahr, ist der Shop für berechnete Versandprofile verlegbar. (Nur in den USA und Kanada verfügbar)

Ist für die Zusage des Käufers angemeldet
is_opted_in_to_buyer_promise boolean

Wenn dies der Fall ist, hat sich der Shop für die Zusage des Käufers entschieden.

Ist US-basiert
is_shop_us_based boolean

Wenn wahr, ist der Shop in den USA ansässig.

Verkaufstransaktionsanzahl
transaction_sold_count integer

Die Gesamtzahl der Verkaufstransaktionen für diesen Shop

Versand ab Land ISO
shipping_from_country_iso string

Das Land iso der Shop wird abversandt.

Shopstandort ISO
shop_location_country_iso string

Das Land iso, wo sich der Shop befindet.

Anzahl überprüfen
review_count integer

Anzahl der Bewertungen von Shop-Einträgen im vergangenen Jahr.

Durchschnittliche Überprüfung
review_average double

Durchschnittliche Bewertung basierend auf Rezensionen von Shop-Einträgen im vergangenen Jahr.

ListingImage

Referenz-URLs und Metadaten für ein Bild, das einer bestimmten Auflistung zugeordnet ist. Der url_fullxfull Parameter enthält die URL für die Binärbilddatei in voller Größe.

Name Pfad Typ Beschreibung
Eintrags-ID
listing_id integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Eintragsbild-ID
listing_image_id integer

Die numerische ID des primären Eintragsbilds für diese Transaktion.

Hex-Code
hex_code string

Die Webhex-Zeichenfolge für die durchschnittliche Farbe des Bilds in der Webhexnotation.

Roter Wert
red integer

Der numerische rote Wert entspricht dem durchschnittsroten Wert des Bilds von 0 bis 255 (RGB-Farbe).

Grüner Wert
green integer

Der numerische rote Wert entspricht dem durchschnittsroten Wert des Bilds von 0 bis 255 (RGB-Farbe).

Blauer Wert
blue integer

Der numerische rote Wert entspricht dem durchschnittsroten Wert des Bilds von 0 bis 255 (RGB-Farbe).

Farbtonwert
hue integer

Der numerische Farbton entspricht dem durchschnittlichen Farbton des Bilds von 0 bis 360 (HSV-Farbe).

Sättigungswert
saturation integer

Die numerische Sättigung entspricht der durchschnittlichen Sättigung des Bilds von 0 bis 100 (HSV-Farbe).

Helligkeitswert
brightness integer

Die numerische Helligkeit entspricht der durchschnittliche Helligkeit des Bilds von 0 bis 100 (HSV-Farbe).

Ist Schwarzweiß
is_black_and_white boolean

Wenn wahr, ist das Bild in Schwarzweiß.

Erstellungszeit
creation_tsz integer

Die Erstellungszeit des Eintragsbilds in Epochen sekunden.

Rang
rank integer

Die positive numerische Position ungleich Null in den Bildern, die in einer Auflistung angezeigt werden, wobei die Rang 1-Bilder in der linken Position in einer Auflistung angezeigt werden.

75x75 Bild-URL
url_75x75 string

Die URL-Zeichenfolge für eine Miniaturansicht von 75 x 75 Pixeln des Bilds.

170x135 Bild-URL
url_170x135 string

Die URL-Zeichenfolge für eine Miniaturansicht von 170 x 135 Pixeln des Bilds.

570xN-Bild-URL
url_570xN string

Die URL-Zeichenfolge für eine Miniaturansicht des Bilds, nicht mehr als 570 Pixel breit mit variabler Höhe.

Bild-URL in voller Größe
url_fullxfull string

Die URL-Zeichenfolge für das Bild in voller Größe, bis zu 3000 Pixel in jeder Dimension.

Höhe des Bilds in voller Größe
full_height integer

Die in Pixel gemessene numerische Höhe des Bilds in voller Größe, auf das in url_fullxfull verwiesen wird.

Breite des Bilds in voller Größe
full_width integer

Die in Pixel gemessene numerische Breite des Bilds in voller Größe, auf das in url_fullxfull verwiesen wird.

ListingImages

Stellt eine Liste der Listenbildressourcen dar, die jeweils die Referenz-URLs und Metadaten für ein Bild enthalten.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der Ergebnisse.

Ergebnisse
results array of ListingImage

Die Liste der angeforderten Ressourcen.

ListingInventoryWithAssociations

Eine Darstellung des Bestandsdatensatzes eines einzelnen Eintrags mit Zuordnungen

Name Pfad Typ Beschreibung
Products
products array of ListingInventoryProduct

Ein JSON-Array von Produkten, die in einer Auflistung verfügbar sind, auch wenn nur ein Produkt vorhanden ist. Alle Feldnamen in den JSON-Blobs sind Kleinbuchstaben.

Preis auf Eigenschaften
price_on_property array of integer

Ein Array eindeutiger Auflistungseigenschaften-ID-Ganzzahlen für die Eigenschaften, die produktpreise ändern, falls vorhanden. Wenn Sie z. B. bestimmte Preise für produkte unterschiedlicher Größe in derselben Auflistung berechnen, enthält dieses Array die Eigenschafts-ID für die Größe.

Menge auf Eigenschaften
quantity_on_property array of integer

Ein Array eindeutiger Auflistungseigenschaften-ID-Ganzzahlen für die Eigenschaften, die die Menge der Produkte ändern, falls vorhanden. Wenn Sie z. B. bestimmte Mengen verschiedener farbiger Produkte in derselben Auflistung auf lageren, enthält dieses Array die Eigenschafts-ID für Farbe.

SKU für Eigenschaften
sku_on_property array of integer

Ein Array eindeutiger Auflistungseigenschaften-ID-Ganzzahlen für die Eigenschaften, die die Produkt-SKU ändern, falls vorhanden. Wenn Sie z. B. bestimmte Skus für verschiedene farbige Produkte in derselben Auflistung verwenden, enthält dieses Array die Eigenschafts-ID für Farbe.

ShopListing
listing ShopListing

Ein Eintrag aus einem Shop, der eine Produktmenge, Titel, Beschreibung, Preis usw. enthält.

ListingInventoryProduct

Eine Darstellung eines Produkts für einen Eintrag.

Name Pfad Typ Beschreibung
Produkt-ID
product_id integer

Die numerische ID für ein bestimmtes Produkt, das aus einer Auflistung erworben wurde.

Artikelnummer (SKU)
sku string

Die SKU-Zeichenfolge für das Produkt

Ist gelöscht
is_deleted boolean

Wenn dies der Fall ist, hat jemand dieses Produkt gelöscht.

Offerings
offerings array of ListingInventoryProductOffering

Eine Liste der Produktangebotseinträge für dieses Produkt.

Eigenschaftswerte
property_values array of ListingPropertyValue

Eine Liste der Eigenschaftswerteinträge für dieses Produkt.

ListingInventoryProductOffering

Eine Darstellung eines Angebots für einen Eintrag.

Name Pfad Typ Beschreibung
Angebots-ID
offering_id integer

Die ID für das Produktangebot

Menge
quantity integer

Die Menge des Produktangebots

Ist aktiviert
is_enabled boolean

Ob das Angebot den Käufern angezeigt werden kann oder nicht.

Ist gelöscht
is_deleted boolean

Gibt an, ob das Angebot gelöscht wurde.

Geld
price Money

Eine Darstellung eines Geldbetrags.

ListingPropertyValue

Eine Darstellung strukturierter Datenwerte.

Name Pfad Typ Beschreibung
Eigenschaften-ID
property_id integer

Die numerische ID der Eigenschaft.

Name
property_name string

Der Name der Eigenschaft.

Skalierungs-ID
scale_id integer

Die numerische ID der Skalierung (falls vorhanden).

Skalierungsname
scale_name string

Die Bezeichnung, die zum Beschreiben der ausgewählten Skala verwendet wird (falls vorhanden).

Wert-IDs
value_ids array of integer

Die numerischen IDs der Eigenschaftswerte

Werte
values array of string

Die Eigenschaftswerte

ListingInventory

Eine Darstellung des Bestandsdatensatzes eines einzelnen Eintrags.

Name Pfad Typ Beschreibung
Products
products array of ListingInventoryProduct

Ein JSON-Array von Produkten, die in einer Auflistung verfügbar sind, auch wenn nur ein Produkt vorhanden ist. Alle Feldnamen in den JSON-Blobs sind Kleinbuchstaben.

Preis auf Eigenschaften
price_on_property array of integer

Ein Array eindeutiger Auflistungseigenschaften-ID-Ganzzahlen für die Eigenschaften, die produktpreise ändern, falls vorhanden. Wenn Sie z. B. bestimmte Preise für produkte unterschiedlicher Größe in derselben Auflistung berechnen, enthält dieses Array die Eigenschafts-ID für die Größe.

Menge auf Eigenschaften
quantity_on_property array of integer

Ein Array eindeutiger Auflistungseigenschaften-ID-Ganzzahlen für die Eigenschaften, die die Menge der Produkte ändern, falls vorhanden. Wenn Sie z. B. bestimmte Mengen verschiedener farbiger Produkte in derselben Auflistung auf lageren, enthält dieses Array die Eigenschafts-ID für Farbe.

SKU für Eigenschaften
sku_on_property array of integer

Ein Array eindeutiger Auflistungseigenschaften-ID-Ganzzahlen für die Eigenschaften, die die Produkt-SKU ändern, falls vorhanden. Wenn Sie z. B. bestimmte Skus für verschiedene farbige Produkte in derselben Auflistung verwenden, enthält dieses Array die Eigenschafts-ID für Farbe.

ShopListingsWithAssociations

Eine Reihe von Shopauflistungsressourcen mit Zuordnungen.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der gefundenen Shopauflistungsressourcen.

Ergebnisse
results array of ShopListing

Die Gefundenen Ressourcen für die Shopauflistung.

ListingPropertyValues

Stellt mehrere Auflistungseigenschaftswerte dar.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der gefundenen Shopauflistungsressourcen.

Ergebnisse
results array of ListingPropertyValue

Die Gefundenen Ressourcen für die Shopauflistung.

ShopReceiptTransactions

Eine Reihe von Transaktionsressourcen für Den Shopbeleg

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der gefundenen Transaktionsressourcen für den Shopbeleg.

Ergebnisse
results array of ShopReceiptTransaction

Die gefundenen Transaktionsressourcen für den Shopbeleg.

ShopReceiptTransaction

Ein Transaktionsobjekt, das einer Shopbestätigung zugeordnet ist. Das Unternehmen generiert eine Transaktion pro Gekaufter Eintrag, wie er auf dem Bestelleingang erfasst wurde.

Name Pfad Typ Beschreibung
Buchungskennung
transaction_id integer

Die eindeutige numerische ID für eine Transaktion.

Title
title string

Die Titelzeichenfolge des in dieser Transaktion erworbenen Eintrags.

Description
description string

Die Beschreibungszeichenfolge des in dieser Transaktion erworbenen Eintrags.

Verkäuferbenutzer-ID
seller_user_id integer

Die numerische Benutzer-ID für den Verkäufer in dieser Transaktion.

Käufer-Benutzer-ID
buyer_user_id integer

Die numerische Benutzer-ID für den Käufer in dieser Transaktion.

Erstellter Zeitstempel
create_timestamp integer

Das Erstellungsdatum und die Uhrzeit der Transaktion in Epochen sekunden.

Bezahlter Zeitstempel
paid_timestamp integer

Das kostenpflichtige Datum und die Uhrzeit der Transaktion in Epochen sekunden.

Versandzeitstempel
shipped_timestamp integer

Versanddatum und -uhrzeit der Transaktion in Epochen sekunden.

Menge
quantity integer

Die numerische Anzahl der in dieser Transaktion erworbenen Produkte.

Eintragsbild-ID
listing_image_id integer

Die numerische ID des primären Eintragsbilds für diese Transaktion.

Eingangskennung
receipt_id integer

Die numerische ID für den Beleg, der dieser Transaktion zugeordnet ist.

Ist Digital
is_digital boolean

Wenn dies der Fall ist, hat die Transaktion den Kauf eines digitalen Eintrags aufgezeichnet.

Dateidaten
file_data string

Eine Zeichenfolge, die die in dieser Transaktion erworbenen Dateien beschreibt.

Eintrags-ID
listing_id integer

Die numerische ID für den Eintrag, der dieser Transaktion zugeordnet ist.

Transaktionstyp
transaction_type string

Die Typzeichenfolge für die Transaktion, in der Regel auflisten

Produkt-ID
product_id integer

Die numerische ID für ein bestimmtes Produkt, das aus einer Auflistung erworben wurde.

Geld
price Money

Eine Darstellung eines Geldbetrags.

Geld
shipping_cost Money

Eine Darstellung eines Geldbetrags.

ListingTranslation

Stellt die Übersetzungsdaten für einen Eintrag dar.

Name Pfad Typ Beschreibung
Eintrags-ID
listing_id integer

Die numerische ID für den Eintrag.

Language
language string

Das IETF-Sprachtag (z. B. 'fr') für die Sprache dieser Übersetzung.

Title
title string

Der Titel der Auflistung dieser Übersetzung.

Description
description string

Die Beschreibung der Auflistung dieser Übersetzung.

Stichwörter
tags array of string

Die Tags der Auflistung dieser Übersetzung.

ListingVariationImages

Stellt mehrere Auflistungsvariationsbilder dar.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der Variationsbilder.

Ergebnisse
results array of ListingVariationImage

Die Ergebnisse der Variationsbilder.

ListingVariationImage

Eine Darstellung der Zuordnungen von Variationen und Bildern in einer Auflistung.

Name Pfad Typ Beschreibung
Eigenschaften-ID
property_id integer

Die numerische ID der Eigenschaft.

Wert-ID
value_id integer

Die numerische ID des Werts.

Bild-ID
image_id integer

Die numerische ID des Bilds.

PaymentAccountLedgerEntries

Eine Reihe von Zahlungskonto-Eintragsressourcen

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der Gefundenen Ressourcen für den Kontoeintrag des Zahlungskontos.

Ergebnisse
results array of PaymentAccountLedgerEntry

Die Ressourcen für den Kontoeintrag des Zahlungskontos wurden gefunden.

PaymentAccountLedgerEntry

Stellt einen Eintrag im Hauptbuch eines Shops dar.

Name Pfad Typ Beschreibung
Eintrags-ID
entry_id integer

Die numerische ID des Sachbucheintrags.

Ledger-ID
ledger_id integer

Die numerische ID des Hauptbuchs.

Sequenznummer
sequence_number integer

Die Sequenz ermöglicht die chronologische Sortierung von Sacheinträgen. Je höher die Sequenz, desto aktueller ist der Eintrag.

Betrag
amount integer

Der Betrag, der dem Sachbuch gutgeschrieben wurde.

Währung
currency string

Die Währung des Eintrags auf dem Hauptbuch.

Description
description string

Details dazu, welche Art von Sacheintrag dies ist: eine Zahlung, Rückerstattung, Rückbuchung einer fehlgeschlagenen Rückerstattung, Auszahlung, zurückgegebene Auszahlung, Rückzahlung, Rückzahlung, Sonstige Gutschrift, sonstige Lastschrift oder Rechnungszahlung.

Gesamtbetrag
balance integer

Die Höhe des Geldes im Hauptbuch des Ladens im Moment, nachdem dieser Eintrag angewendet wurde.

Erstellt am
create_date integer

Das Datum und die Uhrzeit, zu dem der Bucheintrag in Epochen sekunden erstellt wurde.

Zahlungen

Stellt mehrere Zahlungen dar, die mit Payment Payments getätigt wurden. Alle geldpolitischen Beträge sind in USD Pennies, sofern nicht anders angegeben.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der Zahlungen in der Antwort.

Ergebnisse
results array of Payment

Eine Liste der Zahlungen.

Zahlung

Stellt eine Zahlung dar, die mit Payment Payments getätigt wurde. Alle geldpolitischen Beträge sind in USD Pennies, sofern nicht anders angegeben.

Name Pfad Typ Beschreibung
Zahlungs-ID
payment_id integer

Eine eindeutige numerische ID für eine Zahlung an einen bestimmten Payment-Shop.

Käufer-Benutzer-ID
buyer_user_id integer

Die numerische ID für den Benutzer, der den Kauf bezahlt hat.

Shop-ID
shop_id integer

Die eindeutige positive Nicht-Null-Numerische ID für einen Webshop.

Eingangskennung
receipt_id integer

Die numerische ID für den Beleg, der dieser Transaktion zugeordnet ist.

Geld
amount_gross Money

Eine Darstellung eines Geldbetrags.

Geld
amount_fees Money

Eine Darstellung eines Geldbetrags.

Geld
amount_net Money

Eine Darstellung eines Geldbetrags.

Geld
posted_gross Money

Eine Darstellung eines Geldbetrags.

Geld
posted_fees Money

Eine Darstellung eines Geldbetrags.

Geld
posted_net Money

Eine Darstellung eines Geldbetrags.

Geld
adjusted_gross Money

Eine Darstellung eines Geldbetrags.

Geld
adjusted_fees Money

Eine Darstellung eines Geldbetrags.

Geld
adjusted_net Money

Eine Darstellung eines Geldbetrags.

Währung
currency string

Die ISO-Codezeichenfolge (alphabetisch) für die Währung der Zahlung.

Shopwährung
shop_currency string

Der ISO-Code (alphabetisch) für die Währung des Shops. Der Shop zeigt standardmäßig alle Preise in dieser Währung an.

Käuferwährung
buyer_currency string

Die Währungszeichenfolge des Käufers.

Benutzerversand-ID
shipping_user_id integer

Die numerische ID des Benutzers, an den der Verkäufer die Bestellung versendet.

Versandadressen-ID
shipping_address_id integer

Die numerische ID, die die Versandadresse identifiziert.

Rechnungsadressen-ID
billing_address_id integer

Die numerische ID, die die Rechnungsadresse des Käufers identifiziert.

Der Status
status string

Eine Zeichenfolge, die den aktuellen Status der Zahlung angibt, am häufigsten abgerechnet oder authentifiziert.

Versandzeitstempel
shipped_timestamp integer

Versanddatum und -uhrzeit der Transaktion in Epochen sekunden.

Erstellter Zeitstempel
create_timestamp integer

Das Erstellungsdatum und die Uhrzeit der Transaktion in Epochen sekunden.

Zeitstempel aktualisieren
update_timestamp integer

Das Datum und die Uhrzeit der letzten Änderung an der Zahlungsanpassung in Epochen sekunden.

Zahlungsanpassungen
payment_adjustments array of PaymentAdjustment

Liste der Erstattungsobjekte bei einer Payment-Transaktion von Payments. Alle geldpolitischen Beträge sind in USD Pennies, sofern nicht anders angegeben.

PaymentAdjustment

Stellt eine Rückerstattung dar, die für eine vorherige Zahlung von Payment gilt. Alle geldpolitischen Beträge sind in USD Pennies, sofern nicht anders angegeben.

Name Pfad Typ Beschreibung
Zahlungsanpassungs-ID
payment_adjustment_id integer

Die numerische ID für eine Zahlungsanpassung.

Zahlungs-ID
payment_id integer

Eine eindeutige numerische ID für eine Zahlung an einen bestimmten Payment-Shop.

Der Status
status string

Die Statuszeichenfolge der Zahlungsanpassung.

Ist Erfolg
is_success boolean

Wenn dies der Fall ist, war oder ist die Zahlungsanpassung wahrscheinlich erfolgreich abgeschlossen.

Benutzer-ID
user_id integer

Die numerische ID für den Benutzer (Verkäufer), der den Kauf erfüllt.

Reason Code
reason_code string

Eine lesbare Zeichenfolge, die den Grund für die Rückerstattung beschreibt.

Gesamtanpassungsbetrag
total_adjustment_amount integer

Der numerische Gesamtbetrag der Rückerstattung in der Zahlungswährung.

Shop Gesamtanpassungsbetrag
shop_total_adjustment_amount integer

Der numerische Betrag der Rückerstattung in der Shopwährung.

Gesamtanpassungsbetrag
buyer_total_adjustment_amount integer

Der numerische Betrag der Rückerstattung in der Währung des Käufers.

Gesamtgebühranpassungsbetrag
total_fee_adjustment_amount integer

Der numerische Betrag der Kartenverarbeitungsgebühren, die einer Zahlungsanpassung zugeordnet sind.

Erstellter Zeitstempel
create_timestamp integer

Das Erstellungsdatum und die Uhrzeit der Transaktion in Epochen sekunden.

Zeitstempel aktualisieren
update_timestamp integer

Das Datum und die Uhrzeit der letzten Änderung an der Zahlungsanpassung in Epochen sekunden.

Stinken

Eine Bestätigung, dass die aktuelle Anwendung Zugriff auf die Open-API hat

Name Pfad Typ Beschreibung
Anwendungs-ID
application_id integer

Die ID der authentifizierten Anwendung

ShopReceipt

Die Aufzeichnung eines Einkaufs aus einem Shop. Shopbestätigungen zeigen Geldwerte mithilfe der Währung des Shops an.

Name Pfad Typ Beschreibung
Eingangskennung
receipt_id integer

Die numerische ID für den Beleg, der dieser Transaktion zugeordnet ist.

Belegtyp
receipt_type integer

Der numerische Wert für den Channel Von Erhält, der den Kauf gewartet hat: 0 für Etsy.com, 1 für einen Pattern Shop.

Verkäuferbenutzer-ID
seller_user_id integer

Die numerische ID für den Benutzer (Verkäufer), der den Kauf erfüllt.

E-Mail-Adresse des Verkäufers
seller_email string

Die E-Mail-Adresszeichenfolge für den Verkäufer des Eintrags.

Käufer-Benutzer-ID
buyer_user_id integer

Die numerische ID für den Benutzer, der den Kauf abnimmt.

E-Mail-Adresse des Käufers
buyer_email string

Die E-Mail-Adresszeichenfolge für den Käufer des Eintrags.

Name
name string

Die Namenszeichenfolge für den Empfänger in der Versandadresse.

Erste Adresszeile
first_line string

Die erste Adresszeilenzeichenfolge für den Empfänger in der Versandadresse.

Zweite Adresszeile
second_line string

Die optionale zweite Adresszeilenzeichenfolge für den Empfänger in der Versandadresse.

Stadt
city string

Die Ortszeichenfolge für den Empfänger in der Versandadresse.

Staat
state string

Die Statuszeichenfolge für den Empfänger in der Versandadresse.

PLZ
zip string

Die Postleitzahl -Zeichenfolge (nicht unbedingt eine Zahl) für den Empfänger in der Versandadresse.

Formatierte Adresse
formatted_address string

Die formatierte Versandadressenzeichenfolge für den Empfänger in der Versandadresse.

Ländercode ISO
country_iso string

Die ISO-3166 Alpha-2-Ländercodezeichenfolge für den Empfänger in der Versandadresse.

Zahlungsmethode
payment_method string

Die Zahlungsmethodenzeichenfolge, die die Zahlungsmethode des Käufers identifiziert, die eine von: "cc" (Kreditkarte), "PayPal", "Check", "mo" (Geldauftrag), "bt" (Überweisung), "other", "ideal", "sofort", "apple_pay", "google", "android_pay", "google_pay", "klarna", "k_pay_in_4" (klarna) oder "k_financing" (klarna).

Zahlungs-E-Mail-Adresse
payment_email string

Die E-Mail-Adresszeichenfolge für die E-Mail-Adresse, an die die Zahlungsbestätigung gesendet werden soll

Nachricht vom Verkäufer
message_from_seller string

Eine optionale Nachrichtenzeichenfolge vom Verkäufer.

Nachricht des Käufers
message_from_buyer string

Eine optionale Nachrichtenzeichenfolge des Käufers.

Nachricht vom Zahlungssystem
message_from_payment string

Die vom Computer generierte Bestätigungszeichenfolge aus dem Zahlungssystem.

Wird bezahlt
is_paid boolean

Wenn wahr, der Käufer zahlte für diesen Kauf.

Wird ausgeliefert
is_shipped boolean

Wenn dies der Fall ist, hat der Verkäufer die Produkte ausgeliefert.

Erstellter Zeitstempel
create_timestamp integer

Die Erstellungszeit des Belegs in Epochen sekunden.

Zeitstempel aktualisieren
update_timestamp integer

Die Uhrzeit der letzten Aktualisierung des Belegs in Epochen sekunden.

Geschenknachricht
gift_message string

Eine Geschenknachricht Zeichenfolge, die der Käufer anfordert, die mit dem Produkt geliefert werden.

Geld
grandtotal Money

Eine Darstellung eines Geldbetrags.

Geld
subtotal Money

Eine Darstellung eines Geldbetrags.

Geld
total_price Money

Eine Darstellung eines Geldbetrags.

Geld
total_shipping_cost Money

Eine Darstellung eines Geldbetrags.

Geld
total_tax_cost Money

Eine Darstellung eines Geldbetrags.

Geld
total_vat_cost Money

Eine Darstellung eines Geldbetrags.

Geld
discount_amt Money

Eine Darstellung eines Geldbetrags.

Geld
gift_wrap_price Money

Eine Darstellung eines Geldbetrags.

Verschiffungen
shipments array of ShopReceiptShipment

Eine Liste der Versandanweisungen für diesen Beleg.

ShopReceiptShipment

Die Aufzeichnung eines Versandereignisses für ein ShopReceipt. Ein Beleg kann viele ShopReceiptShipment-Einträge enthalten.

Name Pfad Typ Beschreibung
Belegversand-ID
receipt_shipping_id integer

Die eindeutige numerische ID eines Einkaufsbestätigungsversanddatensatzes.

Versandbenachrichtigungs-Zeitstempel
shipment_notification_timestamp integer

Die Zeit, zu der Der Käufer des Versandereignisses in Epochensekunden benachrichtigt hat.

Netzbetreibername
carrier_name string

Die Namenszeichenfolge für den Netzbetreiber/die Firma, die für die Lieferung der Lieferung verantwortlich ist.

Nachverfolgungscode
tracking_code string

Die Zeichenfolge des Tracking-Codes, die vom Netzbetreiber/Unternehmen für die Lieferung bereitgestellt wird.

ShopReceipts

Die Belege für einen bestimmten Shop.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der gefundenen Shopbestätigungen.

Ergebnisse
results array of ShopReceipt

Liste der gefundenen Shopbestätigungsressourcen mit allen Feldern "Shopbestätigung" für jede Ressource.

TransactionReviews

Eine Gruppe von Transaktionsüberprüfungsdatensätzen, die von Benutzern hinterlassen werden.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der gefundenen TransactionReview-Ressourcen.

Ergebnisse
results array of TransactionReview

Die gefundenen TransactionReview-Ressourcen.

TransactionReview

Ein Transaktionsüberprüfungsdatensatz, der von einem Benutzer hinterlassen wurde.

Name Pfad Typ Beschreibung
Shop-ID
shop_id integer

Die numerische ID des Shops.

Eintrags-ID
listing_id integer

Die ID des Shopeintrags, zu dem die TransactionReview gehört.

Käufer-Benutzer-ID
buyer_user_id integer

Die numerische ID des Benutzers, der der Käufer in dieser Transaktion war. Hinweis: Je nach den Datenschutzeinstellungen des Käufers ist dieses Feld möglicherweise nicht vorhanden.

Rating
rating integer

Bewertungswert im Maßstab von 1 bis 5

Nachricht überprüfen
review string

Eine Vom Autor hinterlassene Nachricht, die das Feedback erläutert.

Language
language string

Die Sprache der TransactionReview

Fullsize Image URL
image_url_fullxfull string

Die URL zu einem Foto, das mit dem Feedback bereitgestellt wird, dimensionen fullxfull. Hinweis: Je nach den Datenschutzeinstellungen des Käufers ist dieses Feld möglicherweise nicht vorhanden.

Erstellter Zeitstempel
create_timestamp integer

Das Datum und die Uhrzeit, zu der die TransactionReview in Epochen sekunden erstellt wurde.

Zeitstempel aktualisieren
update_timestamp integer

Datum und Uhrzeit der Aktualisierung der TransactionReview in Epochen sekunden.

SellerTaxonomyNodes

Eine Liste der Taxonomieknoten aus der Verkäufertaxonomiestruktur.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der Ergebnisse.

Ergebnisse
results array of SellerTaxonomyNode

Die Liste der angeforderten Ressourcen.

SellerTaxonomyNode

Ein Taxonomieknoten in der Verkäufertaxonomiestruktur.

Name Pfad Typ Beschreibung
ID
id integer

Die eindeutige numerische ID eines Taxonomieknotens vom Typ "Taxonomie", bei dem es sich um eine Metadatenkategorie für Auflistungen handelt, die in der Hierarchiestruktur der Verkäufertaxonomie organisiert sind. Beispielsweise ist der Schuhtaxonomieknoten (ID: 1429, Ebene: 1) höher in der Hierarchie als Mädchenschuhe (ID: 1440, Ebene: 2). Die Taxonomieknoten, die einer Auflistung zugewiesen sind, unterstützen den Zugriff auf bestimmte standardisierte Produktskalen und -eigenschaften. Listen, denen beispielsweise die Taxonomieknoten Schuhe oder Mädchenschuhe zugewiesen wurden, unterstützen den Zugriff auf die EU-Schuhgrößenskala mit den zugehörigen Eigenschaftsnamen und IDs für EU-Schuhgrößen, z. B. Eigenschaft value_id:1394 und name:38.

Ebene
level integer

Die ganzzahlige Tiefe dieses Taxonomieknotens in der Verkäufertaxonomiestruktur mit Wurzeln auf Ebene 0.

Name
name string

Die Namenszeichenfolge für diesen Taxonomieknoten.

Übergeordnete ID
parent_id integer

Die numerische Taxonomie-ID des übergeordneten Elements dieses Knotens.

Kinder
children array of SellerTaxonomyNode

Ein Array von Taxonomieknoten für alle direkten untergeordneten Elemente dieses Taxonomieknotens in der Taxanomy-Struktur des Verkäufers.

Taxonomiepfad-IDs
full_path_taxonomy_ids array of integer

Ein Array von Taxonomie-IDs, einschließlich dieses Knotens und aller direkten übergeordneten Knoten in der Verkäufertaxonomiestruktur bis zu einem Stammknoten. Sie werden von Der Wurzel zum Blatt aufgelistet.

TaxonomyNodeProperties

Eine Liste der Produkteigenschaftendefinitionen.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der Ergebnisse.

Ergebnisse
results array of TaxonomyNodeProperty

Die Liste der angeforderten Ressourcen.

TaxonomyNodeProperty

Eine Produkteigenschaftsdefinition.

Name Pfad Typ Beschreibung
Eigenschaften-ID
property_id integer

Die eindeutige numerische ID dieser Produkteigenschaft.

Name
name string

Die Namenszeichenfolge für diesen Taxonomieknoten.

Anzeigename
display_name string

Die Zeichenfolge für die lesbare Produkteigenschaft.

Waage
scales array of TaxonomyPropertyScale

Eine Liste der verfügbaren Skalierungen.

Ist erforderlich
is_required boolean

Bei "true" erfordern Auflistungen, denen berechtigte Taxonomie-IDs zugewiesen wurden, diese Eigenschaft.

Unterstützt Attribute
supports_attributes boolean

Wenn true, können Sie diese Eigenschaft in Eintragsattributen verwenden.

Unterstützt Variationen
supports_variations boolean

Wenn dies der Fall ist, können Sie diese Eigenschaft in Eintragsvariationen verwenden.

Ist mehrwertige Werte
is_multivalued boolean

Wenn wahr, können Sie dieser Eigenschaft mehrere Eigenschaftswerte zuweisen.

Mögliche Werte
possible_values array of TaxonomyPropertyValue

Eine Liste der unterstützten Eigenschaftswertzeichenfolgen für diese Eigenschaft.

Ausgewählte Werte
selected_values array of TaxonomyPropertyValue

Eine Liste der Eigenschaftswertzeichenfolgen automatisch und immer für die angegebene Eigenschaft ausgewählt.

TaxonomyPropertyScale

Eine Skalierungsverzögerung der zuzuweisenden Inkremente für die Eigenschaftswerte, die für bestimmte Produkteigenschaften verfügbar sind.

Name Pfad Typ Beschreibung
Skalierungs-ID
scale_id integer

Die eindeutige numerische ID einer Skalierung.

Anzeigename
display_name string

Die Namenszeichenfolge für eine Skalierung.

Description
description string

Die Beschreibungszeichenfolge für eine Skalierung.

TaxonomyPropertyValue

Ein Eigenschaftswert für eine bestimmte Produkteigenschaft, die auch eine bestimmte Skalierung verwenden kann.

Name Pfad Typ Beschreibung
Wert-ID
value_id integer

Die numerische ID dieses Eigenschaftswerts.

Name
name string

Die Namenszeichenfolge dieses Eigenschaftswerts.

Skalierungs-ID
scale_id integer

Die numerische Skalierungs-ID der Skalierung, zu der dieser Eigenschaftswert gehört.

Gleich
equal_to array of integer

Eine Liste mit numerischen Eigenschaftswert-IDs ist gleich (falls vorhanden).

ShippingCarriers

Stellt mehrere ShippingCarriers dar.

Name Pfad Typ Beschreibung
count
count integer
results
results array of ShippingCarrier

ShippingCarrier

Ein unterstützter Versandunternehmen, der zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Name Pfad Typ Beschreibung
Versandnetzbetreiber-ID
shipping_carrier_id integer

Die numerische ID dieses Versandunternehmens.

Name
name string

Der Name dieses Versandunternehmens.

Inlandsklassen
domestic_classes array of ShippingCarrierMailClass

Set of domestic mail classes of this shipping carrier.

Internationale Kurse
international_classes array of ShippingCarrierMailClass

Satz internationaler E-Mail-Klassen dieses Versandunternehmens.

ShippingCarrierMailClass

Die E-Mail-Klasse eines Versandunternehmens, die zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Name Pfad Typ Beschreibung
E-Mail-Klassen-ID
mail_class_key string

Der eindeutige Bezeichner dieser E-Mail-Klasse.

Name
name string

Der Name dieser E-Mail-Klasse.

Geschäfte

Eine Reihe von Shop-Datensätzen.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Gesamtzahl der Geschäfte

Ergebnisse
results array of Shop

Die Shop-Ressourcen.

ShopSection

Ein Abschnitt in einem Shop, in den ein Benutzer Einträge sortieren kann.

Name Pfad Typ Beschreibung
Shopabschnitts-ID
shop_section_id integer

Die numerische ID eines Abschnitts in einem bestimmten Webshop.

Title
title string

Die Titelzeichenfolge für einen Shopabschnitt.

Rang
rank integer

Die positive Nicht-Null-Numerische Position dieses Abschnitts in der Abschnittsanzeigereihenfolge für einen Shop, wobei rang 1 Abschnitte zuerst angezeigt werden.

Benutzer-ID
user_id integer

Die numerische ID des Benutzers, der diesen Shopabschnitt besitzt.

Aktive Auflistungsanzahl
active_listing_count integer

Die Anzahl der aktiven Auflistungen in einem Abschnitt eines bestimmten Webshops.

ShopSections

Alle Abschnitte in einem sprecific Shop.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der Ergebnisse.

Ergebnisse
results array of ShopSection

Die Liste der angeforderten Ressourcen.

ShopShippingProfile

Stellt ein Profil dar, das zum Festlegen der Versandinformationen eines Eintrags verwendet wird. Bitte beachten Sie, dass es nicht möglich ist, berechnete Versandvorlagen über die API zu erstellen. Sie können jedoch berechnete Versandprofile, die von Shop Manager erstellt wurden, mit Auflistungen mithilfe der API verknüpfen.

Name Pfad Typ Beschreibung
Versandprofil-ID
shipping_profile_id integer

Die numerische ID des Versandprofils.

Title
title string

Die Namenszeichenfolge dieses Versandprofils.

Benutzer-ID
user_id integer

Die numerische ID für den Benutzer, der das Versandprofil besitzt.

Mindestverarbeitungstage
min_processing_days integer

Die mindeste Anzahl von Tagen für die Verarbeitung des Eintrags.

Maximale Verarbeitungszeit
max_processing_days integer

Die maximale Anzahl von Tagen für die Verarbeitung des Eintrags.

Bezeichnung für Verarbeitungstage
processing_days_display_label string

Übersetzte Anzeigebezeichnungszeichenfolge für verarbeitungstage.

Ursprungsland ISO
origin_country_iso string

Der ISO-Code des Landes, aus dem der Eintrag ausgeliefert wird.

Ist gelöscht
is_deleted boolean

Wenn wahr, hat jemand dieses Versandprofil gelöscht.

Versandprofilziele
shipping_profile_destinations array of ShopShippingProfileDestination

Eine Liste der Versandprofilziele, die für dieses Versandprofil verfügbar sind.

Aktualisierungen des Versandprofils
shipping_profile_upgrades array of ShopShippingProfileUpgrade

Eine Liste der Für dieses Versandprofil verfügbaren Versandprofilupgrades.

Origin Postleitzahl
origin_postal_code string

Die Postleitzahlenzeichenfolge (nicht unbedingt eine Zahl) für den Standort, von dem der Eintrag ausgeliefert wird.

Profiltyp
profile_type ProfileType

ShopShippingProfileDestination

Stellt ein Versandziel dar, das einem Versandprofil zugewiesen ist.

Name Pfad Typ Beschreibung
Ziel-ID des Versandprofils
shipping_profile_destination_id integer

Die numerische ID des Versandprofilziels im Dem Eintrag zugeordneten Versandprofil.

Versandprofil-ID
shipping_profile_id integer

Die numerische ID des Versandprofils.

Ursprungsland ISO
origin_country_iso string

Der ISO-Code des Landes, aus dem der Eintrag ausgeliefert wird.

Zielland ISO
destination_country_iso string

Der ISO-Code des Landes, in das der Eintrag ausgeliefert wird. Wenn NULL, legt die Anforderung das Ziel auf destination_region

DestinationRegion
destination_region DestinationRegion

Der Code der Region, in die der Eintrag ausgeliefert wird. Eine Region stellt eine Reihe von Ländern dar. Unterstützte Regionen sind die Europäische Union und die Nicht-Europäische Union (Länder in Europa, die nicht in der EU sind). Wenn keines vorhanden ist, legt die Anforderung das Ziel auf destination_country_iso oder überall fest, wenn destination_country_iso ebenfalls NULL ist.

Geld
primary_cost Money

Eine Darstellung eines Geldbetrags.

Geld
secondary_cost Money

Eine Darstellung eines Geldbetrags.

Versandnetzbetreiber-ID
shipping_carrier_id integer

Die eindeutige ID eines unterstützten Versandunternehmens, das zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Mail-Klasse
mail_class string

Die eindeutige ID-Zeichenfolge der E-Mail-Klasse eines Versandunternehmens, die zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Mindestzustelltage
min_delivery_days integer

Die mindeste Anzahl von Werktagen, die ein Käufer erwarten kann, auf den Empfang seines gekauften Artikels zu warten, sobald er ausgeliefert wurde.

Maximale Lieferzeit
max_delivery_days integer

Die maximale Anzahl von Werktagen, die ein Käufer erwarten kann, bis er seinen gekauften Artikel erhält, sobald er ausgeliefert wurde.

ShopShippingProfileUpgrade

Eine Darstellung einer Upgradeoption für das Versandprofil.

Name Pfad Typ Beschreibung
Versandprofil-ID
shipping_profile_id integer

Die numerische ID des Basisversandprofils.

Upgrade-ID
upgrade_id integer

Die numerische ID, die einem Versandupgrade zugeordnet ist

Upgradename
upgrade_name string

Name für das Versandupgrade, das käufern beim Auschecken angezeigt wird, z. B. USPS Priority.

Typ
type Type

Der Typ des Versandupgrades. Inland (0) oder international (1).

Rang
rank integer

Die positive numerische Position ungleich Null in den Bildern, die in einer Auflistung angezeigt werden, wobei die Rang 1-Bilder in der linken Position in einer Auflistung angezeigt werden.

Language
language string

Das IETF-Sprachtag für die Sprache des Versandprofils. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru.

Geld
price Money

Eine Darstellung eines Geldbetrags.

Geld
secondary_price Money

Eine Darstellung eines Geldbetrags.

Versandnetzbetreiber-ID
shipping_carrier_id integer

Die eindeutige ID eines unterstützten Versandunternehmens, das zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Mail-Klasse
mail_class string

Die eindeutige ID-Zeichenfolge der E-Mail-Klasse eines Versandunternehmens, die zum Berechnen eines geschätzten Lieferdatums verwendet wird.

Mindestzustelltage
min_delivery_days integer

Die mindeste Anzahl von Werktagen, die ein Käufer erwarten kann, auf den Empfang seines gekauften Artikels zu warten, sobald er ausgeliefert wurde.

Maximale Lieferzeit
max_delivery_days integer

Die maximale Anzahl von Werktagen, die ein Käufer erwarten kann, bis er seinen gekauften Artikel erhält, sobald er ausgeliefert wurde.

ShopShippingProfileDestinations

Stellt eine Liste der Zielobjekte des Versands dar.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der Ergebnisse.

Ergebnisse
results array of ShopShippingProfileDestination

Die Liste der angeforderten Ressourcen.

ShopShippingProfileUpgrades

Eine Liste der Versandupgradeoptionen.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der Ergebnisse.

Ergebnisse
results array of ShopShippingProfileUpgrade

Die Liste der angeforderten Ressourcen.

UserAddress

Stellt die Adresse eines Benutzers dar.

Name Pfad Typ Beschreibung
Benutzeradressen-ID
user_address_id integer

Die numerische ID der Adresse des Benutzers.

Benutzer-ID
user_id integer

Die numerische ID des Benutzers.

Name
name string

Der Name des Benutzers für diese Adresse.

Erste Adresszeile
first_line string

Die erste Zeile der Benutzeradresse.

Zweite Adresszeile
second_line string

Die zweite Zeile der Adresse des Benutzers.

Stadt
city string

Das Ortsfeld der Adresse des Benutzers.

Staat
state string

Das Statusfeld der Adresse des Benutzers.

PLZ
zip string

Das Postleitzahlfeld der Adresse des Benutzers.

Ländercode ISO
iso_country_code string

Der ISO-Code des Landes in dieser Adresse.

Country
country_name string

Der Name des Landes des Benutzers.

Ist Die Standardversandadresse
is_default_shipping_address boolean

Ist dies die Standardversandadresse des Benutzers.

UserAddresses

Stellt mehrere UserAddress-Einträge dar.

Name Pfad Typ Beschreibung
Anzahl
count integer

Die Anzahl der zurückgegebenen UserAddress-Datensätze.

Ergebnisse
results array of UserAddress

Ein Array von UserAddress-Ressourcen.

DestinationRegion

Der Code der Region, in die der Eintrag ausgeliefert wird. Eine Region stellt eine Reihe von Ländern dar. Unterstützte Regionen sind die Europäische Union und die Nicht-Europäische Union (Länder in Europa, die nicht in der EU sind). Wenn keines vorhanden ist, legt die Anforderung das Ziel auf destination_country_iso oder überall fest, wenn destination_country_iso ebenfalls NULL ist.

Der Code der Region, in die der Eintrag ausgeliefert wird. Eine Region stellt eine Reihe von Ländern dar. Unterstützte Regionen sind die Europäische Union und die Nicht-Europäische Union (Länder in Europa, die nicht in der EU sind). Wenn keines vorhanden ist, legt die Anforderung das Ziel auf destination_country_iso oder überall fest, wenn destination_country_iso ebenfalls NULL ist.

DestinationRegion
string

ItemDimensionsUnit

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Abmessungen des Produkts verwendet werden. Der Standardwert ist NULL.

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Abmessungen des Produkts verwendet werden. Der Standardwert ist NULL.

ItemDimensionsUnit
string

ItemWeightUnit

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Gewichtung des Produkts verwendet werden. Der Standardwert ist NULL.

Eine Zeichenfolge, die die Einheiten definiert, die zum Messen der Gewichtung des Produkts verwendet werden. Der Standardwert ist NULL.

ItemWeightUnit
string

Gelegenheit

Eine aufgezählte Zeichenfolge, die eine Gelegenheit angibt, für die dieses Produkt ein geeignetes Geschenk machen würde. Der Standardwert ist NULL.

Eine aufgezählte Zeichenfolge, die eine Gelegenheit angibt, für die dieses Produkt ein geeignetes Geschenk machen würde. Der Standardwert ist NULL.

Gelegenheit
string

Profiltyp

Profiltyp
string

Recipient

Eine aufgezählte Zeichenfolge, die eine Person angibt, für die dieses Produkt ein geeignetes Geschenk machen würde. Der Standardwert ist NULL.

Eine aufgezählte Zeichenfolge, die eine Person angibt, für die dieses Produkt ein geeignetes Geschenk machen würde. Der Standardwert ist NULL.

Recipient
string

Staat

Eine aufgezählte Zeichenfolge aus einer von: aktiv oder inaktiv. Hinweis: Wenn Sie einen Entwurfseintrag auf "aktiv" festlegen, wird die Auflistung auch auf etsy.com veröffentlicht.

Eine aufgezählte Zeichenfolge aus einer von: aktiv oder inaktiv. Hinweis: Wenn Sie einen Entwurfseintrag auf "aktiv" festlegen, wird die Auflistung auch auf etsy.com veröffentlicht.

Staat
integer

Typ

Der Typ des Versandupgrades. Inland (0) oder international (1).

Der Typ des Versandupgrades. Inland (0) oder international (1).

Typ
integer

WhenMade

Eine aufgezählte Zeichenfolge für die Ära, in der der Hersteller das Produkt in diesem Eintrag gemacht hat. Hilft Käufern, den Eintrag unter der Vintage-Überschrift zu finden. Erfordert "is_supply" und "who_made".

Eine aufgezählte Zeichenfolge für die Ära, in der der Hersteller das Produkt in diesem Eintrag gemacht hat. Hilft Käufern, den Eintrag unter der Vintage-Überschrift zu finden. Erfordert "is_supply" und "who_made".

WhenMade
string

WhoMade

Eine aufgezählte Zeichenfolge, die das Produkt erstellt hat. Hilft Käufern, den Eintrag unter der Handgemachten Überschrift zu finden. Erfordert "is_supply" und "when_made".

Eine aufgezählte Zeichenfolge, die das Produkt erstellt hat. Hilft Käufern, den Eintrag unter der Handgemachten Überschrift zu finden. Erfordert "is_supply" und "when_made".

WhoMade
string