Kapsamlar ve restoran bağları
Bir anahtar bütün Cloud paneline açılmaz. Süper admin hangi işleri ve hangi restoranları paylaşacağını tek tek işaretler.
sales_inbound şarttır. Stok düşümü ve kasa kaydı ayrıca stock / accounting (veya cash) ister. Nasıl gönderilir: Satış kapanınca.Kapsamlar
| Kapsam | Yön | Ne açar |
|---|---|---|
| products | Okuma | GET …/products ve …/categories. id, plu, priceAmount ve diğer alanlar ürün sayfasında. |
| products_inbound | Yazma | POST /hooks/product-upsert — kendi menünüzü Cloud’a yazma. |
| stock | Okuma + satışta yazma | GET …/stock. Satışta depodan çıkış satırı. |
| cash | Okuma + yazma | GET …/cash, …/z-reports, …/cash-shifts. Satışta ödeme türüne göre kasa. POST z-report-created, cash-in, cash-out, cash-shift-closed. |
| accounting | Okuma + yazma | GET …/accounting. Satışta POS_SALE. POST expense-created; cash-in / cash-out da bu kapsamla yazılır. |
| personnel | Okuma | GET …/personnel. PIN, IBAN, telefon, e-posta dönmez. |
| sales_inbound | Yazma | POST /hooks/sale-created. Fişsiz bu uç 403 döner. |
| webhooks | Restroid → siz | Panelde webhook da açık olmalı. Satış göndermez. |
accounting veya cash açıksa satışta her ödeme kendi hesabına yazılır. İkisi de kapalıysa fiş yine Siparişler’e düşer; kasa satırı oluşmaz.
Restoran bağları
Bağlanmayan restoran için 403 dönersiniz: «Bu restoran bu entegrasyona bağlı değil.» «Tüm restoranlar» diye bir varsayılan yoktur. Yeni işletme eklendiğinde süper admin onu ayrıca işaretlemelidir. Satış gövdesindeki restaurantId, GET /restaurants yanıtındaki id’dir.
Tipik senaryo
Restoran menüyü Cloud’da tutuyorsa siz GET /products ile alırsınız (her alanın anlamı o sayfada). Kendi menünüz master ise products_inbound ile product-upsert atarsınız. Kasiyer sizin ekranınızda satışı kapatır; backend fişi POST eder. İptal sale-cancelled iledir. Çekmece, öğle vardiya, gider ve gün sonu Z: Z raporu ve kasa.