Webshopmotorok

WooCommerce integráció: rendelés, számlázás és készlet automatikusan

A WooCommerce a WordPress webshopbővítménye: a saját tárhelyeden fut, így szinte bármihez köthető. A hivatalos REST API-n a rendelések, termékek, vevők és kuponok programból kezelhetők, a webhookok pedig azonnal jeleznek új rendelésnél vagy változásnál.

Automatizálás

Mit lehet automatizálni egy WooCommerce-integrációval?

  • Új rendelés → számla és NAV-jelentés Számlázz.hu vagy Billingo rendszerben.
  • Készlet és ár szinkronja a raktár- vagy ügyviteli rendszerből, kötegelt frissítéssel (kérésenként legfeljebb 100 elem).
  • Futárcímke és nyomkövetés: a csomagszám visszakerül a rendeléshez és a vevőhöz.
  • Vevők és rendelések átadása a CRM-be.
  • Visszatérítések, kuponok és rendelésállapotok kezelése külső rendszerből.
Hogyan működik?

Így működik a WooCommerce-integráció

01Hogyan kapcsolódunk?

A WooCommerce REST API (v3) a WordPress beépített REST-felületére épül. Az azonosítás a WooCommerce beállításaiban létrehozott kulcspárral (consumer key és secret) történik, olvasási, írási vagy mindkét jogosultsággal — HTTPS-en.

A régi, úgynevezett Legacy REST API a WooCommerce 9.0 óta nem része az alaprendszernek, csak külön bővítményként érhető el. Az erre épülő régi integrációkat érdemes a v3 API-ra átírni.

02Webhookok

A WooCommerce webhookot küld rendelés, termék, vevő és kupon létrehozásakor, módosításakor és törlésekor. Minden kérés HMAC-SHA256 aláírást visel, amit ellenőrzünk, mielőtt bármit feldolgoznánk.

Fontos: 5 egymást követő sikertelen kézbesítés után a WooCommerce letiltja a webhookot. Ezért a fogadó oldalt megbízhatóra építjük, és figyeljük a webhookok állapotát.

03Saját szerver, saját felelősség

Mivel a WooCommerce a saját tárhelyeden fut, a teljesítmény, a frissítések és a biztonság is a te felelősséged. Az alaprendszer REST API-jára a dokumentáció nem ír elő sebességkorlátot — a terhelést a szervernek kell bírnia, ezért a nagy szinkronokat kötegeljük és ütemezzük.

Tipikus megoldások

Amit leggyakrabban építünk

  1. 01

    Rendelés → számla → e-mail

    Az új rendelésből automatikusan számla lesz, a NAV-jelentést a számlázó szolgáltatás végzi, a vevő pedig e-mailben kapja meg a számlát.

  2. 02

    Raktár → webshopkészlet

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

  3. 03

    Webshop → futár

    A rendelésből csomag és címke lesz, a nyomkövetési szám pedig visszakerül a rendeléshez. Lásd: futárszolgálat-integráció.

  4. 04

    Webshop → CRM

    A vevők és a rendelések a MiniCRM-be vagy egy egyedi CRM-be kerülnek.

Buktatók

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

  1. 01

    Letiltott webhook

    5 sikertelen kézbesítés után a webhook kikapcsol, és amíg valaki vissza nem kapcsolja, a rendelések nem jutnak tovább. A webhookok állapotát ezért figyeljük, és hiba esetén riasztunk.

  2. 02

    Ne az adatbázisból olvass

    A 8.2-es verzió óta az új webshopok a rendeléseket saját, nagy teljesítményű táblákban tárolják (HPOS). A közvetlenül a WordPress-táblákból olvasó régi megoldások ilyenkor üres vagy elavult adatot látnak — mi mindig az API-t használjuk.

  3. 03

    Összegek és kerekítés

    Az API az összegeket két tizedesjegyű szövegként adja vissza, a forintos számla viszont kerekít. A kerekítést tudatosan kezeljük, hogy a számla és a rendelés végösszege egyezzen.

  4. 04

    Legacy REST API

    A WooCommerce 9.0 óta a régi Legacy REST API külön bővítmény; az erre épülő integrációk egy frissítés után elhallgathatnak.

Gyakori kérdések

Kell külön bővítmény a WooCommerce-integrációhoz?
A REST API és a webhookok a WooCommerce részei, külön bővítmény nem kell hozzájuk. A régi Legacy REST API-ra épülő megoldásokhoz viszont már külön bővítmény szükséges.
Mi történik, ha a fogadó rendszer elérhetetlen?
A WooCommerce számolja a sikertelen kézbesítéseket, és 5 egymást követő hiba után letiltja a webhookot. Ezért figyeljük a webhookok állapotát, és egyeztető lekérdezéssel pótoljuk a kimaradt rendeléseket.
Olvashatjuk az adatokat közvetlenül az adatbázisból?
Nem ajánljuk: a HPOS-t használó webshopokban a rendelések már nem a régi WordPress-táblákban vannak. Az API stabil, dokumentált felület, amely a frissítések után is működik.

WooCommerce-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