eBay (независимый издатель) (предварительная версия)
eBay является американской многонациональной компанией электронной коммерции, которая упрощает потребительские и бизнес-продажи на потребитель через свой веб-сайт.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Artesian Software Technologies LLP |
| URL | https://artesian.io |
| Адрес электронной почты | amit.sharma@artesian.io |
| Метаданные соединителя | |
|---|---|
| Publisher | Artesian Software Technologies LLP |
| Веб-сайт | https://www.ebay.com/ |
| Privacy Policy (Политика конфиденциальности) | https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260 |
| Категории | Торговля; Продажи и CRM |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Идентификатор клиента — ваш идентификатор клиента eBay | струна | Введите идентификатор клиента. | True |
| Секрет клиента | securestring | Введите секрет клиента. | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Обновление предложения |
Этот вызов обновляет существующее предложение, которое может быть опубликовано или в неопубликованном состоянии. |
| Отзыв предложения |
Этот вызов используется для завершения одно вариантного описания, связанного с указанным предложением. |
|
Получение tree |
В данной платформе eBay может использоваться несколько деревьев категорий, но одно из этих деревьев считается стандартным для этого marketplace. Этот вызов извлекает ссылку на дерево категорий по умолчанию, связанное с указанным идентификатором eBay marketplace. |
| Получение аспектов элемента для категории |
Этот вызов возвращает список аспектов, подходящих или необходимых для точного описания элементов в указанной конечной категории. Каждый аспект идентифицирует атрибут элемента (например, цвет), для которого продавцу потребуется или рекомендуется предоставить значение (или значения вариантов) при предложении элемента в этой категории на eBay. |
| Получение политик возврата |
Этот метод извлекает все политики возврата, настроенные для Marketplace, с помощью параметра запроса marketplace_id. |
| Получение политик выполнения |
Этот метод извлекает все политики выполнения, настроенные для Marketplace, с помощью параметра запроса marketplace_id. |
| Получение политик оплаты |
Этот метод извлекает все политики оплаты, настроенные для Marketplace, с помощью параметра запроса marketplace_id. |
| Получение политик условий элементов |
Этот метод возвращает метаданные условия элемента в одном, нескольких или всех категориях eBay на платформе eBay. |
| Получение политики возврата |
Этот метод извлекает полные сведения о политике возврата, указанной параметром пути returnPolicyId. |
| Получение политики выполнения |
Этот метод извлекает полные сведения о политике выполнения. Укажите идентификатор политики, которую требуется получить с помощью параметра пути fulfillmentPolicyId. |
| Получение политики оплаты |
Этот метод получает полные сведения о политике оплаты. Укажите идентификатор политики, которую вы хотите получить с помощью параметра пути paymentPolicyId. |
| Получение предложений категорий |
Этот вызов возвращает массив конечных узлов дерева категорий в указанном дереве категорий, которые считаются eBay наиболее тесно соответствуют запросу. |
| Получение расположений инвентаризации |
Этот вызов извлекает все определенные сведения для каждого расположения инвентаризации, связанного с учетной записью продавца. |
| Получение расположения инвентаризации |
Этот вызов извлекает все определенные сведения о расположении инвентаризации, заданном параметром пути merchantLocationKey. |
| Получение элементов инвентаризации |
Этот вызов извлекает все записи инвентаризации, определенные для учетной записи продавца. |
| Предложение GET |
Этот вызов извлекает определенное опубликованное или неопубликованное предложение. |
| Предложения GET |
Этот вызов извлекает все существующие предложения для указанного значения SKU. Продавец имеет возможность ограничить предложения, которые извлекаются на определенный рынок eBay, или в формат списка. |
| Публикация предложения |
Этот вызов используется для преобразования неопубликованного предложения в опубликованное предложение или динамического списка eBay. Уникальный идентификатор предложения (offerId) передается в конце URI вызова. |
| Создание или замена элемента инвентаризации |
Этот вызов создает новую запись элемента инвентаризации или заменяет существующую запись элемента инвентаризации. |
| Создание предложения |
Этот вызов создает предложение для определенного элемента инвентаризации на определенной платформе eBay. |
| Создание расположения инвентаризации |
Используйте этот вызов для создания нового расположения инвентаризации. Чтобы создать и опубликовать предложение, продавец должен иметь одно расположение инвентаризации, так как каждое предложение должно быть связано с расположением. |
| Удаление предложения |
Этот вызов окончательно удаляет предложение. |
| Элемент инвентаризации GET |
Этот вызов извлекает запись элемента инвентаризации для заданного номера SKU. |
Обновление предложения
Этот вызов обновляет существующее предложение, которое может быть опубликовано или в неопубликованном состоянии.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор предложения
|
offerId | True | string |
Уникальный идентификатор предложения, который требуется обновить. |
|
Доступное количество
|
availableQuantity | integer |
Доступное количество запасов для покупки. |
|
|
Идентификатор категории
|
categoryId | string |
Идентификатор категории eBay Unique, в который будет указан продукт. |
|
|
Идентификатор благотворительности
|
charityId | string |
Присвоенный eBay уникальный идентификатор благотворительной организации, которая получит процент выручки от продаж. |
|
|
Процент пожертвований
|
donationPercentage | string |
Процент цены покупки, который благотворительная организация получит для каждой продажи, которая создает список. |
|
|
Идентификатор продукта производителя
|
producerProductId | string |
Уникальный идентификатор производителя, связанного с элементом. |
|
|
Идентификатор пакета продукта
|
productPackageId | string |
Уникальный идентификатор производителя упаковки продукта, добавленного продавцом. |
|
|
Идентификатор пакета отправки
|
shipmentPackageId | string |
Уникальный идентификатор производителя любой упаковки, используемой продавцом для доставки товара. |
|
|
Идентификатор документации по продукту
|
productDocumentationId | string |
Уникальный идентификатор производителя любой бумаги, добавленной в посылку товара продавцом. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Скрытие сведений о покупателе
|
hideBuyerDetails | boolean |
Это поле включается, если продавец хочет создать частный листинг. |
|
|
Включение сведений о продукте каталога
|
includeCatalogProductDetails | boolean |
Указывает, применяются ли сведения о каталоге продуктов eBay к списку. |
|
|
Описание описания
|
listingDescription | string |
Описание списка eBay. |
|
|
Длительность перечисления
|
listingDuration | string |
Количество дней, в которые будет активное описание. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Лучшее предложение включено
|
bestOfferEnabled | boolean |
Указывает, включена ли функция "Лучшее предложение" для перечисления. |
|
|
eBay Plus, если это допустимо
|
eBayPlusIfEligible | boolean |
Это поле включается в предложение, если продавец Top-Rated будет включен в программу eBay Plus. |
|
|
Идентификатор политики выполнения
|
fulfillmentPolicyId | string |
Уникальный идентификатор указывает бизнес-политику выполнения, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
|
Идентификатор политики оплаты
|
paymentPolicyId | string |
Уникальный идентификатор указывает политику оплаты, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
|
Идентификаторы политики соответствия продукта
|
productCompliancePolicyIds | array of string |
Это поле содержит массив до пяти идентификаторов, указывающих продавцу созданные политики соответствия для перечисления. |
|
|
Идентификатор политики возврата
|
returnPolicyId | string |
Возврат уникального идентификатора бизнес-политики, который будет использоваться после публикации предложения и преобразования в список eBay. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Priority
|
priority | integer |
Целочисленное значение, входное в это поле, а также значение shippingServiceType, задает параметр внутренней или международной службы доставки в политике выполнения будет изменен с обновленными затратами на доставку. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Тип службы
|
shippingServiceType | string |
Это значение указывает, является ли служба доставки, указанная в поле приоритета, является внутренней или международной службой доставки. |
|
|
Возврат идентификатора политики
|
takeBackPolicyId | string |
Идентификатор продавца, создавший политику возврата. |
|
|
Дата начала перечисления
|
listingStartDate | string |
Это поле можно использовать, если продавец хочет указать время в будущем, что листинг станет активным на eBay. |
|
|
Размер лота
|
lotSize | integer |
Это поле применимо только в том случае, если список является большим списком. Целочисленное значение, переданное в это поле, — общее количество элементов в лоте. |
|
|
Ключ расположения продавца
|
merchantLocationKey | string |
Уникальный идентификатор расположения инвентаризации торговца |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Первоначально продано для розничной цены на
|
originallySoldForRetailPriceOn | string |
Это поле необходимо, если в предложении будет использоваться функция "Цены на забастовку". Это поле указывает, что продукт был продан по цене в исходном поле RetailPrice на сайте eBay или продан за эту цену сторонним розничным торговцем |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Видимость цен
|
pricingVisibility | string |
Это поле необходимо, если функция минимально объявленной цены будет использоваться в предложении. |
|
|
Ограничение количества на покупателя
|
quantityLimitPerBuyer | integer |
Это поле применимо только в том случае, если продавец хочет установить ограничение на количество покупок на продавца. |
|
|
Идентификатор вторичной категории
|
secondaryCategoryId | string |
Уникальный идентификатор вторичной категории и применимый, если продавец решит перечислить элемент под двумя категориями. |
|
|
Хранение имен категорий
|
storeCategoryNames | array of string |
Хранение имен категорий |
|
|
Применение налога
|
applyTax | boolean |
Этот контейнер применяется только в том случае, если к предложению будет применена таблица налога на продажу, ставка налога Value-Added или код категории налоговых исключений. |
|
|
Категория налога стороннего производителя
|
thirdPartyTaxCategory | string |
Код категории налоговых исключений. Если это поле используется, налог на продажу также будет применяться к службе или сбору, а не только цене товара. |
|
|
Процент НДС
|
vatPercentage | number |
Это значение является ставкой НДС для элемента, если таковой имеется. Если указан процент НДС, на странице представления элемента отображается информация о НДС элемента. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор предложения
|
offerId | string |
Уникальный идентификатор предложения |
|
Предупреждения
|
warnings | array of object |
Этот контейнер возвращается при вызове и ошибках и /или предупреждениях. |
|
Категория
|
warnings.category | string |
Это строковое значение указывает категорию ошибок |
|
Домен
|
warnings.domain | string |
Доменное имя, в котором произошла ошибка или предупреждение. |
|
Идентификатор ошибки
|
warnings.errorId | integer |
Уникальный код, определяющий конкретную ошибку или предупреждение, которое произошло. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Массив одного или нескольких ссылочных идентификаторов, определяющих наиболее тесно связанные с ошибкой или предупреждением определенные элементы запроса. |
|
Длинное сообщение
|
warnings.longMessage | string |
Подробное описание условия, вызвавшего ошибку или предупреждение, и сведения о том, что делать для исправления проблемы. |
|
Message
|
warnings.message | string |
Описание условия, вызвавшего ошибку или предупреждение. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Массив одного или нескольких ссылочных идентификаторов, определяющих наиболее тесно связанные с ошибкой или предупреждением определенные элементы ответа. |
|
parameters
|
warnings.parameters | array of object |
Различные предупреждения и сообщения об ошибках возвращают одну или несколько переменных, содержащих контекстные сведения об ошибке или предупреждении. |
|
имя
|
warnings.parameters.name | string |
имя |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
Имя поддомена, в котором произошла ошибка или предупреждение. |
Отзыв предложения
Этот вызов используется для завершения одно вариантного описания, связанного с указанным предложением.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор предложения
|
offerId | True | string |
Уникальный идентификатор предложения, который требуется отозвать. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор перечисления
|
listingId | string |
Уникальный идентификатор описания eBay, связанного с предложением, которое было снято. |
|
Предупреждения
|
warnings | array of object |
Этот контейнер будет возвращен, если было одно или несколько предупреждений, связанных с попыткой отозвать предложение. |
|
Категория
|
warnings.category | string |
Это строковое значение указывает категорию ошибок |
|
Домен
|
warnings.domain | string |
Это строковое значение указывает категорию ошибок |
|
Идентификатор ошибки
|
warnings.errorId | integer |
Уникальный код, определяющий определенную ошибку или предупреждение, которое произошло. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Массив одного или нескольких ссылочных идентификаторов, определяющих наиболее тесно связанные с ошибкой или предупреждением определенные элементы запроса. |
|
Длинное сообщение
|
warnings.longMessage | string |
Подробное описание условия, вызвавшего ошибку или предупреждение, и сведения о том, что делать для исправления проблемы. |
|
Message
|
warnings.message | string |
Описание условия, вызвавшего ошибку или предупреждение. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Этот контейнер будет возвращен, если было одно или несколько предупреждений, связанных с попыткой отозвать предложение. |
|
parameters
|
warnings.parameters | array of object |
Различные предупреждения и сообщения об ошибках возвращают одну или несколько переменных, которые содержат контекстные сведения об ошибке или борьбе. |
|
имя
|
warnings.parameters.name | string |
имя |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
Имя поддомена, в котором произошла ошибка или предупреждение. |
Получение treeId категории по умолчанию
В данной платформе eBay может использоваться несколько деревьев категорий, но одно из этих деревьев считается стандартным для этого marketplace. Этот вызов извлекает ссылку на дерево категорий по умолчанию, связанное с указанным идентификатором eBay marketplace.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор Marketplace
|
marketplace_id | True | string |
Идентификатор eBay marketplace, для которого запрашивается идентификатор дерева категорий. |
|
Accept-Language
|
Accept-Language | True | string |
Заголовок, используемый для указания естественного языка, который продавец предпочитает ответ. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор дерева категорий
|
categoryTreeId | string |
Идентификатор дерева уникальных категорий eBay для указанного marketplace. |
|
Версия дерева категорий
|
categoryTreeVersion | string |
Версия дерева категорий, определяемая categoryTreeId. |
Получение аспектов элемента для категории
Этот вызов возвращает список аспектов, подходящих или необходимых для точного описания элементов в указанной конечной категории. Каждый аспект идентифицирует атрибут элемента (например, цвет), для которого продавцу потребуется или рекомендуется предоставить значение (или значения вариантов) при предложении элемента в этой категории на eBay.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор дерева категорий
|
category_tree_id | True | string |
Дерево категорий eBay — уникальный идентификатор, из которого запрашиваются аспекты указанной категории. |
|
Идентификатор категории
|
category_id | True | string |
Уникальный идентификатор конечной категории, для которого запрашиваются аспекты. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
перспектива
|
aspects | array of object |
Список аспектов элементов, подходящих для описания элементов в определенной конечной категории |
|
Аспект, применимый к
|
aspects.aspectConstraint.aspectApplicableTo | array of string |
Это значение указывает, является ли аспект, определенный полем aspects.localizedAspectName, является аспектом продукта или элементом или экземпляром, который является аспектом, значение которого зависит от конкретного экземпляра продукта. |
|
Тип данных аспектов
|
aspects.aspectConstraint.aspectDataType | string |
Тип данных аспектов. |
|
Аспект включен для вариантов
|
aspects.aspectConstraint.aspectEnabledForVariations | boolean |
Значение true указывает, что этот аспект можно использовать для выявления вариантов элементов. |
|
Формат аспектов
|
aspects.aspectConstraint.aspectFormat | string |
Возвращается только в том случае, если значение aspectDataType определяет тип данных, требующий определенного форматирования. |
|
Максимальная длина аспектов
|
aspects.aspectConstraint.aspectMaxLength | integer |
Максимальная длина значения элемента. |
|
Режим аспектов
|
aspects.aspectConstraint.aspectMode | string |
Способ, в котором значения этого аспекта должны быть указаны продавцом. |
|
Обязательный аспект
|
aspects.aspectConstraint.aspectRequired | boolean |
Значение true указывает, что этот аспект необходим при предложении элементов в указанной категории. |
|
Использование аспектов
|
aspects.aspectConstraint.aspectUsage | string |
Значение указывает, рекомендуется ли использовать соответствующий аспект или необязательно. |
|
Ожидаемое требование к дате
|
aspects.aspectConstraint.expectedRequiredByDate | string |
Ожидаемая дата, после которой потребуется аспект. |
|
Элемент к кратности аспектов
|
aspects.aspectConstraint.itemToAspectCardinality | string |
Указывает, может ли этот аспект принимать одно или несколько значений для элементов в указанной категории. |
|
aspectValues
|
aspects.aspectValues | array of object |
Список допустимых значений вместе с любыми ограничениями для этого аспекта. |
|
localizedValue
|
aspects.aspectValues.localizedValue | string |
Локализованное значение этого аспекта. |
|
valueConstraints
|
aspects.aspectValues.valueConstraints | array of object |
Содержит список зависимостей, определяющих, когда значение поля localizedValue доступно для текущего аспекта. |
|
applicableForLocalizedAspectName
|
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName | string |
Имя элемента управления, от которого зависит текущее значение аспекта. |
|
applicableForLocalizedAspectValues
|
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues | array of string |
Содержит список значений элемента управления, от которого зависит значение этого аспекта. |
|
Локализованное имя аспекта
|
aspects.localizedAspectName | string |
Локализованное имя этого аспекта. |
|
Количество поисковых запросов
|
aspects.relevanceIndicator.searchCount | integer |
Количество последних поисков аспектов. |
Получение политик возврата
Этот метод извлекает все политики возврата, настроенные для Marketplace, с помощью параметра запроса marketplace_id.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор Marketplace
|
marketplace_id | True | string |
Идентификатор eBay marketplace политики, которую вы хотите получить. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Href
|
href | string |
Это поле предназначено для дальнейшего использования. |
|
Лимит
|
limit | integer |
Это поле предназначено для дальнейшего использования. |
|
Next
|
next | string |
Это поле предназначено для дальнейшего использования. |
|
Смещение
|
offset | integer |
Это поле предназначено для дальнейшего использования. |
|
Предыдущая
|
prev | string |
Это поле предназначено для дальнейшего использования. |
|
returnPolicies
|
returnPolicies | array of object |
Список возвращаемых бизнес-политик продавца, определенных для указанной платформы. |
|
categoryTypes
|
returnPolicies.categoryTypes | array of object |
Этот контейнер указывает, к какой группе категорий применяется политика возврата. |
|
имя
|
returnPolicies.categoryTypes.name | string |
имя |
|
Description
|
returnPolicies.description | string |
Определенное продавцом описание возвращаемой бизнес-политики. |
|
Метод Return
|
returnPolicies.internationalOverride.returnMethod | string |
Это поле задает или указывает, предлагает ли продавец заменяющие товары покупателю в случае международного возврата. |
|
Единица
|
returnPolicies.internationalOverride.returnPeriod.unit | string |
Эти значения перечисления представляют единицу измерения времени, например DAY. |
|
Ценность
|
returnPolicies.internationalOverride.returnPeriod.value | integer |
Единица измерения времени, например DAY. |
|
Возвращает принятые
|
returnPolicies.internationalOverride.returnsAccepted | boolean |
Если задано значение true, продавец принимает международные возвраты. |
|
Возврат оплаты стоимости доставки
|
returnPolicies.internationalOverride.returnShippingCostPayer | string |
Это поле указывает, кто несет ответственность за оплату расходов на доставку возвращаемых товаров. |
|
Идентификатор Marketplace
|
returnPolicies.marketplaceId | string |
Идентификатор eBay marketplace, к которому применяется эта возвращаемая бизнес-политика. |
|
Имя
|
returnPolicies.name | string |
Определенное продавцом имя для этой бизнес-политики оплаты. |
|
Метод возврата средств
|
returnPolicies.refundMethod | string |
Если продавец указывает, что он примет возврат покупателя, это значение будет установлено на MONEY_BACK. |
|
Инструкции по возврату
|
returnPolicies.returnInstructions | string |
Это текстовое поле содержит дополнительные сведения о инструкциях возврата, указанных продавцом. |
|
Метод Return
|
returnPolicies.returnMethod | string |
Это поле возвращается только в том случае, если продавец готов предложить замещающий элемент в качестве альтернативы "Деньги назад". |
|
Единица
|
returnPolicies.returnPeriod.unit | string |
Единица измерения времени, например DAY. |
|
Ценность
|
returnPolicies.returnPeriod.value | integer |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Идентификатор политики возврата
|
returnPolicies.returnPolicyId | string |
Уникальный идентификатор, назначенный eBay для возвращаемой бизнес-политики. |
|
Возвращаемый принятый
|
returnPolicies.returnsAccepted | boolean |
Если это поле возвращается как true, продавец принимает возврат. |
|
Возврат оплаты стоимости доставки
|
returnPolicies.returnShippingCostPayer | string |
Это поле указывает, кто несет ответственность за оплату расходов на доставку возвращаемых товаров. |
|
Total
|
total | integer |
Общее количество возвращаемых бизнес-политик, полученных в результирующем наборе. |
Получение политик выполнения
Этот метод извлекает все политики выполнения, настроенные для Marketplace, с помощью параметра запроса marketplace_id.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор Marketplace
|
marketplace_id | True | string |
Идентификатор eBay marketplace политик, которые требуется получить. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
fulfillmentPolicies
|
fulfillmentPolicies | array of object |
Список политик выполнения продавца, определенных для указанной платформы. |
|
Типы категорий
|
fulfillmentPolicies.categoryTypes | array of object |
Этот контейнер указывает, применяется ли политика выполнения к спискам автомобилей, не являющихся автомобилими. |
|
имя
|
fulfillmentPolicies.categoryTypes.name | string |
Тип категории, к которому применяется политика |
|
Description
|
fulfillmentPolicies.description | string |
Определенное продавцом описание политики выполнения. |
|
Грузоперевозка
|
fulfillmentPolicies.freightShipping | boolean |
Если он возвращается как true, продавец предлагает доставку грузов для больших товаров более 150 фунтов. |
|
Идентификатор политики выполнения
|
fulfillmentPolicies.fulfillmentPolicyId | string |
Уникальный идентификатор, назначенный eBay для политики выполнения. |
|
Глобальная доставка
|
fulfillmentPolicies.globalShipping | boolean |
Если он возвращается как true, программа глобальной доставки eBay будет использоваться продавцом для отправки товаров в международные расположения. |
|
Единица
|
fulfillmentPolicies.handlingTime.unit | string |
Единица измерения времени, например DAY. |
|
Ценность
|
fulfillmentPolicies.handlingTime.value | integer |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Локальный сбор
|
fulfillmentPolicies.localPickup | boolean |
Если возвращается значение true, для этой политики доступен локальный сбор. |
|
Идентификатор Marketplace
|
fulfillmentPolicies.marketplaceId | string |
Идентификатор платформы eBay, к которой применяется эта политика выполнения. |
|
Имя
|
fulfillmentPolicies.name | string |
Определенное продавцом имя для этой политики выполнения. Имена должны быть уникальными для политик, назначенных той же marketplace. |
|
Раскрывающийся список пикап
|
fulfillmentPolicies.pickupDropOff | boolean |
Если возвращается значение true, продавец предлагает параметр "Щелкнуть и собрать". |
|
shippingOptions
|
fulfillmentPolicies.shippingOptions | array of object |
В массиве содержатся подробные сведения о вариантах внутреннего и международного доставки, доступных для политики. |
|
Тип затрат
|
fulfillmentPolicies.shippingOptions.costType | string |
Это поле определяет, является ли модель затрат на доставку FLAT_RATE или ВЫЧИСЛЯЕМой |
|
Валюта
|
fulfillmentPolicies.shippingOptions.insuranceFee.currency | string |
Базовая валюта, применяемая к полю значения для установления денежной суммы. |
|
Ценность
|
fulfillmentPolicies.shippingOptions.insuranceFee.value | string |
Денежный объем в указанной валюте. |
|
optionType
|
fulfillmentPolicies.shippingOptions.optionType | string |
optionType |
|
currency
|
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency | string |
currency |
|
value
|
fulfillmentPolicies.shippingOptions.packageHandlingCost.value | string |
value |
|
rateTableId
|
fulfillmentPolicies.shippingOptions.rateTableId | string |
rateTableId |
|
shippingServices
|
fulfillmentPolicies.shippingOptions.shippingServices | array of object |
shippingServices |
|
currency
|
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency | string |
currency |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value | string |
value |
|
buyerResponsibleForPickup
|
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup | boolean |
buyerResponsibleForPickup |
|
buyerResponsibleForShipping
|
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping | boolean |
buyerResponsibleForShipping |
|
currency
|
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency | string |
currency |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value | string |
value |
|
freeShipping
|
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping | boolean |
freeShipping |
|
shippingCarrierCode
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode | string |
shippingCarrierCode |
|
currency
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency | string |
currency |
|
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 |
|
regionName
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName | string |
regionName |
|
regionType
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType | string |
regionType |
|
regionIncluded
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded | array of object |
regionIncluded |
|
regionName
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName | string |
regionName |
|
regionType
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType | string |
regionType |
|
sortOrder
|
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder | integer |
sortOrder |
|
currency
|
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency | string |
currency |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value | string |
value |
|
Исключенный регион
|
fulfillmentPolicies.shipToLocations.regionExcluded | array of object |
Массив значений regionName, указывающих области, в которые продавец не отправляется. |
|
regionName
|
fulfillmentPolicies.shipToLocations.regionExcluded.regionName | string |
regionName |
|
regionType
|
fulfillmentPolicies.shipToLocations.regionExcluded.regionType | string |
regionType |
|
Включенный регион
|
fulfillmentPolicies.shipToLocations.regionIncluded | array of object |
Массив полей regionName, указывающих области, в которые отправляется продавец. |
|
regionName
|
fulfillmentPolicies.shipToLocations.regionIncluded.regionName | string |
regionName |
|
regionType
|
fulfillmentPolicies.shipToLocations.regionIncluded.regionType | string |
regionType |
|
Href
|
href | string |
Это поле предназначено для дальнейшего использования. |
|
Лимит
|
limit | integer |
Это поле предназначено для дальнейшего использования. |
|
Next
|
next | string |
Это поле предназначено для дальнейшего использования. |
|
Смещение
|
offset | integer |
Это поле предназначено для дальнейшего использования. |
|
Предыдущая
|
prev | string |
Это поле предназначено для дальнейшего использования. |
|
Total
|
total | integer |
Общее количество политик выполнения, полученных в результирующем наборе. |
Получение политик оплаты
Этот метод извлекает все политики оплаты, настроенные для Marketplace, с помощью параметра запроса marketplace_id.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор Marketplace
|
marketplace_id | string |
Идентификатор eBay marketplace политик, которые требуется получить. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Href
|
href | string |
Это поле предназначено для дальнейшего использования. |
|
Лимит
|
limit | integer |
Это поле предназначено для дальнейшего использования. |
|
Next
|
next | string |
Это поле предназначено для дальнейшего использования. |
|
Смещение
|
offset | integer |
Это поле предназначено для дальнейшего использования. |
|
paymentPolicies
|
paymentPolicies | array of object |
Список бизнес-политик оплаты продавца, определенных для указанной платформы. |
|
categoryTypes
|
paymentPolicies.categoryTypes | array of object |
Этот контейнер указывает, применяется ли политика выполнения к спискам транспортных средств или не автомобильных транспортных средств. |
|
default
|
paymentPolicies.categoryTypes.default | boolean |
default |
|
имя
|
paymentPolicies.categoryTypes.name | string |
имя |
|
Валюта
|
paymentPolicies.deposit.amount.currency | string |
Базовая валюта, применяемая к полю значения для установления денежной суммы. |
|
Ценность
|
paymentPolicies.deposit.amount.value | string |
Денежный объем в указанной валюте. |
|
Единица
|
paymentPolicies.deposit.dueIn.unit | string |
Эти значения представляют единицу измерения времени, например DAY. |
|
Ценность
|
paymentPolicies.deposit.dueIn.value | integer |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Description
|
paymentPolicies.description | string |
Определенное продавцом описание политики оплаты. |
|
Единица
|
paymentPolicies.fullPaymentDueIn.unit | string |
Единица измерения времени, например DAY. |
|
Ценность
|
paymentPolicies.fullPaymentDueIn.value | integer |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Немедленная оплата
|
paymentPolicies.immediatePay | boolean |
Если это поле возвращается как истинное, от покупателя требуется немедленная оплата |
|
Идентификатор Marketplace
|
paymentPolicies.marketplaceId | string |
Идентификатор eBay marketplace, к которому применяется политика оплаты. |
|
Имя
|
paymentPolicies.name | string |
Определенное продавцом имя для этой политики выполнения. |
|
Платежные инструкции
|
paymentPolicies.paymentInstructions | string |
Хотя это поле может быть возвращено для некоторых старых бизнес-политик оплаты, инструкции по оплате больше не поддерживаются политиками оплаты. Если это поле возвращается, его можно игнорировать, и эти инструкции по оплате не будут отображаться в списках, использующих соответствующую бизнес-политику. |
|
методы оплаты
|
paymentPolicies.paymentMethods | array of object |
Этот контейнер возвращается для отображения методов оплаты, которые принимаются для бизнес-политики оплаты. |
|
paymentMethodType
|
paymentPolicies.paymentMethods.paymentMethodType | string |
Тип метода оплаты |
|
Идентификатор политики оплаты
|
paymentPolicies.paymentPolicyId | string |
Уникальный идентификатор, назначенный eBay для политики оплаты. |
|
Предыдущая
|
prev | string |
Это поле предназначено для дальнейшего использования. |
|
Total
|
total | integer |
Общее количество бизнес-политик оплаты, полученных в результирующем наборе. |
Получение политик условий элементов
Этот метод возвращает метаданные условия элемента в одном, нескольких или всех категориях eBay на платформе eBay.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор Marketplace
|
marketplace_id | True | string |
Идентификатор eBay marketplace, для которого извлекаются сведения о политике. |
|
Filter
|
filter | string |
Ограничивает ответ, возвращая сведения о политике только для выбранных разделов дерева категорий. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
itemConditionPolicies
|
itemConditionPolicies | array of object |
Список идентификаторов категорий и политик для указания состояния элемента в каждой из перечисленных категорий. |
|
Идентификатор категории
|
itemConditionPolicies.categoryId | string |
Идентификатор категории, к которому применяется политика условия элемента. |
|
Идентификатор дерева категорий
|
itemConditionPolicies.categoryTreeId | string |
Значение, указывающее корневой узел дерева категорий, используемого для набора ответов. |
|
Обязательное условие элемента
|
itemConditionPolicies.itemConditionRequired | boolean |
Этот флаг указывает, нужно ли указывать условие элемента в списке для указанной категории. |
|
itemConditions
|
itemConditionPolicies.itemConditions | array of object |
Значения условий элемента, разрешенные в категории. |
|
conditionDescription
|
itemConditionPolicies.itemConditions.conditionDescription | string |
Метка, читаемая человеком для условия. |
|
conditionId
|
itemConditionPolicies.itemConditions.conditionId | string |
Значение идентификатора условия выбранного элемента. |
|
использование
|
itemConditionPolicies.itemConditions.usage | string |
использование |
|
Предупреждения
|
warnings | array of object |
Список предупреждений, созданных в результате запроса. |
|
Категория
|
warnings.category | string |
Тип категории для этой ошибки или предупреждения. |
|
Домен
|
warnings.domain | string |
Доменное имя, содержащее службу или приложение. |
|
Идентификатор ошибки
|
warnings.errorId | integer |
Положительное целое число, однозначно определяющее конкретное условие ошибки, которое произошло. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Определяет определенные элементы запроса, связанные с ошибкой, если таковые есть. Ответ inputRefId имеет определенный формат. |
|
Длинное сообщение
|
warnings.longMessage | string |
Расширенная версия сообщения, которая должна составлять около 100–200 символов, но не обязательно должна быть такой. |
|
Message
|
warnings.message | string |
Понятное сообщение для пользователей и разработчиков приложений. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Определяет определенные элементы ответа, связанные с ошибкой, если таковые есть. |
|
parameters
|
warnings.parameters | array of object |
Различные предупреждения и сообщения об ошибках возвращают одну или несколько переменных, содержащих контекстные сведения об ошибке или предупреждении. |
|
имя
|
warnings.parameters.name | string |
имя |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
Имя подсистемы или подразделения домена. |
Получение политики возврата
Этот метод извлекает полные сведения о политике возврата, указанной параметром пути returnPolicyId.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор политики возврата
|
return_policy_id | True | string |
Возвращает идентификатор политики, который требуется получить. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
categoryTypes
|
categoryTypes | array of object |
Этот контейнер указывает, к какой группе категорий применяется политика возврата. |
|
Имя
|
categoryTypes.name | string |
Тип категории, к которому применяется политика |
|
Description
|
description | string |
Определенное продавцом описание возвращаемой бизнес-политики. |
|
Метод Return
|
internationalOverride.returnMethod | string |
Это поле задает или указывает, предлагает ли продавец заменяющие товары покупателю в случае международного возврата. |
|
Единица
|
internationalOverride.returnPeriod.unit | string |
Единица измерения времени, например DAY. |
|
Ценность
|
internationalOverride.returnPeriod.value | integer |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Возвращает принятые
|
internationalOverride.returnsAccepted | boolean |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Возврат оплаты стоимости доставки
|
internationalOverride.returnShippingCostPayer | string |
Это поле указывает, кто несет ответственность за оплату расходов на доставку возвращаемых товаров. |
|
Идентификатор Marketplace
|
marketplaceId | string |
Идентификатор рынка eBay, к которому применяется эта возвращаемая бизнес-политика. |
|
Имя
|
name | string |
Определенное продавцом имя для этой бизнес-политики оплаты. |
|
Метод возврата средств
|
refundMethod | string |
Если продавец указывает, что он примет возврат покупателя, это значение будет установлено на MONEY_BACK. |
|
Инструкции по возврату
|
returnInstructions | string |
Это текстовое поле содержит дополнительные сведения о инструкциях возврата, указанных продавцом. Это поле возвращается только в том случае, если задано значение для возвращаемой бизнес-политики. |
|
Метод Return
|
returnMethod | string |
Это поле возвращается только в том случае, если продавец готов предложить замещающий элемент в качестве альтернативы "Деньги назад" |
|
Единица
|
returnPeriod.unit | string |
Единица измерения времени, например DAY. |
|
Ценность
|
returnPeriod.value | integer |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Идентификатор политики возврата
|
returnPolicyId | string |
Уникальный идентификатор, назначенный eBay для возвращаемой бизнес-политики. Этот идентификатор создается при создании политики. |
|
Возвращает принятые
|
returnsAccepted | boolean |
Если это поле возвращается как true, продавец принимает возврат. |
|
Возврат оплаты стоимости доставки
|
returnShippingCostPayer | string |
Это поле указывает, кто несет ответственность за оплату расходов на доставку возвращаемых товаров. |
Получение политики выполнения
Этот метод извлекает полные сведения о политике выполнения. Укажите идентификатор политики, которую требуется получить с помощью параметра пути fulfillmentPolicyId.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор политики выполнения
|
fulfillmentPolicyId | True | string |
Идентификатор политики выполнения, который требуется получить |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
categoryTypes
|
categoryTypes | array of object |
Этот контейнер указывает, применяется ли политика выполнения к спискам транспортных средств или не автомобильным автомобилям. |
|
Имя
|
categoryTypes.name | string |
Имя типа категории, к которому применяется политика. |
|
Description
|
description | string |
Определенное продавцом описание политики выполнения. Это описание предназначено только для использования продавца и не предоставляется на страницах eBay. |
|
Грузоперевозка
|
freightShipping | boolean |
Если он возвращается как true, продавец предлагает доставку грузов. |
|
Идентификатор политики выполнения
|
fulfillmentPolicyId | string |
Уникальный идентификатор, назначенный eBay для политики выполнения. |
|
Глобальная доставка
|
globalShipping | boolean |
Если он возвращается как true, программа глобальной доставки eBay будет использоваться продавцом для отправки товаров в международные расположения. |
|
Единица
|
handlingTime.unit | string |
Интервал времени определяется при применении значения, указанного в поле значения, к значению, указанному для единицы. |
|
Ценность
|
handlingTime.value | integer |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Локальный сбор
|
localPickup | boolean |
Если возвращается значение true, для этой политики доступен локальный сбор. |
|
Идентификатор Marketplace
|
marketplaceId | string |
Идентификатор eBay marketplace, к которому применяется эта политика выполнения. |
|
Имя
|
name | string |
Уникальное имя, определенное продавцом для этой политики выполнения. |
|
Раскрывающийся список пикап
|
pickupDropOff | boolean |
Если возвращается значение true, продавец предлагает параметр "Щелкнуть и собрать". |
|
shippingOptions
|
shippingOptions | array of object |
Этот массив используется для предоставления подробных сведений о вариантах внутреннего и международного доставки, доступных для политики. |
|
Тип затрат
|
shippingOptions.costType | string |
Это поле определяет, является ли модель стоимости доставки FLAT_RATE или ВЫЧИСЛЯЕМой |
|
Тип параметра
|
shippingOptions.optionType | string |
Это поле используется для указания того, являются ли соответствующие варианты службы доставки внутренними или международными. |
|
Валюта
|
shippingOptions.packageHandlingCost.currency | string |
Базовая валюта, применяемая к полю значения для установления денежной суммы. |
|
Ценность
|
shippingOptions.packageHandlingCost.value | string |
Денежный объем в указанной валюте. |
|
Идентификатор таблицы rate
|
shippingOptions.rateTableId | string |
Это поле используется, если продавец хочет связать таблицу тарифной ставки на внутреннюю или международную доставку с политикой выполнения бизнес-политики. |
|
shippingServices
|
shippingOptions.shippingServices | array of object |
Этот массив состоит из внутренних или международных служб доставки, определенных для политики. |
|
currency
|
shippingOptions.shippingServices.additionalShippingCost.currency | string |
currency |
|
value
|
shippingOptions.shippingServices.additionalShippingCost.value | string |
value |
|
buyerResponsibleForPickup
|
shippingOptions.shippingServices.buyerResponsibleForPickup | boolean |
Это поле должно быть включено для описания автомобиля, если он будет ответственностью покупателя забрать приобретенный автомобиль после полной оплаты. |
|
buyerResponsibleForShipping
|
shippingOptions.shippingServices.buyerResponsibleForShipping | boolean |
Это поле должно быть включено для перечисления транспортных средств, если он будет ответственностью покупателя на доставку приобретенного транспортного средства после полной оплаты |
|
currency
|
shippingOptions.shippingServices.cashOnDeliveryFee.currency | string |
currency |
|
value
|
shippingOptions.shippingServices.cashOnDeliveryFee.value | string |
value |
|
freeShipping
|
shippingOptions.shippingServices.freeShipping | boolean |
Это поле включается, если продавец предлагает вариант бесплатной доставки покупателю. |
|
shippingCarrierCode
|
shippingOptions.shippingServices.shippingCarrierCode | string |
Это поле задает или указывает перевозчика доставки. |
|
currency
|
shippingOptions.shippingServices.shippingCost.currency | string |
currency |
|
value
|
shippingOptions.shippingServices.shippingCost.value | string |
value |
|
shippingServiceCode
|
shippingOptions.shippingServices.shippingServiceCode | string |
Это поле задает или указывает вариант внутренней или международной службы доставки. |
|
regionExcluded
|
shippingOptions.shippingServices.shipToLocations.regionExcluded | array of object |
regionExcluded |
|
regionName
|
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName | string |
regionName |
|
regionType
|
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType | string |
regionType |
|
regionIncluded
|
shippingOptions.shippingServices.shipToLocations.regionIncluded | array of object |
regionIncluded |
|
regionName
|
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName | string |
regionName |
|
regionType
|
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType | string |
regionType |
|
sortOrder
|
shippingOptions.shippingServices.sortOrder | integer |
Целочисленное значение, заданное в этом поле, определяет порядок доставки. |
|
regionExcluded
|
shipToLocations.regionExcluded | array of object |
Массив значений regionName, указывающих области, в которые продавец не отправляется. |
|
Имя региона
|
shipToLocations.regionExcluded.regionName | string |
Строка, указывающая имя региона, как определено eBay. |
|
Тип региона
|
shipToLocations.regionExcluded.regionType | string |
Зарезервировано для дальнейшего использования. |
|
regionIncluded
|
shipToLocations.regionIncluded | array of object |
Массив полей regionName, указывающих области, в которые отправляется продавец. |
|
Имя региона
|
shipToLocations.regionIncluded.regionName | string |
Строка, указывающая имя региона, как определено eBay. |
|
Тип региона
|
shipToLocations.regionIncluded.regionType | string |
Зарезервировано для дальнейшего использования. |
Получение политики оплаты
Этот метод получает полные сведения о политике оплаты. Укажите идентификатор политики, которую вы хотите получить с помощью параметра пути paymentPolicyId.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор политики оплаты
|
payment_policy_id | True | string |
Идентификатор политики оплаты, который требуется получить. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
categoryTypes
|
categoryTypes | array of object |
Этот контейнер указывает, применяется ли политика выполнения к спискам транспортных средств или не автомобильных транспортных средств. |
|
Имя
|
categoryTypes.name | string |
Тип категории, к которому применяется политика. |
|
Валюта
|
deposit.amount.currency | string |
Базовая валюта, применяемая к полю значения для установления денежной суммы. |
|
Ценность
|
deposit.amount.value | string |
Денежный объем в указанной валюте. |
|
Единица
|
deposit.dueIn.unit | string |
Единица измерения времени, например DAY. |
|
Ценность
|
deposit.dueIn.value | integer |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Description
|
description | string |
Определенное продавцом описание политики оплаты. |
|
Единица
|
fullPaymentDueIn.unit | string |
Единица измерения времени, например DAY. |
|
Ценность
|
fullPaymentDueIn.value | integer |
Значение единицы измерения времени, указанное в поле единицы измерения. |
|
Немедленная оплата
|
immediatePay | boolean |
Если это поле возвращается как истинное, от покупателя требуется немедленная оплата |
|
Идентификатор Marketplace
|
marketplaceId | string |
Идентификатор рынка eBay, к которому применяется политика оплаты. |
|
Имя
|
name | string |
Идентификатор рынка eBay, к которому применяется политика оплаты. |
|
Платежные инструкции
|
paymentInstructions | string |
Хотя это поле может быть возвращено для некоторых старых бизнес-политик оплаты, инструкции по оплате больше не поддерживаются политиками бизнеса оплаты |
|
методы оплаты
|
paymentMethods | array of object |
Этот контейнер возвращается для отображения методов оплаты, которые принимаются для бизнес-политики оплаты. |
|
Тип метода оплаты
|
paymentMethods.paymentMethodType | string |
Тип метода оплаты для автономной поддержки |
|
Идентификатор политики оплаты
|
paymentPolicyId | string |
Уникальный идентификатор, назначенный eBay для политики оплаты. |
Получение предложений категорий
Этот вызов возвращает массив конечных узлов дерева категорий в указанном дереве категорий, которые считаются eBay наиболее тесно соответствуют запросу.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор дерева категорий
|
category_tree_id | True | string |
Дерево категорий eBay уникальное идентификатор, для которого запрашиваются предлагаемые узлы. |
|
Условие поиска
|
q | True | string |
Поисковый термин, описывающий товар, предлагаемый для продажи. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
categorySuggestions
|
categorySuggestions | array of object |
Содержит сведения о одной или нескольких предлагаемых категориях, которые соответствуют предоставленным ключевым словам. |
|
Идентификатор категории
|
categorySuggestions.category.categoryId | string |
Уникальный идентификатор категории eBay в дереве категорий. |
|
Имя категории
|
categorySuggestions.category.categoryName | string |
Имя категории, определяемой идентификатором categoryId. |
|
Предки узлов дерева категорий
|
categorySuggestions.categoryTreeNodeAncestors | array of object |
Массив упорядоченных ссылок на категории, описывающий расположение предлагаемой категории в указанном дереве категорий. |
|
categoryId
|
categorySuggestions.categoryTreeNodeAncestors.categoryId | string |
Уникальный идентификатор категории предка eBay. |
|
categoryName
|
categorySuggestions.categoryTreeNodeAncestors.categoryName | string |
Имя категории предка, определяемой идентификатором categoryId. |
|
categorySubtreeNodeHref
|
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref | string |
Часть href вызова getCategorySubtree, извлекающая поддерев под узлом категории предков. |
|
categoryTreeNodeLevel
|
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel | integer |
Абсолютный уровень узла категории предков в иерархии его дерева категорий. |
|
Уровень узла дерева категорий
|
categorySuggestions.categoryTreeNodeLevel | integer |
Абсолютный уровень узла категории предков в иерархии его дерева категорий. |
|
Уместность
|
categorySuggestions.relevancy | string |
Это поле зарезервировано для внутреннего или будущего использования. |
|
Идентификатор дерева категорий
|
categoryTreeId | string |
Уникальный идентификатор дерева категорий eBay, из которого возвращаются предложения. |
|
Версия дерева категорий
|
categoryTreeVersion | string |
Версия дерева категорий, определяемая categoryTreeId. |
Получение расположений инвентаризации
Этот вызов извлекает все определенные сведения для каждого расположения инвентаризации, связанного с учетной записью продавца.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Смещение
|
offset | string |
Указывает количество расположений, которые нужно пропустить в результирующем наборе, прежде чем возвращать первое расположение. |
|
|
Лимит
|
limit | string |
Максимальное количество записей, возвращаемых на страницу данных. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Href
|
href | string |
URI текущей страницы результатов из результирующий набор. |
|
Лимит
|
limit | integer |
Количество элементов, возвращаемых на одной странице из результирующий набор. |
|
Next
|
next | string |
URI для следующей страницы результатов. |
|
Смещение
|
offset | string |
Количество пропущенных результатов в результирующем наборе перед перечислением первого возвращаемого результата. |
|
Предыдущая
|
prev | string |
URI для предыдущей страницы результатов. |
|
Total
|
total | integer |
Общее количество элементов, полученных в результирующем наборе. |
|
местоположения
|
locations | array of object |
Массив одного или нескольких расположений инвентаризации торговца. |
|
Адресная строка 1
|
locations.location.address.addressLine1 | string |
Первая строка адреса улицы. |
|
Строка адреса 2
|
locations.location.address.addressLine2 | string |
Вторая строка адреса улицы. |
|
Город
|
locations.location.address.city | string |
Город, в котором находится расположение инвентаризации. |
|
Страна
|
locations.location.address.country | string |
Код страны, в котором находится адрес. |
|
Округ
|
locations.location.address.county | string |
Округ, в котором находится адрес. |
|
Почтовый индекс
|
locations.location.address.postalCode | string |
Почтовый или почтовый индекс адреса. |
|
Штат или провинция
|
locations.location.address.stateOrProvince | string |
Штат или провинция, в которой находится расположение инвентаризации. |
|
Широта
|
locations.location.geoCoordinates.latitude | string |
Компонент широты географической координаты. |
|
Долгота
|
locations.location.geoCoordinates.longitude | string |
Компонент долготы географической координаты. |
|
Идентификатор расположения
|
locations.location.locationId | string |
Уникальный идентификатор, назначенный eBay для расположения. |
|
Дополнительные сведения о расположении
|
locations.locationAdditionalInformation | string |
Это поле содержит дополнительные сведения о расположении инвентаризации. |
|
Инструкции по расположению
|
locations.locationInstructions | string |
Это поле используется продавцом для предоставления специальных инструкций по сбору для расположения магазина. |
|
locationTypes
|
locations.locationTypes | array of string |
Этот контейнер определяет функцию расположения инвентаризации. |
|
Url-адрес расположения
|
locations.locationWebUrl | string |
В этом поле показан адрес веб-сайта, связанный с расположением инвентаризации. |
|
Ключ расположения продавца
|
locations.merchantLocationKey | string |
Уникальный идентификатор расположения инвентаризации. |
|
Состояние расположения продавца
|
locations.merchantLocationStatus | string |
Это поле указывает, включено ли или отключено расположение инвентаризации. |
|
Имя
|
locations.name | string |
Имя расположения инвентаризации. |
|
operatingHours
|
locations.operatingHours | array of object |
В этом контейнере отображаются обычные рабочие часы для расположения магазина в течение дней недели. |
|
dayOfWeekEnum
|
locations.operatingHours.dayOfWeekEnum | string |
dayOfWeekEnum |
|
Интервалы
|
locations.operatingHours.intervals | array of object |
Этот контейнер используется для определения времени открытия или закрытия рабочего дня магазина. |
|
закрыть
|
locations.operatingHours.intervals.close | string |
закрыть |
|
открытый
|
locations.operatingHours.intervals.open | string |
открытый |
|
Телефон
|
locations.phone | string |
Номер телефона для расположения инвентаризации. |
|
специальный хурс
|
locations.specialHours | array of object |
В этом контейнере отображаются специальные рабочие часы для расположения магазина по определенной дате или датам. |
|
date
|
locations.specialHours.date | string |
date |
|
Интервалы
|
locations.specialHours.intervals | array of object |
Этот контейнер используется для определения времени открытия и закрытия хранилища на определенную дату. |
|
закрыть
|
locations.specialHours.intervals.close | string |
закрыть |
|
открытый
|
locations.specialHours.intervals.open | string |
открытый |
Получение расположения инвентаризации
Этот вызов извлекает все определенные сведения о расположении инвентаризации, заданном параметром пути merchantLocationKey.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Ключ расположения продавца
|
merchantLocationKey | True | string |
Уникальный ключ, определенный торговцем (идентификатор) для расположения инвентаризации. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Адресная строка 1
|
location.address.addressLine1 | string |
Первая строка адреса улицы. |
|
Строка адреса 2
|
location.address.addressLine2 | string |
Вторая строка адреса улицы. |
|
Город
|
location.address.city | string |
Город, в котором находится расположение инвентаризации. |
|
Страна
|
location.address.country | string |
Код страны, в котором находится адрес |
|
Округ
|
location.address.county | string |
Округ, в котором находится адрес. |
|
Почтовый индекс
|
location.address.postalCode | string |
Почтовый или почтовый индекс адреса. |
|
Штат или провинция
|
location.address.stateOrProvince | string |
Штат или провинция, в которой находится расположение инвентаризации. |
|
Широта
|
location.geoCoordinates.latitude | string |
Компонент широты географической координаты. |
|
Долгота
|
location.geoCoordinates.longitude | string |
Компонент долготы географической координаты. |
|
Идентификатор расположения
|
location.locationId | string |
Уникальный идентификатор, назначенный eBay для расположения. |
|
Дополнительные сведения о расположении
|
locationAdditionalInformation | string |
Это текстовое поле предоставляет дополнительные сведения о расположении инвентаризации. |
|
Инструкции по расположению
|
locationInstructions | string |
Поле используется продавцом для предоставления специальных инструкций по сбору для расположения магазина. |
|
locationTypes
|
locationTypes | array of string |
Этот контейнер определяет функцию расположения инвентаризации. |
|
Url-адрес расположения
|
locationWebUrl | string |
В поле отображается адрес веб-сайта, связанный с расположением инвентаризации. |
|
Ключ расположения продавца
|
merchantLocationKey | string |
Уникальный идентификатор расположения инвентаризации. |
|
Состояние расположения продавца
|
merchantLocationStatus | string |
Поле указывает, включена или отключена ли расположение инвентаризации. |
|
Имя
|
name | string |
Имя расположения инвентаризации. |
|
operatingHours
|
operatingHours | array of object |
В этом контейнере отображаются обычные рабочие часы для расположения магазина в течение дней недели. |
|
Перечисление недели
|
operatingHours.dayOfWeekEnum | string |
Значение требуется для каждого дня недели, в течение которых расположение магазина имеет обычные рабочие часы. |
|
Интервалы
|
operatingHours.intervals | array of object |
Этот контейнер используется для определения времени открытия или закрытия рабочего дня магазина. |
|
закрыть
|
operatingHours.intervals.close | string |
закрыть |
|
открытый
|
operatingHours.intervals.open | string |
открытый |
|
Телефон
|
phone | string |
Номер телефона для расположения инвентаризации. |
|
Специальные хурс
|
specialHours | array of object |
В этом контейнере отображаются специальные рабочие часы для расположения магазина по определенной дате или датам. |
|
Date
|
specialHours.date | string |
Значение даты требуется для каждой конкретной даты, в течение которых расположение магазина имеет специальные рабочие часы. |
|
Интервалы
|
specialHours.intervals | array of object |
Этот контейнер используется для определения времени открытия или закрытия хранилища на определенную дату. |
|
закрыть
|
specialHours.intervals.close | string |
закрыть |
|
открытый
|
specialHours.intervals.open | string |
открытый |
Получение элементов инвентаризации
Этот вызов извлекает все записи инвентаризации, определенные для учетной записи продавца.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Лимит
|
limit | string |
Максимальное количество записей, возвращаемых на страницу данных. |
|
|
Смещение
|
offset | string |
Номер страницы для получения. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Href
|
href | string |
Это URL-адрес текущей страницы элементов инвентаризации. |
|
inventoryItems
|
inventoryItems | array of object |
Этот контейнер представляет собой массив одного или нескольких элементов инвентаризации. |
|
pickupAtLocationAvailability
|
inventoryItems.availability.pickupAtLocationAvailability | array of object |
Этот контейнер состоит из массива физических магазинов продавца, где элемент инвентаризации доступен для сбора в магазине. |
|
availabilityType
|
inventoryItems.availability.pickupAtLocationAvailability.availabilityType | string |
Состояние доступности элемента инвентаризации |
|
единица
|
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit | string |
Единица времени, используемая для указания времени выполнения |
|
value
|
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value | integer |
Целочисленное значение в этом поле вместе с единицей времени в поле единицы будет указывать время выполнения. |
|
merchantLocationKey
|
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey | string |
Уникальный идентификатор магазина продавца, в котором находится In-Store элемент инвентаризации пикап, или отправляется в нее. |
|
количество
|
inventoryItems.availability.pickupAtLocationAvailability.quantity | integer |
количество |
|
Аукцион
|
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction | integer |
Это целочисленное значение указывает количество элементов инвентаризации, зарезервированных для опубликованных предложений формата аукциона номера SKU. |
|
Фиксированная цена
|
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.fixedPrice | integer |
Это значение указывает количество элементов инвентаризации, доступных для предложений SKU с фиксированной ценой. |
|
availabilityDistributions
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions | array of object |
Этот контейнер используется для задания доступного количества элемента инвентаризации в одном или нескольких расположениях склада. |
|
единица
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit | string |
единица |
|
value
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value | integer |
value |
|
merchantLocationKey
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey | string |
merchantLocationKey |
|
количество
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity | integer |
количество |
|
Количество
|
inventoryItems.availability.shipToLocationAvailability.quantity | integer |
Этот контейнер используется для задания общего количества товаров инвентаризации,которые будут доступны для покупки через одно или несколько опубликованных предложений. |
|
Состояние
|
inventoryItems.condition | string |
Это значение указывает условие элемента. |
|
Описание условия
|
inventoryItems.conditionDescription | string |
Это строковое поле используется продавцом для более четкого описания состояния элементов |
|
идентификаторы групп
|
inventoryItems.groupIds | array of string |
Этот массив возвращается, если элемент инвентаризации связан с любыми группами элементов инвентаризации. |
|
inventoryItemGroupKeys
|
inventoryItems.inventoryItemGroupKeys | array of string |
Этот массив возвращается, если элемент инвентаризации связан с любыми группами элементов инвентаризации. |
|
Региональные настройки
|
inventoryItems.locale | string |
Это поле возвращает естественный язык, предоставленный в значениях полей полезных данных запроса. |
|
Высота
|
inventoryItems.packageWeightAndSize.dimensions.height | number |
Фактическая высота пакета доставки. |
|
Length
|
inventoryItems.packageWeightAndSize.dimensions.length | number |
Фактическая длина пакета доставки. |
|
Единица
|
inventoryItems.packageWeightAndSize.dimensions.unit | string |
Единица измерения, используемая для указания измерений пакета доставки. |
|
Ширина
|
inventoryItems.packageWeightAndSize.dimensions.width | number |
Фактическая ширина пакета доставки. |
|
Ширина
|
inventoryItems.packageWeightAndSize.packageType | string |
Тип пакета доставки, используемый для доставки товара инвентаризации. |
|
Единица
|
inventoryItems.packageWeightAndSize.weight.unit | string |
Единица измерения, используемая для указания веса пакета доставки. |
|
Ценность
|
inventoryItems.packageWeightAndSize.weight.value | number |
Фактический вес пакета доставки. |
|
Перспектива
|
inventoryItems.product.aspects | object |
Это коллекция пар "имя-значение", которые предоставляют дополнительные сведения о продукте и могут упростить поиск покупателей. |
|
Бренд
|
inventoryItems.product.brand | string |
Бренд продукта. Это поле часто связано с полем mpn, чтобы определить конкретный продукт по номеру части производства. |
|
Description
|
inventoryItems.product.description | string |
Описание продукта. |
|
ean
|
inventoryItems.product.ean | array of string |
Номер европейской статьи или номер международной статьи для продукта. |
|
EPID
|
inventoryItems.product.epid | string |
Идентификатор продукта eBay (ePID) для продукта. |
|
imageUrls
|
inventoryItems.product.imageUrls | array of string |
Массив одной или нескольких ссылок на изображения для продукта. |
|
номер ISBN
|
inventoryItems.product.isbn | array of string |
Международное значение номера стандартной книги для продукта. |
|
MPN
|
inventoryItems.product.mpn | string |
Номер части продукта изготовителя. |
|
Субтитры
|
inventoryItems.product.subtitle | string |
Подзаголовок является необязательной функцией перечисления, которая позволяет продавцу предоставлять дополнительные сведения о продукте, возможно, включая ключевые слова, которые могут помочь с результатами поиска. |
|
Название
|
inventoryItems.product.title | string |
Название элемента инвентаризации можно добавить или изменить |
|
м.
|
inventoryItems.product.upc | array of string |
Значение универсального кода продукта для продукта. |
|
videoIds
|
inventoryItems.product.videoIds | array of string |
Массив одного или нескольких значений VideoId для продукта. |
|
Артикул (SKU)
|
inventoryItems.sku | string |
Определяется продавцом Stock-Keeping единица инвентаризации. |
|
Лимит
|
limit | integer |
Количество элементов инвентаризации, отображаемых на каждой странице результатов. |
|
Next
|
next | string |
URL-адрес следующей страницы элементов инвентаризации. |
|
Предыдущая
|
prev | string |
URL-адрес предыдущей страницы элементов инвентаризации. |
|
Size
|
size | integer |
Общее количество страниц доступных результатов. |
|
Total
|
total | integer |
Ttotal количество товаров инвентаризации, которые существуют для учетной записи продавца. |
Предложение GET
Этот вызов извлекает определенное опубликованное или неопубликованное предложение.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор предложения
|
offerId | True | string |
Уникальный идентификатор предложения, который требуется получить. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Доступное количество
|
availableQuantity | integer |
Количество товаров инвентаризации, которые будут доступны для покупки покупателями. |
|
Идентификатор категории
|
categoryId | string |
Уникальный идентификатор основной категории eBay, в которую указан элемент инвентаризации. |
|
Идентификатор благотворительности
|
charity.charityId | string |
Назначаемый eBay уникальный идентификатор благотворительной организации, которая получит процент выручки от продаж. |
|
Процент пожертвований
|
charity.donationPercentage | string |
Процент цены покупки, который благотворительная организация получит для каждой продажи, которую создает список. |
|
Идентификатор продукта производителя
|
extendedProducerResponsibility.producerProductId | string |
Уникальный идентификатор производителя, связанного с элементом. |
|
Идентификатор пакета продукта
|
extendedProducerResponsibility.productPackageId | string |
Уникальный идентификатор производителя любой упаковки, связанной с продуктом, добавленным продавцом. |
|
Идентификатор пакета отправки
|
extendedProducerResponsibility.shipmentPackageId | string |
Уникальный идентификатор производителя любой упаковки, используемой продавцом для отправки товара. |
|
Идентификатор документации по продукту
|
extendedProducerResponsibility.productDocumentationId | string |
Уникальный идентификатор производителя любой бумаги, добавленной в посылку товара продавцом. |
|
Валюта
|
extendedProducerResponsibility.ecoParticipationFee.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
extendedProducerResponsibility.ecoParticipationFee.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Формат
|
format | string |
Формат перечисления предложения |
|
Скрытие сведений о покупателе
|
hideBuyerDetails | boolean |
Это поле возвращается как true, если для предложения включена функция частного перечисления. |
|
Включение сведений о продукте каталога
|
includeCatalogProductDetails | boolean |
Это поле указывает, применяются ли сведения о каталоге продуктов eBay к списку. |
|
Идентификатор перечисления
|
listing.listingId | string |
Уникальный идентификатор списка eBay, связанного с опубликованным предложением. |
|
Состояние перечисления
|
listing.listingStatus | string |
Состояние перечисления, связанное с опубликованным предложением. |
|
Проданное количество
|
listing.soldQuantity | integer |
Количество продуктов, проданных для опубликованного предложения. |
|
Описание описания
|
listingDescription | string |
Описание списка eBay |
|
Длительность перечисления
|
listingDuration | string |
Это поле указывает количество дней, в которых будет активно перечисление. |
|
Валюта
|
listingPolicies.bestOfferTerms.autoAcceptPrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
listingPolicies.bestOfferTerms.autoAcceptPrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Валюта
|
listingPolicies.bestOfferTerms.autoDeclinePrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
listingPolicies.bestOfferTerms.autoDeclinePrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Лучшее предложение включено
|
listingPolicies.bestOfferTerms.bestOfferEnabled | boolean |
Этот контейнер используется, если продавец хотел бы поддержать функцию наилучшего предложения в их списке. |
|
eBay Plus, если это допустимо
|
listingPolicies.eBayPlusIfEligible | boolean |
Это поле включается в предложение, если продавец Top-Rated будет включен в программу eBay Plus. |
|
Идентификатор политики выполнения
|
listingPolicies.fulfillmentPolicyId | string |
Уникальный идентификатор указывает бизнес-политику выполнения, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
Идентификатор политики оплаты
|
listingPolicies.paymentPolicyId | string |
Уникальный идентификатор указывает политику оплаты, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
productCompliancePolicyIds
|
listingPolicies.productCompliancePolicyIds | array of string |
Это поле содержит массив до пяти идентификаторов, указывающих продавцу созданные политики соответствия для перечисления. |
|
Идентификатор политики возврата
|
listingPolicies.returnPolicyId | string |
Уникальный идентификатор указывает возвращаемую бизнес-политику, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
shippingCostOverrides
|
listingPolicies.shippingCostOverrides | array of object |
Этот контейнер используется, если продавец хочет переопределить расходы на доставку для одного или нескольких внутренних или международных вариантов доставки, определенных в политике перечисления заказов. |
|
Валюта
|
listingPolicies.shippingCostOverrides.additionalShippingCost.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
listingPolicies.shippingCostOverrides.additionalShippingCost.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Priority
|
listingPolicies.shippingCostOverrides.priority | integer |
Целочисленное значение, входное в это поле, а также значение shippingServiceType, задает параметр внутренней или международной службы доставки в политике выполнения будет изменен с обновленными затратами на доставку. |
|
Валюта
|
listingPolicies.shippingCostOverrides.shippingCost.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
listingPolicies.shippingCostOverrides.shippingCost.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Тип службы доставки
|
listingPolicies.shippingCostOverrides.shippingServiceType | string |
Это значение указывает, является ли служба доставки внутренней или международной службой доставки. |
|
Возврат идентификатора политики
|
listingPolicies.takeBackPolicyId | string |
Идентификатор продавца создал политику возврата. |
|
Дата начала перечисления
|
listingStartDate | string |
Эта метка времени — это дата и время, заданное продавцом для запланированного списка. |
|
Размер лота
|
lotSize | integer |
Это поле применимо только в том случае, если перечисление имеет большое значение. Много перечисления — это список с несколькими количествами одного продукта. |
|
Идентификатор Marketplace
|
marketplaceId | string |
Уникальный идентификатор сайта eBay, на котором доступно предложение или будет доступен. |
|
Ключ расположения продавца
|
merchantLocationKey | string |
Уникальный идентификатор расположения инвентаризации. |
|
Идентификатор предложения
|
offerId | string |
Уникальный идентификатор предложения. |
|
Валюта
|
pricingSummary.auctionReservePrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
pricingSummary.auctionReservePrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Валюта
|
pricingSummary.auctionStartPrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
pricingSummary.auctionStartPrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Валюта
|
pricingSummary.minimumAdvertisedPrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
pricingSummary.minimumAdvertisedPrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Первоначально продано для розничной цены на
|
pricingSummary.originallySoldForRetailPriceOn | string |
Это поле необходимо, если в предложении будет использоваться функция "Цены на забастовку". Это поле указывает, что продукт был продан по цене в исходном поле RetailPrice на сайте eBay или продан за эту цену сторонним розничным торговцем. |
|
Валюта
|
pricingSummary.originalRetailPrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
pricingSummary.originalRetailPrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Валюта
|
pricingSummary.price.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
pricingSummary.price.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Видимость цен
|
pricingSummary.pricingVisibility | string |
Это поле необходимо, если функция минимально объявленной цены будет использоваться в предложении. |
|
Ограничение количества на покупателя
|
quantityLimitPerBuyer | integer |
Это поле применимо только в том случае, если продавец хочет установить ограничение на количество покупки товара на продавца. |
|
Идентификатор вторичной категории
|
secondaryCategoryId | string |
Уникальный идентификатор вторичной категории и применимо, если продавец решит перечислить элемент в двух категориях. |
|
Артикул (SKU)
|
sku | string |
Определенное продавцом значение номера SKU продукта в предложении. |
|
Состояние
|
status | string |
Значение указывает состояние предложения. |
|
Хранение имен категорий
|
storeCategoryNames | array of string |
Имя категории хранилища |
|
Применение налога
|
tax.applyTax | boolean |
Это поле будет включено, если продавец хотел бы ссылаться на налог на продажу на уровне учетной записи |
|
Категория налога стороннего производителя
|
tax.thirdPartyTaxCategory | string |
Код категории налоговых исключений. Если это поле используется, налог на продажу также будет применяться к службе или сбору, а не только цене товара. |
|
Процент НДС
|
tax.vatPercentage | number |
Это значение является ставкой НДС для элемента, если таковой имеется. Если указан процент НДС, на странице представления элемента отображается информация о НДС элемента. |
Предложения GET
Этот вызов извлекает все существующие предложения для указанного значения SKU. Продавец имеет возможность ограничить предложения, которые извлекаются на определенный рынок eBay, или в формат списка.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Артикул (SKU)
|
sku | True | string |
Определенное продавцом значение SKU |
|
Идентификатор Marketplace
|
marketplace_id | string |
Уникальный идентификатор платформы eBay. |
|
|
Формат
|
format | string |
Формат перечисления предложения. |
|
|
Лимит
|
limit | string |
Максимальное количество записей, возвращаемых на страницу данных. |
|
|
Смещение
|
offset | string |
Номер страницы для получения. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Href
|
href | string |
URL-адрес текущей страницы предложений. |
|
Лимит
|
limit | integer |
Количество предложений, которые будут отображаться на каждой странице результатов. |
|
Next
|
next | string |
URL-адрес следующей страницы предложений. |
|
offers
|
offers | array of object |
Этот контейнер представляет собой массив предложений одного или нескольких продавцов для значения SKU. |
|
Доступное количество
|
offers.availableQuantity | integer |
Количество элементов инвентаризации, которое будет доступно для покупки. |
|
Идентификатор категории
|
offers.categoryId | string |
Уникальный идентификатор категории eBay, в который указан элемент инвентаризации. |
|
Идентификатор благотворительности
|
offers.charity.charityId | string |
Назначаемый eBay уникальный идентификатор благотворительной организации, которая получит процент выручки от продаж. |
|
Процент пожертвований
|
offers.charity.donationPercentage | string |
Процент цены покупки, который благотворительная организация получит для каждой продажи. |
|
Идентификатор продукта производителя
|
offers.extendedProducerResponsibility.producerProductId | string |
Уникальный идентификатор производителя, связанного с элементом. |
|
Идентификатор пакета продукта
|
offers.extendedProducerResponsibility.productPackageId | string |
Уникальный идентификатор упаковаемого продукта, добавленного продавцом. |
|
Идентификатор пакета отправки
|
offers.extendedProducerResponsibility.shipmentPackageId | string |
Уникальный идентификатор производителя любой упаковки, используемой продавцом для отправки товара. |
|
Идентификатор документации по продукту
|
offers.extendedProducerResponsibility.productDocumentationId | string |
Уникальный идентификатор производителя любой бумаги, добавленной в посылку товара продавцом. |
|
Валюта
|
offers.extendedProducerResponsibility.ecoParticipationFee.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
offers.extendedProducerResponsibility.ecoParticipationFee.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Формат
|
offers.format | string |
Это значение задает формат описания предложения |
|
Скрытие сведений о покупателе
|
offers.hideBuyerDetails | boolean |
Это поле возвращается как true, если для предложения включена функция частного перечисления. |
|
Включение сведений о продукте каталога
|
offers.includeCatalogProductDetails | boolean |
Это поле указывает, применяются ли сведения о каталоге продуктов eBay к списку. |
|
Идентификатор перечисления
|
offers.listing.listingId | string |
Уникальный идентификатор списка eBay, связанного с опубликованным предложением. |
|
Состояние перечисления
|
offers.listing.listingStatus | string |
Состояние перечисления, связанное с опубликованным предложением. |
|
Проданное количество
|
offers.listing.soldQuantity | integer |
Количество продуктов, проданное для опубликованного предложения. |
|
Описание описания
|
offers.listingDescription | string |
Описание описания eBay. |
|
Длительность перечисления
|
offers.listingDuration | string |
Указывает количество дней, в которых будет активно перечисление. |
|
Валюта
|
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Валюта
|
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Лучшее предложение включено
|
offers.listingPolicies.bestOfferTerms.bestOfferEnabled | boolean |
Это поле указывает, включена ли функция "Лучшее предложение" для перечисления. |
|
eBay Plus, если это допустимо
|
offers.listingPolicies.eBayPlusIfEligible | boolean |
Это поле включается в предложение и имеет значение true, если продавец Top-Rated будет включен в программу eBay Plus |
|
Идентификатор политики выполнения
|
offers.listingPolicies.fulfillmentPolicyId | string |
Уникальный идентификатор указывает бизнес-политику выполнения, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
Идентификатор политики оплаты
|
offers.listingPolicies.paymentPolicyId | string |
Уникальный идентификатор указывает политику оплаты, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
productCompliancePolicyIds
|
offers.listingPolicies.productCompliancePolicyIds | array of string |
Это поле содержит массив до пяти идентификаторов, указывающих продавцу созданные политики соответствия для перечисления. |
|
Идентификатор политики возврата
|
offers.listingPolicies.returnPolicyId | string |
Уникальный идентификатор указывает возвращаемую бизнес-политику, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
shippingCostOverrides
|
offers.listingPolicies.shippingCostOverrides | array of object |
Этот контейнер используется, если продавец хочет переопределить расходы на доставку или доплату за один или несколько вариантов внутренних или международных служб доставки, определенных в политике перечисления о выполнении. |
|
currency
|
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.currency | string |
currency |
|
value
|
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value | string |
value |
|
priority
|
offers.listingPolicies.shippingCostOverrides.priority | integer |
priority |
|
currency
|
offers.listingPolicies.shippingCostOverrides.shippingCost.currency | string |
currency |
|
value
|
offers.listingPolicies.shippingCostOverrides.shippingCost.value | string |
value |
|
shippingServiceType
|
offers.listingPolicies.shippingCostOverrides.shippingServiceType | string |
shippingServiceType |
|
Возврат идентификатора политики
|
offers.listingPolicies.takeBackPolicyId | string |
Идентификатор продавца, создавший политику возврата. |
|
Дата начала перечисления
|
offers.listingStartDate | string |
Дата и время, заданное продавцом для запланированного списка. |
|
Размер лота
|
offers.lotSize | integer |
Это поле применимо только и возвращается, если перечисление имеет большое значение. |
|
Идентификатор Marketplace
|
offers.marketplaceId | string |
Уникальный идентификатор сайта eBay, на котором доступно предложение или будет доступен. |
|
Ключ расположения продавца
|
offers.merchantLocationKey | string |
Уникальный идентификатор расположения инвентаризации. |
|
Идентификатор предложения
|
offers.offerId | string |
Уникальный идентификатор предложения. |
|
Валюта
|
offers.pricingSummary.auctionReservePrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
offers.pricingSummary.auctionReservePrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Валюта
|
offers.pricingSummary.auctionStartPrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
offers.pricingSummary.auctionStartPrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Валюта
|
offers.pricingSummary.minimumAdvertisedPrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
offers.pricingSummary.minimumAdvertisedPrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Первоначально продано для розничной цены на
|
offers.pricingSummary.originallySoldForRetailPriceOn | string |
Это поле необходимо, если в предложении будет использоваться функция "Цены на забастовку". Это поле указывает, что продукт был продан по цене в исходном поле RetailPrice на сайте eBay или продан за эту цену сторонним розничным торговцем. |
|
Валюта
|
offers.pricingSummary.originalRetailPrice.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
offers.pricingSummary.originalRetailPrice.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Валюта
|
offers.pricingSummary.price.currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
Ценность
|
offers.pricingSummary.price.value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
Видимость цен
|
offers.pricingSummary.pricingVisibility | string |
Это поле необходимо, если функция минимально объявленной цены будет использоваться в предложении. |
|
Ограничение количества на покупателя
|
offers.quantityLimitPerBuyer | integer |
Это поле применимо только в том случае, если продавец хочет установить ограничение на количество покупки товара на продавца. |
|
Идентификатор вторичной категории
|
offers.secondaryCategoryId | string |
Уникальный идентификатор вторичной категории. |
|
Артикул (SKU)
|
offers.sku | string |
Определенное продавцом значение номера SKU продукта в предложении. |
|
Состояние
|
offers.status | string |
Значение указывает состояние предложения. |
|
storeCategoryNames
|
offers.storeCategoryNames | array of string |
Этот контейнер возвращается, если продавец решил поместить товар инвентаризации в одну или две категории магазина eBay, которые продавец настроил для своего магазина eBay |
|
Применение налога
|
offers.tax.applyTax | boolean |
Это поле будет включено, если продавец хотел бы ссылаться на свою таблицу налога на продажу на уровне учетной записи, чтобы вычислить налог на продажу для заказа. |
|
Категория налога стороннего производителя
|
offers.tax.thirdPartyTaxCategory | string |
Код категории налоговых исключений. |
|
Процент НДС
|
offers.tax.vatPercentage | number |
Значение ставки налога на добавленную стоимость (НДС) для элемента, если таковой имеется. |
|
Предыдущая
|
prev | string |
URL-адрес предыдущей страницы предложений. |
|
Size
|
size | integer |
Количество предложений, отображаемых на текущей странице результатов. |
|
Total
|
total | integer |
Общее количество предложений, которые существуют для указанного значения номера SKU. |
Публикация предложения
Этот вызов используется для преобразования неопубликованного предложения в опубликованное предложение или динамического списка eBay. Уникальный идентификатор предложения (offerId) передается в конце URI вызова.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор предложения
|
offerId | True | string |
Уникальный идентификатор предложения, который должен быть опубликован. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор перечисления
|
listingId | string |
Уникальный идентификатор только что созданного списка eBay. |
|
Предупреждения
|
warnings | array of object |
Этот контейнер будет возвращен, если было одно или несколько предупреждений, связанных с попыткой отозвать предложение. |
|
Категория
|
warnings.category | string |
Это строковое значение указывает категорию ошибок. |
|
Домен
|
warnings.domain | string |
Имя домена, в котором произошла ошибка или предупреждение. |
|
Идентификатор ошибки
|
warnings.errorId | integer |
Уникальный код, определяющий определенную ошибку или предупреждение, которое произошло. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Массив одного или нескольких ссылочных идентификаторов, определяющих наиболее тесно связанные с ошибкой или предупреждением определенные элементы запроса. |
|
Длинное сообщение
|
warnings.longMessage | string |
Подробное описание условия, вызвавшего ошибку или предупреждение, и сведения о том, что делать для исправления проблемы. |
|
Message
|
warnings.message | string |
Описание условия, вызвавшего ошибку или предупреждение. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Массив одного или нескольких ссылочных идентификаторов, определяющих наиболее тесно связанные с ошибкой или предупреждением определенные элементы ответа. |
|
parameters
|
warnings.parameters | array of object |
Различные предупреждения и сообщения об ошибках возвращают одну или несколько переменных, содержащих контекстные сведения об ошибке или предупреждении. |
|
имя
|
warnings.parameters.name | string |
имя |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
Имя поддомена, в котором произошла ошибка или предупреждение. |
Создание или замена элемента инвентаризации
Этот вызов создает новую запись элемента инвентаризации или заменяет существующую запись элемента инвентаризации.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Артикул (SKU)
|
sku | True | string |
Определенное продавцом значение для элемента инвентаризации. |
|
Язык содержимого
|
Content-Language | True | string |
Заголовок задает естественный язык, который будет использоваться в значениях полей полезных данных запроса. |
|
Тип
|
availabilityType | string |
Состояние доступности элемента инвентаризации в физическом хранилище торговца. |
|
|
Единица
|
unit | string |
Единица времени, используемая для указания времени выполнения. |
|
|
Ценность
|
value | integer |
Значение времени выполнения. |
|
|
Ключ расположения продавца
|
merchantLocationKey | string |
Магазин торговца уникальный идентификатор, в котором в настоящее время находится In-Store элемент инвентаризации пикап или отправляется в нее. |
|
|
Количество
|
quantity | integer |
Количество элементов инвентаризации, доступных для In-Store пикап. |
|
|
Единица
|
unit | string |
Единица времени, используемая для указания времени выполнения. |
|
|
Ценность
|
value | integer |
Значение времени выполнения. |
|
|
Ключ расположения продавца
|
merchantLocationKey | string |
Уникальный идентификатор магазина торговца, в котором в настоящее время находится In-Store элемент инвентаризации пикап или будет отправлен в. |
|
|
Количество
|
quantity | integer |
Количество элементов инвентаризации, доступных в этом расположении инвентаризации. |
|
|
Количество
|
quantity | integer |
Общее количество товаров инвентаризации", которые будут доступны для покупки через одно или несколько опубликованных предложений. |
|
|
Состояние
|
condition | string |
Условие элемента. |
|
|
Описание условия
|
conditionDescription | string |
Описание условия элемента инвентаризации. |
|
|
Высота
|
height | number |
Фактическая высота пакета доставки. |
|
|
Length
|
length | number |
Фактическая длина пакета доставки. |
|
|
Единица
|
unit | string |
Единица измерения, используемая для указания измерений пакета доставки. |
|
|
Ширина
|
width | number |
Фактическая ширина пакета доставки. |
|
|
Тип пакета
|
packageType | string |
Значение пакета доставки, используемое для отправки элемента инвентаризации. |
|
|
Единица
|
unit | string |
Единица измерения, используемая для указания веса пакета доставки. |
|
|
Ценность
|
value | number |
Фактический вес пакета доставки. |
|
|
Перспектива
|
aspects | object |
Это коллекция пар "имя-значение", которые предоставляют дополнительные сведения о продукте и могут упростить поиск покупателей. |
|
|
Бренд
|
brand | string |
Бренд продукта. |
|
|
Description
|
description | string |
Описание продукта. |
|
|
Элементы EAN
|
ean | array of string |
EAN |
|
|
EPID
|
epid | string |
Идентификатор продукта eBay для продукта. |
|
|
URL-адреса изображений
|
imageUrls | array of string |
URL-адреса изображений |
|
|
Элементы ISBN
|
isbn | array of string |
Номер ISBN |
|
|
MPN
|
mpn | string |
Номер части продукта изготовителя. |
|
|
Субтитры
|
subtitle | string |
Необязательная функция перечисления, которая позволяет продавцу предоставлять дополнительные сведения о продукте, возможно, включая ключевые слова, которые могут помочь с результатами поиска. |
|
|
Название
|
title | string |
Название элемента инвентаризации можно добавить или изменить. |
|
|
ЭЛЕМЕНТЫ С ПОМОЩЬЮ КОДОВ
|
upc | array of string |
м. |
|
|
Идентификаторы видео
|
videoIds | array of string |
videoIds |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Предупреждения
|
warnings | array of object |
Этот контейнер будет возвращен в полезные данные ответа на вызов, если активируются одно или несколько предупреждений или ошибок. |
|
Категория
|
warnings.category | string |
Это строковое значение указывает категорию ошибок. |
|
Домен
|
warnings.domain | string |
Имя домена, в котором произошла ошибка или предупреждение. |
|
Идентификатор ошибки
|
warnings.errorId | integer |
Уникальный код, определяющий определенную ошибку или предупреждение, которое произошло. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Массив одного или нескольких ссылочных идентификаторов, определяющих наиболее тесно связанные с ошибкой или предупреждением определенные элементы запроса. |
|
Длинное сообщение
|
warnings.longMessage | string |
Подробное описание условия, вызвавшего ошибку или предупреждение, и сведения о том, что делать для исправления проблемы. |
|
Message
|
warnings.message | string |
Описание условия, вызвавшего ошибку или предупреждение. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Массив одного или нескольких ссылочных идентификаторов, определяющих наиболее тесно связанные с ошибкой или предупреждением определенные элементы ответа. |
|
parameters
|
warnings.parameters | array of object |
Различные предупреждения и сообщения об ошибках возвращают одну или несколько переменных, содержащих контекстные сведения об ошибке или предупреждении. |
|
имя
|
warnings.parameters.name | string |
имя |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | object |
Описание условия, вызвавшего ошибку или предупреждение. |
Создание предложения
Этот вызов создает предложение для определенного элемента инвентаризации на определенной платформе eBay.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Доступное количество
|
availableQuantity | integer |
Доступное количество запасов для покупки. |
|
|
Идентификатор категории
|
categoryId | string |
Идентификатор категории eBay Unique, в который будет указан продукт. |
|
|
Идентификатор благотворительности
|
charityId | string |
Присвоенный eBay уникальный идентификатор благотворительной организации, которая получит процент выручки от продаж. |
|
|
Процент пожертвований
|
donationPercentage | string |
Процент цены покупки, который благотворительная организация получит для каждой продажи, которая создает список. |
|
|
Идентификатор продукта производителя
|
producerProductId | string |
Уникальный идентификатор производителя, связанного с элементом. |
|
|
Идентификатор пакета продукта
|
productPackageId | string |
Уникальный идентификатор производителя упаковки продукта, добавленного продавцом. |
|
|
Идентификатор пакета отправки
|
shipmentPackageId | string |
Уникальный идентификатор производителя любой упаковки, используемой продавцом для доставки товара. |
|
|
Идентификатор документации по продукту
|
productDocumentationId | string |
Уникальный идентификатор производителя любой бумаги, добавленной в посылку товара продавцом. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Формат
|
format | string |
Формат перечисления предложения. |
|
|
Скрытие сведений о покупателе
|
hideBuyerDetails | boolean |
Это поле включается, если продавец хочет создать частный листинг. |
|
|
Включение сведений о продукте каталога
|
includeCatalogProductDetails | boolean |
Указывает, применяются ли сведения о каталоге продуктов eBay к списку. |
|
|
Описание описания
|
listingDescription | string |
Описание списка eBay. |
|
|
Длительность перечисления
|
listingDuration | string |
Количество дней, в которые будет активное описание. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Лучшее предложение включено
|
bestOfferEnabled | boolean |
Указывает, включена ли функция "Лучшее предложение" для перечисления. |
|
|
eBay Plus, если это допустимо
|
eBayPlusIfEligible | boolean |
Это поле включается в предложение, если продавец Top-Rated будет включен в программу eBay Plus. |
|
|
Идентификатор политики выполнения
|
fulfillmentPolicyId | string |
Уникальный идентификатор указывает бизнес-политику выполнения, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
|
Идентификатор политики оплаты
|
paymentPolicyId | string |
Уникальный идентификатор указывает политику оплаты, которая будет использоваться после публикации предложения и преобразования в список eBay. |
|
|
Идентификаторы политики соответствия продукта
|
productCompliancePolicyIds | array of string |
Это поле содержит массив до пяти идентификаторов, указывающих продавцу созданные политики соответствия для перечисления. |
|
|
Идентификатор политики возврата
|
returnPolicyId | string |
Возврат уникального идентификатора бизнес-политики, который будет использоваться после публикации предложения и преобразования в список eBay. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Priority
|
priority | integer |
Целочисленное значение, входное в это поле, а также значение shippingServiceType, задает параметр внутренней или международной службы доставки в политике выполнения будет изменен с обновленными затратами на доставку. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Тип службы
|
shippingServiceType | string |
Это значение указывает, является ли служба доставки, указанная в поле приоритета, является внутренней или международной службой доставки. |
|
|
Возврат идентификатора политики
|
takeBackPolicyId | string |
Идентификатор продавца, создавший политику возврата. |
|
|
Дата начала перечисления
|
listingStartDate | string |
Это поле можно использовать, если продавец хочет указать время в будущем, что листинг станет активным на eBay. |
|
|
Размер лота
|
lotSize | integer |
Это поле применимо только в том случае, если список является большим списком. Целочисленное значение, переданное в это поле, — общее количество элементов в лоте. |
|
|
Идентификатор Marketplace
|
marketplaceId | string |
Уникальный идентификатор сайта eBay, для которого будет доступно предложение. |
|
|
Ключ расположения продавца
|
merchantLocationKey | string |
Уникальный идентификатор расположения инвентаризации торговца |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Первоначально продано для розничной цены на
|
originallySoldForRetailPriceOn | string |
Это поле необходимо, если в предложении будет использоваться функция "Цены на забастовку". Это поле указывает, что продукт был продан по цене в исходном поле RetailPrice на сайте eBay или продан за эту цену сторонним розничным торговцем |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Валюта
|
currency | string |
Трехзначное строковое значение, представляющее тип валюты. |
|
|
Ценность
|
value | string |
Строковое представление значения доллара, выраженного в поле валюты. |
|
|
Видимость цен
|
pricingVisibility | string |
Это поле необходимо, если функция минимально объявленной цены будет использоваться в предложении. |
|
|
Ограничение количества на покупателя
|
quantityLimitPerBuyer | integer |
Это поле применимо только в том случае, если продавец хочет установить ограничение на количество покупок на продавца. |
|
|
Идентификатор вторичной категории
|
secondaryCategoryId | string |
Уникальный идентификатор вторичной категории и применимый, если продавец решит перечислить элемент под двумя категориями. |
|
|
Артикул (SKU)
|
sku | string |
Определенное продавцом значение SKU продукта, которое будет отображаться на сайте eBay. |
|
|
Хранение имен категорий
|
storeCategoryNames | array of string |
Имя категории хранилища |
|
|
Применение налога
|
applyTax | boolean |
Этот контейнер применяется только в том случае, если к предложению будет применена таблица налога на продажу, ставка налога Value-Added или код категории налоговых исключений. |
|
|
Категория налога стороннего производителя
|
thirdPartyTaxCategory | string |
Код категории налоговых исключений. Если это поле используется, налог на продажу также будет применяться к службе или сбору, а не только цене товара. |
|
|
Процент НДС
|
vatPercentage | number |
Это значение является ставкой НДС для элемента, если таковой имеется. Если указан процент НДС, на странице представления элемента отображается информация о НДС элемента. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор предложения
|
offerId | string |
Уникальный идентификатор предложения |
|
Предупреждения
|
warnings | array of object |
Этот контейнер возвращается при вызове и ошибках и /или предупреждениях. |
|
Категория
|
warnings.category | string |
Это строковое значение указывает категорию ошибок |
|
Домен
|
warnings.domain | string |
Доменное имя, в котором произошла ошибка или предупреждение. |
|
Идентификатор ошибки
|
warnings.errorId | integer |
Уникальный код, определяющий конкретную ошибку или предупреждение, которое произошло. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Массив одного или нескольких ссылочных идентификаторов, определяющих наиболее тесно связанные с ошибкой или предупреждением определенные элементы запроса. |
|
Длинное сообщение
|
warnings.longMessage | string |
Подробное описание условия, вызвавшего ошибку или предупреждение, и сведения о том, что делать для исправления проблемы. |
|
Message
|
warnings.message | string |
Описание условия, вызвавшего ошибку или предупреждение. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Массив одного или нескольких ссылочных идентификаторов, определяющих наиболее тесно связанные с ошибкой или предупреждением определенные элементы ответа. |
|
parameters
|
warnings.parameters | array of object |
Различные предупреждения и сообщения об ошибках возвращают одну или несколько переменных, содержащих контекстные сведения об ошибке или предупреждении. |
|
имя
|
warnings.parameters.name | string |
имя |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
Имя поддомена, в котором произошла ошибка или предупреждение. |
Создание расположения инвентаризации
Используйте этот вызов для создания нового расположения инвентаризации. Чтобы создать и опубликовать предложение, продавец должен иметь одно расположение инвентаризации, так как каждое предложение должно быть связано с расположением.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Ключ расположения продавца
|
merchantLocationKey | True | string |
Уникальный ключ, определенный продавцом для расположения инвентаризации. |
|
Адресная строка 1
|
addressLine1 | string |
Первая строка адреса улицы. |
|
|
Строка адреса 2
|
addressLine2 | string |
Вторая строка адреса улицы. |
|
|
Город
|
city | string |
Город, в котором находится расположение инвентаризации. |
|
|
Страна
|
country | string |
Код страны, в котором находится адрес. |
|
|
Округ
|
county | string |
Округ, в котором находится адрес. |
|
|
Почтовый индекс
|
postalCode | string |
Почтовый или почтовый индекс адреса. |
|
|
Штат или провинция
|
stateOrProvince | string |
Штат или провинция, в которой находится расположение инвентаризации. |
|
|
Широта
|
latitude | string |
Компонент широты географической координаты. |
|
|
Долгота
|
longitude | string |
Компонент долготы географической координаты. |
|
|
Дополнительные сведения о расположении
|
locationAdditionalInformation | string |
Дополнительные сведения о расположении инвентаризации. |
|
|
Инструкции по расположению
|
locationInstructions | string |
Специальные инструкции по сбору для расположения инвентаризации магазина. |
|
|
locationTypes
|
locationTypes | array of string |
Типы расположения |
|
|
Url-адрес расположения
|
locationWebUrl | string |
Адрес веб-сайта, связанный с расположением инвентаризации. |
|
|
Состояние расположения продавца
|
merchantLocationStatus | string |
Состояние расположения инвентаризации может быть включено или отключено. |
|
|
Имя
|
name | string |
Имя расположения инвентаризации. |
|
|
День недели
|
dayOfWeekEnum | string |
День расположения магазина имеет обычные рабочие часы. |
|
|
закрыть
|
close | string |
Время закрытия магазина. |
|
|
открытый
|
open | string |
Время открытия магазина. |
|
|
Телефон
|
phone | string |
Номер телефона для расположения инвентаризации магазина. |
|
|
Date
|
date | string |
Конкретное значение даты, в которое расположение магазина имеет специальные рабочие часы. |
|
|
закрыть
|
close | string |
Время закрытия магазина. |
|
|
открытый
|
open | string |
Время открытия магазина. |
Возвращаемое значение
- response
- string
Удаление предложения
Этот вызов окончательно удаляет предложение.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор предложения
|
offerId | True | string |
Уникальный идентификатор предложения для удаления. |
Возвращаемое значение
- response
- string
Элемент инвентаризации GET
Этот вызов извлекает запись элемента инвентаризации для заданного номера SKU.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Артикул (SKU)
|
sku | True | string |
Определенное продавцом значение продукта, запись которого требуется получить. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
PickupAtLocationAvailability
|
availability.pickupAtLocationAvailability | array of object |
Этот контейнер состоит из массива физических магазинов продавца, где элемент инвентаризации доступен для сбора в магазине. |
|
Тип доступности
|
availability.pickupAtLocationAvailability.availabilityType | string |
Это поле указывает состояние доступности элемента инвентаризации в физическом хранилище торговца. |
|
Единица
|
availability.pickupAtLocationAvailability.fulfillmentTime.unit | string |
Значение указывает единицу времени, используемую для указания времени выполнения. |
|
Ценность
|
availability.pickupAtLocationAvailability.fulfillmentTime.value | integer |
Целочисленное значение в этом поле вместе с единицей времени в поле единицы будет указывать время выполнения. |
|
Ключ расположения продавца
|
availability.pickupAtLocationAvailability.merchantLocationKey | string |
Уникальный идентификатор магазина продавца, в котором в настоящее время находится In-Store элемент инвентаризации пикап или будет отправлен в. |
|
Количество
|
availability.pickupAtLocationAvailability.quantity | integer |
Это целочисленное значение указывает количество элементов инвентаризации, доступных для In-Store выбора |
|
Аукцион
|
availability.shipToLocationAvailability.allocationByFormat.auction | integer |
Это целочисленное значение указывает количество элементов инвентаризации, зарезервированных для опубликованных предложений формата аукциона номера SKU. |
|
Фиксированная цена
|
availability.shipToLocationAvailability.allocationByFormat.fixedPrice | integer |
Это целочисленное значение указывает количество товара инвентаризации, доступное для предложений SKU фиксированной цены. |
|
ДоступностьDistributions
|
availability.shipToLocationAvailability.availabilityDistributions | array of object |
Этот контейнер используется для задания доступного количества элемента инвентаризации в одном или нескольких расположениях склада. |
|
Единица
|
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit | string |
Значение указывает единицу времени, используемую для указания времени выполнения. |
|
Ценность
|
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value | integer |
Целочисленное значение в этом поле вместе с единицей времени в поле единицы будет указывать время выполнения. |
|
Ключ расположения продавца
|
availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey | string |
Уникальный идентификатор расположения инвентаризации, в котором доступно количество для элемента инвентаризации. |
|
Количество
|
availability.shipToLocationAvailability.availabilityDistributions.quantity | integer |
Количество элементов инвентаризации, доступных в этом расположении инвентаризации. |
|
Количество
|
availability.shipToLocationAvailability.quantity | integer |
Этот контейнер используется для задания общего количества товаров инвентаризации,которые будут доступны для покупки с помощью одного или нескольких опубликованных предложений. |
|
Состояние
|
condition | string |
Это значение указывает условие элемента |
|
Описание условия
|
conditionDescription | string |
Это строковое поле используется продавцом для более четкого описания условий используемых элементов или элементов, которые не являются "Совершенно новыми", "Новые с тегами" или "Новые в поле". |
|
идентификаторы групп
|
groupIds | array of string | |
|
inventoryItemGroupKeys
|
inventoryItemGroupKeys | array of string |
Этот массив возвращается, если элемент инвентаризации связан с любыми группами элементов инвентаризации. |
|
Региональные настройки
|
locale | string |
Это поле возвращает естественный язык, предоставленный в значениях полей полезных данных запроса. |
|
Высота
|
packageWeightAndSize.dimensions.height | number |
Фактическая высота пакета доставки. |
|
Length
|
packageWeightAndSize.dimensions.length | number |
Фактическая длина пакета доставки. |
|
Единица
|
packageWeightAndSize.dimensions.unit | string |
Единица измерения, используемая для указания измерений пакета доставки. |
|
Ширина
|
packageWeightAndSize.dimensions.width | number |
Фактическая ширина пакета доставки. |
|
Тип пакета
|
packageWeightAndSize.packageType | string |
Это значение указывает тип пакета доставки, используемого для отправки элемента инвентаризации. |
|
Единица
|
packageWeightAndSize.weight.unit | string |
Единица измерения, используемая для указания веса пакета доставки. |
|
Ценность
|
packageWeightAndSize.weight.value | number |
Фактический вес пакета доставки. |
|
Перспектива
|
product.aspects | object |
Это коллекция пар "имя-значение", которые предоставляют дополнительные сведения о продукте и могут упростить поиск покупателей. |
|
Бренд
|
product.brand | string |
Бренд продукта. |
|
Description
|
product.description | string |
Описание продукта. |
|
ean
|
product.ean | array of string |
Номер европейской статьи/номер международной статьи (EAN) для продукта. |
|
EPID
|
product.epid | string |
Идентификатор продукта eBay (ePID) для продукта. |
|
imageUrls
|
product.imageUrls | array of string |
Массив одной или нескольких ссылок на изображения для продукта. |
|
номер ISBN
|
product.isbn | array of string |
Международное значение номера стандартной книги для продукта. |
|
MPN
|
product.mpn | string |
Номер части производителя (MPN) продукта. |
|
Субтитры
|
product.subtitle | string |
Подзаголовок является необязательной функцией перечисления, которая позволяет продавцу предоставлять дополнительные сведения о продукте, возможно, включая ключевые слова, которые могут помочь с результатами поиска. |
|
Название
|
product.title | string |
Название элемента инвентаризации можно добавить или изменить с помощью вызова createOrReplaceInventoryItem. |
|
м.
|
product.upc | array of string |
Международное значение номера стандартной книги для продукта. |
|
videoIds
|
product.videoIds | array of string |
Массив одного или нескольких значений VideoId для продукта. |
|
Артикул (SKU)
|
sku | string |
Объект инвентаризации, определенный продавцом, Stock-Keeping единица (SKU). Продавец должен иметь уникальное значение SKU для каждого продукта, который они продают. |
Определения
струна
Это базовый тип данных string.