Ažurirano 13. 10. 2026. Pravi i održava KhaSoftware.
Šta pokriva ovaj vodič
Vodič pokazuje kako se WooCommerce prodavnica u Srbiji povezuje sa City Express nalogom: šta se traži od City Express-a, kako se biraju pošiljalac i načini isporuke i kako kupac bira paketomat ili parcel shop. Namenjen je vlasnicima prodavnica i agencijama koje im prave i održavaju sajt.
Koraci su prikazani na pluginu City Express plugin za WooCommerce. Njega pravi KhaSoftware iz Beograda i nije zvanični plugin City Express-a: radi preko njihovog API-ja, sa tvojim nalogom.
Šta ti treba od City Express-a
Za povezivanje treba ugovor sa City Express-om. Iz njega plugin koristi dve stvari:
- API ključJedan niz znakova kojim prodavnica pristupa tvom nalogu. Traži se od City Express-a, ako nije stigao uz ugovor.
- Pošiljaoci na naloguMagacini ili radnje odakle kurir preuzima pakete. Ne prepisuju se: plugin ih učita sa naloga kad proveri API ključ.
Ako šalješ iz više magacina, svi treba da budu upisani na nalogu kod City Express-a, pa se za svaku pošiljku bira odakle kurir preuzima. Cene dostave, rokovi i uslovi za otkupninu zavise od ugovora sa City Express-om. Da li postoji poseban test nalog, takođe se dogovara sa njima. Plugin nema odvojen test server.
Mapa paketomata na checkout-u traži i Google Maps API ključ, ali on nije obavezan: bez njega kupac bira tačku sa liste.
WordPress, WooCommerce i PHP
Potrebni su WordPress 6.4 ili noviji, WooCommerce 8.0 ili noviji i PHP od 7.4 do 8.3. Plugin radi sa oba načina čuvanja porudžbina (HPOS i klasičnim) i sa klasičnim i blok checkout-om.
Ko prelazi sa verzije 2.1, staru verziju ne briše: nova se otprema preko nje, a API ključ, pošiljalac, načini dostave i pošiljke ostaju. Ako je stara verzija u drugom folderu, prvo se deaktivira.
Povezivanje, korak po korak
Instalacija i licenca
Posle otpremanja ZIP fajla i aktivacije otvara se „prvo podešavanje“ u šest koraka: Licenca, API i pošiljalac, Pošiljke, Nalepnice, Načini isporuke i Probna pošiljka. U prvi korak ide licencni ključ iz mejla posle kupovine. I bez aktivne licence kupci naručuju normalno, a zaključano je samo slanje pošiljki.
API ključ i pošiljalac
- Upiši API ključ i klikni „Proveri vezu i učitaj spisak“.
- Poruka „Veza radi“ pokazuje i koliko pošiljalaca ima na nalogu.
- Izaberi pošiljaoca sa spiska. Njegova adresa ide na nalepnicu i na listu preuzimanja.
Pošiljke i nalepnice
Ovde se jednom određuje šta važi za svaku pošiljku: težina iz proizvoda ili uvek ista, obaveštenje primaocu, ko plaća dostavu i koje metode plaćanja su pouzeće. Formati nalepnica stižu sa City Express servera, pa biraš onaj koji odgovara tvom štampaču. Može i povratna nalepnica uz svaku pošiljku.
Načini isporuke
Jednim klikom se u zonu Srbija dodaju „City Express dostava na adresu“, „City Express paketomat“ i, po želji, „City Express parcel shop“, svaki sa svojom cenom. Kasnije, u WooCommerce Podešavanja Dostava, svaki način može da uzima cenu i rok isporuke sa City Express servera. Ako server tada ne odgovori, kupac vidi rezervnu fiksnu cenu i normalno poručuje.
Šta vidi kupac na checkout-u
- Uz svaki način isporuke kupac vidi cenu, a ako je uključeno, i rok isporuke.
- Za paketomat ili parcel shop otvara se lista tačaka u mestu kupca, sa pretragom po ulici ili nazivu i dugmetom „Najbliže meni“. Mapa se prikazuje samo uz Google Maps ključ.
- Uz svaku tačku piše da li prima pouzeće. Kad je izabrano plaćanje pouzećem, tačke koje ga ne primaju ne mogu da se izaberu.
Izbor tačke radi u klasičnom i u blok checkout-u.
Probna pošiljka
Poslednji korak pravi pošiljku ka adresi pošiljaoca i odmah je otkazuje, pa kurir ne dolazi. Tako se vidi da City Express prima podatke, pre prve prave porudžbine. Pravi se samo kad klikneš „Pošalji probnu pošiljku“. Ako otkazivanje iz nekog razloga ne prođe, plugin to napiše, a pošiljka se otkazuje preko City Express korisničkog servisa.
Statusi pošiljki stižu i bez dodatnog podešavanja: plugin ih proverava na 30, 60 ili 120 minuta. Za promene čim se dese postoji webhook. Plugin daje adresu i tajni token, ti ih šalješ City Express-u, a obaveštenja uživo se uključuju kad oni potvrde da je webhook podešen.
Česte greške pri povezivanju
- „City Express nije prihvatio API ključ“ ili „Greška 7000“
- Ključ je pogrešan ili nije aktivan. Najčešće nije kopiran ceo ili je uhvaćen razmak. Ako je ključ ispravan, a greška ostaje, ključ treba proveriti sa City Express-om.
- „Veza radi · 0 pošiljalaca na nalogu“
- Ključ radi, ali na nalogu nema upisanog pošiljaoca. City Express ga dodaje na nalog, a posle toga se spisak učitava ponovo.
- „Nema veze sa City Express serverom“
- Server prodavnice ne dobija odgovor. Pokušaj ponovo za par minuta. Ako traje, Dijagnostika pokazuje da li je problem u vezi ili na hostingu.
- „Adresa pošiljaoca nije dostupna“ u probnoj pošiljci
- Veza radi, ali nalog ne vraća adresu izabranog pošiljaoca. Adresu dopunjava City Express na tvom nalogu.
Sledeći korak
Uz API ključ povezivanje traje desetak minuta. Licenca važi godinu dana za jedan sajt. Pro (18.000 RSD) ima slanje jednim klikom, nalepnice, masovno slanje i štampu, praćenje i podršku mejlom i telefonom. Business (24.000 RSD) ima sve to, plus 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.
Ovaj vodič i detaljno uputstvo za instalaciju i povezivanje, koje stiže uz licencu, dovoljni su većini prodavnica. Instalaciju po želji preuzimamo mi, za 8.000 RSD paušalno, uz testiranje i postavljanje na pravi sajt. U roku od 14 dana od kupovine može da se traži povraćaj celog iznosa. Uputstvo za svakodnevni rad, sa zakazivanjem kurira i otkupninama, otvara se kupcima posle prijave.