Omniva pakiandmete edastamine liidese kaudu

Omniva liidestamine võimaldab saata pakiandmed otse Directost nende süsteemi ja trükkida pakikaardid Directost.

Vajadus tekib eelkõige firmadel, kelle tellimused vormistatakse veebipoes, kus klient teeb kättetoimetamise valiku ja tellimused postitatakse üle liidese Directosse ning kauba noppimine ja arveks tegemine käib Directos.

Pakiandmete edastamine käib aruandest 'Arvete nimekiri', pakikaart on spetsiaalne arve või aruande väljatrükk, mida saab trükkida ühekaupa arve enda pealt või siis massiga aruandest 'Arvete nimekiri'.

Süsteemiseadistustes tuleb täita piltidel toodud väljad.
'Omniva XML: iseteeninduse kasutajanimi' on teie kasutajanimi Omniva iseteenindusse sisselogimisel. See võib ühtida teie kliendikoodiga Omnivas.
'Omniva XML: ID' on kliendikood Omnivas. See võib ühtida eelmisega. 'Omniva XML: paki ribakoodi prefiks' on unikaalne prefiks pakiandmete saatmisel Omniva keskkonda. Sellele väljale tuleb sisestada 10 tähemärki. Kõigepealt JJEE ja seejärel kuni 6 kohta teie kliendikood. Kui see on lühem kui 6 tähemärki, siis lisada ette nulle. Nt kui kliendikood on 14875, siis sellele väljale sisestada JJEE014875.
'Omniva XML: iseteeninduse parool' on parool iseteenindusse sisselogimisel.
URL väljale sisestada: https://edixml.post.ee/epmx/services/messagesService
NB! UUS OMX keskkond:LIVE: https://omx.omniva.eu/api/v01/omx/shipments/business-to-client ning koos sellega muutuvad Omniva XML: iseteeninduse kasutajanimi ja Omniva XML: iseteeninduse parool mis saate Omniva käest!
'Omniva XML: saatja aadress' väljale sisestada pakkide üleandmise aadress.

Tellimuse/arve lisaväli, millel on Omniva pakiautomaadi number.
NB! Kui kasutusel on ka Smartpost, siis on kasutusel sama lisaväli.

Arve lisaväli, millele tekib paki jälgimiskood ehk paki ribakood.

Oluline on ka seadistus, mis määrab, kas klient peab paki kättesaamisel paki eest tasuma. Selleks on süsteemiseadistus:

Selle väärtus saab olla EI või JAH.
EI - sel juhul lunasummat ei ole. St klient on paki eest juba ette tasunud või klient võib tasuda hiljem ülekandega.
JAH - sel juhul saadetakse Omniva süsteemi lunasummaks arve Saldo ja klient peab paki kättesaamisel selle summa automaati või kullerile tasuma. See on spetsiaalne Omniva teenus, mis tuleb aktiveerida ja millel on erihind.
Teenus on kohustuslik saaja IBAN. IBAN leitakse kas OBJEKTI LISAINFO väljalt või seadistustest Firma pangakonto/IBAN„ Selle teenuse soovil tuleb kindlasti ühenduda kliendihalduriga!

Reeglina võetakse kaal artiklikaardilt. Kui järgneva sätte väärtus on 0, siis puuduva kaalu korral annab liides vea. Igaks juhuks võib selle välja täita 1-ga:

Vajalik on luua lisaväljad tellimusele/arvele ja lähetusviisile.

Lisaväljade loomiseks tuleb minna: Seadistused > Üldised seadistused > Lisaandmete liigid.

Iga uue lisavälja loomiseks vajutada 'Lisa uus' nuppu.

Arve lisavälja KOOD tekib automaatselt KLASS 'Arve' valikuga. Juhul kui arve lisavälju juba kasutatakse, siis tekib automaatselt järgmine vaba. Neid saab olla kuni 7.

Arve lisavälja KOOD tekib automaatselt KLASS 'Arve' valikuga. Juhul kui arve lisavälju juba kasutatakse, siis tekib automaatselt järgmine vaba. Neid saab olla kuni 7.

