Ugrás a tartalomra

3525 Miskolc, Bodótetői út 1. 3. em. 9.

2021 Lorz Kft.

Webshopmotorok

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.

Automatizálás

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ó.
Hogyan működik?

Í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.
Tipikus megoldások

Amit leggyakrabban építünk

  1. 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.

  2. 02

    Raktár → webshopkészlet

    A raktár- vagy ügyviteli rendszer készlet- és áradatai kötegelve, ütemezetten frissülnek a Shoprenterben.

  3. 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.

  4. 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.

Buktatók

Amire egy Shoprenter-integrációnál figyelünk

  1. 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.

  2. 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.

  3. 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.

  4. 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?
A Shoprenter hivatalos árlistája szerint az API a Gold csomagtól érhető el; a Bronze és a Silver csomag nem tartalmazza.
Kell külön alkalmazást regisztrálni?
Saját webshophoz nem: az adminfelületen létrehozott API-kliens elég. A több webshopnak szánt, nyilvános alkalmazásokat a Shoprenternél regisztrálni kell.
Működik még a régi API-hozzáférésünk?
A Shoprenter 2025 júliusában vezette be az OAuth2-alapú azonosítást, és 2026. szeptember 30. óta csak HTTPS-en szabad hívni az API-t. A régi megoldásokat érdemes átnézni és átállítani.

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.

Ajánlatot kérek