Товарные предложения: master_product_offers¶

Товарное предложение - это экземпляр общего товара, продаваемый продавцом. Сущность добавляется модулем Общие товары для продавцов.

URL¶

http://example.com/api/master_products/:id/master_product_offers — обращается ко всем предложениям одного общего товара.

Поддерживает GET и POST.

http://example.com/api/master_products/:id/master_product_offers/:id — обращается к конкретному товарному предложению общего товара.

Поддерживает GET, PUT и DELETE.

Постраничная навигация и сортировка¶

Параметры сортировки и постраничной навигации полностью наследуются от программных интерфейсов (API) товаров.

Фильтры¶

Параметры фильтрации полностью наследуются от программных интерфейсов (API) товаров. Модуль Общие товары для продавцов добавляет следующий новый параметр фильтрации, который доступен через программные интерфейсы (API) товаров:

show_master_products_only (bool[true|false]) — фильтр по типу товара, позволяет получить только общие товары либо только товары, принадлежащие продавцам.

Поля¶

Поля общих товаров полностью наследуются от программных интерфейсов (API) товаров. Модуль Общие товары для продавцов добавляет следующее новое поле, доступное как через программные интерфейсы (API) товаров, так и через программные интерфейсы (API) общих товаров:

master_product_id — идентификатор общего товара, которому принадлежит выбранное товарное предложение;
master_product_status — статус общего товара, которому принадлежит выбранное товарное предложение.

Примеры¶

Получение списка предложений общего товара с идентификатором (ID) 1:

GET /api/master_products/1/master_product_offers
Получение данных товарного предложения с идентификатором (ID) 311:

GET /api/master_products/1/master_product_offers/311
Добавление общего товара продавцу (создание товарного предложения продавца):

Запрос

POST /api/master_products/1/master_product_offers

Данные JSON

{
    "company_id": "1"
}

где company_id - идентификатор (ID) продавца. company_id является обязательным полем при добавлении товара администратором маркетплейса.

Обновление товарного предложения c идентификатором (ID) 311:

Запрос

PUT /api/master_products/1/master_product_offers/311

Данные JSON

{
       "price": "100",
       "amount": "5"
}

Удаление товарного предложения c идентификатором (ID) 311:

DELETE /api/master_products/311