Integracije kurira

Mozhe se integriše sa više kurirskih službi za automatsko kreiranje pošiljki, praćenje i štampanje nalepnica. Ovaj vodič pokriva dostupne integracije kurira i kako ih konfigurisati.

Dostupni kuriri

GLS

GLS je evropska paketna služba koja radi širom Srbije i regiona.

Karakteristike:

• Automatsko kreiranje pošiljki
• Praćenje paketa
• Štampanje nalepnica
• Ažuriranja statusa dostave
• Podrška za plaćanje pouzećem

Pokrivenost: Srbija, Evropska unija

BEX

BEX (ranije Box Express) je srpska kurirska služba specijalizovana za e-commerce dostave.

Karakteristike:

• Automatsko kreiranje pošiljki
• Praćenje paketa
• Štampanje nalepnica (A4 i A6 formati)
• Ažuriranja statusa dostave
• Podrška za pouzeće sa saldiranjem na bankovni račun
• Baza podataka opština i naselja

Pokrivenost: Srbija

DExpress

DExpress je srpska kurirska služba sa ekstenzivnom domaćom pokrivenošću i opcijama dostave u parcelboxove/parcelshopove.

Karakteristike:

• Automatsko kreiranje pošiljki
• Generisanje barkodova
• Sveobuhvatno praćenje statusa (40+ statusnih kodova)
• Webhooks za status dostave
• Podrška za pouzeće sa saldiranjem na bankovni račun
• Baza podataka gradova i opština
• Dostava u Parcelbox i Parcelshop

Pokrivenost: Srbija

Preduslovi

Pre konfigurisanja integracija kurira:

• Aktivan način dostave sa izabranim API kurirom
• Trgovački nalog kurira sa API pristupom
• API akreditivi od kurira
• Konfigurisana adresa preuzimanja u vašoj organizaciji

Konfiguracija GLS

Korak 1: Dobijte GLS akreditive

Kontaktirajte GLS da dobijete:

• Client ID: Vaš GLS broj kupca
• Username: API korisničko ime
• Password: API lozinka (može imati više za različite usluge)
• Identity Card Number: Potreban za verifikaciju pošiljaoca

Korak 2: Konfigurišite GLS u Mozhe

1. Idite na Podešavanja organizacije > Dostava
2. Kreirajte ili izmenite način dostave
3. Izaberite kao API provajdera

Korak 3: Adresa preuzimanja

Konfigurišite vašu lokaciju preuzimanja:

1. Idite na Podešavanja organizacije > Adrese
2. Dodajte ili verifikujte vašu adresu preuzimanja
3. Uverite se da poštanski broj odgovara GLS bazi podataka

Tok GLS pošiljke

1. Porudžbina pripremljena: Označite porudžbinu kao spremnu za slanje
2. Pošalji GLS-u: Mozhe poziva GLS PrepareLabels API
3. Dobij nalepnicu: Preuzmite i odštampajte nalepnicu za dostavu
4. Prati: Pratite status paketa preko GetParcelStatuses
5. Dostavljeno: GLS potvrđuje dostavu

GLS konfiguracija za pouzeće

Za porudžbine sa plaćanjem pouzećem:

• Iznos pouzećem se automatski izračunava iz ukupnog iznosa porudžbine
• GLS preuzima plaćanje od kupca
• Sredstva se deponuju na vaš konfigurisani bankovni račun
• Referenca uključuje broj porudžbine

GLS usluge

Dostupne opcije GLS usluga:

Konfiguracija BEX

Korak 1: Dobijte BEX akreditive

Kontaktirajte BEX da dobijete:

• Client ID: Vaš BEX broj kupca
• API Token: Token za autentifikaciju API zahteva

Korak 2: Konfigurišite BEX u Mozhe

1. Idite na Podešavanja organizacije > Dostava
2. Kreirajte ili izmenite način dostave
3. Izaberite BEX kao API provajdera
4. Unesite akreditive:

Korak 3: Sinhronizacija baze adresa

