Udostępnij przez


eBay (niezależny wydawca) (wersja zapoznawcza)

eBay to amerykańska międzynarodowa firma zajmująca się handlem elektronicznym, która ułatwia sprzedaż między konsumentami i firmami za pośrednictwem swojej strony internetowej.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Artesian Software Technologies LLP
adres URL https://artesian.io
Email amit.sharma@artesian.io
Metadane łącznika
Publisher Artesian Software Technologies LLP
Witryna internetowa https://www.ebay.com/
Zasady zachowania poufności informacji https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260
Kategorie Handel; Sprzedaż i CRM

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: Wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Identyfikator klienta — Identyfikator klienta serwisu eBay ciąg Wprowadź identyfikator klienta. Prawda
Tajemnica klienta securestring Wprowadź klucz tajny klienta. Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Aktualizuj ofertę

To wywołanie aktualizuje istniejącą ofertę, która może być opublikowana lub nieopublikowana.

OFERTA GET

To wywołanie pobiera określoną opublikowaną lub cofniętą ofertę.

Oferty GET

To wywołanie pobiera wszystkie istniejące oferty dla określonej wartości jednostki SKU. Sprzedawca ma możliwość ograniczenia ofert pobranych na określoną platformę handlową w serwisie eBay lub w formacie aukcji.

Pobieranie aspektów elementu dla kategorii

To wywołanie zwraca listę aspektów, które są odpowiednie lub niezbędne do dokładnego opisywania elementów w określonej kategorii liścia. Każdy aspekt identyfikuje atrybut elementu (na przykład kolor), dla którego sprzedawca będzie wymagany lub zachęcany do podania wartości (lub wartości odmiany) podczas oferowania elementu w tej kategorii w serwisie eBay.

Pobieranie domyślnego identyfikatora drzewa kategorii

Dana platforma handlowa w serwisie eBay może używać wielu drzew kategorii, ale jeden z tych drzew jest uważany za domyślny dla tej platformy handlowej. To wywołanie pobiera odwołanie do domyślnego drzewa kategorii skojarzonego z określonym identyfikatorem witryny marketplace serwisu eBay.

Pobieranie elementów spisu

To wywołanie pobiera wszystkie rekordy elementów zapasów zdefiniowane dla konta sprzedawcy.

Pobieranie lokalizacji spisu

To wywołanie pobiera wszystkie zdefiniowane szczegóły lokalizacji spisu określonej przez parametr ścieżki merchantLocationKey.

Pobieranie lokalizacji spisu

To wywołanie pobiera wszystkie zdefiniowane szczegóły dla każdej lokalizacji zapasów skojarzonej z kontem sprzedawcy.

Pobieranie zasad realizacji

Ta metoda pobiera pełne szczegóły zasad realizacji. Podaj identyfikator zasad, które chcesz pobrać przy użyciu parametru path fulfillmentPolicyId.

POBIERZ element spisu

To wywołanie pobiera rekord elementu spisu dla danej jednostki SKU.

Publikowanie oferty

To połączenie służy do konwertowania nieopublikowanej oferty na opublikowaną ofertę lub oferty na żywo w serwisie eBay. Unikatowy identyfikator oferty (offerId) jest przekazywany na końcu identyfikatora URI wywołania.

Tworzenie lokalizacji spisu

Użyj tego wywołania, aby utworzyć nową lokalizację spisu. Aby można było utworzyć i opublikować ofertę, sprzedawca musi mieć co najmniej jedną lokalizację zapasów, ponieważ każda oferta musi być skojarzona z lokalizacją.

Tworzenie lub zastępowanie elementu spisu

To wywołanie tworzy nowy rekord elementu spisu lub zastępuje istniejący rekord elementu spisu.

Tworzenie oferty

To wywołanie tworzy ofertę dla określonego elementu zapasów na określonej platformie handlowej serwisu eBay.

Usuń ofertę

To wywołanie spowoduje trwałe usunięcie oferty

Uzyskiwanie sugestii dotyczących kategorii

To wywołanie zwraca tablicę węzłów liści drzewa kategorii w określonym drzewie kategorii, które są brane pod uwagę przez serwis eBay, aby najlepiej odpowiadać zapytaniu.

Uzyskiwanie zasad powrotu

Ta metoda pobiera pełne szczegóły zasad zwracanych określonych przez parametr ścieżki returnPolicyId.

Uzyskiwanie zasad płatności

Ta metoda pobiera wszystkie zasady płatności skonfigurowane dla platformy handlowej określonej przy użyciu parametru zapytania marketplace_id.

Uzyskiwanie zasad płatności

Ta metoda pobiera pełne szczegóły zasad płatności. Podaj identyfikator zasad, które chcesz pobrać przy użyciu parametru ścieżki paymentPolicyId.

Uzyskiwanie zasad realizacji

Ta metoda pobiera wszystkie zasady realizacji skonfigurowane dla platformy handlowej określonej przy użyciu parametru zapytania marketplace_id.

Uzyskiwanie zasad warunku elementu

Ta metoda zwraca metadane warunku elementu w jednej, wielu lub wszystkich kategoriach serwisu eBay na platformie handlowej w serwisie eBay.

Uzyskiwanie zasad zwrotu

Ta metoda pobiera wszystkie zasady zwracane skonfigurowane dla platformy handlowej określonej przy użyciu parametru zapytania marketplace_id.

Wycofuj ofertę

To wywołanie służy do kończenia pojedynczej listy odmian skojarzonej z określoną ofertą.

Aktualizuj ofertę

To wywołanie aktualizuje istniejącą ofertę, która może być opublikowana lub nieopublikowana.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator oferty
offerId True string

Unikatowy identyfikator oferty, którą chcesz zaktualizować.

Dostępna ilość
availableQuantity integer

Dostępna ilość zapasów do zakupu.

Identyfikator kategorii
categoryId string

Unikatowy identyfikator kategorii serwisu eBay, w ramach którego będzie wyświetlany produkt.

Identyfikator organizacji charytatywnej
charityId string

Przypisany przez serwis eBay unikatowy identyfikator organizacji charytatywnej, która otrzyma procent wpływów ze sprzedaży.

Procent darowizny
donationPercentage string

Procent ceny zakupu, który organizacja charytatywna otrzyma za każdą sprzedaż, która generuje aukcję.

Identyfikator produktu producenta
producerProductId string

Unikatowy identyfikator producenta powiązanego z elementem.

Identyfikator pakietu produktu
productPackageId string

Unikatowy identyfikator producenta opakowania produktu dodanego przez sprzedawcę.

Identyfikator pakietu wysyłki
shipmentPackageId string

Unikatowy identyfikator producenta dowolnego opakowania używanego przez sprzedawcę do wysyłki.

Identyfikator dokumentacji produktu
productDocumentationId string

Unikatowy identyfikator producenta dowolnego papieru dodanego do paczki przedmiotu przez sprzedawcę.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Ukryj szczegóły nabywcy
hideBuyerDetails boolean

To pole jest uwzględniane, jeśli sprzedawca chce utworzyć prywatną ofertę.

Uwzględnij szczegóły produktu wykazu
includeCatalogProductDetails boolean

Wskazuje, czy szczegóły wykazu produktów eBay są stosowane do oferty.

Opis listy
listingDescription string

Opis oferty w serwisie eBay.

Czas trwania listy
listingDuration string

Liczba dni, w których lista będzie aktywna.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Włączono najlepszą ofertę
bestOfferEnabled boolean

Wskazuje, czy dla listy jest włączona funkcja Najlepsza oferta.

eBay Plus , jeśli kwalifikuje się
eBayPlusIfEligible boolean

To pole jest uwzględniane w ofercie, jeśli sprzedawca Top-Rated zostanie wyrażeniu zgody na program eBay Plus.

Identyfikator zasad realizacji
fulfillmentPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe realizacji, które będą używane po opublikowaniu oferty i przekonwertowaniu na ofertę w serwisie eBay.

Identyfikator zasad płatności
paymentPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe płatności, które będą używane po opublikowaniu oferty i przekonwertowaniu jej na ofertę w serwisie eBay.

Identyfikatory zasad zgodności produktów
productCompliancePolicyIds array of string

To pole zawiera tablicę zawierającą maksymalnie pięć identyfikatorów określających zasady zgodności utworzone przez sprzedawcę dla oferty.

Identyfikator zasad zwracanych
returnPolicyId string

Zwracanie unikatowych identyfikatorów zasad biznesowych, które będą używane po opublikowaniu oferty i przekonwertowaniu jej na listę w serwisie eBay.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Priority
priority integer

Dane wejściowe wartości całkowitej w tym polu wraz z wartością shippingServiceType określają, która opcja krajowej lub międzynarodowej usługi wysyłkowej w zasadach realizacji zostanie zmodyfikowana ze zaktualizowanymi kosztami wysyłki.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Rodzaj usługi
shippingServiceType string

Ta wartość wskazuje, czy usługa wysyłkowa określona w polu priorytetu jest opcją krajową, czy międzynarodową usługą wysyłkową.

Identyfikator zasad take back
takeBackPolicyId string

Identyfikator sprzedawcy, który utworzył zasady wycofywania.

Data rozpoczęcia wyświetlania listy
listingStartDate string

To pole może być używane, jeśli sprzedawca chce określić czas w przyszłości, że aukcja stanie się aktywna w serwisie eBay.

Rozmiar partii
lotSize integer

To pole ma zastosowanie tylko wtedy, gdy lista jest listą wielu. Wartość całkowita przekazana do tego pola to całkowita liczba elementów w partii.

Klucz lokalizacji sprzedawcy
merchantLocationKey string

Unikatowy identyfikator lokalizacji spisu sprzedawcy

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Pierwotnie sprzedany za cenę detaliczną w dniu
originallySoldForRetailPriceOn string

To pole jest potrzebne, jeśli funkcja Cennik przekreślenia będzie używana w ofercie. To pole wskazuje, że produkt został sprzedany za cenę w oryginalnym polu RetailPrice w witrynie serwisu eBay lub sprzedany za tę cenę przez sprzedawcy zewnętrznego

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Widoczność cen
pricingVisibility string

To pole jest wymagane, jeśli funkcja Minimalna anonsowana cena będzie używana w ofercie.

Limit ilości na nabywcę
quantityLimitPerBuyer integer

To pole ma zastosowanie i jest ustawiane tylko wtedy, gdy sprzedawca chce ustawić ograniczenie dotyczące ilości zakupu na sprzedawcę.

Identyfikator kategorii pomocniczej
secondaryCategoryId string

Unikatowy identyfikator kategorii pomocniczej i ma zastosowanie, jeśli sprzedawca zdecyduje się wyświetlić element w dwóch kategoriach.

Nazwy kategorii sklepu
storeCategoryNames array of string

Nazwy kategorii sklepu

Zastosuj podatek
applyTax boolean

Ten kontener ma zastosowanie i jest używany tylko wtedy, gdy do oferty zostanie zastosowana tabela podatku, Value-Added stawka podatku lub kod kategorii wyjątków podatkowych.

Kategoria podatku innej firmy
thirdPartyTaxCategory string

Kod kategorii wyjątków podatkowych. Jeśli to pole jest używane, podatek od sprzedaży będzie również stosowany do usługi/opłaty, a nie tylko ceny przedmiotu.

Procent podatku VAT
vatPercentage number

Ta wartość to stawka VAT dla przedmiotu, jeśli istnieje. Po określeniu wartości procentowej PODATKU VAT informacje o podatku VAT są wyświetlane na stronie Wyświetl element.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator oferty
offerId string

Unikatowy identyfikator oferty

Ostrzeżenia
warnings array of object

Ten kontener zostanie zwrócony, gdy zostanie wykonane wywołanie, a wystąpią błędy i/lub ostrzeżenia.

Kategoria
warnings.category string

Ta wartość ciągu wskazuje kategorię błędów

Domena
warnings.domain string

Nazwa domeny, w której wystąpił błąd lub ostrzeżenie.

Identyfikator błędu
warnings.errorId integer

Unikatowy kod identyfikujący określony błąd lub ostrzeżenie, które wystąpiło.

inputRefIds
warnings.inputRefIds array of string

Tablica z co najmniej jednym identyfikatorem odwołania, które identyfikują określone elementy żądania najbardziej powiązane z błędem lub ostrzeżeniem, jeśli istnieją.

Długa wiadomość
warnings.longMessage string

Szczegółowy opis warunku, który spowodował błąd lub ostrzeżenie, oraz informacje o tym, co należy zrobić, aby rozwiązać problem.

Message
warnings.message string

Opis warunku, który spowodował błąd lub ostrzeżenie.

outputRefIds
warnings.outputRefIds array of string

Tablica jednego lub większej liczby identyfikatorów odwołań, które identyfikują określone elementy odpowiedzi najbardziej powiązane z błędem lub ostrzeżeniem, jeśli istnieją.

parameters
warnings.parameters array of object

Różne komunikaty ostrzegawcze i komunikaty o błędach zwracają co najmniej jedną zmienną zawierającą kontekstowe informacje o błędzie lub ostrzeżeniu.

nazwa
warnings.parameters.name string

nazwa

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nazwa poddomeny, w której wystąpił błąd lub ostrzeżenie.

OFERTA GET

To wywołanie pobiera określoną opublikowaną lub cofniętą ofertę.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator oferty
offerId True string

