QUINCE API. Інвентаризація
Список методів
| Метод | Опис |
|---|---|
/api/v2/document/inventory/list | Отримання списку документів |
/api/v2/document/inventory/add | Додавання документа |
/api/v2/document/inventory/update | Оновлення документа |
/api/v2/document/inventory/unpublish | Зняття документа з проведення |
/api/v2/document/inventory/fill_balances | Отримання залишків для заповнення інвентаризації |
Отримання списку документів
Назва методу: /api/v2/document/inventory/list
Повертає список документів інвентаризації. Для навігації використовується номер сторінки page.
Параметри запиту
| Поле | Опис |
|---|---|
filter.Id | Ідентифікатор документа. |
filter.DateFrom | Початок періоду у форматі YYYY-MM-DD або YYYY-MM-DD HH:mm:ss. |
filter.DateTo | Кінець періоду у форматі YYYY-MM-DD або YYYY-MM-DD HH:mm:ss. |
filter.Company | Ідентифікатор організації. |
filter.Archive | Ознака архівності. |
filter.MobileApp | Якщо true, API повертає збільшений ліміт елементів для мобільного сценарію. |
page | Номер сторінки. Необов’язковий. |
Основні поля відповіді
| Поле | Опис |
|---|---|
Id | Ідентифікатор документа. |
Date | Дата документа у часовому поясі користувача. |
Number | Номер документа. |
Comment | Коментар. |
Fixed | Ознака проведення документа. |
Void | Ознака архівності. |
Store | Склад. |
Company | Організація. |
Responsible | Відповідальний. |
Rows | Рядки товарів із Qty, QtyAccount, QtyFact, ціною та сумою. |
Додавання документа
Назва методу: /api/v2/document/inventory/add
Метод додає один документ за запит. Якщо передати Fixed: true, API проведе документ після створення.
| Поле | Опис |
|---|---|
array | Масив з одним документом. |
array[].Date | Дата документа. Обов’язкова, якщо не задана в шаблоні документа. |
array[].Company | Id організації. Обов’язковий, якщо не заданий у шаблоні документа. |
array[].Store | Id складу. Обов’язковий, якщо не заданий у шаблоні документа. |
array[].Responsible | Id відповідального. Обов’язковий, якщо не заданий у шаблоні документа. |
array[].Comment | Коментар. |
array[].Fixed | Провести документ після створення. |
array[].Rows або array[].RowsGoods | Масив рядків товарів. Обов’язковий. |
Поля рядка
| Поле | Опис |
|---|---|
Product | Id товару. Обов’язковий. |
QtyFact | Фактична кількість. Якщо не передати, береться Qty або 1. |
QtyAccount | Облікова кількість. За замовчуванням 0. |
Qty | Різниця. Якщо передані Qty і QtyFact, використовується Qty; інакше рахується як QtyFact - QtyAccount. |
Price | Ціна. |
Sum | Сума. Якщо не передати, рахується як Qty * Price. |
Unit | Id одиниці виміру. Якщо не передати, API підставить одиницю товару. |
RowNo | Номер рядка. |
Store | Id складу в рядку. Якщо не передати, береться склад документа. |
MemoRows або Comment | Коментар рядка. |
Barcode | Штрихкод. |
SeriesCode | Серія. |
SeriesDateManufacture | Дата виробництва серії. |
SeriesDateShelfLife | Термін придатності серії. |
PnlItem | Id статті P&L. |
Оновлення документа
Назва методу: /api/v2/document/inventory/update
Метод оновлює один документ за запит. Поле Id обов’язкове. Якщо передати Rows або RowsGoods, API замінить рядки документа перед збереженням.
Зняття документа з проведення
Назва методу: /api/v2/document/inventory/unpublish
Метод знімає з проведення один документ за запит.
{
"array": [
{
"Id": 8027
}
]
}
Отримання залишків для заповнення інвентаризації
Назва методу: /api/v2/document/inventory/fill_balances
Повертає залишки товарів для організації та складу. Метод можна використовувати, щоб підготувати рядки інвентаризації.
| Поле | Опис |
|---|---|
filter.Company або Company | Id організації. Обов’язковий. |
filter.Store або Store | Id складу. Обов’язковий. |
filter.Date або Date | Дата залишків. Необов’язкова. |
filter.OnlyRemaining або OnlyRemaining | Якщо 1, повертає тільки товари із залишками. За замовчуванням 1. |
filter.Folder або Folder | Id папки товарів. |
filter.Complect або Complect | Ознака комплектів. За замовчуванням 0. |
{
"filter": {
"Company": 126,
"Store": 132,
"Date": "2026-03-31",
"OnlyRemaining": 1
}
}