Бонус за товар

Правила бонуса продавцу за продажу конкретных товаров: для каждого товара задаётся процент или фиксированная сумма бонуса.

Метод	Адрес	Назначение
GET	`/company/bonus/product-rule`	Список правил бонуса за товар
GET	`/company/bonus/product-rule/{model}`	Правило бонуса за товар
POST	`/company/bonus/product-rule`	Создать правило бонуса за товар
PUT	`/company/bonus/product-rule/{model}`	Изменить правило бонуса за товар
DELETE	`/company/bonus/product-rule/{model}`	Удалить правило бонуса за товар

Список правил бонуса за товар

GET/company/bonus/product-rule

Постраничный список правил доступных компаний; фильтры по названию, активности и дате, товары правила подгружаются через with[]=items.product.

Заголовки

Заголовок	Значение	Описание
`Authorization`	`Bearer {token}`	Токен из `POST /common/auth/login`
`Accept`	`application/json`	Ответ в JSON
`Accept-Language`	`ru`	Язык сообщений и названий: `ru`, `uz`, `oz`

Параметры запроса

Параметр	Описание
`filter[id]`	ID — точное значение
`filter[company_id]`	Компания — точное значение
`filter[name]`	Название — поиск по части строки
`filter[is_active]`	Активен — точное значение
`filter[created_at]`	Создано — период: `[0]` — с, `[1]` — по (`Y-m-d`)
`sort[]`	Сортировка, `-` — по убыванию: `id`, `-id`, `name`, `-name`, `created_at`, `-created_at`
`with[]`	Подгрузить связи: `creator.profile`, `company`, `items.product.brand`, `items.product.unit`, `items.product.price`
`page`	Номер страницы, с 1
`page-size`	Записей на странице, не больше 20

http

GET /company/bonus/product-rule?with[0]=items.product.price

Ответ · 200

Постраничный ответ: записи в data[], пагинация в links и meta.

Поля ответа

Поле	Тип	Описание
`data`	object[]	Данные
`data[].id`	integer	ID
`data[].creator_id`	integer	Создатель
`data[].updater_id`	integer	Обновитель
`data[].company_id`	integer	Компания
`data[].name`	string	Название
`data[].is_active`	boolean	Активен
`data[].is_discounted_excluded`	boolean	Не начисляется при продаже со скидкой
`data[].is_return_deducted`	boolean	Возврат вычитается из бонуса
`data[].items_count`	integer
`data[].created_at`	string	Создано
`data[].updated_at`	string	Обновлено
`data[].items`	object[]	Состав
`data[].items[].id`	integer	ID
`data[].items[].company_id`	integer	Компания
`data[].items[].rule_id`	integer
`data[].items[].product_id`	integer	Продукт
`data[].items[].percent`	integer	Процент
`data[].items[].amount`	null	Сумма
`data[].items[].created_at`	string	Создано
`data[].items[].updated_at`	string	Обновлено
`data[].items[].product`	object
`data[].items[].product.id`	integer	ID
`data[].items[].product.parent_id`	null	Родитель
`data[].items[].product.creator_id`	integer	Создатель
`data[].items[].product.company_id`	integer	Компания
`data[].items[].product.category_id`	integer	Категория
`data[].items[].product.brand_id`	integer	Бренд
`data[].items[].product.unit_id`	integer	Единица измерения
`data[].items[].product.name`	string	Название
`data[].items[].product.full_text`	string	Полный текст
`data[].items[].product.plu`	string	Артикул (PLU)
`data[].items[].product.description`	string	Описание
`data[].items[].product.is_free_price`	boolean	Продажа по свободной цене
`data[].items[].product.is_favorite`	boolean
`data[].items[].product.min_quantity`	null
`data[].items[].product.barcode`	string	Штрих-код
`data[].items[].product.images_list`	array	Изображения
`data[].items[].product.images_list_thumbs`	object[]
`data[].items[].product.images_list_thumbs[].widen_100`	object
`data[].items[].product.images_list_thumbs[].widen_500`	object
`data[].items[].product.images_list_thumbs[].original`	object
`data[].items[].product.created_at`	string	Создано
`data[].items[].product.updated_at`	string	Обновлено
`data[].items[].product.is_deleted`	boolean
`data[].items[].product.price`	object	Цена
`data[].items[].product.price.id`	integer	ID
`data[].items[].product.price.updater_id`	integer	Обновитель
`data[].items[].product.price.company_id`	integer	Компания
`data[].items[].product.price.product_id`	integer	Продукт
`data[].items[].product.price.source_type`	string	Источник
`data[].items[].product.price.source_id`	integer	Источник
`data[].items[].product.price.price`	integer	Цена
`data[].items[].product.price.currency`	string	Валюта
`data[].items[].product.price.min_price`	null
`data[].items[].product.price.min_price_percent`	null
`data[].items[].product.price.created_at`	string	Создано
`data[].items[].product.price.updated_at`	string	Обновлено
`data[].items[].product.price.effective_min_price`	integer
`data[].items[].product.price.price_uzs`	integer
`data[].items[].product.price.effective_min_price_uzs`	integer
`data[].items[].product.price.price_usd`	number
`data[].items[].product.price.effective_min_price_usd`	integer
`data[].items[].product.price.price_eur`	number
`data[].items[].product.price.effective_min_price_eur`	integer
`data[].items[].product.price.price_rub`	number
`data[].items[].product.price.effective_min_price_rub`	integer

