Razmjena podataka s vanjskim sustavima

Import/export dokumenata i stavki iz/za vanjske sustave i uređaje

Deklaracija import/export datoteka za automatsko učitavanje i snimanje dokumenata, stavki i serijskih brojeva iz vanjskih sustava.

Datum kreiranja: 22.02.2005.

Datum zadnje izmjene: 06.02.2023. - U dokumente dodan refernetni broj kupca i opis da se svi iznosi moraju poslati prilikom importa iznosa po stavkama

Datoteke i format

Import/export se sastoji od tri tekstualne datoteke. Nazivi datoteka imaju oblik DOK-*.txt za dokumente, STA-*.txt za stavke, SPS-*.txt za specifikacije sredstava plaćanja i SER-*.txt za serijske brojeve. "*" treba za sve datoteke biti ista. Npr:
DOK-OTP20070213.txt, STA-OTP20070213.txt i SER-OTP20070213.txt
DOK-K004A.txt, STA-K004A.txt, SPS-K004A.txt i SER-K004A.txt
Datoteke mogu imati nastavke txt ili csv.
Datoteke u csv ili txt formatu trebaju biti u ANSI Windows 1250 encodingu kako bi se ispravno importirali dijakritički znakovi. Dakle, ako za kreiranje importne *.csv datoteke koristite MS Excel, kod spremanja datoteke u *.csv format u polju “Save as type” potrebno je odabrati CSV (Comma delimited) kako biste dobili traženo (ANSI Windows 1250 kodiranje):

Korisnik prilikom importa bira samo prvu datoteku (DOK), a (STA, SPS i SER) se automatski učitavaju.
Kolone su odvojene točka-zarezom (;).
Prilikom exporta iz 4D Wanda, kreiraju se datoteke s nazivima DOK-<Oznaka dokumenta><ggggmmdd>.csv. Na primjer: DOK-ULN20070823.csv za ulazne narudžbe na dan 23.08.2007.

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 s maksimalnom duljinom 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 u formatu dan.mjesec.godina gdje su dan i mjesec popunjeni vodećim nulama ako je isti manji od 10, npr.: 03.04.2006.

Dokumenti

Opis kolona za tablicu dokumenti

Rb.

Dokumenti (DOK)

1.

Dokument

NUMERIC

ID dokumenta iz 4D Wanda (u export-u) ili ID dokumenta iz vanjskog sustava. Ako se ovaj broj
koristi za import internog broja dokumenta u 4D Wand-u onda taj broj ne smije biti veći od
6 znamenki.

2.

Tip

NUMERIC (3)

Tip dokumenta
010 - primka (PRI)
011 - primka maloprodaje (PRIM)
015 - priprema primke (PRP)
019 - povrat robe dobavljaču (STP)
045 - interna izdatnica (INO)
046 - interna primka (INP)
049 - razduženje skladišta (RAS)
051 - otpremnica (OTP)
052 - servisni radni nalog (RAD)
 054 - dnevni promet maloprodaje (PRM)
057 - revers (REI)
059 - povrat robe od kupca (STO)
061 - radni nalog vozila (RNL)
 091 - izlazni račun (IFA)
099 - izlazni račun ostalo (IFD)
110 - ulazna narudžba (narudžba od kupca) (ULN)
111 - pretponuda (PON)
119 - specifikacija sredstava plaćanja (SPS)
121 - ponuda (IZP)
122 - nalog za slaganje (SLA)

3.

Partner

NUMERIC (<=20)

ID iz 4D Wand-a ili OIB komitenta (upisuje se za sve komitente ili ID ili OIB jer import može raditi ili samo po ID-u ili samo po OIB-u)

4.

Skladište

STRING(7)

Šifra skladišta iz 4D Wand s kojeg je prodana roba

5.

Komercijalist

STRING(<=6)

ID komercijaliste iz 4D Wand

6.

Datum

STRING(10)

Datum izvornog dokumenta u obliku DD.MM.GGGG

7.

Rok plaćanja (<=4)

NUMERIC

Rok plaćanja (broj dana), od 0 do 9999

8.

Komentar

STRING(<=240)

Napomena (na primkama se popunjava polje Dostavnica dobavljača). Ako se u koloni
nalaze delimiteri '|' (pipe), u importiranom dokumentu će se tekst podijeliti u tri reda
napomena sukladno tome gdje se nalaze delimiteri. Kod eksporta podataka uvijek se
eksportiraju sva tri retka napomene odvojeni delimiterima '|'. Svaki redak napomene može
biti najveće duljine 80 znakova.

9.

Sredstvo plaćanja

STRING(<=80)

Šifra ili naziv sredstva plaćanja u 4D Wandu

10.

PDV

STRING(<=2)

Način obračuna PDV-a. Učitava se s partnera, ali se može poslati.
1 - Ne podliježe oporezivanju
2 - Oslobođeno - izvoz
3 - Oslobođeno - ostalo
4 - Oporezivo - porezni obveznici
5 - Oporezivo - krajnja potrošnja
6 - Oporezivo - nenaplaćeni izvoz
7 - Oporezivo - nezaračunane isporuke
8 - Naknadno oslobođenje PDV-a
9 - Oslobođeno - tuzemstvo (po tarifama)
10 - Oslobođeno - u vezi s međ. prijevozom
11 - Prolazna stavka (zakašnjela plaćanja)
12 - Oslobođeno - isporuke dobara
13 - Isp. dob. u drugim drž. EU (po tarifama)
14 - Isp. dob. i usl. unutar EU (po tarifama)
15 - Isp. dob. u post. 42 i 63 u EU (po tarifama)
16 - Isp. dob. u okv. trostr. posla u EU (po tarifama)
17 - Obav. isp. osobama bez sjedišta RH (po tarifama)
18 - Sast. i postav. dobara u drugoj članici EU (po tarifama)
19 - Isporuke novih prijevoznih sredstava u EU
20 - Tuzemni prijenos PDV-a (po tarifama)
21 - Isp. dob. unutar EU (po tarifama)
22 - Oporezivo - porezni obveznici (Tuzemne isporuke)
23 - Oporezivo - porezni obveznici (Tuzemni prijenos porezne obveze)
24 - Isp. dob. unutar EU (bez obzira na tarifu)
25 - Isp. dob. i usl. unutar EU (bez obzira na tarifu)
26 - Isp. dob. u drugim drž. EU (bez obzira na tarifu)
27 - Isp. dob. u okv. trostr. posla u EU (bez obzira na tarifu)
28 - Isp. dob. u post. 42 i 63 u EU (bez obzira na tarifu)
29 - Obav. isp. osobama bez sjedišta RH (bez obzira na tarifu)
30 - Oslobođeno - tuzemstvo (bez obzira na tarifu)
31 - Sast. i postav. dobara u drugoj članici EU (bez obzira na tarifu)
32 - Tuzemni prijenos PDV-a (bez obzira na tarifu)
33 - Oslobođeno – izvoz (roba i usluga)
34 - Posebni postupak oporezivanja u članicama EU
35 - Oporezivo - porezni obveznici (Obavljene usluge unutar EU)
36 - Ne uključuje se u obračun PDV-a
37 - Oporezivo - automobili
38 - Obavljene usluge unutar EU (bez obzira na tarifu)
39 - Isp. dob. u okv. trost. posla u EU (samo za ZP)
40 - Oslobođeno - Isp. dob. u drugim drž. EU (ne ide u ZP)
 

11.

Mjesto troška

STRING(<=6)

Mjesto troška. Ako se ne pošalje, uzima se mjesto troška sa skladišta

12.

D1

STRING(<=6)

Dimenzija 1. Ako se ne pošalje, uzima se dimenzija 1 sa skladišta

13.

D2

STRING(<=6)

Dimenzija 2. Ako se ne pošalje, uzima se dimenzija 2 sa skladišta

14.

D3

STRING(<=6)

Dimenzija 3. Ako se ne pošalje, uzima se dimenzija 3 sa skladišta

15.

Broj

NUMERIC (<=6)

Interni broj dokumenta (u export-u) ili ID veznog dokumenta (pri importu). Ako se ovaj broj pri importu koristi za povezivanje s internim brojem dokumenta u 4D Wand-u onda taj broj ne smije biti veći od 6 znamenki.

