Kompakt ZOLL interface leírás

Kompakt ZOLL interface leírás rendszerleírás a KZOLL rendszer fogadó interface-éről.

Kompakt ZOLL interface leírás verzió:

3.45

Jelen dokumentum aktuális verziója elérhető a www.vamsoft.com/kzoll/docs.asp oldalon!

Vamsoft Kft. 2001-2006

1

Meghatározás Az adatkapcsolati modul feladata, hogy más vállalatirányítási rendszerből, elsősorban vámeljárással kapcsolatos, adatokat vegyen át a Kompakt Zoll V5 rendszerbe. Ezzel próbáljuk meg gyorsítani a vállalat működését, illetve elkerülni azt, hogy egy adatot mindkét rendszerben fel kelljen vinni és az ebből adódó hibázási lehetőségeket. Az adatkapcsolati modul valamilyen, mindkét rendszer számára elérhető, közös tárhelyről beolvassa az adatokat, amelyet a másik rendszer átad a Kompakt Zoll V5 rendszerébe.

Modell Az adatkapcsolati modul két részből áll. Az első rész cégre szabott. Erre azért van szükség, mert cégenként változik annak módja, hogy hogyan, milyen formában állnak rendelkezésre az adatok. A program az első lépés során az adatokat átalakítja MIME formátummá. Ezek után megjelenik a feldolgozandó adatok között. Ekkor még nem készültek a konkrét import, export számlák stb. A második lépés, hogy az elkészült MIME forrást feldolgoztatjuk a programmal. Ennek során a program elkészíti az export, import számlákat.Az adatkapcsolati modul jelenleg a következő input adattípusokat (file szintű) támogatja: • CSX file-ok(ajánlott) • CSV file-ok • ASC file-ok • XML file-ok • DBF file-ok emellett támogatjuk bármelyik adatbázis szervert is, amennyiben biztosítani tudják részünkre az ODBC-s elérést.

Kompakt ZOLL adatfogadás A Kompakt ZOLL a következő adatok fogadására képes: 1. part item (cikktörzs) 2. import invoices (import számlák) 3. export invoices (export számlák) 4. warehouse out-store (raktári kitár) 5. finished goods (BOM) (késztermék) 6. Szállítói rendelések 7. firm item(partnertörzs) Általánosan: Minden rekordhoz, 2 "egyéb információ" mezőt is adhatunk át a Kompakt ZOLL rendszernek. Ezek a kötetlen formájú mezők (típus: Char 35, név xxx_other1, xxx_other2) és minden rekord esetén rendelkezésre állnak. Ezek a mezők letárolásra kerülnek a KZOLL rendszerben. A szükséges mezőket tartalmaznia kell a filenak, amennyiben ezek nincsenek meg, az adatkapcsolat nem olvassa be az adatokat. A fontos mezők azt jelentik, hogy feldolgozás szempontjából szükséges adatokról van szó, ezek nélkül nem teljesértékű az adat - ezeket az importálás után kézzel kell kitölteni a KZOLL rendszerben, amennyiben üresek.


2

Minden cikket, amely szerepel az adatcsomagban, mellékelni kell a csomaghoz (ez lehet ugyanazon csomagban is). Amennyiben nem található a meghatározott cikk az adatcsomagban, úgy azt egy külön file-ban mellékelni kell. Azokat a mezőknek, amelyeknek a feldolgozó program nem találja a KZOLL megfelelőjét, figyelmen kívül hagyja. Ezeknek a fileloknak a következő rekord-struktúrával kell rendelkezniük:


3

1::Cikk (Part Item) szerkezet :: cikk (part) megjegyzés: ha a cikk már létezik, tehát már van ilyen cikkszámú cikk, akkor nem viszi fel, és a naplóban jelzi a hibát. Mezőnév

mező típusa

mező leírása

szükséges

fontos

part_id

Cikk azonosító(cikkszám)

*

*

Part_descr

Char 50 egyedi azonosító Char 50

Cikk leírása

*

Part_commcode

Char 10

Vámtarifaszám

*

Part_unit

*

Part_tariffn

Char 10 Mennyiségi egység Ha nincs ilyen mennyiségi egység akkor létrehozzuk. Numeric Nettó tömeg Pl. 12.1234, 0.7 Char 35 Egyéb1 Szabadon választott adat tárolására használható mező Char 35 Egyéb2 Szabadon választott adat tárolására használható mező Char 50 Tarifális megnevezés

Part_corgn

Char 2

Származási ország

*

Part_currency

Char 3

Devizanem

*

Part_price

part_royalty

Numeric Egységár Pl. 12.1234, 0.7 Numeric Áregység Megadható, hogy az ár hány darabra vonatkozik Char 35 Azonosító Másodlagos azonosító Char 35 Royalty

part_id2

Char 35

Cikkszám 2

part_descr2

Char 35

Cikknév 2

part_descr3

Char 35

Cikknév 3

part_ecode1

Char 3

Körny.term.díj kód 1

part_ecode2

Char 3

