Laohalduse liides WMS Direct – sisesta andmeid vaid üks kord ja otse nende tekkimiskohas

Directo äritarkvara kasutajatel, kes puutuvad oma tegevuses kokku laomajanduse ja tootmisega, on võimalik oma tööprotsesside lihtsustamiseks ja automatiseerimiseks võtta kasutusele uus liides WMS Direct.

WMS Direct on Directo äritarkvara uus standardne liides logistika- ja laodokumentide haldamiseks Directo väliste WMS lahendustega (WMS = Warehouse Management System ehk laohaldussüsteem). Selle uue ja võimeka liidese kasutamine võimaldab tegeleda välises rakenduses täiesti paberivabalt erinevate laoprotsessidega (kauba vastuvõtt, kauba komplekteerimine, inventuurid, tootmine jne). WMS Directi võimalusi kasutades saate seda teha kiiresti, lihtsalt ja turvaliselt. Lühidalt öeldes hoiab see kokku teie aega ning minimeerib vigade tekkimise tõenäosuse.

WMS Direct võimalused:

1. Kaupade vastu võtmine – lattu saabuva kauba andmete sisestamine kiiresti ja turvaliselt kasutades skannerit (skännerid ei sisaldu WMS Direct kuutasus), mis kannab info Directos automaatselt Sissetuleku dokumendile.
2. Kaupade lähetamine – laost väljuvate kaupade andmete kiire ja vigadeta sisestamine, mille tulemusena tekib Directos automaatselt Lähetuse dokumendile vajalik info. Lisaks saab algatada ka Arve loomise ja kinnitamise protsessi juba lähetatud, aga arveldamata kaupadele.
3. Inventeerimine – kiire ning turvaline vigade korrigeerimine, puudujääkide kõrvaldamine, kauba inventeerimine kasutades skannereid.
4. Mahakandmised – võimaldab jooksvalt märkida ära (maha kanda) defektiga tooted, nii laost kui tootmise juurest liigub info Directosse kiiresti ja otse toimumiskohast
5. Ladude vahelised liikumised – kaupade mugav kiire ja vigadeta liigutamine ladude vahel.
6. Võimalus arendada skännerlahendust Directo tootmismooduli dokumentidega.
7. Ja veel palju erinevaid võimalusi oma lao info halduse automatiseerimiseks

Kokkuvõtvalt tähendab WMS Direct, et laoga seotud andmed sisestatakse alati vaid üks kord ning seda tehakse info tekkimiskohas ja -ajal.

WMS Direct liidese hind on 199 €/kuus (ei sisalda KM). Vaata hinnakirja. Tehingute ja liidese poole pöörduvate seadmete hulk ei ole kuupaketis piiratud.
NB! antud summa sisaldab vaid Directo tarkvaralahenduse WMS Direct kasutamist, millele lisanduvad vajalikud skannerid jm. riistvara (ei ole Directo pakutav teenus).

WMS Direct on arendatud sujuvaks koostööks WMS lahendustega ning liidese kasutaja ei pea muretsema selle aegumise või tehnoloogia arenguga kaasnevate muudatuste pärast, sest kõik uuendused sisalduvad juba kuupõhises tasus. Samuti sisalduvad kuutasus ka paigalduskulud.

WMS Directi on võimalik kasutada koos mistahes laohaldussüsteemiga, kui selle teenuse pakkuja on nõus tegema oma tarkvaras arendused, mis võimaldavad Directoga liidestamist. Teenuse tellimiseks pöördu meie poole ning aitame Sul käima lükata Directo liidestamise juba Sinul kasutusel oleva WMS tarkvaraga või soovitame vajadusel ka häid laohaldustarkvara pakkujaid, kellega oleme koostööd teinud ning kellel on WMS Direct liidese kasutamiseks vajalikud arendused juba tehtud.

Mõningad WMS teenuse pakkujad, kellel on WMS Direct kogemus juba olemas:

• VTMF
  • Alo Toom
  • +372 501 8161
  • alo@vtmf.ee
  • #skännerlahendus
