1. Szerver oldali folyamatok

Tartalomjegyzék

Tartalomjegyzék ...................................................................................................................................... 1 1.

Szerver oldali folyamatok ................................................................................................................ 2

1.1

Adatfeltöltési folyamatok ............................................................................................................ 2

1.2

Adatletöltési folyamatok ............................................................................................................. 2

1.3

Confirm folyamat......................................................................................................................... 2

2.

Struktúra leírások letöltési folyamatokhoz ..................................................................................... 3

2.1

Megrendelés letöltés................................................................................................................... 3

2.2

Számla letöltés............................................................................................................................. 6

2.3

Termék adat letöltés ................................................................................................................... 9

3.

Struktúra leírások feltöltési folyamatokhoz .................................................................................. 11

3.1

Termék adatok feltöltése .......................................................................................................... 11

3.2

Termék kategória adatok feltöltése .......................................................................................... 15

3.3

Árlista adatok feltöltése ............................................................................................................ 16

3.4

Ügyfél kategória feltöltés .......................................................................................................... 17

3.5

Ügyfél adat feltöltés .................................................................................................................. 18

3.6

Számlák feltöltése...................................................................................................................... 20

3.7

Nyelvi adatok feltöltés............................................................................................................... 23

1. Szerver oldali folyamatok 1.1 Adatfeltöltési folyamatok Az adatfeltöltési folyamatokat a Kulcs-Ügyvitel Szinkron program kezdeményezi a beállított ütemezés szerint. A szinkron program a kliens számítógépen legenerál egy UTF-8 karakterkódolású XML állományt, majd ezt feltölti a központilag beállított URL-re. A beérkező fájlokat érdemes (bár nem kötelező) a szerveren fájlként is tárolni, így mindig rendelkezésünkre áll az utolsóként feltöltött XML fájl tartalma. Ezen felül minden a programból feltöltött értéket érdemes adatbázisba menteni, hogy az akár jelenleg nem használt értékekből később egyszerűen tudjunk dolgozni. A feltöltést követően a szinkron programnak szüksége van egy válaszra („response”), a sikeres tételek feldolgozásáról. Amennyiben a visszajelzés nem érkezik meg, a szinkron program a következő ütemezett periódusban újra feltölti az adatokat. A struktúra leírásban folyamatonként kerül meghatározásra a „response” adattartalma. 1.2 Adatletöltési folyamatok Letöltésnél a program, a szinkronstruktúra táblázat alapját előírt XML formátumú UTF8 karakterkódolású szöveget vár visszatérési értékként a megadott URL-ről, amit a szinkron program tölt le XML fájlként és dolgoz fel. Fontos, hogy a visszaigazolás, számla, szállítólevél, stb.. letöltésénéll mindig van egy olyan egyedi azonosító, amivel egyértelműen kell tudnunk azonosítani az adott rekordot a weben. Az egyedi azonosítónak érdemes tartalmaznia egy webáruházra utaló prefixet, így a későbbiekben lehetőség van, akár több webáruházzal történő összekötésre is. Ilyen lehet például egy számla webes adatbázisban tárolt egyedi azonosítója. Ez a mező később a confirm folyamatnál lesz kulcsfontosságú. 1.3 Confirm folyamat A confirm folyamat során a program visszajelzi, hogy a letöltött adatok megérkeztek hozzá. Ez a folyamat az adat letöltését követően fut le és visszajelzi a fogadott termékek, visszaigazolások, számlák programbeli iktatószámát. A confirm ’webazonosító_programiktatószám;’ formátumban kerülnek az adatok átadásra a web felé. Web ID

Ügyvitel ID

1

15

2

17

3

28

Ekkor: ”1_15;2_17;3_28” az adattartalom

A feldolgozás részeként el kell tárolni, hogy az a rekord letöltésre került így többet nem jelenhet meg a letöltések között, illetve érdemes a programbeli azonosítót is eltárolni, például hibakeresés céljára.

2. Struktúra leírások letöltési folyamatokhoz Az alábbi fejezetben a letöltési szinkron folyamatok struktúra leírása található, amelyek során az adatok a külső forrásból importálásra kerülnek a Kulcs-Soft program adatbázisba. 2.1 Megrendelés letöltés Név: megrendeles_download Verziószám: v1 Confirm: van

XML tag 1 2 3

4

Megrendelés struktúra Kötelező I/N