16.

Tip veznog dokumenta

NUMERIC (3)

Tip dokumenta
015 - priprema primke (PRP)
049 - razduženje skladišta (RAS)
051 - otpremnica (OTP)
057 - revers (REI)
059 - povrat robe od kupca (STO)
091 - izlazni račun (IFA)
099 - izlazni račun ostalo (IFD)
110 - ulazna narudžba (narudžba od kupca) (ULN)
111 - pretponuda (PON)
121 - ponuda (IZP)
122 - nalog za slaganje (SLA)

17.

Broj paragon bloka

STRING(80)

Redni broj računa izdanog iz knjige uvezanih računa bez mogućnosti izdavanja
računa putem naplatnog uređaja

18.

Zaštitni kod izdavatelja

STRING(40)

Zaštitni kod izdavatelja računa - ZKI

19.

Jedinstveni identifikator
računa

STRING(40)

Jedinstveni identifikator računa - JIR

20.

Fiskalni broj računa

STRING(80)

Fiskalni broj računa po novoj strukturi brojanja računa. Ako se ovo polje
koristi prilikom importa izlaznih računa, fiskalni broj će se importirati
u polje Napomena i prepisati preko tamo upisanog sadržaja.

21.

Datum izdavanja računa

STRING(10)

Datum izdavanja izlaznog računa u formatu DD.MM.GGGG. Datum se importira isključivo
u dokumente tipa IFA, IFB i IFD, a za ostale tipove dokumenata se zanemaruje

22.

Vrijeme izdavanja računa

STRING(8)

Vrijeme izdavanja izlaznog računa u formatu HH.MM.SS. Vrijeme se importira isključivo
u dokumente tipa IFA, IFB i IFD, a za ostale tipove dokumenata se zanemaruje

23.

Valuta

STRING(3)

Brojčana šifra valute dokumenta

24.

Tečaj

STRING(<=20)

Tečaj valute (bez odvajanja tisuća, decimalni zarez ili točka)

25.

Vozilo/Objekt

STRING(<=50)

U slučaju da se u razmjeni podataka pojavi Radni nalog servisa vozila (RNL), ovdje se može proslijediti broj šasije vozila (STRING 30) na radnom nalogu.
 U slučaju da se u razmjeni podataka pojavi Radni nalog servisa (RAD), ovdje se može proslijediti serijski broj objekta (STRING 50) na radnom nalogu.

26.

Oznaka procesa

STRING(<=20)

Oznaka poslovnog procesa

27.

Datum ugovora

STRING(10)

Datum ugovora u obliku DD.MM.GGGG

28.

Broj ugovora

STRING(30)

Broj ugovora

29.

Primatelj plaćanja

NUMERIC (<=20)

ID iz 4D Wand-a ili OIB primatelja plaćanja (upisuje se za sve komitente ili ID ili OIB jer import može raditi ili samo po ID-u ili samo po OIB-u)

30.

Broj narudžbe

STRING(80)

Broj narudžbe upisan na dokumentu

31.

Datum narudžbe

DD.MM.GGGG

Datum narudžbe upisan na dokumentu

32.

Adresant

NUMERIC(<=6)

ID osobe iz 4D Wand-a

33.

Datum izvršenja

DD.MM.GGGG

Datum izvršenja radnog naloga (samo za RAD i RNL klase)

34.

Poziv na broj

STRING(30)

Poziv na broj dokumenta

35.

Referentni broj kupca

STRING(255)

Referentni broj kupca, šalje ga kupac, navodi se na izlaznom dokumentu za potrebe kupca, posebno za potrebe eRačuna

Ostali tipovi dokumenata će se po potrebi otvarati.

Za sada je import prvenstveno predviđen za izlazne dokumente. Export se može otvoriti nad bilo kojom klasom dokumenata.
Primke se mogu učitavati standardnim data portom.

Stavke

Opis kolona za tablicu stavke

Rb.

Stavke (STA)

1.

Dokument

NUMERIC

