Etsy (nezávislý vydavatel)

Tento konektor používá klíč rozhraní API pro přístup k různým funkcím Etsy.com. Podporuje akce pro inventarizaci, prodejní objednávky a správu obchodů. Všechny akce jsou založené na rozhraní Etsy Open API v3, které obsahuje koncové body, které jsou stále v beta verzi. Pokud například akce používají beta rozhraní API, akce obsahující beta verzi v názvu a vrátí kód odpovědi 501.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Logic Apps	Standard	Všechny oblasti Logic Apps s výjimkou následujících:      – Oblasti Azure Government      – Oblasti Azure China      - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Power Automate	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)

Kontakt
Název	Troy Taylor
URL	https://www.hitachisolutions.com
Email	ttaylor@hitachisolutions.com

Metadata konektoru
Vydavatel	Troy Taylor, Hitachi Solutions
Internetová stránka	https://www.etsy.com/
Zásady ochrany osobních údajů	https://www.etsy.com/legal/privacy/
Kategorie	Commerce

Vytvoření připojení

Konektor podporuje následující typy ověřování:

výchozí	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
klíč rozhraní API	securestring	Klíč rozhraní API pro toto rozhraní API	Pravdivé

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	100	60 sekund

Akce

Aktualizace cíle expedičního profilu	Aktualizuje existující expediční cíl, který může nastavit nebo znovu přiřadit přepravní náklady, dopravce a třídu pro cíl.
Aktualizace expedičního profilu	Změní nastavení v expedičním profilu.
Aktualizace inventáře výpisu	Aktualizuje inventář pro výpis identifikovaný ID výpisu. Aktualizace selže, pokud zadané hodnoty pro skladovou položku produktu, množství nabídek a/nebo cena nejsou kompatibilní s hodnotami v polích vlastností. Při nastavování ceny přiřaďte plovoucí hodnotu, která se rovná množství děliteli, jak je uvedeno v peněžním zdroji.
Aktualizace obchodu	Aktualizujte obchod. Předpokládá, že všechny parametry řetězce jsou k dispozici v primárním jazyce obchodu.
Aktualizace obrázků variant výpisu	Vytvoří obrázky variant ve výpisu.
Aktualizace překladu výpisu	Aktualizuje překlad výpisu podle ID výpisu a jazyka.
Aktualizace upgradu expedičního profilu	Aktualizuje upgrade expedičního profilu a aktualizuje všechny výpisy, které používají expediční profil.
Aktualizace vlastnosti výpisu	Aktualizuje nebo naplní seznam vlastností definující nabídky produktů pro výpis. Každá nabídka vyžaduje hodnotu i ID hodnoty, které jsou platné pro ID škálování přiřazené k výpisu nebo které přiřadíte výpisu pomocí tohoto požadavku.
Aktualizace výpisu	Aktualizuje výpis identifikovaný ID výpisu pro konkrétní obchod identifikovaný ID obchodu.
Hledat obchody	Vrátí seznam obchodů s odpovídajícím názvem.
Nahrání obrázku výpisu	Nahraje nebo přiřadí obrázek k výpisu identifikovanému ID obchodu s ID výpisu. Pokud chcete nahrát nový obrázek, nastavte soubor image jako hodnotu parametru image. Dříve odstraněný obrázek můžete přiřadit výpisu pomocí ID image odstraněného obrázku v parametru ID výpisu obrázku. Pokud požadavek obsahuje hodnoty parametrů image i výpis ID obrázku, koncový bod nahraje obrázek pouze do parametru image.
Nahrání souboru výpisu	Nahraje nový soubor pro digitální výpis nebo přidruží existující soubor ke konkrétnímu výpisu. Musíte zadat ID souboru výpisu existujícího souboru nebo název a binární data souboru, aby se soubor nahrál. Přidružení existujícího souboru k fyzickému výpisu převede fyzický výpis na digitální výpis, který odebere všechny náklady na dopravu a všechny varianty produktů a zásob.
Načtení transakcí výpisu	Načte seznam transakcí přidružených k výpisu.
Odstranění cíle expedičního profilu	Odstraní cíl expedice a odebere cílovou možnost z každého výpisu, který používá přidružený expediční profil. Expediční profil vyžaduje alespoň jeden cíl expedice, takže tento koncový bod nemůže odstranit konečný cíl expedice pro žádný expediční profil. Chcete-li odstranit konečný cíl expedice z expedičního profilu, musíte odstranit celý expediční profil.
Odstranění expedičního profilu	Odstraní expediční profil podle daného ID.
Odstranění obrázku výpisu	Odstraní obrázek výpisu. Kopie souboru zůstane na našich serverech, takže odstraněná image může být znovu přidružena k výpisu bez opětovného nahrání původního obrázku.
Odstranění souboru ze výpisu	Když odstraníte konečný soubor digitálního výpisu, převede se výpis na fyzický výpis. Odpověď na žádost o odstranění vrátí seznam zbývajících záznamů souboru přidružených k danému výpisu.
Odstranění upgradu expedičního profilu	Odstraní upgrade expedičního profilu a odebere možnost upgradu z každého výpisu, který používá přidružený expediční profil.
Odstranění vlastnosti výpisu	Odstraní vlastnost ze výpisu.
Odstranění výpisu	Tato akce odstraní výpis obchodu. Výpis lze odstranit pouze v případě, že je stav jeden z následujících: SOLD_OUT, KONCEPT, KONEC PLATNOSTI, NEAKTIVNÍ, AKTIVNÍ a is_available nebo AKTIVNÍ a má příznaky prodejce: SUPRESSED (zmrazeno), VACATION, CUSTOM_SHOPS (vzor), SELL_ON_FACEBOOK
Ping	Zkontrolujte připojení k rozhraní Etsy API pomocí aplikace.
Vytvoření cíle expedičního profilu	Vytvoří nový cíl expedice, který nastaví náklady na dopravu, dopravce a třídu pro cíl v expedičním profilu. Tím se přiřazují náklady pomocí měny přidruženého obchodu. Nastavte cíl pomocí cílové země ISO nebo cílové oblasti; cílová země ISO a cílová oblast se vzájemně vylučují – nastavte jednu nebo druhou. Nastavení obou aktivačních událostí chyby 400 Pokud požadavek nenastaví cílovou zemi ISO ani cílovou oblast, výchozí cíl je všude. Musíte také přiřadit ID přepravního dopravce i poštovní třídu nebo minimální dobu doručení i maximální počet dnů doručení.
Vytvoření expedičního profilu	Vytvoří nový expediční profil. Při vytváření expedičního profilu můžete předat kód ISO země nebo oblast, ale ne obojí. Vyžaduje se jenom jeden. Musíte předat BUĎ ID přepravního dopravce a třídu pošty, nebo minimální i maximální dobu doručení.
Vytvoření oddílu obchodu	Vytvoří nový oddíl v konkrétním obchodě.
Vytvoření potvrzení o zásilce	Odešle informace o sledování pro potvrzení o prodejně, které vytvoří položku potvrzení o prodejně pro dané ID potvrzení. Pokaždé, když úspěšně odešlete informace o sledování, odešle Etsy e-mail s oznámením uživateli kupujícího. Při odeslání skryté kopie platí, že Etsy odesílá oznámení o expedičním oznámení také prodejci. Pokud se sledovací kód a jméno dopravce neodesílají, potvrzení se označí jenom jako expedované.
Vytvoření překladu výpisu	Vytvoří překlad výpisu podle ID výpisu a jazyka.
Vytvoření upgradu expedičního profilu	Vytvoří nový upgrade expedičního profilu, který může stanovit cenu pro přepravní možnost, jako je alternativní dopravce nebo rychlejší doručení.
Vytvoření výpisu konceptu	Vytvoří fyzický produkt s výpisem konceptu v obchodě v kanálu Etsy.
Získat oddíl obchodu	Načte oddíl obchodu, na který odkazuje ID oddílu a ID obchodu.
Získání adresy uživatele	Načte adresu uživatele. Probíhá vývoj pro tento koncový bod. Vrátí pouze odpověď 501.
Získání aktivních výpisů	Seznam všech aktivních výpisů na stránkované Etsy podle data vytvoření Bez výpisů pořadí řazení se ve výchozím nastavení vrátí nejnovější.
Získání aktivních výpisů podle obchodu	Načte seznam všech aktivních výpisů v Etsy v konkrétním obchodě, stránkovaný podle data vytvoření výpisu.
Získání cílů profilu podle expedičního profilu	Načte seznam cílových objektů expedice přidružených k expedičnímu profilu.
Získání doporučených výpisů podle obchodu	Načte výpisy přidružené k obchodu, který je doporučený.
Získání expedičních profilů	Načte seznam expedičních profilů dostupných v konkrétním obchodě Etsy identifikovaný podle ID obchodu.
Získání expedičního profilu	Načte expediční profil odkazovaný podle ID expedičního profilu.
Získání inventáře výpisu	Načte záznam inventáře pro výpis. Výpisy, které jste neupravovali pomocí nástrojů inventáře Etsy.com, nemají žádné záznamy inventáře. Tento koncový bod vrátí data skladové položky, pokud jste vlastníkem načtených záznamů inventáře.
Získání nabídky výpisu	Získejte nabídku pro výpis.
Získání obchodu podle ID vlastníka	Načte obchod identifikovaný ID uživatele vlastníka obchodu.
Získání obrázku výpisu	Načte odkazy a metadata pro výpis obrázku s konkrétním ID obrázku.
Získání obrázků variant výpisu	Získá všechny variantní obrázky na výpisu.
Získání obrázků výpisu	Načte všechny prostředky výpisu obrázků pro výpis s konkrétním ID výpisu.
Získání oddílů obchodu	Načte seznam oddílů obchodu v konkrétním obchodě identifikované ID obchodu.
Získání platby z ID položky registru platebního účtu	Pokud je to možné, získejte platbu z ID položky platebního účtu.
Získání platby z konkrétního potvrzení	Načte platbu z konkrétního účtenky, která je identifikována ID účtenky, z konkrétního obchodu identifikovaného ID obchodu.
Získání položek registru platebních účtů v obchodě	Načtěte položky registru platebního účtu v obchodě.
Získání potvrzení	Načte potvrzení identifikované ID účtenky z obchodu Etsy.
Získání produktu výpisu	Načte výpis produktu podle ID.
Získání překladu výpisu	Vrátí překlad výpisu v daném jazyce.
Získání přepravních dopravců	Načte seznam dostupných přepravních dopravců a tříd pošty přidružených k nim pro danou zemi.
Získání recenzí	Načte recenze z obchodu s id.
Získání seznamu plateb	Načte seznam plateb z obchodu identifikovaného ID obchodu. Výsledky můžete filtrovat také pomocí seznamu ID plateb.
Získání souboru ze výpisu	Načte jeden soubor přidružený k danému digitálnímu výpisu. Žádost o soubor z fyzického výpisu vrátí prázdný výsledek.
Získání transakce	Načte transakci podle ID transakce.
Získání transakce obchodu	Načte seznam transakcí přidružených k obchodu.
Získání transakce účtenky	Načte seznam transakcí přidružených ke konkrétnímu potvrzení.
Získání upgradů expedičního profilu	Načte seznam upgradů expedičního profilu přiřazeného ke konkrétnímu expedičnímu profilu.
Získání uzlů taxonomie prodejce	Načte celý strom hierarchie uzlů taxonomie prodejce.
Získání uživatele	Vrátí profil uživatele identifikovaný ID uživatele.
Získání uživatelských adres	Načte seznam uživatelských adres.
Získání vlastnosti výpisu (beta verze)	Načte vlastnost výpisu. Probíhá vývoj pro tento koncový bod. Vrátí pouze odpověď 501.
Získání vlastností produktu podle ID taxonomie	Načte seznam vlastností produktu s příslušnými měřítky a hodnotami podporovanými pro konkrétní ID taxonomie prodejce.
Získání vlastností výpisu	Vrátí seznam vlastností výpisu.
Získání výpisu	Načte záznam výpisu podle ID výpisu.
Získání výpisů podle ID	Umožňuje dotazovat více ID výpisu najednou. Omezte maximálně 100 ID na dotaz.
Získání výpisů podle ID oddílu obchodu	Načte všechny výpisy z oddílu konkrétního obchodu.
Získání výpisů podle obchodu	Vrátí výpisy, které patří do obchodu. Výpisy lze filtrovat pomocí parametru stavu.
Získání výpisů podle účtenky obchodu	Získá všechny výpisy přidružené k potvrzení.
Získání všech souborů výpisu	Načte všechny soubory přidružené k danému digitálnímu výpisu. Žádost o soubory z fyzického výpisu vrátí prázdný výsledek.
Získání účtenek	Požádá o účtenky z konkrétního obchodu, nefiltrované nebo filtrované podle rozsahu ID účtenky nebo posunu, data, placeného a/nebo expedovaného nákupu.

Aktualizace cíle expedičního profilu

ID operace:

ShippingUpdateProfileDestination

Aktualizuje existující expediční cíl, který může nastavit nebo znovu přiřadit přepravní náklady, dopravce a třídu pro cíl.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	string	Číselné ID expedičního profilu přidruženého k výpisu.
ID cíle expedičního profilu	shipping_profile_destination_id	True	string	Číselné ID cílového profilu expedice asociované s výpisem.
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

Návraty

Představuje expediční cíl přiřazený k expedičnímu profilu.

ShopShippingProfileDestination

ShopShippingProfileDestination

Aktualizace expedičního profilu

ID operace:

ShippingUpdateProfile

Změní nastavení v expedičním profilu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.
Title	title		string	Řetězec názvu tohoto expedičního profilu.
Země původu – ISO	origin_country_iso		string	Kód ISO země, ze které se seznam dodává.
Minimální doba zpracování	min_processing_time		integer	Minimální doba potřebná ke zpracování výpisů s tímto expedičním profilem.
Maximální doba zpracování	max_processing_time		integer	Maximální doba zpracování, po které se musí výpis odeslat.
Časová jednotka zpracování	processing_time_unit		string	Jednotka, která se používá k vyjádření doby zpracování. Týden odpovídá 5 pracovním dnům. Pokud není k dispozici žádná položka, je jednotka nastavená na business_days.
PSČ původu	origin_postal_code		string	Řetězec PSČ (nemusí nutně číslo) pro umístění, ze kterého se výpis dodává.

Návraty

Představuje profil použitý k nastavení informací o expedičním výpisu. Upozorňujeme, že prostřednictvím rozhraní API není možné vytvářet počítané šablony expedice. Počítané expediční profily vytvořené z Shop Manageru ale můžete přidružit k výpisům pomocí rozhraní API.

ShopShippingProfile

ShopShippingProfile

Aktualizace inventáře výpisu

ID operace:

ListingUpdateInventory

