Shoprenter API

Shoprenter API · fejlesztőknek és boltoknak

Shoprenter API: token, limitek, szinkron, érthetően.

REST API Gold csomagtól, 3 kérés/mp limittel. Megmutatjuk az új, tokenes hitelesítést, a batch- és webhook-buktatókat, és kiszámolhatod, milyen gyakori készletszinkron kell, hogy ne add el kétszer ugyanazt.

Nyilvános API alapján: doc.shoprenter.hu Fix ár: 390 000 Ft-tól, nettó Ellenőrizve: 2026. október 10.
A Shoprenter rendelései webhookkal azonnal mennek az integráción át az ERP-be, a más csatornán fogyó készlet ütemezett szinkronnal jön vissza a boltba ShoprenterAPI2 · Bearer Bolti készletstock1–stock4 K ERP, raktára készlet gazdája Más csatornabolt, piactér order_confirm rendelés utolsó db stock1: 0
webhook: rendelés azonnal készlet: ütemezett szinkron 3 kérés/mp, sorba állítva
Fejlesztői útmutató

A Shoprenter API egy képernyőn

A hivatalos dokumentáció a doc.shoprenter.hu oldalon van, az alkalmazásfejlesztői program a partner.shoprenter.hu címen. Ez a rész a gyors eligazodáshoz készült.

A Shoprenter API alapadatai
TípusREST (GET, POST, PUT, DELETE). Kérés JSON-ban (ajánlott) vagy multipart formában. A válasz alapból XML, Accept: application/json fejléccel JSON. A Content-Type fejléc kötelező.
CsomagGold csomagtól (Gold, Platinum). A Bronze és a Silver csomagban nincs API.
HitelesítésÚj mód: egyedi API-kliens (Beállítások > API beállítások), abból client_credentials tokenkérés a https://oauth.app.shoprenter.net/<shopnév>/app/token címen, majd Authorization: Bearer …. Régi mód: API-felhasználónév és jelszó (Basic). A régi kapcsolatok működnek, de az új végpontokhoz az új rendszer kell.
AlapcímTokennel: https://<shopnév>.api2.myshoprenter.hu/api/. Régi, Basic módban: https://<shopnév>.api.myshoprenter.hu/
JogosultságErőforrásonkénti scope-ok, például product.product:read, order.order:write, store.webhook:write. A boltgazda adja meg, és később bővítheti.
Limit3 kérés/mp alkalmazásonként és boltonként (180/perc). Túllépésnél 429.

Egyedi API-kliens a boltban

Ha egy bolthoz kell integráció, nem kell platform-alkalmazást fejleszteni. A boltgazda a Beállítások > API beállítások menüben létrehoz egy klienst, csak a szükséges scope-okkal.

Token kérése

POST a token-végpontra grant_type: client_credentials, client_id és client_secret mezőkkel. A válaszban access_token (JWT) és expires_in jön.

Hívás az API2 címen

Authorization: Bearer …, Accept: application/json és Content-Type fejléccel. A régi címről és a Basic módról ez a váltás.

Lejárat előtt új token

Az expires_in másodpercben mondja meg az élettartamot (a dokumentáció példájában 3600). A JWT-ből a lejárat és a kapott scope-ok is kiolvashatók.

Tömegesen batch-csel, eseményre webhookkal

Sok kérést a /batch végponton egyben küldhetsz. Rendelés- és hírlevél-eseményekre webhookot állíthatsz be API-ból.

Token és első hívás · curla titok fájlban, nem a parancssorban
# 1) Access token az egyedi API-kliens adataival
#    token-keres.json (ne commitold):
#    {"grant_type": "client_credentials",
#     "client_id": "…", "client_secret": "…"}
curl -s -X POST "https://oauth.app.shoprenter.net/SHOPNEV/app/token" \
  -H "Content-Type: application/json" \
  -d @token-keres.json
# Válasz: {"token_type": "Bearer", "expires_in": 3600,
#          "access_token": "eyJ…"}

# 2) Termékek lekérése az API2 címen, JSON-ban
curl -s "https://SHOPNEV.api2.myshoprenter.hu/api/products?limit=10" \
  -H "Authorization: Bearer $SR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"
# 429 = túl gyors vagy: 3 kérés/mp alkalmazásonként és boltonként

A token-végpont, a kérés és a válasz mezői a Shoprenter tokenkérési leírása szerint. A SHOPNEV helyére a bolt neve kerül.

Buktatók, amelyeken a legtöbb Shoprenter-integráció elcsúszik

3 kérés/mp: sorba kell állítani