Típus

Megjegyzés

HUF

I I

nvarchar

<arfolyam>1

I

decimal(18,6)

481

I

int

w481

I

nvarchar(20)

w481

N

nvarchar(20)

0123456789 <email>[email protected] <szamlanev>Vevő Béla <szamlairsz>1144 <szamlavaros>Budapest <szamlautca>Füredi <szamlalepcsohaz> <szamlaajto>1 <szamlaemelet>I emelet <szamlahazszam>7. <szamlaepulet>. <szamlakozteruletjelleg>utca <szamlaorszag>Magyaroszág. <szallitnev>Vevő Béla <szallitirsz>1144 <szallitvaros>Budapest <szallitutca>Füredi

N I I I I I I I I I I I

nvarchar(20) nvarchar(80) nvarchar(80) nvarchar(20) nvarchar(80) nvarchar(80) nvarchar(80) nvarchar(80) nvarchar(80) nvarchar(80) nvarchar(80) nvarchar(80)

Vevői rendelés Rendelés sorszáma a weben (több webáruházzal való szinkron esetén webáruházanként egyedinek kell lenni) Bizonylat fejléc adatok Pénznem, Ügyvitelben léteznie kell a törzsadatokban Árfolyam ( kötelező kitölteni, HUF esetén = 1 tizedes esetén tizedesvessző!) Ügyfél azonosító az ügyvitelben. Elsődleges ügyfélazonosítás (ha nem ismert, akkor == 0) Webes-ügyfél azonosító (Amennyiben nincs megadva, ugyfelkod alapján keres) Másodlagos ügyfélazonosítás. Ügyfél kód. Harmadlagos ügyfélazonosítás Ügyfél telefonszáma Ügyfél e-mail címe Számlázási név (max 80 karakter) Számlázási irányítószám Számlázási város Számlázási utca Számlázás lépcsőház Számlázás ajtó Számlázás emelet Számlázás házszám Számlázás épület Számlázás közterület jelleg

I I I I I

nvarchar(80) nvarchar(80) nvarchar(20) nvarchar(80) nvarchar(80)

Számlázás ország Szállítási név (max 80 karakter) Szállítási irányítószám Szállítási város Szállítási utca

I

<szallitlepcsohaz> <szallitajto>1 <szallitemelet>I emelet <szallithazszam>7. <szallitepulet> <szallitkozteruletjelleg>utca <szallitorszag>Magyaroszág. Készpénz 0

2012-02-22 <szallitasdatum>2012-02-22

I I I I I I

nvarchar(80) nvarchar(80) nvarchar(80) nvarchar(80) nvarchar(80) nvarchar(80)

Szállítási lépcsőház Szállítási ajtó Szállítási emelet Szállítási házszám Szállítási épület Szállítási közterület jelleg

I N I I

nvarchar(80) nvarchar(80) nvarchar(80)

Szállítási ország Adószám Fizetési mód neve Fizetési határidő. Napok száma (0= azonnali kiegyenlítésű fizetés. Napok száma > 0, halasztott kiegyenlítésű fizetés. Egész szám lehet csak.) Megrendelés dátuma Kiszállítás dátuma Bizonylat megjegyzés

I I N

integer datetime datetime nvarchar(m)

I

01222

I

<webshopid>

I

T01

I

int

XML tag 1 2 3

4

nvarchar(20) nvarchar(20)

Megrendelés struktúra Kötelező I/N

<service>0

I

Termék 1 <mennyiseg>3 <mennyisegegyseg>db

I I I

<egysegarnetto>123,50

I

Típus

boolean nvarchar(140) decimal nvarchar

27%

N I

decimal nvarchar(m) nvarchar

Bizonylat tétel adatok. Első tétel=0 és minden tételnél 1-el növekszik Ügyvitel belső ID (ha nincs találat, vagy nincs megadva webshopid alapján azonosít, amennyiben nem ismert legyen 0) Webáruház auto id, egyedi azonosító a weben (Ha nincs találat, rögzíti a terméket) Termékkód

Megjegyzés Áru/Szolgáltatás (Ha nincs megadva, akkor szolgáltatást rögzít, 0=áru, 1=szolgáltatás) Terméknév Mennyiség Mennyiségi egység, ügyvitel törzsadatban létezni kell Egységár (123,50 formátumban tizedesvessző használatával. ) Tételes megjegyzés Áfakód (lásd áfakód listában)

* A weben egyedileg kell azonosítani a rendelést, érdemes egyedi előtagot használni, folyamatoként is, mert későbbi bővítés esetén lesz praktikus. Több webáruház és több folyamat esetén egyedileg lehet azonosítani, hogy melyik webről milyen folyamatot jelent.

Példa: Két webáruház, rendelés és számla letöltés esetén az első webáruház rendelés azonosítója kapjon AR előtagot, a második webáruház kapjon BR, a számlák esetében ASZ, BSZ előtagokat. Ezzel lehet biztosítani a hibamentes működést.

Confirm folyamat Paraméterek

Magyarázat

$_REQUEST["pw"]

Kulcs-Ügyvitelben beállított admin jelszó (md5 hash)

$_REQUEST['data']

taralma: <web_azon>_ <web_azon>: azonosító melyet a webáruház rendel a rendeléshez (download_order-> ) : azonosító amelyet a Kulcs-Ügyvitel rendel a letöltött rendeléshez, pl ’4_23;5_24’

2.2 Számla letöltés Név: számla_download Verziószám: v1 Confirm: van

XML tag 4

1 2 3 <invoices> <invoice id='81'>

Számla struktúra Kötelező Típus I/N

Megjegyzés

<currencyrate>1

I

w481

N

<customerid>w481

I

<customercode>w481 0123456789 <email>[email protected] <customername>Vevő Béla 1144 Budapest

I

Számla Számla sorszáma a weben. (több webáruháznál való szinkron esetén webáruházanként egyedinek kell lenni*) Bizonylat fejléc adatok nvarchar Pénznem, Ügyvitelben léteznie kell a törzsadatokban decimal(18,6 Árfolyam (HUF esetén = 1) ) integer Ügyfél azonosító az Ügyvitelben Elsődleges ügyfélazonosítás (ha nincs megadva, akkor customerid alapján azonosít) nvarchar(20) Webes-ügyfél azonosító – külső azonosító (Amennyiben nincs megadva customercode) Másodlagos ügyfélazonosítás nvarchar(20) Ügyfél kód. Harmadlagos ügyfélazonosítás

N I I

nvarchar(20) Ügyfél telefonszáma nvarchar(80) Ügyfél e-mail címe nvarchar(80) Számlázási név (max 80 karakter)

I I

nvarchar(20) Számlázási irányítószám nvarchar(80) Számlázási város

I

nvarchar(80) Számlázás utca

I

nvarchar(20) Számlázási lépcsőház

I I I

nvarchar(20) Számlázási ajtó nvarchar(20) Számlázási emelet nvarchar(20) Számlázási házszám

I

nvarchar(20) Számlázási épület

I

nvarchar(20) Számlázási közterület jellege

I

nvarchar(20) Számlázási ország

I I I

nvarchar(20) Szállítási irányítószám nvarchar(80) Szállítási város Szállítási utca nvarchar(80) Szállítási lépcsőház nvarchar(80)

<currency>HUF

<deliveryzip> <deliverycity> <deliverystreet> <deliveryStaircase>

I

I I

I

<deliveryDoor> <deliveryFloor> <deliveryBuilding> <deliveryNumber> <deliverypublicdomain > <paymentmethodname>Készpénz

<paymentmethoddelaydays>0

<paymentdate>2012-0222 2012-0222 1 0

<detail id='0'> <productid>01222

XML tag 4

1 2 3

<webshopid>01222

I I I I I N I I

nvarchar(80) Szállítási ajtó Szállítási emelet nvarchar(80) Szállítási épület nvarchar(80) Szállítási házszám nvarchar(80) Szállítási közterület jellege nvarchar(80) nvarchar(80) Adószám nvarchar(80) Fizetési mód neve Fizetési határidő. Napok száma (0= azonnali kiegyenlítésű fizetés. Napőok száma > 0, halasztott kiegyenlítésű fizetés. Egész szám integer lehet csak.)

I datetime

Fizetési határidő dátuma

datetime

Teljesítés dátuma

nvarchar(m) nvarchar(m) nvarchar(m)

Bizonylat megjegyzés Biz. típusa (1=gépi számla 2=kézi számla) Kiegyenlítés összege

I N N N I I int Számla struktúra Kötelező Típus I/N I

<productcode>T01 <customtariffnumber>72.11 <currency>HUF <service>0

I I