Aktualizuje inventář pro výpis identifikovaný ID výpisu. Aktualizace selže, pokud zadané hodnoty pro skladovou položku produktu, množství nabídek a/nebo cena nejsou kompatibilní s hodnotami v polích vlastností. Při nastavování ceny přiřaďte plovoucí hodnotu, která se rovná množství děliteli, jak je uvedeno v peněžním zdroji.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID výpisu	listing_id	True	string	Číselné ID výpisu přidruženého k této transakci.
Products	products	True	string	Pole JSON produktů dostupných v seznamu, i když je jen jeden produkt. Všechny názvy polí v objektech blob JSON jsou malá písmena.
Cena na nemovitosti	price_on_property		string	Pole jedinečných čísel ID vlastnosti výpisu pro vlastnosti, které mění ceny produktů, pokud existuje. Pokud například naúčtujete konkrétní ceny produktů s různou velikostí ve stejném výpisu, bude toto pole obsahovat ID vlastnosti pro velikost.
Quantity on Property	quantity_on_property		string	Pole jedinečných čísel ID vlastnosti výpisu pro vlastnosti, které mění množství produktů, pokud existuje. Pokud například skladujete konkrétní množství různých barevných produktů ve stejném výpisu, bude toto pole obsahovat ID vlastnosti pro barvu.
Skladová položka ve vlastnosti	sku_on_property		string	Pole jedinečných čísel ID vlastnosti výpisu pro vlastnosti, které změní skladovou položku produktu( pokud existuje). Pokud například použijete konkrétní skladové položky pro různé barevné produkty ve stejném výpisu, bude toto pole obsahovat ID vlastnosti pro barvu.

Návraty

Reprezentace záznamu inventáře jednoho výpisu

VýpisInventory

ListingInventory

Aktualizace obchodu

ID operace:

ShopUpdate

Aktualizujte obchod. Předpokládá, že všechny parametry řetězce jsou k dispozici v primárním jazyce obchodu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Title	title		string	Stručný řetězec nadpisu hlavní stránky obchodu.
Oznámení	announcement		string	Řetězec oznámení pro kupující, kteří se zobrazují na domovské stránce obchodu.
Zpráva o prodeji	sale_message		string	Řetězec zprávy odeslaný uživatelům, kteří dokončí nákup z tohoto obchodu.
Digitální zpráva o prodeji	digital_sale_message		string	Řetězec zprávy odeslaný uživatelům, kteří si kupují digitální položku z tohoto obchodu.

Návraty

Obchod vytvořený uživatelem Etsy.

Obchod

Shop

Aktualizace obrázků variant výpisu

ID operace:

ListingUpdateVariation

Vytvoří obrázky variant ve výpisu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Obrázky variant	variation_images	True	string	Pole dat obrázku varianty

Návraty

Představuje několik výpisu obrázků variant.

ListingVariationImages

ListingVariationImages

Aktualizace překladu výpisu

ID operace:

ListingUpdateTranslation

Aktualizuje překlad výpisu podle ID výpisu a jazyka.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Jazyk	language	True	string	Značka jazyka IETF pro jazyk tohoto překladu. Příklad: de, en, es, fr, it, ja, nl, pl, pt, ru.
Title	title	True	string	Název výpisu tohoto překladu.
Description	description	True	string	Popis výpisu tohoto překladu.
Štítky	tags		string	Značky výpisu tohoto překladu.

Návraty

Představuje data překladu pro výpis.

Výpistranslation

ListingTranslation

Aktualizace upgradu expedičního profilu

ID operace:

ShippingUpdateProfileUpgrade

Aktualizuje upgrade expedičního profilu a aktualizuje všechny výpisy, které používají expediční profil.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.
ID upgradu	upgrade_id	True	integer	Číselné ID přidružené k upgradu expedice
Typ	type		string	Typ upgradu expedice. Vnitrostátní (0) nebo mezinárodní (1).
Název upgradu	upgrade_name		string	Název expedičního upgradu zobrazeného pro nakupující v pokladně, např. PRIORITA USPS.
Cena	price		float	Další náklady na přidání upgradu expedice
Sekundární cena	secondary_price		float	Další náklady na přidání upgradu expedice pro každou další položku
ID přepravního dopravce	shipping_carrier_id		integer	Jedinečné ID podporovaného dopravce, který se používá k výpočtu odhadovaného data doručení.
Mail – třída	mail_class		string	Jedinečný řetězec ID poštovní třídy přepravního dopravce, který se používá k výpočtu odhadovaného data doručení.
Minimální počet dnů doručení	min_delivery_days		integer	min_delivery_days
Maximální počet dnů doručení	max_delivery_days		integer	Maximální počet pracovních dnů, které může kupující očekávat, že po odeslání obdrží zakoupenou položku.

Návraty

Reprezentace možnosti upgradu expedičního profilu

ShopShippingProfileUpgrade

ShopShippingProfileUpgrade

Aktualizace vlastnosti výpisu

ID operace:

ListingUpdateProperty

Aktualizuje nebo naplní seznam vlastností definující nabídky produktů pro výpis. Každá nabídka vyžaduje hodnotu i ID hodnoty, které jsou platné pro ID škálování přiřazené k výpisu nebo které přiřadíte výpisu pomocí tohoto požadavku.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
ID vlastnosti	property_id	True	integer	Jedinečné ID vlastnosti výpisu Etsy.
ID hodnot	value_ids	True	integer	Číselné ID jednoho Etsy.com měřítka měření.
Hodnoty	values	True	string	Pole hodnotových řetězců pro více hodnot Etsy výpis hodnot hodnot.
ID škálování	scale_id		integer	Číselné ID jednoho Etsy.com měřítka měření.

Návraty

Reprezentace strukturovaných hodnot dat

ListingPropertyValue

ListingPropertyValue

Aktualizace výpisu

ID operace:

ListingUpdate

Aktualizuje výpis identifikovaný ID výpisu pro konkrétní obchod identifikovaný ID obchodu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Množství	quantity		integer	Kladný nenulový počet produktů, které jsou k dispozici k nákupu v výpisu.
Title	title		string	Řetězec názvu výpisu. Platné řetězce nadpisu obsahují pouze písmena, číslice, interpunkční znaménka, matematické symboly, znaky prázdných znaků, ™ , © a ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Můžete použít pouze %, :, &a + znaky jednou.
Description	description		string	Popisový řetězec produktu k prodeji v seznamu.
Cena	price		float	Kladná nenulová cena produktu. (Prodané výpisy produktů jsou soukromé) Poznámka: Cena je minimální možná cena.
Kdo udělal	who_made		string	Řetězec inidcat, který vytvořil produkt. Pomáhá kupujícím najít výpis pod nadpisem Handmade. Vyžaduje is_supply a when_made.
Při vytváření	when_made		string	Řetězec pro období, ve kterém výrobce vytvořil produkt v tomto výpisu. Pomáhá kupujícím najít výpis pod nadpisem Vintage. Vyžaduje is_supply a who_made.
ID taxonomie	taxonomy_id		integer	ID číselné taxonomie výpisu. Prodejce spravuje id taxonomie pro svůj obchod.
ID expedičního profilu	shipping_profile_id		integer	Číselné ID expedičního profilu přidruženého k výpisu.
Materials	materials		string	Pole materiálových řetězců pro materiály použité v produktu. Platné řetězce materiálů obsahují pouze písmena, číslice a prázdné znaky. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
ID oddílu obchodu	shop_section_id		integer	Číselné ID oddílu obchodu pro tento výpis.
Minimální zpracování	processing_min		integer	Minimální počet dní potřebných ke zpracování tohoto výpisu.
Maximální zpracování	processing_max		integer	Maximální počet dní potřebných ke zpracování tohoto výpisu.
Štítky	tags		string	Pole řetězců značek pro výpis. Platné řetězce značek obsahují pouze písmena, číslice, prázdné znaky, -, ', ™ , © , a ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)
Recipient	recipient		string	Řetězec označující osobu, pro kterou by tento produkt udělal vhodný dárek.
Příležitost	occasion		string	Řetězec označující příležitost, pro kterou by tento produkt udělal vhodný dárek.
Styly	styles		string	Pole stylů řetězců pro tento výpis, z nichž každý je volný textový řetězec, jako je Formal nebo Steampunk. Výpis může mít až dva styly. Platné řetězce stylu obsahují pouze písmena, číslice a prázdné znaky. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Hmotnost položky	item_weight		float	Číselná hmotnost výrobku měřená v jednotkách nastavených v jednotce hmotnosti položky.
Délka položky	item_length		integer	Číselná délka produktu měřená v jednotkách nastavených v jednotce dimenzí položek.
Šířka položky	item_width		float	Číselná šířka výrobku měřená v jednotkách nastavených v "jednotce dimenzí položek".
Výška položky	item_height		float	Číselná výška výrobku měřená v jednotkách nastavených v "jednotce dimenzí položek".
Jednotka hmotnosti položky	item_weight_unit		string	Řetězec definující jednotky použité k měření hmotnosti produktu.
Jednotka dimenzí položek	item_dimensions_unit		string	Řetězec definující jednotky použité k měření rozměrů produktu.
Je personalizovatelná	is_personalizable		boolean	Pokud ano, tento výpis je přizpůsobitelný.
ID obrázků	image_ids		string	Pole ČÍSELNÝCH ID obrázků obrázků ve výpisu, které může obsahovat až 10 obrázků.
Is Supply	is_supply		boolean	Pokud je hodnota true, označí výpis jako produkt dodávky, znamená to, že se jedná o hotový produkt. Pomáhá kupujícím najít výpis pod nadpisem Dodávky. Vyžaduje ,kdo udělal' a 'kdy'.
Je přizpůsobitelný	is_customizable		boolean	Pokud je pravda, může kupující kontaktovat prodejce s přizpůsobenou objednávkou. Výchozí hodnota je true, když obchod přijímá vlastní objednávky. Nevztahuje se na obchody, které nepřijímají vlastní objednávky.
Je zdanitelná	is_taxable		boolean	Pokud je to pravda, příslušné sazby daně z obchodů se vztahují na tento výpis v pokladně.
Doporučené pořadí	featured_ rank		integer	Pozitivní nenulová číselná pozice v doporučených výpisech obchodu s pořadím 1 výpisy, které se zobrazují v pozici nejvíce vlevo v doporučeném výpisu na domovské stránce obchodu.
Mělo by se automaticky prodloužit	should_auto_renew		boolean	Pokud je hodnota true, prodlouží výpis po dobu čtyř měsíců po expriaci. Pokud je nastavená hodnota true v případě dříve nepravdivé hodnoty, etsy.com obnoví výpis před vypršením jeho platnosti, ale období prodloužení začíná nemidiateálně místo prodloužení data vypršení platnosti výpisu. Všechny nevyužité časy zbývající v výpisu se ztratí. Prodloužení vede k poplatkům na faktuře uživatele.
Typ	type		string	Určuje, jestli je výpis fyzický nebo digitální soubor ke stažení.
Channels	channels		string	Pole výčtových řetězců ID kanálu. Kanál je místem pro prodejce, aby se mohli spojit s kupujícími, aby mohli prodávat.

Návraty

Výpis z obchodu, který obsahuje množství produktů, název, popis, cenu atd.

ShopListing

ShopListing

Hledat obchody

ID operace:

ShopSearch

Vrátí seznam obchodů s odpovídajícím názvem.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název obchodu	shop_name	True	string	Řetězec názvu obchodu.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.

Návraty

Sada záznamů v obchodě.

Obchody

Shops

Nahrání obrázku výpisu

ID operace:

ListingUploadImage

Nahraje nebo přiřadí obrázek k výpisu identifikovanému ID obchodu s ID výpisu. Pokud chcete nahrát nový obrázek, nastavte soubor image jako hodnotu parametru image. Dříve odstraněný obrázek můžete přiřadit výpisu pomocí ID image odstraněného obrázku v parametru ID výpisu obrázku. Pokud požadavek obsahuje hodnoty parametrů image i výpis ID obrázku, koncový bod nahraje obrázek pouze do parametru image.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Obrázek	image		string	Řetězec názvu souboru, který chcete nahrát.
Výpis ID obrázku	listing_image_id		integer	Číselné ID primárního výpisu obrázku pro tuto transakci.
Hodnost	rank		integer	Kladná nenulová číselná pozice na obrázcích zobrazených ve výpisu s pořadím 1 obrázků, které se zobrazují v seznamu úplně vlevo.
Přepsat	overwrite		boolean	Pokud je hodnota true, nahradí tento požadavek existující image v daném pořadí.
Je vodoznak	is_watermarked		boolean	Pokud je hodnota true, znamená to, že nahraný obrázek obsahuje vodoznak.

Návraty

Odkazy na adresy URL a metadata obrázku přidruženého ke konkrétnímu výpisu Parametr url_fullxfull obsahuje adresu URL pro soubor binárního obrázku v plné velikosti.

ListingImage

ListingImage

Nahrání souboru výpisu

ID operace:

ListingUpload

Nahraje nový soubor pro digitální výpis nebo přidruží existující soubor ke konkrétnímu výpisu. Musíte zadat ID souboru výpisu existujícího souboru nebo název a binární data souboru, aby se soubor nahrál. Přidružení existujícího souboru k fyzickému výpisu převede fyzický výpis na digitální výpis, který odebere všechny náklady na dopravu a všechny varianty produktů a zásob.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Výpis ID souboru	listing_file_id		integer	Jedinečné číselné ID souboru přidruženého k digitálnímu výpisu.
File	file	True	string	Binární soubor, který se má nahrát.
Název	name		string	Řetězec názvu souboru k nahrání
Hodnost	rank		integer	Kladná nenulová číselná pozice na obrázcích zobrazených ve výpisu s pořadím 1 obrázků, které se zobrazují v seznamu úplně vlevo.

Návraty

Soubor přidružený k digitálnímu výpisu.

ShopListingFile

ShopListingFile

Načtení transakcí výpisu

ID operace:

TransactionsListing

Načte seznam transakcí přidružených k výpisu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.

Návraty

Sadaprostředkůch

ShopReceiptTransactions

ShopReceiptTransactions

Odstranění cíle expedičního profilu

ID operace:

ShippingDeleteProfileDestination

Odstraní cíl expedice a odebere cílovou možnost z každého výpisu, který používá přidružený expediční profil. Expediční profil vyžaduje alespoň jeden cíl expedice, takže tento koncový bod nemůže odstranit konečný cíl expedice pro žádný expediční profil. Chcete-li odstranit konečný cíl expedice z expedičního profilu, musíte odstranit celý expediční profil.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.
ID cíle expedičního profilu	shipping_profile_destination_id	True	integer	Číselné ID cíle expedičního profilu v expedičním profilu přidruženém k výpisu.

Odstranění expedičního profilu