Körny.term.díj kód 2

part_ebase1

Numeric

Körny.term.díj alap 1

part_ebase2

Numeric

Körny.term.díj alap 2

part_edivmode1

Int

Körny.term.díj alap 1 számítás

Part_netw Part_other1 part_other2

Part_priceu part_indentify

*

1 – megadott érték 2 – bruttó-nettó 3 – nettó x%-a


4

Mezőnév

mező típusa

mező leírása

part_edivmode2

Int

Körny.term.díj alap 2 számítás

part_epercent1

part_epercent2

part_county

szükséges

fontos

1 – megadott érték 2 – bruttó-nettó 3 – nettó x%-a Numeric Körny.term.díj alap 1 százalék Csak ha part_edivmode1 = 3 Numeric Körny.term.díj alap 2 százalék Csak ha part_edivmode2 = 3 Char 3 Származási ország tartománykód

part_pref

Char 5

Preferencia

part_tax

Áfa kód

part_grossw

Char 3 Pl. 625 Numeric

Bruttó tömeg

part_order

Char 35

Szerződés azonosító

part_CanModify

part_alc_pct

Char 1 Számlán módosítható T –módosítható F –nem módosítható Numeric Alkohol %

part_alc_quant

Numeric

Alkohol mennyisége

part_group

Char 10

Cikkcsoport azonosító

part_volume

numeric

Töltő térfogat

part_volume_unit

Char 10

Töltőtérfogat mennyiségi egysége

part_sale_price

Numeric

Eladási ár

part_sale_curr

Char 3

Eladási ár devizanem

XML példa(1 rekord): filenév cikk.xml <part> <part_id>x0001107037 <part_descr>STA BOSCH <part_commcode>8511900001 <part_unit>DB <part_netw>0.0

CSV példa (4 rekord): filenév cikk.csv SGH-2400DA/WST;SGH-2400DA/WST,MAIN SET;8525209900;DB;0.065; SGH-2400GA/WST;SGH-2400GA/WST,MAIN SET;8525209900;DB;0.065; PD-M120VE-00;PCB-MODEL,ASM120VE;;PCE;0.000; PD-M120VE-01;PCB-MODEL,ASM070VE;;PCE;0.000;


5

2:: Szállítói számla (Import Invoices) szerkezet :: szállítói számla fej (inv) mezőnév

mező típusa

inv_id

inv_no

Char 35 Egyedi számlaazonosító * * Amennyiben a számlaszám egyedi akkor használható itt. Ha nem akkor egy egyedi azonosítót kell megadni. Char 30 Számlaszám * *

inv_supplier

Char 35

Eladó azonosító

*

inv_customer

Char 35

Vevő azonosító

*

inv_date

Date

Számla kelte

*

inv_netwt

Numeric

Össz nettó tömeg(kg)

inv_grosswt

Numeric

Össz bruttó tömeg(kg)

inv_currency

Char 3

Devizanem (ISO)

inv_pricet

*

inv_parcountry

Numeric számlaérték A megadott devizanemben Char 3 paritáskód Incoterms Char 2 Paritás ország(ISO)

inv_parplace

Char 20

paritáshely

*

inv_taxinc

Numeric

Vámérték növelő

*

inv_vatinc

Numeric

ÁFA növelő érték

*

inv_incstat

Inv_dutym

Char 2 Osszuk-e tételre a vámérték növelő és az áfanövelő értéket OK – Igen NO – Nem Char 2 számla tipusa Nem használt Char 35 Egyéb1 Szabadon választott adat tárolására használható mező Char 35 Egyéb2 Szabadon választott adat tárolására használható mező Char 1 Osztás módja 1 – nettó tömeg szerint 2 – bruttó tömeg szerint 3 – érték szerint Char 30 Feladó azonosító Ha üres akkor az eladó azonosítója kerül bele Char 35 Címzett azonosító Ha üres akkor a vevő azonosítója kerül bele Char 35 Vámkezelő azonosító

Inv_order

Char 35


Inv_transtype

Char 2

Ügyletfajta kód

Inv_transport

Char 2

Külf. Fuvarozási mód

Inv_ForceCheck

Char 1 Számla ellenőrzése Értéke T vagy F. Lassú, de a számla egyből FV státuszba kerülhet.

inv_parcode

inv_type inv_other1 inv_other2 inv_incmode

inv_sender inv_shipto


mező leírása

szükséges

fontos

*

*

6

Inv_Owner

Char 35

Tulajdonos

szerkezet :: szállítói számla tétel (inv_d) mezőnév inv_d_id inv_d_part inv_d_price

mező mező leírása típusa Char 35 Egyedi számlaazonosító u.a. mint a fej adatnál (inv_id) Char 50 Cikk azonosító

Szüksé -ges *

fontos * *

*

inv_d_unit

Numeric Tételérték = érték * mennyiség Numeric Mennyiség Abban a mennyiségi egységben ami a cikktörzsben adott Char 10 Mennyiségi egység

inv_d_corgn

Char 2

*

inv_d_torgn