A limit alkalmazásonként és boltonként él, ez 180 kérés percenként. Párhuzamos szálakkal gyorsan 429 lesz belőle. Egy sor, egyenletes tempó, és csak a változott tételek.

A batch akkor is 200-at ad, ha egy alkérés elhasal

A /batch válasza technikai hibánál is 200, ezért minden alkérés saját statusCode-ját ellenőrizd. Ajánlott legfeljebb 200 kérés batch-enként, 32 MB-ig, és ne küldj batch-eket párhuzamosan.

A válasz alapból XML

JSON-hoz Accept: application/json fejléc kell. A Content-Type megadása minden kérésnél kötelező.

Scope csak tokennel

A dokumentáció szerint az erőforrásonkénti scope-ok csak a tokenes (JWT) kéréseknél érvényesek. Ha jogosultság-korlátozott hozzáférést akarsz, a tokenes hitelesítésre kell váltani.

Webhook rendelésre igen, készletre nem

Webhook van order_confirm, order_status_change, hírlevél- és abandoned_cart eseményre, JSON-ban vagy XML-ben. A dokumentált események között nincs készletváltozás, ezért a készletet ütemezetten vagy az ERP felől kell frissíteni.

Négy raktár, négy mező

A termék készlete a stock1–stock4 mezőkben van. Kétraktáras szinkronnál előre rögzítsd, melyik raktár melyik mező, és ki a készlet gazdája.

Saját azonosító: Outer ID

Létrehozáskor saját azonosítót (például cikkszámot) adhatsz az URI-ban, és később arra hivatkozhatsz. Ahol van Extend erőforrás (például productExtend), a dokumentáció azt ajánlja helyette.

Lejárt token, csendes leállás

A token lejár, utána a kérések elutasítást kapnak. Kérj újat lejárat előtt, és riasszon a rendszer, ha a tokenkérés hibát ad (például visszavont kliens).

Szinkron-kalkulátor

Milyen gyakran kell szinkronizálni, hogy ne add el kétszer ugyanazt?

Ha egy termék a boltban, piactéren vagy a raktárban elfogy, a webshop a következő szinkronig még eladhatónak mutatja. Állítsd be a számaidat, és nézd meg, mekkora ez a „vak ablak” napi, óránkénti és 15 perces szinkronnál. Szemléltetés, egyszerű és látható képlettel, nem előrejelzés.

1A boltod

2Készletmozgás a webshopon kívül

Bolti eladás, piactér, nagyker vagy ERP-korrekció, amitől egy termék elfogy, de a webshop még nem tudja.

Ami elfogy, az jellemzően keresettebb az átlagnál. 1× = átlagos.

3Mibe kerül egy túladás?

Lemondás, visszautalás, ügyfélszolgálati idő, elmaradó újravásárlás. A saját becslésed.

Egy nap, három szinkron

Egy nap 24 órája · kék vonal = szinkron · piros pont = máshol elfogyott a termék · piros sáv = a webshop még eladhatónak mutatja
Javasolt szinkronÓránként
Eredmény
Shoprenter MCP

A Shoprenternek saját MCP-alkalmazása van. Mire jó, és mire figyelj?

A „Shoprenter MCP” alkalmazást 2026. március 3-án jelentették be. Az Alkalmazások menüből telepíthető: kiválasztod a chat klienst, majd hitelesítesz. Ezután egy AI-asszisztens a boltodban dolgozhat.

képességek

Mit tud?

Termékadat lekérdezése és frissítése, raktárankénti készletmódosítás, kuponlétrehozás, rendelésösszesítés, vásárlókeresés és blogposzt-írás, a bejelentés szerint.

csomagfüggő

Melyik csomagban van?

Erről nem találtunk nyilvános adatot. Csomagfüggő lehet, ezért ellenőrizd a Shoprenternél, mielőtt erre tervezel. A Claude connector-könyvtárában 2026 októberében nem szerepelt.

kockázat

Mire figyelj?

Az ár-, készlet- és kuponmódosítás chatből egy elgépeléssel élesbe mehet. A vásárlókeresés személyes adatot visz az AI-szolgáltatóhoz. Írásnál jóváhagyási lépés, személyes adatnál szabályzat kell.

Mit csinálunk mi?

Segítünk beállítani, és biztonságos munkafolyamatot építünk rá: ki mit írhat, mit kell jóváhagyni, mi nem mehet AI-hoz. Ha a csapat Claude-ot használ, ez a Claude a cégedben csomag része. Automatikus, felügyelt szinkronhoz viszont klasszikus integráció kell, nem chat.

Fix áras bekötés

Nem akarod megírni? Bekötjük a Shoprenter-boltodat.