json

{
    "data": [
        {
            "id": 4,
            "creator_id": 2,
            "updater_id": 2,
            "company_id": 1,
            "name": "Rule",
            "is_active": true,
            "is_discounted_excluded": false,
            "is_return_deducted": false,
            "items_count": 1,
            "created_at": "2026-09-30 12:51:06",
            "updated_at": "2026-09-30 12:51:06",
            "items": [
                {
                    "id": 6,
                    "company_id": 1,
                    "rule_id": 4,
                    "product_id": 1,
                    "percent": 5,
                    "amount": null,
                    "created_at": "2026-09-30 12:51:06",
                    "updated_at": "2026-09-30 12:51:06",
                    "product": {
                        "id": 1,
                        "parent_id": null,
                        "creator_id": 1,
                        "company_id": 1,
                        "category_id": 4,
                        "brand_id": 1,
                        "unit_id": 1,
                        "name": "Product 1",
                        "full_text": "Product 1",
                        "plu": "0001",
                        "description": "Description 1",
                        "is_free_price": false,
                        "is_favorite": false,
                        "min_quantity": null,
                        "barcode": "0000000000001",
                        "images_list": [
                            "https://api-minio.icangroup.uz/wasyt/test_data/images/1.png",
                            "https://api-minio.icangroup.uz/wasyt/test_data/images/2.png"
                        ],
                        "images_list_thumbs": [
                            {
                                "widen_100": {
                                    "raw": "https://api-minio.icangroup.uz/wasyt/test_data/images/1.png",
                                    "webp": "https://api-minio.icangroup.uz/wasyt/test_data/images/1.png"
                                },
                                "widen_500": {
                                    "raw": "https://api-minio.icangroup.uz/wasyt/test_data/images/1.png",
                                    "webp": "https://api-minio.icangroup.uz/wasyt/test_data/images/1.png"
                                },
                                "original": {
                                    "raw": "https://api-minio.icangroup.uz/wasyt/test_data/images/1.png",
                                    "webp": "https://api-minio.icangroup.uz/wasyt/test_data/images/1.png"
                                }
                            },
                            {
                                "widen_100": {
                                    "raw": "https://api-minio.icangroup.uz/wasyt/test_data/images/2.png",
                                    "webp": "https://api-minio.icangroup.uz/wasyt/test_data/images/2.png"
                                },
                                "widen_500": {
                                    "raw": "https://api-minio.icangroup.uz/wasyt/test_data/images/2.png",
                                    "webp": "https://api-minio.icangroup.uz/wasyt/test_data/images/2.png"
                                },
                                "original": {
                                    "raw": "https://api-minio.icangroup.uz/wasyt/test_data/images/2.png",
                                    "webp": "https://api-minio.icangroup.uz/wasyt/test_data/images/2.png"
                                }
                            }
                        ],
                        "created_at": "2026-09-30 12:47:59",
                        "updated_at": "2026-09-30 12:51:06",
                        "is_deleted": false,
                        "price": {
                            "id": 1,
                            "updater_id": 2,
                            "company_id": 1,
                            "product_id": 1,
                            "source_type": "purchase",
                            "source_id": 1,
                            "price": 1100,
                            "currency": "uzs",
                            "min_price": null,
                            "min_price_percent": null,
                            "created_at": "2026-09-30 12:47:59",
                            "updated_at": "2026-09-30 12:47:59",
                            "effective_min_price": 0,
                            "price_uzs": 1100,
                            "effective_min_price_uzs": 0,
                            "price_usd": 1.1,
                            "effective_min_price_usd": 0,
                            "price_eur": 1.1,
                            "effective_min_price_eur": 0,
                            "price_rub": 1.1,
                            "effective_min_price_rub": 0
                        }
                    }
                }
            ]
        }
    ],
    "links": {
        "first": "https://api.wasyt.uz/company/bonus/product-rule?page=1",
        "last": "https://api.wasyt.uz/company/bonus/product-rule?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/company/bonus/product-rule",
        "per_page": 20,
        "to": 1,
        "total": 1
    }
}

