↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Продажі та документи
    4. Обробка замовлень покупця
    5. Служби доставки в Elbuz

    UPS API в Elbuz: накладна із замовлення, етикетка, курʼєр і відстеження

    8 хв читанняОновлено

    Elbuz працює з UPS API через ваш застосунок на developer.ups.com. Накладна й етикетка UPS виписуються з картки замовлення, курʼєр викликається звідти ж, а статуси програма забирає сама кожні 10 хвилин.

    Коли це знадобиться:

    • Відправляєте з Польщі чи іншої країни ЄС — адреса й країна одержувача беруться із замовлення, кабінет UPS для накладної не потрібен.
    • Етикетку треба передрукувати — друк доступний і через кілька днів після накладної.
    • Посилки забирають з вашої адреси — заявка на курʼєра UPS оформлюється з накладної.
    • Клієнт питає, де посилка — статус UPS видно в замовленні й у реєстрі посилок.

    З чого почати: створіть застосунок на developer.ups.com → впишіть ключі в Elbuz.

    Що вміє UPS в Elbuz

    Як підключити UPS API: ключі й номер клієнта

    Де взяти Client ID і Client Secret UPS

    1. Увійдіть на developer.ups.com з обліковим записом UPS і виберіть «Create an Application» (або «My Apps» → «Add Apps»).
    2. Виберіть номер клієнта UPS, до якого привʼязується застосунок, і прийміть угоду UPS API Access Agreement.
    3. Додайте продукти Shipping, Tracking і Pickup; Authorization (OAuth) додається сам.
    4. Збережіть застосунок і скопіюйте 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; запис компанії має перевагу над загальним
    Форма підключення UPS: ключі, номер клієнта, послуга, тестове середовище та відправник
    1Користувач і Пароль
    2Номер клієнта UPS
    3Послуга за замовчуванням
    4Тестове середовище (sandbox)
    5Відправник
    1. Користувач і Пароль — це Client ID і Client Secret застосунку UPS.
    2. Номер клієнта UPS (Shipper Number) — 6 символів, видно в профілі UPS.
    3. Послуга за замовчуванням — одна послуга UPS для всіх накладних.
    4. Тестове середовище (sandbox) — запити йдуть у тестове середовище UPS, а не в бойове.
    5. Відправник — адреса забору й зворотна адреса на етикетці.

    Форма зберігається сама, щойно ви змінили поле. «Пароль» після збереження показує крапки, а порожнє поле ключ не стирає.

    Під час збереження 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 не підключено
    Форма накладної UPS: одержувач, адреса з кодом країни, вага й габарити
    1Країна (код ISO) одержувача
    2Загальна вага, кг
    3Довжина / Ширина / Висота
    4Зворотна доставка: Не потрібно
    5Створити накладну
    1. Країна одержувача — двобуквений код ISO, тут DE.
    2. Загальна вага посилки в кілограмах.
    3. Габарити посилки в сантиметрах.
    4. Зворотна доставка (післяплата) не потрібна — обрано «Не потрібно».
    5. Кнопка, що відправляє запит у службу й створює накладну.

    Номер замовлення йде в накладну як референс, до 35 символів. Оплачує відправник — з вашого рахунку UPS, упаковка ваша. Пункти видачі UPS Access Point форма не пропонує: доставка лише на адресу.

    Що відбувається після «Створити накладну»

    1. Elbuz перевіряє дані ще до UPS. Бракує номера клієнта чи адреси відправника — повідомлення з причиною, наприклад «Error: UPS account number is required (API settings)»; накладна не створюється.
    2. UPS створює відправлення. Номер відстеження посилки лягає в «Сервіс доставки: номер», зʼявляється «Створено товарно-транспортну накладну №‹номер›».
    3. Якщо 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 вписує в «Статуси доставки» сам. Код, якого немає в таблиці, дає в «Відправленні» стан «Невідомо», і статус замовлення за ним не міняється.

    1. У підключенні UPS, блок «Статуси замовлень, за якими перевіряти статус посилки в службі доставки», позначте статуси, у яких замовлення чекає доставки, наприклад «Відвантажено».
    2. У блоці «Налаштування повідомлень» відкрийте «Статуси доставки» (за потреби й «Статуси замовлення», «Статуси оплати»).
    3. Коди UPS з таблиці нижче вже вписані в колонку «Код (назва) на сайті (API)»; свої дописуйте через кому.
    Коди UPS для вікна «Статуси доставки»
    Ваш статус доставкиКод 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
    1. Створити застосунок і ключіdeveloper.ups.com
    2. Вписати ключі, номер клієнта й відправникаЗовнішні сервіси та інтеграції → UPS
    3. Вписати коди статусів UPSТам само, «Налаштування повідомлень»
    4. Виписати накладну й надрукувати етикеткуКартка замовлення, секція «Доставка»
    5. Викликати курʼєраПерегляд накладної

    Суміжні теми

    • Якщо потрібно бачити всі посилки всіх служб в одному списку — Відправлення.
    • Якщо відправляєте ще й FedEx — FedEx в Elbuz: форма накладної та сама.
    • Якщо магазин у Німеччині й працює з DHL Paket — DHL Paket в Elbuz.
    • Якщо хочете порівняти способи виписати накладну — накладна із замовлення.

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно