Számla letöltés szerkezeti leírás

Szerver-oldali 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 letöltési folymamatoknál 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.

Ez a mező később a confirm folyamatnál lesz kulcsfontosságú.

A folyamat során törzsadatok is érkeznek az xml-ben. Ezeknek az Ügyvitel adatbázisában szerepelnie kell, kivétel, ha erre a szinkronstruktúra kiegészítést tartalmaz.

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 azonosítóját.

A confirm ’webáruházazonosító_ügyvitelazonosító;’ formátumban kerülnek az adatok átadásra a web felé.

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.

A folyamat működtetéséhez egy letöltési url és egy confirm url elkészítése szükséges.

További fejlesztések

Számla letöltés folyamat kiegészítése távnyomtatással

A funkció csak Webszinkron modullal és Távnyomtatás modullal rendelkező Ügyfeleink számára érhető el!

Kiegészítésre került a Számla letöltés folyamat az automatikus távnyomtatáshoz szükséges tagekkel, melynek segítségével a letöltött bizonylatok automatikusan távnyomtatásra kerülnek a megadott adatok alapján.

A funkció csak akkor működik, ha az adatbázisban be van aktiválva a távnyomtatás modul.

Távnyomtatási határidő figyelembe vétele számla letöltés szinkron esetén is 

Eddig a távnyomtatási határidőt csak akkor vette figyelembe a program, ha a számla manuális rögzítéssel került a programba. A továbbiakban viszont akkor is ellenőrzi a rendszer ezt a beállítást, ha a bizonylat egy szinkron során kerül be a programba, például webáruházon keresztül.

Számla letöltés szinkron folyamatban közvetített szolgáltatás alkalmazása

Új tag: <MediatedService>1</MediatedService>

Értéke 0, vagy 1 lehet, attól függően, hogy az adott termék közvetített szolgáltatás-e, vagy sem (0 – nem, 1 – igen)

Működése a szinkron feldolgozási folyamatában:

– Ha a törzsben szerepelt a szolgáltatás (közvetítettként) és a szinkronban nincs meg a tag, akkor a bizonylatra a törzs alapján közvetített szolgáltatásként kerül fel a termék

– Ha a törzsben szerepelt a szolgáltatás (közvetítettként) és a <MediatedService>1</MediatedService>, akkor szintén felkerül a felirat a bizonylatra

– Ha a törzsben szerepelt a szolgáltatás (nem közvetítettként) és van <MediatedService>1</MediatedService>, akkor a szinkron állományban szereplő beállítások lesznek a mérvadók és szintén felkerül a szöveg a bizonylatra

– Ha a törzsben szerepelt a szolgáltatás (nem közvetítettként) és a <MediatedService>0</MediatedService>, vagy nincs megadva, akkor nem kerül fel a közvetített szolgáltatás felirat a bizonylatra

– Ha a törzsben nem szerepelt a szolgáltatás és <MediatedService>0</MediatedService>, akkor az újonnan rögzítésre kerülő szolgáltatás:

És a számlára sem kerül fel a felirat.

– Ha a törzsben nem szerepelt a szolgáltatás és <MediatedService>1</MediatedService>, akkor az újonnan rögzítésre kerülő szolgáltatás:

Illetve a számlára felkerül a felirat.

Számla letöltés szinkronfolyamatban elszámolási időszak záró dátumának kezelése

A számla letöltés webszinkron folyamatba beépítésre került az elszámolási időszak záró dátumának kezelése. A szoftver az „InvoiceAccountingDeliveryDate” elemben megküldve képes feldolgozni az új adatot.

Minta:

…

<InvoiceAccountingDeliveryDate>2022-04-21</InvoiceAccountingDeliveryDate>

…

Számla letöltés szinkron folyamat során a korábbiakban az alapértelmezett kísérő szöveggel küldte ki az elkészült számlákat a rendszer. Az új opciónak köszönhetően a távnyomtatás beállításokban módosítottra is át lehet állítani.

Az új lehetőség a Karbantartás / Rendszer beállítások / Általános / Alapértelmezett adatok beállítása részen található: „Számla letöltés szinkron folyamatban alapértelmezett sablon használata„

Kikapcsolt állapotban a fenti képen lévő módosított (módosítható) nézettel kerülnek kiküldésre a letöltött számlák, ha pedig aktív a jelölő, akkor a korábbi működés érvényesül (vagyis az alapértelmezett kísérő szöveg).

Bruttó ár megadási lehetőség számla szinkronban

A számla letöltés szinkron (v4) folyamatban bevezetésre került egy új mező:

<GrossUnitPrice>12700</GrossUnitPrice>

Ahol a GrossUnitPrice a számla tétel bruttó értékét jelenti. A működésben három esetet különböztethetünk meg:

– Ha az új adat nem szerepel a feldolgozandó fájlban, a működés a korábbiak szerint történik (nettóból bruttó számítás)

– Ha a GrossUnitPrice meg van adva, akkor ebből a bruttó értékből számolódik ki a tétel nettó értéke

– Ha a GrossUnitPrice és a UnitPrice (nettó) is meg van adva, akkor szintén a bruttó árból történik a számítás, függetlenül a nettó értéktől

A stuktúra leírás és a minta xml fájl megtalálható a csatolmányban.