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

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

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

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

    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

    1. Увійдіть на developer.fedex.com з обліковим записом FedEx і створіть організацію в «My Projects».
    2. «Add shipping accounts» → «+ Add Account»: номер рахунку FedEx і адреса платника.
    3. «+ Create API Project»: позначте Ship API, Track API і Pickup API, назвіть проєкт і виберіть країни відправки.
    4. Скопіюйте ключі: тестові — на вкладці «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; запис компанії має перевагу над загальним
    Форма підключення FedEx: ключі доступу, номер рахунку, послуга, sandbox і відправник
    1Користувач і Пароль
    2Номер рахунку FedEx
    3Послуга за замовчуванням
    4Тестове середовище (sandbox)
    5Відправник
    1. Користувач і Пароль — API Key і Secret Key проєкту з developer.fedex.com.
    2. Номер рахунку FedEx — 9 цифр, з цього рахунку FedEx бере оплату.
    3. Послуга за замовчуванням — одна послуга FedEx для всіх накладних.
    4. Тестове середовище (sandbox) — перемикач тестового режиму FedEx.
    5. Відправник — дані вашої компанії, які потрапляють в накладну як відправник.

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

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

    Номер замовлення йде в накладну як референс клієнта, до 30 символів. Оплачує відправник — з вашого рахунку FedEx, упаковка ваша, дата відправки — сьогодні. Поле «Опис відправлення» FedEx не передається.

    Змінені значення форма запамʼятовує в замовленні: відкриєте її знову — вони на місці.

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

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

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

    Суміжні теми

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

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

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

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

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

    Зміст статті

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

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