ID dokumenta iz 4D Wanda (u export-u) ili ID dokumenta iz vanjskog sustava kojem pripada stavka. Ako se ovaj broj koristi za import internog broja dokumenta u 4D Wand-u onda taj broj ne smije biti veći od 6 znamenki.

2.

Roba

STRING(<=30)

ID, šifra, kataloški ili bar code artikla iz 4D Wand (iz parametara programa)

3.

Količina

STRING(<=20)

Količina (bez odvajanja tisuća, decimalni zarez ili točka)

4.

Bruto iznos

STRING(<=20)

Iznos prije rabata (u devizi dokumenta)

5.

Neto iznos

STRING(<=20)

Iznos s primijenjenim rabatom (u devizi dokumenta)

6.

VP iznos

STRING(<=20)

Veleprodajni iznos (za izlazne dokumente)

7.

MP iznos

STRING(<=20)

Maloprodajni iznos

8.

Sastavnica

STRING(<=20)

0 - bez akcije
1 - stavka je proizvod čije će komponente biti navedene u sljedećim
stavkama u import datoteci
2 - stavka je komponenta prethodno navedenog proizvoda u import datoteci

9.

Mjesto troška

STRING(<=6)

Mjesto troška

10.

D1

STRING(<=6)

Dimenzija 1

11.

D2

STRING(<=6)

Dimenzija 2

12.

D3

STRING(<=6)

Dimenzija 3

13.

Tip dokumenta

NUMERIC (3)

Tip dokumenta
 015 - priprema primke (PRP)
049 - razduženje skladišta (RAS)
051 - otpremnica (OTP)
057 - revers (REI)
059 - povrat robe od kupca (STO)
091 - izlazni račun (IFA)
099 - izlazni račun ostalo (IFD)
110 - ulazna narudžba (narudžba od kupca) (ULN)
111 - pretponuda (PON)
121 - ponuda (IZP)
122 - nalog za slaganje (SLA)

14.

ID vozila

NUMERIC

ID vozila koje treba povezati na stavku, vozilo mora postojati u registru vozila

15.

Opis stavke/usluge

STRING(5000)

Tekstualni opis koji će se importirati u napomenu stavke/opis usluge

Stavke imaju, dakle, standardni 4D Wand data port format, ali je dodano pretpolje za vezu na dokument u koji će se stavke importirati.
Naknadno je dodano i neobavezno polje Tip dokumenta po kojem se ovaj data port razlikuje od standardnog 4D Wand data port formata.
 Prilikom učitavanja podataka, ako iznosi nisu poslani, program učitava iznose iz planske kalkulacije, rabate iz rabatne politike.
 Ukoliko se šalju iznosi putem data porta potrebno je popuniti sve iznose (i bruto iznos, i neto iznos, i VP iznos i MP iznos) da bi import ispravno popunio vrijednosti po stavkama.

Serijski brojevi

Deklaracija import datoteke za automatsko učitavanje serijskih brojeva stavka iz vanjskih bar code čitača

Importira se jedna tekstualne datoteka. Predloženi naziv datoteke ima oblik SER-*.txt Npr: SER-061205.txt, SER-070404-1.txt, SER-070404-2.txt. Nije obavezno.
Kolone su odvojene točka-zarezom (;). Završetak reda je kombinacija CR+LF.
U datoteci se mogu nalaziti podaci za više dokumenata u 4D Wandu, a predviđeno je da se iz 4D Wanda ispiše dokument s bar code brojem dokumenta (npr. „Otpremnica s bar code serijskim brojevima“) pa se prva kolona importa može učitati s tog papira u čitač. Broj dokumenta se formira u dužini od 9 brojeva, od kojih prva tri predstavljaju tip dokumenta (npr. 051 za otpremnicu), a ostali broj dokumenta (npr. 000137). Ovaj način je korišten da se olakša korištenje i programiranje vanjskih čitača koji onda mogu raditi samo s jednim identifikatorom dokumenta.
Ako je na nekom dokumentu ista roba upisana više puta, import se vrši samo na prvu robu po rednom broju.
Prilikom importa program provjerava i prijavljuje grešku ako ne postoje dokument, stavka ili artikl
Prilikom importa program provjerava i preskače redak ako je već importiran.
Ako datoteka ima više kolona od ove tri propisane, iste se zanemaruju.