inv_d_prefno

Char 3 Származási tartomány Ha a származási ország DE, RU, ES Char 20 Preferencia okmány EUR1, BSZ, SZNY Char 20 Preferencia száma (EUR1 esetén)

inv_d_netw

Numeric

Nettó tömeg

inv_d_grossw

Numeric

Bruttó tömeg

inv_d_taxinc

Numeric

Vámérték növelő

*

inv_d_vatinc

Numeric

ÁFA növelő érték

*

inv_d_supplierno

Char 20

Beszállító kódja

inv_d_supplierdocno

Char 20

Szállítólevél száma

inv_d_uniqueID

Char 35 Egyedi tétel azonosító Amennyiben tétel szerinti kivételezés szükséges, itt kell megadni azt az azonosítót, amire a későbbiekben hivatkozni fogunk. Char 35 Besorolás meghatározása Char 35 Egyéb1 Szabadon választott adat tárolására használható mező Char 35 Egyéb2 Szabadon választott adat tárolására használható mező Numeric KT alap1

inv_d_quantity

inv_d_prefo

inv_d_beso_azon inv_d_other1 inv_d_other2 Inv_d_ebase1 inv_d_ecode1

Inv_d_ebase2


Származási ország (ISO)

*

*

Char 3 KT kód 1 Ha nincs kitöltve sem ez, sem az alap, akkor a ciktörzsből veszi az adatokat Numeric KT alap 2

7

Inv_d_ecode2

inv_d_passivecustomsduties

Char 3 KT kód 2 Ha nincs kitöltve sem ez, sem az alap, akkor a ciktörzsből veszi az adatokat Numeric Statisztikai érték módosító érték Intrastat jelentéshez szükséges adat Char 2 Értékelési mód kód Numeric Passzív vámteher

inv_d_passiveworkfee

Numeric

Passzív feldolgozás díja

inv_d_passiveaddedvalue

Numeric

Passzív hozzáadott érték

inv_d_passivecurrency

Char 3

Passzív devizanem

inv_d_StoragePlace

Char 50

Tárolási hely

Inv_d_StatPriceMod Inv_d_evaltype

XML példa: BE1014661 456/2001 XIKA 01Eng 2001-04-20 EUR BE1014661 1000301056 34.2 100.0 DB 0.0 BE1014661 BS161 87.4 100.0 DB 0.0 BE1014661 BS162 131.1 150.0 DB 0.0 BE1014661 BS157 243.2 200.0 DB 0.0

CSV példa(4 rekord): filenév inv_fej.csv 0090003857;0090003482;SEH;BOLIY;2004-02-25;;;USD;1480.00;FCA;HU;FCA Váchartyán;;;; 0090003858;0090003485;SEH;BOLIY;2004-02-25;;;EUR;96.00;FCA;HU;FCA Váchartyán;;;;


8

0090000682;0090000682;SEH;LIBRA;2004-02-24;;;EUR;20400.00;CIP;AT;;;;; 0090000712;0090000622;SEH;SEUK;2004-02-24;;;GBP;1170.00;CIP;FR;;;;;

filenév inv_tet.csv 0090003857;CK531FT0X/XEK;480.00;96.000;DB;HU;;;;2016.000;2208.000;;;;;; 0090003857;CK5073T0X/XEK;500.00;100.000;DB;HU;;;;1800.000;2000.000;;;;;; 0090003857;CK501FT0X/XEK;500.00;100.000;DB;HU;;;;1750.000;2000.000;;;;;; 0090003858;CK531FT0X/XEK;96.00;96.000;PCE;HU;;;;2016.000;2208.000;;;;;; 0090000682;CK5344WX/LIB;20400.00;50.000;PCE;HU;;;;23.000;25.000;;;;;; 0090000712;CI683CNX/XEU;1170.00;0.000;DB;HU;;;;0.000;0.000;;;;;;


9

3:: Vevői számla (Export Invoices) szerkezet :: vevői számla fej (inve) mező neve inve_id

inve_no

mező típusa mező leírása Char 35 Egyedi számla azonosító Amennyiben a számlaszám egyedi akkor használható egyedi azonosítót kell megadni. Char 35 számlaszám

inve_supplier

Char 35

Eladó azonosítója

*

inve_customer

Char 35

Vevő azonosítója

*

inve_shipto

Char 35

Címzett azonosító

*

inve_netwt

Numeric

Össz nettó tömeg (kg)

inve_grosswt

Numeric

Össz bruttó tömeg (kg)

inve_currency

Char 3

Devizanem (ISO)

inve_pricet

*

inve_parcountry

Numeric Össz érték Az adott devizanemben Char 3 Paritáskód Incoterms Char 2 Paritás ország (ISO)

inve_parplace

Char 20

*

inve_type

Char 2 számla tipusa EP – Export proforma számla ES – Export számla – alapértelmezett, ha nincs töltve BS – Belföldi számla BL – Belföldi szállítólevél

inve_parcode

inve_other1 inve_other2 inve_date inve_taxinc

