> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.weblium.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Подключение метода доставки "Новая Почта" к интернет-магазину

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

**Содержание**:
* [Получение API-ключа в аккаунте Новой почты](#1-poluchenie-api-klyucha-v-akkaunte-novoj-pochty)
* [Подключение интеграции к сайту на Weblium](#1-podklyuchenie-integracii-k-sajtu-na-weblium)
* [Настройка интеграции на Weblium](#1-nastrojka-integracii-na-weblium)
* [Создание ТТН на основе заказов](#1-sozdanie-ttn-na-osnove-zakazov)
* [Продление срока работы API-ключа](#1-prodlenie-sroka-raboty-api-klyucha)

${youtube}[Як підключити Нову Пошту до інтернет магазину](rpaet3ongOM)

# Получение API-ключа в аккаунте Новой почты

1. [Зарегистрируйте](https://new.novaposhta.ua/) личный кабинет на сайте Новой Почты или [войдите](https://new.novaposhta.ua/) в имеющийся.

2. Перейдите на вкладку **Безпека** и нажмите на кнопку **Створити ключ**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-1_fdfb3r.png)

3. Подтвердите создание API-ключа нажатием на кнопку **Створити**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-2_og53ty.png)

4. Скопируйте ваш API-ключ в колонке **Ключ**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-3_6zheqd.png)

|| ${color}[#FFA800](Примечание:) в колонке "Сервіс" должно быть указано именно "Бізнес-кабінет" (не "Мобільний додаток" или т.п.).
||| ${color}[#F97700](Важно:) ключ API создается сроком на 1 год. После наступления окончательной даты ключ перестает работать и больше не может использоваться на вашем сайте. Вы можете узнать, как продлить срок действия ключа API в [последнем разделе этой инструкции](#1-prodlenie-sroka-raboty-api-klyucha) (это можно сделать заранее).

# Подключение интеграции к сайту на Weblium

1. Откройте настройки вашего сайта, перейдите к разделу **Доставка** и нажмите кнопку **Подключить** в секции **Новая Почта**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ru-1_5ghfvf.png)

2. Вставьте ваш **API-ключ** в соответствующее поле и нажмите на кнопку **Сохранить**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ru-2_17y2jmg.png)

# Настройка интеграции на Weblium

1. Как и в других способах доставки, вы можете добавить для ваших покупателей **Примечания** и редактировать надписи на полях, которые заполняют покупатели вашего магазина, а именно изменять название и подсказку внутри этих полей:
ㅤㅤㅤ1) В поле **Название способа доставки** можно, соответственно, указать название метода доставки, который вы выбрали;
ㅤㅤㅤ2) В поле **Примечания** вы можете указать для ваших клиентов дополнительную информацию, которая будет отображаться под названием метода доставки;
ㅤㅤㅤ3) В поле с названием **Поле названия города** вы можете указать тот текст, который будет отображаться в корзине сверху и внутри поля, из которого ваши покупатели будут выбирать город для получения посылки;
ㅤㅤㅤ4) Так же вы можете изменить название и текст-подсказку внутри поля **Поле отделения почты** (то, где покупатель выбирает конкретное отделение НП в своем городе):
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ru-3_ldehqd.png)

|| ${color}[#FFA800](Примечание:) информация из этих полей поступает от базы данных Новой Почты напрямую.

2. Следующая опция для настройки – **Фильтр почтовых отделений**.
Здесь вы выбираете типы отделений, которые будут отображаться на стороне покупателя при выборе отделения:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ru-4_kvde6z.png)

1) Почтовое отделение - обычное отделение Новой Почты, принимающее посылки весом до 30 кг (некоторые отделения имеют меньший максимальный вес посылки).
2) Грузовое отделение – осуществляют прием/выдачу отправления с фактическим и объемным весом до 1 000 кг на одно место отправления, максимальной длиной до 300 см и высотой до 170 см.
3) Почтомат – это автоматический терминал для получения и отправки посылок, чтобы сделать это в любое время достаточно удобным способом.

| ${color}[#1AA900](Подсказка:) подробнее о работе почтомата Новой Почты можно [узнать здесь](https://novaposhta.ua/poshtomat/).
|| ${color}[#FFA800](Примечание:) если у вас крупногабаритные товары, вам может быть полезно отключить этот тип отделения (а также обычные почтовые отделения) и оставить только грузовые.

4) Почтомат Приватбанка - то же, что описано в предыдущем пункте. Приватбанк сотрудничает с Новой Почтой и предоставляет свои почтоматы для использования.
5) Parcel Shop предусматривает размещение пунктов приёма и выдачи посылок весом до 15 кг в торговых центрах и супермаркетах на небольшой площади.