<productname>Termék 1 3 db 123,50

I

<detailcomment> 27% <stock>Központ

N

I I

I I

nvarchar(20) nvarchar(20) nvarchar nvarchar

nvarchar decimal nvarchar(m) nvarchar nvarchar



Megjegyzés

Webes-termék azonosító (Ha nincs találat, rögzíti a terméket) Termékkód Vámtarifaszám Fizetési mód Áru/Szolgáltatás (Nem létezik=szolgáltatás, 0=áru, 1=szolgáltatás)

boolean nvarchar(140 ) Terméknév decimal Mennyiség

I

I N

Számla tételek. Első tétel=0 Ügyvitel belső ID (ha nincs találat, webshopid alapján azonosít, amennyiben nincs megadva 0 értéknek kell szerepelnie)

Mennyiségi egység Egységár (123,50 formátumban tizedesvessző használatával. ) Tételes megjegyzés Áfakód (lásd áfakód listában) Raktár neve, ebből kerül kivételezésre a termék, szolgáltatás esetén nem kötelező.

* <invoice id='81'> A weben egyedileg kell azonosítani a számlát, érdemes egyedi előtagot használni, folyamatonként is, mert későbbi bővítés esetén lesz praktikus. Több webáruház és több folyamat esetén egyedileg lehet azonosítani, hogy melyik webről milyen folyamatot jelent. Példa: Két webáruház, rendelés és számla letöltés esetén az első webáruház rendelés azonosítója kapjon AR előtagot, a második webáruház kapjon BR, a számlák esetében ASZ, BSZ előtagokat. Ezzel lehet biztosítani a hibamentes működést.

Confirm folyamat Paraméterek

Magyarázat

$_REQUEST["pw"]

Kulcs-Ügyvitelben beállított admin jelszó (md5 hash)

$_REQUEST['data']

taralma: <web_azon>_ <web_azon>: azonosító melyet a webáruház rendel a számlához (download_invoice-> <invoice id='1'>) : azonosító, amelyet a Kulcs-Ügyvitel rendel a letöltött számlához pl ’4_23;5_24’

2.3 Termék adat letöltés Név: termék_download Verziószám: v1 Confirm: nincs Visszatérési érték (response): nincs Termék struktúra Kötelező

XML tag 1 2

3

4

5

Megjegyzés

6

<products> <product> <productid>1 <webshopid>400

Termék letöltés I,A1 I,A2

<productcode>AAA001 1124 5991236547896<\barcode> <productname>Alma

N N N TR

18%<\vatcode> kg<\quantityunit> 1<\active>

TR TR N

<service>1<\service>

N

asdasdads<\comment> 400<\lastpurchaseprice > <prices> <currency>HUF <price>540 <\unitprice> <pricelist>

N N

Nagyker <currency>HUF <price>540 <\pricelist> <\prices> <\product> <\products>

Kötelező mezők:

Típus

ARF ARF

int nvarchar(20)

Ügyvitel termék azonosító. Webáruház termék azonosító, ennek több webáruháznál való szinkron esetén webáruházanként egyedinek kell lennie. nvarchar(20) Termékkód nvarchar(20) Cikkszám nvarchar(30) Vonalkód nvarchar(140 Név ) nvarchar Áfakód (lásd áfakód lista) nvarchar Mennyiségi egység boolean Törölt/nem törölt (1=aktív, 0=törölt) boolean Áru/Szolgáltatás (0=áru, 1=szolgáltatás, N/A=Szolgáltatás) Megjegyzés Utolsó beszerzési ár decimal Ár Egységár nvarchar Pénznem decimal Érték

ALF ALF ALF

nvarchar(80) nvarchar decimal

Árlista (több árlista esetén ismételni kell) Név, Ügyvitelben léteznie kell a törzsadatokban Pénznem Érték

I = kötelező A1= Azonosító (indexben az azonosítás sorrendje található. A node-nak minden esetben léteznie kell a struktúrában) TR= új termék rögzítésénél kötelező ARF=Árfrissítéshez kötelező ALF=Árlista frissítéshez kötelező N= nem kötelező