szükséges fontos * * itt.Ha nem akkor egy *

Paritáshely

Jelenleg nem használt. Char 35 Egyéb1 Szabadon választott adat tárolására használható mező Char 35 Egyéb2 Szabadon választott adat tárolására használható mező Date Számla kelte

Inve_dutym

Numeric Vámérték növelő tényező HUF - ban Char 35 Feladó azonosító Ha üres akkor a eladó azonosítója kerül bele Char 35 Vámkezelő azonosító

Inve_comment

Char 250

Megjegyzés

Inve_order

Char 35


Inve_ForceCheck Inve_pocket

Char 1 Számla ellenőrzése Értéke T vagy F. Lassú, de a számla egyből FV státuszba kerülhet. Numeric Csomagszám

Inve_transtype

Char 2

inve_sender


*

*

*

*

* *

Ügyletfajta kód

10

Inve_transport

Char 2

Külf. Fuvarozási mód

szerkezet :: vevői számla tétel (inve_d) Mezőnév inve_d_id inve_d_part inve_d_price

mező típusa mező leírása Char 35 Egyedi számlaazonosító u.a. mint a fej adatnál Char 50 Cikk azonosító

szükséges *

fontos *

*

* *

inve_d_unit

Numeric Tételérték = érték * mennyiség Numeric mennyiség Abban a mennyiségi egységben ami a cikktörzsben adott Char 10 Mennyiségi egység

inve_d_corgn

Char 2

*

inve_d_torgn

inve_d_prefno

Char 3 Tartománykód Ha a származási ország DE, RU, ES Char 20 prefrencia EUR1, BSZ, SZNY Char 20 Preferencia száma(EUR1 esetén)

inve_d_netw

Numeric

Nettó tömeg

inve_d_grossw

Numeric

Bruttó tömeg

inve_d_mattype

Char 4 Anyag típusa AA – alapanyag KT – késztermék Nem használt mező! Char 35 Egyedi azonosító

inve_d_quantity

inve_d_prefo

inve_d_ uniqueID inve_d_beso_azon inve_d_method

inve_d_inv_d_uniqueID inve_d_other1 inve_d_other2 inve_d_discount inve_d_workord inve_d_StatPriceMod


Származási ország (ISO)

*

*

Char 35 Besorolás meghatározása Char 4 Meghatározza, hogy milyen formában, elven történjen az anyag levétele Lehetséges értékek: CIKK – cikk szerinti kivét KSZC – készleten levő cikk szerinti kivét KSZV – meghatározott bevét alapján. Ekkor a inve_d_part mezőben nem cikkszám, hanem az import számla tételnél megadott azonosítóból (inv_d_uniqueID) vesszük le a megadott mennyiséget. Char 35 Bevételezés azonosítója Ha inve_d_method = KSZV Char 35 Egyéb1 Szabadon választott adat tárolására használható mező Char 35 Egyéb2 Szabadon választott adat tárolására használható mező Numeric Engedmény Char 20 Munkaszám Utólagos alapanyaglista felvitelhez Numeric Statisztikai érték módosító érték Intrastat jelentéshez szükséges adat

11

XML példa: SZ100182 SZ100182 XDR Belg XDR Belg 319.6 0.0 BEF 1845.0 SZ100182 0001107043 420.0 20.0 DB 94.0 0.0 SZ100182 0001107045 980.0 28.0 DB 131.6 0.0

CSV példa(4 rekord): filenév inve_fej.csv 0090003857;0090003482;SEH;BOLIY;BOLI;;;HUF;1480.00;FCA;HU;FCA Váchartyán; 0090003858;0090003485;SEH;BOLIY;BOLI;;;JPY;96.00;FCA;HU;FCA Váchartyán; 0090000682;0090000682;SEH;LIBRA;LIBRA;;;DEM;20400.00;CIP;AT; 0090000712;0090000622;SEH;SEUK;SEUK;;;GBP;1170.00;CIP;HU;

filenév inve_tet.csv 0090003857;CK531FT0X/XEK;480.00;96.000;DB;HU;;;;2016.000;2208.000;; 0090003857;CK5073T0X/XEK;500.00;100.000;DB;HU;;;;1800.000;2000.000;; 0090003857;CK501FT0X/XEK;500.00;100.000;DB;HU;;;;1750.000;2000.000;; 0090003858;CK531FT0X/XEK;96.00;96.000;PCE;HU;;;;2016.000;2208.000;; 0090000682;CK5344WX/LIB;20400.00;50.000;PCE;HU;;;;23.000;25.000;; 0090000712;CI683CNX/XEU;1170.00;0.000;DB;HU;;;;0.000;0.000;;


12

4::Raktári kitár (Warehouse out-store) szerkezet :: raktári kitár fej (otst) mező neve otst_id

mező típusa Char 35

mező leírása Egyedi azonosító

otst_customer

Char 35

Vevő azonosító

otst_shipto

Char 35

Címzett azonosító

otst_supplier

Char 35

Eladó azonosító

otst_parcode

Char 3

