Максим

Максим

Обновлено Oct 8, 2026

Правила, которые одинаково работают во всех методах API.

Точность чисел

Количества хранятся с точностью до 3 знаков после запятой, суммы и цены до копеек. API округляет переданные значения так же, как интерфейс Controlata: 0.3333 сохранится как 0.333, 10.125 как 10.13. Количество в строках операций должно оставаться больше нуля после округления: 0.0004 будет отклонено.

Редактирование

Методы edit меняют только переданные поля. Обязателен только ID записи, остальные поля остаются прежними.

  • Массивы (строки операции, категории, поставщики, состав продукта) при передаче заменяются целиком. Чтобы очистить массив, передайте пустой массив.
  • Если передан хотя бы один из массивов materials и products, строки операции заменяются целиком, а непереданный массив считается пустым. Если не передан ни один, строки не меняются.

Например, чтобы изменить только заметки поставки, достаточно передать purchase_id и notes: строки, даты, склады и поставщик останутся прежними.

Постраничная выдача

Методы get_list принимают необязательные параметры постраничной выдачи. Исключение: небольшие справочники (единицы измерения, категории и склады) всегда возвращаются целиком и этих параметров не принимают.

Поле Тип Описание
limit int Размер страницы, от 1 до 1000
offset int Сколько записей пропустить. Передается вместе с limit

Без limit возвращается весь список. В ответе есть поле total с общим числом записей, подходящих под фильтры.

Ошибка Причина
Invalid limit value. Must be between 1 and 1000 Неверный limit
Invalid offset value. Must be 0 or greater Неверный offset
Offset requires limit Передан offset без limit