Товарные предложения: 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