# Метадані документа

**Опис параметрів**

<div class="wy-table-responsive" id="bkmrk-%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80-%D0%A2%D0%B8%D0%BF%C2%A01-%D0%A4%D0%BE%D1%80%D0%BC%D0%B0"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.4187%;"></col><col style="width: 5.95783%;"></col><col style="width: 11.2011%;"></col><col style="width: 68.3985%;"></col></colgroup><thead><tr class="row-odd"><th class="head">Параметр

</th><th class="head">Тип <sup>1</sup>

</th><th class="head">Формат

</th><th class="head">Опис

</th></tr></thead><tbody><tr class="row-even"><td>receivers

</td><td>M

</td><td>List&lt;String&gt;

</td><td>масив з UUID-ами отримувачів документа; для незареєстрованих на платформі користувачів передаються email адреси

</td></tr><tr class="row-odd"><td>number

</td><td>O

</td><td>String

</td><td>номер документа

</td></tr><tr class="row-even"><td>date

</td><td>O

</td><td>String

</td><td>дата документа

</td></tr><tr class="row-odd"><td>sum

</td><td>O

</td><td>String

</td><td>Сума (грн)

</td></tr><tr class="row-even"><td>text

</td><td>O

</td><td>String

</td><td>текст повідомлення

</td></tr><tr class="row-odd"><td>title

</td><td>M

</td><td>String

</td><td>тема документа

</td></tr><tr class="row-even"><td>recipientEDRPOU

</td><td>O

</td><td>String

</td><td>ЄДРПОУ отримувача. Якщо поле заповнено, то сервіс «Вільний» буде перевіряти отримувача на етапі підписання документа (вказане значення ЄДРПОУ та ЄДРПОУ ключа ЕЦП підписанта повинні співпадати). В разі невідповідності значення під час підписання буде виникати помилка.

</td></tr><tr class="row-odd"><td>senderEDRPOU

</td><td>O

</td><td>String

</td><td>ЄДРПОУ відправника. Якщо поле заповнено, то сервіс «Вільний» буде перевіряти відправника на етапі підписання документа (вказане значення ЄДРПОУ та ЄДРПОУ ключа ЕЦП підписанта повинні співпадати). В разі невідповідності значення під час підписання буде виникати помилка.

</td></tr><tr class="row-even"><td>googleFileName

</td><td>O

</td><td>String

</td><td>назва документа на Google Диску (відправка документа через віджет [«EDIN еПідпис»](https://workspace.google.com/u/0/marketplace/app/edin_%D0%B5%D0%BF%D1%96%D0%B4%D0%BF%D0%B8%D1%81/587777684212))

</td></tr><tr class="row-odd"><td>handleDocumentRule

</td><td>M

</td><td>int

</td><td>код правила обробки документа отримувачами:

- 0 - Всі отримувачі мають підписати документ;
- 1 - Один з отримувачів має підписати документ;
- 2 - Всі отримувачі мають прийняти документ;
- 3 - Один з отримувачів має прийняти документ

</td></tr><tr class="row-even"><td>dateUpdate

</td><td>O

</td><td>long

</td><td>дата оновлення (unix timestamp)

</td></tr></tbody></table>

</div>---

<dl class="footnote brackets" id="bkmrk-%5B1%5D---%D0%9F%D1%96%D0%B4-%D0%B2%D0%B8%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%BD%D1%8F"><dt class="label" id="bkmrk-%5B1%5D---%D0%9F%D1%96%D0%B4-%D0%B2%D0%B8%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%BD%D1%8F-1">\[1\] - Під визначенням колонки **Тип поля** мається на увазі скорочене позначення:</dt><dd>- M (mandatory) — обов’язкові до заповнення поля;
- O (optional) — необов’язкові (опціональні) до заповнення поля.

</dd></dl>**JSON приклад**

```json
{
  "receivers": [
    "85e32f82-9d86-4c36-8b3f-54eccf13b09c"
  ],
  "date": "2022-08-02",
  "title": "SomeSome",
  "googleFileName": "SomeSome.pdf",
  "handleDocumentRule": 2,
  "dateUpdate": 1659454506,
  "recipientEDRPOU": "12345678",
  "senderEDRPOU": "12345678",
  "number": "Number",
  "sum": "50.26",
  "text": "Message"
}
```