3. Struktúra leírások feltöltési folyamatokhoz A alábbi fejezetben a feltöltési szinkron folyamatok struktúra leírása található, amelyek során az adatok a Kulcs-Soft program adatbázisából feltöltésre kerülnek a külső adatbázis részére. 3.1 Termék adatok feltöltése Név: termektorzs_upload Verziószám: v1 Confirm: response Visszatérési érték (response): kod, Szinkronizálás: Csak a változások szinkronizálása 2947 <webshopid>1 alm1 Alma <mee>db <default>Alma Apple Apfel <default>db pcs stk 27% 27 <ar>1192 <arakcios>1084,72 1 <szabadraktar>37 5107 1,2|3,4 <service>0 365 <minimumquantity>100 <maximumquantity>5000 2000 0 0 <stocks> <stock> <stockname>Központi 40 0

40 <stocincommingstockquantitykname>20 2012-07-30 <pricelists> <pricelist> <pricelistid>1 <pricelistname>Nagyker <currency>1 <price>40

Termék struktúra XML tag 1 2 3 4 2947 <webshopid>2947

alm1 Alma <mee>Kg <default>Alma Apple

Apfel

Típus

int nvarchar(20)

nvarchar(20) nvarchar(20) nvarchar(140 ) nvarchar nvarchar nvarchar nvarchar

nvarchar

nvarchar <default>db nvarchar pcs nvarchar stk nvarchar 27% nvarchar 27 int <ar>1192 decimal <arakcios>1084,72 nvarchar(m) Termék struktúra XML tag Típus

Megjegyzés Termék felöltés Első termék Ügyvitel azonosító Termék webáruházas azonosítója. Több webáruházzal való szinkron esetén webáruházanként egyedinek kell lennie. Termékkód Cikkszám Termék név Mennyiségi egysége Nyelvesített megnevezés Alapértelmezett megnevezés Az _ utáni szám a Language szinkronban felküldött id alapján töltődik fel. Az _ utáni szám a Language szinkronban felküldött id alapján töltődik fel. Nyelvesített mennyiségi egység Alapértelmezett mennyiségi egység Nyelv2 mennyiségi egység Nyelv3 mennyiségi egység Áfakód Áfakulcs Egységár Akciós ár Termék megjegyzés Megjegyzés

1 2

3 4 1 <szabadraktar>37 5107

boolean decimal int

1,4|2,5|3,6< /categories>

int

<service>0

int

365 <minimumquantity>100 <maximumquantity>5000 2000 0

int decimal decimal decimal date

0

decimal

<stocks> <stock>

Termék kép, bináris adat, base64stringbe konvertálva, Élő/Törölt Szabad készlet Kategoria_upload v1 esetén töltődik, megadja, hogy a felszinkronizált főkategória melyik elem van kiválasztva az adott termékhez. Ha nincs kategória akkor 0 jelenik meg a mezőben. Kategoria_upload v2 esetén töltődik. A | karakterekkel elválasztott számpáros első tagja a főkategória idje, a második a kategória értéke. Termék/Szolgáltatás 0=termék 1= szolgáltatás Garancia (nap) Minimális mennyiség Maximális mennyiség Optimális mennyiség Beérkezés dátuma (Dátum szerint első beérkezés mennyisége) Beérkezés mennyisége (első beérkezés menny.) Raktárankénti készlet

nvarchar

Raktár neve

decimal

Teljes készlet

decimal

Foglalt készlet

decimal decimal

Szabad készlet Beérkező készlet (első beérkezés mennyisége)

date

Beérkezés dátuma (Dátum szerint első beérkezés)

<stockname>Központi 40 0 20 <stocincommingstockquantitykname>20 2012 -0730 <pricelists> <pricelist>

Árlisták int

Árlista id

<pricelistid>1 Termék struktúra XML tag

Típus

Megjegyzés

1 2

3

4 nvarchar

Árlista neve

nvarchar

Árlista pénznem

nvarchar

Érték

<pricelistname>Nagyker <currency>HUF <price>1000

Szinkronizált tételek: A szinkron a termékeket első szinkronizáláskor 10-es csomagokban küldi a webáruház felé. Miután egy termék szinkronizálva van, a további szinkronizálás folyamán, már csak azok a termékek szinkronizálódnak, amelyeknek idő közben változott az adata. A responsenak tartalmaznia kell a node értéket ’,’ elválasztva: pl ’1,2,3’

3.2 Termék kategória adatok feltöltése Név: Kategoria_upload Verziószám: v1 Confirm: nincs Visszatérési érték (response): nincs Szinkronizálás: Minden alkalommal teljes szinkron. Készülék 1 <parentid>0 Alkatrész 2 <parentid>0

