Etsy (oberoende utgivare)

Den här anslutningsappen använder din API-nyckel för att komma åt olika Etsy.com funktioner. Den stöder åtgärder för inventering, försäljningsorder och butikshantering. Alla åtgärder baseras på Etsy Open API v3 som har slutpunkter som fortfarande är i betaversion. Om till exempel åtgärder använder beta-API:et, kommer åtgärden med inkludera Beta i rubriken och returnera en 501-svarskod.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster	Class	Regioner
Copilot Studio	Premie	Alla Power Automate-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)
Logiska appar	Norm	Alla Logic Apps-regioner utom följande:      – Azure Government-regioner      – Regioner i Azure Kina      - US Department of Defense (DoD)
Power Apps	Premie	Alla Power Apps-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)
Power Automate	Premie	Alla Power Automate-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)

Kontakt
Namn	Troy Taylor
URL	https://www.hitachisolutions.com
E-postmeddelande	ttaylor@hitachisolutions.com

Metadata för anslutningsprogram
Utgivare	Troy Taylor, Hitachi Solutions
Webbplats	https://www.etsy.com/
Sekretesspolicy	https://www.etsy.com/legal/privacy/
Kategorier	Commerce

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:

Standardinställning	Parametrar för att skapa anslutning.	Alla regioner	Går inte att dela

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Namn	Typ	Description	Krävs
API-nyckel	securestring	API-nyckeln för det här API:et	Sann

Begränsningsgränser

Name	Anrop	Förnyelseperiod
API-anrop per anslutning	100	60 sekunder

Åtgärder

Avsnittet Hämta butik	Hämtar ett butiksavsnitt som refereras till av avsnitts-ID och butiks-ID.
Få aktiva listor per butik	Hämtar en lista över alla aktiva listor på Etsy i en specifik butik, sidnumrerad efter skapandedatum.
Hämta aktiva listor	En lista över alla aktiva listor på Etsy sidnumrerade efter deras skapandedatum. Utan sorteringsordningslistor returneras nyast först som standard.
Hämta aktuella listor per butik	Hämtar listor som är associerade med en butik som finns.
Hämta alla listfiler	Hämtar alla filer som är associerade med den angivna digitala listan. Om du begär filer från en fysisk lista returneras ett tomt resultat.
Hämta användaradresser	Hämta en lista över användaradresser.
Hämta användare	Returnerar användarprofilen för användaren som identifieras av ett användar-ID.
Hämta användarens adress	Hämtar användarens adress. Utveckling för den här slutpunkten pågår. Det returnerar bara ett 501-svar.
Hämta butik efter ägar-ID	Hämtar butiken som identifieras av butiksägarens användar-ID.
Hämta butiksavsnitt	Hämtar listan över butiksavsnitt i en specifik butik som identifieras med butiks-ID.
Hämta en betalning från ett transaktions-ID för ett betalningskonto	Hämta en betalning från ett transaktions-ID för ett betalningskonto, om tillämpligt.
Hämta en betalning från ett visst kvitto	Hämtar en betalning från ett specifikt kvitto, som identifieras med kvitto-ID, från en specifik butik, identifierad av butiks-ID.
Hämta en butiks transaktion	Hämtar listan över transaktioner som är associerade med en butik.
Hämta en fil från en lista	Hämtar en enda fil som är associerad med den angivna digitala listan. Om du begär en fil från en fysisk lista returneras ett tomt resultat.
Hämta en leveransprofil	Hämtar en leveransprofil som refereras till av leveransprofil-ID.
Hämta en lista	Hämtar en listpost genom att visa ID.
Hämta en lista över betalningar	Hämtar en lista över betalningar från en butik som identifieras av butiks-ID. Du kan också filtrera resultat med hjälp av en lista över betalnings-ID:t.
Hämta en listas bilder	Hämtar alla bildresurser för en lista med ett specifikt list-ID.
Hämta en listas egenskap (Beta)	Hämtar en listas egenskap. Utveckling för den här slutpunkten pågår. Det returnerar bara ett 501-svar.
Hämta en listas egenskaper	Returnerar en lista över en listas egenskaper.
Hämta en listas erbjudande	Få ett erbjudande för en lista.
Hämta en listas inventering	Hämtar inventeringsposten för en lista. Listor som du inte redigerade med hjälp av Etsy.com inventeringsverktyg har inga inventeringsposter. Den här slutpunkten returnerar SKU-data om du äger inventeringsposterna som hämtas.
Hämta en listas produkt	Hämta en listprodukt efter ID.
Hämta en listas transaktioner	Hämtar listan över transaktioner som är associerade med en lista.
Hämta en listas översättning	Returnerar översättningen för en lista på det angivna språket.
Hämta en listbild	Hämtar referenser och metadata för en listbild med ett specifikt bild-ID.
Hämta en transaktion	Hämtar en transaktion efter transaktions-ID.
Hämta ett kvitto	Hämtar ett kvitto som identifieras av ett kvitto-ID från en Etsy-butik.
Hämta ett kvittos transaktion	Hämtar listan över transaktioner som är associerade med ett specifikt kvitto.
Hämta fraktföretag	Hämtar en lista över tillgängliga transportföretag och de e-postklasser som är associerade med dem för ett visst land.
Hämta kvitton	Begär butikskvitton från en specifik butik, ofiltrerad eller filtrerad efter kvitto-ID-intervall eller förskjutning, datum, betald och/eller levererade inköp.
Hämta leveransprofiler	Hämtar en lista över leveransprofiler som är tillgängliga i den specifika Etsy-butik som identifieras av dess butiks-ID.
Hämta listans variantbilder	Hämtar alla variantbilder på en lista.
Hämta listor efter butiksavsnitts-ID	Hämtar alla listor från avsnittet i en specifik butik.
Hämta listor efter butikskvitto	Hämtar alla listor som är associerade med ett kvitto.
Hämta listor efter ID	Gör att du kan köra frågor mot flera list-ID:er samtidigt. Begränsa maximalt 100 ID:t per fråga.
Hämta listor per butik	Returnerar listor som tillhör en butik. Listor kan filtreras med hjälp av tillståndsparametern.
Hämta produktegenskaper efter taxonomi-ID	Hämtar en lista över produktegenskaper, med tillämpliga skalor och värden, som stöds för ett specifikt säljartaxonomi-ID.
Hämta profilmål efter leveransprofil	Hämtar en lista över leveransmålobjekt som är associerade med en leveransprofil.
Hämta recensioner	Hämtar recensionerna från en butik med tanke på dess ID.
Hämta taxonominoder för säljare	Hämtar det fullständiga hierarkiträdet för säljartaxonominoder.
Hämta transaktionsposter för ett butiksbetalningskonto	Hämta posterna i en butiks betalningskontoregister.
Hämta uppgraderingar av leveransprofilen	Hämtar listan över uppgraderingar av leveransprofilen som tilldelats till en specifik leveransprofil.
Ladda upp en listbild	Laddar upp eller tilldelar en bild till en lista som identifieras av ett butiks-ID med ett list-ID. Om du vill ladda upp en ny bild anger du bildfilen som värde för bildparametern. Du kan tilldela en tidigare borttagen bild till en lista med hjälp av den borttagna bildens bild-ID i listbild-ID-parametern. När en begäran innehåller både bild- och listningsvärden för bild-ID laddar slutpunkten endast upp bilden i bildparametern.
Ladda upp en listfil	Laddar upp en ny fil för en digital lista eller associerar en befintlig fil med en specifik lista. Du måste antingen ange listfil-ID för en befintlig fil eller namn och binära fildata för en fil att ladda upp. Om du kopplar en befintlig fil till en fysisk lista konverteras den fysiska listan till en digital lista, vilket tar bort alla fraktkostnader och eventuella produkt- och lagervariationer.
Ping	Kontrollera om du vill bekräfta anslutningen till Etsy-API:et med ett program.
Skapa en leveransprofil	Skapar en ny leveransprofil. Du kan skicka ett lands ISO-kod eller en region när du skapar en leveransprofil, men inte båda. Endast en krävs. Du måste antingen skicka ett transportföretags-ID och en e-postklass, eller både min och max leveransdagar.
Skapa en listöversättning	Skapar en listöversättning genom att visa ID och språk.
Skapa en uppgradering av leveransprofilen	Skapar en ny uppgradering av leveransprofilen, som kan fastställa ett pris för ett leveransalternativ, till exempel ett alternativt transportföretag eller snabbare leverans.
Skapa en utkastlista	Skapar en produkt för fysisk utkastlista i en butik på Etsy-kanalen.
Skapa ett butiksavsnitt	Skapar ett nytt avsnitt i en specifik butik.
Skapa ett leveranskvitto	Skickar spårningsinformation för ett butikskvitto, vilket skapar ett butikskvitto Leveranspost för det angivna kvitto-ID:t. Varje gång du skickar spårningsinformation skickar Etsy ett e-postmeddelande till köparens användare. När BCC är sant skickar Etsy även leveransmeddelanden till säljaren. När spårningskod och transportörsnamn inte skickas markeras kvittot endast som levererat.
Skapa ett leveransprofilmål	Skapar ett nytt leveransmål som anger fraktkostnad, transportör och klass för ett mål i en leveransprofil. Detta tilldelar kostnader med hjälp av valutan för den associerade butiken. Ange målet med antingen mållandets ISO- eller målregion. mållandet ISO och målregionen är ömsesidigt uteslutande – ange det ena eller det andra. Ange båda utlösarnas fel 400. Om begäran varken anger mållandets ISO eller målregion finns standardmålet överallt. Du måste också antingen tilldela både ett transportföretags-ID och e-postklass eller både min leveransdagar och maximala leveransdagar.
Sök i butiker	Returnerar en lista över butiker med matchande namn.
Ta bort en fil från listan	När du tar bort den sista filen för en digital lista konverteras listan till en fysisk lista. Svaret på en borttagningsbegäran returnerar en lista över återstående filposter som är associerade med den angivna listan.
Ta bort en leveransprofil	Tar bort en leveransprofil med angivet ID.
Ta bort en lista	Den här åtgärden tar bort en butikslista. En lista kan bara tas bort om tillståndet är något av följande: SOLD_OUT, DRAFT, EXPIRED, INACTIVE, ACTIVE och is_available eller ACTIVE och har säljflaggor: SUPRESSED (fryst), VACATION, CUSTOM_SHOPS (mönster), SELL_ON_FACEBOOK
Ta bort en listbild	Tar bort en listbild. En kopia av filen finns kvar på våra servrar, så en borttagen avbildning kan åter associeras med listan utan att den ursprungliga avbildningen laddas upp igen.
Ta bort en listegenskap	Tar bort en egenskap från en lista.
Ta bort en uppgradering av leveransprofilen	Tar bort en uppgradering av leveransprofilen och tar bort uppgraderingsalternativet från varje lista som använder den associerade leveransprofilen.
Ta bort ett leveransprofilmål	Tar bort ett leveransmål och tar bort målalternativet från varje lista som använder den associerade leveransprofilen. En leveransprofil kräver minst ett leveransmål, så den här slutpunkten kan inte ta bort det slutliga leveransmålet för någon leveransprofil. Om du vill ta bort det slutliga leveransmålet från en leveransprofil måste du ta bort hela leveransprofilen.
Uppdatera en butik	Uppdatera en butik. Förutsätter att alla strängparametrar anges på butikens primära språk.
Uppdatera en leveransprofil	Ändrar inställningarna i en leveransprofil.
Uppdatera en lista	Uppdaterar en lista, identifierad med ett list-ID, för en specifik butik som identifieras av ett butiks-ID.
Uppdatera en listas inventering	Uppdaterar inventeringen för en lista som identifieras av ett list-ID. Uppdateringen misslyckas om de angivna värdena för produkt-SKU, erbjudandekvantitet och/eller pris inte är kompatibla med värden i i egenskapsfält. När du anger ett pris tilldelar du en flyttal som är lika med beloppet dividerat med divisor enligt vad som anges i pengaresursen.
Uppdatera en listas variantbilder	Skapar variantbilder i en lista.
Uppdatera en listegenskap	Uppdaterar eller fyller i egenskapslistan som definierar produkterbjudanden för en lista. Varje erbjudande kräver både ett värde och ett värde-ID som är giltigt för ett skalnings-ID som tilldelats listan eller som du tilldelar till listan med den här begäran.
Uppdatera en listöversättning	Uppdaterar en listöversättning genom att visa ID och språk.
Uppdatera en uppgradering av leveransprofilen	Uppdaterar en uppgradering av leveransprofilen och uppdaterar alla listor som använder leveransprofilen.
Uppdatera ett leveransprofilmål	Uppdaterar ett befintligt leveransmål som kan ange eller tilldela om fraktkostnaden, transportföretaget och klassen för ett mål.

Avsnittet Hämta butik

Åtgärds-ID:

ShopGetSection

Hämtar ett butiksavsnitt som refereras till av avsnitts-ID och butiks-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Butiksavsnitts-ID	shop_section_id	True	integer	Det numeriska ID:t för ett avsnitt i en specifik Etsy-butik.

Returer

Ett avsnitt i en butik där en användare kan sortera listor.

ShopSection

ShopSection

Få aktiva listor per butik

Åtgärds-ID:

ListingGetActiveByShop

Hämtar en lista över alla aktiva listor på Etsy i en specifik butik, sidnumrerad efter skapandedatum.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.
Includes	keywords		string	Sökord eller fras som måste visas i alla resultat.

Returer

En uppsättning butikslistningsresurser.

ShopListings

ShopListings

Hämta aktiva listor

Åtgärds-ID:

ListingGetActive

En lista över alla aktiva listor på Etsy sidnumrerade efter deras skapandedatum. Utan sorteringsordningslistor returneras nyast först som standard.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.
Includes	keywords		string	Sökord eller fras som måste visas i alla resultat.
Sortera efter	sort_on		string	Värdet för att sortera ett sökresultat av listor på. Obs! Sortera på fungerar endast när det kombineras med något av sökalternativen (nyckelord, region osv.).
Sorteringsordning	sort_order		string	Stigande(upp) eller fallande(ned) ordning för att sortera listor efter. Obs! sort_order fungerar bara när det kombineras med något av sökalternativen (nyckelord, region osv.).
Minimipris	min_price		float	Det lägsta priset för listor som ska returneras av ett sökresultat.
Högsta pris	max_price		float	Det maximala priset för listor som ska returneras av ett sökresultat.
Taxonomi-ID	taxonomy_id		integer	Det numeriska taxonomi-ID:t för listan. Säljaren hanterar listning taxonomi-ID:n för sin butik.
Butiksplats	shop_location		string	Filtrerar efter butiksplats. Om platsen inte kan parsas svarar Etsy med ett fel.

