Метод: GET
Получение списка финансовых операций, которые были изменены и ожидают синхронизации.
Параметры
| Тип | Название | Значение |
|---|---|---|
| integer | count | Количество возвращаемых финансовых операций. Максимальное значение — 500. Значение по умолчанию — 500 |
| integer | offset | Смещение относительно первой финансовой операции. Значение по умолчанию — 0 |
Результат
После успешного выполнения метод возвращает объект в поле data.
Объект содержит:
| Тип | Название | Описание |
|---|---|---|
| array (finance) | items | Список изменённых финансовых операций |
| boolean | hasMore | Показывает, остались ли ещё изменённые финансовые операции, которые можно получить следующим запросом |
Описание полей объекта финансовой операции находится на странице «Объект финансовой операции — finance».
Коды ошибок
В ходе выполнения запроса могут возникнуть общие ошибки. Их описание находится на отдельной странице.
Пример запроса
https://api.laim.bz/1.0/finances/getModified?count=2&offset=0
Пример ответа
{
"success": true,
"data": {
"items": [
{
"id": "8f412f75-d041-48b8-9d48-6149a73325eb",
"number": 458,
"date": "2026-07-16T00:00:00",
"financeKind": 1,
"financeType": "Оплата клиентом",
"partner": "ООО Ромашка",
"sum": 25000,
"account": "Основной расчётный счёт",
"transferAccount": null,
"transferSum": 0,
"syncStatus": 1,
"version": 1595823441
},
{
"id": "d4f9e0bb-3126-4a94-9889-4db89be154c5",
"number": 459,
"date": "2026-07-17T00:00:00",
"financeKind": 2,
"financeType": "Комиссия банка",
"partner": null,
"sum": 1500,
"account": "Основной расчётный счёт",
"transferAccount": null,
"transferSum": 0,
"syncStatus": 1,
"version": 1595823500
}
],
"hasMore": false
}
}
Обратите внимание
Метод возвращает только финансовые операции со статусом синхронизации «изменена».
После успешной обработки финансовой операции во внешней системе необходимо вызвать метод finances/setSynced и передать идентификатор и версию обработанной операции.
Максимальное значение параметра count — 500.
Если передать значение count больше 500, метод автоматически использует значение 500.
Поле hasMore содержит true, если после текущей выборки остались другие изменённые финансовые операции.
Для получения следующей страницы необходимо увеличить значение offset на количество уже полученных финансовых операций.
Например:
- первый запрос:
count=100&offset=0; - второй запрос:
count=100&offset=100; - третий запрос:
count=100&offset=200.
Финансовые операции возвращаются в порядке возрастания их идентификаторов.