Szolgáltatói szerződés és API-kulcsok
Hogyan szerződsz az egyes szolgáltatókkal, hol igényled az API-hozzáférést, milyen adatokat kapsz, és hol van tesztkörnyezet.
This article is currently available in Hungarian only.
A Rackoon a saját szolgáltatói szerződésedet használja: a csomagokat a te nevedben, a te ügyfélszámoddal adjuk fel, a szállítási díjat pedig a szolgáltató a veled kötött szerződés alapján számlázza neked. Ezért a bekötés előtt két dolog kell:
- Szerződés vagy üzleti regisztráció a szolgáltatónál.
- API-hozzáférés: azok az azonosítók (kulcs, token, felhasználónév és jelszó), amelyekkel a szolgáltatónál azonosítunk téged.
A saját szerződés előnye, hogy a kialkudott díjaid, a kártérítési feltételeid és az utánvét-elszámolásod változatlanok maradnak, és a szolgáltatóval közvetlenül tartod a kapcsolatot.
Tipp: Ha még nincs szerződésed egy szolgáltatóval, vagy kedvezőbb díjakat szeretnél, a Rackoon Contract+ keretében díjmentesen tárgyalunk a nevedben. A szerződés ilyenkor is a te nevedre szól. Ld. Rackoon Contract+: kedvezőbb díjak, tárgyalás a nevedben.
Összehasonlítás
| Szolgáltató | Hogyan szerződsz | Hol igényled az API-hozzáférést | Mit kapsz | Tesztkörnyezet | Részletek |
|---|---|---|---|---|---|
| MPL | Ajánlatigénylő űrlap (posta.hu/webaruhazi_szerzodeskotes), egyedi szerződés | ÉnPostám-regisztráció, adatlap a [email protected] címre, majd Devportal → Alkalmazások | API Key, API Secret, vevőkód, megállapodáskód | Van, a sandbox kulcspár a Devportalon | MPL |
| GLS | Árajánlat-űrlap vagy [email protected], egyedi szerződés | A GLS-től: külön MyGLS-felhasználó, integráció: [email protected] | MyGLS-felhasználónév, jelszó, ügyfélszám | Van (test.mygls.hu), a GLS-től igényelhető | GLS |
| DPD | Árajánlat-űrlap a dpd.com/hu oldalon, napi 5+ csomagtól | A DPD-s értékesítőtől vagy kapcsolattartótól; [email protected] | Shipping API token, DSW-kód, feladási cím azonosítója | Van (preprod), a teszt-tokent a DPD adja | DPD |
| Express One | Az értékesítésen keresztül ([email protected]), egyedi szerződés | A szerződéssel együtt: WEBCAS-belépés | Cégazonosító, WEBCAS-felhasználónév, jelszó | Nincs | Express One |
| FÁMA | Ajánlatigénylés a famafutar.hu oldalon vagy [email protected] | A szerződés után a FÁMA értékesítésétől vagy a kapcsolattartótól | API-kulcs, feladói cím azonosítója | Nincs | FÁMA |
| Packeta | Online regisztráció webáruházként (client.packeta.com), jóváhagyás akár 3 munkanap | Nem kell külön igényelni: kliens szekció → Support oldal | API-jelszó, API-kulcs, feladó megjelölése | Nincs külön, tesztelés éles vagy tesztfiókkal | Packeta |
| FoxPost | Online regisztráció üzleti partnerként, szerződéskötés nélkül | foxpost.hu → Beállítások → Új generálása | Felhasználónév, jelszó, API-kulcs | Van, a [email protected] címen igényelhető | FoxPost |
| Fürgefutár | Pactic üzleti fiók, az integráció havi 25 csomagtól, [email protected] | Nincs külön kulcs: a Pactic-fiók belépési adatai | Pactic e-mail-cím és jelszó | Nincs (tesztmód valós fuvarlevél nélkül) | Fürgefutár |
| Trans-Pack | Kizárólag egyedi szerződés ([email protected]) | A szerződéskötéskor egyeztetitek | Partnerportál-belépés vagy API-kulcs, partnerazonosító | Nincs | Trans-Pack |
| UPS | Online fióknyitás a ups.com/hu oldalon, szerződéses díjakhoz ajánlat a UPS értékesítésétől | Önkiszolgáló: developer.ups.com → Apps → Add Apps | Client ID, Client Secret, 6 karakteres ügyfélszám (Shipper Number) | Van (CIE), ugyanazzal a kulcspárral | UPS |
| FedEx | Online fióknyitás a fedex.com/hu-hu oldalon, szerződéses díjakhoz ajánlat a FedEx értékesítésétől | Önkiszolgáló: developer.fedex.com → My Projects → Create API Project | API Key, Secret Key, 9 jegyű ügyfélszám | Van (sandbox), külön Test Key kulcspárral | FedEx |
Azt, hogy mennyi ideig tart a szerződéskötés, a legtöbb szolgáltató nem teszi közzé. Az online regisztrációs szolgáltatóknál (FoxPost, Packeta, UPS, FedEx) néhány óra vagy néhány munkanap, a szerződéses szolgáltatóknál az ajánlattól az aláírásig érdemes több héttel számolni.
Általános tanácsok
- Igényelj külön API-felhasználót az integrációhoz. Ne a saját vagy egy munkatársad napi belépését add meg: ha az illető jelszót cserél vagy kilép, a csomagfeladás leáll. Ahol a szolgáltató ezt lehetővé teszi (például GLS, Express One), kérdezd meg az üzletkötőt, hogyan nyithatsz integrációs felhasználót.
- Tárold biztonságosan a kulcsokat. Az API-kulcsot, a tokent és a jelszót kezeld jelszóként: ne küldd nyílt e-mailben, ne tedd közös dokumentumba. A Rackoonban a titkos adatokat titkosítva tároljuk, és a felületen csak az utolsó karaktereik látszanak.
- Telephelyenként eltérő azonosítók. Több feladó telephelynél a szolgáltató eltérő ügyfélszámot, feladási cím azonosítót vagy teljesen külön hozzáférést adhat. A DPD-nél és a FoxPostnál minden telephelyhez saját hozzáférés kell. Ezeket a Külön hozzáférés gombbal adhatod meg, ld. Szolgáltató bekötése.
- Tartsd külön a teszt- és az éles adatokat. Ahol van tesztkörnyezet, ott a teszt-hozzáférés jellemzően más, mint az éles (az MPL-nél például külön kulcspár tartozik hozzájuk). Éles indulás előtt a Környezet mezőt állítsd Éles értékre.
- Kulcscsere után frissíts. Ha a szolgáltatónál új kulcsot generálsz vagy jelszót cserélsz, a Rackoonban is add meg az újat, majd kattints a Kapcsolat tesztelése gombra.
- Szerződéses szolgáltatások. Hogy egy szolgáltatás (például szombati kézbesítés vagy cserecsomag) használható-e, azt a szerződésed dönti el. A Rackoonban csak azt engedélyezd a Szolgáltatások fülön, amire szerződésed van.
Tipp: Ha a szolgáltató integrációs csapata azt kérdezi, milyen rendszerből adsz fel, nyugodtan jelezd, hogy a Rackoon többszolgáltatós panelt használod, a saját szerződéseddel.
Megadás a Rackoonban
Ha megvannak az adatok, a bekötés lépései: Szolgáltató bekötése. Röviden:
- Aktiváld a szolgáltató modulját a Modulok oldalon.
- Nyisd meg a Szolgáltatók menüt, és válaszd ki a szolgáltatót.
- A Kapcsolat fülön válaszd ki a Környezet értékét, és töltsd ki a hozzáférési mezőket.
- Kattints a Mentés, majd a Kapcsolat tesztelése gombra.