MiniCRM integráció: webshop, űrlap és számlázás egy folyamatban
A MiniCRM a hivatalos API-n, XML-szinkronizáción és webhookokon keresztül köthető össze a webshoppal, a weboldal űrlapjaival és a számlázással. Így az érdeklődő, a rendelés és a számla ugyanabban a folyamatban marad, kézi átmásolás nélkül.
Platformok szerint egy táblában: melyik CRM és webshopmotor mivel köthető össze, hivatalos forrásokkal.
Mit lehet automatizálni egy MiniCRM-integrációval?
- Webshop → MiniCRM: rendelések és vevők átadása XML-szinkronnal, ahogy a MiniCRM webshopokhoz ajánlja.
- Weboldal-űrlap → új adatlap: az érdeklődő automatikusan bekerül a CRM-be, felelőssel és teendővel.
- Adatlap-állapot → számla: ha egy ügy megnyert állapotba kerül, webhook indítja a számlázást Billingo vagy Számlázz.hu rendszerben.
- Teendők és emlékeztetők létrehozása külső eseményekre.
- Ügyfél- és cégadatok szinkronja más rendszerekkel.
Így működik a MiniCRM-integráció
01Hogyan kapcsolódunk?
A MiniCRM fő interfésze az R3 REST API (JSON); emellett van számlázási és webes jelentkezési (Signup) végpontja, valamint XML-szinkronizációja. Az azonosítás a rendszerazonosítóval és egy API-kulccsal történik, amelyet adminisztrátori jogú felhasználó generál.
Az API Professional vagy Enterprise csomaggal, a „MiniCRM REST APIs + XML szinkronizáció” kiegészítővel érhető el. Ha a csomag később kisebbre vált, az integráció hibát kezd adni — ezt érdemes tudni csomagváltás előtt.
02Korlátok
A MiniCRM hívásszám-korlátai miatt a nagyobb adatmozgatást ütemezett, kötegelt szinkronra tervezzük:
- R3 API: percenként 60 kérés (kérésre 120-ra vagy 180-ra emelhető);
- XML-szinkron: óránként 180 kérés;
- a listák 100-as oldalakban érkeznek.
03Webhookok
A MiniCRM webhookjait a MiniCRM ügyfélszolgálata állítja be. Sikertelen kézbesítésnél hatszor próbálkozik (10 másodperctől 1 óráig növekvő szünetekkel), utána a változás elvész. A fogadó oldalt ezért megbízhatóra építjük, és szükség esetén egyeztető lekérdezést is futtatunk. Teszteléshez külön tesztrendszer kérhető.
04Fejlesztőknek: MiniCRM API (R3) gyorsreferencia
A leggyakoribb technikai kérdések röviden, a MiniCRM 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://r3.minicrm.hu/Api/R3 — JSON, UTF-8 kódolással. Külön végpontcsoport szolgálja a számlákat, rendeléseket, ajánlatokat és az űrlapbeküldést (/Api/Invoice, /Api/Order, /Api/Offer, /Api/Signup). A hibaválasz sima szöveg, nem JSON.
- Azonosítás: HTTP Basic. A felhasználónév a rendszerazonosító (SystemId — a böngésző címsorában az r3.minicrm.hu/ utáni szám), a jelszó az API-kulcs, amelyet adminisztrátor hoz létre a Beállítások › Rendszer menüben.
- Hozzáférés: Professional vagy Enterprise csomag, vagy a „MiniCRM REST APIs + XML szinkronizáció” kiegészítő.
- Korlát: az R3 API percenként 60, az XML SyncFeed óránként 180 kérést enged; túllépéskor 429. A keret token-bucket elven töltődik vissza, az első 429 után addig semmi nem fut le. Kérésre percenként 120 vagy 180 is beállítható; a számla-végpontnak nincs korlátja.
- Erőforrások: Project (adatlap), Contact, Address, ToDo, Template, Category, Schema, ProjectHistory. Új adatlaphoz kötelező a CategoryId és a ContactId, ezek utólag nem módosíthatók.
- Lapozás: oldalanként 100 találat, a Page 0-tól indul; a változások az UpdatedSince szűrővel kérdezhetők le.
- Webhook és teszt: Contact- és Project-változásnál POST-hívás jön; a fogadónak 200-at kell adnia, különben hat újrapróbálkozás következik 10 másodperctől 1 óráig. A webhookot a MiniCRM ügyfélszolgálata állítja be; ha a fogadó az API-n visszaír, figyelni kell a végtelen ciklusra. Külön tesztrendszer kérhető, amely nem küld e-mailt.
Amit leggyakrabban építünk
- 01
Webshop → CRM
A webshop rendelései és vevői XML-szinkronnal kerülnek a MiniCRM-be — például WooCommerce vagy Shoprenter webshopból.
- 02
Űrlap → érdeklődő
A weboldal ajánlatkérő űrlapjából közvetlenül adatlap lesz, felelőssel és határidős teendővel.
- 03
Megnyert ügy → számla
Az adatlap állapotváltozása webhookkal indítja a számlázást; a számla adatai visszakerülnek az adatlapra.
Amire egy MiniCRM-integrációnál figyelünk
- 01
Három hívás egy új ügyfélért
Egy cég, egy kapcsolattartó és egy adatlap létrehozása REST-en három külön hívás. A percenkénti kerettel együtt ezt tervezni kell, és hiba esetén nem maradhat félkész rekord.
- 02
Webhook-hurok
Ha a webhookot feldolgozó rendszer ugyanazokat a mezőket írja vissza, a változás újabb webhookot indít. A visszaírást ezért szűrjük.
- 03
Elveszett változások
Hat sikertelen próbálkozás után a MiniCRM eldobja a változást. Ha a fogadó rendszer hosszabban kiesik, egyeztető lekérdezéssel pótoljuk a kimaradt eseményeket.
- 04
Csomagváltás
Kisebb csomagra váltáskor megszűnik az API-hozzáférés, és az integráció hibát ad — ezt a csomag módosítása előtt érdemes végiggondolni.
Gyakori kérdések
Melyik MiniCRM-csomag kell az API-hoz?
Webshophoz REST API-t vagy XML-szinkront használjunk?
Kezdeményez a MiniCRM hívást a mi rendszerünk felé?
Kapcsolódó integrációk
Források
- MiniCRM — API-dokumentáció
- MiniCRM — integrációs kézikönyv
- MiniCRM Integrations Manual (2026. szeptember, PDF)
Utolsó szakmai ellenőrzés: 2026. november 4.
MiniCRM-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.

