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 jednom konfigurisanom prodavnicom
- 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
Korak 1 — Otvorite konfiguraciju prodavnice
- Prijavite se na Stogly Portal
- U bočnom meniju idite na Podešavanja → Podešavanja organizacije
- Kliknite na karticu Konfiguracija prodavnice
- Ako imate više prodavnica, izaberite ispravnu iz padajućeg menija na vrhu
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)
- Proširite odeljak API akreditivi i unesite:
- Client ID
- Client Secret
- Webhook Secret
- Venue ID - 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 i opcioni Cenovnik
- Unesite:
- Store ID
- API Token
- Webhook Token - Kliknite Sačuvaj
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 Podešavanja → Podešavanja organizacije → Konfiguracija prodavnice → Platforme za dostavu.
> Podešavanja dostave su po prodavnici i dele se na svim POS uređajima te prodavnice.
Cenovnici za platforme za dostavu
Wolt i Glovo obično zahtevaju drugačije cene od vašeg menija u prodavnici (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 Prodavnice i POS → Platforme za dostavu → Konfiguracija
- 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.
Rešavanje problema
Porudžbine se ne pojavljuju na POS-u
- Proverite da li je platforma Omogućena u Portalu → Platforme za dostavu → 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.