Returer

En uppsättning butikslistningsresurser.

ShopListings

ShopListings

Hämta aktuella listor per butik

Åtgärds-ID:

ListingGetFeatured

Hämtar listor som är associerade med en butik som finns.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.

Returer

En uppsättning butikslistningsresurser.

ShopListings

ShopListings

Hämta alla listfiler

Åtgärds-ID:

ListingGetFiles

Hämtar alla filer som är associerade med den angivna digitala listan. Om du begär filer från en fysisk lista returneras ett tomt resultat.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
List-ID	listing_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.

Returer

Representerar flera ShopListingFiles.

ShopListingFiles

ShopListingFiles

Hämta användaradresser

Åtgärds-ID:

UserGetAddresses

Hämta en lista över användaradresser.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.

Returer

Representerar flera UserAddress-poster.

UserAddresses

UserAddresses

Hämta användare

Åtgärds-ID:

UserGet

Returnerar användarprofilen för användaren som identifieras av ett användar-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Användar-ID	user_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en användare.

Returer

Representerar en enskild användare av webbplatsen

User

User

Hämta användarens adress

Åtgärds-ID:

UserGetAddress

Hämtar användarens adress. Utveckling för den här slutpunkten pågår. Det returnerar bara ett 501-svar.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Användaradress-ID	user_address_id	True	integer	Det numeriska ID:t för användarens adress.

Returer

Representerar en användares adress.

UserAddress

UserAddress

Hämta butik efter ägar-ID

Åtgärds-ID:

ShopGetByOwnerID

Hämtar butiken som identifieras av butiksägarens användar-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Användar-ID	user_id	True	string	Det numeriska användar-ID:t för den användare som äger den här butiken.

Returer

En butik som skapats av en Etsy-användare.

Butik

Shop

Hämta butiksavsnitt

Åtgärds-ID:

ShopGetSections

Hämtar listan över butiksavsnitt i en specifik butik som identifieras med butiks-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.

Returer

Alla avsnitt i en sprecific Shop.

ShopSections

ShopSections

Hämta en betalning från ett transaktions-ID för ett betalningskonto

Åtgärds-ID:

PaymentGetEntryID

Hämta en betalning från ett transaktions-ID för ett betalningskonto, om tillämpligt.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Transaktionsregisterpost-ID:t	ledger_entry_ids	True	string	Matris med heltal.

Returer

Representerar flera betalningar som görs med Etsy-betalningar. Alla penningbelopp är i USD-pennies om inget annat anges.

Payments

Payments

Hämta en betalning från ett visst kvitto

Åtgärds-ID:

PaymentGetReceipt

Hämtar en betalning från ett specifikt kvitto, som identifieras med kvitto-ID, från en specifik butik, identifierad av butiks-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Kvitto-ID	receipt_id	True	string	Det numeriska ID:t för kvittot som är kopplat till den här transaktionen.

Returer

Representerar flera betalningar som görs med Etsy-betalningar. Alla penningbelopp är i USD-pennies om inget annat anges.

Payments

Payments

Hämta en butiks transaktion

Åtgärds-ID:

TransactionGetShop

Hämtar listan över transaktioner som är associerade med en butik.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.

Returer

En uppsättning transaktionsresurser för butikskvitton

ShopReceiptTransactions

ShopReceiptTransactions

Hämta en fil från en lista

Åtgärds-ID:

ListingGetFile

Hämtar en enda fil som är associerad med den angivna digitala listan. Om du begär en fil från en fysisk lista returneras ett tomt resultat.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Visa fil-ID	listing_file_id	True	integer	Det unika numeriska ID:t för en fil som är associerad med en digital lista.

Returer

En fil som är associerad med en digital lista.

ShopListingFile

ShopListingFile

Hämta en leveransprofil

Åtgärds-ID:

ShippingGetProfile

Hämtar en leveransprofil som refereras till av leveransprofil-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.

Hämta en lista

Åtgärds-ID:

ListingGet

Hämtar en listpost genom att visa ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Includes	includes		string	En uppräkningssträng som bifogar en giltig association. Godtagbara indata är "shop", "images" och "user".

Hämta en lista över betalningar

Åtgärds-ID:

PaymentsGet

Hämtar en lista över betalningar från en butik som identifieras av butiks-ID. Du kan också filtrera resultat med hjälp av en lista över betalnings-ID:t.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
BetalningsID	payment-ids	True	string	En kommaavgränsad matris med betalnings-ID-nummer.

Returer

Representerar flera betalningar som görs med Etsy-betalningar. Alla penningbelopp är i USD-pennies om inget annat anges.

Payments

Payments

Hämta en listas bilder

Åtgärds-ID:

ListingGetImages

Hämtar alla bildresurser för en lista med ett specifikt list-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.

Returer

Representerar en lista över bildresurser som var och en innehåller referens-URL:er och metadata för en bild.

ListingImages

ListingImages

Hämta en listas egenskap (Beta)

Åtgärds-ID:

ListingGetProperty

Hämtar en listas egenskap. Utveckling för den här slutpunkten pågår. Det returnerar bara ett 501-svar.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Egenskaps-ID	property_id	True	integer	Det unika ID:t för en Etsy-listegenskap.

Returer

En representation av strukturerade datavärden.

ListingPropertyValue

ListingPropertyValue

Hämta en listas egenskaper

Åtgärds-ID:

ListingGetProperties

Returnerar en lista över en listas egenskaper.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.

Returer

Representerar flera egenskapsvärden i listan.

ListingPropertyValues

ListingPropertyValues

Hämta en listas erbjudande

Åtgärds-ID:

ListingGetOffering

Få ett erbjudande för en lista.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Produkt-ID	product_id	True	integer	Det numeriska ID:t för den produkt som är associerad med den här transaktionen.
Produkterbjudande-ID	product_offering_id	True	integer	Det numeriska ID:t för produkterbjudandet som är associerat med den här transaktionen.

Returer

En representation av ett erbjudande för en lista.

ListingInventoryProductOffering

ListingInventoryProductOffering

Hämta en listas inventering

Åtgärds-ID:

ListingGetInventory

Hämtar inventeringsposten för en lista. Listor som du inte redigerade med hjälp av Etsy.com inventeringsverktyg har inga inventeringsposter. Den här slutpunkten returnerar SKU-data om du äger inventeringsposterna som hämtas.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Includes	includes		string	En uppräkningssträng som bifogar en giltig association.

Returer

En representation av en enskild listas inventeringspost med associationer

ListingInventoryWithAssociations

ListingInventoryWithAssociations

Hämta en listas produkt

Åtgärds-ID:

ListingGetProduct

Hämta en listprodukt efter ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
List-ID	listing_id	True	integer	Listan som ska returnera en listprodukt för.
Produkt-ID	product_id	True	integer	Det numeriska ID:t för en specifik produkt som köpts från en lista.

Returer

En representation av en produkt för en lista.

ListingInventoryProduct

ListingInventoryProduct

Hämta en listas transaktioner

Åtgärds-ID:

TransactionsListing

Hämtar listan över transaktioner som är associerade med en lista.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.

Returer

En uppsättning transaktionsresurser för butikskvitton

ShopReceiptTransactions

ShopReceiptTransactions

Hämta en listas översättning

Åtgärds-ID:

ListingGetTranslation

Returnerar översättningen för en lista på det angivna språket.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Language	language	True	string	IETF-språktaggen för språket i den här översättningen. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru.

Returer

Representerar översättningsdata för en lista.

ListingTranslation

ListingTranslation

Hämta en listbild

Åtgärds-ID:

ListingGetImage

Hämtar referenser och metadata för en listbild med ett specifikt bild-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Lista bild-ID	listing_image_id	True	integer	Det numeriska ID:t för den primära listbilden för den här transaktionen.

Returer

Referens-URL:er och metadata för en bild som är associerad med en specifik lista. Parametern url_fullxfull innehåller URL:en för en binär bildfil i full storlek.

ListingImage

ListingImage

Hämta en transaktion

Åtgärds-ID:

TransactionGet

Hämtar en transaktion efter transaktions-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Transaktions-ID	transaction_id	True	integer	Det unika numeriska ID:t för en transaktion.

Returer

Ett transaktionsobjekt som är associerat med ett butikskvitto. Etsy genererar en transaktion per lista som köpts enligt orderkvittot.

ShopReceiptTransaction

ShopReceiptTransaction

Hämta ett kvitto

Åtgärds-ID:

ReceiptGet

Hämtar ett kvitto som identifieras av ett kvitto-ID från en Etsy-butik.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Kvitto-ID	receipt_id	True	integer	Det numeriska ID:t för kvittot som är kopplat till den här transaktionen.

Returer

Posten för ett köp från en butik. Butikskvitton visar monetära värden med hjälp av butikens valuta.

ShopReceipt

ShopReceipt

Hämta ett kvittos transaktion

Åtgärds-ID:

TransactionReceipt

Hämtar listan över transaktioner som är associerade med ett specifikt kvitto.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Kvitto-ID	receipt_id	True	integer	Det numeriska ID:t för kvittot som är kopplat till den här transaktionen.

Returer

En uppsättning transaktionsresurser för butikskvitton

ShopReceiptTransactions

ShopReceiptTransactions

Hämta fraktföretag

Åtgärds-ID:

ShippingCarriers

Hämtar en lista över tillgängliga transportföretag och de e-postklasser som är associerade med dem för ett visst land.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
ISO för ursprungsland	origin_country_iso	True	string	ISO-koden för det land som listan levereras från.

Returer

Representerar flera ShippingCarriers.

ShippingCarriers

ShippingCarriers

Hämta kvitton

Åtgärds-ID:

ReceiptsGet

Begär butikskvitton från en specifik butik, ofiltrerad eller filtrerad efter kvitto-ID-intervall eller förskjutning, datum, betald och/eller levererade inköp.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Minsta antal skapade	min_created		integer	Den tidigaste unix-tidsstämpeln för när en post skapades.
Maximalt antal skapade	max_created		integer	Den senaste unix-tidsstämpeln för när en post skapades.
Tidigast senast ändrad	min_last_modified		integer	Den tidigaste unix-tidsstämpeln för när en post senast ändrades.
Senast ändrad	max_last_modified		integer	Den senaste unix-tidsstämpeln för när en post senast ändrades.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.
Betalades	was_paid		boolean	När det är sant fick säljaren betalning för produkterna i detta kvitto.
Levererades	was_shipped		boolean	När det är sant levererade säljaren produkterna på det här kvittot.

Returer

Kvitton för en specifik butik.

ShopReceipts

ShopReceipts

Hämta leveransprofiler

Åtgärds-ID:

ShippingProfiles

Hämtar en lista över leveransprofiler som är tillgängliga i den specifika Etsy-butik som identifieras av dess butiks-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.

Returer

Representerar en profil som används för att ange en listas leveransinformation. Observera att det inte går att skapa beräknade leveransmallar via API:et. Du kan dock associera beräknade leveransprofiler som skapats från Shop Manager med listor med hjälp av API:et.

ShopShippingProfile

ShopShippingProfile

Hämta listans variantbilder

Åtgärds-ID:

ListingGetVariation

Hämtar alla variantbilder på en lista.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.

Returer

Representerar flera olika variantbilder.

ListingVariationImages

ListingVariationImages

Hämta listor efter butiksavsnitts-ID

Åtgärds-ID:

ListingGetBySectionID

Hämtar alla listor från avsnittet i en specifik butik.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Butiksavsnitts-ID:t	shop_section_ids	True	string	En matris med numeriska ID:n för alla avsnitt i en specifik Etsy-butik.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.
Sortera efter	sort_on		string	Värdet för att sortera ett sökresultat av listor på.
Sorteringsordning	sort_order		string	Stigande(upp) eller fallande(ned) ordning för att sortera listor efter.

Returer

En uppsättning butikslistningsresurser.

ShopListings

ShopListings

Hämta listor efter butikskvitto

Åtgärds-ID:

ListingGetByReceipt

Hämtar alla listor som är associerade med ett kvitto.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det numeriska ID:t för kvittot som är kopplat till den här transaktionen.
Kvitto-ID	receipt_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.

Returer

En uppsättning butikslistningsresurser.

ShopListings

ShopListings

Hämta listor efter ID

Åtgärds-ID:

ListingGetByID

Gör att du kan köra frågor mot flera list-ID:er samtidigt. Begränsa maximalt 100 ID:t per fråga.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Lista ID:t	listing_ids	True	string	Matrisen med numeriska ID:n för listorna i en specifik Etsy-butik.
Includes	includes		string	En uppräkningssträng som bifogar en giltig association.

Returer

En uppsättning butikslistningsresurser med associationer.

ShopListingsWithAssociations

ShopListingsWithAssociations

Hämta listor per butik

Åtgärds-ID:

ListingGetShop

Returnerar listor som tillhör en butik. Listor kan filtreras med hjälp av tillståndsparametern.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Stat/län	State		string	En uppräknad sträng från någon av: aktiv eller inaktiv.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.
Sortera efter	Sort On		string	Värdet för att sortera ett sökresultat av listor på.
Sorteringsordning	Sort Order		string	Stigande(upp) eller fallande(ned) ordning för att sortera listor efter.

Returer

En uppsättning butikslistningsresurser.

ShopListings

ShopListings

Hämta produktegenskaper efter taxonomi-ID

Åtgärds-ID:

ListingGetPropertiesByTaxonomy

Hämtar en lista över produktegenskaper, med tillämpliga skalor och värden, som stöds för ett specifikt säljartaxonomi-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Taxonomi-ID	taxonomy_id	True	string	Det unika numeriska ID:t för en Etsy-taxonominod, som är en metadatakategori för listor ordnade i hierarkiträdet för säljarens taxonomi.

