purchases/getModified

Метод: GET

Получение списка закупок, которые были изменены и ожидают синхронизации.

Параметры

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

Результат

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

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

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

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

Коды ошибок

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

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

https://api.laim.bz/1.0/purchases/getModified?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": 0,
        "purchasedProducts": [
          {
            "productId": "6e0bba93-747a-4c12-ae08-7d4a8cf37232",
            "article": "МАТ-15",
            "price": 300,
            "quantity": 40,
            "vat": 20
          }
        ],
        "syncStatus": 1,
        "version": 1595823500
      }
    ],
    "hasMore": false
  }
}

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

Метод возвращает только закупки со статусом синхронизации «изменена».

После успешной обработки закупки во внешней системе необходимо вызвать метод purchases/setSynced и передать идентификатор и версию обработанной закупки.

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

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

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

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

Например:

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

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

ЛЭЙМ БИЗНЕС

Войти