Razmjena podataka s vanjskim sustavima

Import naloga za slaganje iz XML datoteke

•Deklaracija import datoteke za automatsko učitavanje naloga za slaganje iz XML datoteke

•Datum kreiranja: 15.06.2015.

•Datum zadnje izmjene: 17.08.2021. - Dodane postavke importa naloga za slaganje iz XML datoteke

Preduvjeti za uspješnu implementaciju

Prije implementacije 4D Wand2XML aplikacije i pokretanja importa naloga za slaganje iz XML datoteke, korisnik mora u suradnji s WMS providerom i administratorom svoga sustava dogovoriti i implementirati nekoliko vrlo bitnih koraka:

•korisnik/implementator treba detaljno osmisliti i analizirati sve procese u poduzeću koji se tiču razmjene podataka s WMS softwareom i dati jasne upute WMS provideru što od podataka i kada ih želi s njim razmjenjivati, paralelno sa stvarnim logističkim akcijama u dolasku, smještaju, izlasku i inventuri robe za koju se podaci razmjenjuju;

•korisnik mora odrediti i popisati poduzeća i skladišta koja će sudjelovati u razmjeni podataka s WMS providerom, odnosno u logističkim operacijama;

•korisnik mora odrediti i u 4D Wand-u otvoriti korisnički račun i dodijeliti mu željena prava pristupa te obavijestiti WMS providera i 4th Dimension o kojem korisničkom računu se radi kako bi mogli izvršiti potrebna podešavanja;

•korisnik mora zajedno s WMS providerom proći sve procedure fizičkog i podatkovnog prometa roba između svojih skladišta i logističara;

•korisnik odlučuje o tome kako se koji proces iniciran kreiranjem Naloga za slaganje treba odviti do kraja i sukladno tome određuje dimenziju dokumenta koje služi za provođenje automatike opisane u uputama za razmjenu podataka u oba smjera, te unosi dimenzije koje će za to konkretno služiti;

•na osnovu dogovora korisnik i WMS provider odlučuju o vremenima i okidačima u poslovanju koji pokreću određene razmjene podataka bilo u smjeru WMS-a ili u smjeru 4D Wand-a;

Nakon što su dogovoreni svi tijekovi kolanja podataka korisnik/implementator WMS-a trebao bi kontaktirati 4th Dimension kako bi zajedno:

•pripremili demo poduzeće za test rada WMS sustava

•pripremili postavke 4D Wand sustava za pokretanje procesa u zadanom poduzeću

•eventualno uskladili eksportirane podatke iz wand2XML aplikacije potrebama WMS sustava

Datoteke i Format

Procedura prilikom poziva importira jednu po jednu datoteku u kojoj se nalazi zaglavlje dokumenta Naloga za slaganje (SLA), pripadajuće stavke u kojima je definirana složena količina i serijski brojevi vezani na složene stavke.
Da bi se prethodno opisana datoteka importirala, potrebno je u 4D Wandu otvoriti dokument Naloga za slaganje (SLA), te iz izbornika Obrade pozvati proces Import složenih količina iz WMS-a.

Nakon što se otvori prozor za odabir datoteka, potrebno je osvijetliti jednu ili više datoteka za import, te nakon toga izbor potvrditi pritiskom na tipku Open. Nakon toga se aktivira procedura za import, te se po njezinom dovršetku automatski otvara datoteka ImportPotvrdaWMS.log sa zapisom o tome da li je import uspješno izvršen ili se prilikom importa dogodila neka pogreška.

Ako je na nalogu za slaganje definirana Dimenzija 1 sa specifičnom šesteroznamenkastom šifrom (NNNMMM), koja se sastoji od troznamenkaste brojčane šifre klase dokumenta (NNN) i troznamenkaste brojčane oznake izvještaja za tu klasu dokumenta (MMM), automatski se nakon importa složenih količina kreira odabrani dokument i ispisuje se na pisač odabrani izvještaj. U nastavku se nalazi lista dokumenata koje je automatikom moguće kreirati. Naglašavamo da izvještaji moraju biti odabrani sa zadnjeg kreiranog dokumenta na način prikazan na slici ispod spiska klasa dokumenata. U slučaju da je Dimenzija 1 iskorištena za neke druge namjene, po potrebi je moguće definirati da se šifra nalazi u mjestu troška ili nekoj drugoj dimenziji, koju na taj način treba i odabrati na dokumentu.