Returer

En lista över produktegenskapsdefinitioner.

TaxonomyNodeProperties

TaxonomyNodeProperties

Hämta profilmål efter leveransprofil

Åtgärds-ID:

ShippingGetDestinations

Hämtar en lista över leveransmålobjekt som är associerade med en leveransprofil.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.

Returer

Representerar en lista över leveransmålobjekt.

ShopShippingProfileDestinations

ShopShippingProfileDestinations

Hämta recensioner

Åtgärds-ID:

ReviewsGet

Hämtar recensionerna från en butik med tanke på dess ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.

Returer

En uppsättning transaktionsgranskningsposter som lämnas av användare.

TransactionReviews

TransactionReviews

Hämta taxonominoder för säljare

Åtgärds-ID:

ListingGetTaxonomyNodes

Hämtar det fullständiga hierarkiträdet för säljartaxonominoder.

Returer

En lista över taxonominoder från säljarens taxonomiträd.

SellerTaxonomyNodes

SellerTaxonomyNodes

Hämta transaktionsposter för ett butiksbetalningskonto

Åtgärds-ID:

PaymentLedgerEntries

Hämta posterna i en butiks betalningskontoregister.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Minsta antal skapade	min_created	True	integer	Den tidigaste unix-tidsstämpeln för när en post skapades.
Maximalt antal skapade	max_created	True	integer	Den senaste unix-tidsstämpeln för när en post skapades.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.

Returer

En uppsättning transaktionsresurser för betalningskontot

PaymentAccountLedgerEntries

PaymentAccountLedgerEntries

Hämta uppgraderingar av leveransprofilen

Åtgärds-ID:

ShippingGetProfileUpgrades

Hämtar listan över uppgraderingar av leveransprofilen som tilldelats till en specifik leveransprofil.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.

Returer

En lista över alternativ för leveransuppgradering.

ShopShippingProfileUpgrades

ShopShippingProfileUpgrades

Ladda upp en listbild

Åtgärds-ID:

ListingUploadImage

Laddar upp eller tilldelar en bild till en lista som identifieras av ett butiks-ID med ett list-ID. Om du vill ladda upp en ny bild anger du bildfilen som värde för bildparametern. Du kan tilldela en tidigare borttagen bild till en lista med hjälp av den borttagna bildens bild-ID i listbild-ID-parametern. När en begäran innehåller både bild- och listningsvärden för bild-ID laddar slutpunkten endast upp bilden i bildparametern.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Bild	image		string	Filnamnssträngen för en fil som ska laddas upp.
Lista bild-ID	listing_image_id		integer	Det numeriska ID:t för den primära listbilden för den här transaktionen.
Rangordning	rank		integer	Den positiva icke-noll numeriska positionen i bilderna som visas i en lista, med rankning 1 bilder som visas i den vänstra positionen i en lista.
Skriv över	overwrite		boolean	När det är sant ersätter den här begäran den befintliga avbildningen med en viss rangordning.
Är vattenstämplad	is_watermarked		boolean	När det är sant anger det att den uppladdade bilden har en vattenstämpel.

Returer

Referens-URL:er och metadata för en bild som är associerad med en specifik lista. Parametern url_fullxfull innehåller URL:en för en binär bildfil i full storlek.

ListingImage

ListingImage

Ladda upp en listfil

Åtgärds-ID:

ListingUpload

Laddar upp en ny fil för en digital lista eller associerar en befintlig fil med en specifik lista. Du måste antingen ange listfil-ID för en befintlig fil eller namn och binära fildata för en fil att ladda upp. Om du kopplar en befintlig fil till en fysisk lista konverteras den fysiska listan till en digital lista, vilket tar bort alla fraktkostnader och eventuella produkt- och lagervariationer.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Visa fil-ID	listing_file_id		integer	Det unika numeriska ID:t för en fil som är associerad med en digital lista.
File	file	True	string	En binär fil att ladda upp.
Namn	name		string	Filnamnssträngen för en fil som ska laddas upp
Rangordning	rank		integer	Den positiva icke-noll numeriska positionen i bilderna som visas i en lista, med rankning 1 bilder som visas i den vänstra positionen i en lista.

Returer

En fil som är associerad med en digital lista.

ShopListingFile

ShopListingFile

Ping

Åtgärds-ID:

Ping

Kontrollera om du vill bekräfta anslutningen till Etsy-API:et med ett program.

Returer

En bekräftelse på att det aktuella programmet har åtkomst till Open API

Pong

Pong

Skapa en leveransprofil

Åtgärds-ID:

ShippingCreateProfile

Skapar en ny leveransprofil. Du kan skicka ett lands ISO-kod eller en region när du skapar en leveransprofil, men inte båda. Endast en krävs. Du måste antingen skicka ett transportföretags-ID och en e-postklass, eller både min och max leveransdagar.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Titel	title	True	string	Namnsträngen för den här leveransprofilen.
ISO för ursprungsland	origin_country_iso	True	string	ISO-koden för det land som listan levereras från.
Primär kostnad	primary_cost	True	float	Kostnaden för leverans till det här landet/regionen, mätt i butikens standardvaluta.
Sekundär kostnad	secondary_cost	True	float	Kostnaden för leverans till det här landet/regionen med ett annat objekt, mätt i butikens standardvaluta.
Minsta bearbetningstid	min_processing_time	True	integer	Den minsta tid som krävs för att bearbeta för att skicka listor med den här leveransprofilen.
Maximal bearbetningstid	max_processing_time	True	integer	Den maximala bearbetningstid som listan behöver skicka.
Bearbetningstidsenhet	processing_time_unit		string	Den enhet som används för att representera hur lång tid en bearbetningstid är. En vecka motsvarar 5 arbetsdagar.
ISO för målland	destination_country_iso		string	ISO-koden för det land som listan levereras till. Om värdet är null anger begäran målet till målregionen.
Målregion	destination_region		string	Koden för den region som listan levereras till. En region representerar en uppsättning länder. Regioner som stöds är Eu-unionen och icke-Europeiska unionen (länder i Europa som inte är i EU). Om inget görs anger begäran målet till mållandets ISO, eller överallt om mållandets ISO också är null.
Ursprungspostnummer	origin_postal_code		string	Postnummersträngen (inte nödvändigtvis ett nummer) för den plats från vilken listan levereras.
Transportföretags-ID	shipping_carrier_id		integer	Det unika ID:t för ett transportföretag som stöds, som används för att beräkna ett beräknat leveransdatum.
E-postklass	mail_class		string	Den unika ID-strängen för ett transportföretags e-postklass, som används för att beräkna ett beräknat leveransdatum.
Minsta leveransdagar	min_delivery_days		integer	Det minsta antalet arbetsdagar som en köpare kan förvänta sig att vänta med att få sin köpta artikel när den har levererats.
Maximalt antal leveransdagar	max_delivery_days		integer	Det maximala antalet arbetsdagar som en köpare kan förvänta sig att vänta med att få sin köpta artikel när den har levererats.

Returer

Representerar en profil som används för att ange en listas leveransinformation. Observera att det inte går att skapa beräknade leveransmallar via API:et. Du kan dock associera beräknade leveransprofiler som skapats från Shop Manager med listor med hjälp av API:et.

ShopShippingProfile

ShopShippingProfile

Skapa en listöversättning

Åtgärds-ID:

ListingCreateTranslation

Skapar en listöversättning genom att visa ID och språk.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Language	language	True	string	IETF-språktaggen för språket i den här översättningen. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru.
Titel	title	True	string	Rubriken på listan över den här översättningen.
Description	description	True	string	Beskrivningen av listan över den här översättningen.
Etiketter	tags		string	Taggarna i listan över den här översättningen.

Returer

Representerar översättningsdata för en lista.

ListingTranslation

ListingTranslation

Skapa en uppgradering av leveransprofilen

Åtgärds-ID:

ShippingCreateUpgrade

Skapar en ny uppgradering av leveransprofilen, som kan fastställa ett pris för ett leveransalternativ, till exempel ett alternativt transportföretag eller snabbare leverans.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Typ	type	True	string	Typ av leveransuppgradering. Inrikes (0) eller internationellt (1).
Uppgraderingsnamn	upgrade_name	True	string	Namn på leveransuppgradering som visas för kunder i kassan, t.ex. USPS Priority.
Pris	price	True	float	Extra kostnad för att lägga till leveransuppgradering.
Sekundärt pris	secondary_price	True	float	Ytterligare kostnad för att lägga till leveransuppgradering för varje ytterligare objekt.
Transportföretags-ID	shipping_carrier_id		integer	Det unika ID:t för ett transportföretag som stöds, som används för att beräkna ett beräknat leveransdatum.
E-postklass	mail_class		string	Den unika ID-strängen för ett transportföretags e-postklass, som används för att beräkna ett beräknat leveransdatum.
Minsta leveransdagar	min_delivery_days		integer	min_delivery_days
Maximalt antal leveransdagar	max_delivery_days		integer	Det maximala antalet arbetsdagar som en köpare kan förvänta sig att vänta med att få sin köpta artikel när den har levererats.

Returer

En representation av uppgraderingsalternativet för en leveransprofil.

ShopShippingProfileUpgrade

ShopShippingProfileUpgrade

Skapa en utkastlista

Åtgärds-ID:

ListingCreate

Skapar en produkt för fysisk utkastlista i en butik på Etsy-kanalen.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Kvantitet	quantity	True	integer	Det positiva antalet produkter som inte är noll som är tillgängliga för köp i listan.
Titel	title	True	string	Listans rubriksträng. Giltiga rubriksträngar innehåller bara bokstäver, siffror, skiljetecken, matematiska symboler, blankstegstecken, ™ , © och ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Du kan bara använda tecknen %, :, & och + en gång var.
Description	description	True	string	En beskrivningssträng för produkten som ska säljas i listan.
Pris	price	True	float	Det positiva priset på produkten som inte är noll. (Sålda produktlistor är privata) Obs! Priset är det lägsta möjliga priset.
Vem gjorde	who_made	True	string	En sträng inidcated vem som gjorde produkten. Hjälper köpare att hitta listan under den handgjorda rubriken. Kräver "is_supply" och "when_made".
När den är gjord	when_made		string	En sträng för den tid då tillverkaren gjorde produkten i den här listan. Hjälper köpare att hitta listan under rubriken Vintage. Kräver "is_supply" och "who_made".
Taxonomi-ID	taxonomy_id	True	integer	Det numeriska taxonomi-ID:t för listan. Säljaren hanterar listning taxonomi-ID:n för sin butik.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Materials	materials		string	En matris med materialsträngar för material som används i produkten. Giltiga materialsträngar innehåller endast bokstäver, siffror och blankstegstecken. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Butiksavsnitts-ID	shop_section_id		integer	Det numeriska ID:t för butiksavsnittet för den här listan.
Minsta bearbetning	processing_min		integer	Det minsta antal dagar som krävs för att bearbeta den här listan.
Maximal bearbetning	processing_max		integer	Det maximala antalet dagar som krävs för att bearbeta den här listan.
Etiketter	tags		string	En matris med taggsträngar för listan. Giltiga taggsträngar innehåller bara bokstäver, siffror, blankstegstecken, -, ', ™ , © och ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)
Recipient	recipient		string	En sträng som anger en person för vilken den här produkten skulle göra en lämplig gåva.
Tillfälle	occasion		string	En sträng som anger ett tillfälle då den här produkten skulle göra en lämplig gåva.
Stilar	styles		string	En matris med formatsträngar för den här listan, som var och en är textsträng i fri form, till exempel Formal eller Steampunk. En lista kan ha upp till två formatmallar. Giltiga formatsträngar innehåller bara bokstäver, siffror och blankstegstecken. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Artikelvikt	item_weight		float	Den numeriska vikten för produkten som mäts i enheter som anges i artikelns viktenhet.
Artikellängd	item_length		integer	Den numeriska längden på produkten som mäts i enheter som anges i enheten för objektdimensioner.
Objektbredd	item_width		float	Den numeriska bredden på produkten som mäts i enheter som anges i "artikeldimensionsenhet".
Objekthöjd	item_height		float	Den numeriska höjden på produkten som mäts i enheter som anges i "artikeldimensionsenhet".
Artikelns viktenhet	item_weight_unit		string	En sträng som definierar de enheter som används för att mäta produktens vikt.
Objektdimensionsenhet	item_dimensions_unit		string	En sträng som definierar de enheter som används för att mäta produktens dimensioner.
Är personligt ansenlig	is_personalizable		boolean	När det är sant är den här listan personlig.
Bild-ID:t	image_ids		string	En matris med numeriska bild-ID:n för bilderna i en lista, som kan innehålla upp till 10 bilder.
Är leverans	is_supply		boolean	När det är sant taggar du listan som en leveransprodukt, annars anger att det är en färdig produkt. Hjälper köpare att hitta listan under rubriken Leveranser. Kräver "who made" och "when made".
Är anpassningsbar	is_customizable		boolean	När det är sant kan en köpare kontakta säljaren för en anpassad beställning. Standardvärdet är sant när en butik accepterar anpassade beställningar. Gäller inte för butiker som inte accepterar anpassade beställningar.
Är skattepliktig	is_taxable		boolean	När det är sant gäller tillämpliga butiksskattesatser för denna lista i kassan.

Returer

En lista från en butik som innehåller en produktkvantitet, rubrik, beskrivning, pris osv.

ShopListing

ShopListing

Skapa ett butiksavsnitt

Åtgärds-ID:

ShopCreateSection

Skapar ett nytt avsnitt i en specifik butik.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Titel	title	True	string	Rubriksträngen för ett butiksavsnitt.

Returer

Ett avsnitt i en butik där en användare kan sortera listor.

ShopSection

ShopSection

Skapa ett leveranskvitto

Åtgärds-ID:

ReceiptCreateShipment