Paritás kódja

otst_parplace

Char 35

Paritás helye

otst_parcountry

Char 2

Paritás országa

otst_carrysign

Char 35

Szállítóeszköz rendszáma

otst_carrycountry

Char 2

Szállítóeszköz honossága

otst_order

Char 35


otst_other1

Char 35

Egyéb1

otst_other2

Char 35

Egyéb2

otst_date

Char 35

Felvitel dátuma

otst_pricet

Numeric

Devizaérték

otst_currency

Char 3

Devizanem

otst_netwt

Char 35

Nettó tömeg

otst_divnet

Char 1 Osztás módja Súly vagy tétel szerint osszuk-e Char 35 Bruttó tömeg

otst_grosswt otst_divgross otst_pocket otst_divpocket otst_priceset otst_netwset otst_grosswset otst_pocketset otst_sender otst_dutym

szükséges *

fontos *

*

Char 1 Osztás módja Súly vagy tétel szerint osszuk-e Numeric Csomagszám Char 1 Osztás módja Súly vagy tétel szerint osszuk-e Char 1 Megadtuk-e a devizaértéket T vagy F Char 1 Megadtuk-e a nettó tömeget T vagy F Char 1 Megadtuk-e a bruttó tömeget T vagy F Char 1 Megadtuk-e a csomagszámot T vagy F Char 35 Feladó azonosító Ha üres akkor a eladó azonosítója kerül bele Char 35 Vámkezelő azonosító


* * * *

13

otst_Description

Char 35

Megnevezés

otst_InvoiceNo

Char 50

Számlaszám

Otst_owner

Char 35

Tulajdonos azonosító

szerkezet :: raktári kitár tétel (otst_d) mező neve otst_d_id

mező típusa Char 35


szükséges *

fontos *

otst_d_beso_azon

Char 10

Besorolás

*

*

otst_d_type

Char 35 Kivételezés módja KSZC – Cikk szerinti kivételezés(FIFO)

*

*

otst_d_quantity

KSZV – Megadott bevét alapján Char 35 KSZV esetén A bevételezés azonosítója Char 35 KSZC esetén A cikk azonosítója numeric Mennyiség

otst_d_price

numeric

Devizaérték

otst_d_netw

numeric

Nettó tömeg

otst_d_grossw

numeric

Bruttó tömeg

otst_d_pocket

numeric

Csomagszám

otst_d_other1

numeric

Egyéb1

otst_d_other2

numeric

Egyéb2

otst_d_uniqueid

numeric

Egyedi kivét tétel azonosító

otst_d_markup

numeric

Haszonkulcs

otst_d_charge

numeric

Költség

otst_d_charge_markup

numeric

Forgalmazó haszonkulcsa

otst_d_sale_curr

Char 3

Eladási devizanem

otst_d_unique_id otst_d_part

XML példa: 00000001 ISS-WO 2001-04-19 00000001 KSZC 1000301061 100.0


14

00000001 KSZC 134658 200.0 00000001 KSZC 2000301036 200.0 00000001 KSZC 3801D 150.0 00000001 KSZC 3865D 150.0

CSV példa(4 rekord): filenév otst_fej.csv 4900201932;CUST;;;;;;;;;;;2001-03-01;;;;;;;;F;F;F;F 4900201933;CUST;;;;;;;;;;;2001-03-01;;;;;;;;F;F;F;F 4900201934;CUST;;;;;;;;;;;2001-03-01;;;;;;;;F;F;F;F

filenév otst_tet.csv 4900201932;BS12;KSZV;1204-001634;;50.000; 4900201932;BS12; KSZV;AA09-00116A;;50.000; 4900201933;BS13; KSZV;AA26-30001Y;;20.000; 4900201934;BS12; KSZV;1204-001634;;50.000;


15

5::Késztermék (Finished Goods) Általános információk: a gyártás során , a késztermék elkészültének 5 lehetséges módozatát különböztetjük meg. Ezek a következők: (Fg_type) NO: Norma átadás. Ekkor csak egy késztermék alapanyagnormájának tekintjük a kapott adatot.Semmi féle készletvéltozás nem történik. NA: Norma alapján történő lejelentés. Ekkor a kapot adatot egy gyártási lejelentésnek vesszük, és a megadott norma alapján megtörténik az alapanyagkészlet csökkentése. K1: Csak késztermék készül el, nem norma alapján. A tényleges alapanyagfelhasználás csak később kerül át a rendszerbe. K2: Elkészült a késztermék és a tényleges alapanyagfelhasználás is átadásra kerül. K3: Csak a tényleges alapanyag felhasználás jön át, amely a munkaszám alapján össze lesz kapcsolva a K1-kel. szerkezet :: késztermék fej (fg) mező neve mező típusa Fg_id Char 35 Termék kódja Fg_part Char 35


szükséges *

fontos *

Késztermék cikkszáma

*

*

Fg_quantity

Numeric

Fg_type

Fg_workord

