Posta Srbije WP Platinum Konektor

WordPress/WooCommerce plugin koji:

• mapira WooCommerce shipping adresu u format Poste Srbije
• koristi GetNaselje i GetUlica za predloge grada i ulice na checkout-u
• pametno razresava latinicu, cirilicu i osnovne tipfelere preko vise Poštinih upita
• validira adresu preko ProveraDostupnostiUsluge
• racuna postarinu preko PostarinaPosiljke
• salje B2BManifest zahtev rucno ili automatski da se porudzbina pojavi u EPK/B2B aplikaciji
• salje kupcu email sa tracking brojem i linkom za pracenje posiljke posle uspesnog submit-a
• po zelji generise PDF adresnicu za stampu i salje je na zadati email posle uspesnog submit-a
• vodi prijemnu knjigu za uspesno poslate porudzbine i na zahtev izvozi PDF tabelu za kurira
• automatski salje dnevnu knjigu porudzbina u PDF-u za magacin, za period 01:00-01:00
• proverava i adresu posiljaoca / mesta preuzimanja pre slanja
• razlikuje gresku neresene adrese od slucaja kada je adresa razresena, ali izabrana Postina usluga nije dostupna na toj adresi
• cuva odgovor, manifest ID, tracking broj i debug artefakte u order meta

Trenutna logika

1. Podrazumevani tok je rucno slanje iz settings strane, order akcije ili sa samog ordera kada ste spremni da posaljete posiljku Posti.
2. Automatsko slanje je opciono i ukljucuje se preko settings toggle-a. Tada plugin pokusava slanje kada order udje u izabrani status (processing i/ili completed).
3. Checkout ne blokira porudzbinu. Adresa kupca se meko razresava pri kreiranju ordera i, ako je moguce, normalizuje se u pozadini.
4. Pre slanja se proveravaju adresa primaoca, adresa vase firme / posiljaoca i mesto preuzimanja.
5. Ako je adresa prepoznata, dopunjavaju se tehnicka polja koja vraca Posta (IdNaselje, IdUlica, Pak, korekcija poste).
6. Ako je adresa razresena, ali izabrana usluga nije definisana na toj adresi, order dobija jasnu gresku sa listom B2B rukovanja koja prolaze proveru za istu adresu.
7. Racuna se postarina i njen iznos se ubacuje u manifest.
8. Salje se B2BManifest i rezultat se cuva u order meta.
9. Ako je Posta vratila tracking broj, kupcu se salje email na billing email adresu sa linkom za pracenje posiljke.
10. Porudzbina se upisuje u prijemnu knjigu i ceka prvi sledeci izvoz.
11. Dnevna knjiga porudzbina se automatski pravi u 01:00 za prethodni zavrseni period 01:00-01:00, nezavisno od toga da li su porudzbine vec poslate Posti.

Checkout predlozi

• Na checkout-u plugin dodaje bubble predloge za drzavu i okrug bez Woo dropdown-a.
• Checkout polja za adresu se slazu tako da grad ide pre ulice, uz kratku poruku da kupac prvo izabere grad.
• Grad dobija AJAX predloge preko GetNaselje.
• Ulica dobija AJAX predloge preko GetUlica kada je grad izabran.
• Podrzani su latinicni i cirilicni unosi, kao i osnovni tipfeleri kroz fuzzy rangiranje.
• Porudzbina se ne blokira ako adresa nije automatski razresena; order se oznacava za proveru pre slanja u EPK.
• Ako checkout uspe da razresi adresu, ali ne i da potvrdi dostupnost podrazumevane usluge, normalizovana adresa se i dalje cuva, a problem sa uslugom se proverava tek pri slanju ordera.

Podesavanja

U adminu idite na:

WooCommerce > Posta Srbije WP Platinum Konektor

Bitna polja:

• Ukljuci plugin
• Omoguci automatsko slanje
• Generisi PDF adresnicu i salji na email
• Automatska knjiga porudzbina
• Email za stampu adresnice
• WSP username
• WSP password
• ExtBrend
• ExtMagacin
• IdRukovanje
• NacinPlacanja
• podaci vase firme / posiljaoca
• zasebno Mesto preuzimanja ako kurir ne preuzima sa iste adrese
• COD racun i sifra placanja ako koristite pouzece

Rucno slanje

• Na vrhu stranice WooCommerce > Posta Srbije WP Platinum Konektor postoji forma za rucno slanje ordera po WooCommerce Order ID.
• Order moze da se posalje odmah kao ranije ili da se doda u buffer za stampu.
• Buffer prima najvise 4 ordera. Kada je pun, prvo posaljite buffer na stampu pre dodavanja novih ordera.
• Buffer moze da se posalje i kada ima 2 ili 3 ordera; ne mora da se ceka da se napune sva 4 mesta.
• Batch slanje prvo salje order(e) u Posta EPK, zatim generise jedan A4 PDF sa do 4 adresnice i salje ga na email za stampu.
• Batch slanje pravi kratku pauzu izmedju ordera i jednom ponavlja order koji dobije privremenu HTTP/API gresku.
• Na samom orderu postoji i dugme Posalji ovaj order u Postu.
• Posle uspesnog slanja i dobijanja tracking broja kupac dobija email na jeziku sajta. Email sadrzi tracking broj, link https://www.posta.rs/cir/alati/pracenje-posiljke.aspx, naziv firme, adresu sajta i kontakt telefon ako je unet u podesavanjima posiljaoca.
• Ako je ukljucena opcija za adresnicu, posle uspesnog slanja plugin pravi PDF i salje ga kao attachment na email za stampu.