Skickar spårningsinformation för ett butikskvitto, vilket skapar ett butikskvitto Leveranspost för det angivna kvitto-ID:t. Varje gång du skickar spårningsinformation skickar Etsy ett e-postmeddelande till köparens användare. När BCC är sant skickar Etsy även leveransmeddelanden till säljaren. När spårningskod och transportörsnamn inte skickas markeras kvittot endast som levererat.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Kvitto-ID	receipt_id	True	integer	Kvittot att skicka spårning för.
Spårningskod	tracking_code		string	Spårningskoden för det här kvittot.
Namn på operatör	carrier_name		string	Transportföretagets namn för det här kvittot.
Skicka hemlig kopia	send_bcc		boolean	Om sant skickas även leveransmeddelandet till säljaren

Returer

Posten för ett köp från en butik. Butikskvitton visar monetära värden med hjälp av butikens valuta.

ShopReceipt

ShopReceipt

Skapa ett leveransprofilmål

Åtgärds-ID:

ShippingCreateDestination

Skapar ett nytt leveransmål som anger fraktkostnad, transportör och klass för ett mål i en leveransprofil. Detta tilldelar kostnader med hjälp av valutan för den associerade butiken. Ange målet med antingen mållandets ISO- eller målregion. mållandet ISO och målregionen är ömsesidigt uteslutande – ange det ena eller det andra. Ange båda utlösarnas fel 400. Om begäran varken anger mållandets ISO eller målregion finns standardmålet överallt. Du måste också antingen tilldela både ett transportföretags-ID och e-postklass eller både min leveransdagar och maximala leveransdagar.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Primär kostnad	primary_cost	True	float	Kostnaden för leverans till det här landet/regionen, mätt i butikens standardvaluta.
Sekundär kostnad	secondary_cost	True	string	Kostnaden för leverans till det här landet/regionen med ett annat objekt, mätt i butikens standardvaluta.
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

Returer

Representerar ett leveransmål som tilldelats en leveransprofil.

ShopShippingProfileDestination

ShopShippingProfileDestination

Sök i butiker

Åtgärds-ID:

ShopSearch

Returnerar en lista över butiker med matchande namn.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiksnamn	shop_name	True	string	Butikens namnsträng.
Limit	limit		integer	Det maximala antalet resultat som ska returneras.
Offset	offset		integer	Antalet poster som ska hoppa över innan du väljer det första resultatet.

Returer

En uppsättning shop-poster.

Butiker

Shops

Ta bort en fil från listan

Åtgärds-ID:

ListingDeleteFile

När du tar bort den sista filen för en digital lista konverteras listan till en fysisk lista. Svaret på en borttagningsbegäran returnerar en lista över återstående filposter som är associerade med den angivna listan.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Visa fil-ID	listing_file_id	True	integer	Det unika numeriska ID:t för en fil som är associerad med en digital lista.

Ta bort en leveransprofil

Åtgärds-ID:

ShippingDeleteProfile

Tar bort en leveransprofil med angivet ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.

Returer

Representerar en profil som används för att ange en listas leveransinformation. Observera att det inte går att skapa beräknade leveransmallar via API:et. Du kan dock associera beräknade leveransprofiler som skapats från Shop Manager med listor med hjälp av API:et.

ShopShippingProfile

ShopShippingProfile

Ta bort en lista

Åtgärds-ID:

ListingDelete

Den här åtgärden tar bort en butikslista. En lista kan bara tas bort om tillståndet är något av följande: SOLD_OUT, DRAFT, EXPIRED, INACTIVE, ACTIVE och is_available eller ACTIVE och har säljflaggor: SUPRESSED (fryst), VACATION, CUSTOM_SHOPS (mönster), SELL_ON_FACEBOOK

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.

Ta bort en listbild

Åtgärds-ID:

ListingDeleteImage

Tar bort en listbild. En kopia av filen finns kvar på våra servrar, så en borttagen avbildning kan åter associeras med listan utan att den ursprungliga avbildningen laddas upp igen.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Lista bild-ID	listing_image_id	True	integer	Det numeriska ID:t för den primära listbilden för den här transaktionen.

Ta bort en listegenskap

Åtgärds-ID:

ListingDeleteProperty

Tar bort en egenskap från en lista.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Egenskaps-ID	property_id	True	integer	Det unika ID:t för en Etsy-listegenskap.

Ta bort en uppgradering av leveransprofilen

Åtgärds-ID:

ShippingDeleteProfileUpgrade

Tar bort en uppgradering av leveransprofilen och tar bort uppgraderingsalternativet från varje lista som använder den associerade leveransprofilen.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för leveransprofilen.
Uppgraderings-ID	upgrade_id	True	integer	Det numeriska ID som är associerat med en leveransuppgradering

Ta bort ett leveransprofilmål

Åtgärds-ID:

ShippingDeleteProfileDestination

Tar bort ett leveransmål och tar bort målalternativet från varje lista som använder den associerade leveransprofilen. En leveransprofil kräver minst ett leveransmål, så den här slutpunkten kan inte ta bort det slutliga leveransmålet för någon leveransprofil. Om du vill ta bort det slutliga leveransmålet från en leveransprofil måste du ta bort hela leveransprofilen.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Mål-ID för leveransprofil	shipping_profile_destination_id	True	integer	Det numeriska ID:t för leveransprofilmålet i leveransprofilen som är associerad med listan.

Uppdatera en butik

Åtgärds-ID:

ShopUpdate

Uppdatera en butik. Förutsätter att alla strängparametrar anges på butikens primära språk.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Titel	title		string	En kort rubriksträng för butikens huvudsida.
Meddelande	announcement		string	En meddelandesträng till köpare som visas på butikens hemsida.
Försäljningsmeddelande	sale_message		string	En meddelandesträng som skickas till användare som slutför ett köp från den här butiken.
Digitalt försäljningsmeddelande	digital_sale_message		string	En meddelandesträng som skickas till användare som köper ett digitalt objekt från den här butiken.

Returer

En butik som skapats av en Etsy-användare.

Butik

Shop

Uppdatera en leveransprofil

Åtgärds-ID:

ShippingUpdateProfile

Ändrar inställningarna i en leveransprofil.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Titel	title		string	Namnsträngen för den här leveransprofilen.
ISO för ursprungsland	origin_country_iso		string	ISO-koden för det land som listan levereras från.
Minsta bearbetningstid	min_processing_time		integer	Den minsta tid som krävs för att bearbeta för att skicka listor med den här leveransprofilen.
Maximal bearbetningstid	max_processing_time		integer	Den maximala bearbetningstid som listan behöver skicka.
Bearbetningstidsenhet	processing_time_unit		string	Den enhet som används för att representera hur lång tid en bearbetningstid är. En vecka motsvarar 5 arbetsdagar. Om ingen anges är enheten inställd på business_days.
Ursprungspostnummer	origin_postal_code		string	Postnummersträngen (inte nödvändigtvis ett nummer) för den plats från vilken listan levereras.

Returer

Representerar en profil som används för att ange en listas leveransinformation. Observera att det inte går att skapa beräknade leveransmallar via API:et. Du kan dock associera beräknade leveransprofiler som skapats från Shop Manager med listor med hjälp av API:et.

ShopShippingProfile

ShopShippingProfile

Uppdatera en lista

Åtgärds-ID:

ListingUpdate

Uppdaterar en lista, identifierad med ett list-ID, för en specifik butik som identifieras av ett butiks-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Kvantitet	quantity		integer	Det positiva antalet produkter som inte är noll som är tillgängliga för köp i listan.
Titel	title		string	Listans rubriksträng. Giltiga rubriksträngar innehåller bara bokstäver, siffror, skiljetecken, matematiska symboler, blankstegstecken, ™ , © och ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Du kan bara använda tecknen %, :, & och + en gång var.
Description	description		string	En beskrivningssträng för produkten som ska säljas i listan.
Pris	price		float	Det positiva priset på produkten som inte är noll. (Sålda produktlistor är privata) Obs! Priset är det lägsta möjliga priset.
Vem gjorde	who_made		string	En sträng inidcated vem som gjorde produkten. Hjälper köpare att hitta listan under den handgjorda rubriken. Kräver "is_supply" och "when_made".
När den är gjord	when_made		string	En sträng för den tid då tillverkaren gjorde produkten i den här listan. Hjälper köpare att hitta listan under rubriken Vintage. Kräver "is_supply" och "who_made".
Taxonomi-ID	taxonomy_id		integer	Det numeriska taxonomi-ID:t för listan. Säljaren hanterar listning taxonomi-ID:n för sin butik.
Leveransprofil-ID	shipping_profile_id		integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Materials	materials		string	En matris med materialsträngar för material som används i produkten. Giltiga materialsträngar innehåller endast bokstäver, siffror och blankstegstecken. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Butiksavsnitts-ID	shop_section_id		integer	Det numeriska ID:t för butiksavsnittet för den här listan.
Minsta bearbetning	processing_min		integer	Det minsta antal dagar som krävs för att bearbeta den här listan.
Maximal bearbetning	processing_max		integer	Det maximala antalet dagar som krävs för att bearbeta den här listan.
Etiketter	tags		string	En matris med taggsträngar för listan. Giltiga taggsträngar innehåller bara bokstäver, siffror, blankstegstecken, -, ', ™ , © och ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)
Recipient	recipient		string	En sträng som anger en person för vilken den här produkten skulle göra en lämplig gåva.
Tillfälle	occasion		string	En sträng som anger ett tillfälle då den här produkten skulle göra en lämplig gåva.
Stilar	styles		string	En matris med formatsträngar för den här listan, som var och en är textsträng i fri form, till exempel Formal eller Steampunk. En lista kan ha upp till två formatmallar. Giltiga formatsträngar innehåller bara bokstäver, siffror och blankstegstecken. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Artikelvikt	item_weight		float	Den numeriska vikten för produkten som mäts i enheter som anges i artikelns viktenhet.
Artikellängd	item_length		integer	Den numeriska längden på produkten som mäts i enheter som anges i enheten för objektdimensioner.
Objektbredd	item_width		float	Den numeriska bredden på produkten som mäts i enheter som anges i "artikeldimensionsenhet".
Objekthöjd	item_height		float	Den numeriska höjden på produkten som mäts i enheter som anges i "artikeldimensionsenhet".
Artikelns viktenhet	item_weight_unit		string	En sträng som definierar de enheter som används för att mäta produktens vikt.
Objektdimensionsenhet	item_dimensions_unit		string	En sträng som definierar de enheter som används för att mäta produktens dimensioner.
Är personligt ansenlig	is_personalizable		boolean	När det är sant är den här listan personlig.
Bild-ID:t	image_ids		string	En matris med numeriska bild-ID:n för bilderna i en lista, som kan innehålla upp till 10 bilder.
Är leverans	is_supply		boolean	När det är sant taggar du listan som en leveransprodukt, annars anger att det är en färdig produkt. Hjälper köpare att hitta listan under rubriken Leveranser. Kräver "who made" och "when made".
Är anpassningsbar	is_customizable		boolean	När det är sant kan en köpare kontakta säljaren för en anpassad beställning. Standardvärdet är sant när en butik accepterar anpassade beställningar. Gäller inte för butiker som inte accepterar anpassade beställningar.
Är skattepliktig	is_taxable		boolean	När det är sant gäller tillämpliga butiksskattesatser för denna lista i kassan.
Aktuell rangordning	featured_ rank		integer	Den positiva icke-noll numeriska positionen i de aktuella listorna i butiken med rankning 1 listor som visas i den vänstra positionen i aktuell lista på en butiks startsida.
Bör förnyas automatiskt	should_auto_renew		boolean	När det är sant förnyas en lista i fyra månader vid expriation. Om värdet är sant när det tidigare är falskt förnyar etsy.com listan innan den upphör att gälla, men förnyelseperioden börjar immidiately i stället för att förlänga listans förfallodatum. All oanvänd tid som återstår på listan går förlorad. Förnyelser resulterar i avgifter för en användares faktura.
Typ	type		string	Anger om listan är fysisk eller en digital nedladdning.
Kanaler	channels		string	En matris med uppräknade kanal-ID-strängar. En kanal är en plats för säljare att nå köpare för att göra försäljning.

Returer

En lista från en butik som innehåller en produktkvantitet, rubrik, beskrivning, pris osv.

ShopListing

ShopListing

Uppdatera en listas inventering

Åtgärds-ID:

ListingUpdateInventory

Uppdaterar inventeringen för en lista som identifieras av ett list-ID. Uppdateringen misslyckas om de angivna värdena för produkt-SKU, erbjudandekvantitet och/eller pris inte är kompatibla med värden i i egenskapsfält. När du anger ett pris tilldelar du en flyttal som är lika med beloppet dividerat med divisor enligt vad som anges i pengaresursen.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
List-ID	listing_id	True	string	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Produkter	products	True	string	En JSON-matris med produkter som är tillgängliga i en lista, även om det bara är en produkt. Alla fältnamn i JSON-blobarna är gemener.
Pris på egendom	price_on_property		string	En matris med unika egenskaps-ID-heltal för egenskaper som ändrar eventuella produktpriser. Om du till exempel debiterar specifika priser för produkter av olika storlek i samma lista innehåller den här matrisen egenskaps-ID:t för storlek.
Kvantitet på egenskap	quantity_on_property		string	En matris med unika egenskaps-ID-heltal för de egenskaper som ändrar kvantiteten för produkterna, om det finns några. Om du till exempel lagrar specifika mängder av olika färgade produkter i samma lista innehåller den här matrisen egenskaps-ID:t för färg.
SKU på egenskap	sku_on_property		string	En matris med unika egenskaps-ID-heltal för de egenskaper som ändrar produktens SKU, om det finns några. Om du till exempel använder specifika sku:er för olika färgade produkter i samma lista innehåller den här matrisen egenskaps-ID för färg.

Returer

En representation av en enskild listas inventeringspost.

ListingInventory

ListingInventory

Uppdatera en listas variantbilder

Åtgärds-ID:

ListingUpdateVariation

Skapar variantbilder i en lista.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Variantbilder	variation_images	True	string	En matris med variantbilddata.

Returer

Representerar flera olika variantbilder.

ListingVariationImages

ListingVariationImages

Uppdatera en listegenskap

Åtgärds-ID:

ListingUpdateProperty