Правило бонуса за товар

GET/company/bonus/product-rule/{model}

Одно правило по ID вместе с запрошенными связями.

Заголовки

Заголовок	Значение	Описание
`Authorization`	`Bearer {token}`	Токен из `POST /common/auth/login`
`Accept`	`application/json`	Ответ в JSON
`Accept-Language`	`ru`	Язык сообщений и названий: `ru`, `uz`, `oz`

Параметры пути

Параметр	Описание
`model`	ID записи

Ответ

Пример ответа пока не записан тестами.

Создать правило бонуса за товар

POST/company/bonus/product-rule

Создаёт правило со списком товаров; у каждого товара должен быть задан процент или сумма бонуса, но не оба сразу. Товары берутся из каталога семьи компаний. Флаги: is_active (по умолчанию true), is_discounted_excluded — не начислять за товары со скидкой, is_return_deducted — вычитать бонус при возврате.

Заголовки

Заголовок	Значение	Описание
`Authorization`	`Bearer {token}`	Токен из `POST /common/auth/login`
`Accept`	`application/json`	Ответ в JSON
`Accept-Language`	`ru`	Язык сообщений и названий: `ru`, `uz`, `oz`

Тело запроса

Поле	Тип	Обязательно	Описание
`company_id`	integer	Да	Компания. ID существующей записи, доступной пользователю
`name`	string	Да	Название. Макс. 255 символов
`is_active`	boolean	Нет	Активен
`is_discounted_excluded`	boolean	Нет	Не начисляется при продаже со скидкой
`is_return_deducted`	boolean	Нет	Возврат вычитается из бонуса
`items`	object[]	Да	Состав. Мин. 1 элементов. Макс. 1000 элементов
`items[].product_id`	integer	Да	Товар. Без повторов
`items[].percent`	number	Нет	Бонус %. До 2 знаков после запятой. > `0`. Не больше 100
`items[].amount`	number	Нет	FSM бонус. До 2 знаков после запятой. Не меньше 0.01. Не больше 999999999999.99. > `0`

JSONcURL

json

{
    "company_id": 1,
    "name": "Сентябрь — бонус за телевизоры",
    "is_discounted_excluded": 1,
    "is_return_deducted": 1,
    "items": [
        {
            "product_id": 1,
            "percent": 5
        },
        {
            "product_id": 2,
            "amount": 500
        }
    ]
}

bash

curl -X POST "https://api.wasyt.uz/company/bonus/product-rule" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"company_id":1,"name":"Сентябрь — бонус за телевизоры","is_discounted_excluded":1,"is_return_deducted":1,"items":[{"product_id":1,"percent":5},{"product_id":2,"amount":500}]}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
`company_id`	integer	Компания
`name`	string	Название
`is_discounted_excluded`	boolean	Не начисляется при продаже со скидкой
`is_return_deducted`	boolean	Возврат вычитается из бонуса
`is_active`	boolean	Активен
`updated_at`	string	Обновлено
`created_at`	string	Создано
`updater_id`	integer	Обновитель
`creator_id`	integer	Создатель
`id`	integer	ID
`items_count`	integer

json

{
    "company_id": 1,
    "name": "Сентябрь — бонус за телевизоры",
    "is_discounted_excluded": true,
    "is_return_deducted": true,
    "is_active": true,
    "updated_at": "2026-09-30 12:51:05",
    "created_at": "2026-09-30 12:51:05",
    "updater_id": 2,
    "creator_id": 2,
    "id": 1,
    "items_count": 2
}

Пример ошибки · 422

json

{
    "message": "Укажите либо процент бонуса, либо фиксированную сумму",
    "errors": {
        "items.0.percent": [
            "Укажите либо процент бонуса, либо фиксированную сумму"
        ]
    }
}

Изменить правило бонуса за товар

PUT/company/bonus/product-rule/{model}

Обновляет правило и полностью заменяет его список товаров переданным items. Компания правила не меняется, даже если передан другой company_id.