Char 2 Késztermék típúsa Az elkészülés módja Numeric Nettó tömeg Opcionális Char 2 Jelen pillanatban nem használatos. Char 35 Rendelésszám(munkaszám)

Fg_normid

Numeric

Fg_beso_azon

Char 35 Alapanyag besorolás meghatározása Char 35 Késztermék besorolás meghatározása

Fg_netw Fg_movementcode

Fg_beso_azon2

Mennyiség

fg_d_unit

Char 10

fg_d_type

Char 2 Beépülés típusa AA – alapanyag, MD – munkadij(költség) Numeric Nettó tömeg

fg_d_method

*

*

Elszámolási norma száma

szerkezet :: Késztermék tétel (fg_d) mező neve mező típusa mező leírása fg_d_id Char 35 Egyedi azonosító u.a. mint a fejnél fg_d_part Char 50 cikkszám Beépülő cikk cikkszáma fg_d_quantity Numeric mennyiség

fg_d_netw

*

szükséges *

fontos *

*

* *

Mennyiségi egység

* *

*

Char 10 Alapanyag felhasználás Az alapanyag kivételezésének módja. Ha üres (alapértelmezett) vagy értéke "FIFO", akkor FIFO módszerrel csökkenti az alapanyag készletet, ha értéke "IT", akkor az fg_d_part mezőben nem cikkszám, hanem import számla tétel azonosító (inv_d_uniqueID) található.


16

XML példa: vr1013971 0001107043 20.0 vr1013971 1000301056 20.0 DB AA vr1013971 1000917004 20.0 DB AA vr1013971 BS161 40.0 DB AA


17

6::Partner (Firm Item) szerkezet :: partner (firm) megjegyzés: ha a partner már létezik, tehát már van ilyen azonosítójú partner, akkor nem viszi fel, és a naplóban jelzi a hibát. Mezőnév

mező típusa

firm_id firm_name

Char 50 partner azonosító * * egyedi azonosító, ezt használjuk a két rendszer közötti kapcsolattartásra Char 50 Partner neve *

firm_city

Char 20

Város

firm_zip

Char 10

Irányítószám

firm_address

Char 50

Cím (utca, házszám)

firm_taxno

Char 50

Adószám

firm_phone

Char 15

Telefonszám

firm_fax

Char 15

Faxszám

firm_country

Ország

firm_territory

Char 2 ISO szabvány. Char 3

Tartománykód

firm_garantno

Char 10

Garancia száma

firm_email

Char 30

Email cím

firm_firmno

Char 20

Cégjegyzék száma

firm_other1

Char 35 Egyéb1 Szabadon választott adat tárolására használható mező Char 35 Egyéb2 Szabadon választott adat tárolására használható mező

firm_other2


mező leírása

szükséges

fontos

18

Szükséges fileformátum Mezőtípusok: mezőtípus Numeric

Date Char

formátum Négy tizedesjegyig tartalmazhat számot (kivéve ahol másként van jelölve). Ezres elválasztó nincs, a tizedeselválasztó egy pont"." éééé-hh-nn Maximálisan használható karakterek száma megadott.

megjegyzések -

példa: 2000-10-15 Az adat “trimmelve” lesz (az elejéről és a végéről a szóközök levágva)

Névkonvenciók (pl.csv esetén. Természetesen más kiterjesztés esetén is, az előtag ugyanaz):

Cikktörzs – cikk.csv Import számlafej – inv_fej.csv Import számlatétel – inv_tet.csv Export számlafej – inve_fej.csv Export számlatétel – inve_tet.csv Anyagbeépülés fej – fg_fej.csv Anyagbeépülés tétel – fg_tet.csv Raktári kitár fej – otst_fej.csv Raktári kitár tétel – otst_tet.csv Partnertörzs – firm.csv megjegyzés: a file nevek után rakhatunk egy egyedi azonosítót, sorszámot, elkerülvén, hogy több ugyanolyan file legyen egy könyvtárban. Ennek jelentősége abban rejlik, hogy a felhasználó is meg tudja különböztetni az adatokat egymástól. Pl. cikk23.csv, inv_fej45.csv-inv_tet45.csv

Mely verziót ajánljuk? Mi két alternatívát tudunk ajánlani az adatkapcsolat működésére. Az egyik a file szintű adatkapcsolat: ekkor az adatokat file-okban kapjuk meg. Ez esetben a CSV(pontosvesszővel elválasztott adatok) file-t ajánljuk, mivel ennek a formátuma egyszerű, illetve könnyen feldolgozható. Hátránya, hogy könnyen sérülhet a file illetve, hogy törölhetik stb. Másik hátránya, hogy egy CSV file csak egy fajta adathalmazt tartalmazhat, pl. cikktörzs. A másik alternatíva az adatbázis elérés: ebben az esetben az adatokat egy, a cég által használt, adatbázisból vesszük (pl. Progress), ODBC driver-en keresztül. Az ODBC driver-t a cégnek kell biztosítani. Előnye, hogy biztonságos, mivel jogokkal lehet felruházni azt a felhasználót, aki hozzáférhet az adatokhoz. Hátránya, hogy nem “ismert” adatbázis szerver esetén, több munkaórát igényel a modul fejlesztése, illetve beüzemelése.