Uppdaterar eller fyller i egenskapslistan som definierar produkterbjudanden för en lista. Varje erbjudande kräver både ett värde och ett värde-ID som är giltigt för ett skalnings-ID som tilldelats listan eller som du tilldelar till listan med den här begäran.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Egenskaps-ID	property_id	True	integer	Det unika ID:t för en Etsy-listegenskap.
Värde-ID:t	value_ids	True	integer	Det numeriska ID:t för en enda Etsy.com måttskala.
Värden	values	True	string	En matris med värdesträngar för flera Etsy-egenskapsvärden.
Skalnings-ID	scale_id		integer	Det numeriska ID:t för en enda Etsy.com måttskala.

Returer

En representation av strukturerade datavärden.

ListingPropertyValue

ListingPropertyValue

Uppdatera en listöversättning

Åtgärds-ID:

ListingUpdateTranslation

Uppdaterar en listöversättning genom att visa ID och språk.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
List-ID	listing_id	True	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Language	language	True	string	IETF-språktaggen för språket i den här översättningen. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru.
Titel	title	True	string	Rubriken på listan över den här översättningen.
Description	description	True	string	Beskrivningen av listan över den här översättningen.
Etiketter	tags		string	Taggarna i listan över den här översättningen.

Returer

Representerar översättningsdata för en lista.

ListingTranslation

ListingTranslation

Uppdatera en uppgradering av leveransprofilen

Åtgärds-ID:

ShippingUpdateProfileUpgrade

Uppdaterar en uppgradering av leveransprofilen och uppdaterar alla listor som använder leveransprofilen.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Uppgraderings-ID	upgrade_id	True	integer	Det numeriska ID som är associerat med en leveransuppgradering
Typ	type		string	Typ av leveransuppgradering. Inrikes (0) eller internationellt (1).
Uppgraderingsnamn	upgrade_name		string	Namn på leveransuppgradering som visas för kunder i kassan, t.ex. USPS Priority.
Pris	price		float	Extra kostnad för att lägga till leveransuppgradering.
Sekundärt pris	secondary_price		float	Ytterligare kostnad för att lägga till leveransuppgradering för varje ytterligare objekt.
Transportföretags-ID	shipping_carrier_id		integer	Det unika ID:t för ett transportföretag som stöds, som används för att beräkna ett beräknat leveransdatum.
E-postklass	mail_class		string	Den unika ID-strängen för ett transportföretags e-postklass, som används för att beräkna ett beräknat leveransdatum.
Minsta leveransdagar	min_delivery_days		integer	min_delivery_days
Maximalt antal leveransdagar	max_delivery_days		integer	Det maximala antalet arbetsdagar som en köpare kan förvänta sig att vänta med att få sin köpta artikel när den har levererats.

Returer

En representation av uppgraderingsalternativet för en leveransprofil.

ShopShippingProfileUpgrade

ShopShippingProfileUpgrade

Uppdatera ett leveransprofilmål

Åtgärds-ID:

ShippingUpdateProfileDestination

Uppdaterar ett befintligt leveransmål som kan ange eller tilldela om fraktkostnaden, transportföretaget och klassen för ett mål.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Butiks-ID	shop_id	True	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Leveransprofil-ID	shipping_profile_id	True	string	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Mål-ID för leveransprofil	shipping_profile_destination_id	True	string	Det numeriska ID:t för leveransprofilens målassocierat med listan.
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

Returer

Representerar ett leveransmål som tilldelats en leveransprofil.

ShopShippingProfileDestination

ShopShippingProfileDestination

Definitioner

ShopListing

En lista från en butik som innehåller en produktkvantitet, rubrik, beskrivning, pris osv.

Name	Sökväg	Typ	Description
List-ID	listing_id	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Användar-ID	user_id	integer	Det numeriska ID:t för användaren som publicerar listan.
Butiks-ID	shop_id	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Titel	title	string	Listans rubriksträng. Giltiga rubriksträngar innehåller bara bokstäver, siffror, skiljetecken, matematiska symboler, blankstegstecken, ™ , © och ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Du kan bara använda tecknen %, :, & och + en gång var.
Description	description	string	En beskrivningssträng för produkten som ska säljas i listan.
Stat/län	state	State	En uppräknad sträng från någon av: aktiv eller inaktiv. Obs! Om du anger ett utkast till aktivt publiceras även listan på etsy.com.
Tidsstämpel för skapande	creation_timestamp	integer	Listans skapandetid, i epok sekunder.
Sluttidsstämpel	ending_timestamp	integer	Listans förfallotid, i epok sekunder.
Tidsstämpel för ursprunglig skapande	original_creation_timestamp	integer	Listans skapandetid, i epok sekunder.
Senast ändrad tidsstämpel	last_modified_timestamp	integer	Tiden för den senaste uppdateringen av listan, i epok sekunder.
Tidsstämpel för senaste tillståndsändring	state_timestamp	integer	Datum och tid för den senaste tillståndsändringen av den här listan.
Kvantitet	quantity	integer	Det positiva antalet produkter som inte är noll som är tillgängliga för köp i listan. Obs! Listkvantiteten är summan av tillgängliga erbjudandekvantiteter. Du kan begära kvantiteterna för enskilda erbjudanden från ListingInventory-resursen med hjälp av lagerslutpunkten hämta lista.
Butiksavsnitts-ID	shop_section_id	integer	Det numeriska ID:t för ett avsnitt i en specifik Etsy-butik.
Aktuell rangordning	featured_rank	integer	Den positiva icke-noll numeriska positionen i de aktuella listorna i butiken, med rankning 1 listor som visas i den vänstra positionen i aktuell lista på en butiks startsida.
URL	url	string	Den fullständiga URL:en till listans sida på Etsy.
Antal favoriseringar	num_favorers	integer	Antalet användare som markerade den här listan som en favorit.
Ej beskattningsbar	non_taxable	boolean	När det är sant gäller tillämpliga butiksskattesatser inte för denna lista i kassan.
Är anpassningsbar	is_customizable	boolean	När det är sant kan en köpare kontakta säljaren för en anpassad beställning. Standardvärdet är sant när en butik accepterar anpassade beställningar. Gäller inte för butiker som inte accepterar anpassade beställningar.
Är peronalizable	is_personalizable	boolean	När det är sant är den här listan personlig. Standardvärdet är null.
Anpassning krävs	personalization_is_required	boolean	När det är sant kräver den här listan anpassning. Standardvärdet är null.
Maximalt antal personanpassningstecken	personalization_char_count_max	integer	Detta är ett heltalsvärde som representerar den maximala längden för anpassningsmeddelandet som angetts av köparen.
Anpassningsinstruktioner	personalization_instructions	string	När det är sant kräver den här listan anpassning. Standardvärdet är null.
Listtyp	listing_type	boolean	En uppräknad typsträng som anger om listan är fysisk eller en digital nedladdning.
Etiketter	tags	array of string	En lista över taggsträngar för listan. Giltiga taggsträngar innehåller bara bokstäver, siffror, blankstegstecken, -, ', ™ , © och ® . (regex: /[^\p{L}\p{Nd}\p{Zs}\-'™©®]/u) Standardvärdet är null.
Materials	materials	array of string	En lista över materialsträngar för material som används i produkten. Giltiga materialsträngar innehåller endast bokstäver, siffror och blankstegstecken. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Standardvärdet är null.
Leveransprofil-ID	shipping_profile_id	integer	Det numeriska ID:t för den leveransprofil som är associerad med listan.
Minsta bearbetningsdagar	processing_min	integer	Det minsta antal dagar som krävs för att bearbeta den här listan. Standardvärdet är null.
Maximalt antal bearbetningsdagar	processing_max	integer	Det maximala antalet dagar som krävs för att bearbeta den här listan. Standardvärdet är null.
WhoMade	who_made	WhoMade	En uppräkningssträng inidcated vem som gjorde produkten. Hjälper köpare att hitta listan under den handgjorda rubriken. Kräver "is_supply" och "when_made".
WhenMade	when_made	WhenMade	En uppräkningssträng för den tid då tillverkaren gjorde produkten i den här listan. Hjälper köpare att hitta listan under rubriken Vintage. Kräver "is_supply" och "who_made".
Leveransprodukt	is_supply	boolean	När det är sant taggar du listan som en leveransprodukt, annars anger att det är en färdig produkt. Hjälper köpare att hitta listan under rubriken Leveranser. Kräver "who_made" och "when_made".
Artikelvikt	item_weight	double	Den numeriska vikten för produkten som mäts i enheter som anges i artikelns viktenhet. Standardvärdet är null. Om värdet anges måste det vara större än 0.
ItemWeightUnit	item_weight_unit	ItemWeightUnit	En sträng som definierar de enheter som används för att mäta produktens vikt. Standardvärdet är null.
Artikellängd	item_length	double	Den numeriska längden på produkten som mäts i enheter som anges i enheten för objektdimensioner. Standardvärdet är null. Om värdet anges måste det vara större än 0.
Objektbredd	item_width	double	Den numeriska bredden på produkten som mäts i enheter som anges i objektdimensionsenheten. Standardvärdet är null. Om värdet anges måste det vara större än 0.
Objekthöjd	item_height	double	Den numeriska längden på produkten som mäts i enheter som anges i enheten för objektdimensioner. Standardvärdet är null. Om värdet anges måste det vara större än 0.
ItemDimensionsUnit	item_dimensions_unit	ItemDimensionsUnit	En sträng som definierar de enheter som används för att mäta produktens dimensioner. Standardvärdet är null.
Är privat	is_private	boolean	När det är sant är detta en privat notering som är avsedd för en specifik köpare och dold från butiksvyn.
Recipient	recipient	Recipient	En uppräkningssträng som anger en person för vilken produkten skulle göra en lämplig gåva. Standardvärdet är null.
Tillfälle	occasion	Occasion	En uppräkningssträng som anger ett tillfälle då den här produkten skulle göra en lämplig gåva. Standardvärdet är null.
Stil	style	array of string	En matris med formatsträngar för den här listan, som var och en är textsträng i fri form, till exempel Formal eller Steampunk. En lista kan ha upp till två formatmallar. Giltiga formatsträngar innehåller bara bokstäver, siffror och blankstegstecken. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Standardvärdet är null.
Fildata	file_data	string	En sträng som beskriver de filer som är kopplade till en digital lista.
Har variationer	has_variations	boolean	När det är sant har listan variationer.
Bör förnyas automatiskt	should_auto_renew	boolean	När det är sant förnyas en lista i fyra månader vid expriation. Om värdet är sant när det tidigare är falskt förnyar etsy.com listan innan den upphör att gälla, men förnyelseperioden börjar immidiately i stället för att förlänga listans förfallodatum. All oanvänd tid som återstår på listan går förlorad. Förnyelser resulterar i avgifter för en användares faktura.
Language	language	string	IETF-språktaggen för standardspråket i listan. Ex: de, en, es, fr, it, ja, nl, , pl, pt, ru.
Pengar	price	Money	En representation av en summa pengar.
Taxonomi-ID	taxonomy_id	integer	Det numeriska taxonomi-ID:t för listan. Säljaren hanterar listning taxonomi-ID:n för sin butik. Mer information finns i säljartaxonomi.

Pengar

En representation av en summa pengar.

Name	Sökväg	Typ	Description
Mängd	amount	integer	Mängden som representeras av dessa data.
Divisor	divisor	integer	Divisor-programmet för att återge beloppet.
Valutakod	currency_code	string	ISO-valutakoden för dessa data.

ShopListingFile

En fil som är associerad med en digital lista.

Name	Sökväg	Typ	Description
Visa fil-ID	listing_file_id	integer	Det unika numeriska ID:t för en fil som är associerad med en digital lista.
List-ID	listing_id	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Rangordning	rank	integer	Det numeriska indexet för visningsordningspositionen för den här filen i listan, med början 1.
Filnamn	filename	string	Filnamnssträngen för en fil som är associerad med en digital lista.
Filstorlek	filesize	string	En formatstorlekssträng som kan läsas av människor för storleken på en fil.
Storlek i byte	size_bytes	integer	Ett tal som anger storleken på en fil, mätt i byte.
Filtyp	filetype	string	En typsträng som anger en fils MIME-typ.
Skapa tidsstämpel	create_timestamp	integer	Den unika numeriska tidsstämpeln för en fil som är associerad med en digital lista.

ShopListingFiles

Representerar flera ShopListingFiles.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet ShopListingFiles som returneras..
Results	results	array of ShopListingFile	En matris med ShopListingFile-resurser.

ShopListings

En uppsättning butikslistningsresurser.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet butikslistningsresurser som hittades.
Results	results	array of ShopListing	Butiken visar resurser som hittats.

User

Representerar en enskild användare av webbplatsen

Name	Sökväg	Typ	Description
Användar-ID	user_id	integer	Det numeriska ID:t för en användare. Det här numret är också ett giltigt butiks-ID för användarens butik.
Inloggningsnamn	login_name	string	Användarens inloggningsnamnsträng.
Primär e-post	primary_email	string	En e-postadresssträng för användarens primära e-postadress.
Förnamn	first_name	string	Användarens förnamn.
Efternamn	last_name	string	Användarens efternamn.
Skapad tidsstämpel	create_timestamp	integer	Datum och tid då användaren skapade sitt konto i epok sekunder.
Hänvisas av användar-ID	referred_by_user_id	integer	Det numeriska ID:t för den användare som hänvisade till den här användaren.
Använda nya lagerslutpunkter	use_new_inventory_endpoints	boolean	Deprecated. Alltid sant.
Är säljare	is_seller	boolean	Sant om användaren är säljare.
Biografi	bio	string	Användarens biografi.
Kön	gender	string	Användarens kön.
Födelsemånad	birth_month	string	Användarens födelsemånad.
Födelsedag	birth_day	string	Användarens födelsedag.
Köp transaktionsantal	transaction_buy_count	integer	Antalet transaktioner där användaren har köpt.
Antal sålda transaktioner	transaction_sold_count	integer	Antalet transaktioner där användaren har sålt.

Butik

En butik som skapats av en Etsy-användare.