Prijemna knjiga

• Na stranici WooCommerce > Posta Srbije WP Platinum Konektor postoji blok Prijemna knjiga.
• Svaka porudzbina koja je uspesno poslata Posti i ima tracking broj dobija red u prijemnoj knjizi.
• Izvoz obuhvata samo porudzbine koje jos nisu izvezene kroz prijemnu knjigu.
• Porudzbine se pri izvozu dele u posebne prijemne knjige po kombinaciji: da li imaju otkup, da li je kupcu naplacena postarina u WooCommerce porudzbini i koji je Postin NacinPlacanja za postarinu (POF, POG, PRF, PRG, TL).
• Ako jedan izvoz sadrzi vise tipova naplate, plugin pravi vise PDF fajlova i salje ih kao odvojene priloge u istom emailu.
• Svaki PDF se pravi u A4 landscape formatu sa kolonama iz primera: redni broj, prijemni broj, primalac, adresa/PAK, postanski broj i mesto, kontakt, vrednost, otkupnina, masa, sadrzaj, postarina i napomena.
• Zaglavlje prijemne knjige prikazuje B2B, naziv i adresu posiljaoca, uslugu, nacin placanja postarine i datume formiranja/slanja/stampe.
• PDF prijemne knjige salju se na isti email koji se koristi za PDF adresnice.
• Porudzbine se oznacavaju kao izvezene tek kada je email sa PDF prijemnom knjigom uspesno poslat.

Knjiga porudzbina

• Na stranici WooCommerce > Posta Srbije WP Platinum Konektor postoji blok Knjiga porudzbina.
• Automatski izvoz se pokrece WP-Cron dogadjajem svakog dana u 01:00 i obuhvata porudzbine kreirane od 01:00 prethodnog dana do 01:00 tekuceg dana.
• Rucni izvoz pokrece isti zavrseni period 01:00-01:00 i salje PDF na isti email koji se koristi za adresnice.
• PDF koristi Platinum Zenith logo iz assets/platinum-zenith-logo.jpg.
• Tabela sadrzi spojenu kolonu za redni broj i broj porudzbine, datum, nacin placanja, spojenu kolonu za primaoca/email/telefon, adresu kroz vise redova, artikle sa zasebnim unutrasnjim celijama za naziv/kolicinu/cenu, postarinu i ukupno za porudzbinu.
• Automatski izvoz ne salje prazan PDF ako u periodu nema porudzbina; period se evidentira kao obradjen da se ne pokrece duplo.

Order meta

Plugin upisuje:

• _posta_epk_status
• _posta_epk_tracking_number
• _posta_epk_manifest_id
• _posta_epk_partner_id
• _posta_epk_error
• _posta_epk_synced_at
• _posta_epk_debug_log_path
• _posta_epk_last_api_debug_files
• _posta_epk_last_manifest_payload
• _posta_epk_last_manifest_response
• _posta_epk_last_error_payload
• _posta_epk_customer_tracking_email_status
• _posta_epk_customer_tracking_email_recipient
• _posta_epk_customer_tracking_email_tracking_number
• _posta_epk_customer_tracking_email_sent_at
• _posta_epk_customer_tracking_email_error
• _posta_epk_manifest_book_entry
• _posta_epk_manifest_book_added_at
• _posta_epk_manifest_book_status
• _posta_epk_manifest_book_exported_at
• _posta_epk_manifest_book_exported_tracking_number
• _posta_epk_manifest_book_export_id
• _posta_epk_manifest_book_group_key
• _posta_epk_manifest_book_group_label
• _posta_epk_manifest_book_pdf_path
• _posta_epk_manifest_book_pdf_url
• _posta_epk_manifest_book_email_status
• _posta_epk_manifest_book_email_recipient
• _posta_epk_manifest_book_email_error
• _posta_epk_order_book_status
• _posta_epk_order_book_exported_at
• _posta_epk_order_book_export_id
• _posta_epk_order_book_range_key
• _posta_epk_order_book_range_label
• _posta_epk_order_book_pdf_path
• _posta_epk_order_book_pdf_url
• _posta_epk_order_book_email_status
• _posta_epk_order_book_email_recipient
• _posta_epk_order_book_email_error

Napomene

• Podrazumevano je ukljucen format za domaci saobracaj.
• Ako tezina proizvoda ne postoji, koristi se podrazumevana masa iz settings stranice.
• Za COD se trenutno automatski koristi Woo payment method cod.
• Ako Posta zahteva dodatna polja koja su specijalna za vas nalog, payload builder treba prosiriti u includes/class-posta-epk-order-sync.php.
• Debug tekst logovi i JSON artefakti se cuvaju u wp-content/uploads/posta-epk-logs/.
• PDF prijemne knjige se cuva u wp-content/uploads/posta-epk-manifest-books/.
• PDF knjige porudzbina se cuva u wp-content/uploads/posta-epk-order-books/.
• TipAdrese za Poštin API se sada salje po ulozi: 0 za mesto preuzimanja, 1 za posiljaoca i 2 za primaoca.