| ${color}[#1AA900](Подсказка:) детальнее об этом типе отделения вы можете [узнать тут](https://novaposhta.ua/news/rubric/2/id/2183).
||| ${color}[#F97700](Важно:) по состоянию на сегодняшний день такие типы отделений, как "Почтомат ПриватБанка" и "Parcel Shop", недоступны. Они в данный момент присутствуют у нас, потому что Новая Почта до сих пор технически позволяет выбирать эти опции и мы, соответственно, тоже их оставили доступными. Возможно, данные типы отделений станут снова доступны в будущем, поэтому по желанию вы можете оставить эти опции активированными.

3. Вы также можете настроить **стоимость доставки**.
Она бывает как фиксированной:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ru-5_1sj2q2h.png)

||| ${color}[#F97700](Важно:) фиксированная стоимость доставки будет включена в общую сумму заказа.

…так и индивидуальной:

![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ru-6_1ahhdke.png)

4. И напоследок, вы можете выбрать способы оплаты, при выборе которых для ваших покупателей будет доступна опция доставки от Новой Почты:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ru-7_18ess6w.png)

| ${color}[#1AA900](Подсказка:) Новая Почта стабильно работает со всеми данными платёжными системами, указанными на скриншоте выше.

Не забудьте [опубликовать](https://help.weblium.com/ru/article/publikaciya-sajta-1xvrq6l/) сайт для внесения всех последних изменений.

5. После окончания всех настроек и их сохранения вы увидите Новую Почту в корзине на вашем сайте:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ru-8_n7rgcj.png)

# Создание ТТН на основе заказов

Если к вашему сайту подключена Новая почта, вы можете генерировать ТТН (товарно-транспортную накладную) на стороне Weblium для каждого отдельного заказа в вашем магазине. Для этого необходимо выполнить первичную настройку интеграции, после чего в каждом заказе станет доступна кнопка **Создать ТТН**.

### Первичная настройка генерации ТТН
Для выполнения этих настроек в вашем интернет-магазине уже должна быть подключена интеграция с Новой почтой согласно инструкциям в предыдущих разделах. Перед тем как для заказов можно будет генерировать ТТН, необходимо указать данные отправителя (ваши реквизиты) и параметры посылки, которые будут использоваться по умолчанию (габариты и вес). Для этого:

1. В настройках вашего сайта в разделе **Ваш магазин** перейдите в подраздел **Доставка**, в строке напротив Новой почты справа нажмите на три точки и выберите пункт **Настроить**.
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-1_vf1hpx.png)

2. В разделе **Автогенерация ТТН** заполните данные отправителя (продавца), которые будут использоваться во всех сгенерированных ТТН в качестве отправителя.
![](https://storage.crisp.chat/users/helpdesk/website/-/f/a/8/4/fa84b4d83a50e800/ttn-ukr-2_13d0q6.png)
ㅤㅤㅤ① **Отправитель** — выберите из выпадающего списка фамилию, имя и отчество (ФИО) нужного вам отправителя (контактного лица);  
ㅤㅤㅤ② **Телефонный номер отправителя** — номер телефона отправителя;  
ㅤㅤㅤ③ **Город отправителя** — выберите город, из которого будет отправляться посылка. Вы можете начать вводить название города, чтобы выбрать его из списка;  
ㅤㅤㅤ④ **Отделение отправителя** — выберите отделение в вашем городе, из которого будете отправлять посылку. Рекомендуется выбирать такое отделение, где максимальный допустимый вес посылки позволяет отправлять все ваши товары (если у вас бывают крупные или тяжёлые товары, лучше не выбирать мини-отделения для отправки);  
ㅤㅤㅤ⑤ **Плательщик за доставку** — выберите, кто будет оплачивать доставку: **отправитель** (вы) или **получатель** (покупатель);  
ㅤㅤㅤ⑥ **Форма оплаты** — выберите способ оплаты: **наличными** в отделении (этот вариант также включает оплату банковской картой) или **безналичный расчёт** (оплата через банк от юридического лица на банковский счёт Новой почты);  

|| ${color}[#ffa800](Примечание:) безналичный расчёт доступен только клиентам, у которых заключён договор с Новой почтой на организацию перевозок и нет просроченной дебиторской задолженности. В общем случае рекомендуется указывать безналичный расчёт только если плательщиком является отправитель (вы), так как не все ваши покупатели могут иметь заключённый договор с Новой почтой.

ㅤㅤㅤ⑦ **Использовать «Контроль оплаты»** — при активации предоставляет возможность при создании ТТН выбрать функцию «Контроль оплаты», которая позволит вашему клиенту оплатить заказ на почте при получении посылки.

ㅤㅤㅤ➇ **Описание отправки** (описание отправления) — значение из этого поля отобразится в описании отправления. Вы можете использовать переменные для текста, чтобы туда автоматически подставлялась нужная информация, например номер заказа, перечень товаров и т.д.


3. Отдельно стоит выделить пункт под названием **Дополнительная информация об отправке**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-3_2tsqi7.png)

Здесь можно указать шаблон, по которому будет генерироваться дополнительная полезная информация при создании ТТН. При нажатии на кнопку **Показать переменные** вы сможете увидеть, какие переменные можно использовать для вашего шаблона:  
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-4_11f2l1b.png)

4. Ниже в разделе **Параметры посылки по умолчанию** вам необходимо заполнить те параметры посылки, которые будут применяться ко всем отправлениям по умолчанию. Вы можете указать те параметры, которые наиболее характерны для ваших отправлений (большинства посылок, которые вы отправляете):
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-3_vqxruv.png) 