BEX koristi ID-jeve opština i naselja za adresiranje:

1. Mozhe automatski sinhronizuje BEX bazu adresa
2. Kupci biraju naselja iz padajućeg menija pri plaćanju
3. ID naselja se čuva uz porudžbinu

Tok BEX pošiljke

1. Porudžbina pripremljena: Označite porudžbinu kao spremnu za slanje
2. Pošalji BEX-u: Mozhe poziva BEX postShipments API
3. Dobij nalepnicu: Preuzmite nalepnicu za dostavu (preporučen A6 format)
4. Prati: Pratite status pošiljke
5. Dostavljeno: BEX potvrđuje dostavu

BEX konfiguracija za pouzeće

Za porudžbine sa plaćanjem pouzećem:

• Postavite payType na 6 (bankarski transfer)
• Konfigurišite bankovni račun u podešavanjima organizacije
• BEX preuzima plaćanje i prebacuje na vaš račun
• Format reference: "Porudzbina {broj_porudžbine}"

BEX struktura zadataka

BEX koristi zadatke za preuzimanje i dostavu:

Zadatak preuzimanja (Tip 1)

• Ime i adresa pošiljaoca
• Kontakt broj telefona
• Vremenski prozor preuzimanja

Zadatak dostave (Tip 2)

• Ime i adresa primaoca
• Kontakt broj telefona
• Podešavanja prethodnog obaveštenja (npr. 60 minuta pre)
• Napomene za dostavu

Štampanje BEX nalepnica

Dobijte nalepnice za štampanje:

pageSize: 6 (A6) ili 4 (A4)
pagePosition: 1-4 (pozicija na A4 listu)

A6 nalepnice su preporučene za termalne štampače.

Brisanje BEX pošiljki

Za otkazivanje pošiljke pre preuzimanja:

1. Idite na detalje porudžbine
2. Kliknite Otkaži pošiljku
3. BEX pošiljka se poništava
4. Status porudžbine se ažurira

Konfiguracija DExpress

Korak 1: Dobijte DExpress akreditive

Kontaktirajte DExpress da dobijete:

• Client ID: Vaš DExpress broj kupca
• Username: API korisničko ime
• Password: API lozinka
• Barcode Prefix: Vaš dodeljeni prefiks barkoda (npr. "MOZ")

Korak 2: Konfigurišite DExpress u Mozhe

1. Idite na Podešavanja organizacije > Dostava
2. Kreirajte ili izmenite način dostave
3. Izaberite kao API provajdera

Korak 3: Konfiguracija barkoda

DExpress zahteva unapred generisane barkodove:

• Format: {prefiks}{10-cifreni-brojač}
• Primer: MOZ0000000042
• Mozhe automatski upravlja brojačem

Tok DExpress pošiljke

1. Porudžbina pripremljena: Označite porudžbinu kao spremnu za slanje
2. Generiši barkod: Mozhe kreira jedinstveni kod za praćenje
3. Pošalji DExpress-u: Pozovi addshipment API
4. Prati: Prati preko statusnih webhooks
5. Dostavljeno: DExpress potvrđuje dostavu

DExpress konfiguracija za pouzeće

Za porudžbine sa plaćanjem pouzećem:

• Iznos konvertovan u "para" (pomnoži sa 100)
• Bankovni račun sačuvan u metapodacima porudžbine
• BuyOut iznos postavljen za naplatu od kupca
• BuyOutAccount za destinaciju saldiranja

DExpress statusni kodovi

DExpress pruža detaljno praćenje statusa:

Puna lista statusa uključuje 40+ kodova za detaljno praćenje.

DExpress webhooks

DExpress može slati ažuriranja statusa putem webhooks:

1. Konfigurišite webhook URL na DExpress trgovačkom portalu
2. Mozhe prima ažuriranja statusa automatski
3. Status porudžbine se ažurira u realnom vremenu

Webhook endpoint: /api/webhooks/dexpress

DExpress opcije dostave