• RIS
  • Raino Einroos
  • +372 5015625
  • raino@ris.ee
  • üldmeil: ris@ris.ee
  • #skännerlahendus
• Tovacom
  • Jüri Vau
  • +372 5066007
  • jyri.vau@tovacom.com
  • #laoteenus

2 - Sissetuleku loomine ostutellimuse numbri järgi ja Sissetuleku loomine kui pole ostutellimust
4 - Lähetuse ridadele saab sn lisada kui artikkel on algsel lähetusel

Liides on eeldatud, et dokumendid luuakse Directos. Juhul kui dokument luuakse läbi liidese, siis on nõutav et läbi liidese antakse kaasa kõik vajalik informatsioon (a'la konto, objektid, projektid jne) ning ei saa eeldada et liides käitub nagu Directo kasutajaliides (UI). Liides on standardne st. kõikide klientide jaoks ühetaoline ning kõik arendused on samad kõikide klientide jaoks. Väljundliidesed näitavad kõiki kirjeid ning piiranguid saab teha päringu filtritega! Andmemahu vähendamiseks on vajalik kasutada filtrit TimeStamp (ts).

Võrreldes tavapärase xmlcore liidestega on WMS Direct puhul kasutusel uus ühine pöördumispunkt. Sellest tulenevalt on mõned erisused millega peab arvestama

Ligipääsu pöördumispunkt (Base URL): https://login.directo.ee/xmlcore/wmsd/xmlcore.asp
Ligipääsu tagamiseks tuleb kasutada token'it. Tokeni leidmine . Token asendab vanemat tüüpi liideste appkey ja andmebaasi nime korraga. Token tuleb POST meetodil muutujas TOKEN (sarnaselt siis html vormi postitamisele) saata antud URL'i pihta tulemuse saamiseks. Ebakorrektse või valesti saadetud tokeni korral on vastus <result type=„5“ desc=„Unauthorized“/>

Kui ei kasuta muutujat TOKEN, siis on vastus <err>token required</err>

CURL näide

curl --location 'https://login.directo.ee/xmlcore/wmsd/xmlcore.asp' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=••••••' \
--data-urlencode 'get=1' \
--data-urlencode 'what=xxxxx' \
--data-urlencode 'ts=xx.xx.xxxx'

Et leida liidese XML võtit on vaja:
1. Logi Directosse sisse kasutajaga kellel on SUPER õigused
2. Ava töötaja kaart 'XML'

3. Liigu Admin sakile

4. Liigu sektsioonini XML liidesed
5. Real WMS Direct vajuta nuppu et näha võtit

Test web liides https://login.directo.ee/xmlcore/wmsd/webupload.html

Väljund skeema: https://login.directo.ee/xmlcore/wmsd/ws_artiklid.xsd
what=item
get=1
Filter „class“,„code“,„type“,„barcode“,„supplier“,„supplieritem“,„closed“,„ts“

Sisend skeema: https://login.directo.ee/xmlcore/wmsd/xml_IN_artiklid.xsd
what=item
put=1

Väljund skeema: https://login.directo.ee/xmlcore/wmsd/ws_artikliklassid.xsd
what=itemclass
get=1
Filter „code“,„master“

Partii/sn lisaväljadele info sisestamiseks konkreetsele artikli partiile. Partii peab olema enne olemas. Väli qty mitte kasutada!!!
Skeema: https://login.directo.ee/xmlcore/wmsd/xml_IN_sn_lisavaljad.xsd
what=sndatafield
put=1

Parti/sn lisaväljade info otsimiseks partii/sn ja artikli koodi järgi Skeema: https://login.directo.ee/xmlcore/wmsd/ws_sn_lisavaljad.xsd
what=sndatafield
get=1

Filter: „code“,„class“,„sn“

Vajalik partii/sn struktuuri info saamiseks

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_sn_lisavalja_klassid.xsd
what=sndatafieldclass
get=1
Filter „code“,„class“

tyyp selgitus: 1=number; 3=aeg; 4=valik (Vaata ka: Lisaväljad)

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_retseptid.xsd
what=recipe
get=1
Filter „code“,„ts“

On ainult väljundid. Liideses on võimalik teha laoseisus päring ka TimeStamp järgi. Selleks kasuta filtrit ts. Kui teha päring kasutades filtrit ts, siis väljund näitab ka need artiklid mille kogus on muutunud antud perioodis nulliks. Ilma ts filtrita näitab väljund ainult neid koguseid mis on suuremad kui null
Esimesel korral on vaja laadida kõik laoseisud ning selleks ära kasuta ts filtrit!

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_laoseis.xsd
what=stocklevel
get=1
Filter „code“,„stock“,„ts“

Pane tähele et:

• eeldab et Riiulid on kohustulikud baasis LaoId küljes
• näitab ainult tegelikku laoseisu
• kui on kasutusel ka Projektid, siis ka Riiuli ja Projekti lõikes laoseisu

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_laoseis_riiul.xsd
what=shelfstocklevel
get=1
Filter „code“,„stock“,„shelf“,„ts“

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_laod.xsd
what=stock
get=1
Filter „code“,„closed“

https://login.directo.ee/xmlcore/wmsd/ws_kliendid.xsd
what=customer
get=1
Filter „code“,„loyaltycard“,„regno“,„email“,„phone“,„closed“,„ts“,„class“

https://login.directo.ee/xmlcore/wmsd/ws_hankijad.xsd
what=supplier
get=1
Filter „code“,„class“,„regno“,„email“,„type“,„closed“,„ts“

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_kasutajad.xsd
what=user
get=1
Filter „code“,„internalcode“,„idnumber“,„closed“,„email“,„ts“

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_objektid.xsd
what=object
get=1
Filter „code“,„master“,„type“,„level“,„ts“

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_projektid.xsd
what=project
get=1
Filter „code“,„customer“,„supplier“,„orderer“,„contract“,„closed“,„ts“

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_riiulid.xsd
what=shelf
get=1
Filter „stock“

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_tookeskused.xsd
what=workcenter
get=1
Filter „code“

Müügitellimuste dokument on infotrmatiivne ja ainult väljund

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_tellimused.xsd
what=order
get=1

Vaja seadistada Lao lähetuse staatused (näidis kuidas võib kasutada)

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_lahetused.xsd
what=delivery
get=1
Filter „number“, „ordernumber“, „customercode“, „status“, „stock“, „confirmed“, „ts“

Lähetuste liideses saab muuta olemasolevaid lähetuse dokumente.
Skeema: https://login.directo.ee/xmlcore/wmsd/xml_IN_lahetused.xsd
what=delivery
put=1

• Seerianumbrite kasutamisel liides tuleb esialgne rida nn „splittida“ see tähendab olemasolevatel kaubale panna kaasa rea number, liides kontrollib seost vana reaga
  • Kui saata mitu rida sama rn siis salvestab mõlemad <rows> <row item=„8000-5669“ rn=„2“ qty=„1.000“ serialnumber=„ZZZ“/> <row item=„8000-5669“ rn=„2“ qty=„1.000“ serialnumber=„AAA“/> </rows> Originaal rida kustutakse!
• Saab Staatuse muutmiseks saata ainult dokumendi päis ilma ridadeta
• Kui lähetuse dokument on kustutatud ja liides proovib salvestada saab veatete „Not Found“ ja type=11
• Lähtuse kinnitamisel väärtusega confirm=2 tehakse lisaks kinnitamisele ka arve. Vastussõnumis tagastakse arve number

Lähetuse numbri järgi leiab tellimus ning käivitada arve tegemise protseduur kus kõikide lähetatud aga arveldamata kaupade kohta tehakse arve. Liides tagastab loodud Arve number.
Lähetuse sisendis confirm=2 tähendab kinnita ja loo kinnitatud arve (mitte otsearve!).

Kui on vajadus lähetus lukustada nii et WMS süsteemis muutmise ajal ei saaks Directos dokumenti muuta, siis tuleb kasutada staatuseid ja Directo seadistust Lähetuse staatused, mis määravad lähetuse lukku.

Sissetulekute liides on mõeldud kasutamiseks et Ostutellimusel luuakse Sissetuleku dokument. Postitada võib nii kogu dokumendi kui ka rida haaval aga soovitav on postitada kogu dokument korraga, et välistada liigset keerukust.

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_sissetulekud.xsd
what=stockreceipt
get=1
Filter „number“,„date1“,„date2“,„supplier“,„confirmed“,„status“,„ts“,„stock“

Sissetuleku liides võimaldab muuta olemas olevat dokumenti. Uue dokumendi loomiseks tuleb seos ostutellimusega loomisel täpselt postitada (Loe: Erisused)

Skeema: https://login.directo.ee/xmlcore/wmsd/xml_IN_sissetulekud.xsd
what=stockreceipt
put=1

• Sissetulekul kui sama reanumbriga (rn) saata, siis kirjutab üle. Kehtib ka SN puhul
• Kui saata mitu rida sama rn siis salvestab mõlemad <rows> <row item=„8000-5669“ rn=„2“ qty=„1.000“ serialnumber=„ZZZ“/> <row item=„8000-5669“ rn=„2“ qty=„1.000“ serialnumber=„AAA“/> </rows> Originaal rida kustutakse!
• Liides ei kontrolli kas toode on SN jälgimisega või mitte!
• Sissetuleku ridade lisamine/muutmine:
  • uutel ridadel jätta ära rea number
  • olemasolevatel panna kaasa rea number, liides kontrollib seost vana reaga.
• Kui on olemas Directos sissetulek, siis tuleb kõik saadud väljad mida isegi ei muudeta kaasa panna!
• Väljad mida süsteem otsib sissetulekule kui need puuduvad
  • Hankija nimi (hankija kaardilt)
  • Ladu (transpordi parameetrilt vaikimisi ladu: stock)
  • Valuuta (trans. parameeter valuuta või EUR)
  • Valuuta kurss
  • Konto (trans. Paramaeeter ladu_sis_kreedit )
  • Asumaa (hankija kaardilt )
  • Tehingu liik (hankija kaardilt)
  • Lähetusviis (hankija kaardilt)
  • Tasumistingimus (hankija kaardilt)
• Kui luua uus sissetulek liidesest et tekiks ka seos ostutellimusega, siis peab olema postitatud päises ostutellimuse number ning ridadel peab olema õige reaga seos -orn = ostutellimuse reanumber
• Sissetuleku päises olevat ostutellimuse numbrit ei tohi ridael uuesti korrata. Lubatud on ridadel viidate teistele OT numbritele (vaata näidet)

  • <?xml version="1.0" encoding="utf-8"?>
    <stockreceipts>
      <stockreceipt number="100001" supplier="0001" suppliername="Directo OÜ" stock="TL1" user="SUPER" purchaseorder="100001">
        <rows>
          <row item="0001" qty="10" orn="1" />
          <row item="0002" qty="10" purchaseorder="100002" orn="1" />
        </rows>
      </stockreceipt>
    </stockreceipts>

Inventuuri tegemiseks:

• Loo Directos inventuuri dokumendid ilma ridadeta
• Laoid laialaijagmine teha kui lugemine on lõppenud
• Kui kasutad mitut skännerit:
  • Loo keti peadokument, kuhu ei loeta artikleid
  • Tee inventuuri dokumendid mis kuuluksid ühte ketti (vt eelmine punkt)
  • Lisa kommentaari kellele on dokument kasutamiseks

NB! Kui inventuuri dokumendi number puudub Directos loob liides uue dokumendi!

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_inventuurid.xsd
what=taking
get=1
Filter „number“,„chain“,„stock“,„confirmed“,„ts“

Liides võimaldab lisada uusi ja muuta juba olemas olevaid inventuuri dokumente.

Skeema: https://login.directo.ee/xmlcore/wmsd/xml_IN_inventuurid.xsd
what=taking
put=1

• Kui dokument puudub loob liides uue dokumendi
• Rea kustutamiseks sisendile lisada delete=1. Rea ja artikli täpsus on vajalik!

Enne inventuuri!

• Dokument tuleb luua Directos (ainult päis ilma ridadeta)
• Laoid splitti ei teha kui kogused saata läbi liidese
• Liideses tuleb saata alati rea numbriga!!! (rea number on ID!)
• Dokument tuleb kinnitada Directos ning Directos teha Laoid split

Lao liikumiste liidesed saab kasutada kui kaup liigub laost lattu, Lao sees riiulitel ümber paigutamisel (riiulipõhine laoseis)

Directos kuvatakse liikumise dokumendil staatuse väljal info mis seisundis on liikumine. Staatuse välja ei ole skeemis!

Staatus väli Directos

Saab teha muudatusi ja lisada uusi liikumise dokumente.

Skeem https://login.directo.ee/xmlcore/wmsd/xml_IN_liikumised.xsd
what=movement
put=1

• Kui anda ette olemasoelv number toimub update
• Kui anda ette liikumise dokumendi number mida Directos pole, loob uue dokumendi
• Saab kasutada ka välise ID uue dokumendi loomisel. Sellisel juhul üritab süsteem luua uue dokumendi mille number on kas DOK seeriast või seeriast mis on häälestatud transpordi parameetrites. NB! Välise ID dokumeni loomist vältida!!!
• Väljad qty ja receivedqty on kohustulikud ja peavad olema võrdsed!!!

Skeem https://login.directo.ee/xmlcore/wmsd/ws_liikumised.xsd
what=movement
get=1

Filter „number“,„fromstock“,„tostock“,„confirmed“,„ts“

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_tootmised.xsd
what=production
get=1
Filter „number“,„status“,„kinnitatud“,„ts“

Saab muuta ja lisada tootmise dokumente.

Skeema: https://login.directo.ee/xmlcore/wmsd/xml_IN_tootmised.xsd
what=production
put=1

Skeem https://login.directo.ee/xmlcore/wmsd/ws_otellimused.xsd
what=purchaseorder
get=1
Filter „number“,„date1“,„date2“,„supplier“,„confirmed“,„status“,„type“,„ts“,„stock“

Kui on soov teha Ostutellimusest Sissetuleku dokument , siis tuleb lisada täpselt samade andmetega sissetulek ning jälgida et sissetulekul oleks ka viited ostutellimuse ridadele!

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_mahakandmised.xsd
what=writeoff
get=1
Filter „number“,„status“,„project“,„stock“,„confirmed“,„ts“

Uute dokumentide lisamine ja muutmine. Vaata ka projektid

Skeema: https://login.directo.ee/xmlcore/wmsd/xml_IN_mahakandmised.xsd
what=writeoff
put=1

• Ridade konto võetakse Artikli klassi MAHA KONTO pealt

Skeem https://login.directo.ee/xmlcore/wmsd/ws_arved.xsd
what=invoice
get=1
Filter „number“,„customercode“,„transactiondate“,„date1“,„date2“,„ts“,„status“

Dokumentide lisamine ja muutmine.

https://login.directo.ee/xmlcore/wmsd/xml_IN_arved.xsd
what=invoice
put=1

Vaikimisi parameetreid ei pea looma!

Skeema: https://login.directo.ee/xmlcore/wmsd/ws_tagastused.xsd
what=stockreturn
get=1
Filter number, customercode, status, project, stock, confirmed, ts

Dokumentide loomine ja muutmine.

Skeem https://login.directo.ee/xmlcore/wmsd/xml_IN_tagastused.xsd
what=stockreturn
put=1

• Sisend loob uue dokumendi kui antud dokumendi numbriga Tagastust pole.
• Kui on olemas antud numbriga tagastus: Kirjutatakse päis üle ning read kustutkse ja lisatakse uuesti.
• Kui postitakse confirm = 1 siis dokument kinnitatakse ja rohkem muuta ei saa.
• vaata ka projektid

Liides väljastab infot kõide kustutamiste kohta Directos!

Skeem https://login.directo.ee/xmlcore/wmsd/ws_kustutamised.xsd
what=delete
get=1
Filtrid: document,ts

Filtri document selgitused

type=„0“ means success