QUINCE API. Випуск продукції

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

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

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

Назва методу: /api/v2/document/manufacture/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`	Ознака архівності.
`Company`	Організація.
`StoreMaterials`	Склад матеріалів.
`StoreProducts`	Склад готової продукції.
`Product`	Випущена продукція.
`QtyProduct`	Кількість випущеної продукції.
`ProductCost`	Собівартість випущеної продукції.
`Responsible`	Відповідальний.
`RowsMaterial`	Рядки матеріалів у відповіді списку.
`RowsService`	Рядки робіт або послуг у відповіді списку.
`RowsSalary`	Рядки нарахувань зарплати у відповіді списку.
`RowsWaste`	Рядки відходів у відповіді списку.
`RowsSkuMaterial`	Рядки матеріалів SKU у відповіді списку.

Поля рядків у відповіді списку

Поле	Опис
`RowsMaterial[].Material`	Матеріал.
`RowsMaterial[].QtyMaterial`	Кількість матеріалу.
`RowsMaterial[].MaterialCost`	Собівартість матеріалу.
`RowsService[].Service`	Робота або послуга.
`RowsService[].QtyService`	Кількість роботи або послуги.
`RowsService[].SumService`	Сума роботи або послуги.
`RowsSalary[].CompanyPerson`	Співробітник.
`RowsSalary[].SalaryMoveItem`	Стаття нарахування.
`RowsSalary[].Qty`	Кількість.
`RowsSalary[].Tariff`	Тариф.
`RowsSalary[].Sum`	Сума нарахування.
`RowsWaste[].Product`	Товар-відхід.
`RowsWaste[].Qty`	Кількість відходів.
`RowsWaste[].Price`	Ціна відходів.
`RowsSkuMaterial[].Product`	SKU-продукція.
`RowsSkuMaterial[].Material`	Матеріал SKU.
`RowsSkuMaterial[].Qty`	Кількість матеріалу SKU.

Для list API повертає масиви RowsMaterial і RowsService. Для add та update використовуються payload-поля Rows і RowsServices.

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

{
  "filter": {
    "DateFrom": "2026-03-01",
    "DateTo": "2026-03-31",
    "Company": 126
  },
  "page": 1
}

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

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

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

Поле	Опис
`array`	Масив з одним документом.
`array[].Date`	Дата документа.
`array[].Company`	Id організації. Обов’язковий.
`array[].StoreFrom`	Id складу матеріалів. Обов’язковий.
`array[].StoreTo`	Id складу готової продукції. Обов’язковий.
`array[].Product`	Id готової продукції. Обов’язковий.
`array[].Qty`	Кількість випущеної продукції.
`array[].Specification`	Id специфікації, якщо документ створюється на її основі.
`array[].InnerSpecification`	Внутрішня специфікація, якщо використовується у сценарії виробництва.
`array[].Responsible`	Id відповідального. Обов’язковий.
`array[].SalaryPeriod`	Період нарахування зарплати.
`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 складу в рядку. Якщо не передати, береться `StoreFrom`.
`Rows[].Unit`	Id одиниці виміру. Якщо не передати, API підставить одиницю товару.
`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`	Кількість матеріалу SKU.
`RowsSkuMaterial[].Price`	Ціна матеріалу SKU.

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

{
  "array": [
    {
      "Date": "2026-06-16",
      "Company": 126,
      "StoreFrom": 45,
      "StoreTo": 48,
      "Product": 9104,
      "Qty": 10,
      "Specification": 3201,
      "Responsible": 57,
      "SalaryPeriod": "2026-06-01",
      "Comment": "Випуск партії 16-06",
      "Fixed": true,
      "Rows": [
        {
          "Product": 5001,
          "Qty": 12,
          "Price": 85,
          "Store": 45
        }
      ],
      "RowsServices": [
        {
          "Product": 8001,
          "Qty": 1,
          "Price": 350
        }
      ],
      "RowsWaste": [
        {
          "Product": 5009,
          "Qty": 0.5,
          "Price": 10,
          "Store": 45
        }
      ],
      "RowsSalary": [
        {
          "CompanyPerson": 301,
          "SalaryMoveItem": 12,
          "Qty": 1,
          "Tariff": 500,
          "MSum": 500
        }
      ],
      "RowsSkuMaterial": [
        {
          "Product": 9104,
          "Material": 5002,
          "Store": 45,
          "Qty": 4,
          "Price": 42
        }
      ]
    }
  ]
}

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

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

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

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

{
  "array": [
    {
      "Id": 8452,
      "Comment": "Оновлений випуск після коригування витрат",
      "Fixed": true,
      "Rows": [
        {
          "Id": 12011,
          "Product": 5001,
          "Qty": 13,
          "Price": 85,
          "Store": 45
        }
      ]
    }
  ]
}

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

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

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

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