Подключение метода доставки "Новая Почта" к интернет-магазину
Вы можете подключить интеграцию с Новой Почтой для того, чтобы ваши покупатели могли при создании заказа выбрать необходимое отделение из списка.
Примечание: на сегодняшний день возможность автоматически создавать ТТН (товарно-транспортную накладную) отсутствует, то есть информация из вашего интернет-магазина не будет передаваться в ваш кабинет Новой Почты.
Содержание:
Получение API-ключа в аккаунте Новой почты
Подключение интеграции к сайту на Weblium
Настройка интеграции на Weblium
Создание ТТН на основе заказов
Продление срока работы API-ключа
Зарегистрируйте личный кабинет на сайте Новой Почты или войдите в имеющийся.
Перейдите на вкладку Безпека и нажмите на кнопку Створити ключ:
Подтвердите создание API-ключа нажатием на кнопку Створити:
Скопируйте ваш API-ключ в колонке Ключ:
Примечание: в колонке "Сервіс" должно быть указано именно "Бізнес-кабінет" (не "Мобільний додаток" или т.п.).
Важно: ключ API создается сроком на 1 год. После наступления окончательной даты ключ перестает работать и больше не может использоваться на вашем сайте. Вы можете узнать, как продлить срок действия ключа API в последнем разделе этой инструкции (это можно сделать заранее).
Откройте настройки вашего сайта, перейдите к разделу Доставка и нажмите кнопку Подключить в секции Новая Почта:
Вставьте ваш API-ключ в соответствующее поле и нажмите на кнопку Сохранить:
Как и в других способах доставки, вы можете добавить для ваших покупателей Примечания и редактировать надписи на полях, которые заполняют покупатели вашего магазина, а именно изменять название и подсказку внутри этих полей:
ㅤㅤㅤ1) В поле Название способа доставки можно, соответственно, указать название метода доставки, который вы выбрали;
ㅤㅤㅤ2) В поле Примечания вы можете указать для ваших клиентов дополнительную информацию, которая будет отображаться под названием метода доставки;
ㅤㅤㅤ3) В поле с названием Поле названия города вы можете указать тот текст, который будет отображаться в корзине сверху и внутри поля, из которого ваши покупатели будут выбирать город для получения посылки;
ㅤㅤㅤ4) Так же вы можете изменить название и текст-подсказку внутри поля Поле отделения почты (то, где покупатель выбирает конкретное отделение НП в своем городе):
Примечание: информация из этих полей поступает от базы данных Новой Почты напрямую.
Следующая опция для настройки – Фильтр почтовых отделений.
Здесь вы выбираете типы отделений, которые будут отображаться на стороне покупателя при выборе отделения:
1) Почтовое отделение - обычное отделение Новой Почты, принимающее посылки весом до 30 кг (некоторые отделения имеют меньший максимальный вес посылки).
2) Грузовое отделение – осуществляют прием/выдачу отправления с фактическим и объемным весом до 1 000 кг на одно место отправления, максимальной длиной до 300 см и высотой до 170 см.
3) Почтомат – это автоматический терминал для получения и отправки посылок, чтобы сделать это в любое время достаточно удобным способом.
Подсказка: подробнее о работе почтомата Новой Почты можно узнать здесь.
Примечание: если у вас крупногабаритные товары, вам может быть полезно отключить этот тип отделения (а также обычные почтовые отделения) и оставить только грузовые.
4) Почтомат Приватбанка - то же, что описано в предыдущем пункте. Приватбанк сотрудничает с Новой Почтой и предоставляет свои почтоматы для использования.
5) Parcel Shop предусматривает размещение пунктов приёма и выдачи посылок весом до 15 кг в торговых центрах и супермаркетах на небольшой площади.
Подсказка: детальнее об этом типе отделения вы можете узнать тут.
Важно: по состоянию на сегодняшний день такие типы отделений, как "Почтомат ПриватБанка" и "Parcel Shop", недоступны. Они в данный момент присутствуют у нас, потому что Новая Почта до сих пор технически позволяет выбирать эти опции и мы, соответственно, тоже их оставили доступными. Возможно, данные типы отделений станут снова доступны в будущем, поэтому по желанию вы можете оставить эти опции активированными.
Вы также можете настроить стоимость доставки.
Она бывает как фиксированной:
Важно: фиксированная стоимость доставки будет включена в общую сумму заказа.
…так и индивидуальной:
И напоследок, вы можете выбрать способы оплаты, при выборе которых для ваших покупателей будет доступна опция доставки от Новой Почты:
Подсказка: Новая Почта стабильно работает со всеми данными платёжными системами, указанными на скриншоте выше.
Не забудьте опубликовать сайт для внесения всех последних изменений.
После окончания всех настроек и их сохранения вы увидите Новую Почту в корзине на вашем сайте:
Если к вашему сайту подключена Новая почта, вы можете генерировать ТТН (товарно-транспортную накладную) на стороне Weblium для каждого отдельного заказа в вашем магазине. Для этого необходимо выполнить первичную настройку интеграции, после чего в каждом заказе станет доступна кнопка Создать ТТН.
Для выполнения этих настроек в вашем интернет-магазине уже должна быть подключена интеграция с Новой почтой согласно инструкциям в предыдущих разделах. Перед тем как для заказов можно будет генерировать ТТН, необходимо указать данные отправителя (ваши реквизиты) и параметры посылки, которые будут использоваться по умолчанию (габариты и вес). Для этого:
В настройках вашего сайта в разделе Ваш магазин перейдите в подраздел Доставка, в строке напротив Новой почты справа нажмите на три точки и выберите пункт Настроить.
В разделе Автогенерация ТТН заполните данные отправителя (продавца), которые будут использоваться во всех сгенерированных ТТН в качестве отправителя.
ㅤㅤㅤ① Отправитель — выберите из выпадающего списка фамилию, имя и отчество (ФИО) нужного вам отправителя (контактного лица);
ㅤㅤㅤ② Телефонный номер отправителя — номер телефона отправителя;
ㅤㅤㅤ③ Город отправителя — выберите город, из которого будет отправляться посылка. Вы можете начать вводить название города, чтобы выбрать его из списка;
ㅤㅤㅤ④ Отделение отправителя — выберите отделение в вашем городе, из которого будете отправлять посылку. Рекомендуется выбирать такое отделение, где максимальный допустимый вес посылки позволяет отправлять все ваши товары (если у вас бывают крупные или тяжёлые товары, лучше не выбирать мини-отделения для отправки);
ㅤㅤㅤ⑤ Плательщик за доставку — выберите, кто будет оплачивать доставку: отправитель (вы) или получатель (покупатель);
ㅤㅤㅤ⑥ Форма оплаты — выберите способ оплаты: наличными в отделении (этот вариант также включает оплату банковской картой) или безналичный расчёт (оплата через банк от юридического лица на банковский счёт Новой почты);
ㅤㅤㅤ⑦ Описание отправки (описание отправления) — значение из этого поля отобразится в описании отправления. Вы можете использовать переменные для текста, чтобы туда автоматически подставлялась нужная информация, например номер заказа, перечень товаров и т.д.
Примечание: безналичный расчёт доступен только клиентам, у которых заключён договор с Новой почтой на организацию перевозок и нет просроченной дебиторской задолженности. В общем случае рекомендуется указывать безналичный расчёт только если плательщиком является отправитель (вы), так как не все ваши покупатели могут иметь заключённый договор с Новой почтой.
Отдельно стоит выделить пункт под названием Дополнительная информация об отправке:
Здесь можно указать шаблон, по которому будет генерироваться дополнительная полезная информация при создании ТТН. При нажатии на кнопку Показать переменные вы сможете увидеть, какие переменные можно использовать для вашего шаблона:
Ниже в разделе Параметры посылки по умолчанию вам необходимо заполнить те параметры посылки, которые будут применяться ко всем отправлениям по умолчанию. Вы можете указать те параметры, которые наиболее характерны для ваших отправлений (большинства посылок, которые вы отправляете):
Подсказка: при этом можно указать как средние значения, так и параметры тех ваших посылок, которые меньше других. Если фактический размер отправления окажется больше указанного, операторы Новой почты вручную скорректируют габариты посылки и при необходимости пересчитают ее стоимость. Если посылка окажется настолько большой, что не пройдет в выбранное покупателем отделение по габаритам или весу, представитель Новой почты свяжется с вами (обычно позвонит), чтобы уточнить другое отделение, куда отправить посылку получателю (например, ближайшее грузовое отделение).
Укажите в 4 полях последовательно значения посылки, которые будут использоваться по умолчанию: вес, длина, ширина и высота.
Сохраните изменения, нажав Сохранить в правом верхнем углу:
Готово! Теперь вы сможете создавать ТТН в заказах через настройки сайта.
Чтобы создать ТТН для заказа, выполните следующие шаги:
В настройках вашего сайта в разделе Ваш магазин перейдите в подраздел Заказы и нажмите на необходимый вам заказ:
В правом меню снизу в секции Доставка нажмите на кнопку Создать ТТН:
Важно: текст в деталях заказа (разделы Контакт и Доставка) должен быть указан кириллицей.
В появившемся окне заполните все необходимые данные и нажмите на кнопку Создать:
Дополнительно стоит обратить внимание на пункт под названием Параметры отправки:
ㅤㅤㅤ① Общие параметры. Вы можете задавать параметры отправления для отдельных мест. Чтобы задать общие параметры, необходимо установить галочку в этом поле;
ㅤㅤㅤ② Кнопка для копирования места отправления;
ㅤㅤㅤ③ Кнопка для удаления места отправления;
ㅤㅤㅤ④ Кнопка для активирования опции ручной обработки (его необходимо отмечать, если посылка не упакована согласно правил Новой Почты);
ㅤㅤㅤ⑤ Кнопка для добавления места отправления.
При необходимости можно редактировать созданную ТТН:
На стороне Новой почты ТТН будет выглядеть следующим образом:
Если вам нужно скопировать или удалить ТТН, вы можете сделать это в том же месте, где она была создана, а именно в настройках заказа с помощью соответствующих кнопок, которые находятся справа от номера ТТН:
Срок действия вашего ключа API можно продлить. Это можно сделать, если зайти в личный кабинет Новой Почты, аналогично процессу подключения, в разделе Налаштування перейти к вкладке Безпека и нажать на иконку в виде часов у нужного ключа:
…и продлить его нажатием на кнопку Підтвердити:
Однако существует несколько ситуаций, которые не позволят продлить срок действия ключа: если дата окончания его работы уже прошла или если ключ был удален. То есть срок работы ключа можно продлить, пока не наступила его конечная дата и он не изъят.
Важно: если срок действия ключа истек, вам необходимо повторить процесс подключения из этой инструкции (создать новый ключ API и повторно подключить его в настройках вашего сайта вместо устаревшего ключа).
Подсказка: ключ можно продлить заблаговременно, сразу после его создания.
Примечание: на сегодняшний день возможность автоматически создавать ТТН (товарно-транспортную накладную) отсутствует, то есть информация из вашего интернет-магазина не будет передаваться в ваш кабинет Новой Почты.
Содержание:
Получение API-ключа в аккаунте Новой почты
Подключение интеграции к сайту на Weblium
Настройка интеграции на Weblium
Создание ТТН на основе заказов
Продление срока работы API-ключа
Получение API-ключа в аккаунте Новой почты
Зарегистрируйте личный кабинет на сайте Новой Почты или войдите в имеющийся.
Перейдите на вкладку Безпека и нажмите на кнопку Створити ключ:
Подтвердите создание API-ключа нажатием на кнопку Створити:
Скопируйте ваш API-ключ в колонке Ключ:
Примечание: в колонке "Сервіс" должно быть указано именно "Бізнес-кабінет" (не "Мобільний додаток" или т.п.).
Важно: ключ API создается сроком на 1 год. После наступления окончательной даты ключ перестает работать и больше не может использоваться на вашем сайте. Вы можете узнать, как продлить срок действия ключа API в последнем разделе этой инструкции (это можно сделать заранее).
Подключение интеграции к сайту на Weblium
Откройте настройки вашего сайта, перейдите к разделу Доставка и нажмите кнопку Подключить в секции Новая Почта:
Вставьте ваш API-ключ в соответствующее поле и нажмите на кнопку Сохранить:
Настройка интеграции на Weblium
Как и в других способах доставки, вы можете добавить для ваших покупателей Примечания и редактировать надписи на полях, которые заполняют покупатели вашего магазина, а именно изменять название и подсказку внутри этих полей:
ㅤㅤㅤ1) В поле Название способа доставки можно, соответственно, указать название метода доставки, который вы выбрали;
ㅤㅤㅤ2) В поле Примечания вы можете указать для ваших клиентов дополнительную информацию, которая будет отображаться под названием метода доставки;
ㅤㅤㅤ3) В поле с названием Поле названия города вы можете указать тот текст, который будет отображаться в корзине сверху и внутри поля, из которого ваши покупатели будут выбирать город для получения посылки;
ㅤㅤㅤ4) Так же вы можете изменить название и текст-подсказку внутри поля Поле отделения почты (то, где покупатель выбирает конкретное отделение НП в своем городе):
Примечание: информация из этих полей поступает от базы данных Новой Почты напрямую.
Следующая опция для настройки – Фильтр почтовых отделений.
Здесь вы выбираете типы отделений, которые будут отображаться на стороне покупателя при выборе отделения:
1) Почтовое отделение - обычное отделение Новой Почты, принимающее посылки весом до 30 кг (некоторые отделения имеют меньший максимальный вес посылки).
2) Грузовое отделение – осуществляют прием/выдачу отправления с фактическим и объемным весом до 1 000 кг на одно место отправления, максимальной длиной до 300 см и высотой до 170 см.
3) Почтомат – это автоматический терминал для получения и отправки посылок, чтобы сделать это в любое время достаточно удобным способом.
Подсказка: подробнее о работе почтомата Новой Почты можно узнать здесь.
Примечание: если у вас крупногабаритные товары, вам может быть полезно отключить этот тип отделения (а также обычные почтовые отделения) и оставить только грузовые.
4) Почтомат Приватбанка - то же, что описано в предыдущем пункте. Приватбанк сотрудничает с Новой Почтой и предоставляет свои почтоматы для использования.
5) Parcel Shop предусматривает размещение пунктов приёма и выдачи посылок весом до 15 кг в торговых центрах и супермаркетах на небольшой площади.
Подсказка: детальнее об этом типе отделения вы можете узнать тут.
Важно: по состоянию на сегодняшний день такие типы отделений, как "Почтомат ПриватБанка" и "Parcel Shop", недоступны. Они в данный момент присутствуют у нас, потому что Новая Почта до сих пор технически позволяет выбирать эти опции и мы, соответственно, тоже их оставили доступными. Возможно, данные типы отделений станут снова доступны в будущем, поэтому по желанию вы можете оставить эти опции активированными.
Вы также можете настроить стоимость доставки.
Она бывает как фиксированной:
Важно: фиксированная стоимость доставки будет включена в общую сумму заказа.
…так и индивидуальной:
И напоследок, вы можете выбрать способы оплаты, при выборе которых для ваших покупателей будет доступна опция доставки от Новой Почты:
Подсказка: Новая Почта стабильно работает со всеми данными платёжными системами, указанными на скриншоте выше.
Не забудьте опубликовать сайт для внесения всех последних изменений.
После окончания всех настроек и их сохранения вы увидите Новую Почту в корзине на вашем сайте:
Создание ТТН на основе заказов
Если к вашему сайту подключена Новая почта, вы можете генерировать ТТН (товарно-транспортную накладную) на стороне Weblium для каждого отдельного заказа в вашем магазине. Для этого необходимо выполнить первичную настройку интеграции, после чего в каждом заказе станет доступна кнопка Создать ТТН.
Первичная настройка генерации ТТН
Для выполнения этих настроек в вашем интернет-магазине уже должна быть подключена интеграция с Новой почтой согласно инструкциям в предыдущих разделах. Перед тем как для заказов можно будет генерировать ТТН, необходимо указать данные отправителя (ваши реквизиты) и параметры посылки, которые будут использоваться по умолчанию (габариты и вес). Для этого:
В настройках вашего сайта в разделе Ваш магазин перейдите в подраздел Доставка, в строке напротив Новой почты справа нажмите на три точки и выберите пункт Настроить.
В разделе Автогенерация ТТН заполните данные отправителя (продавца), которые будут использоваться во всех сгенерированных ТТН в качестве отправителя.
ㅤㅤㅤ① Отправитель — выберите из выпадающего списка фамилию, имя и отчество (ФИО) нужного вам отправителя (контактного лица);
ㅤㅤㅤ② Телефонный номер отправителя — номер телефона отправителя;
ㅤㅤㅤ③ Город отправителя — выберите город, из которого будет отправляться посылка. Вы можете начать вводить название города, чтобы выбрать его из списка;
ㅤㅤㅤ④ Отделение отправителя — выберите отделение в вашем городе, из которого будете отправлять посылку. Рекомендуется выбирать такое отделение, где максимальный допустимый вес посылки позволяет отправлять все ваши товары (если у вас бывают крупные или тяжёлые товары, лучше не выбирать мини-отделения для отправки);
ㅤㅤㅤ⑤ Плательщик за доставку — выберите, кто будет оплачивать доставку: отправитель (вы) или получатель (покупатель);
ㅤㅤㅤ⑥ Форма оплаты — выберите способ оплаты: наличными в отделении (этот вариант также включает оплату банковской картой) или безналичный расчёт (оплата через банк от юридического лица на банковский счёт Новой почты);
ㅤㅤㅤ⑦ Описание отправки (описание отправления) — значение из этого поля отобразится в описании отправления. Вы можете использовать переменные для текста, чтобы туда автоматически подставлялась нужная информация, например номер заказа, перечень товаров и т.д.
Примечание: безналичный расчёт доступен только клиентам, у которых заключён договор с Новой почтой на организацию перевозок и нет просроченной дебиторской задолженности. В общем случае рекомендуется указывать безналичный расчёт только если плательщиком является отправитель (вы), так как не все ваши покупатели могут иметь заключённый договор с Новой почтой.
Отдельно стоит выделить пункт под названием Дополнительная информация об отправке:
Здесь можно указать шаблон, по которому будет генерироваться дополнительная полезная информация при создании ТТН. При нажатии на кнопку Показать переменные вы сможете увидеть, какие переменные можно использовать для вашего шаблона:
Ниже в разделе Параметры посылки по умолчанию вам необходимо заполнить те параметры посылки, которые будут применяться ко всем отправлениям по умолчанию. Вы можете указать те параметры, которые наиболее характерны для ваших отправлений (большинства посылок, которые вы отправляете):
Подсказка: при этом можно указать как средние значения, так и параметры тех ваших посылок, которые меньше других. Если фактический размер отправления окажется больше указанного, операторы Новой почты вручную скорректируют габариты посылки и при необходимости пересчитают ее стоимость. Если посылка окажется настолько большой, что не пройдет в выбранное покупателем отделение по габаритам или весу, представитель Новой почты свяжется с вами (обычно позвонит), чтобы уточнить другое отделение, куда отправить посылку получателю (например, ближайшее грузовое отделение).
Укажите в 4 полях последовательно значения посылки, которые будут использоваться по умолчанию: вес, длина, ширина и высота.
Сохраните изменения, нажав Сохранить в правом верхнем углу:
Готово! Теперь вы сможете создавать ТТН в заказах через настройки сайта.
Создание ТТН
Чтобы создать ТТН для заказа, выполните следующие шаги:
В настройках вашего сайта в разделе Ваш магазин перейдите в подраздел Заказы и нажмите на необходимый вам заказ:
В правом меню снизу в секции Доставка нажмите на кнопку Создать ТТН:
Важно: текст в деталях заказа (разделы Контакт и Доставка) должен быть указан кириллицей.
В появившемся окне заполните все необходимые данные и нажмите на кнопку Создать:
Дополнительно стоит обратить внимание на пункт под названием Параметры отправки:
ㅤㅤㅤ① Общие параметры. Вы можете задавать параметры отправления для отдельных мест. Чтобы задать общие параметры, необходимо установить галочку в этом поле;
ㅤㅤㅤ② Кнопка для копирования места отправления;
ㅤㅤㅤ③ Кнопка для удаления места отправления;
ㅤㅤㅤ④ Кнопка для активирования опции ручной обработки (его необходимо отмечать, если посылка не упакована согласно правил Новой Почты);
ㅤㅤㅤ⑤ Кнопка для добавления места отправления.
При необходимости можно редактировать созданную ТТН:
На стороне Новой почты ТТН будет выглядеть следующим образом:
Копирование или Удаление ТТН
Если вам нужно скопировать или удалить ТТН, вы можете сделать это в том же месте, где она была создана, а именно в настройках заказа с помощью соответствующих кнопок, которые находятся справа от номера ТТН:
Продление срока работы API-ключа
Срок действия вашего ключа API можно продлить. Это можно сделать, если зайти в личный кабинет Новой Почты, аналогично процессу подключения, в разделе Налаштування перейти к вкладке Безпека и нажать на иконку в виде часов у нужного ключа:
…и продлить его нажатием на кнопку Підтвердити:
Однако существует несколько ситуаций, которые не позволят продлить срок действия ключа: если дата окончания его работы уже прошла или если ключ был удален. То есть срок работы ключа можно продлить, пока не наступила его конечная дата и он не изъят.
Важно: если срок действия ключа истек, вам необходимо повторить процесс подключения из этой инструкции (создать новый ключ API и повторно подключить его в настройках вашего сайта вместо устаревшего ключа).
Подсказка: ключ можно продлить заблаговременно, сразу после его создания.
Последнее изменение: 22/02/2025
Спасибо!