Unikatowy identyfikator oferty, która ma zostać pobrana.

Zwraca

Nazwa Ścieżka Typ Opis
Dostępna ilość
availableQuantity integer

Ilość towaru zapasów, który będzie dostępny do zakupu przez kupujących.

Identyfikator kategorii
categoryId string

Unikatowy identyfikator podstawowej kategorii serwisu eBay, w ramach którego znajduje się element spisu.

Identyfikator organizacji charytatywnej
charity.charityId string

Przypisany przez serwis eBay Unikatowy identyfikator organizacji charytatywnej, która otrzyma procent wpływów ze sprzedaży.

Procent darowizny
charity.donationPercentage string

Procent ceny zakupu, który organizacja charytatywna otrzyma za każdą sprzedaż wygenerowaną przez aukcję.

Identyfikator produktu producenta
extendedProducerResponsibility.producerProductId string

Unikatowy identyfikator producenta powiązanego z elementem.

Identyfikator pakietu produktu
extendedProducerResponsibility.productPackageId string

Unikatowy identyfikator producenta dowolnego opakowania związanego z produktem dodanym przez sprzedawcę.

Identyfikator pakietu wysyłki
extendedProducerResponsibility.shipmentPackageId string

Unikatowy identyfikator producenta dowolnego opakowania używanego przez sprzedawcę do wysłania towaru.

Identyfikator dokumentacji produktu
extendedProducerResponsibility.productDocumentationId string

Unikatowy identyfikator producenta dowolnego papieru dodanego do paczki towaru przez sprzedawcę.

Waluta
extendedProducerResponsibility.ecoParticipationFee.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
extendedProducerResponsibility.ecoParticipationFee.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Format
format string

Format oferty

Ukryj szczegóły nabywcy
hideBuyerDetails boolean

To pole jest zwracane jako prawdziwe, jeśli dla oferty włączono funkcję oferty prywatnej.

Uwzględnij szczegóły produktu wykazu
includeCatalogProductDetails boolean

To pole wskazuje, czy szczegóły wykazu produktów eBay są stosowane do oferty.

Identyfikator listy
listing.listingId string

Unikatowy identyfikator oferty serwisu eBay skojarzony z opublikowaną ofertą.

Stan listy
listing.listingStatus string

Stan listy skojarzony z opublikowaną ofertą.

Sprzedana ilość
listing.soldQuantity integer

Ilość produktu, który został sprzedany dla opublikowanej oferty.

Opis listy
listingDescription string

Opis oferty w serwisie eBay

Czas trwania listy
listingDuration string

To pole wskazuje liczbę dni, w których lista będzie aktywna.

Waluta
listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
listingPolicies.bestOfferTerms.autoAcceptPrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
listingPolicies.bestOfferTerms.autoDeclinePrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Włączono najlepszą ofertę
listingPolicies.bestOfferTerms.bestOfferEnabled boolean

Ten kontener jest używany, jeśli sprzedawca chce obsługiwać funkcję Najlepsza oferta na swojej liście.

eBay Plus , jeśli kwalifikuje się
listingPolicies.eBayPlusIfEligible boolean

To pole jest uwzględniane w ofercie, jeśli sprzedawca Top-Rated zostanie wyrażeniu zgody na program eBay Plus.

Identyfikator zasad realizacji
listingPolicies.fulfillmentPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe realizacji, które będą używane po opublikowaniu oferty i przekonwertowaniu na ofertę w serwisie eBay.

Identyfikator zasad płatności
listingPolicies.paymentPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe płatności, które będą używane po opublikowaniu oferty i przekonwertowaniu jej na ofertę w serwisie eBay.

productCompliancePolicyIds
listingPolicies.productCompliancePolicyIds array of string

To pole zawiera tablicę zawierającą maksymalnie pięć identyfikatorów określających zasady zgodności utworzone przez sprzedawcę dla oferty.

Identyfikator zasad zwracanych
listingPolicies.returnPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe zwrotu, które będą używane po opublikowaniu oferty i przekonwertowaniu jej na ofertę w serwisie eBay.

shippingCostOverrides
listingPolicies.shippingCostOverrides array of object

Ten kontener jest używany, jeśli sprzedawca chce zastąpić koszty wysyłki dla co najmniej jednej opcji usługi wysyłki krajowej lub międzynarodowej zdefiniowanej w zasadach aukcji realizacji.

Waluta
listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
listingPolicies.shippingCostOverrides.additionalShippingCost.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Priority
listingPolicies.shippingCostOverrides.priority integer

Dane wejściowe wartości całkowitej w tym polu wraz z wartością shippingServiceType określają, która opcja krajowej lub międzynarodowej usługi wysyłkowej w zasadach realizacji zostanie zmodyfikowana ze zaktualizowanymi kosztami wysyłki.

Waluta
listingPolicies.shippingCostOverrides.shippingCost.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
listingPolicies.shippingCostOverrides.shippingCost.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Typ usługi wysyłkowej
listingPolicies.shippingCostOverrides.shippingServiceType string

Ta wartość wskazuje, czy usługa wysyłkowa jest krajową, czy międzynarodową opcją usługi wysyłkowej.

Identyfikator zasad take back
listingPolicies.takeBackPolicyId string

Utworzono zasady wycofywania identyfikatora sprzedawcy.

Data rozpoczęcia wyświetlania listy
listingStartDate string

Ten znacznik czasu to data/godzina ustawiona przez sprzedawcę dla zaplanowanej oferty.

Rozmiar partii
lotSize integer

To pole ma zastosowanie tylko wtedy, gdy lista jest listą wielu. Lista lotów to lista, która zawiera wiele ilości tego samego produktu.

Identyfikator witryny Marketplace
marketplaceId string

Unikatowy identyfikator witryny serwisu eBay, w której jest dostępna oferta lub zostanie udostępniona.

Klucz lokalizacji sprzedawcy
merchantLocationKey string

Unikatowy identyfikator lokalizacji spisu.

Identyfikator oferty
offerId string

Unikatowy identyfikator oferty.

Waluta
pricingSummary.auctionReservePrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
pricingSummary.auctionReservePrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
pricingSummary.auctionStartPrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
pricingSummary.auctionStartPrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
pricingSummary.minimumAdvertisedPrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
pricingSummary.minimumAdvertisedPrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Pierwotnie sprzedany za cenę detaliczną w dniu
pricingSummary.originallySoldForRetailPriceOn string

To pole jest potrzebne, jeśli funkcja Cennik przekreślenia będzie używana w ofercie. To pole wskazuje, że produkt został sprzedany za cenę w oryginalnym polu RetailPrice w witrynie serwisu eBay lub sprzedany za tę cenę przez sprzedawcy zewnętrznego.

Waluta
pricingSummary.originalRetailPrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
pricingSummary.originalRetailPrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
pricingSummary.price.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
pricingSummary.price.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Widoczność cen
pricingSummary.pricingVisibility string

To pole jest potrzebne, jeśli funkcja Minimalna anonsowana cena będzie używana w ofercie.

Limit ilości na nabywcę
quantityLimitPerBuyer integer

To pole ma zastosowanie tylko wtedy, gdy sprzedawca chce ustawić ograniczenie dotyczące ilości zakupu przedmiotu zapasów na sprzedawcę.

Identyfikator kategorii pomocniczej
secondaryCategoryId string

Unikatowy identyfikator dla kategorii pomocniczej i ma zastosowanie, jeśli sprzedawca zdecyduje się wyświetlić element w dwóch kategoriach.

SKU
sku string

Wartość jednostki SKU zdefiniowanej przez sprzedawcę produktu w ofercie.

Status
status string

Wartość określa stan oferty.

Nazwy kategorii sklepu
storeCategoryNames array of string

Nazwa kategorii sklepu

Zastosuj podatek
tax.applyTax boolean

To pole zostanie uwzględnione, jeśli sprzedawca chce odwołać się do podatku od sprzedaży na poziomie konta

Kategoria podatku innej firmy
tax.thirdPartyTaxCategory string

Kod kategorii wyjątków podatkowych. Jeśli to pole jest używane, podatek od sprzedaży będzie również stosowany do usługi/opłaty, a nie tylko ceny przedmiotu.

Procent podatku VAT
tax.vatPercentage number

Ta wartość to stawka VAT dla przedmiotu, jeśli istnieje. Po określeniu wartości procentowej PODATKU VAT informacje o podatku VAT są wyświetlane na stronie Wyświetl element.

Oferty GET

To wywołanie pobiera wszystkie istniejące oferty dla określonej wartości jednostki SKU. Sprzedawca ma możliwość ograniczenia ofert pobranych na określoną platformę handlową w serwisie eBay lub w formacie aukcji.

Parametry

Nazwa Klucz Wymagane Typ Opis
SKU
sku True string

Wartość jednostki SKU zdefiniowanej przez sprzedawcę

Identyfikator witryny Marketplace
marketplace_id string

Unikatowy identyfikator witryny handlowej serwisu eBay.

Format
format string

Format oferty.

Ograniczenie
limit string

Maksymalna liczba rekordów zwracanych na stronę danych.

Przesunięcie
offset string

Numer strony do pobrania.

Zwraca

Nazwa Ścieżka Typ Opis
Href
href string

Adres URL bieżącej strony ofert.

Ograniczenie
limit integer

Liczba ofert, które będą wyświetlane na każdej stronie wyników.

Next
next string

Adres URL na następnej stronie ofert.

offers
offers array of object

Ten kontener jest tablicą co najmniej jednej oferty sprzedawcy dla wartości jednostki SKU.

Dostępna ilość
offers.availableQuantity integer

Ilość pozycji spisu, która będzie dostępna do zakupu.

Identyfikator kategorii
offers.categoryId string

Unikatowy identyfikator kategorii serwisu eBay, w ramach którego znajduje się element spisu.

Identyfikator organizacji charytatywnej
offers.charity.charityId string

Unikatowy identyfikator organizacji charytatywnej przypisanej przez firmę eBay, która otrzyma procent wpływów ze sprzedaży.

Procent darowizny
offers.charity.donationPercentage string

Procent ceny zakupu, który organizacja charytatywna otrzyma za każdą sprzedaż.

Identyfikator produktu producenta
offers.extendedProducerResponsibility.producerProductId string

Unikatowy identyfikator producenta powiązanego z elementem.

Identyfikator pakietu produktu
offers.extendedProducerResponsibility.productPackageId string

Unikatowy identyfikator spakowanego produktu dodanego przez sprzedawcę.

Identyfikator pakietu wysyłki
offers.extendedProducerResponsibility.shipmentPackageId string

Unikatowy identyfikator producenta dowolnego opakowania używanego przez sprzedawcę do wysłania towaru.

Identyfikator dokumentacji produktu
offers.extendedProducerResponsibility.productDocumentationId string

Unikatowy identyfikator producenta dowolnego papieru dodanego do paczki towaru przez sprzedawcę.

Waluta
offers.extendedProducerResponsibility.ecoParticipationFee.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
offers.extendedProducerResponsibility.ecoParticipationFee.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Format
offers.format string

Ta wartość ustawia format listy dla oferty

Ukryj szczegóły nabywcy
offers.hideBuyerDetails boolean

To pole jest zwracane jako prawdziwe, jeśli dla oferty włączono funkcję oferty prywatnej.

Uwzględnij szczegóły produktu wykazu
offers.includeCatalogProductDetails boolean

To pole wskazuje, czy szczegóły wykazu produktów eBay są stosowane do oferty.

Identyfikator listy
offers.listing.listingId string

Unikatowy identyfikator oferty serwisu eBay skojarzony z opublikowaną ofertą.

Stan listy
offers.listing.listingStatus string

Stan listy skojarzony z opublikowaną ofertą.

Sprzedana ilość
offers.listing.soldQuantity integer

Ilość produktu, która została sprzedana dla opublikowanej oferty.

Opis listy
offers.listingDescription string

Opis oferty w serwisie eBay.

Czas trwania listy
offers.listingDuration string

Wskazuje liczbę dni, w których lista będzie aktywna.

Waluta
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Włączono najlepszą ofertę
offers.listingPolicies.bestOfferTerms.bestOfferEnabled boolean

To pole wskazuje, czy dla oferty jest włączona funkcja Najlepsza oferta.

eBay Plus , jeśli kwalifikuje się
offers.listingPolicies.eBayPlusIfEligible boolean

To pole jest zawarte w ofercie i ustawione na wartość true, jeśli sprzedawca Top-Rated zostanie włączony do programu eBay Plus

Identyfikator zasad realizacji
offers.listingPolicies.fulfillmentPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe realizacji, które będą używane po opublikowaniu oferty i przekonwertowaniu na ofertę w serwisie eBay.

Identyfikator zasad płatności
offers.listingPolicies.paymentPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe płatności, które będą używane po opublikowaniu oferty i przekonwertowaniu jej na ofertę w serwisie eBay.

productCompliancePolicyIds
offers.listingPolicies.productCompliancePolicyIds array of string

To pole zawiera tablicę zawierającą maksymalnie pięć identyfikatorów określających zasady zgodności utworzone przez sprzedawcę dla oferty.

Identyfikator zasad zwracanych
offers.listingPolicies.returnPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe zwrotu, które będą używane po opublikowaniu oferty i przekonwertowaniu jej na ofertę w serwisie eBay.

shippingCostOverrides
offers.listingPolicies.shippingCostOverrides array of object