ID operace:

ShippingDeleteProfile

Odstraní expediční profil podle daného ID.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.

Návraty

Představuje profil použitý k nastavení informací o expedičním výpisu. Upozorňujeme, že prostřednictvím rozhraní API není možné vytvářet počítané šablony expedice. Počítané expediční profily vytvořené z Shop Manageru ale můžete přidružit k výpisům pomocí rozhraní API.

ShopShippingProfile

ShopShippingProfile

Odstranění obrázku výpisu

ID operace:

ListingDeleteImage

Odstraní obrázek výpisu. Kopie souboru zůstane na našich serverech, takže odstraněná image může být znovu přidružena k výpisu bez opětovného nahrání původního obrázku.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Výpis ID obrázku	listing_image_id	True	integer	Číselné ID primárního výpisu obrázku pro tuto transakci.

Odstranění souboru ze výpisu

ID operace:

ListingDeleteFile

Když odstraníte konečný soubor digitálního výpisu, převede se výpis na fyzický výpis. Odpověď na žádost o odstranění vrátí seznam zbývajících záznamů souboru přidružených k danému výpisu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Výpis ID souboru	listing_file_id	True	integer	Jedinečné číselné ID souboru přidruženého k digitálnímu výpisu.

Odstranění upgradu expedičního profilu

ID operace:

ShippingDeleteProfileUpgrade

Odstraní upgrade expedičního profilu a odebere možnost upgradu z každého výpisu, který používá přidružený expediční profil.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu.
ID upgradu	upgrade_id	True	integer	Číselné ID přidružené k upgradu expedice

Odstranění vlastnosti výpisu

ID operace:

ListingDeleteProperty

Odstraní vlastnost ze výpisu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
ID vlastnosti	property_id	True	integer	Jedinečné ID vlastnosti výpisu Etsy.

Odstranění výpisu

ID operace:

ListingDelete

Tato akce odstraní výpis obchodu. Výpis lze odstranit pouze v případě, že je stav jeden z následujících: SOLD_OUT, KONCEPT, KONEC PLATNOSTI, NEAKTIVNÍ, AKTIVNÍ a is_available nebo AKTIVNÍ a má příznaky prodejce: SUPRESSED (zmrazeno), VACATION, CUSTOM_SHOPS (vzor), SELL_ON_FACEBOOK

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.

Ping

ID operace:

Ping

Zkontrolujte připojení k rozhraní Etsy API pomocí aplikace.

Návraty

Potvrzení, že aktuální aplikace má přístup k rozhraní Open API

Zápach

Pong

Vytvoření cíle expedičního profilu

ID operace:

ShippingCreateDestination

Vytvoří nový cíl expedice, který nastaví náklady na dopravu, dopravce a třídu pro cíl v expedičním profilu. Tím se přiřazují náklady pomocí měny přidruženého obchodu. Nastavte cíl pomocí cílové země ISO nebo cílové oblasti; cílová země ISO a cílová oblast se vzájemně vylučují – nastavte jednu nebo druhou. Nastavení obou aktivačních událostí chyby 400 Pokud požadavek nenastaví cílovou zemi ISO ani cílovou oblast, výchozí cíl je všude. Musíte také přiřadit ID přepravního dopravce i poštovní třídu nebo minimální dobu doručení i maximální počet dnů doručení.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.
Primární náklady	primary_cost	True	float	Samotné náklady na dopravu do této země/oblasti měřené ve výchozí měně obchodu.
Sekundární náklady	secondary_cost	True	string	Náklady na expedici do této země/oblasti s jinou položkou měřenou ve výchozí měně obchodu.
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

Návraty

Představuje expediční cíl přiřazený k expedičnímu profilu.

ShopShippingProfileDestination

ShopShippingProfileDestination

Vytvoření expedičního profilu

ID operace:

ShippingCreateProfile

Vytvoří nový expediční profil. Při vytváření expedičního profilu můžete předat kód ISO země nebo oblast, ale ne obojí. Vyžaduje se jenom jeden. Musíte předat BUĎ ID přepravního dopravce a třídu pošty, nebo minimální i maximální dobu doručení.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Title	title	True	string	Řetězec názvu tohoto expedičního profilu.
Země původu – ISO	origin_country_iso	True	string	Kód ISO země, ze které se seznam dodává.
Primární náklady	primary_cost	True	float	Samotné náklady na dopravu do této země/oblasti měřené ve výchozí měně obchodu.
Sekundární náklady	secondary_cost	True	float	Náklady na expedici do této země/oblasti s jinou položkou měřenou ve výchozí měně obchodu.
Minimální doba zpracování	min_processing_time	True	integer	Minimální doba potřebná ke zpracování výpisů s tímto expedičním profilem.
Maximální doba zpracování	max_processing_time	True	integer	Maximální doba zpracování, po které se musí výpis odeslat.
Časová jednotka zpracování	processing_time_unit		string	Jednotka, která se používá k vyjádření doby zpracování. Týden odpovídá 5 pracovním dnům.
Iso cílové země	destination_country_iso		string	Kód ISO země, do které se seznam dodává. Pokud je hodnota null, požadavek nastaví cíl do cílové oblasti.
Cílová oblast	destination_region		string	Kód oblasti, do které se seznam dodává. Oblast představuje sadu zemí. Podporované oblasti jsou Evropská unie a Unie mimo Evropu (země v Evropě, nikoli v EU). Pokud žádná, požadavek nastaví cíl do cílové země ISO nebo všude, pokud je cílová země ISO také null.
PSČ původu	origin_postal_code		string	Řetězec PSČ (nemusí nutně číslo) pro umístění, ze kterého se výpis dodává.
ID přepravního dopravce	shipping_carrier_id		integer	Jedinečné ID podporovaného dopravce, který se používá k výpočtu odhadovaného data doručení.
Mail – třída	mail_class		string	Jedinečný řetězec ID poštovní třídy přepravního dopravce, který se používá k výpočtu odhadovaného data doručení.
Minimální počet dnů doručení	min_delivery_days		integer	Minimální počet pracovních dnů, které může kupující očekávat, že po odeslání obdrží zakoupenou položku.
Maximální počet dnů doručení	max_delivery_days		integer	Maximální počet pracovních dnů, které může kupující očekávat, že po odeslání obdrží zakoupenou položku.

Návraty

Představuje profil použitý k nastavení informací o expedičním výpisu. Upozorňujeme, že prostřednictvím rozhraní API není možné vytvářet počítané šablony expedice. Počítané expediční profily vytvořené z Shop Manageru ale můžete přidružit k výpisům pomocí rozhraní API.

ShopShippingProfile

ShopShippingProfile

Vytvoření oddílu obchodu

ID operace:

ShopCreateSection

Vytvoří nový oddíl v konkrétním obchodě.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Title	title	True	string	Řetězec názvu oddílu obchodu.

Návraty

Oddíl v obchodě, do kterého může uživatel řadit výpisy.

ShopSection

ShopSection

Vytvoření potvrzení o zásilce

ID operace:

ReceiptCreateShipment

Odešle informace o sledování pro potvrzení o prodejně, které vytvoří položku potvrzení o prodejně pro dané ID potvrzení. Pokaždé, když úspěšně odešlete informace o sledování, odešle Etsy e-mail s oznámením uživateli kupujícího. Při odeslání skryté kopie platí, že Etsy odesílá oznámení o expedičním oznámení také prodejci. Pokud se sledovací kód a jméno dopravce neodesílají, potvrzení se označí jenom jako expedované.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID potvrzení	receipt_id	True	integer	Potvrzení k odeslání sledování.
Sledovací kód	tracking_code		string	Sledovací kód pro tento příjem.
Jméno dopravce	carrier_name		string	Název dopravce pro tento potvrzení.
Odeslat skrytou kopii	send_bcc		boolean	Pokud je to pravda, oznámení o expedici se odešle také prodejci.

Návraty

Záznam nákupu z obchodu. Účtenky v obchodě zobrazují peněžní hodnoty pomocí měny obchodu.

ShopReceipt

ShopReceipt

Vytvoření překladu výpisu

ID operace:

ListingCreateTranslation

Vytvoří překlad výpisu podle ID výpisu a jazyka.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Jazyk	language	True	string	Značka jazyka IETF pro jazyk tohoto překladu. Příklad: de, en, es, fr, it, ja, nl, pl, pt, ru.
Title	title	True	string	Název výpisu tohoto překladu.
Description	description	True	string	Popis výpisu tohoto překladu.
Štítky	tags		string	Značky výpisu tohoto překladu.

Návraty

Představuje data překladu pro výpis.

Výpistranslation

ListingTranslation

Vytvoření upgradu expedičního profilu

ID operace:

ShippingCreateUpgrade

Vytvoří nový upgrade expedičního profilu, který může stanovit cenu pro přepravní možnost, jako je alternativní dopravce nebo rychlejší doručení.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.
Typ	type	True	string	Typ upgradu expedice. Vnitrostátní (0) nebo mezinárodní (1).
Název upgradu	upgrade_name	True	string	Název expedičního upgradu zobrazeného pro nakupující v pokladně, např. PRIORITA USPS.
Cena	price	True	float	Další náklady na přidání upgradu expedice
Sekundární cena	secondary_price	True	float	Další náklady na přidání upgradu expedice pro každou další položku
ID přepravního dopravce	shipping_carrier_id		integer	Jedinečné ID podporovaného dopravce, který se používá k výpočtu odhadovaného data doručení.
Mail – třída	mail_class		string	Jedinečný řetězec ID poštovní třídy přepravního dopravce, který se používá k výpočtu odhadovaného data doručení.
Minimální počet dnů doručení	min_delivery_days		integer	min_delivery_days
Maximální počet dnů doručení	max_delivery_days		integer	Maximální počet pracovních dnů, které může kupující očekávat, že po odeslání obdrží zakoupenou položku.

Návraty

Reprezentace možnosti upgradu expedičního profilu

ShopShippingProfileUpgrade

ShopShippingProfileUpgrade

Vytvoření výpisu konceptu

ID operace:

ListingCreate

Vytvoří fyzický produkt s výpisem konceptu v obchodě v kanálu Etsy.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Množství	quantity	True	integer	Kladný nenulový počet produktů, které jsou k dispozici k nákupu v výpisu.
Title	title	True	string	Řetězec názvu výpisu. Platné řetězce nadpisu obsahují pouze písmena, číslice, interpunkční znaménka, matematické symboly, znaky prázdných znaků, ™ , © a ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Můžete použít pouze %, :, &a + znaky jednou.
Description	description	True	string	Popisový řetězec produktu k prodeji v seznamu.
Cena	price	True	float	Kladná nenulová cena produktu. (Prodané výpisy produktů jsou soukromé) Poznámka: Cena je minimální možná cena.
Kdo udělal	who_made	True	string	Řetězec inidcat, který vytvořil produkt. Pomáhá kupujícím najít výpis pod nadpisem Handmade. Vyžaduje is_supply a when_made.
Při vytváření	when_made		string	Řetězec pro období, ve kterém výrobce vytvořil produkt v tomto výpisu. Pomáhá kupujícím najít výpis pod nadpisem Vintage. Vyžaduje is_supply a who_made.
ID taxonomie	taxonomy_id	True	integer	ID číselné taxonomie výpisu. Prodejce spravuje id taxonomie pro svůj obchod.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.
Materials	materials		string	Pole materiálových řetězců pro materiály použité v produktu. Platné řetězce materiálů obsahují pouze písmena, číslice a prázdné znaky. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
ID oddílu obchodu	shop_section_id		integer	Číselné ID oddílu obchodu pro tento výpis.
Minimální zpracování	processing_min		integer	Minimální počet dní potřebných ke zpracování tohoto výpisu.
Maximální zpracování	processing_max		integer	Maximální počet dní potřebných ke zpracování tohoto výpisu.
Štítky	tags		string	Pole řetězců značek pro výpis. Platné řetězce značek obsahují pouze písmena, číslice, prázdné znaky, -, ', ™ , © , a ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)
Recipient	recipient		string	Řetězec označující osobu, pro kterou by tento produkt udělal vhodný dárek.
Příležitost	occasion		string	Řetězec označující příležitost, pro kterou by tento produkt udělal vhodný dárek.
Styly	styles		string	Pole stylů řetězců pro tento výpis, z nichž každý je volný textový řetězec, jako je Formal nebo Steampunk. Výpis může mít až dva styly. Platné řetězce stylu obsahují pouze písmena, číslice a prázdné znaky. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Hmotnost položky	item_weight		float	Číselná hmotnost výrobku měřená v jednotkách nastavených v jednotce hmotnosti položky.
Délka položky	item_length		integer	Číselná délka produktu měřená v jednotkách nastavených v jednotce dimenzí položek.
Šířka položky	item_width		float	Číselná šířka výrobku měřená v jednotkách nastavených v "jednotce dimenzí položek".
Výška položky	item_height		float	Číselná výška výrobku měřená v jednotkách nastavených v "jednotce dimenzí položek".
Jednotka hmotnosti položky	item_weight_unit		string	Řetězec definující jednotky použité k měření hmotnosti produktu.
Jednotka dimenzí položek	item_dimensions_unit		string	Řetězec definující jednotky použité k měření rozměrů produktu.
Je personalizovatelná	is_personalizable		boolean	Pokud ano, tento výpis je přizpůsobitelný.
ID obrázků	image_ids		string	Pole ČÍSELNÝCH ID obrázků obrázků ve výpisu, které může obsahovat až 10 obrázků.
Is Supply	is_supply		boolean	Pokud je hodnota true, označí výpis jako produkt dodávky, znamená to, že se jedná o hotový produkt. Pomáhá kupujícím najít výpis pod nadpisem Dodávky. Vyžaduje ,kdo udělal' a 'kdy'.
Je přizpůsobitelný	is_customizable		boolean	Pokud je pravda, může kupující kontaktovat prodejce s přizpůsobenou objednávkou. Výchozí hodnota je true, když obchod přijímá vlastní objednávky. Nevztahuje se na obchody, které nepřijímají vlastní objednávky.
Je zdanitelná	is_taxable		boolean	Pokud je to pravda, příslušné sazby daně z obchodů se vztahují na tento výpis v pokladně.

Návraty

Výpis z obchodu, který obsahuje množství produktů, název, popis, cenu atd.

ShopListing

ShopListing

Získat oddíl obchodu

ID operace:

ShopGetSection

Načte oddíl obchodu, na který odkazuje ID oddílu a ID obchodu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID oddílu obchodu	shop_section_id	True	integer	Číselné ID oddílu v konkrétním obchodě Etsy.

Návraty

Oddíl v obchodě, do kterého může uživatel řadit výpisy.

ShopSection

ShopSection

Získání adresy uživatele

ID operace:

UserGetAddress

