> For the complete documentation index, see [llms.txt](https://api-portal.novapost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-portal.novapost.com/changelog-1/documentation-1/robota-z-suprovidnimi-dokumentami-do-men-cherez-kliyentske-api.md).

# Робота з супровідними документами до МЕН через клієнтське апі

### Огляд доступних операцій <a href="#oglyad-dostupnikh-operacii" id="oglyad-dostupnikh-operacii"></a>

| Операція                            | Що робить                                                    | Результат для клієнта                                       |
| ----------------------------------- | ------------------------------------------------------------ | ----------------------------------------------------------- |
| Завантаження супровідних документів | Додає файл(и) у систему                                      | Документ збережено та доступний для подальшого використання |
| Видалення документів                | Прибирає раніше завантажений документ                        | Документ більше не доступний для перегляду/завантаження     |
| Отримання списку документів         | Показує перелік доступних документів за вибраними критеріями | Ви бачите, які документи вже є в системі                    |
| Отримання файлу                     | Дозволяє завантажити конкретний документ на ваш пристрій     | Ви отримуєте копію потрібного файлу                         |

### Загальні вимоги до файлів <a href="#zagalni-vimogi-do-failiv" id="zagalni-vimogi-do-failiv"></a>

* **Типи файлів**
  * Поширені формати: PDF, JPG/JPEG, PNG, DOC, DOCX, XLS, XLSX.
  * Якщо ви не впевнені, чи підтримується формат: спробуйте завантажити файл — система повідомить, якщо формат не дозволений.
* **Розмір файлу**
  * Максимальний розмір файлу до 1 Мб.
* **Вимоги до назв файлів**
  * Рекомендовано:
    * використовувати латиницю, цифри, дефіс і нижнє підкреслення;
    * уникати спеціальних символів (`/ \ ? % * : | " < >` тощо);
    * не робити назву надто довгою.
  * Приклади рекомендованих назв:
    * `invoice_12345.pdf`
    * `contract_client_v2.pdf`
    * `photo_package_front.jpg`
* **Загальні поради**
  * Перед завантаженням перевірте, що файл відкривається на вашому комп’ютері.
  * Не завантажуйте архіви з паролем.
  * Не завантажуйте файли, що містять шкідливе ПЗ або конфіденційну інформацію, не призначену для обробки в системі.

### Завантаження супровідних документів <a href="#zavantazhennya-suprovidnikh-dokumentiv" id="zavantazhennya-suprovidnikh-dokumentiv"></a>

#### Призначення <a href="#priznachennya" id="priznachennya"></a>

Операція завантаження супровідних документів дозволяє додати ваші файли до міжнародної експрес-накладної, щоб:

* надати їх для подальшої перевірки чи обробки митним брокером;
* мати доступ до них у будь-який час у межах порталу.

#### Коли використовувати <a href="#koli-vikoristovuvati" id="koli-vikoristovuvati"></a>

* Ви створили МЕН, і вам треба додати якісь супроводжуючи документи, окрім інвойса.
* Вам потрібно завантажити оновлену версію інвойса.

#### Параметри / обмеження <a href="#parametri-obmezhennya" id="parametri-obmezhennya"></a>

* **Типи файлів**: підтримувані формати вказані в блоці «Загальні вимоги до файлів».
* **Розмір**: максимальний обсяг файлу залежить від налаштувань; при перевищенні метод віддасть помилку.
* **Кількість файлів**:
  * можливе завантаження до 12 файлів, але сумарний розмір не має перевищувати 10 Мб;
  * при масовому завантаженні окремі файли можуть бути відхилені (через формат або розмір).
* **Типи документів:**

| **Код документу** (typeCode) по клієнтському апі | **Значення**                            |
| ------------------------------------------------ | --------------------------------------- |
| 0271                                             | Пакувальний лист (Packing list)         |
| 0325                                             | Рахунок Проформа (Proforma Invoice)     |
| 0851                                             | Фітосанітарний сертифікат               |
| 0852                                             | Міжнародний Санітарний Сертифікат       |
| 0853                                             | Міжнародний Ветеринарний Сертифікат     |
| 0861                                             | Сертифікат про походження товару        |
| 0954                                             | Сертифікат про походження товару EUR-1  |
| 3023                                             | Геологічний Висновок                    |
| 4100                                             | Договір (Контракт) ЗЕД (Sales Contract) |
| 4103                                             | Додаток/Специфікація до Договору ЗЕД    |
| 9000                                             | Інше                                    |
| 0380                                             | Рахунок Фактура (Comercial Invoice)     |

#### Типові помилки та як їх уникнути <a href="#tipovi-pomilki-ta-yak-yikh-uniknuti" id="tipovi-pomilki-ta-yak-yikh-uniknuti"></a>

* **Файл не завантажується / з’являється повідомлення про помилку формату**
  * Переконайтесь, що формат файлу входить до підтримуваних.
  * За необхідності збережіть документ у форматі PDF або іншому стандартному форматі.
* **Файл завеликий**
  * Спробуйте зменшити розмір (стиснути зображення, зробити PDF із меншою роздільною здатністю).
  * Поділіть великий документ на кілька менших файлів (якщо це прийнятно з точки зору змісту).
* **Завантаження переривається**
  * Перевірте стабільність інтернет-з’єднання.
  * Повторіть завантаження, за можливості — з іншої мережі.

### Видалення документів <a href="#vidalennya-dokumentiv" id="vidalennya-dokumentiv"></a>

#### Призначення <a href="#priznachennya.1" id="priznachennya.1"></a>

Видалення документів дозволяє прибрати з системи файли, які більше не актуальні, були завантажені помилково або не повинні зберігатися в порталі (наприклад, дублікати або некоректні документи).

#### Коли використовувати <a href="#koli-vikoristovuvati.1" id="koli-vikoristovuvati.1"></a>

* Ви завантажили неправильний або застарілий файл.
* Потрібно привести список документів у порядок (прибрати дублікати).

#### Параметри / обмеження <a href="#parametri-obmezhennya.1" id="parametri-obmezhennya.1"></a>

Можливість видалення документа обмежена статусом відправлення. Видаляти документи можна лише в статусі ReadyToShip.

### Отримання списку документів <a href="#otrimannya-spisku-dokumentiv" id="otrimannya-spisku-dokumentiv"></a>

#### Призначення <a href="#priznachennya.2" id="priznachennya.2"></a>

Отримання списку документів дозволяє побачити всі доступні файли по накладній й швидко зорієнтуватися, які документи вже є в системі.

#### Коли використовувати <a href="#koli-vikoristovuvati.2" id="koli-vikoristovuvati.2"></a>

Вам потрібно переконатися, що всі необхідні документи завантажені.

#### Параметри / обмеження <a href="#parametri-obmezhennya.2" id="parametri-obmezhennya.2"></a>

Отримати список документів можна лише за власною активною накладною.

### Отримання файлу <a href="#otrimannya-failu" id="otrimannya-failu"></a>

#### Призначення <a href="#priznachennya.3" id="priznachennya.3"></a>

Отримання файлу дозволяє завантажити конкретний документ на ваш комп’ютер або інший пристрій для перегляду, друку або подальшої обробки (наприклад, пересилання контрагенту).

#### Коли використовувати <a href="#koli-vikoristovuvati.3" id="koli-vikoristovuvati.3"></a>

* Вам потрібно переглянути вміст документа.
* Потрібно роздрукувати рахунок, накладну, акт або інший документ.
* Ви хочете зберегти копію документа для внутрішнього архіву.

#### Параметри / обмеження <a href="#parametri-obmezhennya.3" id="parametri-obmezhennya.3"></a>

Отримати файлу можна лише за власною активною накладною.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-portal.novapost.com/changelog-1/documentation-1/robota-z-suprovidnimi-dokumentami-do-men-cherez-kliyentske-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.