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

Огляд доступних операцій

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

Загальні вимоги до файлів

• Типи файлів

  • Поширені формати: PDF, JPG/JPEG, PNG, DOC, DOCX, XLS, XLSX.
  • Якщо ви не впевнені, чи підтримується формат: спробуйте завантажити файл — система повідомить, якщо формат не дозволений.
• Розмір файлу

  • Максимальний розмір файлу до 1 Мб.
• Вимоги до назв файлів

  • Рекомендовано:

    • використовувати латиницю, цифри, дефіс і нижнє підкреслення;
    • уникати спеціальних символів (/ \ ? % * : | " < > тощо);
    • не робити назву надто довгою.
  • Приклади рекомендованих назв:

    • invoice_12345.pdf
    • contract_client_v2.pdf
    • photo_package_front.jpg
• Загальні поради

  • Перед завантаженням перевірте, що файл відкривається на вашому комп’ютері.
  • Не завантажуйте архіви з паролем.
  • Не завантажуйте файли, що містять шкідливе ПЗ або конфіденційну інформацію, не призначену для обробки в системі.

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

Призначення

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

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

Коли використовувати

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

Параметри / обмеження

• Типи файлів: підтримувані формати вказані в блоці «Загальні вимоги до файлів».
• Розмір: максимальний обсяг файлу залежить від налаштувань; при перевищенні метод віддасть помилку.
• Кількість файлів:

  • можливе завантаження до 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)

Типові помилки та як їх уникнути

• Файл не завантажується / з’являється повідомлення про помилку формату

  • Переконайтесь, що формат файлу входить до підтримуваних.
  • За необхідності збережіть документ у форматі PDF або іншому стандартному форматі.
• Файл завеликий

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

  • Перевірте стабільність інтернет-з’єднання.
  • Повторіть завантаження, за можливості — з іншої мережі.

Видалення документів

Призначення

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

Коли використовувати

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

Параметри / обмеження

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

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

Призначення

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

Коли використовувати

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

Параметри / обмеження

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

Отримання файлу

Призначення

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

Коли використовувати

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

Параметри / обмеження

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