UPS

A UPS bekötése OAuth-kulcspárral és UPS-ügyfélszámmal, nemzetközi expressz és Standard szolgáltatások, UPS Access Point, papírmentes kereskedelmi számla és kárigény.

7 perc olvasásFrissítve: 2026. 11. 03.

Szerződés és API-hozzáférés igénylése

A UPS API-ját bármely UPS-ügyfélszámmal (Shipper Number) rendelkező feladó használhatja. A hozzáférést a UPS fejlesztői portálján (developer.ups.com) magad hozod létre. A portál és az API díjmentes, a szállítási díjat a UPS a szerződésed szerint számlázza.

1. UPS-fiók nyitása Magyarországon

  1. Nyisd meg a ups.com magyar oldalát (ups.com/hu), és a jobb felső Bejelentkezés menüben válaszd a Regisztráció lehetőséget: hozz létre egy ups.com felhasználót (My UPS).
  2. Bejelentkezés után a Fiók menüben válaszd a Fiók nyitása (Open an Account) pontot, és add meg a céged adatait: cégnév, adószám vagy közösségi adószám, székhely, kapcsolattartó, számlázási cím és fizetési mód.
  3. A fiók megnyitása után megkapod a 6 karakteres UPS-ügyfélszámot (pl. A1B2C3).
  4. Rendszeres feladáshoz és kedvezőbb piaci árhoz igényelj ajánlatot a UPS magyarországi értékesítésétől (a ups.com/hu Kapcsolat oldalán). A szerződéses díjak az ügyfélszámodhoz kapcsolódnak.

2. API-hozzáférés létrehozása

  1. Lépj be a developer.ups.com oldalra ugyanazzal a ups.com felhasználóval.
  2. Válaszd az Apps menüt, majd az Add Apps gombot.
  3. A kérdésnél jelöld, hogy a UPS-technológiát a saját vállalkozásodhoz használod („I want to integrate UPS technology into my business”).
  4. Válaszd ki az ügyfélszámodat (vagy add hozzá az Add Account gombbal), majd add meg az alkalmazás nevét (pl. „Rackoon”).
  5. A termékek közül add hozzá: Authorization (OAuth), Shipping, Tracking, Locator és Paperless Documents.
  6. Mentés után az alkalmazás Credentials részében látod a Client ID és Client Secret értéket.

3. Papírmentes kereskedelmi számla (Paperless Invoice)

EU-n kívüli csomagnál a UPS a vámadatokból kereskedelmi számlát készít. Ha a fiókod regisztrált a Paperless Invoice szolgáltatásra, a számla elektronikusan jut el a vámhatósághoz, nem kell kinyomtatnod. A regisztrációt a ups.com Fiók menüjében, a papírmentes számla beállításánál vagy a UPS ügyfélszolgálatán igényelheted. Regisztráció nélkül a UPS számláját a címke PDF-jének végére fűzzük: nyomtasd ki, írd alá, és tedd a csomagra.

4. Amit kapsz

A UPS-től kapott adat Rackoon-mező
Client ID (developer.ups.com → Apps → Credentials) Client ID
Client Secret Client Secret
6 karakteres ügyfélszám (Shipper Number) UPS-ügyfélszám (Shipper Number)

5. Tesztkörnyezet

A UPS-nek van tesztkörnyezete (Customer Integration Environment, CIE). Ugyanaz a Client ID és Client Secret működik benne, a tesztcímkék nem élesek, a UPS nem szállítja ki őket.

Megadás a Rackoonban

  1. Nyisd meg a Szolgáltatók menüt, és válaszd a UPS szolgáltatót.
  2. A Kapcsolat fülön a Környezet résznél válaszd a Teszt (sandbox) vagy az Éles lehetőséget.
  3. Töltsd ki a Client ID, Client Secret és UPS-ügyfélszám (Shipper Number) mezőt.
  4. Kattints a Mentés, majd a Kapcsolat tesztelése gombra. Ha az ellenőrzés sikeres, a kapcsolat állapota Csatlakoztatva lesz.