Ten kontener jest używany, jeśli sprzedawca chce przesłonić koszty wysyłki lub dopłaty za jedną lub więcej opcji krajowych lub międzynarodowych usług wysyłkowych zdefiniowanych w zasadach aukcji realizacji.

waluta
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

waluta

value
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value string

value

priority
offers.listingPolicies.shippingCostOverrides.priority integer

priority

waluta
offers.listingPolicies.shippingCostOverrides.shippingCost.currency string

waluta

value
offers.listingPolicies.shippingCostOverrides.shippingCost.value string

value

shippingServiceType
offers.listingPolicies.shippingCostOverrides.shippingServiceType string

shippingServiceType

Identyfikator zasad take back
offers.listingPolicies.takeBackPolicyId string

Identyfikator sprzedawcy, który utworzył zasady wycofywania.

Data rozpoczęcia wyświetlania listy
offers.listingStartDate string

Data/godzina ustawiona przez sprzedawcę dla zaplanowanej oferty.

Rozmiar partii
offers.lotSize integer

To pole ma zastosowanie i zwracane tylko wtedy, gdy lista jest listą wielu.

Identyfikator witryny Marketplace
offers.marketplaceId string

Unikatowy identyfikator witryny serwisu eBay, w której jest dostępna oferta lub zostanie udostępniona.

Klucz lokalizacji sprzedawcy
offers.merchantLocationKey string

Unikatowy identyfikator lokalizacji spisu.

Identyfikator oferty
offers.offerId string

Unikatowy identyfikator oferty.

Waluta
offers.pricingSummary.auctionReservePrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
offers.pricingSummary.auctionReservePrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
offers.pricingSummary.auctionStartPrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
offers.pricingSummary.auctionStartPrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
offers.pricingSummary.minimumAdvertisedPrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
offers.pricingSummary.minimumAdvertisedPrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Pierwotnie sprzedany za cenę detaliczną w dniu
offers.pricingSummary.originallySoldForRetailPriceOn string

To pole jest potrzebne, jeśli funkcja Cennik przekreślenia będzie używana w ofercie. To pole wskazuje, że produkt został sprzedany za cenę w oryginalnym polu RetailPrice w witrynie serwisu eBay lub sprzedany za tę cenę przez sprzedawcy zewnętrznego.

Waluta
offers.pricingSummary.originalRetailPrice.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
offers.pricingSummary.originalRetailPrice.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
offers.pricingSummary.price.currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
offers.pricingSummary.price.value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Widoczność cen
offers.pricingSummary.pricingVisibility string

To pole jest wymagane, jeśli funkcja Minimalna anonsowana cena będzie używana w ofercie.

Limit ilości na nabywcę
offers.quantityLimitPerBuyer integer

To pole ma zastosowanie i jest ustawiane tylko wtedy, gdy sprzedawca chce ustawić ograniczenie dotyczące ilości zakupu przedmiotu zapasów na sprzedawcę.

Identyfikator kategorii pomocniczej
offers.secondaryCategoryId string

Unikatowy identyfikator dla kategorii pomocniczej.

SKU
offers.sku string

Wartość jednostki SKU zdefiniowanej przez sprzedawcę produktu w ofercie.

Status
offers.status string

Wartość określa stan oferty.

storeCategoryNames
offers.storeCategoryNames array of string

Ten kontener jest zwracany, jeśli sprzedawca zdecydował się umieścić przedmiot zapasów w jednej lub dwóch kategoriach sklepów eBay, które sprzedawca skonfigurował dla swojego sklepu w serwisie eBay

Zastosuj podatek
offers.tax.applyTax boolean

To pole zostanie uwzględnione, jeśli sprzedawca chce odwołać się do tabeli podatku od sprzedaży na poziomie konta w celu obliczenia podatku od sprzedaży dla zamówienia.

Kategoria podatku innej firmy
offers.tax.thirdPartyTaxCategory string

Kod kategorii wyjątków podatkowych.

Procent podatku VAT
offers.tax.vatPercentage number

Value Add Tax (VAT) wartość stawki dla przedmiotu, jeśli istnieje.

Poprzedni
prev string

Adres URL poprzedniej strony ofert.

Rozmiar
size integer

Liczba ofert wyświetlanych na bieżącej stronie wyników.

Total
total integer

Łączna liczba ofert, które istnieją dla określonej wartości jednostki SKU.

Pobieranie aspektów elementu dla kategorii

To wywołanie zwraca listę aspektów, które są odpowiednie lub niezbędne do dokładnego opisywania elementów w określonej kategorii liścia. Każdy aspekt identyfikuje atrybut elementu (na przykład kolor), dla którego sprzedawca będzie wymagany lub zachęcany do podania wartości (lub wartości odmiany) podczas oferowania elementu w tej kategorii w serwisie eBay.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator drzewa kategorii
category_tree_id True string

Drzewo kategorii serwisu eBay Unikatowy identyfikator, z którego są żądane aspekty określonej kategorii.

Identyfikator kategorii
category_id True string

Unikatowy identyfikator kategorii liścia, dla którego są żądane aspekty.

Zwraca

Nazwa Ścieżka Typ Opis
Aspekty
aspects array of object

Lista aspektów elementów, które są odpowiednie do opisywania elementów w określonej kategorii liścia

Aspekt ma zastosowanie do
aspects.aspectConstraint.aspectApplicableTo array of string

Ta wartość wskazuje, czy aspekt zidentyfikowany przez pole aspects.localizedAspectName jest aspektem produktu lub aspektem elementu/wystąpienia, który jest aspektem, którego wartość będzie się różnić w zależności od określonego wystąpienia produktu.

Typ danych aspektu
aspects.aspectConstraint.aspectDataType string

Typ danych aspektu.

Aspekt włączony dla odmian
aspects.aspectConstraint.aspectEnabledForVariations boolean

Wartość true wskazuje, że ten aspekt może służyć do identyfikowania odmian elementów.

Format proporcji
aspects.aspectConstraint.aspectFormat string

Zwracane tylko wtedy, gdy wartość parametru aspectDataType identyfikuje typ danych, który wymaga określonego formatowania.

Maksymalna długość proporcji
aspects.aspectConstraint.aspectMaxLength integer

Maksymalna długość wartości aspektu elementu.

Tryb proporcji
aspects.aspectConstraint.aspectMode string

Sposób, w jaki wartości tego aspektu muszą być określone przez sprzedawcę.

Wymagany aspekt
aspects.aspectConstraint.aspectRequired boolean

Wartość true wskazuje, że ten aspekt jest wymagany podczas oferowania elementów w określonej kategorii.

Użycie aspektu
aspects.aspectConstraint.aspectUsage string

Wartość wskazuje, czy odpowiedni aspekt jest zalecany lub opcjonalny.

Oczekiwano wymagane do daty
aspects.aspectConstraint.expectedRequiredByDate string

Oczekiwana data, po której będzie wymagany aspekt.

Element do kardynalności aspektu
aspects.aspectConstraint.itemToAspectCardinality string

Wskazuje, czy ten aspekt może akceptować pojedyncze lub wiele wartości dla elementów w określonej kategorii.

aspectValues
aspects.aspectValues array of object

Lista prawidłowych wartości wraz z wszelkimi ograniczeniami dla tego aspektu.

localizedValue
aspects.aspectValues.localizedValue string

Zlokalizowana wartość tego aspektu.

ograniczenia wartości
aspects.aspectValues.valueConstraints array of object

Zawiera listę zależności, które identyfikują, kiedy wartość pola localizedValue jest dostępna dla bieżącego aspektu.

applicableForLocalizedAspectName
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName string

Nazwa aspektu kontrolki, od którego zależy bieżąca wartość aspektu.

applicableForLocalizedAspectValues
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues array of string

Zawiera listę wartości aspektu kontrolnego, od którego zależy wartość tego aspektu.

Zlokalizowana nazwa aspektu
aspects.localizedAspectName string

Zlokalizowana nazwa tego aspektu.

Liczba wyszukiwań
aspects.relevanceIndicator.searchCount integer

Liczba ostatnich wyszukiwań dla aspektu.

Pobieranie domyślnego identyfikatora drzewa kategorii

Dana platforma handlowa w serwisie eBay może używać wielu drzew kategorii, ale jeden z tych drzew jest uważany za domyślny dla tej platformy handlowej. To wywołanie pobiera odwołanie do domyślnego drzewa kategorii skojarzonego z określonym identyfikatorem witryny marketplace serwisu eBay.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator witryny Marketplace
marketplace_id True string

Identyfikator witryny Marketplace serwisu eBay, dla którego jest żądany identyfikator drzewa kategorii.

Accept-Language
Accept-Language True string

Nagłówek używany do wskazywania języka naturalnego, w jakim sprzedawca preferuje odpowiedź.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator drzewa kategorii
categoryTreeId string

Unikatowy identyfikator drzewa kategorii serwisu eBay dla określonej platformy handlowej.

Wersja drzewa kategorii
categoryTreeVersion string

Wersja drzewa kategorii zidentyfikowana przez categoryTreeId.

Pobieranie elementów spisu

To wywołanie pobiera wszystkie rekordy elementów zapasów zdefiniowane dla konta sprzedawcy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Ograniczenie
limit string

Maksymalna liczba rekordów zwracanych na stronę danych.

Przesunięcie
offset string

Numer strony do pobrania.

Zwraca

Nazwa Ścieżka Typ Opis
Href
href string

Jest to adres URL bieżącej strony elementów spisu.

inventoryItems
inventoryItems array of object

Ten kontener jest tablicą co najmniej jednego elementu spisu.

pickupAtLocationAvailability
inventoryItems.availability.pickupAtLocationAvailability array of object

Ten kontener składa się z tablicy sklepów fizycznych sprzedawcy, w których przedmiot zapasów jest dostępny do odbioru w sklepie.

availabilityType
inventoryItems.availability.pickupAtLocationAvailability.availabilityType string

Stan dostępności elementu spisu

jednostka
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit string

Jednostka czasowa używana do określania czasu realizacji

value
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value integer

Wartość całkowita w tym polu wraz z jednostką czasową w polu jednostki będzie wskazywać czas realizacji.

merchantLocationKey
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey string

Unikatowy identyfikator sklepu handlowego, w którym znajduje się obecnie In-Store Przedmiot zapasów odbioru lub do którego zostanie wysłany.

ilość
inventoryItems.availability.pickupAtLocationAvailability.quantity integer

ilość

Aukcja
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction integer

Ta wartość całkowita wskazuje ilość elementu zapasów zarezerwowanego dla ofert opublikowanych ofert aukcyjnych jednostki SKU.

Stała cena
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

Ta wartość wskazuje ilość elementu zapasów, który jest dostępny dla ofert jednostki SKU w stałej cenie.

availabilityDistributions
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions array of object

Ten kontener służy do ustawiania dostępnej ilości elementu zapasów w co najmniej jednej lokalizacji magazynu.

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

jednostka

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

value

merchantLocationKey
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

merchantLocationKey

ilość
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity integer

ilość

Ilość
inventoryItems.availability.shipToLocationAvailability.quantity integer

Ten kontener służy do ustawiania całkowitej ilości "ship-to-home" elementu zapasów, który będzie dostępny do zakupu za pośrednictwem co najmniej jednej opublikowanej oferty

Condition
inventoryItems.condition string

Ta wartość wskazuje warunek elementu.

Opis warunku
inventoryItems.conditionDescription string

To pole ciągu jest używane przez sprzedawcę do dokładniejszego opisania warunku elementów

groupIds
inventoryItems.groupIds array of string

Ta tablica jest zwracana, jeśli element spisu jest skojarzony z dowolnymi grupami elementów spisu.

inventoryItemGroupKeys
inventoryItems.inventoryItemGroupKeys array of string

Ta tablica jest zwracana, jeśli element spisu jest skojarzony z dowolnymi grupami elementów spisu.

Lokalizacja
inventoryItems.locale string

To pole zwraca język naturalny podany w wartościach pól ładunku żądania.

Wysokość
inventoryItems.packageWeightAndSize.dimensions.height number

Rzeczywista wysokość pakietu wysyłkowego.

Długość
inventoryItems.packageWeightAndSize.dimensions.length number

Rzeczywista długość pakietu wysyłkowego.

Unit
inventoryItems.packageWeightAndSize.dimensions.unit string

Jednostka miary służąca do określania wymiarów pakietu wysyłkowego.

Szerokość
inventoryItems.packageWeightAndSize.dimensions.width number

Rzeczywista szerokość pakietu wysyłkowego.

Szerokość
inventoryItems.packageWeightAndSize.packageType string

Typ pakietu wysyłkowego używanego do wysłania elementu zapasów.

Unit
inventoryItems.packageWeightAndSize.weight.unit string

Jednostka miary używana do określania wagi pakietu wysyłkowego.

Wartość
inventoryItems.packageWeightAndSize.weight.value number

Rzeczywista waga pakietu wysyłkowego.

Aspekty
inventoryItems.product.aspects object

Jest to kolekcja par nazwa-wartość elementu, które dostarczają więcej informacji o produkcie i mogą ułatwić kupującym znalezienie.

Marka
inventoryItems.product.brand string

Marka produktu. To pole jest często sparowane z polem mpn w celu zidentyfikowania określonego produktu według numeru części produkcji.