Importom u Nalog za slaganje moguće je automatski kreirati jedino sljedeće tipove dokumenata:

•Otpremnica (šifra 051, primjer 2.);

•Interna izdatnica (šifra 045, primjer 3.);

•Revers (šifra 057, primjer 4.);

•Izdatnica na komisiju (šifra 067, primjer 5.);

•ili samo importirati složene količine u Nalog za slaganje (šifra 122, primjer 6.).

Osim toga moguće je importu naložiti da kreira i Izlazni račun (šifra 091) tako da prethodno kreira i odobri otpremnicu i iz nje automatski pokrene proces fakturiranja tako kreirane otpremnice (primjer 1.).

Primjeri:

•091003 – Kreira se dokument otpremnice, zatim dokument računa (091 označava tip dokumenta izlaznog računa) i ispisuje se izvještaj Račun (RPT-3)

•051012 – Kreira se dokument otpremnice (051 označava tip dokumenta otpremnice) i ispisuje se izvještaj Otpremnica (RPT-12)

•045404 – Kreira se interna izdatnica (045 označava tip dokumenta interne izdatnice) i ispisuje se izvještaj Interne izdatnice (RPT-404)

Napomena: Na internoj izdatnici će se eksterno skladište učitati po partneru odabranom na nalogu za slaganje. Po tom partneru bit će učitano skladište na kojem je isti odabran kao poslovnica. Ako je na više skladišta kao poslovnica odabran isti partner, učitat će se prvo skladište u nizu.

•057009 – Kreira se izlazni revers (057 označava tip dokumenta revers) i ispisuje se izvještaj Izlazni revers bez cijena (RPT-009)

•067251 – Kreira se izdatnica na komisiju (067 označava tip dokumenta izdatnica na komisiju) i ispisuje se izvještaj Izdatnica s cijenama (RPT-251)

•122440 – Importira se nalog za slaganje (122 označava tip dokumenta naloga za slaganje) i ispisuje se izvještaj naloga za slaganje (RPT-440)

Da biste saznali broj izvještaja koji ćete upisati u šifru registra, ispišite željeni izvještaj iz izbornika Ispisi odabrane klase dokumenata, kliknite na zeleni kružić i u Summary Info prozoru pročitajte broj u parametru Keywords.

Ako želite primijeniti potpunu automatiku, potrebno je pozvati sljedeću naredbu kao unaprijed definirani korisnik komu je u parametrima programa uključena opcija ispisa dokumenata bez upita i bez pregleda:

c:\4d\wand\sys\w_exe ANA=96 SF1=w:\4d\Wand\DataTest\Chahta\WMS\Test_SLA_445001.xml SF2=3

Dakle potrebno je pozvati proceduru ANA=96, te joj u parametru SF1 poslati putanju do .xml dokumenta koji želite importirati. Parametrom SF2 možete birati da li želite da 4D Wand sustav automatski generira izvještaj. Moguće opcije za SF2 parametar su:0 – bez automatskog ispisa, 1 – automatski ispiši izvještaj na štampač, 2 – automatski generiraj izvještaj u RTF formatu ili 3 – automatski generiraj izvještaj u PDF formatu. Ako se koriste opcije 2 ili 3, izvještaj se generira u datoteku identičnog naziva kao i import datoteka s odgovarajućom ekstenzijom (rtf ili pdf). U parametrima programa potrebno na korisniku definiranom kao AutoUser odabrati prethodno opisane opcije prikazane na sljedećoj slici:

Opis tipova podataka

NUMERIC(-mm.nn) - Numerički podatak maksimalne duljine mm znamenki (uključujući decimalni separator i predznak), od kojih je nn znamenki odvojeno za decimalna mjesta. Decimalni separator je ',' (zarez), a separator za tisućice se ne upisuje: npr.: -1234567890,12 . Prethodni primjer predstavlja numerički podatak u formatu -14.2: predznak (-), 10 mjesta za cjelobrojni dio, decimalni zarez i 2 mjesta za decimalni dio (ukupno 14 znakova).
STRING(nn) - Tekstualni podataka maksimalne duljine nn znakova u kom ne smije biti znak ; (točka-zarez), znak '<=' u tablicama označava da vrijednost pojedine kolone može biti manja ili jednaka upisanom broju, nipošto veća.
DD.MM.GGGG - Datumski podatak formatiran kao dan.mjesec.godina , gdje su dan i mjesec popunjeni vodećim nulama ako su manji od 10, npr.: 03.05.2014.
HH:MM:SS - Vremenski podatak formatiran kao sat:minuta:sekunda popunjeni s vodećim nulama ako su vrijednosti manje od 10, npr: 01:04:09