Részletek: Szolgáltató bekötése, összehasonlítás: Szolgáltatói szerződés és API-kulcsok.

Teszt és éles környezet

A Teszt (sandbox) környezetben a csomagokat a UPS tesztrendszerébe (CIE) küldjük, a címke nem érvényes. Éles indulás előtt állítsd a Környezet mezőt Éles értékre. A kulcspár mindkét környezetben ugyanaz.

Szolgáltatások

Szolgáltatás Típus Súlyhatár
UPS Standard Házhozszállítás (belföld és Európa) 70 kg
UPS Standard – UPS Access Point Átvevőhely 20 kg
UPS Express Saver Nemzetközi expressz 70 kg
UPS Express Nemzetközi expressz (délelőtti kézbesítés) 70 kg
UPS Express Plus Nemzetközi expressz (kora reggeli kézbesítés) 70 kg
UPS Expedited Nemzetközi, EU-n kívül 70 kg
UPS visszáru – nyomtatott visszaküldési címke (PRL) Visszáru 70 kg

Kiegészítő szolgáltatások: Utánvét (UPS Standard, belföldön és egyes EU-országokba), Értéknyilvánítás, Aláírás a kézbesítéskor, Felnőtt aláírása a kézbesítéskor, Szombati kézbesítés (expressz szolgáltatásoknál).

Címkeformátumok: A6 (PDF, 4×6 hüvelyk), ZPL (hőnyomtató).

Csomagpontok

UPS Access Point átvevőhelyre a UPS Standard – UPS Access Point szolgáltatással adhatsz fel. A pont azonosítóját (pl. U12345678) az Új csomag űrlapján add meg, a pont címét a UPS rendszeréből kérdezzük le. Access Pointos csomagnál a címzett e-mail-címe kötelező, ebben kapja az átvételi értesítést. Részletek: Csomagpontok és automaták.

Különleges szabályok

  • Nincs napzárás. A címke azonnal érvényes, a UPS a csomagot felvételkor szkenneli.
  • Telefonszám: nemzetközi csomagnál a feladó és a címzett telefonszáma is kötelező.
  • USA és Kanada: a UPS-nek az állam kódja is kell. Az irányítószámból kiszámoljuk. Ha ez nem sikerül, írd a település után (pl. „Austin, TX”).
  • Vámadat: EU-n kívüli csomagnál a vámtételekből kereskedelmi számlát készítünk. DDP-nél a vámot és az importáfát a UPS a te ügyfélszámodra terheli, DAP-nál a címzett fizeti.
  • Visszavonás: a UPS-nél a feladást a felvétel előtt vonhatod vissza (Void).
  • Státuszszinkron: időszakos lekérdezés, csomagonként. A vámeseményeket (vámkezelés, vámadat szükséges, vámkezelve) is jelezzük.

Kárigény és reklamáció

Bejelentés Online a ups.com/hu oldalon: Támogatás → Kárigény bejelentése (a nyomkövetési számmal). A feladó és a címzett is bejelentheti
Sérülés A kézbesítés után a lehető leghamarabb, nemzetközi légi szállításnál a Montreali Egyezmény szerint legkésőbb 14 napon belül
Késés Nemzetközi légi szállításnál legkésőbb 21 napon belül
Elveszés A UPS szállítási feltételeiben megadott határidőn belül. A csomagot előbb nyomkövetéssel keresd

Felelősség: a UPS szállítási feltételei és a nemzetközi egyezmények (Montreali Egyezmény, CMR) szerinti, súlyalapú korlátig. Magasabb értéknél használd az Értéknyilvánítás kiegészítőt.

Szükséges dokumentumok: nyomkövetési szám, a tartalom értékét igazoló számla, fényképek a csomagolásról és a tartalomról. A csomagot a csomagolással együtt őrizd meg az esetleges vizsgálathoz.

Megjegyzés: A pontos határidőket és összeghatárokat a UPS aktuális szállítási feltételei (ups.com/hu, Szállítási feltételek) és az egyedi szerződésed rögzítik.

A panelen a csomag oldalán a Műveletek → Reklamáció, kárigény ponttal indíthatsz reklamációt.