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.
Dieser Artikel ist derzeit nur auf Ungarisch verfügbar.
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
- 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).
- 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.
- A fiók megnyitása után megkapod a 6 karakteres UPS-ügyfélszámot (pl.
A1B2C3). - 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
- Lépj be a developer.ups.com oldalra ugyanazzal a ups.com felhasználóval.
- Válaszd az Apps menüt, majd az Add Apps gombot.
- 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”).
- Válaszd ki az ügyfélszámodat (vagy add hozzá az Add Account gombbal), majd add meg az alkalmazás nevét (pl. „Rackoon”).
- A termékek közül add hozzá: Authorization (OAuth), Shipping, Tracking, Locator és Paperless Documents.
- 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
- Nyisd meg a Szolgáltatók menüt, és válaszd a UPS szolgáltatót.
- A Kapcsolat fülön a Környezet résznél válaszd a Teszt (sandbox) vagy az Éles lehetőséget.
- Töltsd ki a Client ID, Client Secret és UPS-ügyfélszám (Shipper Number) mezőt.
- 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.