Načte adresu uživatele. Probíhá vývoj pro tento koncový bod. Vrátí pouze odpověď 501.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID adresy uživatele	user_address_id	True	integer	Číselné ID adresy uživatele.

Návraty

Představuje adresu uživatele.

UserAddress

UserAddress

Získání aktivních výpisů

ID operace:

ListingGetActive

Seznam všech aktivních výpisů na stránkované Etsy podle data vytvoření Bez výpisů pořadí řazení se ve výchozím nastavení vrátí nejnovější.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.
Includes	keywords		string	Hledaný termín nebo fráze, které se musí zobrazit ve všech výsledcích.
Seřadit podle	sort_on		string	Hodnota, podle které se má řadit výsledek hledání výpisů. POZNÁMKA: Řazení funguje pouze v kombinaci s jednou z možností hledání (klíčová slova, oblast atd.).
Pořadí řazení	sort_order		string	Vzestupné (nahoru) nebo sestupné (dolů) pořadí řazení výpisů podle. POZNÁMKA: sort_order funguje pouze v kombinaci s jednou z možností hledání (klíčová slova, oblast atd.).
Nejnižší cena	min_price		float	Minimální cena výpisů vrácená výsledkem hledání.
Nejvyšší cena	max_price		float	Maximální cena výpisů vrácená výsledkem hledání.
ID taxonomie	taxonomy_id		integer	ID číselné taxonomie výpisu. Prodejce spravuje id taxonomie pro svůj obchod.
Poloha obchodu	shop_location		string	Filtry podle umístění obchodu. Pokud umístění nejde analyzovat, Etsy odpoví chybou.

Návraty

Sada obchodů se seznamem zdrojů.

ShopListings

ShopListings

Získání aktivních výpisů podle obchodu

ID operace:

ListingGetActiveByShop

Načte seznam všech aktivních výpisů v Etsy v konkrétním obchodě, stránkovaný podle data vytvoření výpisu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.
Includes	keywords		string	Hledaný termín nebo fráze, které se musí zobrazit ve všech výsledcích.

Návraty

Sada obchodů se seznamem zdrojů.

ShopListings

ShopListings

Získání cílů profilu podle expedičního profilu

ID operace:

ShippingGetDestinations

Načte seznam cílových objektů expedice přidružených k expedičnímu profilu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.

Návraty

Představuje seznam cílových objektů expedice.

ShopShippingProfileDestinations

ShopShippingProfileDestinations

Získání doporučených výpisů podle obchodu

ID operace:

ListingGetFeatured

Načte výpisy přidružené k obchodu, který je doporučený.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.

Návraty

Sada obchodů se seznamem zdrojů.

ShopListings

ShopListings

Získání expedičních profilů

ID operace:

ShippingProfiles

Načte seznam expedičních profilů dostupných v konkrétním obchodě Etsy identifikovaný podle ID obchodu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.

Návraty

Představuje profil použitý k nastavení informací o expedičním výpisu. Upozorňujeme, že prostřednictvím rozhraní API není možné vytvářet počítané šablony expedice. Počítané expediční profily vytvořené z Shop Manageru ale můžete přidružit k výpisům pomocí rozhraní API.

ShopShippingProfile

ShopShippingProfile

Získání expedičního profilu

ID operace:

ShippingGetProfile

Načte expediční profil odkazovaný podle ID expedičního profilu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.

Získání inventáře výpisu

ID operace:

ListingGetInventory

Načte záznam inventáře pro výpis. Výpisy, které jste neupravovali pomocí nástrojů inventáře Etsy.com, nemají žádné záznamy inventáře. Tento koncový bod vrátí data skladové položky, pokud jste vlastníkem načtených záznamů inventáře.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Includes	includes		string	Výčet řetězce, který připojí platné přidružení.

Návraty

Reprezentace záznamu inventáře s jedním výpisem s přidruženími

ListingInventoryWithAssociations

ListingInventoryWithAssociations

Získání nabídky výpisu

ID operace:

ListingGetOffering

Získejte nabídku pro výpis.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
ID produktu	product_id	True	integer	Číselné ID produktu přidruženého k této transakci.
ID nabídky produktů	product_offering_id	True	integer	Číselné ID nabídky produktu přidružené k této transakci.

Návraty

Reprezentace nabídky pro výpis.

VýpisInventoryProductOffering

ListingInventoryProductOffering

Získání obchodu podle ID vlastníka

ID operace:

ShopGetByOwnerID

Načte obchod identifikovaný ID uživatele vlastníka obchodu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID uživatele	user_id	True	string	Číselné ID uživatele uživatele, který tento obchod vlastní.

Návraty

Obchod vytvořený uživatelem Etsy.

Obchod

Shop

Získání obrázku výpisu

ID operace:

ListingGetImage

Načte odkazy a metadata pro výpis obrázku s konkrétním ID obrázku.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Výpis ID obrázku	listing_image_id	True	integer	Číselné ID primárního výpisu obrázku pro tuto transakci.

Návraty

Odkazy na adresy URL a metadata obrázku přidruženého ke konkrétnímu výpisu Parametr url_fullxfull obsahuje adresu URL pro soubor binárního obrázku v plné velikosti.

ListingImage

ListingImage

Získání obrázků variant výpisu

ID operace:

ListingGetVariation

Získá všechny variantní obrázky na výpisu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.

Návraty

Představuje několik výpisu obrázků variant.

ListingVariationImages

ListingVariationImages

Získání obrázků výpisu

ID operace:

ListingGetImages

Načte všechny prostředky výpisu obrázků pro výpis s konkrétním ID výpisu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.

Návraty

Představuje seznam prostředků s výpisem obrázků, z nichž každý obsahuje referenční adresy URL a metadata obrázku.

ListingImages

ListingImages

Získání oddílů obchodu

ID operace:

ShopGetSections

Načte seznam oddílů obchodu v konkrétním obchodě identifikované ID obchodu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.

Návraty

Všechny oddíly v nejvýznamném obchodě.

ShopSections

ShopSections

Získání platby z ID položky registru platebního účtu

ID operace:

PaymentGetEntryID

Pokud je to možné, získejte platbu z ID položky platebního účtu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID položek registru	ledger_entry_ids	True	string	Pole celých čísel

Návraty

Představuje několik plateb provedených pomocí Etsy Payments. Všechny peněžní částky jsou v usd pennies, pokud není uvedeno jinak.

Payments

Payments

Získání platby z konkrétního potvrzení

ID operace:

PaymentGetReceipt

Načte platbu z konkrétního účtenky, která je identifikována ID účtenky, z konkrétního obchodu identifikovaného ID obchodu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID potvrzení	receipt_id	True	string	Číselné ID potvrzení přidružené k této transakci.

Návraty

Představuje několik plateb provedených pomocí Etsy Payments. Všechny peněžní částky jsou v usd pennies, pokud není uvedeno jinak.

Payments

Payments

Získání položek registru platebních účtů v obchodě

ID operace:

PaymentLedgerEntries

Načtěte položky registru platebního účtu v obchodě.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Minimální počet vytvořených	min_created	True	integer	Nejstarší časové razítko unixu pro vytvoření záznamu.
Maximální počet vytvořených	max_created	True	integer	Nejnovější časové razítko unixu pro vytvoření záznamu.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.

Návraty

Sada vstupních prostředků registru platebních účtů

PaymentAccountLedgerEntries

PaymentAccountLedgerEntries

Získání potvrzení

ID operace:

ReceiptGet

Načte potvrzení identifikované ID účtenky z obchodu Etsy.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID potvrzení	receipt_id	True	integer	Číselné ID potvrzení přidružené k této transakci.

Návraty

Záznam nákupu z obchodu. Účtenky v obchodě zobrazují peněžní hodnoty pomocí měny obchodu.

ShopReceipt

ShopReceipt

Získání produktu výpisu

ID operace:

ListingGetProduct

Načte výpis produktu podle ID.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID výpisu	listing_id	True	integer	Výpis pro vrácení produktu výpisu.
ID produktu	product_id	True	integer	Číselné ID konkrétního produktu zakoupeného ze výpisu.

Návraty

Reprezentace produktu pro výpis.

ListingInventoryProduct

ListingInventoryProduct

Získání překladu výpisu

ID operace:

ListingGetTranslation

Vrátí překlad výpisu v daném jazyce.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Jazyk	language	True	string	Značka jazyka IETF pro jazyk tohoto překladu. Příklad: de, en, es, fr, it, ja, nl, pl, pt, ru.

Návraty

Představuje data překladu pro výpis.

Výpistranslation

ListingTranslation

Získání přepravních dopravců

ID operace:

ShippingCarriers

Načte seznam dostupných přepravních dopravců a tříd pošty přidružených k nim pro danou zemi.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Země původu – ISO	origin_country_iso	True	string	Kód ISO země, ze které se seznam dodává.

Návraty

Představuje několik přepravních vozíků.

Přepravní vozíky

ShippingCarriers

Získání recenzí

ID operace:

ReviewsGet

Načte recenze z obchodu s id.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.

Návraty

Sada záznamů kontroly transakcí, které opustila uživatelé.

TransactionReviews

TransactionReviews

Získání seznamu plateb

ID operace:

PaymentsGet

Načte seznam plateb z obchodu identifikovaného ID obchodu. Výsledky můžete filtrovat také pomocí seznamu ID plateb.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID platby	payment-ids	True	string	Pole čísel PLATEBNÍCH ID oddělených čárkami.

Návraty

Představuje několik plateb provedených pomocí Etsy Payments. Všechny peněžní částky jsou v usd pennies, pokud není uvedeno jinak.

Payments

Payments

Získání souboru ze výpisu

ID operace:

ListingGetFile

Načte jeden soubor přidružený k danému digitálnímu výpisu. Žádost o soubor z fyzického výpisu vrátí prázdný výsledek.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Výpis ID souboru	listing_file_id	True	integer	Jedinečné číselné ID souboru přidruženého k digitálnímu výpisu.

Návraty

Soubor přidružený k digitálnímu výpisu.

ShopListingFile

ShopListingFile

Získání transakce

ID operace:

TransactionGet

Načte transakci podle ID transakce.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID transakce	transaction_id	True	integer	Jedinečné číselné ID transakce.

Návraty

Objekt transakce přidružený k potvrzení o prodejně. Etsy vygeneruje jednu transakci za výpis zakoupený podle zaznamenaného na potvrzení objednávky.

ShopReceiptTransaction

ShopReceiptTransaction

Získání transakce obchodu

ID operace:

TransactionGetShop

Načte seznam transakcí přidružených k obchodu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.

Návraty

Sadaprostředkůch

ShopReceiptTransactions

ShopReceiptTransactions

Získání transakce účtenky

ID operace:

TransactionReceipt

Načte seznam transakcí přidružených ke konkrétnímu potvrzení.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID potvrzení	receipt_id	True	integer	Číselné ID potvrzení přidružené k této transakci.

Návraty

Sadaprostředkůch

ShopReceiptTransactions

ShopReceiptTransactions

Získání upgradů expedičního profilu

ID operace:

ShippingGetProfileUpgrades

Načte seznam upgradů expedičního profilu přiřazeného ke konkrétnímu expedičnímu profilu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID expedičního profilu	shipping_profile_id	True	integer	Číselné ID expedičního profilu přidruženého k výpisu.

Návraty

Seznam možností upgradu expedice.

ShopShippingProfileUpgrades

ShopShippingProfileUpgrades

Získání uzlů taxonomie prodejce

ID operace:

ListingGetTaxonomyNodes

Načte celý strom hierarchie uzlů taxonomie prodejce.

Návraty

Seznam uzlů taxonomie ze stromu taxonomie prodejce

SellerTaxonomyNodes

SellerTaxonomyNodes

Získání uživatele

ID operace:

UserGet

Vrátí profil uživatele identifikovaný ID uživatele.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID uživatele	user_id	True	integer	Jedinečné kladné nenulové číselné ID pro uživatele.

Návraty

Představuje jednoho uživatele webu.

Uživatel

User

Získání uživatelských adres

ID operace:

UserGetAddresses

Načte seznam uživatelských adres.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.

Návraty

Představuje několik záznamů UserAddress.

UserAddresses

UserAddresses

Získání vlastnosti výpisu (beta verze)

ID operace:

ListingGetProperty

Načte vlastnost výpisu. Probíhá vývoj pro tento koncový bod. Vrátí pouze odpověď 501.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
ID vlastnosti	property_id	True	integer	Jedinečné ID vlastnosti výpisu Etsy.

Návraty

Reprezentace strukturovaných hodnot dat

ListingPropertyValue

ListingPropertyValue

Získání vlastností produktu podle ID taxonomie

ID operace:

ListingGetPropertiesByTaxonomy

Načte seznam vlastností produktu s příslušnými měřítky a hodnotami podporovanými pro konkrétní ID taxonomie prodejce.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID taxonomie	taxonomy_id	True	string	Jedinečné číselné ID uzlu taxonomie Etsy, což je kategorie metadat pro výpisy uspořádané do stromu hierarchie taxonomie prodejce.

Návraty

Seznam definic vlastností produktu.

TaxonomyNodeProperties

TaxonomyNodeProperties

Získání vlastností výpisu

ID operace:

ListingGetProperties

Vrátí seznam vlastností výpisu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.

Návraty

Představuje několik hodnot vlastností výpisu.

ListingPropertyValues

ListingPropertyValues

Získání výpisu

ID operace:

ListingGet

Načte záznam výpisu podle ID výpisu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID výpisu	listing_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
Includes	includes		string	Výčet řetězce, který připojí platné přidružení. Přijatelné vstupy jsou "shop", "images" a "user".

Získání výpisů podle ID

ID operace:

ListingGetByID

Umožňuje dotazovat více ID výpisu najednou. Omezte maximálně 100 ID na dotaz.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Výpis ID	listing_ids	True	string	Pole číselných ID výpisů v konkrétním obchodě Etsy.
Includes	includes		string	Výčet řetězce, který připojí platné přidružení.

Návraty

Sada obchodů uvádějící prostředky s přidruženími.

ShopListingsWithAssociations

ShopListingsWithAssociations

Získání výpisů podle ID oddílu obchodu

ID operace:

ListingGetBySectionID

Načte všechny výpisy z oddílu konkrétního obchodu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID oddílu obchodu	shop_section_ids	True	string	Pole číselných ID pro všechny oddíly v konkrétním obchodě Etsy
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.
Seřadit podle	sort_on		string	Hodnota, podle které se má řadit výsledek hledání výpisů.
Pořadí řazení	sort_order		string	Vzestupné (nahoru) nebo sestupné (dolů) pořadí řazení výpisů podle.

Návraty

Sada obchodů se seznamem zdrojů.

ShopListings

ShopListings

Získání výpisů podle obchodu

