> 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/gotovi-integraciyi/popular_integration/populyarni-integraciyi/woocommerce.md).
# Woocommerce
Встановити
### Як налаштувати плагін для початку роботи
{% hint style="warning" %}
Для коректної роботи з плагіном необхідний договір бізнес-клієнта з Nova Post. Якщо вам необхідно дізнатись номер договору або підписати договір, напишіть [на пошту відділу продажів у вашій країні](https://api-portal.novapost.com/uk/help-center).
{% endhint %}
Вкладка Nova Post Settings
1. Отримайте API-ключ. Згенеруйте ключ [для продуктового](https://api-portal.novapost.com/uk/api-nova-post/start/api-keys) або [тестового середовища](https://api-portal.novapost.com/uk/test-api-keys).
2. Встановіть плагін Nova Post
3. З бокового меню перейдіть у налаштування плагіна: WooCommerce → Nova Post Settings та заповніть наступні розділи.
Розділ API Configuration
Вставте отриманий API ключ.
{% hint style="info" %}
Якщо потрібно налаштувати плагін для тесту, поставте прапорець в чек-боксі Testing API та вставте тестовий ключ. Ви зможете протестувати створення відправлень без створення справжніх накладних.
{% endhint %}
Розділ Contract Numbers
1. У полі Domestic Contract Number вкажіть номер договору для локальних відправок в межах країни відправки\*.
2. У полі International Contract Number вкажіть номер договору на міжнародну доставку (для доставки в країни ЄС або поза ними).
\*Країна відправки – країна реєстрації бізнесу та укладання договору з Nova Post.
Розділ Sender Data
{% hint style="warning" %}
Ці дані використовуватимуться для генерації накладник, вказуйте ті дані, які вказані в договорі Nova Post
{% endhint %}
Заповніть наступні поля:
* Прізвище
* Ім'я
* Електрона пошта
* Телефон
* Податковий номер компанії\*
* EORI\*\*
\*Необов'язково, але необхідно заповнити для користування послугою післяплати
\*\*Необов'язково, але необхідно заповнити для міжнародної доставки.
#### **Заповніть інформацію в підрозділі Shipment Departure Method**
Розділ дозволяє налаштувати способи відправки.
У розділі є дві вкладки: адреса та відділення. Заповніть інформацію у цих вкладках відповідно до того, як ви бажаєте відправляти посилки: з відділення або з адреси.
{% hint style="warning" %}
Поле «Населений пункт» має містити лише назву міста або населеного пункту, без назви району, області та без коми. Зверніть увагу, що "Riga" та "Rīga" є двома різними записами в системі.
{% endhint %}
Розділ Product Information
Дані, вказані у цьому розділі, будуть використовуватись для створення накладних за замовчуванням, якщо у картці товару не буде вказано відповідної інформації.
* Вага за замовчуванням, кг
* Довжина, ширина, висота, см
* HS-code – ідентифікатор для класифікації товарів у міжнародній торгівлі
Розділ Packaging Settings
Вкажіть тип пакування, який буде додаватись до створених накладних:
* Use Nova Post boxes – при створенні накладної будуть використовуватись розміри пакування Nova Post. Розміри пакування будуть визначатись автоматично, залежно від габаритів товарів у посилці.
* One box per order – якщо використовуєте один тип пакування, його розмір буде автоматично застосовуватись до кожного замовлення.
* Use custom boxes – якщо використовуєте для пакування декілька варіантів коробок. Розмір пакування буде автоматично підібрано, залежно від габаритів товарів у замовленні.
При виборі One box per order або Use custom boxes вкажіть розміри пакування.
Розділ Carrier shipping calculation
Розділ дозволяє вказати вартість доставки для покупця:
* за тарифами Nova Post
* інша вартість від продавця
* безплатно (для всіх замовлень або від певної суми замовлення)
Розділ Cash on Delivery
Якщо бажаєте підключити оплату при отриманні, необхідно підписати з Nova Post додатковий договір.
У розділі вкажіть інформацію так, як вказано в договорі:
* Платника комісії за послугу оплати при отриманні
* Bank Account ID
* Рахунок для зарахування коштів
Для коректної роботи послуги вказуйте ті дані, які зазначені в договорі з Nova Post.
Розділ Order Workflow
У розділі ви можете налаштувати автоматичне інформування покупця про відправку замовлення. Якщо встановити прапорець навпроти Auto-complete orders, після створення накладної ми автоматично відправимо покупцю лист з інформацією про відстеження посилки, а замовлення перейде в статус Completed.
Розділ Divisions Filters
Залиште прапорці навпроти тих способів доставки, які ви бажаєте залишити доступними для оформлення замовлення покупцем.
Вкладка Settings
***Розділ General options***
Перейдіть Settings – General options
1. Налаштування Selling location(s):
* Виберіть Sell to specific countries
* Вкажіть країни, в які плануєте продавати.
Вказуйте тільки ті країни, в яких є представництва Nova Post.
Країни присутності Nova Post:
* Ukraine
* Moldova
* Poland
* Lithuania
* Czech Republic
* Romania
* Germany
* Slovakia
* Estonia
* Latvia
* Hungary
* Italy
* United Kingdom
* Spain
* France
* Austria
* Netherlands
* USA
2. Налаштування Currency
У полі Валюта (Currency) має бути встановлена та грошова одиниця, яка відповідає країні відправки та збігається з тою, що вказана в договорі з Nova Post.
Наприклад: якщо відправки здійснюються з Румунії — обирайте румунський лей (RON).
За потреби змініть валюту та збережіть зміни.
{% hint style="warning" %}
Якщо валюта магазину збігається з валютою договору, ви уникнете курсової різниці та розбіжностей у платежах. Та в разі відмінностей в валюті, Nova Post проведе необхідну конвертацію.
{% endhint %}
***Розділ Shipping zones***
Перейдіть: Settings — Shipping
Розділ дозволяє задати доступні способи доставки залежно від країни.
1. Натисніть Add zone
2. Задайте назву зони
3. Додайте країни, які входитимуть в цю зону
4. Натисніть Add shipping method
5. Виберіть, який спосіб доставки буде доступний для цієї зони: доставка на адресу (Nova Post Address) або доставка у відділення (Nova Post Division).
Щоб були доступні обидва варіанти доставки, створіть таку саму зону з другим способом доставки.
**Особливості заповнення даних про товари у разі доставки за межі ЄС або у зону ЄС з інших країн**\
Для коректного оформлення митних документів внесіть у відповідні поля у картках товарів наступні дані:
* Product name – назву товару анлійською мовою
* HS code – код товару за класифікацією
HS code має складатись з 8-10 числових символів:
* Якщо ваш HS-код коротший за 8-м символів доповнить його нулями.
* Якщо ваш HS-код має довжину більшу за 10-ть символів - видалить останні.
#### Як створити відправлення та роздрукувати документи
{% hint style="warning" %}
Якщо виникає помилка створення накладної, яку ви не можете усунути, напишіть запит на .
{% endhint %}
1. Відкрийте розділ Orders
2. Натисніть кнопку Create waybill (1)
3. Відкриється вікно попереднього перегляду сформованої накладної, в самому низу натисніть кнопку Create waybill
4. Після створення накладної у розділі замовлень відобразиться номер накладної та з'явиться можливість розрукувати документи (2).
Для доставки по країні або в межах ЄС згенерується тільки етикетка зі штрих-кодом та даними про посилку, а для міжнародної доставки буде згенеровано етикетку та інвойс.
{% hint style="warning" %}
Якщо ви хочете створити декілька накладних одночасно:
* виберіть потрібні посилки за допомогою чек-боксів (3)
* в Bulk Actions виберіть опцію Nova Post: Create Shipments
* натисніть кнопку Apply
{% endhint %}
5. Щоб роздрукувати документ, натисніть на його іконку (2) та у вікні попереднього перегляду підтвердіть друк.
#### Як відправити посилки кур'єром
Створюйте виклик кур'єра та відправляйте до 15 посилок за раз з власної адреси без візитів у відділення.
{% hint style="warning" %}
Щоб виклики створювались коректно, переконайтесь, що у вас заповнена інформація про адресу відправки у розділі Shipment Departure Method.
{% endhint %}
1. Відкрийте розділ Orders
2. Виберіть посилки, які бажаєте відправити з адреси.
{% hint style="warning" %}
Додавати у виклик можна тільки посилки, для яких вже створено ЕН або МЕН, і які перебувають у статусі «Готово до відправки», для яких створено ЕН.
{% endhint %}
1. У випадаючому меню Bulk Actions виберіть опцію Створити заявку на забір та натисніть Застосувати.
2. З'явиться модальне вікно. Виберіть дату та доступний часовий інтервал для приїзду кур'єра.
3. Натисніть Підтвердити для підтвердження заявки та перегляду результату.
{% hint style="info" %}
**Важливі деталі!**
* Не змінюйте адресу відправника для виклику кур'єра, якщо у вас вже є створені посилки. Адреса відправника має залишатися незмінним протягом усього процесу створення заявки на забір. Якщо потрібно змінити адресу, видаліть всі накладні, які були створені, але ще не відправлені, а потім створіть їх заново.
* У заявку можна додати 15 посилок. Якщо у вашому виборі буде більше, решта замовлень буде автоматично пропущена та відображена у блоці Попередження звіту
{% endhint %}
#### Результати звіту заявки на виклик кур'єра
| Успішно | Заявку створено. Всі або деякі з вибраних посилок успішно додано до заявки. |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- |
| Попередження | Деякі посилки було автоматично пропущено. У звіті відображено перелік із зазначенням причини для кожної. |
| Помилка | Одна або кілька посилок не пройшли валідацію. У звіті відображено список проблемних замовлень із детальним описом помилок. |
Всі типи статусів можуть відображатися одночасно в одному звіті, залежно від вибраних посилок та результатів їх валідації.
### Як відстежити статус виклику кур'єра
Номер створеної заявки та її поточний статус відображається:
* у блоці Nova Post на сторінці деталей окремого замовлення.
* на сторінці списку замовлень у стовпчику "Shipping Status" у відповідній іконці з Pickup.
Статус заявки автоматично оновлюється щоразу, коли ви відкриваєте або перезавантажуєте сторінки.
### Як відредагувати або скасувати виклик кур'єра
Редагування часового інтервалу, додавання або видалення відправлень, а також видалення заявки доступне виключно у вашому бізнес-кабінеті Nova Post.
### Як відстежити посилку продавцю та покупцю
**Відстеження продавцем**
* В розділі Orders у стовпчику Shipping Status (1) відображатиметься дані про поточний статус доставки посилки.
* У стовпчику Nova Post Shipment відображається номер накладної (2). Це активне посилання, кліком по ньому можна перейти до трекінгу посилки з деталями маршруту.
#### Відстеження покупцем
Покупець може відстежувати рух посилки через застосунок NovaPost або безпосередньо на сайті NovaPost. Для відстеження покупцю необхідний номер посилки.
Відправте покупцю дані для відстеження посилки після створення накладної:
1. Поставте галочку у чек-боксі навпроти потрібних замовлень.
2. В Bulk actions вкажіть Change status to Completed
3. Натисніть Apply
Після цього покупцю на пошту, вказану при оформленні замовлення, автоматично надійде лист з номером посилки та посиланням на сторінку трекінгу.
### Як виглядає шлях покупця: від замовлення до отримання
Після того, як покупець додав товари в корзину та перейшов у чекаут, йому потрібно:
1. Вказати електрону пошту
2. Заповнити дані про адресу доставки:
* Країна
* Ім'я
* Прізвище
* Вулицю та номер будинку
* Номер квартири\*
* Місто
* Регіон\*
* Поштовий індекс
* Телефон
3. Заповнити дані про платіжну адресу: можна ввести вручну або застосувати дані адреси доставки
4. Вибрати спосіб доставки з переліку доступних для країни доставки:
* Кур'єром за адресою
* У точку видачі
{% hint style="info" %}
У випадку доставки у точку сервісу потрібно вибрати тип: відділення або поштомат, а після з переліку вказати потрібний.
{% endhint %}
5. Вибрати спосіб обплати:
6. На сайті
7. При отриманні (якщо відповідна послуга підключена у продавця)
8. Додати коментар до замовлення (необов'язково)
9. Натиснути кнопку створення замовлення.
10. Після створення накладної для доставки замовлення, продавець може відправити лист-інформування з номером посилки для відстеження.
11. Коли посилка прибуде у місце призначення, на пошту, вказану при замовленні, надійде інформування про прибуття посилки або про час візиту кур'єра.
---
# 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, and the optional `goal` query parameter:
```
GET https://api-portal.novapost.com/gotovi-integraciyi/popular_integration/populyarni-integraciyi/woocommerce.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.