Podešavanje platformi za dostavu (Wolt i Glovo)
Povežite Stogly sa Wolt i Glovo platformama kako bi porudžbine stizale direktno na POS.
Povežite Stogly sa Wolt i Glovo platformama kako bi porudžbine za dostavu direktno stizale na vaš POS — bez ručnog unosa i prebacivanja između aplikacija.
Pregled
Stogly integracija dostave vam omogućava da:
- Primate Wolt i Glovo porudžbine direktno na POS terminalu
- Prihvatate, odbijate ili označavate porudžbine kao gotove jednim dodirom
- Automatski obaveštavate platformu o promenama statusa porudžbine
- Primenite poseban cenovnik po platformi za dostavu
- Pregledate celu istoriju porudžbina i upravljate konfiguracijom iz Portala
Kako funkcioniše
Stogly koristi arhitekturu portal releja:
`
Wolt / Glovo
│
▼ webhook (platforma → Portal)
Stogly Portal (cl-api)
│ čuva porudžbinu u bazi podataka
│ emituje putem Realtime-a
│
▼ POS proverava svakih 30 sekundi
POS terminal
│ osoblje prihvata / odbija
▼
Stogly Portal → Wolt / Glovo API (ažuriranje statusa)
`
Ovo znači da vaš POS funkcioniše čak i tokom kratkih prekida interneta — porudžbine se čuvaju u Portalu i preuzimaju na sledećem ciklusu provere.
Preduslovi
Pre podešavanja platformi za dostavu potrebno vam je:
- Stogly Portal nalog sa barem jednim konfigurisanim objektom
- Wolt Partner nalog ili Glovo Partner nalog — prijavite se putem odgovarajućih partner portala
- Admin pristup vašoj Stogly organizaciji
- API akreditivi od svake platforme (pogledajte dole gde ih naći)
Dobijanje akreditiva od Wolta
Wolt koristi OAuth2 za autentifikaciju POS-a. Potrebno vam je:
| Akreditiv | Gde ga naći |
|---|---|
| Client ID | Wolt Partner Portal → Integrations → POS Integration |
| Client Secret | Wolt Partner Portal → Integrations → POS Integration |
| Webhook Secret | Generiše se kada registrujete URL vašeg webhookа u Wolt Partner Portalu |
| Venue ID | Wolt Partner Portal → stranica podešavanja vašeg lokala |
> URL webhookа koji treba registrovati u Wolt Partner Portalu:
> https://vaš-portal-domen/api/delivery/webhooks/wolt
Wolt tokeni ističu posle 1 sata. Stogly ih automatski obnavlja u pozadini — ne morate ništa raditi posle inicijalnog podešavanja.
Dobijanje akreditiva od Glova
Glovo koristi statički API token za autentifikaciju POS-a. Potrebno vam je:
| Akreditiv | Gde ga naći |
|---|---|
| Store ID | Glovo Partner Portal → podešavanja vaše prodavnice (format: naziv_partnera__id_prodavnice) |
| API Token | Glovo Partner Portal → Integrations → API Access |
| Webhook Token | Vi ga postavljate pri registraciji webhookа — koristite jaku nasumičnu nisku |
> URL webhookа koji treba registrovati u Glovo Partner Portalu:
> https://vaš-portal-domen/api/delivery/webhooks/glovo
> Napomena: Glovo ne podržava odbijanje porudžbina sa POS strane. Ako odbijete porudžbinu u Stogly-u, menja se samo lokalni status — morate je otkazati i u Glovo Partner Portalu ako je potrebno.
Konfiguracija platformi za dostavu u Portalu
Wolt i Glovo se konfigurišu po objektu. Svaki objekat ima sopstveni prekidač za omogućavanje, ID objekta/prodavnice na platformi, interval provere, cenovnik, podešavanje automatskog prihvatanja i akreditive.
Korak 1 — Otvorite konfiguraciju dostave
- Prijavite se na Stogly Portal
- U bočnom meniju idite na Objekti i POS → Dostava
- Ako imate više objekata, izaberite objekat u izborniku u gornjem desnom uglu stranice
- Otvorite karticu Konfiguracija
Promenom objekta prikazuju se podešavanja tog objekta — ponovite korake u nastavku za svaki objekat koji prima porudžbine za dostavu.
Korak 2 — Konfigurišite Wolt
- Na kartici Wolt uključite prekidač Omogućeno
- Podesite Interval provere (podrazumevano: 30 sekundi — koliko često POS proverava nove porudžbine)
- Izaberite Cenovnik ako Wolt porudžbine treba da koriste drugačije cene od vašeg podrazumevanog menija (opciono)
- Uključite Automatsko prihvatanje narudžbi ako to želite za ovaj objekat (opciono)
- Unesite Wolt Venue ID — obavezan je da bi platforma mogla da se omogući
- U odeljku API akreditivi unesite:
- Client ID
- Client Secret
- Webhook Secret - Kliknite Sačuvaj
> Akreditivi su šifrovani AES-256-GCM algoritmom i bezbedno čuvani. Neće biti prikazani ponovo posle čuvanja — polja će prikazivati (nepromenjeno) pri sledećem učitavanju.
Korak 3 — Konfigurišite Glovo
- Na kartici Glovo uključite prekidač Omogućeno
- Podesite Interval provere, opcioni Cenovnik i Automatsko prihvatanje narudžbi
- Unesite Glovo Store ID — obavezan je da bi platforma mogla da se omogući
- U odeljku API akreditivi unesite:
- API Token
- Webhook Token - Kliknite Sačuvaj
Isključivanje platforme za objekat
Dugme Sačuvaj je uvek dostupno na kartici svake platforme. Da biste isključili platformu za objekat, isključite prekidač Omogućeno i kliknite Sačuvaj.
Porudžbine prikazane za objekat
Kartica Narudžbe prati isti izbor objekta. Porudžbine koje se šalju kurirskom službom prikazuju se za objekat upisan na porudžbini, zajedno sa porudžbinama koje još nemaju objekat.
Korak 4 — Proverite vezu
Posle čuvanja, POS će početi automatski da proverava porudžbine na sledećem ciklusu sinhronizacije. Za testiranje:
- Postavite test porudžbinu na vašem Wolt ili Glovo lokalu (koristite sandbox/test okruženje platforme ako je dostupno)
- Otvorite POS terminal i idite na Dostava u bočnom meniju
- Porudžbina bi trebalo da se pojavi unutar 30 sekundi
Pregled podešavanja dostave na POS-u
POS prikazuje konfiguraciju dostave sinhronizovanu sa Portala u Podešavanjima → Dostava. Ovaj pregled je samo za čitanje — sve izmene moraju biti napravljene u Portalu pod Objekti i POS → Dostava → Konfiguracija.
> Podešavanja dostave su po objektu i dele se na svim POS uređajima tog objekta.
Cenovnici za platforme za dostavu
Wolt i Glovo obično zahtevaju drugačije cene od vašeg menija u objektu (zbog naknada platforme). Stogly vam omogućava da dodelite poseban cenovnik svakoj platformi:
- Idite na Prodaja → Cenovnici i kreirajte cenovnik (npr. "Wolt cene")
- Podesite cene za proizvode koje prodajete putem te platforme
- Vratite se na Objekti i POS → Dostava → Konfiguracija i izaberite objekat
- Izaberite cenovnik u padajućem meniju Cenovnik za tu platformu
- Sačuvajte
Sve porudžbine primljene od te platforme koristiće dodeljeni cenovnik za prikaz i fiskalnu obradu.
Da biste prestali da koristite poseban cenovnik, izaberite Podrazumevano (bez promene) i kliknite Sačuvaj — time se briše prethodno izabrani cenovnik.
Rešavanje problema
Porudžbine se ne pojavljuju na POS-u
- Proverite da li je platforma Omogućena za odgovarajući objekat u Objekti i POS → Dostava → Konfiguracija
- Proverite da li je POS online (indikator veze u gornjoj traci)
- Potvrdite da je URL webhookа ispravno registrovan na partner portalu platforme
- Proverite Interval provere — porudžbine se pojavljuju u okviru tog broja sekundi od prispeća
Greška "Prihvatanje porudžbine nije uspelo"
- POS je pokušao da pošalje status na API platforme, ali je primio grešku
- Lokalni status porudžbine je ipak ažuriran — proverite listu porudžbina u Portalu za detalje
- Proverite da li su vaši API akreditivi još uvek važeći na partner portalu platforme
Wolt porudžbine su zaglavile kao na čekanju
- Wolt OAuth tokeni su možda istekli — ovo se automatski oporavlja na sledećem ciklusu provere
- Ako problem potraje, ponovo sačuvajte Wolt akreditive u konfiguraciji Portala
Glovo porudžbine ne mogu biti odbijene
Ovo je ograničenje Glovo platforme. Stogly označava porudžbinu kao odbijenu lokalno, ali morate je otkazati i u Glovo Partner Portalu da biste obavestili kupca i kurira.