Opis kolona za tablicu serijski brojevi

Rb.

Serijski brojevi (SER)

1.

Dokument

STRING(9)

Tip i broj dokumenta. Npr. 051000137 označava otpremnicu (tip 051) broj 137. Obavezna vodeća nula za tipove <100

2.

Roba

STRING(<=30)

ID, šifra, kataloški ili bar code artikla iz 4D Wand (iz parametara programa)

3.

Serijski broj

STRING(<=50)

Serijski / Lot broj robe

4.

Rok trajanja

STRING(10)

Datum isteka trajanja u obliku DD.MM.GGGG (Samo ako se importira Lot broj)

5.

Količina

STRING(<=20)

Količina Lot broja (bez odvajanja tisuća, decimalni zarez ili točka). Samo ako se importira Lot broj.

Specifikacije sredstava plaćanja

Deklaracija import datoteke za automatsko učitavanje specifikacije sredstava plaćanja

Importira se jedna tekstualne datoteka. Predloženi naziv datoteke ima oblik SPS-*.txt Npr: SPS-061205.txt, SPS-070404-1.txt, SPS-070404-2.txt. Nije obavezno.
Kolone su odvojene točka-zarezom (;). Završetak reda je kombinacija CR+LF.

Opis kolona za tablicu specifikacije sredstava plaćanja

Rb.

Specifikacije sredstava plaćanja (SPS)

1.

Dokument

NUMERIC

ID dokumenta iz 4D Wanda (u export-u) ili ID dokumenta iz vanjskog sustava kojem pripada stavka. Ako se ovaj broj koristi za import broja dokumenta u 4D Wand-u onda Numeric(<=6).
 U slučaju da se specifikacija sredstava plaćanja importira naknadno u već postojeći dokument, broj dokumenta se predaje u slijedećem formatu:
