📦 Instalacija Plugina

OBVEZNO: Instalirajte OBA plugina za pravilan rad!

1

Preuzimanje Plugina

Nakon kupovine, dobićete email sa:

Link za preuzimanje BEX WooCommerce plugina
Link za preuzimanje SR Address Lookup plugina
Licence key za aktivaciju

2

Upload i Aktivacija

Idite u WordPress Admin → Plugins → Add New → Upload Plugin

# Upload-ujte oba .zip fajla
# Aktivirate oba plugina
# Idite u WooCommerce → BEX License
# Unesite licence key

3

BEX Uslovi — Kako dobiti API pristup

Pre korišćenja plugina morate proći kroz zvanični BEX postupak:

1. Zaključivanje ugovora
Postojeći klijenti: Ukoliko imate zaključen ugovor sa BEX Express-om, možete preći na korak 2.
Novi klijenti: Za zaključivanje ugovora kontaktirajte: ponude@bex.rs

2. Zahtev za API pristup
Pošaljite zahtev za Authorization Token putem e-maila na adresu api@bex.rs.
Molimo vas da u poruci mejla precizirate ugovor na koji se zahtev odnosi.

3. Dobijanje API ključa
Nakon provere ugovora, dobićete jedinstveni API ključ putem e-maila.
Sačuvajte ga bezbedno! Koristićete ga u pluginu kao X-Auth-Token.

U mailu ćete dobiti i:
• API ključ — jedinstveni token za autentifikaciju
• KlijentID (ClientID) — vaš identifikator u sistemu (koristi se za lokacije preuzimanja)

4. CSV fajlovi sa adresama
Potrebni su CSV fajlovi: Municipalities.csv, Places.csv, Streets.csv
(Generišu se automatski preko SR Address Lookup plugina)

⚙️ Konfiguracija

1

API Settings

WooCommerce → BEX Pickup → API Settings

X-Auth-Token: [uneti API ključ dobijen od BEX-a]
Endpoint: https://integrations.bexexpress.rs/api/

Gde naći API ključ?
API ključ dobijate putem e-maila nakon što pošaljete zahtev na api@bex.rs.
To je jedinstveni token koji se koristi za autentifikaciju u svim API zahtevima.

2

Lokacije Preuzimanja (KlijentID)

Dodajte sve lokacije sa tačnim KlijentID vrednostima

Šta je KlijentID (ClientID)?
KlijentID je vaš jedinstveni identifikator u BEX sistemu.
Dobićete ga u istom e-mailu sa API ključem.

KlijentID predstavlja adresu sa koje kuriri preuzimaju pošiljku za slanje.
Možete imati više lokacija (npr. glavna lokacija, skladište, itd.).

Primer konfiguracije:
Ime: Glavna Lokacija
KlijentID: [vaš ClientID iz e-maila]
Telefon: [obavezno]
Vreme: 08:00–16:00
Default: ✓ (označite jednu kao podrazumevanu)

3

Generisanje CSV Baza Adresa (OBVEZNO!)

Idite u SR Address Lookup plugin i generišite CSV fajlove automatski:

Automatsko generisanje preko BEX API-ja:
1. Idite u WordPress Admin → SR Address Lookup → Settings
2. Unesite isti BEX API ključ koji ste koristili u BEX WooCommerce pluginu
3. Kliknite dugme "Ažuriraj podatke sa BEX API-ja"
4. Plugin automatski kreira/ ažurira sva tri CSV fajla:
  • Municipalities.csv
  • Places.csv
  • Streets.csv

⚠️ NE PRESKOČITE OVO!
CSV baze su obavezne za validaciju adresa i sprečavaju greške u adresama (adressType 2 i 3).
Nema potrebe za ručnim upload-om — sve se generiše automatski preko BEX API-ja!

4

Mapiranje Plaćanja

Podesite payment metode prema BEX specifikacijama:

COD (Pouzeće) → payType=2
Kartica → payType=6
Uplatnica → payType=1
Račun za otkup: [vaš broj računa]

🚀 Korišćenje

Kreiranje Pošiljke

1

Idite u WooCommerce → Orders → Odaberite order

2

U desnom sidebar-u popunite BEX metabox:

Odaberite lokaciju preuzimanja
Proverite vreme
Odaberite tip, kategoriju, sadržaj
Dodajte komentare ako treba

3

Kliknite "Kreiraj pošiljku"

Status: ✅ Created - Uspešno kreirano
Status: ⚠️ Error - Došlo je do greške
Status: ⏳ Reserved - Adresa nije tačna

Kako izgleda u WooCommerce porudžbini

Štampanje Nalepnica

Nakon kreiranja, birajte poziciju na A4 formatu:
🖨️ Gore levo | 🖨️ Gore desno
🖨️ Dole levo | 🖨️ Dole desno

🔧 Rešavanje Problema

⚠️ Najčešći Problemi

Problem: "API token not configured" ili "API token nije konfigurisan"

Rešenje:
1. Proverite WooCommerce → BEX Pickup → API Settings
2. Unesite API ključ koji ste dobili od BEX-a putem e-maila
3. Ako nemate API ključ, pošaljite zahtev na api@bex.rs
4. Proverite da li imate zaključen ugovor sa BEX Expressom

Problem: "Label generation failed"

Rešenje: Proverite da li je adresa tačna (koristite SR Address Lookup)

Problem: Pošiljka se ne kreira

Rešenje: Proverite status ugovora kod BEX-a

📋 VAŽNA NAPOMENA

Ako adresa nije tačna, pošiljka se REZERVIŠE ali ne kreira!

Morate čekati ručnu proveru od strane BEX supporta.

📸 Screenshots

Pogledajte kako plugin izgleda u praksi. Kliknite na bilo koju sliku da je vidite u punoj veličini:

BEX Pickup — Podešavanja 1

BEX Pickup — Podešavanja 2

BEX Shipments

BEX License

SR Address Lookup

Praćenje pošiljki

🎥 Video Uputstvo

Pogledajte kako plugin funkcioniše u praksi:

Šta ćete videti u videu:

Kako instalirati i konfigurisati plugin
Kako kreirati pošiljku iz WooCommerce porudžbine
Kako generisati i štampati nalepnice
Kako koristiti SR Address Lookup za validaciju adresa
Kako pratiti status pošiljki

📞 Kontakt Support

🇷🇸 BEX Support

Za BEX specifične probleme

Email: api@bex.rs
Telefon: [BEX support telefon]

🛠️ Plugin Support

Za tehničke probleme sa pluginom

Email: support@vasafirma.rs
Website: vasafirma.rs

📧 Hitni Slučajevi

Za hitne problemske adrese

Email: podrska@bex.rs
Response: 24-48h