QUINCEFIN
Відкрити меню

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[].CompanyId організації. Обов’язковий, якщо не заданий у шаблоні документа.
array[].StoreId складу. Обов’язковий, якщо не заданий у шаблоні документа.
array[].ResponsibleId відповідального. Обов’язковий, якщо не заданий у шаблоні документа.
array[].CommentКоментар.
array[].FixedПровести документ після створення.
array[].Rows або array[].RowsGoodsМасив рядків товарів. Обов’язковий.

Поля рядка

ПолеОпис
ProductId товару. Обов’язковий.
QtyFactФактична кількість. Якщо не передати, береться Qty або 1.
QtyAccountОблікова кількість. За замовчуванням 0.
QtyРізниця. Якщо передані Qty і QtyFact, використовується Qty; інакше рахується як QtyFact - QtyAccount.
PriceЦіна.
SumСума. Якщо не передати, рахується як Qty * Price.
UnitId одиниці виміру. Якщо не передати, API підставить одиницю товару.
RowNoНомер рядка.
StoreId складу в рядку. Якщо не передати, береться склад документа.
MemoRows або CommentКоментар рядка.
BarcodeШтрихкод.
SeriesCodeСерія.
SeriesDateManufactureДата виробництва серії.
SeriesDateShelfLifeТермін придатності серії.
PnlItemId статті 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 або CompanyId організації. Обов’язковий.
filter.Store або StoreId складу. Обов’язковий.
filter.Date або DateДата залишків. Необов’язкова.
filter.OnlyRemaining або OnlyRemainingЯкщо 1, повертає тільки товари із залишками. За замовчуванням 1.
filter.Folder або FolderId папки товарів.
filter.Complect або ComplectОзнака комплектів. За замовчуванням 0.
{
  "filter": {
    "Company": 126,
    "Store": 132,
    "Date": "2026-03-31",
    "OnlyRemaining": 1
  }
}