19

ADO- s adatelérés Az ADO- s adatelérés, az egyik leg biztonságosabb és legkönnyebben élérhető módja az adatok átadásának egyik rendszerből a másikba. A Kompakt Zoll V5 egy egységes plugint dolgozott ki az ADO-s elérésre, ennek következményeként eléggé kötött az az adatformátum amit elvár. Ez a következő kéépen épül fel: az adatbázisban létre kell hozni egy VSI_TABLE nevű táblát, a következő szerkezettel: vsi_table: mezőneve Id trans_seq cdata_type trans_type

rendeltetése egyedi azonosító a rendszerben futó sorszám az átadott adat típusa: csv, csx, xml csv esetén az adatcsomag fajtája:

megjegyzések az ügyfél tölti az ügyfél tölti az ügyfél tölti az ügyfél tölti

cég- firm cikk - part import számla fej - inih import számla tétel - inid export számla fej - ineh export számla tétel - ined finish goods fej - figh finish goods tétel -figd raktári kitár fej - outh raktári kitár tétel - outd trans_status

a feldolgozás státusza: OK, ER,

a vamsoft tölti

errorcode

a hiba kódja és szövege

createddate processeddate c_data

átadás dátuma feldolgozás dátuma adatcsomag

ha a feldolgozás során hiba fordulna elő. A vamsoft tölti. az ügyfél tölti a vamsoft tölti az ügyfél tölti

A pluginnál elvégzendő beállítások(Adatkapcsolat/ Pluginok menüpont): Provider=OraOLEDB.Oracle User ID=system Password=manager Étrtelemszerűen a kacsacsőrös rész átirandó. A vsi_table létrehozásának sql-je(Oracle): CREATE TABLE VSI_TABLE( id varchar2(35) not null, trans_seq number not null, cdata_type varchar2(3), trans_type varchar2(4), trans_status varchar2(2), errorcode varchar2(255), createddate date, proseseddate date, c_data clob);

create index vsi_primary ON VSI_TABLE(trans_seq); create index vsi_voucherid ON VSI_TABLE (id,trans_status,createddate);


20

CREATE SEQUENCE "VSI_SEQ" INCREMENT BY 1 START WITH 1 MAXVALUE 1.0E28 MINVALUE 1 NOCYCLE CACHE 20 NOORDER; Természetesen a mezőtípusok , az adatbázis kezelő függvényében, változhatnak!

A CSX fileformátum Az eddigi használat során felmerült az igény egy összetettebb fileformátumra. Erre azért volt szükség mert ha CSV file-okat adunk át akkor, ahány interface, annyi file(tételek nélkül). Elkerülvén a temérdek file használatát létrehoztunk egy file formátumot, amely képessé teszi a csv file-ok egy fileba való összegyúrását. Ez a következő képpen történik: A csx file tulajdonképpen több csv file egymás alá rakva, azzal a külömbséggel, hogy bejön a sor első adataként egy 4 betűs azonosító, amely azt htározza meg, hogy milyen interface-ről van szó. A négybetűs rövidítés után jön egy pontosvessző, majd a már csv-ből ismert adatsorozat. A 4 betűs rövidítések a következők lehetnek: cég- firm cikk - part import számla fej - inih import számla tétel - inid export számla fej - ineh export számla tétel - ined finish goods fej - figh finish goods tétel -figd raktári kitár fej - outh raktári kitár tétel - outd Példa a CSX file-ra: PART;SGH-2400DA/WST;SGH-2400DA/WST,MAIN SET;852520-99-00;EA; PART;SGH-2400GA/WST;SGH-2400GA/WST,MAIN SET;852520-99-00;EA; INIH;3019;00023520;400802;19;2001-12-17;;;GBP;16650;;;;;;;;APA;; INIH;3020;00283098;135501;19;2001-12-13;;;USD;3600;;;;;;;;APA;; INIH;3021;013405-131;194;19;2001-12-13;;;JPY;7600;;;;;;;;APA;; INID;3019;48386033;16650;45000;pcs;;;;;;;;;400802;368125;;APA;; INID:3020;42090027;3600;18000;pcs;;;;;;;;;135501;367921;;APA;; INID;3021;30606811;7600;4000;pcs;;;;;;;;;194;367911;;APA;;

0.065; 0.065;

Az adatkapcsolat beüzemelése Ahhoz, hogy az adatkapcsolat működjön a következő beállítások elvégzésére, van szükség: 1. lépés: attól függően, hogy mely változatát (CSV, ASC, XML) használjuk, az adott DLL file-t, egy tetszés szerinti könyvtárba másoljuk.