'Operaator' väli on lähetusviisi küljes pakkide toimetamise teenusepakkuja nime/tunnuse hoidmiseks ja vajalik väljatrüki jaoks.

Lisaväli tuleb luua täpselt pildil toodud kujul.

'Teenuse tüüp' väli on lähetusviisi küljes teenuse tüübi tunnus ja vajalik eelkõige väljatrüki jaoks.

Lisaväli tuleb luua täpselt pildil toodud kujul.

'Paki triipkoodi prefiks' väli on lähetusviisi küljes vajalik eelkõige väljatrüki jaoks.

Lisaväli tuleb luua täpselt pildil toodud kujul.

Lähetusviise tuleb luua nii palju, kui on erinevaid teenuseid kasutusel. Siinkohal on näidetena toodud 2 levinumat.

Lähetusviiside loomiseks tuleb minna: Seadistused > Lao seadistused > Lao lähetusviisid

Uue lähetusviis loomiseks vajutada 'Lisa uus' nuppu.

Kui lähetusviisid on juba olemas, siis pole vaja uusi luua (sest kood ei pea olema sama nagu näites), vaid täita juhise järgi muud väljad ja lisaväljad.

'Paki triipkoodi prefiks' koosneb kahest osast: kliendi ID (sama kood, mis süsteemiseadistuses 'Eesti Post XML Tunnus prefiks' väljal) ja nullidest. Nulle tuleb panna niipalju, et kui lisada ka arve numbriseeria pikkus, siis on kokku 21 tähemärki.

Omniva puhul tuleb eraldi rääkida teenuse koodidest ja lisateenuste koodidest. Need on kahetähelised koodid ja kõige parem ja lihtsam on need küsida oma Omniva halduri käest. Teenuse koodid sisestatakse lähetusviisi kaardile 'TEENUSE KOOD' väljale komaga eraldatult. Mõned on näidetana allpool ka välja toodud.
Teenuskoodide list...

Levinumaid põhiteenuse koode on PA ja lisateenusena on kasutusel ST. Esimene tähendab, et tegemist on pakiautomaati jõudva pakiga ja teine kliendi teavitust SMS-iga. Need koodid on komaga eraldatult 'TEENUSE KOOD' väljal.

Lisaks on lisaväljal 'Teenuse tüüp' põhiteenuse nimetus, mida kasutab pakikaardi väljatrükk, antud juhul 'Pakiautomaadi teenus'.

Kasutatav on ka teenuskood PU, mis tähendab, et Omniva kuller käib teie juures pakkide järel ja kohale toimetatakse kliendile pakiautomaati. Sellele vastav 'Teenuse tüüp' lisaväljale on 'Pakiautomaat korje kulleriga'.

Juhul kui teenuse tüüp erineb näidetes toodust, tasub konsulteerida Directo konsultandiga.

Kulleri puhul on samuti teenuskoodid olulised. Alljärgnevalt välja toodud 2 enim kasutatavat - kulleriga paki toimetamine eraisikule ja toimetamine asutusele. Jah, selleks tuleb luua erinevad lähetusviisid, sest teenuskoodid on erinevad.

Selleks, et pakiandmete saatmine ja pakikaardi väljatrükk saaks õnnestuda, on arvel väljad, mis peavad olema reeglite kohaselt täidetud. Juhul kui protsess algab tellimusest, siis tuleks tagada, et need väljad on korrektselt täidetud juba tellimusel, kust need arvele edasi liiguvad.

Directos ei ole pakiautomaatide nimekirja. Eeldus on, et tellimused jõuavad Directosse veebipoest üle liidese korrektselt täidetuna.

Lähetusviisiga määratakse ära, millise teenusepakkuja mis tüüpi teenusega tegu on.

Pakiautomaadi kood on vajalik ainult juhul, kui pakk toimetatakse pakiautomaati. Kullerteenuse puhul jääb see väli tühjaks.

