Правила, которые одинаково работают во всех методах 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 |