Termék kategória struktúra XML tag Típus 1 2 3 4 Készülék nvarchar(80) 1 int <parentid>0 int

Megjegyzés Kategória feltöltés Kategória név Kategória azonosító Szülő kategória id-ja (0=főkategória)

3.3 Árlista adatok feltöltése Név: Pricelist_upload Verziószám: v1 Confirm: nincs Visszatérési érték (response): nincs Szinkronizálás: Minden alkalommal teljes szinkron. <pricelists> <pricelist> 1 Nagyker <customerrelation>1|2|3 <customercategoryrelation>1|2|3 <productrelation>1|2|3 <productcategoryrelation>1|2|3 <pricelist> 2 Kisker <customerrelation>1|2|3 <customercategoryrelation>4|5|6 <productrelation>1|2|3 <productcategoryrelation>1|2|3

Árlista struktúra XML tag 1 2 <pricelists> <pricelist> 1

3

Típus

Nagyker/name> <customerrelation>1|2|3

<customercategoryrelation>1|2|3

<productrelation>1|2|3

<productcategoryrelation>1|2|3



Megjegyzés

4 Árlista feltöltés int Árlista azonosító nvarchar(8 Árlista név 0) int Ügyfél – Árlista kapcsolat, az árlistához rendelt ügyfele id-je | karakterrel elválasztva int Ügyfél kategória – Árlista kapcsolat, az árlistához rendelt ügyfél kategóriák id-je | karakterrel elválasztva int Termék – Árlista kapcsolat, az árlistához rendelt termékek id-je | karakterrel elválasztva int Termék kategória – Árlista kapcsolat, az árlistához rendelt termék kategóriák id-je | karakterrel elválasztva

3.4 Ügyfél kategória feltöltés Név: ugyfelkategoria_upload Verziószám: v1 Confirm: nincs Visszatérési érték (response): nincs Szinkronizálás: Minden alkalommal teljes szinkron. 1 Kateg1 <parentid> 2 Alkateg1 <parentid>1

Ügyfél kategória struktúra XML tag Típus 1 2 3 4 1 int Kateg1 nvarchar(80) <parentid> int

Megjegyzés Kategória feltöltés Kategória azonosító Kategória név Szülő kategória id-ja (0=főkategória)

3.5 Ügyfél adat feltöltés Név: ugyfel_upload Verziószám: v1 Confirm: nincs Visszatérési érték (response): program_azon,webid; Szinkronizálás: Csak a változások szinkronizálása <customers> <customer> <customerid>2921 <customercode>w1 <customername>Próba Elek s <eutaxnumber /> s s s s <email>[email protected] N <webpage /> 0 <paymentmethodname>Készpénz N <expireddebit>0 <debit>0 Y 0 1,2|3,4 <webshopid>w1 Valami 10000

Ügyfél struktúra XML tag 1 2 3 <customers> <customer> <customerid>2921

Típus

Megjegyzés

4

int

Kulcs-Ügyvitel belső ügyfélazonosító <customercode>w1 nvarchar(20) Ügyfélkód <customername>Kulcs-Soft Nyrt. nvarchar(140) Név nvarchar(80) Alapértelmezett kapcsolattartó nvarchar(80) Adószám <eutaxnumber /> nvarchar(80) Eu adószám 1022 nvarchar(20) Irányatószám Budapest nvarchar(80) Város Törökévsz út 30/A nvarchar(80) Utca házszám nvarchar Közterület nvarchar(50) házszám nvarchar(50) épület nvarchar(50) lépcsőház nvarchar(50) folyosó nvarchar(50) ajtó nvarchar ország 0613365300 nvarchar(20) Telefon nvarchar(20) Fax <email>[email protected] nvarchar(80) E-mail N boolean Hírlevél fogadás <webpage /> nvarchar(80) weboldal 0 decimal Kedvezmény százalék nvarchar Fizetési mód <paymentmethodname>Készpénz Kötelező fizetési mód N boolean <expireddebit>0 decimal lejárt kintlévőség <debit>0 decimal összes kintlévőség boolean Aktív Y ugyfelkategoria_upload v1 esetén töltődik, megadja, hogy a felszinkronizált főkategória melyik elem van 0 kiválasztva az adott termékhez. Ha nincs kategória akkor 0 jelenik meg a int mezőben. nvarchar(20) Webshop id <webshopid>w1 ugyfelkategoria_upload v2 esetén töltődik. A | karakterekkel elválasztott számpáros első tagja a főkategória id-je, a második a int kategória értéke. 1,4|2,5|3,6 Valami nvarchar megjegyzés decimal hitelkeret összeg 10000