Description
inventoryItems.product.description string

Opis produktu.

Ean
inventoryItems.product.ean array of string

Numer artykułu europejskiego/numer artykułu międzynarodowego dla produktu.

EPID
inventoryItems.product.epid string

Identyfikator produktu w serwisie eBay (ePID) dla produktu.

imageUrls
inventoryItems.product.imageUrls array of string

Tablica z co najmniej jednym linkiem do obrazów produktu.

Isbn
inventoryItems.product.isbn array of string

Wartość international Standard Book Number (Numer książki standardowej) produktu.

MPN
inventoryItems.product.mpn string

Numer części producenta produktu.

Podtytuł
inventoryItems.product.subtitle string

Podtytuł to opcjonalna funkcja aukcji, która umożliwia sprzedawcy podanie dodatkowych informacji o produkcie, w tym słów kluczowych, które mogą pomóc w wynikach wyszukiwania.

Title
inventoryItems.product.title string

Tytuł elementu spisu można dodać lub zmodyfikować

Upc
inventoryItems.product.upc array of string

Wartość universal Product Code produktu dla produktu.

videoIds
inventoryItems.product.videoIds array of string

Tablica z co najmniej jedną wartością VideoId produktu.

SKU
inventoryItems.sku string

Zdefiniowana przez sprzedawcę Stock-Keeping jednostka elementu zapasów.

Ograniczenie
limit integer

Liczba elementów spisu, które będą wyświetlane na każdej stronie wyników.

Next
next string

Adres URL na następnej stronie elementów spisu.

Poprzedni
prev string

Adres URL poprzedniej strony elementów spisu.

Rozmiar
size integer

Łączna liczba dostępnych stron wyników.

Total
total integer

Ttotal liczba przedmiotów zapasów, które istnieją dla konta sprzedawcy.

Pobieranie lokalizacji spisu

To wywołanie pobiera wszystkie zdefiniowane szczegóły lokalizacji spisu określonej przez parametr ścieżki merchantLocationKey.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz lokalizacji sprzedawcy
merchantLocationKey True string

Unikatowy klucz zdefiniowany przez handlowca (ID) dla lokalizacji zapasów.

Zwraca

Nazwa Ścieżka Typ Opis
Linia adresowa 1
location.address.addressLine1 string

Pierwszy wiersz adresu ulicznego.

Wiersz adresu 2
location.address.addressLine2 string

Drugi wiersz adresu ulicznego.

Miasto
location.address.city string

Miasto, w którym znajduje się lokalizacja spisu.

Country
location.address.country string

Kod kraju, w którym znajduje się adres

Powiat
location.address.county string

Hrabstwo, w którym znajduje się adres.

Kod pocztowy
location.address.postalCode string

Kod pocztowy adresu.

Województwo lub województwo
location.address.stateOrProvince string

Stan/prowincja, w której znajduje się lokalizacja spisu.

Szerokość
location.geoCoordinates.latitude string

Składnik szerokości geograficznej współrzędnej geograficznej.

Długość
location.geoCoordinates.longitude string

Składnik długości geograficznej współrzędnej geograficznej.

Identyfikator lokalizacji
location.locationId string

Unikatowy identyfikator przypisany do serwisu eBay dla lokalizacji.

Dodatkowe informacje o lokalizacji
locationAdditionalInformation string

To pole tekstowe zawiera dodatkowe informacje o lokalizacji spisu.

Instrukcje dotyczące lokalizacji
locationInstructions string

Pole jest używane przez sprzedawcę w celu dostarczenia specjalnych instrukcji odbioru dla lokalizacji sklepu.

locationTypes
locationTypes array of string

Ten kontener definiuje funkcję lokalizacji spisu.

Adres URL sieci Web lokalizacji
locationWebUrl string

Pole zawiera adres witryny internetowej skojarzony z lokalizacją spisu.

Klucz lokalizacji sprzedawcy
merchantLocationKey string

Unikatowy identyfikator lokalizacji spisu.

Stan lokalizacji sprzedawcy
merchantLocationStatus string

Pole wskazuje, czy lokalizacja spisu jest włączona, czy wyłączona

Name
name string

Nazwa lokalizacji spisu.

operatingHours
operatingHours array of object

Ten kontener pokazuje regularne godziny pracy dla lokalizacji sklepu w dniach tygodnia.

Wyliczenie tygodnia
operatingHours.dayOfWeekEnum string

Wartość jest wymagana dla każdego dnia tygodnia, w której lokalizacja sklepu ma regularne godziny pracy.

Odstępach czasu
operatingHours.intervals array of object

Ten kontener służy do definiowania czasów otwierania/zamykania dnia roboczego sklepu.

zamknąć
operatingHours.intervals.close string

zamknąć

otwarty
operatingHours.intervals.open string

otwarty

Telefon
phone string

Numer telefonu lokalizacji spisu.

SpecjalneHours
specialHours array of object

Ten kontener pokazuje specjalne godziny pracy dla lokalizacji sklepu w określonej dacie lub datach.

Date
specialHours.date string

Wartość daty jest wymagana dla każdej konkretnej daty, w której lokalizacja sklepu ma specjalne godziny pracy.

Odstępach czasu
specialHours.intervals array of object

Ten kontener służy do definiowania czasów otwierania/zamykania magazynu w określonej dacie.

zamknąć
specialHours.intervals.close string

zamknąć

otwarty
specialHours.intervals.open string

otwarty

Pobieranie lokalizacji spisu

To wywołanie pobiera wszystkie zdefiniowane szczegóły dla każdej lokalizacji zapasów skojarzonej z kontem sprzedawcy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Przesunięcie
offset string

Określa liczbę lokalizacji do pominięcia w zestawie wyników przed zwróceniem pierwszej lokalizacji.

Ograniczenie
limit string

Maksymalna liczba rekordów zwracanych na stronę danych.

Zwraca

Nazwa Ścieżka Typ Opis
Href
href string

Identyfikator URI bieżącej strony wyników z zestawu wyników.

Ograniczenie
limit integer

Liczba elementów zwróconych na jednej stronie z zestawu wyników.

Next
next string

Identyfikator URI dla następującej strony wyników.

Przesunięcie
offset string

Liczba wyników pominiętych w zestawie wyników przed wyświetleniem pierwszego zwróconego wyniku.

Poprzedni
prev string

Identyfikator URI poprzedniej strony wyników.

Total
total integer

Łączna liczba elementów pobranych w zestawie wyników.

lokalizacje
locations array of object

Tablica z co najmniej jedną lokalizacją zapasów kupca.

Linia adresowa 1
locations.location.address.addressLine1 string

Pierwszy wiersz adresu ulicznego.

Wiersz adresu 2
locations.location.address.addressLine2 string

Drugi wiersz adresu ulicznego.

Miejscowość
locations.location.address.city string

Miasto, w którym znajduje się lokalizacja spisu.

Country
locations.location.address.country string

Kod kraju, w którym znajduje się adres.

Powiat
locations.location.address.county string

Hrabstwo, w którym znajduje się adres.

Kod pocztowy
locations.location.address.postalCode string

Kod pocztowy adresu.

Województwo lub województwo
locations.location.address.stateOrProvince string

Stan/prowincja, w której znajduje się lokalizacja spisu.

Szerokość
locations.location.geoCoordinates.latitude string

Składnik szerokości geograficznej współrzędnej geograficznej.

Długość
locations.location.geoCoordinates.longitude string

Składnik długości geograficznej współrzędnej geograficznej.

Identyfikator lokalizacji
locations.location.locationId string

Unikatowy identyfikator przypisany do serwisu eBay dla lokalizacji.

Dodatkowe informacje o lokalizacji
locations.locationAdditionalInformation string

To pole zawiera dodatkowe informacje o lokalizacji spisu.

Instrukcje dotyczące lokalizacji
locations.locationInstructions string

To pole jest używane przez sprzedawcę w celu dostarczenia specjalnych instrukcji odbioru dla lokalizacji sklepu.

locationTypes
locations.locationTypes array of string

Ten kontener definiuje funkcję lokalizacji spisu.

Adres URL sieci Web lokalizacji
locations.locationWebUrl string

To pole zawiera adres witryny internetowej skojarzony z lokalizacją spisu.

Klucz lokalizacji sprzedawcy
locations.merchantLocationKey string

Unikatowy identyfikator lokalizacji spisu.

Stan lokalizacji sprzedawcy
locations.merchantLocationStatus string

To pole wskazuje, czy lokalizacja spisu jest włączona, czy wyłączona.

Name
locations.name string

Nazwa lokalizacji spisu.

operatingHours
locations.operatingHours array of object

Ten kontener pokazuje regularne godziny pracy dla lokalizacji sklepu w dniach tygodnia.

dayOfWeekEnum
locations.operatingHours.dayOfWeekEnum string

dayOfWeekEnum

Odstępach czasu
locations.operatingHours.intervals array of object

Ten kontener służy do definiowania czasów otwierania/zamykania dnia roboczego sklepu.

zamknąć
locations.operatingHours.intervals.close string

zamknąć

otwarty
locations.operatingHours.intervals.open string

otwarty

Telefon
locations.phone string

Numer telefonu lokalizacji spisu.

specialHours
locations.specialHours array of object

Ten kontener pokazuje specjalne godziny pracy dla lokalizacji sklepu w określonej dacie lub datach.

date
locations.specialHours.date string

date

Odstępach czasu
locations.specialHours.intervals array of object

Ten kontener służy do definiowania czasów otwierania i zamykania magazynu w określonej dacie.

zamknąć
locations.specialHours.intervals.close string

zamknąć

otwarty
locations.specialHours.intervals.open string

otwarty

Pobieranie zasad realizacji

Ta metoda pobiera pełne szczegóły zasad realizacji. Podaj identyfikator zasad, które chcesz pobrać przy użyciu parametru path fulfillmentPolicyId.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zasad realizacji
fulfillmentPolicyId True string

Identyfikator zasad realizacji, który chcesz pobrać

Zwraca

Nazwa Ścieżka Typ Opis
categoryTypes
categoryTypes array of object

Ten kontener wskazuje, czy zasady realizacji mają zastosowanie do list pojazdów samochodowych, czy list innych niż pojazdy silnikowe.

Name
categoryTypes.name string

Nazwa typu kategorii, do której mają zastosowanie zasady.

Description
description string

Zdefiniowany przez sprzedawcę opis zasad realizacji. Ten opis jest przeznaczony tylko do użytku sprzedawcy i nie jest udostępniany na żadnych stronach serwisu eBay.

Wysyłka frachtowa
freightShipping boolean

Jeśli zostanie zwrócona wartość true, sprzedawca oferuje wysyłkę frachtową.

Identyfikator zasad realizacji
fulfillmentPolicyId string

Unikatowy identyfikator przypisany do serwisu eBay dla zasad realizacji.

Globalna wysyłka
globalShipping boolean

Jeśli zostanie zwrócona wartość true, globalny program wysyłkowy serwisu eBay będzie używany przez sprzedawcę do wysyłania przedmiotów do lokalizacji międzynarodowych.

Unit
handlingTime.unit string

Zakres czasu jest definiowany podczas stosowania wartości określonej w polu wartości do wartości określonej dla jednostki.

Wartość
handlingTime.value integer

Wartość jednostki miary czasu określona w polu jednostki.

Odbiór lokalny
localPickup boolean

Jeśli zostanie zwrócona wartość true, odbiór lokalny jest dostępny dla tych zasad.

Identyfikator witryny Marketplace
marketplaceId string

Identyfikator witryny Marketplace serwisu eBay, do którego mają zastosowanie te zasady realizacji.

Name
name string

Unikatowa nazwa zdefiniowana przez sprzedawcę dla tych zasad realizacji.

Odbiór — odejścia
pickupDropOff boolean

Jeśli zostanie zwrócona wartość true, sprzedawca oferuje opcję "Kliknij i zbierz".

shippingOptions
shippingOptions array of object

Ta tablica służy do dostarczania szczegółowych informacji na temat krajowych i międzynarodowych opcji wysyłki dostępnych dla zasad.

Typ kosztu
shippingOptions.costType string

To pole określa, czy model kosztów wysyłki jest FLAT_RATE, czy OBLICZANY

Typ opcji
shippingOptions.optionType string

To pole służy do wskazania, czy odpowiednie opcje usługi wysyłkowej są krajowe lub międzynarodowe.

Waluta
shippingOptions.packageHandlingCost.currency string

Waluta podstawowa zastosowana do pola wartości w celu ustanowienia kwoty pieniężnej.

Wartość
shippingOptions.packageHandlingCost.value string

Kwota pieniężna w określonej walucie.

Identyfikator tabeli stawek
shippingOptions.rateTableId string

To pole jest używane, jeśli sprzedawca chce skojarzyć krajową lub międzynarodową tabelę stawek wysyłkowych z zasadami biznesowymi realizacji.

shippingServices
shippingOptions.shippingServices array of object

Ta tablica składa się z opcji krajowych lub międzynarodowych usług wysyłkowych, które są zdefiniowane dla zasad.

waluta
shippingOptions.shippingServices.additionalShippingCost.currency string

waluta

value
shippingOptions.shippingServices.additionalShippingCost.value string

value

buyerResponsibleForPickup
shippingOptions.shippingServices.buyerResponsibleForPickup boolean

