Ha 32 férőhelyes specialty kávézót üzemeltet Brooklynban Square Terminallal és thMenu QR-menüvel, az árszinkronizáció operatív rémálommá válhat. A barista átírja a latte árát 5,50-ről 5,75 USD-re, de a QR-menü még a régit mutatja. Ez a cikk egy hibrid architektúrát ír le: webhook elöl, polling biztonsági hálóként.
Webhook mint fő csatorna
A Square catalog.version.updated esemény bármely item, variation vagy modifier változásakor elsül. Irányítsd a thMenu Worker /api/integrations/square/webhook végpontjára: ellenőrizd a HMAC-SHA256 aláírást, olvasd ki az object_id-t, majd hívd a /v2/catalog/object/{id}-t.
A Worker D1_MENU sémába mappolja: variations[0].price_money.amount centben (575) → products.price = 5,75 USD. A square_object_id oszlop teszi lehetővé az upsertet. A Square SLA 15 percen belül 99,2 %-ot szállít.
Polling és rate limit
Hálózati kimaradás vagy ritka Square-késés (5+ perc) esetén egy 30 perces cron kérdez le /v2/catalog/search-t az utolsó 35 perc szűrővel.
A Square rate limit 10 kérés/másodperc. 500 tételhez 100 per batch_retrieve majd 1 másodperc szünet.
Adómapping: US vs HU
Brooklyn 8,875 % NY sales tax-et számol; budapesti egység 5 % ÁFA-t (étkezés) vagy 27 %-ot. Adj hozzá tax_us_pct és tax_hu_pct oszlopokat.
GYIK
Mi van, ha a webhook elbukik?A polling 30 percen belül kiegyenlít.
Készletet is szinkronizál?Nem, csak katalógust.
Melyik csomag?Pro és Platinum.
Hasznosnak találtad? Oszd meg.
Kapcsolódó cikkek
Mi az a QR-menü? Teljes útmutató éttermek számára
A QR-menü lehetővé teszi, hogy vendégei okostelefonjukon azonnal elérjék az étla…
Papír étlapról digitális QR-menüre váltani: lépésről lépésre útmutató
QR-menüt szeretne bevezetni, de nem tudja, hol kezdje? Ez az útmutató lefedi a f…
Geocélzott QR-étlapok: különböző nyelvek a látogató IP-je alapján
Hogyan irányítja egy 180 férőhelyes all-inclusive üdülő Antalyában ugyanazt a QR…