2. lépés: az Adatkapcsolat modul, Plugin-ok menüpontjában fel kell vinni az adott plugint, hogy a program használni tudja. Az új elem gombra kattintva a következő értékeke kell megadni: Modul neve: válasszuk ki a nekünk kellő típust. Pl: CSV Plugin Modul helye: a Tallóz gombbal válasszuk ki a DLL file helyét. !Fontos! A DLL file-t az Alkalmazásszerver használja, ezért annak a gépnek a filerendszerében kell megadni. Erre a legjobb módszer, ha az Alkalmazásszervert futtató gépen elindítunk egy Kliens-t, és ott végezzük el a fent leírt lépést.


21

Beállítások: itt tudjuk megadni, hogy pl. mely könyvtárból olvassa fel az adatokat. (Pl. workdir=c:\adka) Szintén itt tudjuk megadni, hogy melyik interface mely besorolást használja. (pl. fg_beso_azon=3, inve_beso_azon=sd3). A használható besorolások: inv_beso_azon, inve_beso_azon, fg_beso_azon, otst_beso_azon

Az adatkapcsolat használata Amennyiben megtörténtek a beállítások, úgy készen áll a Kompakt Zoll V5 arra, hogy fogadja az adatokat. Az első lépés, hogy a másik rendszer adatait beolvassuk a Kompakt Zoll V5 adatbázisába. Ezt, a Adatkapcsolat modul, Feldolgozandó adatok menüpontban tudjuk megtenni. Az ablak jobb oldalán láthatóak azok a formátumok, amelyeket a program támogat: pl. CSV file-ok. Ha itt megnyomjuk a kívánt gombot, akkor feljön egy listaablak. Ebben a listaablakban tekinthetőek meg az átvehető adatok. Itt dupla egérkattintással vagy a space billentyű megnyomásával tudjuk kijelölni, hogy mely adatokat szeretnénk beolvasni. Ha kiválasztottuk a megfelelő adatokat, akkor még adnunk kell egy nevet is a feldolgozandó adatoknak(később ez a név fog megjelenni a listában). Ha ez is megvan, akkor kattintsunk a Beolvasás gombon. Ekkor a program beolvassa az adatokat és, átalakítja MIME formátummá. Természetesen a forrásadatokat is külön eltárolja, a program saját adatbázisába, az utólagos ellenőrzés végett. A második lépés, hogy a létrejött MIME csomagot feldolgoztassuk. Ehhez elég, ha ráállunk a kívánt csomagra és megnyomjuk, jobb oldalon, a Feldolgozás gombot. Az Alkalmazásszerver ekkor elindít egy programot, amely elkezdi feldolgozni az adatokat. A feldolgozás eredményéről a Feldolgozandó adatok lista “S” oszlopából tudunk tájékozódni. A státuszok a következők lehetnek: PR – feldolgozás alatt van ER – a feldolgozás során hiba történt, nem sikerült befejezni a feldolgozást OK – a feldolgozás véget ért és sikeres volt


22

Mi a teendő ha hiba történt a feldolgozás során? Mindenek előtt menjünk be az Adminisztráció, Napló menüpontba. Itt válasszuk ki az ADKA naplót. A program ki fogja listázni a bejegyzéseket. Amelyek pirossal vannak bejegyezve, azok a hibát írják le. Ebből tudunk tájékozódni a hiba jellegére.

Az adatkapcsolat beállításai a programból A programban számtalan lehetőség van az adatkapcsolat testreszabására. Ezeket a Rendszer menü\ Beállítások menüpont\ Adatkapcsolat fülön érhetőek el.

Vevői számla: Sum – Devizaérték: ha be van jelölve, akkor összesíti a tételek devizaértékét. Sum – Bruttó tömeg: ha be van jelölve, akkor összesíti a tételek bruttó tömegét. Sum – Nettó tömeg: ha be van jelölve, akkor összesíti a tételek nettó tömegét. Tételek hozzáadása, amennyiben létezik a számla: ha bejelöljük, akkor a program hozzáfűzi a tételeket a már létező vevői számlához. Szállítói számla:

Sum – Devizaérték: ha be van jelölve, akkor összesíti a tételek devizaértékét. Sum – Bruttó tömeg: ha be van jelölve, akkor összesíti a tételek bruttó tömegét. Sum – Nettó tömeg: ha be van jelölve, akkor összesíti a tételek nettó tömegét.


23

Tételek hozzáadása, amennyiben létezik a számla: ha bejelöljük, akkor a program hozzáfűzi a tételeket a már létező szállítói számlához. Gyártás:

Gyártásnál raktári mozgás generálása: amennyiben be van jelölve, úgy a program a megadott gyújtőbe genereál egy raktári kivétet, a gyártás alapján.

Gyártásnál duplikáció elkerülése: ha be van jelölve, akkor a program, amennyiben már ilyen gyártás létezik(fg_id létezik), nem visszi fel az ugyanolyan azonosítóval rendelkező gyártást. Egyéb:

Nyitott szállítói számlák: ha esetleg a számlák több részletben jönnek, akár néhány nap eltéréssel is, akkor jelöljük be. Jelenleg csak ASC file-típúsnál működik, hagyjuk bejelölve!


24

Kompakt ZOLL interface leírás

Recommend Documents