3.6 Számlák feltöltése Név: Invoice_upload Verziószám: v1 Confirm: nincs Visszatérési érték (response): voucherid ’;’ elválasztva Szinkronizálás: Csak a változások szinkronizálása <invoices> <invoice> 1 1 SZA0001/2012 2012-02-12T15:19:21+02:00 2012-02-12T15:19:21+02:00 <paymentdate>2012-02-12T15:19:21+02:00 <state>1 1000 270 1270 <payablevalue>1270 0 2012-02-14T15:19:21+02:00 <currency>HUF felső megjegyzés alsó megjegyzés <customerid>1144 <customercode>KB <customername>Kiss Balázs <customeremail>[email protected] <invoicezip>1144 <invoicecity>Budapest <invoiceStreet>Füredi park 7. 0 <details> <detail> 123 <productcode>K01 <productname>Cserép 345 <webshopid>123 67 100 100 megjegyzés 27% 27% <serialnumbers> <serialnumber>123 <serialnumber>456 . . . <serialnumber>678

1 2 3 <detail>

Számla struktúra XML tag 1 2 3 <invoices> <invoice> 1 1

Típus

Megjegyzés

4

nvarchar(32) int

SZA0001/2012 2012-02-12T15:19:21+02:00 2012-0212T15:19:21+02:00 <paymentdate>2012-0212T15:19:21+02:00 <state>1

nvarchar(32) datetime datetime

bizonylatszám bizonylat típus, rendelés esetén 6, számla esetén 1, előleg számla esetén 14, kézi számla esetén 12 bizonylatszám dátum ISO8601 formátumban dátum ISO8601 formátumban

datetime

dátum ISO8601 formátumban

int

státusz 6 – normál 7 – helyesbített 8 – helyesbítő 9 – stornó

1000 270 1270 <payablevalue>1270 0 2012-02-14T15:19:21+02:00 <currency>w1 w1 w1 <customerid>w1 <customername>w1 <customercode>w1 <customeremail>[email protected] <invoicezip>w1 <invoicecity>w1 <invoicestreet>w1 0 <details> <detail> w1 <productcode>w1 <productname>w1 w1 <webshopid>w1

decimal decimal decimal decimal decimal datetime nvarchar nvarchar nvarchar int nvarchar nvarchar nvarchar nvarchar nvarchar nvarchar nvarchar

nettó érték áfa érték bruttó érték fizetendő kiegyenlítés kiegyenlítás dátuma pénznem alsó megjegyzés felső megjegyzés ügyfél id ügyfél név ügyfél kód ügyfél email címe számla irsz számlázási város számlázási utca beszerzési ár tételek tétel cikkszám termék kód termék név vonalkód web azonosító

nvarchar(20) nvarchar(20) nvarchar(140) nvarchar(30) nvarchar(50)

w1 w1 w1 w1

int decimal decimal nvarchar

garancianapok száma egységár mennyiség megjegyzés

Számla struktúra XML tag 1 2

3 4 w1 w1 <serialnumbers> <serialnumber>w1 <detail> 1

2 3 <invoices>

Típus nvarchar decimal

Megjegyzés

nvarchar

áfa áfa kulcs gyáriszámok gyáriszám

int int

kapcsolatok rendelés bizonylatid stornó bizonylatid

int

helyesbítő bizonylatid

3.7 Nyelvi adatok feltöltés Név: language_upload Verziószám: v1 Confirm: nincs Visszatérési érték (response): nincs Szinkronizálás: Minden alkalommal teljes szinkron. 1 Angol yyyy.MM.dd EN 2 Német yyyy.MM.dd DE 3 Magyar yyyy.MM.dd HU

Nyelvi adat struktúra XML tag 1 2 3 4 1 Angol yyyy.MM.dd HU

Típus

Megjegyzés Nyelv feltöltés

int nvarchar(80) nvarchar nvarchar

Nyelv azonosító Nyelv név Dátum formátum Rövid kód

Megjegyzés: A nyelv szinkronizálás mindig teljes egészében lefut a webáruház felé.