To pole powinno zostać uwzględnione na aukcji pojazdów mechanicznych, jeśli będzie to odpowiedzialność kupującego za odebranie zakupionego pojazdu silnikowego po pełnej płatności.

buyerResponsibleForShipping
shippingOptions.shippingServices.buyerResponsibleForShipping boolean

To pole powinno zostać uwzględnione na aukcji pojazdów mechanicznych, jeśli będzie on odpowiedzialny za zorganizowanie wysyłki zakupionego pojazdu silnikowego po dokonaniu pełnej płatności

waluta
shippingOptions.shippingServices.cashOnDeliveryFee.currency string

waluta

value
shippingOptions.shippingServices.cashOnDeliveryFee.value string

value

freeShipping
shippingOptions.shippingServices.freeShipping boolean

To pole jest uwzględniane, jeśli sprzedawca oferuje bezpłatną opcję wysyłki do kupującego.

shippingCarrierCode
shippingOptions.shippingServices.shippingCarrierCode string

To pole ustawia/wskazuje przewoźnika wysyłkowego.

waluta
shippingOptions.shippingServices.shippingCost.currency string

waluta

value
shippingOptions.shippingServices.shippingCost.value string

value

shippingServiceCode
shippingOptions.shippingServices.shippingServiceCode string

To pole ustawia/wskazuje opcję krajowej lub międzynarodowej usługi wysyłkowej.

regionExcluded
shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regionExcluded

nazwa_regionu
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

nazwa_regionu

regionType
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType

regionIncluded
shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regionIncluded

nazwa_regionu
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

nazwa_regionu

regionType
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType

sortOrder
shippingOptions.shippingServices.sortOrder integer

Wartość całkowita ustawiona w tym polu kontroluje kolejność usługi wysyłkowej.

regionExcluded
shipToLocations.regionExcluded array of object

Tablica wartości regionName, które określają obszary, w których sprzedawca nie wysyła.

Nazwa regionu
shipToLocations.regionExcluded.regionName string

Ciąg, który wskazuje nazwę regionu, zgodnie z definicją w serwisie eBay.

Typ regionu
shipToLocations.regionExcluded.regionType string

Zastrzeżone do przyszłego użytku.

regionIncluded
shipToLocations.regionIncluded array of object

Tablica pól regionName określających obszary, w których sprzedawca jest dostarczany.

Nazwa regionu
shipToLocations.regionIncluded.regionName string

Ciąg, który wskazuje nazwę regionu, zgodnie z definicją w serwisie eBay.

Typ regionu
shipToLocations.regionIncluded.regionType string

Zastrzeżone do przyszłego użytku.

POBIERZ element spisu

To wywołanie pobiera rekord elementu spisu dla danej jednostki SKU.

Parametry

Nazwa Klucz Wymagane Typ Opis
SKU
sku True string

Wartość zdefiniowana przez sprzedawcę produktu, którego rekord zapasów chcesz pobrać.

Zwraca

Nazwa Ścieżka Typ Opis
PickupAtLocationAvailability
availability.pickupAtLocationAvailability array of object

Ten kontener składa się z tablicy sklepów fizycznych sprzedawcy, w których przedmiot zapasów jest dostępny do odbioru w sklepie.

Typ dostępności
availability.pickupAtLocationAvailability.availabilityType string

To pole wskazuje stan dostępności elementu zapasów w magazynie fizycznym sprzedawcy.

Unit
availability.pickupAtLocationAvailability.fulfillmentTime.unit string

Wartość wskazuje jednostkę czasu używaną do określenia czasu realizacji

Wartość
availability.pickupAtLocationAvailability.fulfillmentTime.value integer

Wartość całkowita w tym polu wraz z jednostką czasową w polu jednostki będzie wskazywać czas realizacji.

Klucz lokalizacji sprzedawcy
availability.pickupAtLocationAvailability.merchantLocationKey string

Unikatowy identyfikator sklepu kupców, do którego znajduje się obecnie In-Store Pickup, lub do którego zostanie wysłany.

Ilość
availability.pickupAtLocationAvailability.quantity integer

Ta wartość całkowita wskazuje ilość elementu zapasów, który jest dostępny dla In-Store Pickup

Aukcja
availability.shipToLocationAvailability.allocationByFormat.auction integer

Ta wartość całkowita wskazuje ilość elementu zapasów zarezerwowanego dla ofert opublikowanych ofert aukcyjnych jednostki SKU.

Stała cena
availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

Ta wartość całkowita wskazuje ilość elementu zapasów, który jest dostępny dla ofert jednostki SKU w stałej cenie.

AvailabilityDistributions
availability.shipToLocationAvailability.availabilityDistributions array of object

Ten kontener służy do ustawiania dostępnej ilości elementu zapasów w co najmniej jednej lokalizacji magazynu.

Unit
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

Wartość wskazuje jednostkę czasu używaną do określenia czasu realizacji

Wartość
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

Wartość całkowita w tym polu wraz z jednostką czasową w polu jednostki będzie wskazywać czas realizacji.

Klucz lokalizacji sprzedawcy
availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

Unikatowy identyfikator lokalizacji spisu, w której ilość jest dostępna dla elementu spisu.

Ilość
availability.shipToLocationAvailability.availabilityDistributions.quantity integer

Ilość elementu spisu, który jest dostępny w tej lokalizacji spisu.

Ilość
availability.shipToLocationAvailability.quantity integer

Ten kontener służy do ustawiania całkowitej ilości "ship-to-home" elementu zapasów, który będzie dostępny do zakupu za pośrednictwem co najmniej jednej opublikowanej oferty.

Condition
condition string

Ta wartość wskazuje warunek elementu

Opis warunku
conditionDescription string

To pole ciągu jest używane przez sprzedawcę, aby wyraźniej opisać warunek używanych elementów lub elementów, które nie są "Brand New", "New with tags" lub "New in box".

groupIds
groupIds array of string
inventoryItemGroupKeys
inventoryItemGroupKeys array of string

Ta tablica jest zwracana, jeśli element spisu jest skojarzony z dowolnymi grupami elementów spisu.

Lokalizacja
locale string

To pole zwraca język naturalny podany w wartościach pól ładunku żądania

Wysokość
packageWeightAndSize.dimensions.height number

Rzeczywista wysokość pakietu wysyłkowego.

Długość
packageWeightAndSize.dimensions.length number

Rzeczywista długość pakietu wysyłkowego.

Unit
packageWeightAndSize.dimensions.unit string

Jednostka miary służąca do określania wymiarów pakietu wysyłkowego.

Szerokość
packageWeightAndSize.dimensions.width number

Rzeczywista szerokość pakietu wysyłkowego.

Typ pakietu
packageWeightAndSize.packageType string

Ta wartość wskazuje typ pakietu wysyłkowego używanego do wysłania elementu zapasów.

Unit
packageWeightAndSize.weight.unit string

Jednostka miary używana do określania wagi pakietu wysyłkowego.

Wartość
packageWeightAndSize.weight.value number

Rzeczywista waga pakietu wysyłkowego.

Aspekty
product.aspects object

Jest to kolekcja par nazwa-wartość elementu, które dostarczają więcej informacji o produkcie i mogą ułatwić kupującym znalezienie.

Marka
product.brand string

Marka produktu.

Description
product.description string

Opis produktu.

Ean
product.ean array of string

Numer artykułu europejskiego/numer artykułu międzynarodowego (EAN) dla produktu.

EPID
product.epid string

Identyfikator produktu w serwisie eBay (ePID) dla produktu.

imageUrls
product.imageUrls array of string

Tablica z co najmniej jednym linkiem do obrazów produktu.

Isbn
product.isbn array of string

Wartość international Standard Book Number (Numer książki standardowej) produktu.

MPN
product.mpn string

Numer części producenta (MPN) produktu.

Podtytuł
product.subtitle string

Podtytuł to opcjonalna funkcja aukcji, która umożliwia sprzedawcy podanie dodatkowych informacji o produkcie, w tym słów kluczowych, które mogą pomóc w wynikach wyszukiwania.

Title
product.title string

Tytuł elementu spisu można dodać lub zmodyfikować za pomocą wywołania createOrReplaceInventoryItem.

Upc
product.upc array of string

Wartość international Standard Book Number (Numer książki standardowej) produktu.

videoIds
product.videoIds array of string

Tablica z co najmniej jedną wartością VideoId produktu.

SKU
sku string

Jednostka (SKU) zdefiniowana Stock-Keeping przez sprzedawcę (JEDNOSTKA SKU) elementu zapasów. Sprzedawca powinien mieć unikatową wartość jednostki SKU dla każdego sprzedawanego produktu.

Publikowanie oferty

To połączenie służy do konwertowania nieopublikowanej oferty na opublikowaną ofertę lub oferty na żywo w serwisie eBay. Unikatowy identyfikator oferty (offerId) jest przekazywany na końcu identyfikatora URI wywołania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator oferty
offerId True string

Unikatowy identyfikator oferty, która ma zostać opublikowana.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator listy
listingId string

Unikatowy identyfikator nowo utworzonej oferty w serwisie eBay.

Ostrzeżenia
warnings array of object

Ten kontener zostanie zwrócony, jeśli wystąpił co najmniej jedno ostrzeżenie skojarzone z próbą wycofania oferty.

Kategoria
warnings.category string

Ta wartość ciągu wskazuje kategorię błędów.

Domena
warnings.domain string

Nazwa domeny, w której wystąpił błąd lub ostrzeżenie.

Identyfikator błędu
warnings.errorId integer

Unikatowy kod identyfikujący konkretny błąd lub ostrzeżenie, które wystąpiło.

inputRefIds
warnings.inputRefIds array of string

Tablica z co najmniej jednym identyfikatorem odwołania, które identyfikują określone elementy żądania najbardziej powiązane z błędem lub ostrzeżeniem, jeśli istnieją.

Długa wiadomość
warnings.longMessage string

Szczegółowy opis warunku, który spowodował błąd lub ostrzeżenie, oraz informacje o tym, co należy zrobić, aby rozwiązać problem.

Message
warnings.message string

Opis warunku, który spowodował błąd lub ostrzeżenie.

outputRefIds
warnings.outputRefIds array of string

Tablica jednego lub większej liczby identyfikatorów odwołań, które identyfikują określone elementy odpowiedzi najbardziej powiązane z błędem lub ostrzeżeniem, jeśli istnieją.

parameters
warnings.parameters array of object

Różne komunikaty ostrzegawcze i komunikaty o błędach zwracają co najmniej jedną zmienną zawierającą kontekstowe informacje o błędzie lub ostrzeżeniu.

nazwa
warnings.parameters.name string

nazwa

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nazwa poddomeny, w której wystąpił błąd lub ostrzeżenie.

Tworzenie lokalizacji spisu

Użyj tego wywołania, aby utworzyć nową lokalizację spisu. Aby można było utworzyć i opublikować ofertę, sprzedawca musi mieć co najmniej jedną lokalizację zapasów, ponieważ każda oferta musi być skojarzona z lokalizacją.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz lokalizacji sprzedawcy
merchantLocationKey True string

Unikatowy klucz zdefiniowany przez handlowca dla lokalizacji zapasów.

Linia adresowa 1
addressLine1 string

Pierwszy wiersz adresu ulicznego.

Wiersz adresu 2
addressLine2 string

Drugi wiersz adresu ulicznego.

Miejscowość
city string

Miasto, w którym znajduje się lokalizacja spisu.

Country
country string

Kod kraju, w którym znajduje się adres.

Powiat
county string

Hrabstwo, w którym znajduje się adres.

Kod pocztowy
postalCode string

Kod pocztowy adresu.

Województwo lub województwo
stateOrProvince string

Stan/prowincja, w której znajduje się lokalizacja spisu.

Szerokość
latitude string

Składnik szerokości geograficznej współrzędnej geograficznej.

Długość
longitude string

Składnik długości geograficznej współrzędnej geograficznej.

Dodatkowe informacje o lokalizacji
locationAdditionalInformation string

Dodatkowe informacje o lokalizacji spisu.

Instrukcje dotyczące lokalizacji
locationInstructions string

Specjalne instrukcje dotyczące odbioru dla lokalizacji magazynu.

locationTypes
locationTypes array of string

Typy lokalizacji

Adres URL sieci Web lokalizacji
locationWebUrl string

Adres witryny internetowej skojarzony z lokalizacją spisu.

Stan lokalizacji sprzedawcy
merchantLocationStatus string

Stan lokalizacji spisu można włączyć lub wyłączyć.

Name
name string

Nazwa lokalizacji spisu.

Dzień tygodnia
dayOfWeekEnum string

Dzień, w której lokalizacja sklepu ma regularne godziny pracy.

zamknąć
close string

Czas zamknięcia sklepu.

otwarty
open string

Czas otwarcia sklepu.

Telefon
phone string

Numer telefonu lokalizacji spisu sklepu.

Date
date string

Określona wartość daty, o której lokalizacja sklepu ma specjalne godziny pracy.

zamknąć
close string

Czas zamknięcia sklepu.

otwarty
open string

Czas otwarcia sklepu.

Zwraca

response
string

Tworzenie lub zastępowanie elementu spisu

To wywołanie tworzy nowy rekord elementu spisu lub zastępuje istniejący rekord elementu spisu.

Parametry

Nazwa Klucz Wymagane Typ Opis
SKU
sku True string

