Ažurirano 13. 10. 2026. Pravi i održava KhaSoftware.
Šta pokriva ovaj vodič
Vodič opisuje kako se WooCommerce prodavnica povezuje sa BEX Express nalogom: koje podatke treba tražiti od BEX-a, kojim redom ide podešavanje i kako izgleda izbor dostave za kupca. Pisan je za vlasnike prodavnica, ali i za programere i agencije koji održavaju sajt.
Koraci su opisani na primeru plugina BEX plugin za WooCommerce. Pravi ga i održava KhaSoftware iz Beograda. To nije zvanični plugin BEX-a, već dodatak koji radi preko BEX API-ja, sa tvojim nalogom i tvojim ugovorom.
Šta ti treba od BEX-a
Plugin pravi pošiljke na tvom BEX nalogu, pa je prvi uslov ugovor sa BEX Express-om. Uz ugovor BEX daje podatke za pristup API-ju:
- API tokenDugačak niz znakova kojim se prodavnica predstavlja BEX-u. Čuva se kao lozinka.
- KlijentIDBroj klijenta za tvoju adresu preuzimanja, na primer UK14220. Po njemu BEX zna odakle kurir preuzima pakete.
- Tekući računRačun na koji BEX uplaćuje novac od pouzeća. Treba samo ako šalješ sa otkupninom.
Ako token i KlijentID nisu stigli uz ugovor, traže se od BEX-a na api@bex.rs. Cena dostave koju plaćaš BEX-u, rokovi i uslovi za otkupninu zavise od ugovora sa BEX-om, ne od plugina.
WordPress, WooCommerce i PHP
Preporučeno je WordPress 6.6 ili noviji, WooCommerce 8.2 ili noviji i PHP 7.4 ili noviji. Plugin podržava HPOS, novi način čuvanja porudžbina u WooCommerce-u, i klasičan checkout. Za blok checkout, sa predlozima adresa i izborom paketomata u blokovima, potreban je WooCommerce 10.3 ili noviji.
Jedan uslov je specifičan za BEX: server prodavnice mora da može da otvori vezu ka api.bex.rs na portu 62503. Većina hostinga to dozvoljava. Ako tvoj ne dozvoljava, plugin to javi već pri testu veze.
Povezivanje, korak po korak
Instalacija i licenca
ZIP fajl se otprema u WordPress adminu kroz Dodaci Dodaj novi Otpremi dodatak. Posle aktivacije sam se otvara čarobnjak u šest koraka: Licenca, Veza sa BEX-om, Pošiljalac, Dostava, Adresar i Probna pošiljka. Prvi korak traži licencni ključ koji počinje sa KHA-BEX i stiže mejlom posle kupovine. Ključ važi za jedan sajt.
Veza sa BEX-om
- Upiši API token i KlijentID, tačno onako kako stoje u mejlu od BEX-a.
- Klikni „Testiraj vezu“. Plugin proverava oba BEX servera, pa i ako podaci još nisu sačuvani.
- Kad stigne poruka „Veza radi“, proveri naziv i adresu koje je BEX prepoznao. To mora da bude tvoja firma i tvoja adresa preuzimanja.
Pošiljalac
Adresu preuzimanja plugin uzima iz BEX-a, na osnovu KlijentID-a, pa je ne prepisuješ. Dopisuješ kontakt osobu i telefon za kurira i tekući račun za otkupninu.
Načini dostave i zona
U koraku „Dostava“ plugin dodaje dva načina isporuke u zonu koja obuhvata Srbiju: „BEX Express dostava“ na adresu i „BEX Paket Shop / Paketomat“. Ako takve zone nema, napravi zonu „Srbija“. Za svaki način upisuješ cenu za kupca i iznos od kog je dostava besplatna. Cena je fiksna, a menja se kasnije u WooCommerce Podešavanja Dostava. U istom koraku biraš šta najčešće šalješ i uključuješ predloge adresa na checkout-u.
Adresar
Spisak mesta, ulica, paketomata i Paket Shop lokacija preuzima se u pozadini, za oko minut. Posle se sam osvežava svake noći.
Šta vidi kupac na checkout-u
- Za dostavu na adresu kupac počne da kuca grad i izabere ga iz predloga, pa isto uradi za ulicu. Poštanski broj se upisuje sam.
- Za Paket Shop ili paketomat kupac pretražuje lokacije po gradu, ulici ili nazivu, ili klikne „Najbliži meni“. Uz svaku lokaciju vidi radno vreme i link ka Google mapama.
- Ako adresa nije prepoznata, porudžbina ipak prolazi, a mesto i ulicu biraš u porudžbini pre slanja.
Izbor radi u klasičnom i u blok checkout-u, a izabrana lokacija ostaje zapisana u porudžbini i na strani „Hvala“.
Prva pošiljka
Poslednji korak čarobnjaka pokazuje šta je podešeno i nudi slanje jedne porudžbine koja čeka. BEX nema poseban test server, pa je to prava pošiljka. Najjednostavnije je napraviti porudžbinu na svoje ime i proveriti ceo tok: pošiljku, nalepnicu i prvi status. Ako je to bila samo proba, pošiljka se otkazuje iz porudžbine pre nego što je kurir preuzme.
Česte greške pri povezivanju
- „BEX je odbio pristup (HTTP 401)“
- API token ili KlijentID nisu ispravni. Najčešće je pri kopiranju uhvaćen višak znakova ili je uzet token iz starijeg mejla. Razmake iz tokena plugin briše sam, a KlijentID sme da ima samo slova, cifre, crticu i donju crtu.
- „Hosting blokira port 62503“
- BEX prima pošiljke na portu 62503, koji neki hostinzi zatvaraju. Uz poruku stoji dugme „Kopiraj“ sa gotovim tekstom za hosting: da dozvole odlazne veze ka api.bex.rs na portu 62503 i ka integrations.bexexpress.rs na portu 443.
- Greška u DNS-u ili SSL sertifikatu
- Problem je na serveru prodavnice, ne u podacima iz ugovora. Plugin piše šta tačno ne radi, a hosting to rešava.
- Na checkout-u nema opcije Paket Shop
- Lokacije još nisu preuzete. Pokreni preuzimanje adresara i sačekaj da se završi. Opcija se nudi samo za adrese u Srbiji.
- Čarobnjak ne pušta dalje od prvog koraka
- Licenca nije aktivna. Proveri da li je ključ prepisan ceo. Kad se prodavnica seli na drugu adresu, ključ se prvo deaktivira na staroj.
Sledeći korak
Ako su API token i KlijentID spremni, povezivanje traje desetak minuta i ne traži programera. Plugin se kupuje kao godišnja licenca za jedan sajt: Pro za 18.000 RSD donosi slanje jednim klikom, nalepnice, masovno slanje i štampu, praćenje i podršku mejlom i telefonom, a Business za 24.000 RSD uz to automatsko slanje, otkupnine i izveštaje, upozorenja i mesečni izveštaj na mejl, prioritetnu podršku u roku od 24 sata i sat tehničke podrške.
Uz ovaj vodič i detaljno uputstvo za kupce, sa slikom svakog ekrana, korak po korak, većina prodavnica sve poveže sama. Ako želiš da to uradimo mi, instalacija i podešavanje su 8.000 RSD paušalno, sa testiranjem i postavljanjem na pravi sajt. Ako ti plugin ne odgovara, povraćaj celog iznosa se traži u roku od 14 dana od kupovine.