ID operace:

ListingGetShop

Vrátí výpisy, které patří do obchodu. Výpisy lze filtrovat pomocí parametru stavu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Stát	State		string	Výčtový řetězec z některého z: aktivních nebo neaktivních.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.
Seřadit podle	Sort On		string	Hodnota, podle které se má řadit výsledek hledání výpisů.
Pořadí řazení	Sort Order		string	Vzestupné (nahoru) nebo sestupné (dolů) pořadí řazení výpisů podle.

Návraty

Sada obchodů se seznamem zdrojů.

ShopListings

ShopListings

Získání výpisů podle účtenky obchodu

ID operace:

ListingGetByReceipt

Získá všechny výpisy přidružené k potvrzení.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Číselné ID potvrzení přidružené k této transakci.
ID potvrzení	receipt_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.

Návraty

Sada obchodů se seznamem zdrojů.

ShopListings

ShopListings

Získání všech souborů výpisu

ID operace:

ListingGetFiles

Načte všechny soubory přidružené k danému digitálnímu výpisu. Žádost o soubory z fyzického výpisu vrátí prázdný výsledek.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Číselné ID výpisu přidruženého k této transakci.
ID výpisu	listing_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.

Návraty

Představuje několik ShopListingFiles.

ShopListingFiles

ShopListingFiles

Získání účtenek

ID operace:

ReceiptsGet

Požádá o účtenky z konkrétního obchodu, nefiltrované nebo filtrované podle rozsahu ID účtenky nebo posunu, data, placeného a/nebo expedovaného nákupu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID obchodu	shop_id	True	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Minimální počet vytvořených	min_created		integer	Nejstarší časové razítko unixu pro vytvoření záznamu.
Maximální počet vytvořených	max_created		integer	Nejnovější časové razítko unixu pro vytvoření záznamu.
Nejstarší poslední změna	min_last_modified		integer	Nejstarší časové razítko unixu, kdy se záznam naposledy změnil.
Poslední změna	max_last_modified		integer	Poslední časové razítko unixu, kdy se záznam naposledy změnil.
Omezení	limit		integer	Maximální počet výsledků, které se mají vrátit.
Posun	offset		integer	Počet záznamů, které se mají přeskočit před výběrem prvního výsledku.
Byla zaplacena.	was_paid		boolean	Pokud je to pravda, prodejce obdržel platbu za produkty v tomto potvrzení.
Odesláno	was_shipped		boolean	Pokud je to pravda, prodejce doručil produkty v tomto potvrzení.

Návraty

Účtenky pro konkrétní obchod.

ShopReceipts

ShopReceipts

Definice

ShopListing

Výpis z obchodu, který obsahuje množství produktů, název, popis, cenu atd.

Name	Cesta	Typ	Description
ID výpisu	listing_id	integer	Číselné ID výpisu přidruženého k této transakci.
ID uživatele	user_id	integer	Číselné ID uživatele, který výpis publikuje.
ID obchodu	shop_id	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
Title	title	string	Řetězec názvu výpisu. Platné řetězce nadpisu obsahují pouze písmena, číslice, interpunkční znaménka, matematické symboly, znaky prázdných znaků, ™ , © a ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Můžete použít pouze %, :, &a + znaky jednou.
Description	description	string	Popisový řetězec produktu k prodeji v seznamu.
Stát	state	State	Výčtový řetězec z některého z: aktivních nebo neaktivních. Poznámka: Nastavení konceptu aktivního výpisu také publikuje výpis na etsy.com.
Časové razítko vytvoření	creation_timestamp	integer	Čas vytvoření výpisu v epochových sekundách.
Koncové časové razítko	ending_timestamp	integer	Doba vypršení platnosti výpisu v epochových sekundách.
Časové razítko původního vytvoření	original_creation_timestamp	integer	Čas vytvoření výpisu v epochových sekundách.
Časové razítko poslední změny	last_modified_timestamp	integer	Čas poslední aktualizace výpisu v epochových sekundách.
Časové razítko poslední změny stavu	state_timestamp	integer	Datum a čas poslední změny stavu tohoto výpisu.
Množství	quantity	integer	Kladný nenulový počet produktů, které jsou k dispozici k nákupu v výpisu. Poznámka: Množství výpisu je součet dostupných nabídek množství. Množství pro jednotlivé nabídky můžete požádat z prostředku ListingInventory pomocí koncového bodu získání výpisu inventáře.
ID oddílu obchodu	shop_section_id	integer	Číselné ID oddílu v konkrétním obchodě Etsy.
Doporučené pořadí	featured_rank	integer	Kladná nenulová číselná pozice v doporučených výpisech obchodu s pořadím 1 výpisů, které se zobrazují na domovské stránce obchodu na pozici nejvíce vlevo.
URL	url	string	Úplná adresa URL stránky výpisu na Etsy.
Počet favoristů	num_favorers	integer	Počet uživatelů, kteří označili tento seznam jako oblíbený.
Neověřitelné	non_taxable	boolean	Pokud je to pravda, příslušné sazby daně z obchodů se na tento výpis v pokladně nevztahují.
Je přizpůsobitelný	is_customizable	boolean	Pokud je pravda, může kupující kontaktovat prodejce s přizpůsobenou objednávkou. Výchozí hodnota je true, když obchod přijímá vlastní objednávky. Nevztahuje se na obchody, které nepřijímají vlastní objednávky.
Je Peronalizable	is_personalizable	boolean	Pokud ano, tento výpis je přizpůsobitelný. Výchozí hodnota je null.
Individuální nastavení je povinné.	personalization_is_required	boolean	Pokud ano, tento výpis vyžaduje přizpůsobení. Výchozí hodnota je null.
Maximální počet znaků přizpůsobení	personalization_char_count_max	integer	Jedná se o celočíselnou hodnotu představující maximální délku zprávy o přizpůsobení zadané kupujícím.
Pokyny k přizpůsobení	personalization_instructions	string	Pokud ano, tento výpis vyžaduje přizpůsobení. Výchozí hodnota je null.
Typ výpisu	listing_type	boolean	Výčtový řetězec typu, který označuje, jestli je výpis fyzický nebo digitální soubor ke stažení.
Štítky	tags	array of string	Seznam řetězců značek pro výpis. Platné řetězce značek obsahují pouze písmena, číslice, prázdné znaky, -, ', ™ , © , a ® . (regex: /[^\p{L}\p{Nd}\p{Zs}\-'™©®]/u) Výchozí hodnota je null.
Materials	materials	array of string	Seznam materiálových řetězců pro materiály použité v produktu. Platné řetězce materiálů obsahují pouze písmena, číslice a prázdné znaky. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Výchozí hodnota je null.
ID expedičního profilu	shipping_profile_id	integer	Číselné ID expedičního profilu přidruženého k výpisu.
Minimální počet dnů zpracování	processing_min	integer	Minimální počet dní potřebných ke zpracování tohoto výpisu. Výchozí hodnota je null.
Maximální počet dnů zpracování	processing_max	integer	Maximální počet dní potřebných ke zpracování tohoto výpisu. Výchozí hodnota je null.
WhoMade	who_made	WhoMade	Výčet řetězce inidcated who made the product. Pomáhá kupujícím najít výpis pod nadpisem Handmade. Vyžaduje is_supply a when_made.
Při vytváření	when_made	WhenMade	Výčtový řetězec pro éru, ve které tvůrce vytvořil produkt v tomto výpisu. Pomáhá kupujícím najít výpis pod nadpisem Vintage. Vyžaduje is_supply a who_made.
Dodávka produktu	is_supply	boolean	Pokud je hodnota true, označí výpis jako produkt dodávky, znamená to, že se jedná o hotový produkt. Pomáhá kupujícím najít výpis pod nadpisem Dodávky. Vyžaduje who_made a when_made.
Hmotnost položky	item_weight	double	Číselná hmotnost výrobku měřená v jednotkách nastavených v jednotce hmotnosti položky. Výchozí hodnota je null. Pokud je nastavená hodnota, musí být větší než 0.
ItemWeightUnit	item_weight_unit	ItemWeightUnit	Řetězec definující jednotky použité k měření hmotnosti produktu. Výchozí hodnota je null.
Délka položky	item_length	double	Číselná délka produktu měřená v jednotkách nastavených v jednotce dimenzí položek. Výchozí hodnota je null. Pokud je nastavená hodnota, musí být větší než 0.
Šířka položky	item_width	double	Číselná šířka produktu měřená v jednotkách nastavených v jednotce dimenzí položek. Výchozí hodnota je null. Pokud je nastavená hodnota, musí být větší než 0.
Výška položky	item_height	double	Číselná délka produktu měřená v jednotkách nastavených v jednotce dimenzí položek. Výchozí hodnota je null. Pokud je nastavená hodnota, musí být větší než 0.
ItemDimensionsUnit	item_dimensions_unit	ItemDimensionsUnit	Řetězec definující jednotky použité k měření rozměrů produktu. Výchozí hodnota je null.
Je soukromé	is_private	boolean	Pokud je pravda, jedná se o soukromý výpis, který je určený pro konkrétního kupujícího a skrytý před zobrazením obchodu.
Recipient	recipient	Recipient	Výčtový řetězec označující osobu, pro kterou by tento produkt udělal vhodný dárek. Výchozí hodnota je null.
Příležitost	occasion	Occasion	Výčtový řetězec označující příležitost, pro kterou by tento produkt udělal vhodný dárek. Výchozí hodnota je null.
Styl	style	array of string	Pole stylů řetězců pro tento výpis, z nichž každý je volný textový řetězec, jako je Formal nebo Steampunk. Výpis může mít až dva styly. Platné řetězce stylu obsahují pouze písmena, číslice a prázdné znaky. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Výchozí hodnota je null.
Data souboru	file_data	string	Řetězec popisující soubory připojené k digitálnímu výpisu.
Obsahuje varianty	has_variations	boolean	Pokud je hodnota true, výpis obsahuje varianty.
Mělo by se automaticky prodloužit	should_auto_renew	boolean	Pokud je hodnota true, prodlouží výpis po dobu čtyř měsíců po expriaci. Pokud je nastavená hodnota true v případě dříve nepravdivé hodnoty, etsy.com obnoví výpis před vypršením jeho platnosti, ale období prodloužení začíná nemidiateálně místo prodloužení data vypršení platnosti výpisu. Všechny nevyužité časy zbývající v výpisu se ztratí. Prodloužení vede k poplatkům na faktuře uživatele.
Jazyk	language	string	Značka jazyka IETF pro výchozí jazyk výpisu. Příklad: de, en, es, , itfr, janl, pl, ptru.
Peníze	price	Money	Reprezentace částky peněz.
ID taxonomie	taxonomy_id	integer	ID číselné taxonomie výpisu. Prodejce spravuje id taxonomie pro svůj obchod. Další informace najdete v taxonomii prodejce.

Peníze

Reprezentace částky peněz.

Name	Cesta	Typ	Description
Množství	amount	integer	Množství reprezentované daty.
Dělitel	divisor	integer	Dělitel k vykreslení částky.
Kód měny	currency_code	string	Kód měny ISO pro tato data.

ShopListingFile

Soubor přidružený k digitálnímu výpisu.

Name	Cesta	Typ	Description
Výpis ID souboru	listing_file_id	integer	Jedinečné číselné ID souboru přidruženého k digitálnímu výpisu.
ID výpisu	listing_id	integer	Číselné ID výpisu přidruženého k této transakci.
Hodnost	rank	integer	Číselný index pozice pořadí zobrazení tohoto souboru v výpisu počínaje číslem 1.
Jméno souboru	filename	string	Řetězec názvu souboru přidruženého k digitálnímu výpisu.
Nábíd	filesize	string	Řetězec pro velikost souboru čitelný pro člověka.
Velikost v bajtech	size_bytes	integer	Číslo označující velikost souboru měřenou v bajtech.
Typ souboru	filetype	string	Řetězec typu označující typ MIME souboru.
Vytvoření časového razítka	create_timestamp	integer	Jedinečné číselné časové razítko souboru přidruženého k digitálnímu výpisu.

ShopListingFiles

Představuje několik ShopListingFiles.

Name	Cesta	Typ	Description
Počet	count	integer	Počet vrácených souborů ShopListingFiles.
Results	results	array of ShopListingFile	Pole prostředků ShopListingFile.

ShopListings

Sada obchodů se seznamem zdrojů.

Name	Cesta	Typ	Description
Počet	count	integer	Počet nalezených zdrojů v obchodě.
Results	results	array of ShopListing	Našel se obchod se seznamem zdrojů.

Uživatel

Představuje jednoho uživatele webu.

Name	Cesta	Typ	Description
ID uživatele	user_id	integer	Číselné ID uživatele. Toto číslo je také platné ID obchodu pro obchod uživatele.
Přihlašovací jméno	login_name	string	Řetězec přihlašovacího jména uživatele.
Primární e-mail	primary_email	string	Řetězec e-mailové adresy primární e-mailové adresy uživatele.
Křestní jméno	first_name	string	Jméno uživatele.
Příjmení	last_name	string	Příjmení uživatele.
Vytvořené časové razítko	create_timestamp	integer	Datum a čas, kdy uživatel vytvořil svůj účet, v epochových sekundách.
Odkazované ID uživatele	referred_by_user_id	integer	Číselné ID uživatele, který na tohoto uživatele odkazuje.
Použití nových koncových bodů inventáře	use_new_inventory_endpoints	boolean	Deprecated. Vždycky pravda.
Je prodejce	is_seller	boolean	Hodnota True, pokud je uživatel prodejcem.
Životopis	bio	string	Životopis uživatele.
Pohlaví	gender	string	Pohlaví uživatele.
Měsíc narození	birth_month	string	Měsíc narození uživatele.
Narozeniny	birth_day	string	Den narození uživatele.
Koupit počet transakcí	transaction_buy_count	integer	Počet transakcí, ve kterých si uživatel koupil.
Počet prodaných transakcí	transaction_sold_count	integer	Počet transakcí, ve kterých se uživatel prodal.

Obchod

Obchod vytvořený uživatelem Etsy.