4D Wand Klasifikacija

 Primjer importa dokumenta 234772 koji sadrži 4 stavke s različitim traženim količinama, složenim količinama i pripadajućim serijskim brojevima.

<?xml version='1.0' encoding='utf-8' ?>
<ImportXML>
     <Zaglavlje>
          <VerzijaImporta>GEN-180426</VerzijaImporta>
          <PoslovnaGodina>2015</PoslovnaGodina>
          <DatumExporta>18.05.2015</DatumExporta>
          <VrijemeExporta>15:08:10</VrijemeExporta>
     </Zaglavlje>
     <Dokumenti>
          <Dokument>
          <Zaglavlje>
               <dokument_id>234772</dokument_id>
               <Tip_dokumenta>122</Tip_dokumenta>
          </Zaglavlje>
          <Stavke>
               <Stavka>
                    <Stavka_id>1487163</Stavka_id>
                    <roba>50668</roba>
                    <Kolicina>2.000</Kolicina>
                    <Kolicina5>2.000</Kolicina5>
                    <SerijskiBrojevi>
                         <SerijskiBroj>
                              <Broj>LOT1</Broj>
                              <Rok>18.03.2011</Rok>
                              <Kolicina>3.11</Kolicina>
                         </SerijskiBroj>
                         <SerijskiBroj>
                              <Broj>LOT2</Broj>
                              <Rok>18.03.2011</Rok>
                              <Kolicina>9.11</Kolicina>
                         </SerijskiBroj>
                   </SerijskiBrojevi> 
                </Stavka>
               <Stavka>
                    <Stavka_id>1487164</Stavka_id>
                    <roba>49505</roba>
                    <Kolicina>2.000</Kolicina>
                    <Kolicina5>2.000</Kolicina5>
               </Stavka>
               <Stavka>
                    <Stavka_id>1487161</Stavka_id>
                    <roba> 49723</roba>
                    <Kolicina>3.000</Kolicina>
                    <Kolicina5>3.000</Kolicina5>
               </Stavka>
               <Stavka>
                    <Stavka_id>1487162</Stavka_id>
                    <roba> 49724</roba>
                    <Kolicina>2.000</Kolicina>
                    <Kolicina5>2.000</Kolicina5>
               </Stavka>
          </Stavke>
          </Dokument>
     </Dokumenti>
</ImportXML>

Postavke Importa naloga za slaganje iz XML datoteke

S glavnog izbornika 4D Wanda potrebno je odabrati Parametre programa --> Podešavanje dokumenata --> Postavke importa složenih količina iz WMS-a.

Odabirom opcije Postavke importa složenih količina iz WMS-a otvara se sljedeća forma na kojoj je moguće postaviti parametre importa

•Import direktorij – direktorij u kojem nastaju XML datoteke za import složenih količina u Naloge za slaganje

•Direktorij uspješno importiranih – direktorij u koji se sele XML datoteke koje su se uspješno importirale u Naloge za slaganje iz Import direktorija

•Direktorij neuspješno importiranih – direktorij u koji se sele XML datoteke koje se nisu uspješno importirale u Naloge za slaganje iz Import direktorija

•Postavke daljnje obrade SLA se nalaze u – Definiranje u kojoj se dimenziji nalaze specifične šifre koje određuju daljnju obradu Naloga za slaganje (opisano ispod)

•Odaberite način obrade SLA – kao i prilikom ručne obrade Naloga za slaganje (Kreiranje otpremnice, Kreiranje razduženja, Kreiranje interne izdatnice,...) moguće je postaviti način kreiranja sljedećeg dokumenta. Nudi se mogućnost kreiranja jednog dokumenta od svih označenih naloga za slaganje ili mogućnost kreiranja po jednog dokumenta za svaki nalog za slaganje. Zatim odabir zadržavanja cijene upisane na roditeljskom dokumentu (kunske ili devizne), te odabir zadržavanja tečaja s roditeljskog dokumenta.