Elbuz працює з UPS API через ваш застосунок на developer.ups.com. Накладна й етикетка UPS виписуються з картки замовлення, курʼєр викликається звідти ж, а статуси програма забирає сама кожні 10 хвилин.
Коли це знадобиться:
- Відправляєте з Польщі чи іншої країни ЄС — адреса й країна одержувача беруться із замовлення, кабінет UPS для накладної не потрібен.
- Етикетку треба передрукувати — друк доступний і через кілька днів після накладної.
- Посилки забирають з вашої адреси — заявка на курʼєра UPS оформлюється з накладної.
- Клієнт питає, де посилка — статус UPS видно в замовленні й у реєстрі посилок.
З чого почати: створіть застосунок на developer.ups.com → впишіть ключі в Elbuz.
Що вміє UPS в Elbuz
- Підключення — Client ID, Client Secret, номер клієнта UPS і тестове середовище UPS.
- Накладна із замовлення — одержувач, адреса, вага й габарити підставляються самі.
- Етикетка — друк і передрук за номером накладної.
- Виклик курʼєра — дата й години забору, у відповідь — номер заявки UPS.
- Статуси посилок — кожні 10 хвилин; за вашою таблицею кодів міняються статуси замовлень.
Як підключити UPS API: ключі й номер клієнта
Де взяти Client ID і Client Secret UPS
- Увійдіть на developer.ups.com з обліковим записом UPS і виберіть «Create an Application» (або «My Apps» → «Add Apps»).
- Виберіть номер клієнта UPS, до якого привʼязується застосунок, і прийміть угоду UPS API Access Agreement.
- Додайте продукти Shipping, Tracking і Pickup; Authorization (OAuth) додається сам.
- Збережіть застосунок і скопіюйте Client ID і Client Secret з «My Apps».
Номер клієнта UPS видно в профілі UPS, розділ «Accounts and Payments». Рахунку в Польщі ще немає — відкрийте його на ups.com.
Тариф Community безкоштовний. За тарифами UPS на місяць: відстеження — 90 000 запитів, накладні й курʼєр — без обмежень, повторні етикетки — 10 000. Кожен друк з Elbuz — один запит повторної етикетки.
Що вписати в Elbuz
Де: Зовнішні сервіси та інтеграції → Доставка → «UPS».
| Поле | Що вписати |
|---|---|
| «Активність» | Увімкнено — інакше накладна UPS не відкриється |
| «Користувач» | Client ID |
| «Пароль» | Client Secret |
| «Номер клієнта UPS (Shipper Number)» | 6 символів номера клієнта; з цього рахунку UPS бере оплату |
| «Послуга за замовчуванням» | Послуга для всіх накладних (яку вибрати) |
| «Тестове середовище (sandbox)» | Увімкніть для перевірки, вимкніть для роботи |
| Блок «Відправник» | Компанія, контактна особа, країна кодом ISO (порожньо — PL), індекс, місто, вулиця, дім, телефон, e-mail. Це адреса відправника на накладній і адреса забору |
| «Компанія» | Ваша компанія, якщо в кожної свій рахунок UPS; запис компанії має перевагу над загальним |
1
Користувач і Пароль2
Номер клієнта UPS3
Послуга за замовчуванням4
Тестове середовище (sandbox)5
Відправник- Користувач і Пароль — це Client ID і Client Secret застосунку UPS.
- Номер клієнта UPS (Shipper Number) — 6 символів, видно в профілі UPS.
- Послуга за замовчуванням — одна послуга UPS для всіх накладних.
- Тестове середовище (sandbox) — запити йдуть у тестове середовище UPS, а не в бойове.
- Відправник — адреса забору й зворотна адреса на етикетці.
Форма зберігається сама, щойно ви змінили поле. «Пароль» після збереження показує крапки, а порожнє поле ключ не стирає.
Під час збереження Elbuz ключі не перевіряє. Помилку ключа покаже перша накладна: «UPS OAuth: ‹текст UPS›».
Яку послугу вибрати
| Послуга | Що це |
|---|---|
| UPS Standard (11) | За замовчуванням |
| UPS Express Saver (65) | Експрес; в інших країнах ЄС UPS називає її UPS Worldwide Saver |
| UPS Express (07) | Експрес |
| UPS Expedited (08) | Міжнародна послуга |
Назви й коди — з довідника послуг UPS; які з них доступні вам, визначає договір з UPS. Послуга одна на всі накладні, у формі накладної її не змінити.
Тестове середовище UPS
Увімкніть «Тестове середовище (sandbox)» — накладні підуть у тестове середовище UPS (CIE) з тими самими Client ID і Client Secret. Етикетки там мають водяний знак «Sample», гроші не списуються. Перед роботою вимкніть перемикач.
Як виписати накладну UPS із замовлення
Загальний порядок для всіх служб — у статті як виписати накладну із замовлення.
Де: картка замовлення зі способом доставки «UPS» → секція «Доставка» → «Створити накладну».
Що форма заповнить сама і що перевірити
| Поле | Звідки | Що перевірити |
|---|---|---|
| Прізвище, Ім'я, Телефон, E-Mail | Замовлення | Телефон обовʼязковий |
| Індекс, Населений пункт, Вулиця, Дім, Квартира | Адреса доставки замовлення: уся адреса — у «Вулиця», «Дім» і «Квартира» порожні | Вулиця, дім і квартира разом — до 35 символів, місто — до 30; довше Elbuz обріже |
| Країна (код ISO: DE, FR, IT, ES…) | Країна доставки замовлення | Не розпізнано — країна відправника |
| Загальна вага, кг | Вага товарів замовлення | Ваги немає й у товарах — піде 1 кг; округлення до 0,1 кг |
| Довжина, Ширина, Висота, см | Порожні | Передаються, лише якщо заповнено всі три |
| Опис відправлення | Категорія або список товарів | До 50 символів |
| Зворотна доставка (одержувач) | «Гроші», якщо замовлення не оплачене й оплата при отриманні | Поставте «Не потрібно»: післяплату UPS не підключено |
1
Країна (код ISO) одержувача2
Загальна вага, кг3
Довжина / Ширина / Висота4
Зворотна доставка: Не потрібно5
Створити накладну- Країна одержувача — двобуквений код ISO, тут DE.
- Загальна вага посилки в кілограмах.
- Габарити посилки в сантиметрах.
- Зворотна доставка (післяплата) не потрібна — обрано «Не потрібно».
- Кнопка, що відправляє запит у службу й створює накладну.
Номер замовлення йде в накладну як референс, до 35 символів. Оплачує відправник — з вашого рахунку UPS, упаковка ваша. Пункти видачі UPS Access Point форма не пропонує: доставка лише на адресу.
Що відбувається після «Створити накладну»
- Elbuz перевіряє дані ще до UPS. Бракує номера клієнта чи адреси відправника — повідомлення з причиною, наприклад «Error: UPS account number is required (API settings)»; накладна не створюється.
- UPS створює відправлення. Номер відстеження посилки лягає в «Сервіс доставки: номер», зʼявляється «Створено товарно-транспортну накладну №‹номер›».
- Якщо UPS відмовив, у вікні буде його текст із кодом у дужках, а замовлення лишиться без номера.
Щоб у замовленні зʼявлялося посилання на відстеження, у способі доставки «UPS» заповніть «Посилання на трекінг», наприклад https://www.ups.com/track?loc=pl_PL&tracknum= (способи доставки).
Накладна створюється одразу й оплачується за тарифом UPS. Скасувати чи змінити її з Elbuz не можна — лише в UPS. Після скасування очистіть «Сервіс доставки: номер» у замовленні, щоб виписати нову.
Як надрукувати етикетку UPS
Де: картка замовлення → «Перегляд накладної» → значок друку; або «Відправлення» → рядок → «Друк накладної».
Етикетка відкривається в новій вкладці картинкою GIF. Elbuz щоразу бере її в UPS за номером накладної, тож передрукувати можна й накладну, номер якої вписали вручну. UPS зберігає копії етикеток 90 днів (довідка UPS).
Як викликати курʼєра UPS
Де: картка замовлення → «Перегляд накладної» → блок «Виклик курʼєра».
- «Дата забору» — за замовчуванням найближчий робочий день.
- «Забрати з» і «до» — порожньо: 09:00–17:00.
- «Посилок, шт.» і «Загальна вага, кг» — скільки забрати.
«Викликати курʼєра» → «Курʼєра замовлено #‹номер›». Номер заявки UPS (PRN) записується в замовлення, адреса забору — блок «Відправник» підключення.
У Польщі разовий забір UPS платний: одна плата за виїзд, незалежно від кількості посилок (умови UPS). Щоденний забір налаштовують в обліковому записі UPS — тоді заявки не потрібні.
Як Elbuz стежить за посилками UPS
Кожні 10 хвилин Elbuz питає UPS про посилки — до 100 накладних за прохід. Стежить за замовленнями за останні 60 днів і за замовленнями в позначених статусах, доки посилка не отримає стан «Отримано». Код і текст статусу UPS видно в замовленні й у «Відправленні».
У «Відправленні» для UPS працюють «Друк накладної», «SMS одержувачу» і «Відстеження на сайті служби» — сторінка ups.com з номером посилки.
Як міняти статуси замовлень за кодами UPS
Коди UPS Elbuz вписує в «Статуси доставки» сам. Код, якого немає в таблиці, дає в «Відправленні» стан «Невідомо», і статус замовлення за ним не міняється.
- У підключенні UPS, блок «Статуси замовлень, за якими перевіряти статус посилки в службі доставки», позначте статуси, у яких замовлення чекає доставки, наприклад «Відвантажено».
- У блоці «Налаштування повідомлень» відкрийте «Статуси доставки» (за потреби й «Статуси замовлення», «Статуси оплати»).
- Коди UPS з таблиці нижче вже вписані в колонку «Код (назва) на сайті (API)»; свої дописуйте через кому.
| Ваш статус доставки | Код UPS | Стан у «Відправленні» |
|---|---|---|
| Чекання від відправника | M — UPS отримав дані відправлення | Створено |
| У дорозі | I — у дорозі, зокрема на доставці; P — забрано | В дорозі |
| Доставлено | D | Отримано, опитування припиняється |
| Відмова від отримання | RS — повернення відправнику | Відмова, опитування припиняється |
Без коду D навпроти «Доставлено» у «Статуси доставки» посилка не отримає стан «Отримано», і Elbuz питатиме про неї й після вручення, займаючи місце в ліміті 100 накладних за прохід.
Код винятку X і код анульованого відправлення MV лишіть поза таблицею: така посилка матиме стан «Невідомо», і ви її помітите. Коди — з довідника відстеження UPS. Як працюють три таблиці статусів — у статті про автозміну статусу замовлення.
Сценарії
Перше підключення без ризику
Впишіть ключі й номер клієнта, увімкніть «Тестове середовище (sandbox)». Виписуйте накладну на своєму замовленні й надрукуйте етикетку з водяним знаком «Sample». Усе гаразд — вимкніть перемикач.
Щоденна відправка по ЄС
«Послуга за замовчуванням» — UPS Standard. З кожного замовлення — «Створити накладну» й друк етикетки. Курʼєра викликайте одним запитом на день або налаштуйте щоденний забір в UPS.
Замовлення закриваються самі
Позначте в підключенні статус «Відвантажено». Код D впишіть навпроти «Доставлено» і у «Статуси доставки», і у «Статуси замовлення». Посилка вручена — замовлення переходить у «Доставлено», а Elbuz перестає про неї питати.
Що робити, коли щось пішло не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Служба доставки не підключена: заповніть налаштування API цієї служби (Налаштування → Зовнішні сервіси API).» | Не вписано Client Secret або вимкнено «Активність» | Заповніть «Пароль» і ввімкніть «Активність» (що вписати) |
| «UPS OAuth: …» | UPS не прийняв Client ID чи Client Secret | Скопіюйте ключі заново з «My Apps» на developer.ups.com |
| «UPS account number is required (API settings)» | Порожній «Номер клієнта UPS (Shipper Number)» | Впишіть номер клієнта |
| «sender address and phone are required (API settings)» | У блоці «Відправник» бракує назви, вулиці, міста, індексу чи телефону | Заповніть «Відправник» у підключенні |
| «name and phone are required for recipient» або «address is required for recipient» | У замовленні немає імені, телефону, вулиці, міста чи індексу одержувача | Допишіть їх у формі накладної |
| «cash on delivery is not supported for UPS yet — choose «without COD»» | У «Зворотна доставка (одержувач)» стоїть «Гроші» | Виберіть «Не потрібно» |
| У «Відправленні» посилка UPS зі станом «Невідомо» | Коду UPS немає у вікні «Статуси доставки» | Допишіть код (коди UPS) |
Часті запитання
Скільки коштує інтеграція UPS в Elbuz?
Elbuz за накладні, етикетки й статуси UPS нічого не списує. API UPS на тарифі Community безкоштовний, доставку й курʼєра ви оплачуєте UPS.
Чи можна відправляти UPS не з Польщі?
Так, з будь-якої країни ЄС: впишіть код країни в «Країна» блоку «Відправник». Митних даних Elbuz не передає, тому відправки — в межах ЄС.
Чи можна з Elbuz відправити UPS з післяплатою?
Ні, післяплату UPS не підключено: накладна з «Гроші» відхиляється. Залиште «Не потрібно» або оформіть таку посилку в UPS.
Як скасувати накладну UPS?
Лише в UPS. Потім очистіть «Сервіс доставки: номер» у замовленні (після створення).
Чи можна вибрати послугу UPS для окремої накладної?
Ні, послуга одна для всіх — «Послуга за замовчуванням» у підключенні. Перемкніть її перед накладною іншого типу.
Чому статус UPS не міняє статус замовлення?
Статус замовлення не позначено в підключенні або коду UPS немає в таблиці. Позначте статус і впишіть коди (коди UPS).
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка → UPS
- Інші входи
- Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
- Право доступу
- підключення — «API та токени доступу»; накладна й курʼєр — вікно «Створення ТТН служби доставки»
- Підготувати
- обліковий запис UPS з номером клієнта (Shipper Number) і застосунок на developer.ups.com
- Створити застосунок і ключіdeveloper.ups.com
- Вписати ключі, номер клієнта й відправникаЗовнішні сервіси та інтеграції → UPS
- Вписати коди статусів UPSТам само, «Налаштування повідомлень»
- Виписати накладну й надрукувати етикеткуКартка замовлення, секція «Доставка»
- Викликати курʼєраПерегляд накладної
Суміжні теми
- Якщо потрібно бачити всі посилки всіх служб в одному списку — Відправлення.
- Якщо відправляєте ще й FedEx — FedEx в Elbuz: форма накладної та сама.
- Якщо магазин у Німеччині й працює з DHL Paket — DHL Paket в Elbuz.
- Якщо хочете порівняти способи виписати накладну — накладна із замовлення.