Wartość zdefiniowana przez sprzedawcę dla elementu zapasów.

Język zawartości
Content-Language True string

Nagłówek ustawia język naturalny, który będzie używany w wartościach pól ładunku żądania.

Typ
availabilityType string

Stan dostępności przedmiotu zapasów w magazynie fizycznym sprzedawcy.

Unit
unit string

Jednostka czasowa służąca do określania czasu realizacji.

Wartość
value integer

Wartość czasu realizacji.

Klucz lokalizacji sprzedawcy
merchantLocationKey string

Unikatowy identyfikator sklepu kupców, w którym znajduje się obecnie lub do którego będzie wysyłany In-Store pickup.

Ilość
quantity integer

Ilość towaru zapasów dostępnego dla In-Store Odbiór.

Unit
unit string

Jednostka czasowa służąca do określania czasu realizacji.

Wartość
value integer

Wartość czasu realizacji.

Klucz lokalizacji sprzedawcy
merchantLocationKey string

Unikatowy identyfikator sklepu kupców, w którym znajduje się obecnie In-Store przedmiot zapasów odbioru lub do którego zostanie wysłany.

Ilość
quantity integer

Ilość elementu spisu, który jest dostępny w tej lokalizacji spisu.

Ilość
quantity integer

Łączna ilość "ship-to-home" pozycji zapasów, która będzie dostępna do zakupu za pośrednictwem co najmniej jednej opublikowanej oferty.

Condition
condition string

Warunek elementu.

Opis warunku
conditionDescription string

Opis warunku elementu spisu.

Wysokość
height number

Rzeczywista wysokość pakietu wysyłkowego.

Długość
length number

Rzeczywista długość pakietu wysyłkowego.

Unit
unit string

Jednostka miary używana do określania wymiarów pakietu wysyłkowego.

Szerokość
width number

Rzeczywista szerokość pakietu wysyłkowego.

Typ pakietu
packageType string

Wartość pakietu wysyłkowego używana do wysłania elementu zapasów.

Unit
unit string

Jednostka miary używana do określania wagi pakietu wysyłkowego.

Wartość
value number

Rzeczywista waga pakietu wysyłkowego.

Aspekty
aspects object

Jest to kolekcja par nazwa-wartość elementu, które dostarczają więcej informacji o produkcie i mogą ułatwić kupującym znalezienie.

Marka
brand string

Marka produktu.

Description
description string

Opis produktu.

Elementy EAN
ean array of string

EAN

EPID
epid string

Identyfikator produktu w serwisie eBay.

Adresy URL obrazów
imageUrls array of string

Adresy URL obrazów

Elementy ISBN
isbn array of string

ISBN

MPN
mpn string

Numer części producenta produktu.

Podtytuł
subtitle string

Opcjonalna funkcja aukcji, która umożliwia sprzedawcy podanie dodatkowych informacji o produkcie, w tym słów kluczowych, które mogą pomóc w wynikach wyszukiwania.

Title
title string

Tytuł elementu spisu można dodać lub zmodyfikować.

Elementy upC
upc array of string

Upc

Identyfikatory wideo
videoIds array of string

videoIds

Zwraca

Nazwa Ścieżka Typ Opis
Ostrzeżenia
warnings array of object

Ten kontener zostanie zwrócony w ładunku odpowiedzi wywołania, jeśli zostanie wyzwolone jedno lub więcej ostrzeżeń lub błędów.

Kategoria
warnings.category string

Ta wartość ciągu wskazuje kategorię błędów.

Domena
warnings.domain string

Nazwa domeny, w której wystąpił błąd lub ostrzeżenie.

Identyfikator błędu
warnings.errorId integer

Unikatowy kod identyfikujący konkretny błąd lub ostrzeżenie, które wystąpiło.

inputRefIds
warnings.inputRefIds array of string

Tablica z co najmniej jednym identyfikatorem odwołania, które identyfikują określone elementy żądania najbardziej powiązane z błędem lub ostrzeżeniem, jeśli istnieją.

Długa wiadomość
warnings.longMessage string

Szczegółowy opis warunku, który spowodował błąd lub ostrzeżenie, oraz informacje o tym, co należy zrobić, aby rozwiązać problem.

Message
warnings.message string

Opis warunku, który spowodował błąd lub ostrzeżenie.

outputRefIds
warnings.outputRefIds array of string

Tablica jednego lub większej liczby identyfikatorów odwołań, które identyfikują określone elementy odpowiedzi najbardziej powiązane z błędem lub ostrzeżeniem, jeśli istnieją.

parameters
warnings.parameters array of object

Różne komunikaty ostrzegawcze i komunikaty o błędach zwracają co najmniej jedną zmienną zawierającą kontekstowe informacje o błędzie lub ostrzeżeniu.

nazwa
warnings.parameters.name string

nazwa

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain object

Opis warunku, który spowodował błąd lub ostrzeżenie.

Tworzenie oferty

To wywołanie tworzy ofertę dla określonego elementu zapasów na określonej platformie handlowej serwisu eBay.

Parametry

Nazwa Klucz Wymagane Typ Opis
Dostępna ilość
availableQuantity integer

Dostępna ilość zapasów do zakupu.

Identyfikator kategorii
categoryId string

Unikatowy identyfikator kategorii serwisu eBay, w ramach którego będzie wyświetlany produkt.

Identyfikator organizacji charytatywnej
charityId string

Przypisany przez serwis eBay unikatowy identyfikator organizacji charytatywnej, która otrzyma procent wpływów ze sprzedaży.

Procent darowizny
donationPercentage string

Procent ceny zakupu, który organizacja charytatywna otrzyma za każdą sprzedaż, która generuje aukcję.

Identyfikator produktu producenta
producerProductId string

Unikatowy identyfikator producenta powiązanego z elementem.

Identyfikator pakietu produktu
productPackageId string

Unikatowy identyfikator producenta opakowania produktu dodanego przez sprzedawcę.

Identyfikator pakietu wysyłki
shipmentPackageId string

Unikatowy identyfikator producenta dowolnego opakowania używanego przez sprzedawcę do wysyłki.

Identyfikator dokumentacji produktu
productDocumentationId string

Unikatowy identyfikator producenta dowolnego papieru dodanego do paczki przedmiotu przez sprzedawcę.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Format
format string

Format oferty.

Ukryj szczegóły nabywcy
hideBuyerDetails boolean

To pole jest uwzględniane, jeśli sprzedawca chce utworzyć prywatną ofertę.

Uwzględnij szczegóły produktu wykazu
includeCatalogProductDetails boolean

Wskazuje, czy szczegóły wykazu produktów eBay są stosowane do oferty.

Opis listy
listingDescription string

Opis oferty w serwisie eBay.

Czas trwania listy
listingDuration string

Liczba dni, w których lista będzie aktywna.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Włączono najlepszą ofertę
bestOfferEnabled boolean

Wskazuje, czy dla listy jest włączona funkcja Najlepsza oferta.

eBay Plus , jeśli kwalifikuje się
eBayPlusIfEligible boolean

To pole jest uwzględniane w ofercie, jeśli sprzedawca Top-Rated zostanie wyrażeniu zgody na program eBay Plus.

Identyfikator zasad realizacji
fulfillmentPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe realizacji, które będą używane po opublikowaniu oferty i przekonwertowaniu na ofertę w serwisie eBay.

Identyfikator zasad płatności
paymentPolicyId string

Unikatowy identyfikator wskazuje zasady biznesowe płatności, które będą używane po opublikowaniu oferty i przekonwertowaniu jej na ofertę w serwisie eBay.

Identyfikatory zasad zgodności produktów
productCompliancePolicyIds array of string

To pole zawiera tablicę zawierającą maksymalnie pięć identyfikatorów określających zasady zgodności utworzone przez sprzedawcę dla oferty.

Identyfikator zasad zwracanych
returnPolicyId string

Zwracanie unikatowych identyfikatorów zasad biznesowych, które będą używane po opublikowaniu oferty i przekonwertowaniu jej na listę w serwisie eBay.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Priority
priority integer

Dane wejściowe wartości całkowitej w tym polu wraz z wartością shippingServiceType określają, która opcja krajowej lub międzynarodowej usługi wysyłkowej w zasadach realizacji zostanie zmodyfikowana ze zaktualizowanymi kosztami wysyłki.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Rodzaj usługi
shippingServiceType string

Ta wartość wskazuje, czy usługa wysyłkowa określona w polu priorytetu jest opcją krajową, czy międzynarodową usługą wysyłkową.

Identyfikator zasad take back
takeBackPolicyId string

Identyfikator sprzedawcy, który utworzył zasady wycofywania.

Data rozpoczęcia wyświetlania listy
listingStartDate string

To pole może być używane, jeśli sprzedawca chce określić czas w przyszłości, że aukcja stanie się aktywna w serwisie eBay.

Rozmiar partii
lotSize integer

To pole ma zastosowanie tylko wtedy, gdy lista jest listą wielu. Wartość całkowita przekazana do tego pola to całkowita liczba elementów w partii.

Identyfikator witryny Marketplace
marketplaceId string

Unikatowy identyfikator witryny serwisu eBay, dla którego zostanie udostępniona oferta.

Klucz lokalizacji sprzedawcy
merchantLocationKey string

Unikatowy identyfikator lokalizacji spisu sprzedawcy

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Pierwotnie sprzedany za cenę detaliczną w dniu
originallySoldForRetailPriceOn string

To pole jest potrzebne, jeśli funkcja Cennik przekreślenia będzie używana w ofercie. To pole wskazuje, że produkt został sprzedany za cenę w oryginalnym polu RetailPrice w witrynie serwisu eBay lub sprzedany za tę cenę przez sprzedawcy zewnętrznego

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Waluta
currency string

Trzycyfrowa wartość ciągu reprezentująca typ waluty.

Wartość
value string

Ciąg reprezentujący wartość dolara wyrażoną w polu waluty.

Widoczność cen
pricingVisibility string

To pole jest wymagane, jeśli funkcja Minimalna anonsowana cena będzie używana w ofercie.

Limit ilości na nabywcę
quantityLimitPerBuyer integer

To pole ma zastosowanie i jest ustawiane tylko wtedy, gdy sprzedawca chce ustawić ograniczenie dotyczące ilości zakupu na sprzedawcę.

Identyfikator kategorii pomocniczej
secondaryCategoryId string

Unikatowy identyfikator kategorii pomocniczej i ma zastosowanie, jeśli sprzedawca zdecyduje się wyświetlić element w dwóch kategoriach.

SKU
sku string

Wartość jednostki SKU zdefiniowanej przez sprzedawcę produktu, która będzie wyświetlana w witrynie serwisu eBay.

Nazwy kategorii sklepu
storeCategoryNames array of string

Nazwa kategorii sklepu

Zastosuj podatek
applyTax boolean

Ten kontener ma zastosowanie i jest używany tylko wtedy, gdy do oferty zostanie zastosowana tabela podatku, Value-Added stawka podatku lub kod kategorii wyjątków podatkowych.

Kategoria podatku innej firmy
thirdPartyTaxCategory string

Kod kategorii wyjątków podatkowych. Jeśli to pole jest używane, podatek od sprzedaży będzie również stosowany do usługi/opłaty, a nie tylko ceny przedmiotu.

Procent podatku VAT
vatPercentage number

Ta wartość to stawka VAT dla przedmiotu, jeśli istnieje. Po określeniu wartości procentowej PODATKU VAT informacje o podatku VAT są wyświetlane na stronie Wyświetl element.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator oferty
offerId string

Unikatowy identyfikator oferty

Ostrzeżenia
warnings array of object

Ten kontener zostanie zwrócony, gdy zostanie wykonane wywołanie, a wystąpią błędy i/lub ostrzeżenia.

Kategoria
warnings.category string

Ta wartość ciągu wskazuje kategorię błędów

Domena
warnings.domain string

Nazwa domeny, w której wystąpił błąd lub ostrzeżenie.

Identyfikator błędu
warnings.errorId integer

Unikatowy kod identyfikujący określony błąd lub ostrzeżenie, które wystąpiło.

inputRefIds
warnings.inputRefIds array of string

Tablica z co najmniej jednym identyfikatorem odwołania, które identyfikują określone elementy żądania najbardziej powiązane z błędem lub ostrzeżeniem, jeśli istnieją.

Długa wiadomość
warnings.longMessage string

Szczegółowy opis warunku, który spowodował błąd lub ostrzeżenie, oraz informacje o tym, co należy zrobić, aby rozwiązać problem.

Message
warnings.message string

Opis warunku, który spowodował błąd lub ostrzeżenie.

outputRefIds
warnings.outputRefIds array of string

Tablica jednego lub większej liczby identyfikatorów odwołań, które identyfikują określone elementy odpowiedzi najbardziej powiązane z błędem lub ostrzeżeniem, jeśli istnieją.

parameters
warnings.parameters array of object

Różne komunikaty ostrzegawcze i komunikaty o błędach zwracają co najmniej jedną zmienną zawierającą kontekstowe informacje o błędzie lub ostrzeżeniu.

nazwa
warnings.parameters.name string

nazwa

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nazwa poddomeny, w której wystąpił błąd lub ostrzeżenie.

Usuń ofertę

To wywołanie spowoduje trwałe usunięcie oferty

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator oferty
offerId True string

Unikatowy identyfikator oferty do usunięcia.

