Elbuz працює з FedEx API через ваш ключ: накладна й етикетка FedEx виписуються з картки замовлення, курʼєр викликається звідти ж, а статуси посилок програма забирає сама кожні 10 хвилин.
Коли це знадобиться:
- Відправляєте з Польщі чи іншої країни ЄС — адреса й країна одержувача беруться із замовлення, FedEx Ship Manager для накладної не потрібен.
- Етикетка потрібна одразу — PDF відкривається з картки замовлення або з «Відправлення».
- Посилки забирають з вашої адреси — заявка на курʼєра FedEx оформлюється з накладної.
- Клієнт питає, де посилка — статус FedEx видно в замовленні й у реєстрі посилок.
З чого почати: створіть проєкт API на developer.fedex.com → впишіть ключі в Elbuz.
Що вміє FedEx в Elbuz
- Підключення — API Key, Secret Key, номер рахунку FedEx і тестове середовище FedEx.
- Накладна із замовлення — одержувач, адреса, вага й габарити підставляються самі.
- Етикетка — PDF протягом 12 годин після створення накладної.
- Виклик курʼєра — дата й години забору, у відповідь — код підтвердження FedEx.
- Статуси посилок — кожні 10 хвилин; за вашою таблицею кодів міняються статуси замовлень.
Як підключити FedEx API: ключі й номер рахунку
Де взяти API Key і Secret Key FedEx
- Увійдіть на developer.fedex.com з обліковим записом FedEx і створіть організацію в «My Projects».
- «Add shipping accounts» → «+ Add Account»: номер рахунку FedEx і адреса платника.
- «+ Create API Project»: позначте Ship API, Track API і Pickup API, назвіть проєкт і виберіть країни відправки.
- Скопіюйте ключі: тестові — на вкладці «Test Key», бойові — на «Production key».
Secret Key FedEx показує один раз. Загубили — згенеруйте новий і впишіть його в Elbuz.
Сторінка сертифікації FedEx вимагає для Ship API перевірити етикетки, зокрема в Європі. Тестові етикетки й Label Cover Sheet надсилають на label@fedex.com, перевірка триває близько 3 робочих днів.
Що вписати в Elbuz
Де: Зовнішні сервіси та інтеграції → Доставка → «FedEx».
| Поле | Що вписати |
|---|---|
| «Активність» | Увімкнено — інакше накладна FedEx не відкриється |
| «Користувач» | API Key проєкту |
| «Пароль» | Secret Key проєкту |
| «Номер рахунку FedEx» | 9 цифр рахунку, з якого FedEx бере оплату за накладні й курʼєра |
| «Послуга за замовчуванням» | Послуга для всіх накладних (яку вибрати) |
| «Тестове середовище (sandbox)» | Увімкніть для тестових ключів, вимкніть для бойових |
| Блок «Відправник» | Компанія, контактна особа, країна кодом ISO (порожньо — PL), індекс, місто, вулиця, дім, телефон, e-mail. Це адреса відправника на накладній і адреса забору |
| «Компанія» | Ваша компанія, якщо в кожної свій рахунок FedEx; запис компанії має перевагу над загальним |
1
Користувач і Пароль2
Номер рахунку FedEx3
Послуга за замовчуванням4
Тестове середовище (sandbox)5
Відправник- Користувач і Пароль — API Key і Secret Key проєкту з developer.fedex.com.
- Номер рахунку FedEx — 9 цифр, з цього рахунку FedEx бере оплату.
- Послуга за замовчуванням — одна послуга FedEx для всіх накладних.
- Тестове середовище (sandbox) — перемикач тестового режиму FedEx.
- Відправник — дані вашої компанії, які потрапляють в накладну як відправник.
Форма зберігається сама, щойно ви змінили поле. «Пароль» після збереження показує крапки, а порожнє поле ключ не стирає.
Під час збереження Elbuz ключі не перевіряє. Помилку ключа покаже перша накладна: «FedEx OAuth: ‹текст FedEx›».
Яку послугу вибрати
| Послуга | Коли |
|---|---|
| FedEx Priority | За замовчуванням; внутрішня послуга FedEx у Польщі |
| FedEx Priority Express | Внутрішня послуга FedEx у Польщі |
| FedEx International Priority | Відправки за кордон: доставка до кінця дня, зазвичай за 1–3 робочі дні |
| FedEx Economy Select | За довідником FedEx — лише у Великій Британії; з Польщі не вибирайте |
Послуга одна на всі накладні, у формі накладної її не змінити. Відправляєте і по Польщі, і за кордон — перемкніть послугу перед накладною.
Тестове середовище FedEx
Увімкніть «Тестове середовище (sandbox)», впишіть ключі з вкладки «Test Key» і номер тестового рахунку, який FedEx видає до тестового ключа. Накладні підуть у пісочницю FedEx, справжньої відправки не буде. Перед роботою вимкніть перемикач і впишіть бойові ключі й номер рахунку.
Як виписати накладну FedEx із замовлення
Загальний порядок для всіх служб — у статті як виписати накладну із замовлення.
Де: картка замовлення зі способом доставки «FedEx» → секція «Доставка» → «Створити накладну».
Що форма заповнить сама і що перевірити
| Поле | Звідки | Що перевірити |
|---|---|---|
| Прізвище, Ім'я, Телефон, E-Mail | Замовлення | Телефон обовʼязковий |
| Індекс, Населений пункт, Вулиця, Дім, Квартира | Адреса доставки замовлення: уся адреса — у «Вулиця», «Дім» і «Квартира» порожні | Вулиця, дім і квартира разом — до 35 символів, довше Elbuz обріже |
| Країна (код ISO: DE, FR, IT, ES…) | Країна доставки замовлення | Не розпізнано — країна відправника |
| Загальна вага, кг | Вага товарів замовлення | Ваги немає й у товарах — піде 1 кг; округлення до 0,1 кг |
| Довжина, Ширина, Висота, см | Порожні | Передаються, лише якщо заповнено всі три |
| Зворотна доставка (одержувач) | «Гроші», якщо замовлення не оплачене й оплата при отриманні | Поставте «Не потрібно»: післяплату FedEx не підключено |
1
Країна (код ISO) одержувача2
Загальна вага, кг3
Довжина / Ширина / Висота4
Зворотна доставка: Не потрібно5
Створити накладну- Країна одержувача — двобуквений код ISO, тут DE.
- Загальна вага посилки в кілограмах.
- Габарити посилки в сантиметрах.
- Зворотна доставка (післяплата) не потрібна — обрано «Не потрібно».
- Кнопка, що відправляє запит у службу й створює накладну.
Номер замовлення йде в накладну як референс клієнта, до 30 символів. Оплачує відправник — з вашого рахунку FedEx, упаковка ваша, дата відправки — сьогодні. Поле «Опис відправлення» FedEx не передається.
Змінені значення форма запамʼятовує в замовленні: відкриєте її знову — вони на місці.
Що відбувається після «Створити накладну»
- Elbuz перевіряє дані ще до FedEx. Бракує номера рахунку чи адреси відправника — повідомлення з причиною, наприклад «Error: FedEx account number is required (API settings)»; накладна не створюється.
- FedEx створює відправлення. Номер відстеження лягає в «Сервіс доставки: номер», зʼявляється «Створено товарно-транспортну накладну №‹номер›».
- Якщо FedEx відмовив, у вікні буде його текст із кодом у дужках, а замовлення лишиться без номера.
Щоб у замовленні зʼявлялося посилання на відстеження, у способі доставки «FedEx» заповніть «Посилання на трекінг», наприклад https://www.fedex.com/fedextrack/?trknbr= (способи доставки).
Накладна створюється одразу й оплачується за тарифом FedEx. Скасувати чи змінити її з Elbuz не можна — лише у FedEx і лише поки посилку не передано курʼєру. Після скасування очистіть «Сервіс доставки: номер» у замовленні, щоб виписати нову.
Як надрукувати етикетку FedEx
Де: картка замовлення → «Перегляд накладної» → значок друку; або «Відправлення» → рядок → «Друк накладної».
Етикетка відкривається в новій вкладці: PDF на пів аркуша формату Letter. FedEx тримає посилання на етикетку 12 годин. Пізніше у вкладці зʼявиться «print error: FedEx: the label link has expired (12 hours) — reprint it in FedEx Ship Manager», тож друкуйте етикетку одразу після накладної.
Накладну, номер якої вписали в замовлення вручну, Elbuz не друкує: посилання на етикетку є лише в накладних, створених з Elbuz.
Як викликати курʼєра FedEx
Де: картка замовлення → «Перегляд накладної» → блок «Виклик курʼєра».
- «Дата забору» — за замовчуванням найближчий робочий день.
- «Забрати з» і «до» — порожньо: 10:00–17:00.
- «Посилок, шт.» і «Загальна вага, кг» — скільки забрати.
«Викликати курʼєра» → «Курʼєра замовлено #‹код›». Код підтвердження FedEx записується в замовлення, адреса забору — блок «Відправник» підключення. На сьогодні FedEx приймає заявку, поки не минув крайній час для вашого індексу.
Як Elbuz стежить за посилками FedEx
Кожні 10 хвилин Elbuz питає FedEx про посилки — до 100 накладних за прохід. Стежить за замовленнями за останні 60 днів і за замовленнями в позначених статусах, доки посилка не отримає стан «Отримано». Код і текст статусу FedEx видно в замовленні й у «Відправленні».
У «Відправленні» для FedEx працюють «Друк накладної», «SMS одержувачу» і «Відстеження на сайті служби» — сторінка fedex.com з номером посилки.
Як міняти статуси замовлень за кодами FedEx
Коди FedEx Elbuz вписує в «Статуси доставки» сам. Код, якого немає в таблиці, дає в «Відправленні» стан «Невідомо», і статус замовлення за ним не міняється.
- У підключенні FedEx, блок «Статуси замовлень, за якими перевіряти статус посилки в службі доставки», позначте статуси, у яких замовлення чекає доставки, наприклад «Відвантажено».
- У блоці «Налаштування повідомлень» відкрийте «Статуси доставки» (за потреби й «Статуси замовлення», «Статуси оплати»).
- Коди FedEx з таблиці нижче вже вписані в колонку «Код (назва) на сайті (API)»; свої дописуйте через кому.
| Ваш статус доставки | Коди FedEx | Стан у «Відправленні» |
|---|---|---|
| Чекання від відправника | OC — FedEx отримав дані відправлення | Створено |
| У дорозі | PU — забрано, IT — у дорозі, AR, AF, DP — сортування | В дорозі |
| На митниці | CC, CP, CD — митне оформлення | В дорозі |
| Видана кур'єру | OD — на доставці | В дорозі |
| Доставлено | DL | Отримано, опитування припиняється |
| Відмова від отримання | RS — повернення відправнику | Відмова |
Без коду DL навпроти «Доставлено» у «Статуси доставки» посилка не отримає стан «Отримано», і Elbuz питатиме про неї й після вручення, займаючи місце в ліміті 100 накладних за прохід.
Коди винятків DE, SE і DD лишіть поза таблицею: така посилка матиме стан «Невідомо», і ви її помітите. Коди — з довідника подій FedEx. Як працюють три таблиці статусів — у статті про автозміну статусу замовлення.
Сценарії
Перше підключення без ризику
Створіть проєкт на developer.fedex.com, впишіть тестові ключі й тестовий рахунок, увімкніть «Тестове середовище (sandbox)». Виписуйте накладну на своєму замовленні й друкуйте етикетку. Усе гаразд — перемкніться на бойові ключі.
Щоденна відправка в Німеччину
«Послуга за замовчуванням» — FedEx International Priority. З кожного замовлення — «Створити накладну», одразу друк етикетки, наприкінці — один «Виклик курʼєра» з кількістю посилок і загальною вагою.
Замовлення закриваються самі
Позначте в підключенні статус «Відвантажено». Код DL впишіть навпроти «Доставлено» і у «Статуси доставки», і у «Статуси замовлення». Посилка вручена — замовлення переходить у «Доставлено», а Elbuz перестає про неї питати.
Що робити, коли щось пішло не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Служба доставки не підключена: заповніть налаштування API цієї служби (Налаштування → Зовнішні сервіси API).» | Не вписано Secret Key або вимкнено «Активність» | Заповніть «Пароль» і ввімкніть «Активність» (що вписати) |
| «FedEx OAuth: …» | FedEx не прийняв ключі: тестові ключі при вимкненому sandbox або навпаки, чи старий Secret Key | Звірте пару ключів і перемикач «Тестове середовище (sandbox)» (тестове середовище) |
| «FedEx account number is required (API settings)» | Порожній «Номер рахунку FedEx» | Впишіть 9 цифр рахунку |
| «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 FedEx yet — choose «without COD»» | У «Зворотна доставка (одержувач)» стоїть «Гроші» | Виберіть «Не потрібно» |
| «FedEx: the label link has expired…» | Від створення накладної минуло понад 12 годин | Надрукуйте етикетку у FedEx Ship Manager |
| У «Відправленні» посилка FedEx зі станом «Невідомо» | Коду FedEx немає у вікні «Статуси доставки» | Допишіть код (коди FedEx) |
Часті запитання
Скільки коштує інтеграція FedEx в Elbuz?
Elbuz за накладні, етикетки й статуси FedEx нічого не списує. Доставку й курʼєра ви оплачуєте FedEx за своїм договором.
Чи можна відправляти FedEx не з Польщі?
Так, з будь-якої країни ЄС: впишіть код країни в «Країна» блоку «Відправник». Митних даних Elbuz не передає, тому відправки — в межах ЄС.
Чи можна з Elbuz відправити FedEx з післяплатою?
Ні, післяплату FedEx не підключено: накладна з «Гроші» відхиляється. Залиште «Не потрібно» або оформіть таку посилку у FedEx.
Як скасувати накладну FedEx?
Лише у FedEx, поки посилку не передано курʼєру. Потім очистіть «Сервіс доставки: номер» у замовленні (після створення).
Чи можна вибрати послугу FedEx для окремої накладної?
Ні, послуга одна для всіх — «Послуга за замовчуванням» у підключенні. Перемкніть її перед накладною іншого типу.
Чому статус FedEx не міняє статус замовлення?
Статус замовлення не позначено в підключенні або коду FedEx немає в таблиці. Позначте статус і впишіть коди (коди FedEx).
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка → FedEx
- Інші входи
- Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
- Право доступу
- підключення — «API та токени доступу»; накладна й курʼєр — вікно «Створення ТТН служби доставки»
- Підготувати
- рахунок FedEx (9 цифр) і проєкт на developer.fedex.com з Ship, Track і Pickup API
- Створити проєкт API і ключіdeveloper.fedex.com
- Вписати ключі, номер рахунку й відправникаЗовнішні сервіси та інтеграції → FedEx
- Вписати коди статусів FedExТам само, «Налаштування повідомлень»
- Виписати накладну й надрукувати етикеткуКартка замовлення, секція «Доставка»
- Викликати курʼєраПерегляд накладної
Суміжні теми
- Якщо потрібно бачити всі посилки всіх служб в одному списку — Відправлення.
- Якщо відправляєте ще й UPS — UPS в Elbuz: форма накладної та сама.
- Якщо магазин у Німеччині й працює з DHL Paket — DHL Paket в Elbuz.
- Якщо хочете порівняти способи виписати накладну — накладна із замовлення.