Name	Sökväg	Typ	Description
Butiks-ID	shop_id	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Användar-ID	user_id	integer	Det numeriska användar-ID:t för den användare som äger den här butiken.
Butiksnamn	shop_name	string	Butikens namnsträng.
Skapelsedatum	create_date	integer	Datum och tid då butiken skapades, i epok sekunder.
Titel	title	string	En kort rubriksträng för butikens huvudsida.
Meddelande	announcement	string	En meddelandesträng till köpare som visas på butikens hemsida.
Valutakod	currency_code	string	ISO-koden (alfabetisk) för butikens valuta. Butiken visar alla priser i den här valutan som standard.
Är på semester	is_vacation	boolean	När det är sant accepterar denna butik inte inköp.
Semestermeddelande	vacation_message	string	Butikens meddelandesträng visas när is_vacation är sant.
Försäljningsmeddelande	sale_message	string	En meddelandesträng som skickas till användare som slutför ett köp från den här butiken.
Digitalt försäljningsmeddelande	digital_sale_message	string	En meddelandesträng som skickas till användare som köper ett digitalt objekt från den här butiken.
Uppdaterat datum	update_date	integer	Datum och tid för den senaste uppdateringen till butiken, i epok sekunder.
Antal aktiva listor	listing_active_count	integer	Antalet aktiva listor i butiken.
Antal digitala listor	digital_listing_count	integer	Antalet digitala listor i butiken.
Inloggningsnamn	login_name	string	Butiksägarens inloggningsnamnsträng.
Accepterar anpassade begäranden	accepts_custom_requests	boolean	När det är sant accepterar butiken anpassningsbegäranden.
Välkomstprincip	policy_welcome	string	Butikens princip välkommen sträng (kan vara tom).
Betalningsprincip	policy_payment	string	Butikens betalningsprincipsträng (kan vara tom).
Leveransprincip	policy_shipping	string	Butikens leveransprincipsträng (kan vara tom).
Återbetalningsprincip	policy_refunds	string	Butikens principsträng för återbetalning (kan vara tom).
Ytterligare principer	policy_additional	string	Butikens ytterligare principsträng (kan vara tom).
Säljarinformation	policy_seller_info	string	Butikens säljinformationssträng (kan vara tom).
Datum då principen uppdaterades	policy_update_date	integer	Datum och tid för den senaste uppdateringen av butikens principer, i epok sekunder.
Har en privat kvittoprincip	policy_has_private_receipt_info	boolean	När det är sant visar EU-kvitton privat information.
Har ostrukturerade principer	has_unstructured_policies	boolean	När det är sant visar butiken ytterligare ostrukturerade principfält.
Integritetspolicy	policy_privacy	string	Butikens sekretesspolicysträng (kan vara tom).
Vacation Autoreply	vacation_autoreply	string	Butikens automatiska svarssträng visas i nya konversationer när is_vacation är sant.
URL	url	string	URL-strängen för den här butiken.
URL för banderollsbild	image_url_760x100	string	URL-strängen för butikens banderollsbild.
Antal favoriseringar	num_favorers	integer	Antalet användare som markerade den här butiken som en favorit.
Languages	languages	array of string	En lista över språksträngar för butikens registrerade språk.
URL för ikonbild	icon_url_fullxfull	string	URL-strängen för butikens ikonbild.
Använder strukturerade principer	is_using_structured_policies	boolean	När det är sant accepterade butiken att använda strukturerade principer.
Har inbyggda strukturerade principer	has_onboarded_structured_policies	boolean	När det är sant accepterade butiken ELLER avböjde efter att ha sett strukturerade policy onboarding.
Inkludera länk för tvistformulär	include_dispute_form_link	boolean	När det är sant innehåller butikens policyer en länk till ett EU-formulär för onlinetvister.
Är direktutcheckning registrerad	is_direct_checkout_onboarded	boolean	När det är sant har butiken registrerat sig på Etsy Payments.
Är berättigad till beräknad frakt	is_calculated_eligible	boolean	När det är sant är butiken elegible för beräknade fraktprofiler. (Endast tillgängligt i USA och Kanada)
Är anmäld till köparens löfte	is_opted_in_to_buyer_promise	boolean	När det är sant valde butiken att köpa löfte.
Är USA-baserad	is_shop_us_based	boolean	När det är sant är butiken baserad i USA.
Antal försäljningstransaktioner	transaction_sold_count	integer	Det totala antalet försäljningstransaktioner för den här butiken
Leverans från land ISO	shipping_from_country_iso	string	Landet iso butiken är leverans från.
Butikens plats ISO	shop_location_country_iso	string	Landet iso där butiken finns.
Antal granskningar	review_count	integer	Antal recensioner av butikslistor under det senaste året.
Granska medelvärde	review_average	double	Genomsnittligt omdöme baserat på recensioner av butikslistor under det senaste året.

ListingImage

Referens-URL:er och metadata för en bild som är associerad med en specifik lista. Parametern url_fullxfull innehåller URL:en för en binär bildfil i full storlek.

Name	Sökväg	Typ	Description
List-ID	listing_id	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Lista bild-ID	listing_image_id	integer	Det numeriska ID:t för den primära listbilden för den här transaktionen.
Hexkod	hex_code	string	Webhex-strängen för bildens genomsnittliga färg, i webhex-notation.
Rött värde	red	integer	Det numeriska röda värdet är lika med bildens genomsnittliga röda värde, från 0–255 (RGB-färg).
Grönt värde	green	integer	Det numeriska röda värdet är lika med bildens genomsnittliga röda värde, från 0–255 (RGB-färg).
Blått värde	blue	integer	Det numeriska röda värdet är lika med bildens genomsnittliga röda värde, från 0–255 (RGB-färg).
Hue-värde	hue	integer	Den numeriska nyansen är lika med bildens genomsnittliga nyans, från 0–360 (HSV-färg).
Mättnadsvärde	saturation	integer	Den numeriska mättnad som motsvarar bildens genomsnittliga mättnad, från 0–100 (HSV-färg).
Ljushetsvärde	brightness	integer	Den numeriska ljusstyrkan är lika med bildens genomsnittliga ljusstyrka, från 0–100 (HSV-färg).
Är svartvitt	is_black_and_white	boolean	När det är sant är bilden i svartvitt.
Skapandetid	creation_tsz	integer	Listbildens skapandetid, i epok sekunder.
Rangordning	rank	integer	Den positiva icke-noll numeriska positionen i bilderna som visas i en lista, med rankning 1 bilder som visas i den vänstra positionen i en lista.
Bild-URL för 75 x 75	url_75x75	string	URL-strängen för en miniatyrbild på 75 x 75 bildpunkter av bilden.
Bild-URL för 170x135	url_170x135	string	URL-strängen för en miniatyrbild på 170 x 135 bildpunkter av bilden.
Url för 570xN-bild	url_570xN	string	Url-strängen för en miniatyrbild av bilden, högst 570 bildpunkter bred med variabel höjd.
Bild-URL i full storlek	url_fullxfull	string	URL-strängen för bilden i full storlek, upp till 3 000 bildpunkter i varje dimension.
Bildhöjd i full storlek	full_height	integer	Den numeriska höjden, mätt i bildpunkter, för den fullstora bild som refereras i url_fullxfull.
Bildbredd i full storlek	full_width	integer	Den numeriska bredden, mätt i bildpunkter, för den fullstora bild som refereras i url_fullxfull.

ListingImages

Representerar en lista över bildresurser som var och en innehåller referens-URL:er och metadata för en bild.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet resultat.
Results	results	array of ListingImage	Listan över begärda resurser.

ListingInventoryWithAssociations

En representation av en enskild listas inventeringspost med associationer

Name	Sökväg	Typ	Description
Produkter	products	array of ListingInventoryProduct	En JSON-matris med produkter som är tillgängliga i en lista, även om det bara är en produkt. Alla fältnamn i JSON-blobarna är gemener.
Pris på egenskaper	price_on_property	array of integer	En matris med unika egenskaps-ID-heltal för egenskaper som ändrar eventuella produktpriser. Om du till exempel debiterar specifika priser för produkter av olika storlek i samma lista innehåller den här matrisen egenskaps-ID:t för storlek.
Kvantitet på egenskaper	quantity_on_property	array of integer	En matris med unika egenskaps-ID-heltal för de egenskaper som ändrar kvantiteten för produkterna, om det finns några. Om du till exempel lagrar specifika mängder av olika färgade produkter i samma lista innehåller den här matrisen egenskaps-ID:t för färg.
SKU på egenskaper	sku_on_property	array of integer	En matris med unika egenskaps-ID-heltal för de egenskaper som ändrar produktens SKU, om det finns några. Om du till exempel använder specifika sku:er för olika färgade produkter i samma lista innehåller den här matrisen egenskaps-ID för färg.
ShopListing	listing	ShopListing	En lista från en butik som innehåller en produktkvantitet, rubrik, beskrivning, pris osv.

ListingInventoryProduct

En representation av en produkt för en lista.

Name	Sökväg	Typ	Description
Produkt-ID	product_id	integer	Det numeriska ID:t för en specifik produkt som köpts från en lista.
artikelnummer (SKU)	sku	string	SKU-strängen för produkten
Tas bort	is_deleted	boolean	När det är sant har någon tagit bort den här produkten.
Offerings	offerings	array of ListingInventoryProductOffering	En lista över produkterbjudandeposter för den här produkten.
Egenskapsvärden	property_values	array of ListingPropertyValue	En lista över egenskapsvärdeposter för den här produkten.

ListingInventoryProductOffering

En representation av ett erbjudande för en lista.

Name	Sökväg	Typ	Description
Erbjudande-ID	offering_id	integer	ID:t för produkterbjudandet
Kvantitet	quantity	integer	Kvantiteten i produkterbjudandet
Är aktiverad	is_enabled	boolean	Om erbjudandet kan visas för köpare eller inte.
Tas bort	is_deleted	boolean	Om erbjudandet har tagits bort eller inte.
Pengar	price	Money	En representation av en summa pengar.

ListingPropertyValue

En representation av strukturerade datavärden.

Name	Sökväg	Typ	Description
Egenskaps-ID	property_id	integer	Det numeriska ID:t för egenskapen.
Namn	property_name	string	Namnet på egenskapen.
Skalnings-ID	scale_id	integer	Skalans numeriska ID (om det finns något).
Skalningsnamn	scale_name	string	Etiketten som används för att beskriva den valda skalan (om någon).
Värde-ID:t	value_ids	array of integer	De numeriska ID:n för egenskapsvärdena
Värden	values	array of string	Egenskapsvärdena

ListingInventory

En representation av en enskild listas inventeringspost.

Name	Sökväg	Typ	Description
Produkter	products	array of ListingInventoryProduct	En JSON-matris med produkter som är tillgängliga i en lista, även om det bara är en produkt. Alla fältnamn i JSON-blobarna är gemener.
Pris på egenskaper	price_on_property	array of integer	En matris med unika egenskaps-ID-heltal för egenskaper som ändrar eventuella produktpriser. Om du till exempel debiterar specifika priser för produkter av olika storlek i samma lista innehåller den här matrisen egenskaps-ID:t för storlek.
Kvantitet på egenskaper	quantity_on_property	array of integer	En matris med unika egenskaps-ID-heltal för de egenskaper som ändrar kvantiteten för produkterna, om det finns några. Om du till exempel lagrar specifika mängder av olika färgade produkter i samma lista innehåller den här matrisen egenskaps-ID:t för färg.
SKU på egenskaper	sku_on_property	array of integer	En matris med unika egenskaps-ID-heltal för de egenskaper som ändrar produktens SKU, om det finns några. Om du till exempel använder specifika sku:er för olika färgade produkter i samma lista innehåller den här matrisen egenskaps-ID för färg.

ShopListingsWithAssociations

En uppsättning butikslistningsresurser med associationer.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet butikslistningsresurser som hittades.
Results	results	array of ShopListing	Butiken visar resurser som hittats.

ListingPropertyValues

Representerar flera egenskapsvärden i listan.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet butikslistningsresurser som hittades.
Results	results	array of ListingPropertyValue	Butiken visar resurser som hittats.

ShopReceiptTransactions

En uppsättning transaktionsresurser för butikskvitton

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet transaktionsresurser för butikskvitto som hittades.
Results	results	array of ShopReceiptTransaction	Transaktionsresurserna för butikskvittot hittades.

ShopReceiptTransaction

Ett transaktionsobjekt som är associerat med ett butikskvitto. Etsy genererar en transaktion per lista som köpts enligt orderkvittot.

Name	Sökväg	Typ	Description
Transaktions-ID	transaction_id	integer	Det unika numeriska ID:t för en transaktion.
Titel	title	string	Rubriksträngen i listan som köpts i den här transaktionen.
Description	description	string	Beskrivningssträngen för listan som köpts i den här transaktionen.
Säljaranvändar-ID	seller_user_id	integer	Det numeriska användar-ID:t för säljaren i den här transaktionen.
Köparens användar-ID	buyer_user_id	integer	Det numeriska användar-ID:t för köparen i den här transaktionen.
Skapad tidsstämpel	create_timestamp	integer	Transaktionens skapandedatum och tid, i epok sekunder.
Betald tidsstämpel	paid_timestamp	integer	Transaktionens betalda datum och tid, i epoksekunder.
Levererad tidsstämpel	shipped_timestamp	integer	Transaktionens leveransdatum och tid, i epok sekunder.
Kvantitet	quantity	integer	Den numeriska kvantiteten produkter som köpts i den här transaktionen.
Lista bild-ID	listing_image_id	integer	Det numeriska ID:t för den primära listbilden för den här transaktionen.
Kvitto-ID	receipt_id	integer	Det numeriska ID:t för kvittot som är kopplat till den här transaktionen.
Är digital	is_digital	boolean	När det är sant registrerade transaktionen köpet av en digital lista.
Fildata	file_data	string	En sträng som beskriver de filer som köpts i den här transaktionen.
List-ID	listing_id	integer	Det numeriska ID:t för listan som är associerad med den här transaktionen.
Transaktionstyp	transaction_type	string	Typsträngen för transaktionen, vanligtvis listad
Produkt-ID	product_id	integer	Det numeriska ID:t för en specifik produkt som köpts från en lista.
Pengar	price	Money	En representation av en summa pengar.
Pengar	shipping_cost	Money	En representation av en summa pengar.

ListingTranslation

Representerar översättningsdata för en lista.