Name	Cesta	Typ	Description
ID obchodu	shop_id	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID uživatele	user_id	integer	Číselné ID uživatele uživatele, který tento obchod vlastní.
Název obchodu	shop_name	string	Řetězec názvu obchodu.
Datum vytvoření	create_date	integer	Datum a čas vytvoření tohoto obchodu v epochových sekundách.
Title	title	string	Stručný řetězec nadpisu hlavní stránky obchodu.
Oznámení	announcement	string	Řetězec oznámení pro kupující, kteří se zobrazují na domovské stránce obchodu.
Kód měny	currency_code	string	Kód ISO (abecední) pro měnu obchodu. Obchod ve výchozím nastavení zobrazuje všechny ceny v této měně.
Je na dovolené	is_vacation	boolean	Pokud je pravda, tento obchod nepřijímá nákupy.
Zpráva o dovolené	vacation_message	string	Řetězec zprávy v obchodě se zobrazí, když is_vacation je pravdivý.
Zpráva o prodeji	sale_message	string	Řetězec zprávy odeslaný uživatelům, kteří dokončí nákup z tohoto obchodu.
Digitální zpráva o prodeji	digital_sale_message	string	Řetězec zprávy odeslaný uživatelům, kteří si kupují digitální položku z tohoto obchodu.
Datum aktualizace	update_date	integer	Datum a čas poslední aktualizace obchodu v epochových sekundách.
Počet aktivních výpisů	listing_active_count	integer	Počet aktivních výpisů v obchodě.
Počet digitálních výpisů	digital_listing_count	integer	Počet digitálních výpisů v obchodě.
Přihlašovací jméno	login_name	string	Řetězec přihlašovacího jména vlastníka obchodu.
Přijímá vlastní žádosti	accepts_custom_requests	boolean	Pokud je pravda, obchod přijímá žádosti o přizpůsobení.
Uvítací zásada	policy_welcome	string	Uvítací řetězec zásad obchodu (může být prázdný).
Zásady platby	policy_payment	string	Řetězec zásad platby v obchodě (může být prázdný).
Zásady expedice	policy_shipping	string	Řetězec zásad expedice v obchodě (může být prázdný).
Zásady refundace	policy_refunds	string	Řetězec zásad refundace v obchodě (může být prázdný).
Další zásady	policy_additional	string	Řetězec dalších zásad v obchodě (může být prázdný).
Informace o prodejci	policy_seller_info	string	Řetězec informací o prodejci v obchodě (může být prázdný).
Datum aktualizace zásad	policy_update_date	integer	Datum a čas poslední aktualizace zásad obchodu v epochových sekundách.
Má zásady privátního příjmu	policy_has_private_receipt_info	boolean	Pokud je to pravda, zobrazují se v účtech EU soukromé údaje.
Má nestrukturované zásady	has_unstructured_policies	boolean	Pokud je pravda, zobrazí se v obchodě další nestrukturovaná pole zásad.
Zásady ochrany osobních údajů	policy_privacy	string	Řetězec zásad ochrany osobních údajů v obchodě (může být prázdný).
Dovolená Autoreply	vacation_autoreply	string	Řetězec automatické odpovědi v obchodě se zobrazí v nových konverzacích, když je is_vacation pravdivý.
URL	url	string	Řetězec adresy URL pro tento obchod.
Adresa URL obrázku banneru	image_url_760x100	string	Řetězec adresy URL pro banner tohoto obchodu.
Počet favoristů	num_favorers	integer	Počet uživatelů, kteří tento obchod označili jako oblíbenou.
Languages	languages	array of string	Seznam jazykových řetězců zaregistrovaných v obchodě
Adresa URL obrázku ikony	icon_url_fullxfull	string	Řetězec adresy URL ikony tohoto obchodu.
Používá strukturované zásady	is_using_structured_policies	boolean	Pokud je pravda, obchod přijal pomocí strukturovaných zásad.
Má nasazené strukturované zásady.	has_onboarded_structured_policies	boolean	Pokud je pravda, obchod přijal nebo odmítl po zobrazení strukturovaného onboardingu zásad.
Zahrnout odkaz na formulář sporu	include_dispute_form_link	boolean	Pokud je to pravda, zásady tohoto obchodu obsahují odkaz na formulář pro online spor EU.
Je zapnutá přímá rezervace	is_direct_checkout_onboarded	boolean	Pokud je pravda, obchod se onboardoval na Etsy Payments.
Je počítaná doprava způsobilá.	is_calculated_eligible	boolean	Pokud je pravda, obchod je pro počítané expediční profily elegovatelný. (K dispozici pouze v USA a Kanadě)
Je výslovný souhlas s příslibem kupujícího	is_opted_in_to_buyer_promise	boolean	Pokud je pravda, obchod se přihlásil k slibu kupujícího.
Je založená na USA	is_shop_us_based	boolean	Pokud je pravda, obchod je založen v USA.
Sales Transaction Count	transaction_sold_count	integer	Celkový počet prodejních transakcí pro tento obchod
Doprava ze země ISO	shipping_from_country_iso	string	Země iso obchod je expediční z.
Umístění obchodu ISO	shop_location_country_iso	string	Země iso, kde se obchod nachází.
Počet revizí	review_count	integer	Početrecenzích
Zkontrolovat průměr	review_average	double	Průměrné hodnocení na základě recenzí výpisů obchodů v minulém roce.

ListingImage

Odkazy na adresy URL a metadata obrázku přidruženého ke konkrétnímu výpisu Parametr url_fullxfull obsahuje adresu URL pro soubor binárního obrázku v plné velikosti.

Name	Cesta	Typ	Description
ID výpisu	listing_id	integer	Číselné ID výpisu přidruženého k této transakci.
Výpis ID obrázku	listing_image_id	integer	Číselné ID primárního výpisu obrázku pro tuto transakci.
Hex kód	hex_code	string	Řetězec webhexu pro průměrnou barvu obrázku v zápisu webhex.
Červená hodnota	red	integer	Číselná červená hodnota rovna průměrné červené hodnotě obrázku z 0–255 (barva RGB).
Zelená hodnota	green	integer	Číselná červená hodnota rovna průměrné červené hodnotě obrázku z 0–255 (barva RGB).
Modrá hodnota	blue	integer	Číselná červená hodnota rovna průměrné červené hodnotě obrázku z 0–255 (barva RGB).
Hodnota Hue	hue	integer	Číselný odstín se rovná průměrnému odstínu obrázku od 0–360 (barva HSV).
Hodnota sytosti	saturation	integer	Číselná sytost se rovná průměrné sytosti obrázku od 0 do 100 (barva HSV).
Hodnota jasu	brightness	integer	Číselný jas se rovná průměrnému jasu obrázku od 0 do 100 (barva HSV).
Je černá a bílá	is_black_and_white	boolean	Pokud je pravda, obrázek je černobílý.
Čas vytvoření	creation_tsz	integer	Čas vytvoření výpisu obrázku v epochových sekundách.
Hodnost	rank	integer	Kladná nenulová číselná pozice na obrázcích zobrazených ve výpisu s pořadím 1 obrázků, které se zobrazují v seznamu úplně vlevo.
Adresa URL obrázku 75x75	url_75x75	string	Řetězec adresy URL pro miniaturu obrázku o rozměrech 75x75 pixelů.
Adresa URL obrázku 170x135	url_170x135	string	Řetězec adresy URL pro miniaturu obrázku o rozměrech 170 × 135 pixelů.
Adresa URL obrázku 570xN	url_570xN	string	Řetězec adresy URL miniatury obrázku, maximálně 570 pixelů široký s proměnlivou výškou.
Adresa URL obrázku v plné velikosti	url_fullxfull	string	Řetězec adresy URL obrázku s plnou velikostí, až 3000 pixelů v každé dimenzi.
Výška obrázku v plné velikosti	full_height	integer	Číselná výška obrázku v plné velikosti měřená v pixelech, na který odkazuje url_fullxfull.
Šířka obrázku v plné velikosti	full_width	integer	Číselná šířka měřená v pixelech obrázku v plné velikosti, na který odkazuje url_fullxfull.

ListingImages

Představuje seznam prostředků s výpisem obrázků, z nichž každý obsahuje referenční adresy URL a metadata obrázku.

Name	Cesta	Typ	Description
Počet	count	integer	Počet výsledků.
Results	results	array of ListingImage	Seznam požadovaných prostředků

ListingInventoryWithAssociations

Reprezentace záznamu inventáře s jedním výpisem s přidruženími

Name	Cesta	Typ	Description
Products	products	array of ListingInventoryProduct	Pole JSON produktů dostupných v seznamu, i když je jen jeden produkt. Všechny názvy polí v objektech blob JSON jsou malá písmena.
Cena ve vlastnostech	price_on_property	array of integer	Pole jedinečných čísel ID vlastnosti výpisu pro vlastnosti, které mění ceny produktů, pokud existuje. Pokud například naúčtujete konkrétní ceny produktů s různou velikostí ve stejném výpisu, bude toto pole obsahovat ID vlastnosti pro velikost.
Množství ve vlastnostech	quantity_on_property	array of integer	Pole jedinečných čísel ID vlastnosti výpisu pro vlastnosti, které mění množství produktů, pokud existuje. Pokud například skladujete konkrétní množství různých barevných produktů ve stejném výpisu, bude toto pole obsahovat ID vlastnosti pro barvu.
Skladová položka ve vlastnostech	sku_on_property	array of integer	Pole jedinečných čísel ID vlastnosti výpisu pro vlastnosti, které změní skladovou položku produktu( pokud existuje). Pokud například použijete konkrétní skladové položky pro různé barevné produkty ve stejném výpisu, bude toto pole obsahovat ID vlastnosti pro barvu.
ShopListing	listing	ShopListing	Výpis z obchodu, který obsahuje množství produktů, název, popis, cenu atd.

ListingInventoryProduct

Reprezentace produktu pro výpis.

Name	Cesta	Typ	Description
ID produktu	product_id	integer	Číselné ID konkrétního produktu zakoupeného ze výpisu.
skladová jednotka (SKU)	sku	string	Řetězec skladové položky pro produkt
Je odstraněno.	is_deleted	boolean	Pokud ano, někdo tento produkt odstranil.
Offerings	offerings	array of ListingInventoryProductOffering	Seznam položek nabídky produktů pro tento produkt.
Hodnoty vlastností	property_values	array of ListingPropertyValue	Seznam položek hodnot vlastností pro tento produkt.

VýpisInventoryProductOffering

Reprezentace nabídky pro výpis.

Name	Cesta	Typ	Description
ID nabídky	offering_id	integer	ID nabídky produktů
Množství	quantity	integer	Množství nabídky produktů
Je povoleno	is_enabled	boolean	Bez ohledu na to, zda se nabídka může zobrazit kupujícím.
Je odstraněno.	is_deleted	boolean	Bez ohledu na to, jestli byla nabídka odstraněna.
Peníze	price	Money	Reprezentace částky peněz.

ListingPropertyValue

Reprezentace strukturovaných hodnot dat

Name	Cesta	Typ	Description
ID vlastnosti	property_id	integer	Číselné ID vlastnosti.
Název	property_name	string	Název vlastnosti.
ID škálování	scale_id	integer	Číselné ID měřítka (pokud existuje).
Název škálování	scale_name	string	Popisek použitý k popisu zvoleného měřítka (pokud existuje).
ID hodnot	value_ids	array of integer	Číselná ID hodnot vlastností
Hodnoty	values	array of string	Hodnoty vlastností

VýpisInventory

Reprezentace záznamu inventáře jednoho výpisu

Name	Cesta	Typ	Description
Products	products	array of ListingInventoryProduct	Pole JSON produktů dostupných v seznamu, i když je jen jeden produkt. Všechny názvy polí v objektech blob JSON jsou malá písmena.
Cena ve vlastnostech	price_on_property	array of integer	Pole jedinečných čísel ID vlastnosti výpisu pro vlastnosti, které mění ceny produktů, pokud existuje. Pokud například naúčtujete konkrétní ceny produktů s různou velikostí ve stejném výpisu, bude toto pole obsahovat ID vlastnosti pro velikost.
Množství ve vlastnostech	quantity_on_property	array of integer	Pole jedinečných čísel ID vlastnosti výpisu pro vlastnosti, které mění množství produktů, pokud existuje. Pokud například skladujete konkrétní množství různých barevných produktů ve stejném výpisu, bude toto pole obsahovat ID vlastnosti pro barvu.
Skladová položka ve vlastnostech	sku_on_property	array of integer	Pole jedinečných čísel ID vlastnosti výpisu pro vlastnosti, které změní skladovou položku produktu( pokud existuje). Pokud například použijete konkrétní skladové položky pro různé barevné produkty ve stejném výpisu, bude toto pole obsahovat ID vlastnosti pro barvu.

ShopListingsWithAssociations

Sada obchodů uvádějící prostředky s přidruženími.

Name	Cesta	Typ	Description
Počet	count	integer	Počet nalezených zdrojů v obchodě.
Results	results	array of ShopListing	Našel se obchod se seznamem zdrojů.

ListingPropertyValues

Představuje několik hodnot vlastností výpisu.

Name	Cesta	Typ	Description
Počet	count	integer	Počet nalezených zdrojů v obchodě.
Results	results	array of ListingPropertyValue	Našel se obchod se seznamem zdrojů.

ShopReceiptTransactions

Sadaprostředkůch

Name	Cesta	Typ	Description
Počet	count	integer	Početnalezenýchchch
Results	results	array of ShopReceiptTransaction	Zjistily se prostředky transakcí účtenek obchodu.

ShopReceiptTransaction

Objekt transakce přidružený k potvrzení o prodejně. Etsy vygeneruje jednu transakci za výpis zakoupený podle zaznamenaného na potvrzení objednávky.

Name	Cesta	Typ	Description
ID transakce	transaction_id	integer	Jedinečné číselné ID transakce.
Title	title	string	Název řetězce výpisu zakoupeného v této transakci.
Description	description	string	Popis řetězec výpisu zakoupeného v této transakci.
ID uživatele prodejce	seller_user_id	integer	Číselné ID uživatele pro prodejce v této transakci.
ID uživatele kupujícího	buyer_user_id	integer	Číselné ID uživatele pro kupujícího v této transakci.
Vytvořené časové razítko	create_timestamp	integer	Datum a čas vytvoření transakce v epochových sekundách.
Placené časové razítko	paid_timestamp	integer	Placené datum a čas transakce v epochových sekundách.
Časové razítko odeslání	shipped_timestamp	integer	Datum a čas expedice transakce v epochových sekundách.
Množství	quantity	integer	Číselné množství produktů zakoupených v této transakci.
Výpis ID obrázku	listing_image_id	integer	Číselné ID primárního výpisu obrázku pro tuto transakci.
ID potvrzení	receipt_id	integer	Číselné ID potvrzení přidružené k této transakci.
Is Digital	is_digital	boolean	Pokud ano, transakce zaznamenala nákup digitálního výpisu.
Data souboru	file_data	string	Řetězec popisující soubory zakoupené v této transakci.
ID výpisu	listing_id	integer	Číselné ID výpisu přidruženého k této transakci.
Typ transakce	transaction_type	string	Typ řetězec transakce, obvykle výpis
ID produktu	product_id	integer	Číselné ID konkrétního produktu zakoupeného ze výpisu.
Peníze	price	Money	Reprezentace částky peněz.
Peníze	shipping_cost	Money	Reprezentace částky peněz.