Tipovi dostave:

• Regularna (DlTypeID: 2)
• Hitna (DlTypeID: 1)

Opcije plaćanja:

• Pošiljalac plaća (PaymentBy: 0)
• Primalac plaća (PaymentBy: 1)

Automatsko ažuriranje praćenja

Svi kuriri podržavaju automatsko praćenje:

Pozadinski poslovi

Mozhe pokreće zakazane poslove za:

1. Proveru statusa pošiljki na čekanju
2. Ažuriranje statusa porudžbine na osnovu statusa kurira
3. Slanje obaveštenja kupcima o promenama statusa

Mapiranje statusa

Statusi kurira se mapiraju na Mozhe statuse porudžbina:

Štampanje nalepnica

Termalni štampači

Za termalne štampače nalepnica:

1. Koristite A6 format (105mm x 148mm)
2. BEX: pageSize = 6
3. GLS: Standardni format nalepnice
4. DExpress: Generisana nalepnica sa barkodom

A4 štampači

Za standardne A4 štampače:

1. Koristite A4 format sa više pozicija
2. BEX: pageSize = 4, pagePosition = 1-4
3. Štampajte 4 nalepnice po listu

Tok štampanja

1. Idite na detalje porudžbine
2. Kliknite Štampaj nalepnicu
3. Nalepnica se preuzima kao PDF
4. Štampajte sa odgovarajućim podešavanjima štampača

Testiranje integracija

Test režim

Pre pokretanja uživo:

1. Koristite test akreditive koje pruža kurir
2. Kreirajte test pošiljke
3. Verifikujte generisanje nalepnica
4. Proverite praćenje statusa
5. Testirajte tok pouzećem (iznosi mogu biti nula u test režimu)

Validacija

Pre svake pošiljke:

• Verifikujte da su podaci adrese kompletni
• Proverite format broja telefona
• Uverite se da je poštanski broj validan
• Potvrdite ID-jeve naselja/gradova za BEX/DExpress

Rešavanje problema

GLS problemi

"PrepareLabelsError"

• Proverite adrese preuzimanja i dostave
• Verifikujte da poštanski kodovi postoje u GLS bazi
• Uverite se da su akreditivi klijenta tačni

"GetPrintDataError"

• Pošiljka možda ne postoji
• ID paketa može biti netačan
• Sačekajte da nalepnica bude spremna

BEX problemi

"reqstate: false"

• Proverite token za autentifikaciju
• Verifikujte format zahteva
• Pregledajte poruku greške u reqerr

"Opština/mesto nije pronađeno"

• Ažurirajte BEX bazu naselja
• Verifikujte da je kupac izabrao validno naselje
• Proverite mapiranje poštanskog koda

DExpress problemi

"ModelState errors"

• Proverite format broja telefona (381xxxxxxxxx)
• Verifikujte da su ID-jevi gradova validni
• Pregledajte limite dužine adrese

"Nedostaje prefiks barkoda"

• Konfigurišite prefiks barkoda u podešavanjima
• Kontaktirajte DExpress za dodelu prefiksa

Podešavanje webhooks

GLS webhooks

GLS koristi callback URL-ove:

1. Konfigurišite callback URL u zahtevu za pošiljku
2. GLS šalje POST na promene statusa
3. Endpoint: /api/webhooks/gls

BEX webhooks

BEX koristi email izveštaje:

1. Konfigurišite email adrese za izveštaje
2. Izveštaji se šalju za preuzimanje, dostavu, probleme
3. Ručna ažuriranja statusa mogu biti potrebna

DExpress webhooks

DExpress šalje POST zahteve:

1. Konfigurišite na DExpress trgovačkom portalu
2. Zahteva deljenu tajnu za verifikaciju
3. Endpoint: /api/webhooks/dexpress

Sledeći koraci

• Konfigurišite načine dostave sa integracijom kurira
• Omogućite plaćanje pouzećem za podršku pouzećem
• Podesite načine plaćanja za završetak plaćanja