Name	Sökväg	Typ	Description
List-ID	listing_id	integer	Det numeriska ID:t för listan.
Language	language	string	IETF-språktaggen (t.ex. "fr") för språket i den här översättningen.
Titel	title	string	Rubriken på listan över den här översättningen.
Description	description	string	Beskrivningen av listan över den här översättningen.
Etiketter	tags	array of string	Taggarna i listan över den här översättningen.

ListingVariationImages

Representerar flera olika variantbilder.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet variantbilder.
Results	results	array of ListingVariationImage	Resultatet av variantbilderna.

ListingVariationImage

En representation av associationerna för variationer och bilder på en lista.

Name	Sökväg	Typ	Description
Egenskaps-ID	property_id	integer	Det numeriska ID:t för egenskapen.
Värde-ID	value_id	integer	Det numeriska ID:t för värdet.
Bild-ID	image_id	integer	Bildens numeriska ID.

PaymentAccountLedgerEntries

En uppsättning transaktionsresurser för betalningskontot

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet transaktionsresurser för betalningskontot som hittades.
Results	results	array of PaymentAccountLedgerEntry	Transaktionsresurserna för betalningskontot hittades.

PaymentAccountLedgerEntry

Representerar en post i en butiks transaktionsregister.

Name	Sökväg	Typ	Description
Post-ID	entry_id	integer	Transaktionsregistrets numeriska ID.
Transaktionsregister-ID	ledger_id	integer	Transaktionsregistrets numeriska ID.
Sekvensnummer	sequence_number	integer	Sekvensen gör att transaktionsregisterposter kan sorteras kronologiskt. Ju högre sekvens, desto nyare post.
Mängd	amount	integer	Mängden pengar som krediteras till transaktionsregistret.
Valuta	currency	string	Valutan för posten i transaktionsregistret.
Description	description	string	Information om vilken typ av transaktionsregister detta är: en betalning, återbetalning, återföring av en misslyckad återbetalning, utbetalning, returnerad utbetalning, recoupment, diverse krediter, diverse debet eller fakturabetalning.
Saldo	balance	integer	Mängden pengar i butikens transaktionsregister ögonblicket efter att den här posten tillämpades.
Skapelsedatum	create_date	integer	Datum och tid då transaktionsregistret skapades i epoksekunder..

Payments

Representerar flera betalningar som görs med Etsy-betalningar. Alla penningbelopp är i USD-pennies om inget annat anges.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet betalningar i svaret.
Results	results	array of Payment	En lista över betalningar.

Betalning

Representerar en betalning som görs med Etsy-betalningar. Alla penningbelopp är i USD-pennies om inget annat anges.

Name	Sökväg	Typ	Description
BetalningsID	payment_id	integer	Ett unikt numeriskt ID för en betalning till en specifik Etsy-butik.
Köparens användar-ID	buyer_user_id	integer	Det numeriska ID:t för den användare som betalade köpet.
Butiks-ID	shop_id	integer	Det unika positiva numeriska ID:t som inte är noll för en Etsy Shop.
Kvitto-ID	receipt_id	integer	Det numeriska ID:t för kvittot som är kopplat till den här transaktionen.
Pengar	amount_gross	Money	En representation av en summa pengar.
Pengar	amount_fees	Money	En representation av en summa pengar.
Pengar	amount_net	Money	En representation av en summa pengar.
Pengar	posted_gross	Money	En representation av en summa pengar.
Pengar	posted_fees	Money	En representation av en summa pengar.
Pengar	posted_net	Money	En representation av en summa pengar.
Pengar	adjusted_gross	Money	En representation av en summa pengar.
Pengar	adjusted_fees	Money	En representation av en summa pengar.
Pengar	adjusted_net	Money	En representation av en summa pengar.
Valuta	currency	string	ISO-kodsträngen (alfabetisk) för betalningens valuta.
Handla valuta	shop_currency	string	ISO-koden (alfabetisk) för butikens valuta. Butiken visar alla priser i den här valutan som standard.
Köparens valuta	buyer_currency	string	Köparens valutasträng.
Användarleverans-ID	shipping_user_id	integer	Det numeriska ID:t för den användare som säljaren skickar ordern till.
Leveransadress-ID	shipping_address_id	integer	Det numeriska ID:t som identifierar leveransadressen.
Faktureringsadress-ID	billing_address_id	integer	Det numeriska ID:t som identifierar köparens faktureringsadress.
Läge	status	string	En sträng som anger den aktuella statusen för betalningen, som oftast regleras eller autentiseras.
Levererad tidsstämpel	shipped_timestamp	integer	Transaktionens leveransdatum och tid, i epok sekunder.
Skapad tidsstämpel	create_timestamp	integer	Transaktionens skapandedatum och tid, i epok sekunder.
Uppdatera tidsstämpel	update_timestamp	integer	Datum och tid för den senaste ändringen av betalningsjusteringen i epok sekunder.
Betalningsjusteringar	payment_adjustments	array of PaymentAdjustment	Lista över återbetalningsobjekt för en Etsy Payments-transaktion. Alla penningbelopp är i USD-pennies om inget annat anges.

PaymentAdjustment

Representerar en återbetalning som gäller för en tidigare Etsy-betalning. Alla penningbelopp är i USD-pennies om inget annat anges.

Name	Sökväg	Typ	Description
Betalningsjusterings-ID	payment_adjustment_id	integer	Det numeriska ID:t för en betalningsjustering.
BetalningsID	payment_id	integer	Ett unikt numeriskt ID för en betalning till en specifik Etsy-butik.
Läge	status	string	Statussträngen för betalningsjusteringen.
Lyckades	is_success	boolean	När det är sant var eller kommer betalningsjusteringen sannolikt att slutföras.
Användar-ID	user_id	integer	Det numeriska ID:t för användaren (säljaren) som uppfyller köpet.
Orsakskod	reason_code	string	En läsbar sträng som beskriver orsaken till återbetalningen.
Totalt justeringsbelopp	total_adjustment_amount	integer	Det totala numeriska beloppet för återbetalningen i betalningsvalutan.
Totalt justeringsbelopp för butik	shop_total_adjustment_amount	integer	Det numeriska beloppet för återbetalningen i butikens valuta.
Totalt justeringsbelopp	buyer_total_adjustment_amount	integer	Det numeriska beloppet för återbetalningen i köparens valuta.
Totalt avgiftsjusteringsbelopp	total_fee_adjustment_amount	integer	Det numeriska beloppet för kortbearbetningsavgifter som är associerade med en betalningsjustering.
Skapad tidsstämpel	create_timestamp	integer	Transaktionens skapandedatum och tid, i epok sekunder.
Uppdatera tidsstämpel	update_timestamp	integer	Datum och tid för den senaste ändringen av betalningsjusteringen i epok sekunder.

Pong

En bekräftelse på att det aktuella programmet har åtkomst till Open API

Name	Sökväg	Typ	Description
Ansöknings-ID	application_id	integer	Det autentiserade programmets ID

ShopReceipt

Posten för ett köp från en butik. Butikskvitton visar monetära värden med hjälp av butikens valuta.

Name	Sökväg	Typ	Description
Kvitto-ID	receipt_id	integer	Det numeriska ID:t för kvittot som är kopplat till den här transaktionen.
Kvittotyp	receipt_type	integer	Det numeriska värdet för Etsy-kanalen som betjänade köpet: 0 för Etsy.com, 1 för en mönsterbutik.
Säljaranvändar-ID	seller_user_id	integer	Det numeriska ID:t för användaren (säljaren) som uppfyller köpet.
Säljarens e-postadress	seller_email	string	E-postadresssträngen för säljaren av listan.
Köparens användar-ID	buyer_user_id	integer	Det numeriska ID:t för användaren som gör köpet.
Köparens e-postadress	buyer_email	string	E-postadresssträngen för köparen av listan.
Namn	name	string	Namnsträngen för mottagaren i leveransadressen.
Första adressraden	first_line	string	Den första adressradssträngen för mottagaren i leveransadressen.
Andra adressraden	second_line	string	Den valfria andra adressradssträngen för mottagaren i leveransadressen.
City	city	string	Stadssträngen för mottagaren i leveransadressen.
Stat/län	state	string	Tillståndssträngen för mottagaren i leveransadressen.
Postnummer	zip	string	Postnummersträngen (inte nödvändigtvis ett nummer) för mottagaren i leveransadressen.
Formaterad adress	formatted_address	string	Den formaterade leveransadresssträngen för mottagaren i leveransadressen.
Landskod ISO	country_iso	string	Landskodsträngen ISO-3166 alpha-2 för mottagaren i leveransadressen.
Betalningsmetod	payment_method	string	Betalningsmetodsträngen som identifierar köparens betalningsmetod, som måste vara ett av följande: "cc" (kreditkort), "PayPal", "check", "mo" (pengabeställning), "bt" (banköverföring), "other", "ideal", "sofort", "apple_pay", "google", "android_pay", "google_pay", "klarna", "k_pay_in_4" (klarna) eller "k_financing" (klarna).
E-postadress för betalning	payment_email	string	E-postadresssträngen för den e-postadress som betalningsbekräftelsen ska skickas till
Meddelande från säljaren	message_from_seller	string	En valfri meddelandesträng från säljaren.
Meddelande från köparen	message_from_buyer	string	En valfri meddelandesträng från köparen.
Meddelande från betalningssystemet	message_from_payment	string	Den maskingenererade bekräftelsesträngen från betalningssystemet.
Betalas	is_paid	boolean	När det är sant betalade köparen för detta köp.
Levereras	is_shipped	boolean	När det är sant levererade säljaren produkterna.
Skapad tidsstämpel	create_timestamp	integer	Kvittots skapandetid, i epok sekunder.
Uppdatera tidsstämpel	update_timestamp	integer	Tiden för den senaste uppdateringen av kvittot, i epok sekunder.
Presentmeddelande	gift_message	string	En presentmeddelandesträng som köparen begär levereras med produkten.
Pengar	grandtotal	Money	En representation av en summa pengar.
Pengar	subtotal	Money	En representation av en summa pengar.
Pengar	total_price	Money	En representation av en summa pengar.
Pengar	total_shipping_cost	Money	En representation av en summa pengar.
Pengar	total_tax_cost	Money	En representation av en summa pengar.
Pengar	total_vat_cost	Money	En representation av en summa pengar.
Pengar	discount_amt	Money	En representation av en summa pengar.
Pengar	gift_wrap_price	Money	En representation av en summa pengar.
Transporter	shipments	array of ShopReceiptShipment	En lista över leveransinstruktioner för det här kvittot.

ShopReceiptShipment

Posten för en leveranshändelse för en ShopReceipt. Ett kvitto kan ha många ShopReceiptShipment-poster.

Name	Sökväg	Typ	Description
Leverans-ID för kvitto	receipt_shipping_id	integer	Det unika numeriska ID:t för en butikskvittoleveranspost.
Tidsstämpel för leveransmeddelande	shipment_notification_timestamp	integer	Den tid då Etsy underrättade köparen om leveranshändelsen, i epok sekunder.
Namn på operatör	carrier_name	string	Namnsträngen för transportföretaget/företaget som ansvarar för leveransen.
Spårningskod	tracking_code	string	Spårningskodsträngen som tillhandahålls av transportföretaget för leveransen.

ShopReceipts

Kvitton för en specifik butik.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet hittade butikskvitton.
Results	results	array of ShopReceipt	Lista över butikskvittoresurser som hittats, med alla fält för butikskvitto för varje resurs.

TransactionReviews

En uppsättning transaktionsgranskningsposter som lämnas av användare.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet TransactionReview-resurser som hittades.
Results	results	array of TransactionReview	TransactionReview-resurserna hittades.

TransactionReview

En transaktionsgranskningspost som lämnas av en användare.

Name	Sökväg	Typ	Description
Butiks-ID	shop_id	integer	Butikens numeriska ID.
List-ID	listing_id	integer	ID:t för butiken som transactionReview tillhör.
Köparens användar-ID	buyer_user_id	integer	Det numeriska ID:t för den användare som var köpare i den här transaktionen. Obs! Det här fältet kan vara frånvarande, beroende på köparens sekretessinställningar.
Rating	rating	integer	Omdömesvärde på skala från 1 till 5
Granska meddelande	review	string	Ett meddelande som författaren lämnat och som förklarar feedbacken.
Language	language	string	Språket i TransactionReview
Fullsize Image URL	image_url_fullxfull	string	Url:en till ett foto som tillhandahålls med feedback, dimensioner fullxfull. Obs! Det här fältet kan vara frånvarande, beroende på köparens sekretessinställningar.
Skapad tidsstämpel	create_timestamp	integer	Datum och tid då TransactionReview skapades i epok sekunder.
Uppdatera tidsstämpel	update_timestamp	integer	Datum och tid då TransactionReview uppdaterades i epok sekunder.

SellerTaxonomyNodes

En lista över taxonominoder från säljarens taxonomiträd.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet resultat.
Results	results	array of SellerTaxonomyNode	Listan över begärda resurser.

SellerTaxonomyNode

En taxonominod i säljarens taxonomiträd.

Name	Sökväg	Typ	Description
ID-nummer	id	integer	Det unika numeriska ID:t för en Etsy-taxonominod, som är en metadatakategori för listor ordnade i hierarkiträdet för säljarens taxonomi. Till exempel är skor taxonominoden (ID: 1429, nivå: 1) högre i hierarkin än flickors skor (ID: 1440, nivå: 2). Taxonominoderna som tilldelats en lista stöder åtkomst till specifika standardiserade produktskalor och egenskaper. Till exempel har listor som tilldelats taxonominodernas skor eller flickskor stöd för tillgång till EU:s skostorleksskala med tillhörande egenskapsnamn och ID:er för EU-skostorlekar, till exempel egenskapen value_id:1394 och name:38.
Nivå	level	integer	Heltalsdjupet för den här taxonominoden i säljarens taxonomiträd, med rötter på nivå 0.
Namn	name	string	Namnsträngen för den här taxonominoden.
Överordnat ID	parent_id	integer	Det numeriska taxonomi-ID:t för den överordnade noden.
Underordnade	children	array of SellerTaxonomyNode	En matris med taxonominoder för alla direkta underordnade till den här taxonominoden i säljarens taxanomyträd.
Taxonomisökvägs-ID:t	full_path_taxonomy_ids	array of integer	En matris med taxonomi-ID:t, inklusive den här noden och alla dess direkta föräldrar i säljarens taxonomiträd upp till en rotnod. De visas i ordning från rot till löv.