| ${color}[#1aa900](Подсказка:) при этом можно указать как средние значения, так и параметры тех ваших посылок, которые меньше других. Если фактический размер отправления окажется больше указанного, операторы Новой почты вручную скорректируют габариты посылки и при необходимости пересчитают ее стоимость. Если посылка окажется настолько большой, что не пройдет в выбранное покупателем отделение по габаритам или весу, представитель Новой почты свяжется с вами (обычно позвонит), чтобы уточнить другое отделение, куда отправить посылку получателю (например, ближайшее грузовое отделение).

Укажите в 4 полях последовательно значения посылки, которые будут использоваться по умолчанию: **вес**, **длина**, **ширина** и **высота**.  

5. Сохраните изменения, нажав **Сохранить** в правом верхнем углу:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-4_7panci.png)

Готово! Теперь вы сможете создавать ТТН в заказах через настройки сайта.

### Создание ТТН
Чтобы создать ТТН для заказа, выполните следующие шаги:

1. В настройках вашего сайта в разделе **Ваш магазин** перейдите в подраздел **Заказы** и нажмите на необходимый вам заказ:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-5_1o4a978.png)

2. В правом меню снизу в секции **Доставка** нажмите на кнопку **Создать ТТН**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-6_db26qj.png)

||| ${color}[#F97700](Важно:) текст в деталях заказа (разделы `Контакт` и `Доставка`) должен быть указан кириллицей.

3. В появившемся окне заполните все необходимые данные и нажмите на кнопку **Создать**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-1_138jzci.png)

4. Дополнительно стоит обратить внимание на пункт под названием **Параметры отправки**:

ㅤㅤㅤ① **Общие параметры**. Вы можете задавать параметры отправления для отдельных мест. Чтобы задать общие параметры, необходимо установить галочку в этом поле;  
ㅤㅤㅤ② Кнопка для **копирования места отправления**;  
ㅤㅤㅤ③ Кнопка для **удаления места отправления**;  
ㅤㅤㅤ④ Кнопка для активирования опции **ручной обработки** (его необходимо отмечать, если посылка не упакована согласно правил Новой Почты);
ㅤㅤㅤ⑤ Кнопка для **добавления места отправления**. 
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-6_yb6ebx.png)

5. При необходимости можно редактировать созданную ТТН:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-2_1nq6xzj.png)

6. На стороне Новой почты ТТН будет выглядеть следующим образом:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-9_1dkwl24.png)

###### Копирование или Удаление ТТН
Если вам нужно скопировать или удалить ТТН, вы можете сделать это в том же месте, где она была создана, а именно в настройках заказа с помощью соответствующих кнопок, которые находятся справа от номера ТТН:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-7_1xf2w47.png)

# Продление срока работы API-ключа

Срок действия вашего ключа API можно продлить. Это можно сделать, если зайти в личный кабинет Новой Почты, аналогично процессу подключения, в разделе **Налаштування** перейти к вкладке **Безпека** и нажать на иконку в виде часов у нужного ключа:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-4_1iarb4j.png)

…и продлить его нажатием на кнопку **Підтвердити**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-5_1w5geaj.png)

Однако существует несколько ситуаций, которые не позволят продлить срок действия ключа: если дата окончания его работы уже прошла или если ключ был удален. То есть срок работы ключа можно продлить, пока не наступила его конечная дата и он не изъят.

||| ${color}[#F97700](Важно:) если срок действия ключа истек, вам необходимо повторить процесс подключения из этой инструкции (создать новый ключ API и повторно подключить его в настройках вашего сайта вместо устаревшего ключа).
| ${color}[#1AA900](Подсказка:) ключ можно продлить заблаговременно, сразу после его создания.