Из формы (multipart/form-data) метод PUT отправляется как POST с параметром ?_method=PUT.

Заголовки

Заголовок	Значение	Описание
`Authorization`	`Bearer {token}`	Токен из `POST /common/auth/login`
`Accept`	`application/json`	Ответ в JSON
`Accept-Language`	`ru`	Язык сообщений и названий: `ru`, `uz`, `oz`

Параметры пути

Параметр	Описание
`model`	ID записи

Тело запроса

Поле	Тип	Обязательно	Описание
`company_id`	integer	Да	Компания. ID существующей записи, доступной пользователю
`name`	string	Да	Название. Макс. 255 символов
`is_active`	boolean	Нет	Активен
`is_discounted_excluded`	boolean	Нет	Не начисляется при продаже со скидкой
`is_return_deducted`	boolean	Нет	Возврат вычитается из бонуса
`items`	object[]	Да	Состав. Мин. 1 элементов. Макс. 1000 элементов
`items[].product_id`	integer	Да	Товар. Без повторов
`items[].percent`	number	Нет	Бонус %. До 2 знаков после запятой. > `0`. Не больше 100
`items[].amount`	number	Нет	FSM бонус. До 2 знаков после запятой. Не меньше 0.01. Не больше 999999999999.99. > `0`

JSONcURL

json

{
    "company_id": 1,
    "name": "Сентябрь — бонус за телевизоры",
    "is_discounted_excluded": 1,
    "is_return_deducted": 1,
    "items": [
        {
            "product_id": 2,
            "amount": 700
        }
    ]
}

bash

curl -X PUT "https://api.wasyt.uz/company/bonus/product-rule/3" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"company_id":1,"name":"Сентябрь — бонус за телевизоры","is_discounted_excluded":1,"is_return_deducted":1,"items":[{"product_id":2,"amount":700}]}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
`id`	integer	ID
`creator_id`	integer	Создатель
`updater_id`	integer	Обновитель
`company_id`	integer	Компания
`name`	string	Название
`is_active`	boolean	Активен
`is_discounted_excluded`	boolean	Не начисляется при продаже со скидкой
`is_return_deducted`	boolean	Возврат вычитается из бонуса
`items_count`	integer
`created_at`	string	Создано
`updated_at`	string	Обновлено

json

{
    "id": 3,
    "creator_id": 2,
    "updater_id": 2,
    "company_id": 1,
    "name": "Сентябрь — бонус за телевизоры",
    "is_active": true,
    "is_discounted_excluded": true,
    "is_return_deducted": true,
    "items_count": 1,
    "created_at": "2026-09-30 12:51:05",
    "updated_at": "2026-09-30 12:51:06"
}

Удалить правило бонуса за товар

DELETE/company/bonus/product-rule/{model}

Удаляет правило вместе с его товарами.

Из формы (multipart/form-data) метод DELETE отправляется как POST с параметром ?_method=DELETE.

Заголовки

Заголовок	Значение	Описание
`Authorization`	`Bearer {token}`	Токен из `POST /common/auth/login`
`Accept`	`application/json`	Ответ в JSON
`Accept-Language`	`ru`	Язык сообщений и названий: `ru`, `uz`, `oz`

Параметры пути

Параметр	Описание
`model`	ID записи

Ответ · 200

Поля ответа

Поле	Тип	Описание
`message`	string	Сообщение

json

{
    "message": "Success"
}

Бонус за товар ​

Список правил бонуса за товар ​

Заголовки ​

Параметры запроса ​

Ответ · 200 ​

Правило бонуса за товар ​

Заголовки ​

Параметры пути ​

Ответ ​

Создать правило бонуса за товар ​

Заголовки ​

Тело запроса ​

Ответ · 200 ​

Пример ошибки · 422 ​

Изменить правило бонуса за товар ​

Заголовки ​

Параметры пути ​

Тело запроса ​

Ответ · 200 ​

Удалить правило бонуса за товар ​

Заголовки ​

Параметры пути ​

Ответ · 200 ​

Бонус за товар

Список правил бонуса за товар

Заголовки

Параметры запроса

Ответ · 200

Правило бонуса за товар

Заголовки

Параметры пути

Ответ

Создать правило бонуса за товар

Заголовки

Тело запроса

Ответ · 200

Пример ошибки · 422

Изменить правило бонуса за товар

Заголовки

Параметры пути

Тело запроса

Ответ · 200

Удалить правило бонуса за товар

Заголовки

Параметры пути

Ответ · 200