TaxonomyNodeProperties

En lista över produktegenskapsdefinitioner.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet resultat.
Results	results	array of TaxonomyNodeProperty	Listan över begärda resurser.

TaxonomyNodeProperty

En produktegenskapsdefinition.

Name	Sökväg	Typ	Description
Egenskaps-ID	property_id	integer	Det unika numeriska ID:t för den här produktegenskapen.
Namn	name	string	Namnsträngen för den här taxonominoden.
Visningsnamn	display_name	string	Namnsträngen för produktegenskap som kan läsas av människor.
Våg	scales	array of TaxonomyPropertyScale	En lista över tillgängliga skalor.
Krävs	is_required	boolean	När det är sant kräver listor tilldelade berättigade taxonomi-ID:t den här egenskapen.
Stöder attribut	supports_attributes	boolean	När det är sant kan du använda den här egenskapen i listattribut.
Stöder variationer	supports_variations	boolean	När det är sant kan du använda den här egenskapen för att visa variationer.
Är flervärdes	is_multivalued	boolean	När det är sant kan du tilldela flera egenskapsvärden till den här egenskapen
Möjliga värden	possible_values	array of TaxonomyPropertyValue	En lista över egenskapsvärdesträngar som stöds för den här egenskapen.
Markerade värden	selected_values	array of TaxonomyPropertyValue	En lista över egenskapsvärdesträngar automatiskt och alltid valt för den angivna egenskapen.

TaxonomyPropertyScale

En skalning som defnierar de tilldelningsbara ökningarna för de egenskapsvärden som är tillgängliga för specifika produktegenskaper.

Name	Sökväg	Typ	Description
Skalnings-ID	scale_id	integer	Det unika numeriska ID:t för en skala.
Visningsnamn	display_name	string	Namnsträngen för en skala.
Description	description	string	Beskrivningssträngen för en skala.

TaxonomyPropertyValue

Ett egenskapsvärde för en specifik produktegenskap, som också kan använda en specifik skala.

Name	Sökväg	Typ	Description
Värde-ID	value_id	integer	Det numeriska ID:t för det här egenskapsvärdet.
Namn	name	string	Namnsträngen för det här egenskapsvärdet.
Skalnings-ID	scale_id	integer	Det numeriska skalnings-ID:t för skalan som det här egenskapsvärdet tillhör.
Lika med	equal_to	array of integer	En lista över numeriska egenskapsvärde-ID:n som det här egenskapsvärdet är lika med (om det finns några).

ShippingCarriers

Representerar flera ShippingCarriers.

Name	Sökväg	Typ	Description
count	count	integer
results	results	array of ShippingCarrier

ShippingCarrier

Ett transportföretag som stöds, som används för att beräkna ett beräknat leveransdatum.

Name	Sökväg	Typ	Description
Transportföretags-ID	shipping_carrier_id	integer	Det numeriska ID:t för det här transportföretaget.
Namn	name	string	Namnet på det här transportföretaget.
Inrikesklasser	domestic_classes	array of ShippingCarrierMailClass	Uppsättning inrikes postklasser för det här transportföretaget.
Internationella klasser	international_classes	array of ShippingCarrierMailClass	Uppsättning internationella e-postklasser för detta transportföretag.

ShippingCarrierMailClass

Ett fraktföretags e-postklass, som används för att beräkna ett beräknat leveransdatum.

Name	Sökväg	Typ	Description
E-postklass-ID	mail_class_key	string	Den unika identifieraren för den här e-postklassen.
Namn	name	string	Namnet på den här e-postklassen.

Butiker

En uppsättning shop-poster.

Name	Sökväg	Typ	Description
Räkna	count	integer	Det totala antalet butiker
Results	results	array of Shop	Shop-resurserna.

ShopSection

Ett avsnitt i en butik där en användare kan sortera listor.

Name	Sökväg	Typ	Description
Butiksavsnitts-ID	shop_section_id	integer	Det numeriska ID:t för ett avsnitt i en specifik Etsy-butik.
Titel	title	string	Rubriksträngen för ett butiksavsnitt.
Rangordning	rank	integer	Den positiva icke-noll numeriska positionen för det här avsnittet i avsnittet visar ordningen för en butik, med rangordning 1 avsnitt som visas först.
Användar-ID	user_id	integer	Det numeriska ID:t för den användare som äger det här butiksavsnittet.
Antal aktiva listor	active_listing_count	integer	Antalet aktiva listor i ett avsnitt i en specifik Etsy-butik.

ShopSections

Alla avsnitt i en sprecific Shop.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet resultat.
Results	results	array of ShopSection	Listan över begärda resurser.

ShopShippingProfile

Representerar en profil som används för att ange en listas leveransinformation. Observera att det inte går att skapa beräknade leveransmallar via API:et. Du kan dock associera beräknade leveransprofiler som skapats från Shop Manager med listor med hjälp av API:et.

Name	Sökväg	Typ	Description
Leveransprofil-ID	shipping_profile_id	integer	Det numeriska ID:t för leveransprofilen.
Titel	title	string	Namnsträngen för den här leveransprofilen.
Användar-ID	user_id	integer	Det numeriska ID:t för den användare som äger leveransprofilen.
Minsta bearbetningsdagar	min_processing_days	integer	Det minsta antalet dagar för bearbetning av listan.
Maximalt antal bearbetningsdagar	max_processing_days	integer	Det maximala antalet dagar för bearbetning av listan.
Etikett för bearbetningsdagar	processing_days_display_label	string	Översatt visningsetikettsträng för bearbetningsdagar.
ISO för ursprungsland	origin_country_iso	string	ISO-koden för det land som listan levereras från.
Tas bort	is_deleted	boolean	När det är sant har någon tagit bort den här leveransprofilen.
Mål för leveransprofil	shipping_profile_destinations	array of ShopShippingProfileDestination	En lista över mål för leveransprofilen som är tillgängliga för den här leveransprofilen.
Uppgraderingar av leveransprofil	shipping_profile_upgrades	array of ShopShippingProfileUpgrade	En lista över uppgraderingar av leveransprofilen som är tillgängliga för den här leveransprofilen.
Ursprungspostnummer	origin_postal_code	string	Postnummersträngen (inte nödvändigtvis ett nummer) för den plats från vilken listan levereras.
Profiltyp	profile_type	ProfileType

ShopShippingProfileDestination

Representerar ett leveransmål som tilldelats en leveransprofil.

Name	Sökväg	Typ	Description
Mål-ID för leveransprofil	shipping_profile_destination_id	integer	Det numeriska ID:t för leveransprofilmålet i leveransprofilen som är associerad med listan.
Leveransprofil-ID	shipping_profile_id	integer	Det numeriska ID:t för leveransprofilen.
ISO för ursprungsland	origin_country_iso	string	ISO-koden för det land som listan levereras från.
ISO för målland	destination_country_iso	string	ISO-koden för det land som listan levereras till. Om värdet är null anger begäran målet till destination_region
DestinationRegion	destination_region	DestinationRegion	Koden för den region som listan levereras till. En region representerar en uppsättning länder. Regioner som stöds är Eu-unionen och icke-Europeiska unionen (länder i Europa som inte är i EU). Om inget görs anger begäran målet till destination_country_iso, eller överallt om destination_country_iso också är null
Pengar	primary_cost	Money	En representation av en summa pengar.
Pengar	secondary_cost	Money	En representation av en summa pengar.
Transportföretags-ID	shipping_carrier_id	integer	Det unika ID:t för ett transportföretag som stöds, som används för att beräkna ett beräknat leveransdatum.
E-postklass	mail_class	string	Den unika ID-strängen för ett transportföretags e-postklass, som används för att beräkna ett beräknat leveransdatum.
Minsta leveransdagar	min_delivery_days	integer	Det minsta antalet arbetsdagar som en köpare kan förvänta sig att vänta med att få sin köpta artikel när den har levererats.
Maximalt antal leveransdagar	max_delivery_days	integer	Det maximala antalet arbetsdagar som en köpare kan förvänta sig att vänta med att få sin köpta artikel när den har levererats.

ShopShippingProfileUpgrade

En representation av uppgraderingsalternativet för en leveransprofil.

Name	Sökväg	Typ	Description
Leveransprofil-ID	shipping_profile_id	integer	Det numeriska ID:t för basleveransprofilen.
Uppgraderings-ID	upgrade_id	integer	Det numeriska ID som är associerat med en leveransuppgradering
Uppgraderingsnamn	upgrade_name	string	Namn på leveransuppgradering som visas för kunder i kassan, t.ex. USPS Priority.
Typ	type	Type	Typ av leveransuppgradering. Inrikes (0) eller internationellt (1).
Rangordning	rank	integer	Den positiva icke-noll numeriska positionen i bilderna som visas i en lista, med rankning 1 bilder som visas i den vänstra positionen i en lista.
Language	language	string	IETF-språktaggen för fraktprofilens språk. Ex: de, en, es, fr, it, ja, nl, pl, pt, ru.
Pengar	price	Money	En representation av en summa pengar.
Pengar	secondary_price	Money	En representation av en summa pengar.
Transportföretags-ID	shipping_carrier_id	integer	Det unika ID:t för ett transportföretag som stöds, som används för att beräkna ett beräknat leveransdatum.
E-postklass	mail_class	string	Den unika ID-strängen för ett transportföretags e-postklass, som används för att beräkna ett beräknat leveransdatum.
Minsta leveransdagar	min_delivery_days	integer	Det minsta antalet arbetsdagar som en köpare kan förvänta sig att vänta med att få sin köpta artikel när den har levererats.
Maximalt antal leveransdagar	max_delivery_days	integer	Det maximala antalet arbetsdagar som en köpare kan förvänta sig att vänta med att få sin köpta artikel när den har levererats.

ShopShippingProfileDestinations

Representerar en lista över leveransmålobjekt.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet resultat.
Results	results	array of ShopShippingProfileDestination	Listan över begärda resurser.

ShopShippingProfileUpgrades

En lista över alternativ för leveransuppgradering.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet resultat.
Results	results	array of ShopShippingProfileUpgrade	Listan över begärda resurser.

UserAddress

Representerar en användares adress.

Name	Sökväg	Typ	Description
Användaradress-ID	user_address_id	integer	Det numeriska ID:t för användarens adress.
Användar-ID	user_id	integer	Användarens numeriska ID.
Namn	name	string	Användarens namn på den här adressen.
Första adressraden	first_line	string	Den första raden i användarens adress.
Andra adressraden	second_line	string	Den andra raden i användarens adress.
City	city	string	Ortfältet för användarens adress.
Stat/län	state	string	Tillståndsfältet för användarens adress.
Postnummer	zip	string	Postnummerfältet för användarens adress.
Landskod ISO	iso_country_code	string	ISO-koden för landet i den här adressen.
Country	country_name	string	Namnet på användarens land.
Är standardleveransadress	is_default_shipping_address	boolean	Är detta användarens standardleveransadress.

UserAddresses

Representerar flera UserAddress-poster.

Name	Sökväg	Typ	Description
Räkna	count	integer	Antalet UserAddress-poster som returneras.
Results	results	array of UserAddress	En matris med UserAddress-resurser.

DestinationRegion

Koden för den region som listan levereras till. En region representerar en uppsättning länder. Regioner som stöds är Eu-unionen och icke-Europeiska unionen (länder i Europa som inte är i EU). Om inget görs anger begäran målet till destination_country_iso, eller överallt om destination_country_iso också är null

Koden för den region som listan levereras till. En region representerar en uppsättning länder. Regioner som stöds är Eu-unionen och icke-Europeiska unionen (länder i Europa som inte är i EU). Om inget görs anger begäran målet till destination_country_iso, eller överallt om destination_country_iso också är null

DestinationRegion

string

ItemDimensionsUnit

En sträng som definierar de enheter som används för att mäta produktens dimensioner. Standardvärdet är null.

En sträng som definierar de enheter som används för att mäta produktens dimensioner. Standardvärdet är null.

ItemDimensionsUnit

string

ItemWeightUnit

En sträng som definierar de enheter som används för att mäta produktens vikt. Standardvärdet är null.

En sträng som definierar de enheter som används för att mäta produktens vikt. Standardvärdet är null.

ItemWeightUnit

string

Tillfälle

En uppräkningssträng som anger ett tillfälle då den här produkten skulle göra en lämplig gåva. Standardvärdet är null.

En uppräkningssträng som anger ett tillfälle då den här produkten skulle göra en lämplig gåva. Standardvärdet är null.

Tillfälle

string

Profiltyp

Profiltyp

string

Recipient

En uppräkningssträng som anger en person för vilken produkten skulle göra en lämplig gåva. Standardvärdet är null.

En uppräkningssträng som anger en person för vilken produkten skulle göra en lämplig gåva. Standardvärdet är null.

Recipient

string

Stat/län

En uppräknad sträng från någon av: aktiv eller inaktiv. Obs! Om du anger ett utkast till aktivt publiceras även listan på etsy.com.

En uppräknad sträng från någon av: aktiv eller inaktiv. Obs! Om du anger ett utkast till aktivt publiceras även listan på etsy.com.

Stat/län

integer

Typ

Typ av leveransuppgradering. Inrikes (0) eller internationellt (1).

Typ av leveransuppgradering. Inrikes (0) eller internationellt (1).

Typ

integer

WhenMade

En uppräkningssträng för den tid då tillverkaren gjorde produkten i den här listan. Hjälper köpare att hitta listan under rubriken Vintage. Kräver "is_supply" och "who_made".

En uppräkningssträng för den tid då tillverkaren gjorde produkten i den här listan. Hjälper köpare att hitta listan under rubriken Vintage. Kräver "is_supply" och "who_made".

WhenMade

string

WhoMade

En uppräkningssträng inidcated vem som gjorde produkten. Hjälper köpare att hitta listan under den handgjorda rubriken. Kräver "is_supply" och "when_made".

En uppräkningssträng inidcated vem som gjorde produkten. Hjälper köpare att hitta listan under den handgjorda rubriken. Kräver "is_supply" och "when_made".

WhoMade

string