Zwraca

response
string

Uzyskiwanie sugestii dotyczących kategorii

To wywołanie zwraca tablicę węzłów liści drzewa kategorii w określonym drzewie kategorii, które są brane pod uwagę przez serwis eBay, aby najlepiej odpowiadać zapytaniu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator drzewa kategorii
category_tree_id True string

Unikatowy identyfikator drzewa kategorii serwisu eBay, dla którego są żądane sugerowane węzły.

Wyszukiwany termin
q True string

Termin wyszukiwania, który opisuje oferowany przedmiot do sprzedaży.

Zwraca

Nazwa Ścieżka Typ Opis
categorySuggestions
categorySuggestions array of object

Zawiera szczegółowe informacje o co najmniej jednej sugerowanej kategorii, która odpowiada podanym słowom kluczowym.

Identyfikator kategorii
categorySuggestions.category.categoryId string

Unikatowy identyfikator kategorii eBay w drzewie kategorii.

Nazwa kategorii
categorySuggestions.category.categoryName string

Nazwa kategorii zidentyfikowanej przez categoryId.

Elementy podrzędne węzła drzewa kategorii
categorySuggestions.categoryTreeNodeAncestors array of object

Tablica uporządkowanych odwołań do kategorii opisujących lokalizację sugerowanej kategorii w określonym drzewie kategorii.

categoryId
categorySuggestions.categoryTreeNodeAncestors.categoryId string

Unikatowy identyfikator kategorii przodków serwisu eBay.

categoryName
categorySuggestions.categoryTreeNodeAncestors.categoryName string

Nazwa kategorii przodków zidentyfikowanej przez categoryId.

categorySubtreeNodeHref
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref string

Część href wywołania getCategorySubtree, która pobiera poddrzewo poniżej węzła kategorii przodków.

categoryTreeNodeLevel
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel integer

Bezwzględny poziom węzła kategorii przodków w hierarchii drzewa kategorii.

Poziom węzła drzewa kategorii
categorySuggestions.categoryTreeNodeLevel integer

Bezwzględny poziom węzła kategorii przodków w hierarchii drzewa kategorii.

Trafności
categorySuggestions.relevancy string

To pole jest zarezerwowane do użytku wewnętrznego lub przyszłego.

Identyfikator drzewa kategorii
categoryTreeId string

Unikatowy identyfikator drzewa kategorii serwisu eBay, z którego są zwracane sugestie.

Wersja drzewa kategorii
categoryTreeVersion string

Wersja drzewa kategorii zidentyfikowana przez categoryTreeId.

Uzyskiwanie zasad powrotu

Ta metoda pobiera pełne szczegóły zasad zwracanych określonych przez parametr ścieżki returnPolicyId.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zasad zwracanych
return_policy_id True string

Zwraca identyfikator zasad, które chcesz pobrać.

Zwraca

Nazwa Ścieżka Typ Opis
categoryTypes
categoryTypes array of object

Ten kontener wskazuje, do której grupy kategorii mają zastosowanie zasady powrotu.

Name
categoryTypes.name string

Typ kategorii, do którego mają zastosowanie zasady

Description
description string

Zdefiniowany przez sprzedawcę opis zasad biznesowych zwrotu.

Return, metoda
internationalOverride.returnMethod string

To pole ustawia/wskazuje, czy sprzedawca oferuje nabywcy przedmioty zastępcze w przypadku zwrotu międzynarodowego.

Unit
internationalOverride.returnPeriod.unit string

Jednostka miary czasu, taka jak DZIEŃ.

Wartość
internationalOverride.returnPeriod.value integer

Wartość jednostki miary czasu określona w polu jednostki.

Zwraca zaakceptowane
internationalOverride.returnsAccepted boolean

Wartość jednostki miary czasu określona w polu jednostki.

Zwrot kosztu wysyłki płatnika
internationalOverride.returnShippingCostPayer string

To pole wskazuje, kto jest odpowiedzialny za płacenie za opłaty za wysyłkę za zwrócone przedmioty.

Identyfikator witryny Marketplace
marketplaceId string

Identyfikator witryny marketplace serwisu eBay, do której mają zastosowanie te zasady dotyczące zwrotu.

Name
name string

Nazwa zdefiniowana przez sprzedawcę dla tych zasad biznesowych płatności.

Metoda zwrotu pieniędzy
refundMethod string

Jeśli sprzedawca wskaże, że zaakceptuje zwroty kupującego, ta wartość zostanie ustawiona na MONEY_BACK.

Instrukcje powrotu
returnInstructions string

To pole tekstowe zawiera więcej szczegółów na temat instrukcji zwrotnych określonych przez sprzedawcę. To pole jest zwracane tylko w przypadku ustawienia zasad zwracanych firm.

Return, metoda
returnMethod string

To pole jest zwracane tylko wtedy, gdy sprzedawca jest gotów zaoferować przedmiot zastępczy jako alternatywę dla "Money Back"

Unit
returnPeriod.unit string

Jednostka miary czasu, taka jak DZIEŃ.

Wartość
returnPeriod.value integer

Wartość jednostki miary czasu określona w polu jednostki.

Identyfikator zasad zwracanych
returnPolicyId string

Unikatowy identyfikator przypisany do serwisu eBay dla zasad biznesowych zwrotu. Ten identyfikator jest generowany podczas tworzenia zasad.

Zwraca zaakceptowane
returnsAccepted boolean

Jeśli to pole jest zwracane jako true, sprzedawca akceptuje zwroty.

Zwrot kosztu wysyłki płatnika
returnShippingCostPayer string

To pole wskazuje, kto jest odpowiedzialny za płacenie za opłaty za wysyłkę za zwrócone przedmioty.

Uzyskiwanie zasad płatności

Ta metoda pobiera wszystkie zasady płatności skonfigurowane dla platformy handlowej określonej przy użyciu parametru zapytania marketplace_id.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator witryny Marketplace
marketplace_id string

Identyfikator witryny Marketplace serwisu eBay zasad, które chcesz pobrać.

Zwraca

Nazwa Ścieżka Typ Opis
Href
href string

To pole jest przeznaczone do użytku w przyszłości.

Ograniczenie
limit integer

To pole jest przeznaczone do użytku w przyszłości.

Next
next string

To pole jest przeznaczone do użytku w przyszłości.

Przesunięcie
offset integer

To pole jest przeznaczone do użytku w przyszłości.

paymentPolicies
paymentPolicies array of object

Lista zasad biznesowych dotyczących płatności sprzedawcy zdefiniowanych dla określonej platformy handlowej.

categoryTypes
paymentPolicies.categoryTypes array of object

Ten kontener wskazuje, czy zasady realizacji mają zastosowanie do list pojazdów mechanicznych, czy niesilnikowych.

domyślny
paymentPolicies.categoryTypes.default boolean

domyślny

nazwa
paymentPolicies.categoryTypes.name string

nazwa

Waluta
paymentPolicies.deposit.amount.currency string

Waluta podstawowa zastosowana do pola wartości w celu ustanowienia kwoty pieniężnej.

Wartość
paymentPolicies.deposit.amount.value string

Kwota pieniężna w określonej walucie.

Unit
paymentPolicies.deposit.dueIn.unit string

Te wartości reprezentują jednostkę miary czasu, taką jak DZIEŃ.

Wartość
paymentPolicies.deposit.dueIn.value integer

Wartość jednostki miary czasu określona w polu jednostki.

Description
paymentPolicies.description string

Zdefiniowany przez sprzedawcę opis zasad płatności.

Unit
paymentPolicies.fullPaymentDueIn.unit string

Jednostka miary czasu, taka jak DZIEŃ.

Wartość
paymentPolicies.fullPaymentDueIn.value integer

Wartość jednostki miary czasu określona w polu jednostki.

Natychmiastowa płatność
paymentPolicies.immediatePay boolean

Jeśli to pole zostanie zwrócone jako prawdziwe, wymagana jest natychmiastowa płatność od kupującego

Identyfikator witryny Marketplace
paymentPolicies.marketplaceId string

Identyfikator witryny marketplace serwisu eBay, do którego mają zastosowanie zasady płatności.

Name
paymentPolicies.name string

Nazwa zdefiniowana przez sprzedawcę dla tych zasad realizacji.

Instrukcje dokonywania płatności
paymentPolicies.paymentInstructions string

Chociaż to pole może zostać zwrócone dla niektórych starszych zasad biznesowych płatności, instrukcje dotyczące płatności nie są już obsługiwane przez zasady biznesowe płatności. Jeśli to pole zostanie zwrócone, można je zignorować, a te instrukcje dotyczące płatności nie będą wyświetlane w żadnych listach korzystających z odpowiednich zasad biznesowych.

paymentMethods
paymentPolicies.paymentMethods array of object

Ten kontener jest zwracany, aby wyświetlić formy płatności akceptowane dla zasad biznesowych płatności.

paymentMethodType
paymentPolicies.paymentMethods.paymentMethodType string

Typ formy płatności

Identyfikator zasad płatności
paymentPolicies.paymentPolicyId string

Unikatowy identyfikator przypisany do serwisu eBay dla zasad biznesowych płatności.

Poprzedni
prev string

To pole jest przeznaczone do użytku w przyszłości.

Total
total integer

Łączna liczba zasad biznesowych płatności pobranych w zestawie wyników.

Uzyskiwanie zasad płatności

Ta metoda pobiera pełne szczegóły zasad płatności. Podaj identyfikator zasad, które chcesz pobrać przy użyciu parametru ścieżki paymentPolicyId.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zasad płatności
payment_policy_id True string

Identyfikator zasad płatności, które chcesz pobrać.

Zwraca

Nazwa Ścieżka Typ Opis
categoryTypes
categoryTypes array of object

Ten kontener wskazuje, czy zasady realizacji mają zastosowanie do list pojazdów mechanicznych, czy niesilnikowych.

Name
categoryTypes.name string

Typ kategorii, do którego mają zastosowanie zasady.

Waluta
deposit.amount.currency string

Waluta podstawowa zastosowana do pola wartości w celu ustanowienia kwoty pieniężnej.

Wartość
deposit.amount.value string

Kwota pieniężna w określonej walucie.

Unit
deposit.dueIn.unit string

Jednostka miary czasu, taka jak DZIEŃ.

Wartość
deposit.dueIn.value integer

Wartość jednostki miary czasu określona w polu jednostki.

Description
description string

Zdefiniowany przez sprzedawcę opis zasad płatności.

Unit
fullPaymentDueIn.unit string

Jednostka miary czasu, taka jak DZIEŃ.

Wartość
fullPaymentDueIn.value integer

Wartość jednostki miary czasu określona w polu jednostki.

Natychmiastowa płatność
immediatePay boolean

Jeśli to pole zostanie zwrócone jako prawdziwe, wymagana jest natychmiastowa płatność od kupującego

Identyfikator witryny Marketplace
marketplaceId string

Identyfikator witryny marketplace serwisu eBay, do której mają zastosowanie zasady biznesowe płatności.

Name
name string

Identyfikator witryny marketplace serwisu eBay, do której mają zastosowanie zasady biznesowe płatności.

Instrukcje dokonywania płatności
paymentInstructions string

Chociaż to pole może zostać zwrócone dla niektórych starszych zasad biznesowych płatności, instrukcje dotyczące płatności nie są już obsługiwane przez zasady biznesowe płatności

paymentMethods
paymentMethods array of object

Ten kontener jest zwracany, aby wyświetlić formy płatności akceptowane dla zasad biznesowych płatności.

Typ formy płatności
paymentMethods.paymentMethodType string

Typ formy płatności dla pomocy technicznej w trybie offline

Identyfikator zasad płatności
paymentPolicyId string

Unikatowy identyfikator przypisany do serwisu eBay dla zasad biznesowych płatności.

Uzyskiwanie zasad realizacji

Ta metoda pobiera wszystkie zasady realizacji skonfigurowane dla platformy handlowej określonej przy użyciu parametru zapytania marketplace_id.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator witryny Marketplace
marketplace_id True string

Identyfikator witryny Marketplace serwisu eBay zasad, które chcesz pobrać.

Zwraca

Nazwa Ścieżka Typ Opis
fulfillmentPolicies
fulfillmentPolicies array of object

Lista zasad realizacji sprzedawcy zdefiniowanych dla określonej platformy handlowej.

Typy kategorii
fulfillmentPolicies.categoryTypes array of object

Ten kontener wskazuje, czy zasady realizacji mają zastosowanie do list pojazdów motorowych, czy innych niż silnik.

nazwa
fulfillmentPolicies.categoryTypes.name string

Typ kategorii, do którego mają zastosowanie zasady

Description
fulfillmentPolicies.description string

Zdefiniowany przez sprzedawcę opis zasad realizacji.

Wysyłka frachtowa
fulfillmentPolicies.freightShipping boolean

Jeśli zostanie zwrócona wartość true, sprzedawca oferuje wysyłkę frachtową dla dużych przedmiotów powyżej 150 funtów.

Identyfikator zasad realizacji
fulfillmentPolicies.fulfillmentPolicyId string

Unikatowy identyfikator przypisany do serwisu eBay dla zasad realizacji.

Globalna wysyłka
fulfillmentPolicies.globalShipping boolean

Jeśli zostanie zwrócona wartość true, globalny program wysyłkowy serwisu eBay będzie używany przez sprzedawcę do wysyłania przedmiotów do lokalizacji międzynarodowych.