Výpistranslation

Představuje data překladu pro výpis.

Name	Cesta	Typ	Description
ID výpisu	listing_id	integer	Číselné ID výpisu.
Jazyk	language	string	Značka jazyka IETF (např. fr) pro jazyk tohoto překladu.
Title	title	string	Název výpisu tohoto překladu.
Description	description	string	Popis výpisu tohoto překladu.
Štítky	tags	array of string	Značky výpisu tohoto překladu.

ListingVariationImages

Představuje několik výpisu obrázků variant.

Name	Cesta	Typ	Description
Počet	count	integer	Počet obrázků variant.
Results	results	array of ListingVariationImage	Výsledky obrázků variant.

ListingVariationImage

Reprezentace přidružení variant a obrázků na výpisu.

Name	Cesta	Typ	Description
ID vlastnosti	property_id	integer	Číselné ID vlastnosti.
ID hodnoty	value_id	integer	Číselné ID hodnoty.
ID obrázku	image_id	integer	Číselné ID obrázku.

PaymentAccountLedgerEntries

Sada vstupních prostředků registru platebních účtů

Name	Cesta	Typ	Description
Počet	count	integer	Počet nalezených vstupních prostředků registru platebních účtů
Results	results	array of PaymentAccountLedgerEntry	Zjistily se vstupní prostředky registru platebních účtů.

PaymentAccountLedgerEntry

Představuje položku v registru obchodu.

Name	Cesta	Typ	Description
ID položky	entry_id	integer	Číselné ID položky registru.
ID registru	ledger_id	integer	Číselné ID registru.
Pořadové číslo	sequence_number	integer	Posloupnost umožňuje seřazení položek registru chronologicky. Čím vyšší je sekvence, tím novější položka.
Množství	amount	integer	Částka peněz připisovaná do registru.
Měna	currency	string	Měna položky v registru.
Description	description	string	Podrobnosti o tom, jaký druh položky registru je: platba, refundace, vrácení peněz, vrácení neúspěšné refundace, vyplacení, vrácený vyplacení, recoupce, různé kredity, různé debetní platby nebo platba faktury.
Saldo	balance	integer	Částka peněz v registru obchodu v okamžiku, kdy byla tato položka uplatněna.
Datum vytvoření	create_date	integer	Datum a čas vytvoření položky registru v epochových sekundách.

Payments

Představuje několik plateb provedených pomocí Etsy Payments. Všechny peněžní částky jsou v usd pennies, pokud není uvedeno jinak.

Name	Cesta	Typ	Description
Počet	count	integer	Počet plateb v odpovědi.
Results	results	array of Payment	Seznam plateb.

Platba

Představuje platbu provedenou pomocí Etsy Payments. Všechny peněžní částky jsou v usd pennies, pokud není uvedeno jinak.

Name	Cesta	Typ	Description
ID platby	payment_id	integer	Jedinečné číselné ID pro platbu do konkrétního obchodu Etsy.
ID uživatele kupujícího	buyer_user_id	integer	Číselné ID uživatele, který nákup zaplatil.
ID obchodu	shop_id	integer	Jedinečné kladné nenulové číselné ID pro Etsy Shop.
ID potvrzení	receipt_id	integer	Číselné ID potvrzení přidružené k této transakci.
Peníze	amount_gross	Money	Reprezentace částky peněz.
Peníze	amount_fees	Money	Reprezentace částky peněz.
Peníze	amount_net	Money	Reprezentace částky peněz.
Peníze	posted_gross	Money	Reprezentace částky peněz.
Peníze	posted_fees	Money	Reprezentace částky peněz.
Peníze	posted_net	Money	Reprezentace částky peněz.
Peníze	adjusted_gross	Money	Reprezentace částky peněz.
Peníze	adjusted_fees	Money	Reprezentace částky peněz.
Peníze	adjusted_net	Money	Reprezentace částky peněz.
Měna	currency	string	Řetězec kódu ISO (abecední) pro měnu platby.
Měna obchodu	shop_currency	string	Kód ISO (abecední) pro měnu obchodu. Obchod ve výchozím nastavení zobrazuje všechny ceny v této měně.
Měna kupujícího	buyer_currency	string	Řetězec měny kupujícího.
ID expedice uživatele	shipping_user_id	integer	Číselné ID uživatele, do kterého prodejce objednávku dodává.
ID dodací adresy	shipping_address_id	integer	Číselné ID identifikující dodací adresu.
ID fakturační adresy	billing_address_id	integer	Číselné ID identifikující fakturační adresu kupujícího.
Stav	status	string	Řetězec označující aktuální stav platby, nejčastěji vyřešený nebo ověřovací.
Časové razítko odeslání	shipped_timestamp	integer	Datum a čas expedice transakce v epochových sekundách.
Vytvořené časové razítko	create_timestamp	integer	Datum a čas vytvoření transakce v epochových sekundách.
Časové razítko aktualizace	update_timestamp	integer	Datum a čas poslední změny úpravy platby v epochových sekundách.
Úpravy plateb	payment_adjustments	array of PaymentAdjustment	Seznam objektů refundace v transakci Etsy Payments. Všechny peněžní částky jsou v usd pennies, pokud není uvedeno jinak.

PaymentAdjustment

Představuje refundaci, která se vztahuje na předchozí platbu Etsy. Všechny peněžní částky jsou v usd pennies, pokud není uvedeno jinak.

Name	Cesta	Typ	Description
ID úpravy platby	payment_adjustment_id	integer	Číselné ID pro úpravu platby.
ID platby	payment_id	integer	Jedinečné číselné ID pro platbu do konkrétního obchodu Etsy.
Stav	status	string	Stavový řetězec úpravy platby.
Je úspěch	is_success	boolean	Pokud je pravda, úprava platby byla nebo je pravděpodobně úspěšně dokončena.
ID uživatele	user_id	integer	Číselné ID uživatele (prodejce) plnící nákup.
Kód důvodu	reason_code	string	Řetězec čitelný člověkem popisující důvod refundace.
Celková částka úpravy	total_adjustment_amount	integer	Celková číselná částka refundace v měně platby.
Shop Total Adjustment Amount	shop_total_adjustment_amount	integer	Číselná částka refundace v měně obchodu.
Celková částka úpravy	buyer_total_adjustment_amount	integer	Číselná částka refundace v měně kupujícího.
Celková částka vyrovnání poplatku	total_fee_adjustment_amount	integer	Číselné množství poplatků za zpracování karet spojené s úpravou platby.
Vytvořené časové razítko	create_timestamp	integer	Datum a čas vytvoření transakce v epochových sekundách.
Časové razítko aktualizace	update_timestamp	integer	Datum a čas poslední změny úpravy platby v epochových sekundách.

Zápach

Potvrzení, že aktuální aplikace má přístup k rozhraní Open API

Name	Cesta	Typ	Description
Identifikátor aplikace	application_id	integer	ID ověřené aplikace

ShopReceipt

Záznam nákupu z obchodu. Účtenky v obchodě zobrazují peněžní hodnoty pomocí měny obchodu.

Name	Cesta	Typ	Description
ID potvrzení	receipt_id	integer	Číselné ID potvrzení přidružené k této transakci.
Typ potvrzení	receipt_type	integer	Číselná hodnota kanálu Etsy, která obsluhuje nákup: 0 pro Etsy.com, 1 pro obchod se vzory.
ID uživatele prodejce	seller_user_id	integer	Číselné ID uživatele (prodejce) plnící nákup.
E-mailová adresa prodejce	seller_email	string	Řetězec e-mailové adresy prodejce výpisu.
ID uživatele kupujícího	buyer_user_id	integer	Číselné ID uživatele, který nákup provádí.
E-mailová adresa kupujícího	buyer_email	string	Řetězec e-mailové adresy pro kupujícího výpisu.
Název	name	string	Řetězec jména příjemce v expediční adrese.
První řádek adresy	first_line	string	První řetězec řádku adresy příjemce v expediční adrese.
Druhý řádek adresy	second_line	string	Volitelný druhý řetězec řádku adresy příjemce v expediční adrese.
City	city	string	Řetězec města příjemce v expediční adrese.
Stát	state	string	Stavový řetězec příjemce v expediční adrese.
PSČ	zip	string	Řetězec PSČ (nemusí nutně číslo) příjemce v expediční adrese.
Formátovaná adresa	formatted_address	string	Formátovaný řetězec dodací adresy příjemce v expediční adrese.
Kód země ISO	country_iso	string	Řetězec kódu země ISO-3166 alfa-2 pro příjemce v expediční adrese.
Způsob platby	payment_method	string	Řetězec způsobu platby identifikující způsob platby kupujícího, která musí být jednou z těchto: "cc" (kreditní karta), "PayPal", "check", "mo" (money order), 'bt' (bankovní převod), 'other', 'ideal', 'sofort', 'apple_pay', 'google', 'android_pay', 'google_pay', 'klarna', 'k_pay_in_4' (klarna) nebo 'k_financing' (klarna).
Platební e-mailová adresa	payment_email	string	Řetězec e-mailové adresy pro e-mailovou adresu, na kterou se má odeslat potvrzení platby
Zpráva od prodejce	message_from_seller	string	Volitelný řetězec zprávy od prodejce.
Zpráva od Kupujícího	message_from_buyer	string	Volitelný řetězec zprávy od kupujícího.
Zpráva z platebního systému	message_from_payment	string	Strojově vygenerovaný potvrzovací řetězec z platebního systému.
Je zaplaceno	is_paid	boolean	Pokud je pravda, kupující zaplatil za tento nákup.
Je odesláno	is_shipped	boolean	Pokud je to pravda, prodejce odeslal produkty.
Vytvořené časové razítko	create_timestamp	integer	Čas vytvoření účtenky v epochových sekundách.
Časové razítko aktualizace	update_timestamp	integer	Čas poslední aktualizace účtenky v epochových sekundách.
Dárková zpráva	gift_message	string	Řetězec dárkové zprávy s požadavky kupujícího dodaného s produktem.
Peníze	grandtotal	Money	Reprezentace částky peněz.
Peníze	subtotal	Money	Reprezentace částky peněz.
Peníze	total_price	Money	Reprezentace částky peněz.
Peníze	total_shipping_cost	Money	Reprezentace částky peněz.
Peníze	total_tax_cost	Money	Reprezentace částky peněz.
Peníze	total_vat_cost	Money	Reprezentace částky peněz.
Peníze	discount_amt	Money	Reprezentace částky peněz.
Peníze	gift_wrap_price	Money	Reprezentace částky peněz.
Dodávky	shipments	array of ShopReceiptShipment	Seznam výpisů zásilek pro tento doklad.

ObchodReceiptShipment

Záznam jedné události zásilky pro ShopReceipt. Potvrzení může obsahovat mnoho záznamů ShopReceiptShipment.

Name	Cesta	Typ	Description
ID doručení účtenky	receipt_shipping_id	integer	Jedinečné číselné ID záznamu o zásilce účtenky v obchodě.
Časové razítko oznámení o zásilce	shipment_notification_timestamp	integer	Čas, kdy Etsy informoval kupujícího o události zásilky v epochových sekundách.
Jméno dopravce	carrier_name	string	Řetězec názvu dopravce nebo společnosti zodpovědné za dodání zásilky.
Sledovací kód	tracking_code	string	Řetězec sledovacího kódu poskytnutý dopravcem nebo společností pro zásilku.

ShopReceipts

Účtenky pro konkrétní obchod.

Name	Cesta	Typ	Description
Počet	count	integer	Počet nalezených účtenek v obchodě.
Results	results	array of ShopReceipt	Seznam nalezených zdrojů účtenek v obchodě se všemi poli Účtenka obchodu pro každý zdroj

TransactionReviews

Sada záznamů kontroly transakcí, které opustila uživatelé.

Name	Cesta	Typ	Description
Počet	count	integer	Počet nalezených prostředků TransactionReview.
Results	results	array of TransactionReview	Byly nalezeny prostředky TransactionReview.

TransactionReview

Záznam kontroly transakce, který opustil uživatel.

Name	Cesta	Typ	Description
ID obchodu	shop_id	integer	Číselné ID obchodu.
ID výpisu	listing_id	integer	ID obchodu, do kterého patří TransactionReview.
ID uživatele kupujícího	buyer_user_id	integer	Číselné ID uživatele, který byl kupujícím v této transakci. Poznámka: Toto pole může chybět v závislosti na nastavení ochrany osobních údajů kupujícího.
Rating	rating	integer	Hodnota hodnocení ve měřítku od 1 do 5
Zkontrolovat zprávu	review	string	Zpráva, kterou autor opustil, vysvětluje zpětnou vazbu.
Jazyk	language	string	Jazyk TransactionReview
Úplná adresa URL obrázku	image_url_fullxfull	string	Adresa URL fotky poskytnuté zpětné vazby, rozměry fullxfull. Poznámka: Toto pole může chybět v závislosti na nastavení ochrany osobních údajů kupujícího.
Vytvořené časové razítko	create_timestamp	integer	Datum a čas vytvoření TransactionReview v epochových sekundách.
Časové razítko aktualizace	update_timestamp	integer	Datum a čas aktualizace TransactionReview v epochových sekundách.

SellerTaxonomyNodes

Seznam uzlů taxonomie ze stromu taxonomie prodejce

Name	Cesta	Typ	Description
Počet	count	integer	Počet výsledků.
Results	results	array of SellerTaxonomyNode	Seznam požadovaných prostředků

SellerTaxonomyNode

Uzel taxonomie ve stromu taxonomie prodejce

Name	Cesta	Typ	Description
ID	id	integer	Jedinečné číselné ID uzlu taxonomie Etsy, což je kategorie metadat pro výpisy uspořádané do stromu hierarchie taxonomie prodejce. Například uzel taxonomie bot (ID: 1429, úroveň: 1) je v hierarchii vyšší než boty dívek (ID: 1440, úroveň: 2). Uzly taxonomie přiřazené k výpisu podporují přístup ke konkrétním standardizovaným škálám a vlastnostem produktů. Například výpisy přiřazené boty taxonomie boty nebo dívčí boty podporují přístup k velikosti obuvi EU s přidruženými názvy vlastností a ID velikostí bot EU, například vlastnost value_id:1394 a name:38.
Úroveň	level	integer	Celočíselná hloubka tohoto uzlu taxonomie ve stromu taxonomie prodejce s kořeny na úrovni 0.
Název	name	string	Řetězec názvu pro tento uzel taxonomie.
Nadřazené ID	parent_id	integer	ID číselné taxonomie nadřazeného uzlu.
Děti	children	array of SellerTaxonomyNode	Pole uzlů taxonomie pro všechny přímé podřízené položky tohoto uzlu taxonomie ve stromu taxanomy prodejce.
ID cest taxonomie	full_path_taxonomy_ids	array of integer	Pole ID taxonomie včetně tohoto uzlu a všech jeho přímých nadřazených prvků ve stromu taxonomie prodejce až do kořenového uzlu. Jsou uvedeny v pořadí od kořene po list.

