Search

orders/getModified

Метод: GET

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

Параметры

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

Результат

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

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

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

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

Коды ошибок

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

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

https://api.laim.bz/1.0/orders/getModified?count=2&offset=0

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

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "b11219bf-11c3-44c7-b733-1729e91e03c8",
        "number": 1058,
        "date": "2026-07-16T00:00:00",
        "customer": "ООО Ромашка",
        "sum": 2000.00000000,
        "paid": 2000.00000000,
        "deliveryAddress": "г. Москва, ул. Примерная, д. 10, кв. 15",
        "orderedProducts": [
          {
            "productId": "b0767fdf-5016-47aa-7bc3-08d8302b0a0b",
            "article": "П1.14.7",
            "price": 750.00000000,
            "quantity": 2.00000000,
            "vat": -1
          },
          {
            "productId": "ec4c6fa7-64e1-48eb-b07d-c61ec88caf51",
            "article": "У1",
            "price": 500.00000000,
            "quantity": 1.00000000,
            "vat": -1
          }
        ],
        "syncStatus": 1,
        "version": 1595823441
      },
      {
        "id": "4199445e-a603-421d-8465-2ad4ea314295",
        "number": 1059,
        "date": "2026-07-16T00:00:00",
        "customer": "Иванов Иван",
        "sum": 750.00000000,
        "paid": 0.00000000,
        "deliveryAddress": "г. Москва, ул. Новая, д. 5",
        "orderedProducts": [
          {
            "productId": "b0767fdf-5016-47aa-7bc3-08d8302b0a0b",
            "article": "П1.14.7",
            "price": 750.00000000,
            "quantity": 1.00000000,
            "vat": -1
          }
        ],
        "syncStatus": 1,
        "version": 1595823500
      }
    ],
    "hasMore": false
  }
}

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

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

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

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

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

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

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

Например:

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

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