Shoprenter integráció: rendelés, számla, készlet és futár automatikusan
A Shoprenter hivatalos API-ján a rendelések, termékek, készletek és vevők programból olvashatók és írhatók, a webhookok pedig azonnal jelzik az új rendelést. Így a számlázás, a raktár és a szállítás kézi másolgatás nélkül követheti a webshopot.
Mit lehet automatizálni egy Shoprenter-integrációval?
- Új rendelés → számla: a rendelés visszaigazolásakor automatikusan elkészül a számla Számlázz.hu vagy Billingo rendszerben.
- Készlet és ár szinkronja a raktár- vagy ügyviteli rendszerből, kötegelt frissítéssel.
- A rendelésállapot és a nyomkövetési szám visszaírása, hogy a vevő mindig lássa, hol tart a csomag.
- Vevők és rendelések átadása a CRM-be, a kosárelhagyások követése.
- Futárcímke a rendelés adataiból — lásd: futárszolgálat-integráció.
Így működik a Shoprenter-integráció
01Hogyan kapcsolódunk?
A Shoprenter API REST-alapú, JSON- és XML-formátumban is válaszol — mi a JSON-t használjuk. Az azonosítás 2025 júliusa óta OAuth2-vel történik: a webshop adminfelületén (Beállítások › API beállítások) létrehozott API-kliens adataival hozzáférési tokent kérünk, amely egy óráig érvényes. A több webshopnak szánt, nyilvános alkalmazásokat a Shoprenternél külön regisztrálni kell.
Az API a Shoprenter hivatalos árlistája szerint a Gold csomagtól érhető el — ha a webshop kisebb csomagon fut, az integráció előtt csomagváltás kell.
02Webhookok: azonnali jelzés új rendelésnél
A Shoprenter többek között rendelés-visszaigazoláskor, rendelésállapot-változáskor és kosárelhagyáskor küld webhookot. Ezekre indítjuk a számlázást, a szállítást vagy a CRM-bejegyzést.
A dokumentáció nem rögzíti a webhookok újraküldésének és aláírásának szabályait, ezért a webhook mellé rendszeres egyeztető lekérdezést is építünk — így egyetlen rendelés sem maradhat ki.
03Korlátok és nagy adatmennyiség
Az API alkalmazásonként és webshoponként másodpercenként 3 kérést enged, efölött hibát ad. Sok termék vagy készletadat frissítéséhez kötegelt (batch) feldolgozást használunk: egy kötegben nagyjából 200 kérés javasolt, a kötegeket pedig egymás után, nem párhuzamosan küldjük.
04Fejlesztőknek: Shoprenter API gyorsreferencia
A leggyakoribb technikai kérdések röviden, a Shoprenter hivatalos fejlesztői dokumentációja alapján (ellenőrizve: 2026. november 4.). A részletes végpontlistát és a mezőket a lenti forrásokban találod.
- Alapcím: https://{boltnév}.api2.myshoprenter.hu/api/ — REST-felület. A kérés JSON (vagy multipart/form-data), a Content-Type fejléc kötelező. A válasz alapból XML; JSON-hoz Accept: application/json fejléc kell.
- Azonosítás: OAuth2 client credentials. A tokent a https://oauth.app.shoprenter.net/{boltnév}/app/token címről kérjük, és Authorization: Bearer fejlécben küldjük; a dokumentáció példájában egy óráig érvényes. A régi Basic azonosítás már nem támogatott.
- Hozzáférés: egy bolthoz a bolt adminja hoz létre egyedi API-klienst a Beállítások › API beállítások menüben, és ott adja meg a jogosultságait. Alkalmazásfejlesztéshez fejlesztői tesztbolt igényelhető.
- Korlát: alkalmazásonként és boltonként másodpercenként 3 kérés; túllépéskor 429-es válasz jön.
- Batch: a /batch végpontra legfeljebb 200 alkérést javasol a dokumentáció, 32 MB-os törzzsel. Szinkron fut, és akkor is 200-at ad, ha egy alkérés hibás — az alkérések statusCode-ját egyenként kell ellenőrizni. A batch-eket egymás után, ne párhuzamosan küldjük.
- Lapozás és hibakódok: page=0-tól induló lapozás limit paraméterrel; a full=1 linkek helyett a teljes adatot adja. A 400-as válaszon belül saját kód jelzi a hibát (például 40009: hibás dátum), az 504 pedig azt, hogy a kérést kisebb részekre kell bontani.
- Webhookok: rendelés-visszaigazolás, rendelésállapot-változás, hírlevél-események és elhagyott kosár, JSON vagy XML törzzsel, opcionális késleltetéssel. Az újraküldést és az aláírást a dokumentáció nem írja le, ezért a fogadó oldalon ellenőrizzük és naplózzuk a beérkező hívásokat.
Amit leggyakrabban építünk
- 01
Webshop → számlázó → NAV
A visszaigazolt rendelésből automatikusan számla lesz, a NAV-jelentést a számlázó szolgáltatás végzi — a NAV Online Számla szabályai szerint.
- 02
Raktár → webshopkészlet
A raktár- vagy ügyviteli rendszer készlet- és áradatai kötegelve, ütemezetten frissülnek a Shoprenterben.
- 03
Futár → nyomkövetés a rendelésben
A csomagfeladás után a nyomkövetési szám és az új állapot visszakerül a rendeléshez, a vevő pedig értesítést kap.
- 04
Vevők → CRM
A vásárlók és a rendelések a MiniCRM-be vagy egy egyedi CRM-be kerülnek, ahonnan az értékesítés és az ügyfélszolgálat dolgozik.
Amire egy Shoprenter-integrációnál figyelünk
- 01
Csak HTTPS
2026. szeptember 30. óta a Shoprenter a sima HTTP-kéréseket HTTPS-re irányítja át, és ilyenkor a kérés törzse elveszhet. A régi, HTTP-t hívó integrációk így csendben hibázhatnak.
- 02
Régi azonosítás
A régebbi, Basic-azonosítást használó integrációkat érdemes OAuth2-re és az új API-címre átállítani — új alkalmazás már nem kaphat régi típusú hozzáférést.
- 03
Webhook egyeztetés nélkül
Egy elveszett webhook egy kimaradt számlát vagy csomagot jelent. A webhookra épülő folyamatok mellé ezért mindig egyeztető lekérdezés is kerül.
- 04
Sebességkorlát
A másodpercenkénti 3 kérés gyorsan elfogy egy teljes katalógus frissítésénél; a kéréseket sorba állítjuk, és ahol lehet, kötegeljük.
Gyakori kérdések
Melyik Shoprenter-csomag kell az API-hoz?
Kell külön alkalmazást regisztrálni?
Működik még a régi API-hozzáférésünk?
Kapcsolódó integrációk
Források
- Shoprenter — fejlesztői dokumentáció
- Shoprenter API — korlátok és követelmények
- Shoprenter API — kötegelt feldolgozás
- Shoprenter API — webhookok
- Shoprenter API — hozzáférési token igénylése
- Shoprenter — változásnapló
- Shoprenter — árak és csomagok
- Shoprenter fejlesztői dokumentáció — státuszkódok
- Shoprenter fejlesztői dokumentáció — egyedi API-kliensek
Utolsó szakmai ellenőrzés: 2026. november 4.
Shoprenter-integráció: kérj ajánlatot
Írd meg, milyen rendszereket használsz és mit szeretnél automatizálni — egy rövid, ingyenes egyeztetés után írásos, tételes ajánlatot adunk.