TaxonomyNodeProperties

Seznam definic vlastností produktu.

Name	Cesta	Typ	Description
Počet	count	integer	Počet výsledků.
Results	results	array of TaxonomyNodeProperty	Seznam požadovaných prostředků

TaxonomyNodeProperty

Definice vlastnosti produktu.

Name	Cesta	Typ	Description
ID vlastnosti	property_id	integer	Jedinečné číselné ID této vlastnosti produktu.
Název	name	string	Řetězec názvu pro tento uzel taxonomie.
Zobrazovaný název	display_name	string	Řetězec názvu vlastnosti produktu čitelný pro člověka.
Váhy	scales	array of TaxonomyPropertyScale	Seznam dostupných škál.
Vyžaduje se	is_required	boolean	Pokud je pravda, výpisy přiřazených id opravňující taxonomie vyžadují tuto vlastnost.
Podporuje atributy.	supports_attributes	boolean	Pokud ano, můžete tuto vlastnost použít ve výpisu atributů.
Podporuje varianty.	supports_variations	boolean	Pokud ano, můžete tuto vlastnost použít ve výpisu variant.
Je vícehodnotový	is_multivalued	boolean	Pokud je hodnota true, můžete této vlastnosti přiřadit více hodnot vlastností.
Možné hodnoty	possible_values	array of TaxonomyPropertyValue	Seznam podporovaných řetězců hodnot vlastností pro tuto vlastnost.
Vybrané hodnoty	selected_values	array of TaxonomyPropertyValue	Seznam řetězců hodnot vlastností se automaticky a vždy vybere pro danou vlastnost.

TaxonomyPropertyScale

Měřítko defnining přiřaditelné přírůstky pro hodnoty vlastností dostupné pro konkrétní vlastnosti produktu.

Name	Cesta	Typ	Description
ID škálování	scale_id	integer	Jedinečné číselné ID měřítka.
Zobrazovaný název	display_name	string	Řetězec názvu pro měřítko.
Description	description	string	Řetězec popisu pro měřítko.

TaxonomyPropertyValue

Hodnota vlastnosti pro konkrétní vlastnost produktu, která může také využívat konkrétní měřítko.

Name	Cesta	Typ	Description
ID hodnoty	value_id	integer	Číselné ID této hodnoty vlastnosti.
Název	name	string	Řetězec názvu této hodnoty vlastnosti.
ID škálování	scale_id	integer	ID číselného měřítka měřítka, do kterého tato hodnota vlastnosti patří.
Rovná se	equal_to	array of integer	Seznam ID číselných hodnot vlastností se tato hodnota vlastnosti rovná (pokud existuje).

Přepravní vozíky

Představuje několik přepravních vozíků.

Name	Cesta	Typ	Description
count	count	integer
results	results	array of ShippingCarrier

ShippingCarrier

Podporovaný dopravce, který se používá k výpočtu odhadovaného data doručení.

Name	Cesta	Typ	Description
ID přepravního dopravce	shipping_carrier_id	integer	Číselné ID tohoto přepravního dopravce.
Název	name	string	Jméno tohoto přepravního dopravce.
Domácí třídy	domestic_classes	array of ShippingCarrierMailClass	Sada domácích poštovních tříd tohoto dopravce.
Mezinárodní třídy	international_classes	array of ShippingCarrierMailClass	Sada mezinárodních poštovních tříd tohoto přepravního dopravce.

ShippingCarrierMailClass

Poštovní třída přepravního dopravce, která se používá k výpočtu odhadovaného data doručení.

Name	Cesta	Typ	Description
ID třídy pošty	mail_class_key	string	Jedinečný identifikátor této třídy pošty.
Název	name	string	Název této třídy pošty.

Obchody

Sada záznamů v obchodě.

Name	Cesta	Typ	Description
Počet	count	integer	Celkový počet obchodů
Results	results	array of Shop	V obchodě jsou prostředky.

ShopSection

Oddíl v obchodě, do kterého může uživatel řadit výpisy.

Name	Cesta	Typ	Description
ID oddílu obchodu	shop_section_id	integer	Číselné ID oddílu v konkrétním obchodě Etsy.
Title	title	string	Řetězec názvu oddílu obchodu.
Hodnost	rank	integer	Kladné nenulové číselné umístění tohoto oddílu v objednávce zobrazení oddílu pro obchod s pořadím 1 oddílů, které se zobrazují jako první.
ID uživatele	user_id	integer	Číselné ID uživatele, který vlastní tento oddíl obchodu.
Počet aktivních výpisů	active_listing_count	integer	Početaktivníchch

ShopSections

Všechny oddíly v nejvýznamném obchodě.

Name	Cesta	Typ	Description
Počet	count	integer	Počet výsledků.
Results	results	array of ShopSection	Seznam požadovaných prostředků

ShopShippingProfile

Představuje profil použitý k nastavení informací o expedičním výpisu. Upozorňujeme, že prostřednictvím rozhraní API není možné vytvářet počítané šablony expedice. Počítané expediční profily vytvořené z Shop Manageru ale můžete přidružit k výpisům pomocí rozhraní API.

Name	Cesta	Typ	Description
ID expedičního profilu	shipping_profile_id	integer	Číselné ID expedičního profilu.
Title	title	string	Řetězec názvu tohoto expedičního profilu.
ID uživatele	user_id	integer	Číselné ID uživatele, který vlastní expediční profil.
Minimální počet dnů zpracování	min_processing_days	integer	Minimální počet dní pro zpracování výpisu.
Maximální počet dnů zpracování	max_processing_days	integer	Maximální počet dní pro zpracování výpisu.
Popisek dnů zpracování	processing_days_display_label	string	Přeložený řetězec popisku zobrazení pro zpracování dnů
Země původu – ISO	origin_country_iso	string	Kód ISO země, ze které se seznam dodává.
Je odstraněno.	is_deleted	boolean	Pokud je pravda, někdo odstranil tento expediční profil.
Cíle expedičního profilu	shipping_profile_destinations	array of ShopShippingProfileDestination	Seznam cílů expedičního profilu, které jsou pro tento expediční profil k dispozici.
Upgrady expedičního profilu	shipping_profile_upgrades	array of ShopShippingProfileUpgrade	Seznam upgradů expedičního profilu, které jsou k dispozici pro tento expediční profil.
PSČ původu	origin_postal_code	string	Řetězec PSČ (nemusí nutně číslo) pro umístění, ze kterého se výpis dodává.
Typ profilu	profile_type	ProfileType

ShopShippingProfileDestination

Představuje expediční cíl přiřazený k expedičnímu profilu.

Name	Cesta	Typ	Description
ID cíle expedičního profilu	shipping_profile_destination_id	integer	Číselné ID cíle expedičního profilu v expedičním profilu přidruženém k výpisu.
ID expedičního profilu	shipping_profile_id	integer	Číselné ID expedičního profilu.
Země původu – ISO	origin_country_iso	string	Kód ISO země, ze které se seznam dodává.
Iso cílové země	destination_country_iso	string	Kód ISO země, do které se seznam dodává. Pokud má hodnotu null, požadavek nastaví cíl na destination_region
Cílová oblast	destination_region	DestinationRegion	Kód oblasti, do které se seznam dodává. Oblast představuje sadu zemí. Podporované oblasti jsou Evropská unie a Unie mimo Evropu (země v Evropě, nikoli v EU). Pokud žádná, požadavek nastaví cíl na destination_country_iso nebo všude, pokud destination_country_iso má také hodnotu null.
Peníze	primary_cost	Money	Reprezentace částky peněz.
Peníze	secondary_cost	Money	Reprezentace částky peněz.
ID přepravního dopravce	shipping_carrier_id	integer	Jedinečné ID podporovaného dopravce, který se používá k výpočtu odhadovaného data doručení.
Mail – třída	mail_class	string	Jedinečný řetězec ID poštovní třídy přepravního dopravce, který se používá k výpočtu odhadovaného data doručení.
Minimální počet dnů doručení	min_delivery_days	integer	Minimální počet pracovních dnů, které může kupující očekávat, že po odeslání obdrží zakoupenou položku.
Maximální počet dnů doručení	max_delivery_days	integer	Maximální počet pracovních dnů, které může kupující očekávat, že po odeslání obdrží zakoupenou položku.

ShopShippingProfileUpgrade

Reprezentace možnosti upgradu expedičního profilu

Name	Cesta	Typ	Description
ID expedičního profilu	shipping_profile_id	integer	Číselné ID základního expedičního profilu.
ID upgradu	upgrade_id	integer	Číselné ID přidružené k upgradu expedice
Název upgradu	upgrade_name	string	Název expedičního upgradu zobrazeného pro nakupující v pokladně, např. PRIORITA USPS.
Typ	type	Type	Typ upgradu expedice. Vnitrostátní (0) nebo mezinárodní (1).
Hodnost	rank	integer	Kladná nenulová číselná pozice na obrázcích zobrazených ve výpisu s pořadím 1 obrázků, které se zobrazují v seznamu úplně vlevo.
Jazyk	language	string	Značka jazyka IETF pro jazyk expedičního profilu. Příklad: de, en, es, fr, it, ja, nl, pl, pt, ru.
Peníze	price	Money	Reprezentace částky peněz.
Peníze	secondary_price	Money	Reprezentace částky peněz.
ID přepravního dopravce	shipping_carrier_id	integer	Jedinečné ID podporovaného dopravce, který se používá k výpočtu odhadovaného data doručení.
Mail – třída	mail_class	string	Jedinečný řetězec ID poštovní třídy přepravního dopravce, který se používá k výpočtu odhadovaného data doručení.
Minimální počet dnů doručení	min_delivery_days	integer	Minimální počet pracovních dnů, které může kupující očekávat, že po odeslání obdrží zakoupenou položku.
Maximální počet dnů doručení	max_delivery_days	integer	Maximální počet pracovních dnů, které může kupující očekávat, že po odeslání obdrží zakoupenou položku.

ShopShippingProfileDestinations

Představuje seznam cílových objektů expedice.

Name	Cesta	Typ	Description
Počet	count	integer	Počet výsledků.
Results	results	array of ShopShippingProfileDestination	Seznam požadovaných prostředků

ShopShippingProfileUpgrades

Seznam možností upgradu expedice.

Name	Cesta	Typ	Description
Počet	count	integer	Počet výsledků.
Results	results	array of ShopShippingProfileUpgrade	Seznam požadovaných prostředků

UserAddress

Představuje adresu uživatele.

Name	Cesta	Typ	Description
ID adresy uživatele	user_address_id	integer	Číselné ID adresy uživatele.
ID uživatele	user_id	integer	Číselné ID uživatele.
Název	name	string	Jméno uživatele pro tuto adresu.
První řádek adresy	first_line	string	První řádek adresy uživatele
Druhý řádek adresy	second_line	string	Druhý řádek adresy uživatele.
City	city	string	Pole město adresy uživatele.
Stát	state	string	Pole stavu adresy uživatele.
PSČ	zip	string	Pole PSČ adresy uživatele.
Kód země ISO	iso_country_code	string	Kód ISO země v této adrese.
Country	country_name	string	Jméno země uživatele.
Je výchozí dodací adresa.	is_default_shipping_address	boolean	Je to výchozí dodací adresa uživatele.

UserAddresses

Představuje několik záznamů UserAddress.

Name	Cesta	Typ	Description
Počet	count	integer	Počet vrácených záznamů UserAddress.
Results	results	array of UserAddress	Pole prostředků UserAddress.

Cílová oblast

Kód oblasti, do které se seznam dodává. Oblast představuje sadu zemí. Podporované oblasti jsou Evropská unie a Unie mimo Evropu (země v Evropě, nikoli v EU). Pokud žádná, požadavek nastaví cíl na destination_country_iso nebo všude, pokud destination_country_iso má také hodnotu null.

Kód oblasti, do které se seznam dodává. Oblast představuje sadu zemí. Podporované oblasti jsou Evropská unie a Unie mimo Evropu (země v Evropě, nikoli v EU). Pokud žádná, požadavek nastaví cíl na destination_country_iso nebo všude, pokud destination_country_iso má také hodnotu null.

Cílová oblast

string

ItemDimensionsUnit

Řetězec definující jednotky použité k měření rozměrů produktu. Výchozí hodnota je null.

Řetězec definující jednotky použité k měření rozměrů produktu. Výchozí hodnota je null.

ItemDimensionsUnit

string

ItemWeightUnit

Řetězec definující jednotky použité k měření hmotnosti produktu. Výchozí hodnota je null.

Řetězec definující jednotky použité k měření hmotnosti produktu. Výchozí hodnota je null.

ItemWeightUnit

string

Příležitost

Výčtový řetězec označující příležitost, pro kterou by tento produkt udělal vhodný dárek. Výchozí hodnota je null.

Výčtový řetězec označující příležitost, pro kterou by tento produkt udělal vhodný dárek. Výchozí hodnota je null.

Příležitost

string

Typ profilu

Typ profilu

string

Recipient

Výčtový řetězec označující osobu, pro kterou by tento produkt udělal vhodný dárek. Výchozí hodnota je null.

Výčtový řetězec označující osobu, pro kterou by tento produkt udělal vhodný dárek. Výchozí hodnota je null.

Recipient

string

Stát

Výčtový řetězec z některého z: aktivních nebo neaktivních. Poznámka: Nastavení konceptu aktivního výpisu také publikuje výpis na etsy.com.

Výčtový řetězec z některého z: aktivních nebo neaktivních. Poznámka: Nastavení konceptu aktivního výpisu také publikuje výpis na etsy.com.

Stát

integer

Typ

Typ upgradu expedice. Vnitrostátní (0) nebo mezinárodní (1).

Typ upgradu expedice. Vnitrostátní (0) nebo mezinárodní (1).

Typ

integer

Při vytváření

Výčtový řetězec pro éru, ve které tvůrce vytvořil produkt v tomto výpisu. Pomáhá kupujícím najít výpis pod nadpisem Vintage. Vyžaduje is_supply a who_made.

Výčtový řetězec pro éru, ve které tvůrce vytvořil produkt v tomto výpisu. Pomáhá kupujícím najít výpis pod nadpisem Vintage. Vyžaduje is_supply a who_made.

Při vytváření

string

WhoMade

Výčet řetězce inidcated who made the product. Pomáhá kupujícím najít výpis pod nadpisem Handmade. Vyžaduje is_supply a when_made.

Výčet řetězce inidcated who made the product. Pomáhá kupujícím najít výpis pod nadpisem Handmade. Vyžaduje is_supply a when_made.

WhoMade

string