Az ár egy rendszerpárra és legfeljebb négy adattípusra szól. A konfigurátorban két perc alatt összeállítod, a szinkron gyakoriságát (naponta, óránként, 15 percenként) is ott választod.

Egyirányú kapcsolat

390 000 Ft nettó, egyszeri
  • Például rendelés → számlázó, vagy ERP-készlet → Shoprenter
  • Sorba állított hívások a 3 kérés/mp limit alatt
  • Átadás 15 munkanap alatt

Kétirányú vagy kétraktáras

690 000 Ft nettó, egyszeri
  • Például ERP ↔ Shoprenter, ütközéskezeléssel
  • Raktárak leképezése a stock1–stock4 mezőkre
  • Átadás 15 munkanap alatt

Felügyelet az átadás után

39 000 Ft /hó, nettó
  • Hibafigyelés, riasztás, API-változások követése
  • SLA-val: 49 000 Ft/hó
  • SLA: 1 munkanapos reakcióidő, havi riport
Őszintén: Shoprenter-integrációnk még nem fut élesben ügyfélnél. A nyilvános API alapján, a te teszt- vagy fejlesztői boltodban építjük, mentéssel és idempotens szinkronnal. Élesben futó kétraktáras készletünk Unas és CloudERP között van (a CloudERP beépített integrációjára építve), lásd a munkáink oldalt.

Csak vállalkozásoknak. Minden ár nettó, az ÁFA-t külön számlázzuk. Fizetés: 50% előleg, 50% átadáskor. A 15 munkanap az előleg és az API-hozzáférés beérkezésétől számít. A Shoprenter-csomag díját a Shoprenternek fizeted, nem nekünk.

Gyakori kérdések

Shoprenter API – amit a legtöbben kérdeznek

Melyik Shoprenter-csomagban van API?
A Gold csomagtól (Gold, Platinum). A Bronze és a Silver csomagban nincs API.
Mennyi a Shoprenter API limitje?
3 kérés másodpercenként, alkalmazásonként és boltonként, vagyis 180 kérés percenként. Túllépésnél 429-es hibakód jön.
Felhasználónév-jelszó vagy token kell?
2025. július 24. óta van új jogosultságkezelés: erőforrás-szintű jogok, több API-kliens és tokenes hozzáférés. Egy bolthoz egyedi API-klienst hozol létre, abból client_credentials tokent kérsz, és az API2 címet hívod. A régi, felhasználónév-jelszavas kapcsolatok működnek, de az új végpontokhoz az új rendszer kell.
Van a Shoprenternek webhookja?
Van, és API-ból is beállítható: rendelés leadására, rendelésállapot-változásra, hírlevél-feliratkozásra, -leiratkozásra és -adatmódosításra, valamint kosárelhagyásra. JSON-t vagy XML-t küld, késleltetés is megadható.
JSON-t vagy XML-t ad vissza?
Alapból XML-t. Az Accept: application/json fejléccel JSON-t. Kérésben a JSON az ajánlott, a Content-Type fejléc kötelező.
Van Shoprenter MCP?
Igen, a „Shoprenter MCP” alkalmazást 2026. március 3-án jelentették be. Hogy melyik csomag kell hozzá, arról nem találtunk nyilvános adatot, ezért ellenőrizd a Shoprenternél.
Milyen gyakran kell szinkronizálni a készletet?
Attól függ, mennyi termék fogy el a webshopon kívül, és mennyire keresettek. A fenti kalkulátor egy átlátható képlettel megmutatja a napi, óránkénti és 15 perces szinkron különbségét. Sok boltnak az óránkénti is elég, gyorsan forgó készletnél sűrűbb kell.
Mennyibe kerül, ha ti kötitek be?
Egyirányú kapcsolat 390 000 Ft, kétirányú vagy kétraktáras 690 000 Ft, nettó, 15 munkanap alatt. Felügyelet 39 000 Ft/hó, SLA-val 49 000 Ft/hó.
Hivatalos Shoprenter-partnerek vagytok?
Nem. Független fejlesztők vagyunk, és a Shoprenter nyilvános API-ját használjuk.
Kapcsolódó

Másik rendszerrel kötnéd össze?

A Shoprenter név a jogosultja védjegye; a Kidologic független fejlesztő, nem a Shoprenter partnere. Az oldalon a nevet csak leíró jelleggel használjuk.

Fix ár, nyílt specifikáció, előre látható határidő.

Nem kell időpontot egyeztetned ahhoz, hogy megtudd, mennyibe kerül. Állítsd össze, nézd meg, küldd el.