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 |
| 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".