TTTDDDDDD (T:numerički tip dokumenta - 119 za Specifikaciju sredstava plaćanja, D:ID Dokumenta formatiran na šest znamenki s vodećim nulama, n.pr.: 119000034
 ili u formatu TTTDDDDDDSSSSSS - 119000034000001(S:zadnjih 6 znamenki formatiranih s vodećim nulama predstavljaju redni broj stavke)

2.

Oznaka SPS

STRING(<=4)

Oznaka (šifra) sredstva plaćanja

3.

Serijski broj

STRING(<=20)

Serijski broj sredstva plaćanja

4.

Datum zaprimanja

STRING(10)

Datum zaprimanja u obliku DD.MM.GGGG

5.

Broj računa

STRING(80)

Broj računa na koji se odnosi sredstvo plaćanja

6.

Iznos

STRING(<=20)

Iznos sredstva plaćanja

7.

Realizirani iznos

STRING(<=20)

Realizirani iznos sredstva plaćanja

8.

Datum dospijeća

STRING(10)

Datum dospijeća u obliku DD.MM.GGGG

9.

Datum aktivacije

STRING(10)

Datum aktivacije u obliku DD.MM.GGGG

10.

Datum realizacije

STRING(10)

Datum realizacije u obliku DD.MM.GGGG

11.

Napomena stavke

STRING(5000)

Opis/napomena stavke, novi red u polju napomene definira se znakom "pipe" (|)

Opis postupka

Import dokumenata, stavki i serijskih brojeva radi se na sljedeći način:
Na tabeli, u ovom primjeru otpremnica, pozovite Dokument --> Import dokumenata, stavki i serijskih brojeva iz tekst datoteke (prikazano na slici ispod):

Za izbor tekst datoteke iz koje želimo importirati dokument, u ovom primjeru otpremnicu, stavke vezane za taj dokument i serijske brojeve vezane za stavke na sljedećem prozoru odaberite strelicu prema dolje kako bi ste...

... na standardnoj Windows formi odabrali putanju do datoteke npr.:

Nakon što odaberemo putanju datoteke prozor za izbor tekst datoteke izgledat će, prikazano na sljedećoj slici:

Nakon što je import uspješno izvršen u word-u će se otvoriti dokument u kojem je ispisano koji je dokument importiran u 4D Wand, te njegove pripadajuće stavke.

Napomene

Napomene za pojedine klase

Nalozi za slaganje (klasa 'SLA'; tip '122') se ne mogu dodavati nego samo ažurirati stavke postojećih. To znači da se iz 4D Wanda trebaju exportirati željeni nalozi za slaganje i zatim vratiti s upisanim složenim količinama i eventualnim serijskim brojevima. Zaglavlje naloga za slaganje nije moguće ažurirati ovim importom. Prva kolona u exportu je ID dokumenta i taj podatak se treba vratiti u import datoteci.
Pripreme primke (klasa 'PRP'; tip '015') upisuju samo količinu na stavke, a eventualno poslani iznosi se zanemaruju.

Definicije u Setupu

Za poziv procedure iz lokalnog (korisničkog) menija:
SET:Naslov upisati po želji ("Import dokumenata i stavki" ili nešto slično)
SET:Width=17
SET:XPos=26

Primjer

DOK-001.txt

00022164; 51;001300;0000101;8;09.07.2019;001;Za dodatne adresare||;01;4;PRSK;;;;004572; 51;;;;;;;978;7,450000;;;;;0;;;001696;
 00022166; 51;000920;0000101;;09.07.2019;001;Za nove licence||;01;4;PRSK;;;;004574; 51;;;;;;;978;7,450000;;;;;0;;;002274;
 00022167; 91;001300;0000101;8;09.07.2019;001;Za dodatne adresare||;01;4;PRSK;;;;004572; 91;;;;4572-4D-91;09.07.2019;09:30:46;978;7,450000;;;;;0;;;001696;;441119403-7146
 00022169; 91;000920;0000101;;09.07.2019;001;Za nove licence||;01;4;PRSK;;;;004574; 91;;;;4574-4D-91;09.07.2019;9:31:16;978;7,450000;;;;;0;;;002274;
 00022210; 91;002647;0000101;8;12.07.2019;001;Za dodatne adresare||;01;4;PRSK;;;;004578; 91;;;;4578-4D-91;12.07.2019;9:32:45;978;7,465000;;;;;0;;;008695;
 

STA-001.txt

00022164;488;2,000;223,50;0,00;201,70;252,13;;;;;;51;0;
 00022166;491;1,000;372,50;0,00;336,18;420,23;;;;;;51;0;
 00022167;488;2,000;223,50;0,00;201,70;252,13;;;;;;91;0;
 00022169;491;1,000;372,50;0,00;336,18;420,23;;;;;;91;0;
 00022210;488;15,000;1679,70;0,00;1515,90;1894,88;;;;;;91;0;
 

SER-001.txt

00022164;488;3854156548875
00022164;488;3854156548665
00022166;491;2515005754548
00022167;488;2515005654877
00022167;488;2515008879874
00022169;491;2515021215488
 

SPS-001.txt

36950;ČBJE;131313;12.05.1984;BRRAČ;1525.25;1000.25 ;14.01.2013;14.01.2013;16.01.2013;Napomena broj 1
36950;ČBJE;131313;13.05.1984;BRRAČ;1525.25;1000.25;15.01.2013;14.01.2013;17.01.2013;Napomena broj 2|U dva reda
36950;ČBJE;131313;14.05.1984;BRRAČ;1525.25;1000.25;16.01.2013;14.01.2013;18.01.2013;Napomena broj 3|je|u tri reda
 

SPS-NaknadniImport.txt - primjer za import u neodobren dokument koji postoji od ranije

119010001;GOTO;01234567890123121;31.12.2018;78976546541232132;1200;1199;30.12.2018;29.12.2018;28.12.2018;Napomena na stavci SPS


*** Napomena - upute se mogu razlikovati u slikama i tekstu od sadržaja koji se nalazi na vašem računalu, ovisno o inačici 4D Wanda koju trenutno koristite. Posljedica je to stalnog razvoja i nadogradnje 4D Wanda, a koji iz objektivnih razloga dinamikom ne prati i nadogradnja modula Upute. Posebno se to odnosi na zamjenu službene valute RH kuna (kn) u euro (€) i njen prikaz u uputama.