Операции с поставщиками

Журнал взаиморасчётов с поставщиками: оплаты из кассы, приходы, списания и начальные остатки. Каждая строка двигает баланс поставщика в своей валюте.

Метод	Адрес	Назначение
POST	`/company/supplier/transaction/{model}/refund`	Вернуть оплату поставщику
GET	`/company/supplier/transaction`	Список операций с поставщиками
GET	`/company/supplier/transaction/{model}`	Операция с поставщиком

Вернуть оплату поставщику

POST/company/supplier/transaction/{model}/refund

Отменяет оплату поставщику из кассы, проведённую сегодня: деньги возвращаются в кассу (кассовая операция отменяется), сумма снова становится нашим долгом. Строка журнала остаётся с is_refunded = true и комментарием. Другие операции или вчерашняя оплата — 400.

Заголовки

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

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

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

Тело запроса

Поле	Тип	Обязательно	Описание
`comment`	string	Да	Комментарий. Макс. 1000 символов

JSONcURL

json

{
    "comment": "Поставщик вернул деньги"
}

bash

curl -X POST "https://api.wasyt.uz/company/supplier/transaction/226/refund" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"comment":"Поставщик вернул деньги"}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
`id`	integer	ID
`company_id`	integer	Компания
`supplier_id`	integer	Поставщик
`type`	string	Тип
`currency`	string	Валюта
`amount`	integer	Сумма
`source_type`	string	Источник
`source_id`	integer	Источник
`source_data`	object
`source_data.creator_id`	integer	Создатель
`source_data.payment_type`	string	Тип оплаты
`is_refunded`	boolean
`refund_comment`	string
`refunded_at`	string
`created_at`	string	Создано
`is_refundable`	boolean

json

{
    "id": 226,
    "company_id": 1,
    "supplier_id": 1,
    "type": "outcome",
    "currency": "uzs",
    "amount": 300,
    "source_type": "cashbox_transaction",
    "source_id": 126,
    "source_data": {
        "creator_id": 2,
        "payment_type": "cash"
    },
    "is_refunded": true,
    "refund_comment": "Поставщик вернул деньги",
    "refunded_at": "2026-09-30T07:53:48.681791Z",
    "created_at": "2026-09-30 12:53:48",
    "is_refundable": false
}

Список операций с поставщиками

GET/company/supplier/transaction

Постраничный журнал операций доступных компаний; фильтры по поставщику, типу, валюте, источнику (cashbox_transaction, trade_purchase, trade_writeoff, opening_balance) и дате. with[]=creator_full_name, with[]=payment_type добавляют автора и способ оплаты; format=excel отдаёт выгрузку.

Заголовки

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

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

Параметр	Описание
`filter[id]`	ID — точное значение
`filter[supplier_id]`	Поставщик — точное значение
`filter[type]`	Тип — точное значение
`filter[currency]`	Валюта — точное значение
`filter[source_type]`	Источник — точное значение
`filter[source_id]`	Источник — точное значение
`filter[created_at]`	Создано — период: `[0]` — с, `[1]` — по (`Y-m-d`)
`sort[]`	Сортировка, `-` — по убыванию: `id`, `-id`
`with[]`	Подгрузить связи: `supplier`
`page`	Номер страницы, с 1
`page-size`	Записей на странице, не больше 20

http

GET /company/supplier/transaction?sort[0]=id&sort[1]=-id

Ответ · 200

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

Поля ответа

Поле	Тип	Описание
`data`	object[]	Данные
`data[].id`	integer	ID
`data[].company_id`	integer	Компания
`data[].supplier_id`	integer	Поставщик
`data[].type`	string	Тип
`data[].currency`	string	Валюта
`data[].amount`	integer	Сумма
`data[].source_type`	string	Источник
`data[].source_id`	integer	Источник
`data[].source_data`	array
`data[].is_refunded`	boolean
`data[].refund_comment`	null
`data[].refunded_at`	null
`data[].created_at`	string	Создано
`data[].is_refundable`	boolean

json

{
    "data": [
        {
            "id": 1,
            "company_id": 1,
            "supplier_id": 1,
            "type": "income",
            "currency": "uzs",
            "amount": 1000,
            "source_type": "trade_purchase",
            "source_id": 1,
            "source_data": [],
            "is_refunded": false,
            "refund_comment": null,
            "refunded_at": null,
            "created_at": "2026-09-30 12:47:58",
            "is_refundable": false
        },
        {
            "id": 2,
            "company_id": 1,
            "supplier_id": 1,
            "type": "outcome",
            "currency": "usd",
            "amount": 2000,
            "source_type": "cashbox_transaction",
            "source_id": 1,
            "source_data": [],
            "is_refunded": false,
            "refund_comment": null,
            "refunded_at": null,
            "created_at": "2026-09-30 12:47:58",
            "is_refundable": true
        }
    ],
    "links": {
        "first": "https://api.wasyt.uz/company/supplier/transaction?page=1",
        "last": "https://api.wasyt.uz/company/supplier/transaction?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/company/supplier/transaction",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}

Операция с поставщиком

GET/company/supplier/transaction/{model}

Одна операция журнала взаиморасчётов по ID.

Заголовки

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

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

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

Ответ · 200

Поля ответа

Поле	Тип	Описание
`id`	integer	ID
`company_id`	integer	Компания
`supplier_id`	integer	Поставщик
`type`	string	Тип
`currency`	string	Валюта
`amount`	integer	Сумма
`source_type`	string	Источник
`source_id`	integer	Источник
`source_data`	array
`is_refunded`	boolean
`refund_comment`	null
`refunded_at`	null
`created_at`	string	Создано
`is_refundable`	boolean

json

{
    "id": 1,
    "company_id": 1,
    "supplier_id": 1,
    "type": "income",
    "currency": "uzs",
    "amount": 1000,
    "source_type": "trade_purchase",
    "source_id": 1,
    "source_data": [],
    "is_refunded": false,
    "refund_comment": null,
    "refunded_at": null,
    "created_at": "2026-09-30 12:47:58",
    "is_refundable": false
}

Операции с поставщиками ​

Вернуть оплату поставщику ​

Заголовки ​

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

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

Ответ · 200 ​

Список операций с поставщиками ​

Заголовки ​

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

Ответ · 200 ​

Операция с поставщиком ​

Заголовки ​

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

Ответ · 200 ​

Операции с поставщиками

Вернуть оплату поставщику

Заголовки

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

Тело запроса

Ответ · 200

Список операций с поставщиками

Заголовки

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

Ответ · 200

Операция с поставщиком

Заголовки

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

Ответ · 200