Juhul, kui on vajadus tellimusel/arvel käsitsi automaatide koode ja nimetusi täita, siis leiab nende tähised SIIT

Pakiautomaadi teenuse puhul on oluline, et lähetusaadressi esimesel väljal oleks täidetud pakiautomaadi nimetus. Muud lähetusaadressi väljad ei oma tähtsust ja võiksid olla tühjad.

Kullerteenuse puhul on olulised kõik väljad. Eelistatakse lähetusaadressi väljasid. Kui need on tühjad, võetakse aluseks aadressi väljad.

Eriti tähtis on indeksi positsioon! See on lähetusaadressi teisel väljal (real) ja peab vastama alljärgnevale süsteemiseadistusele:

Kuna paki saabumise teavitus käib SMS teel, siis telefon peab alati olema täidetud. See võib, aga ei pea olema suunakoodiga.

Pakiandmete edastamine käib aruandest 'Arvete nimekiri'.

Aruandes tuleb täita vajalikud filtrid, et kätte saada veel saatmata pakiandmed. Topeltsaatmist karta pole vaja, see lihtsalt ei ole võimalik. St kui valimis on ka juba saadetud arveid, siis uuesti postitamisel teise poole süsteem neid vastu ei võta.

Kõige sagedamini kasutatakse Perioodi ja Lähetusviisi filtreid. Kui kasutusel on mitu erinevat Omniva lähetusviisi, siis saab need Lähetusviisi väljale sisestada eraldatult komaga.

Lisaks võib aruandes märkida linnukese 'Lähetusviis', sest see toob lähetusviisi koodi tulbana aruande sisus nähtavale.

Pakiandmete saatmiseks tuleb 'SAADA XML' nupu ees olevast rippmenüüst valida 'Eesti Post XML' ja seejärel vajutada nuppu 'SAADA XML', misjärel küsitakse saatmise kinnitust:

Selle tulemusel avaneb uus aken, mis loetleb rida realt, kas andmete saatmine õnnestus või mitte. Õnnestumisel on rea järel OK. Lõpus on ka välja toodud, mitu saadetist oli kokku, palju oli vigaseid ja palju korras saadetisi. Omniva poolne soovitus on, et korraga saata 20-30 paki kohta andmeid ühe saatmisega. See ei ole tehniline piirang aga see lihtsalt vähendab vastuse saamiseks kuluvat aega.
Ebaõnnestunud postituse korral kuvatakse ka vea põhjused.

Sellisel juhul tuleks arvele andmeid lisada ja saatmist uuesti proovida.

Saatmise õnnestumisel lisatakse arve lisaväljale ka 'Paki jälgimiskood'.

Pakikaart on spetsiaalne arve ja/või aruande Arvete nimekiri väljatrükk. Kasutusel on 2 varianti.

Kui on olemas spetsiaalne etiketiprinter (A6 formaat) või soov trükkida iga pakikaart eraldi A4 tavalisele paberile tavalisest printerist, siis kasutada Arve väljatrükki 'Pakikaart A6'. Arve pealt trükkimiseks avada arve ja vajutada hiire parema klaviga Trüki nupule ning avanevast rippmenüüst valida 'Pakikaart A6'. Sama väljatrükki saab kasutada ka aruandes Arvete nimekiri, kust saab kõik pakikaardid korraga välja trükkida. Selleks tuleb 'TRÜKI ARVED' nupu ees olevast rippmenüüst valida väljatrükk 'Pakikaart A6' ja vajutada nuppu 'TRÜKI ARVED'.

Avaneb pdf, mida trükkida soovitud printerisse.

Aruande väljatrükk võimaldab 4 silti trükkida ühele A4 lehele. Selleks võib kasutada tavalises printeris kleepsupaberit, millel A6 lõiked.

Trükkimiseks tuleb 'Trüki' nupu ees olevast rippmenüüst valida 'Pakikaardid 4xA6' ja vajutada nuppu 'Trüki'.

Avaneb print aken, kust anda trükkimise käsk.