purchases/getAll

Метод: GET

Получение списка всех закупок.

Параметры

Тип	Название	Значение
integer	count	Количество возвращаемых закупок. Максимальное значение — 500. Значение по умолчанию — 500
integer	offset	Смещение относительно первой закупки. Значение по умолчанию — 0

Результат

После успешного выполнения метод возвращает объект в поле data.

Объект содержит:

Тип	Название	Описание
array (purchase)	items	Список закупок
boolean	hasMore	Показывает, остались ли ещё закупки, которые можно получить следующим запросом

Описание полей объекта закупки находится на странице «Объект закупки — purchase».

Коды ошибок

В ходе выполнения запроса могут возникнуть общие ошибки. Их описание находится на отдельной странице.

Пример запроса

https://api.laim.bz/1.0/purchases/getAll?count=2&offset=0

Пример ответа

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "6f275c25-60c3-45ea-90e2-94fe5a493027",
        "number": 321,
        "date": "2026-07-16T00:00:00",
        "customer": "ООО Поставщик",
        "sum": 25000,
        "paid": 15000,
        "purchasedProducts": [
          {
            "productId": "8ad408c9-e877-4b48-7bb7-08d8302b0a0b",
            "article": "П1",
            "price": 500,
            "quantity": 50,
            "vat": 20
          }
        ],
        "syncStatus": 1,
        "version": 1595823441
      },
      {
        "id": "935154f3-9b45-4c5c-864f-d720996ad22a",
        "number": 322,
        "date": "2026-07-17T00:00:00",
        "customer": "ИП Иванов",
        "sum": 12000,
        "paid": 12000,
        "purchasedProducts": [
          {
            "productId": "6e0bba93-747a-4c12-ae08-7d4a8cf37232",
            "article": "МАТ-15",
            "price": 300,
            "quantity": 40,
            "vat": 20
          }
        ],
        "syncStatus": 2,
        "version": 1595823500
      }
    ],
    "hasMore": true
  }
}

Обратите внимание

Максимальное значение параметра count — 500.

Если передать значение count больше 500, метод автоматически использует значение 500.

Поле hasMore содержит true, если после текущей выборки остались другие закупки.

Для получения следующей страницы необходимо увеличить значение offset на количество уже полученных закупок.

Например:

первый запрос: count=100&offset=0;
второй запрос: count=100&offset=100;
третий запрос: count=100&offset=200.

Закупки возвращаются в порядке возрастания их идентификаторов.

ЛЭЙМ БИЗНЕС

Войти