QUINCE API. Специфікації

Список методів

Метод	Опис
`/api/v2/document/specification/list`	Отримання списку документів специфікацій
`/api/v2/document/specification/add`	Додавання документа
`/api/v2/document/specification/update`	Оновлення документа
`/api/v2/document/specification/unpublish`	Зняття документа з проведення

Отримання списку документів

Назва методу: /api/v2/document/specification/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`	Ознака архівності.
`Qty`	Кількість готової продукції в специфікації.
`Company`	Організація.
`Store`	Склад за замовчуванням.
`Product`	Готова продукція.
`Responsible`	Відповідальний.
`Rows`	Рядки матеріалів.
`RowsServices`	Рядки робіт або послуг.
`RowsSalary`	Рядки зарплати.
`RowsWaste`	Рядки відходів.
`RowsSkuMaterial`	Рядки матеріалів SKU.

Приклад запиту

{
  "filter": {
    "DateFrom": "2026-06-01",
    "DateTo": "2026-06-30",
    "Company": 126
  },
  "page": 1
}

Додавання документа

Назва методу: /api/v2/document/specification/add

Метод додає один документ за запит. Якщо передати Fixed: true, API спробує провести документ після створення.

Поле	Опис
`array`	Масив з одним документом.
`array[].Date`	Дата документа.
`array[].Company`	Id організації. Необов’язковий, якщо в шаблоні документа є значення за замовчуванням.
`array[].Store`	Id складу за замовчуванням.
`array[].Product`	Id готової продукції. Обов’язковий.
`array[].Qty`	Кількість продукції, на яку задана специфікація.
`array[].Responsible`	Id відповідального. Обов’язковий.
`array[].Comment`	Коментар.
`array[].Fixed`	Провести документ після створення.
`array[].Rows`	Рядки матеріалів.
`array[].RowsServices`	Рядки робіт або послуг.
`array[].RowsWaste`	Рядки відходів.
`array[].RowsSalary`	Рядки зарплати.
`array[].RowsSkuMaterial`	Рядки матеріалів SKU.

Поля рядків

Поле	Опис
`Rows[].Product`	Id матеріалу. Обов’язковий.
`Rows[].Qty`	Кількість матеріалу.
`Rows[].Price`	Ціна матеріалу.
`Rows[].Store`	Id складу. Якщо не передати, використовується склад документа.
`RowsServices[].Product`	Id роботи або послуги.
`RowsServices[].Qty`	Кількість.
`RowsServices[].Price`	Ціна.
`RowsWaste[].Product`	Id відходу.
`RowsWaste[].Qty`	Кількість відходів.
`RowsWaste[].Price`	Ціна відходів.
`RowsSalary[].CompanyPerson`	Id співробітника.
`RowsSalary[].SalaryMoveItem`	Id статті нарахування.
`RowsSalary[].Qty`	Кількість.
`RowsSalary[].Tariff`	Тариф.
`RowsSalary[].MSum` або `RowsSalary[].Sum`	Сума рядка.
`RowsSkuMaterial[].Product`	Id SKU-продукту.
`RowsSkuMaterial[].Material`	Id матеріалу SKU.
`RowsSkuMaterial[].Store`	Id складу.
`RowsSkuMaterial[].Qty`	Кількість.
`RowsSkuMaterial[].Price`	Ціна.

Приклад створення

{
  "array": [
    {
      "Date": "2026-06-16",
      "Company": 126,
      "Store": 45,
      "Product": 9104,
      "Qty": 1,
      "Responsible": 57,
      "Comment": "Базова специфікація для SKU-варіанту",
      "Fixed": true,
      "Rows": [
        {
          "Product": 5001,
          "Qty": 1.2,
          "Price": 85,
          "Store": 45
        }
      ],
      "RowsServices": [
        {
          "Product": 8001,
          "Qty": 0.25,
          "Price": 350
        }
      ],
      "RowsWaste": [
        {
          "Product": 5009,
          "Qty": 0.05,
          "Price": 10,
          "Store": 45
        }
      ],
      "RowsSalary": [
        {
          "CompanyPerson": 301,
          "SalaryMoveItem": 12,
          "Qty": 0.25,
          "Tariff": 500,
          "MSum": 125
        }
      ],
      "RowsSkuMaterial": [
        {
          "Product": 9104,
          "Material": 5002,
          "Store": 45,
          "Qty": 0.4,
          "Price": 42
        }
      ]
    }
  ]
}

Оновлення документа

Назва методу: /api/v2/document/specification/update

Метод оновлює один документ за запит. Поле Id обов’язкове. Якщо передати Rows, RowsServices, RowsWaste, RowsSalary або RowsSkuMaterial, API замінить відповідні набори рядків перед збереженням.

Приклад оновлення

{
  "array": [
    {
      "Id": 3201,
      "Qty": 1,
      "Comment": "Уточнена специфікація після перегляду норм",
      "Rows": [
        {
          "Id": 17021,
          "Product": 5001,
          "Qty": 1.35,
          "Price": 85,
          "Store": 45
        }
      ]
    }
  ]
}

Зняття документа з проведення

Назва методу: /api/v2/document/specification/unpublish

Метод знімає з проведення один документ за запит.

{
  "array": [
    {
      "Id": 3201
    }
  ]
}