Unit
fulfillmentPolicies.handlingTime.unit string

Jednostka miary czasu, taka jak DZIEŃ.

Wartość
fulfillmentPolicies.handlingTime.value integer

Wartość jednostki miary czasu określona w polu jednostki.

Odbiór lokalny
fulfillmentPolicies.localPickup boolean

Jeśli zostanie zwrócona wartość true, odbiór lokalny jest dostępny dla tych zasad.

Identyfikator witryny Marketplace
fulfillmentPolicies.marketplaceId string

Identyfikator witryny marketplace serwisu eBay, do której mają zastosowanie te zasady realizacji.

Name
fulfillmentPolicies.name string

Nazwa zdefiniowana przez sprzedawcę dla tych zasad realizacji. Nazwy muszą być unikatowe dla zasad przypisanych do tej samej platformy handlowej.

Odbiór — odejścia
fulfillmentPolicies.pickupDropOff boolean

Jeśli zostanie zwrócona wartość true, sprzedawca oferuje opcję "Kliknij i zbierz".

shippingOptions
fulfillmentPolicies.shippingOptions array of object

Tablica zawiera szczegółowe informacje na temat krajowych i międzynarodowych opcji wysyłki dostępnych dla zasad.

Typ kosztu
fulfillmentPolicies.shippingOptions.costType string

To pole określa, czy model kosztów wysyłki jest FLAT_RATE, czy CALCULATED

Waluta
fulfillmentPolicies.shippingOptions.insuranceFee.currency string

Waluta podstawowa zastosowana do pola wartości w celu ustanowienia kwoty pieniężnej.

Wartość
fulfillmentPolicies.shippingOptions.insuranceFee.value string

Kwota pieniężna w określonej walucie.

optionType
fulfillmentPolicies.shippingOptions.optionType string

optionType

waluta
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency string

waluta

value
fulfillmentPolicies.shippingOptions.packageHandlingCost.value string

value

rateTableId
fulfillmentPolicies.shippingOptions.rateTableId string

rateTableId

shippingServices
fulfillmentPolicies.shippingOptions.shippingServices array of object

shippingServices

waluta
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency string

waluta

value
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value string

value

buyerResponsibleForPickup
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup boolean

buyerResponsibleForPickup

buyerResponsibleForShipping
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping boolean

buyerResponsibleForShipping

waluta
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency string

waluta

value
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value string

value

freeShipping
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping boolean

freeShipping

shippingCarrierCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode string

shippingCarrierCode

waluta
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency string

waluta

value
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.value string

value

shippingServiceCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingServiceCode string

shippingServiceCode

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

regionExcluded

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

nazwa_regionu

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

regionType

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

regionIncluded

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

nazwa_regionu

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

regionType

sortOrder
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder integer

sortOrder

waluta
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency string

waluta

value
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value string

value

Wykluczony region
fulfillmentPolicies.shipToLocations.regionExcluded array of object

Tablica wartości regionName, które określają obszary, w których sprzedawca nie wysyła.

nazwa_regionu
fulfillmentPolicies.shipToLocations.regionExcluded.regionName string

nazwa_regionu

regionType
fulfillmentPolicies.shipToLocations.regionExcluded.regionType string

regionType

Uwzględniony region
fulfillmentPolicies.shipToLocations.regionIncluded array of object

Tablica pól regionName określających obszary, w których sprzedawca jest dostarczany.

nazwa_regionu
fulfillmentPolicies.shipToLocations.regionIncluded.regionName string

nazwa_regionu

regionType
fulfillmentPolicies.shipToLocations.regionIncluded.regionType string

regionType

Href
href string

To pole jest przeznaczone do użytku w przyszłości.

Ograniczenie
limit integer

To pole jest przeznaczone do użytku w przyszłości.

Next
next string

To pole jest przeznaczone do użytku w przyszłości.

Przesunięcie
offset integer

To pole jest przeznaczone do użytku w przyszłości.

Poprzedni
prev string

To pole jest przeznaczone do użytku w przyszłości.

Total
total integer

Łączna liczba zasad realizacji pobranych w zestawie wyników.

Uzyskiwanie zasad warunku elementu

Ta metoda zwraca metadane warunku elementu w jednej, wielu lub wszystkich kategoriach serwisu eBay na platformie handlowej w serwisie eBay.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator witryny Marketplace
marketplace_id True string

Identyfikator witryny Marketplace serwisu eBay, dla którego są pobierane informacje o zasadach.

Filter
filter string

Ogranicza odpowiedź, zwracając informacje o zasadach tylko dla wybranych sekcji drzewa kategorii.

Zwraca

Nazwa Ścieżka Typ Opis
itemConditionPolicies
itemConditionPolicies array of object

Lista identyfikatorów kategorii i zasad dotyczących sposobu wskazywania warunku elementu w każdej z wymienionych kategorii.

Identyfikator kategorii
itemConditionPolicies.categoryId string

Identyfikator kategorii, do którego mają zastosowanie zasady warunku elementu.

Identyfikator drzewa kategorii
itemConditionPolicies.categoryTreeId string

Wartość wskazująca węzeł główny drzewa kategorii używanego dla zestawu odpowiedzi.

Wymagany warunek elementu
itemConditionPolicies.itemConditionRequired boolean

Ta flaga określa, czy należy wyświetlić warunek elementu na liście dla określonej kategorii.

itemWarunki
itemConditionPolicies.itemConditions array of object

Wartości warunku elementu dozwolone w kategorii.

conditionDescription
itemConditionPolicies.itemConditions.conditionDescription string

Czytelna dla człowieka etykieta warunku.

conditionId
itemConditionPolicies.itemConditions.conditionId string

Wartość identyfikatora wybranego warunku elementu.

użycie
itemConditionPolicies.itemConditions.usage string

użycie

Ostrzeżenia
warnings array of object

Lista ostrzeżeń wygenerowanych w wyniku żądania.

Kategoria
warnings.category string

Typ kategorii dla tego błędu lub ostrzeżenia.

Domena
warnings.domain string

Nazwa domeny zawierająca usługę lub aplikację.

Identyfikator błędu
warnings.errorId integer

Dodatnia liczba całkowita, która jednoznacznie identyfikuje określony warunek błędu, który wystąpił.

inputRefIds
warnings.inputRefIds array of string

Identyfikuje określone elementy żądania skojarzone z błędem, jeśli istnieją. Odpowiedź inputRefId jest specyficzna dla formatu.

Długa wiadomość
warnings.longMessage string

Rozszerzona wersja komunikatu, która powinna mieć długość od 100 do 200 znaków, ale nie jest wymagana.

Message
warnings.message string

Niezależny od użytkownika końcowego i aplikacji komunikat przyjazny dla deweloperów urządzeń.

outputRefIds
warnings.outputRefIds array of string

Identyfikuje określone elementy odpowiedzi skojarzone z błędem, jeśli istnieją.

parameters
warnings.parameters array of object

Różne komunikaty ostrzegawcze i komunikaty o błędach zwracają co najmniej jedną zmienną zawierającą kontekstowe informacje o błędzie lub ostrzeżeniu.

nazwa
warnings.parameters.name string

nazwa

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nazwa podsystemu lub poddziału domeny.

Uzyskiwanie zasad zwrotu

Ta metoda pobiera wszystkie zasady zwracane skonfigurowane dla platformy handlowej określonej przy użyciu parametru zapytania marketplace_id.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator witryny Marketplace
marketplace_id True string

Identyfikator witryny Marketplace serwisu eBay zasad, które chcesz pobrać.

Zwraca

Nazwa Ścieżka Typ Opis
Href
href string

To pole jest przeznaczone do użytku w przyszłości.

Ograniczenie
limit integer

To pole jest przeznaczone do użytku w przyszłości.

Next
next string

To pole jest przeznaczone do użytku w przyszłości.

Przesunięcie
offset integer

To pole jest przeznaczone do użytku w przyszłości.

Poprzedni
prev string

To pole jest przeznaczone do użytku w przyszłości.

returnPolicies
returnPolicies array of object

Lista zasad biznesowych zwrotu sprzedawcy zdefiniowanych dla określonej platformy handlowej.

categoryTypes
returnPolicies.categoryTypes array of object

Ten kontener wskazuje, do której grupy kategorii mają zastosowanie zasady powrotu.

nazwa
returnPolicies.categoryTypes.name string

nazwa

Description
returnPolicies.description string

Zdefiniowany przez sprzedawcę opis zasad biznesowych zwrotu.

Return, metoda
returnPolicies.internationalOverride.returnMethod string

To pole ustawia/wskazuje, czy sprzedawca oferuje nabywcy przedmioty zastępcze w przypadku zwrotu międzynarodowego.

Unit
returnPolicies.internationalOverride.returnPeriod.unit string

Te wartości wyliczenia reprezentują jednostkę miary czasu, taką jak DAY.

Wartość
returnPolicies.internationalOverride.returnPeriod.value integer

Jednostka miary czasu, taka jak DZIEŃ.

Zwraca zaakceptowane
returnPolicies.internationalOverride.returnsAccepted boolean

W przypadku ustawienia wartości true sprzedawca akceptuje międzynarodowe zwroty.

Zwrot kosztu wysyłki płatnika
returnPolicies.internationalOverride.returnShippingCostPayer string

To pole wskazuje, kto jest odpowiedzialny za płacenie za opłaty za wysyłkę za zwrócone przedmioty.

Identyfikator witryny Marketplace
returnPolicies.marketplaceId string

Identyfikator witryny Marketplace serwisu eBay, do którego mają zastosowanie te zasady dotyczące zwrotu.

Name
returnPolicies.name string

Nazwa zdefiniowana przez sprzedawcę dla tych zasad biznesowych płatności.

Metoda zwrotu pieniędzy
returnPolicies.refundMethod string

Jeśli sprzedawca wskaże, że zaakceptuje zwroty kupującego, ta wartość zostanie ustawiona na MONEY_BACK.

Instrukcje powrotu
returnPolicies.returnInstructions string

To pole tekstowe zawiera więcej szczegółów na temat instrukcji zwrotnych określonych przez sprzedawcę.

Return, metoda
returnPolicies.returnMethod string

To pole jest zwracane tylko wtedy, gdy sprzedawca jest gotów zaoferować przedmiot zastępczy jako alternatywę dla "Money Back".

Unit
returnPolicies.returnPeriod.unit string

Jednostka miary czasu, taka jak DZIEŃ.

Wartość
returnPolicies.returnPeriod.value integer

Wartość jednostki miary czasu określona w polu jednostki.

Identyfikator zasad zwracanych
returnPolicies.returnPolicyId string

Unikatowy identyfikator przypisany do serwisu eBay dla zasad biznesowych zwrotu.

Zwracanie zaakceptowane
returnPolicies.returnsAccepted boolean

Jeśli to pole jest zwracane jako true, sprzedawca akceptuje zwroty.

Zwrot kosztu wysyłki płatnika
returnPolicies.returnShippingCostPayer string

To pole wskazuje, kto jest odpowiedzialny za płacenie za opłaty za wysyłkę za zwrócone przedmioty.

Total
total integer

Łączna liczba zwracanych zasad biznesowych pobranych w zestawie wyników.

Wycofuj ofertę

To wywołanie służy do kończenia pojedynczej listy odmian skojarzonej z określoną ofertą.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator oferty
offerId True string

Unikatowy identyfikator oferty, która ma zostać wycofana.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator listy
listingId string

Unikatowy identyfikator aukcji w serwisie eBay skojarzony z ofertą, która została wycofana.

Ostrzeżenia
warnings array of object

Ten kontener zostanie zwrócony, jeśli wystąpił co najmniej jedno ostrzeżenie skojarzone z próbą wycofania oferty.

Kategoria
warnings.category string

Ta wartość ciągu wskazuje kategorię błędów

Domena
warnings.domain string

Ta wartość ciągu wskazuje kategorię błędów

Identyfikator błędu
warnings.errorId integer

Unikatowy kod identyfikujący konkretny błąd lub ostrzeżenie, które wystąpiło.

inputRefIds
warnings.inputRefIds array of string

Tablica z co najmniej jednym identyfikatorem odwołania, które identyfikują określone elementy żądania najbardziej powiązane z błędem lub ostrzeżeniem, jeśli istnieją.

Długa wiadomość
warnings.longMessage string

Szczegółowy opis warunku, który spowodował błąd lub ostrzeżenie, oraz informacje o tym, co należy zrobić, aby rozwiązać problem.

Message
warnings.message string

Opis warunku, który spowodował błąd lub ostrzeżenie.

outputRefIds
warnings.outputRefIds array of string

Ten kontener zostanie zwrócony, jeśli wystąpił co najmniej jedno ostrzeżenie skojarzone z próbą wycofania oferty.

parameters
warnings.parameters array of object

Różne komunikaty ostrzegawcze i komunikaty o błędach zwracają co najmniej jedną zmienną zawierającą kontekstowe informacje o błędzie lub waringu.

nazwa
warnings.parameters.name string

nazwa

value
warnings.parameters.value string

value

Subdomain
warnings.subdomain string

Nazwa poddomeny, w której wystąpił błąd lub ostrzeżenie.

Definicje

ciąg

Jest to podstawowy typ danych "string".