Leírás
PDF számlakép átadása a webshopnak.
A sERPa küldi a számlaképet vevőszámla nyomtatás eseményre, ha az olyan számla, amihez web rendelés kapcsolódik.
Ha a Számlakép kiküldése jelölőnégyzetben szerepel pipa viszont nem kerül felvételre egy vevőszámla sorozat sem a Számlakép sorozat nevű táblázatba, akkor minden számlasorozatra kiküldjük a PDF számlaképet.
Algoritmus
•Csak olyan számlák esetén küldünk képet, amelyben a számlatételhez olyan szállítólevél kapcsolódik, amelyen vevőrendelés tétel kapcsolat van. Tehát a vevőszámlának vevőrendeléshez kell kapcsolódni a szállítólevélen keresztül.
oEmiatt pl. előlegszámlákat nem adunk át, ott nincs szállítólevélen keresztül rendelés kapcsolat.
•E-számla nyomtatásakor megvárjuk a hitelesített számlaképet és amint azt visszakapjuk a szolgáltatótól kiküldjük a webáruház felé. (ArchivaltHitelesSz = 1)
•Számla Nyomtatott állapotú és van PDF kép. ( Számla mentése PDFként adatbázisba menüparaméter Engedélyezett esetén) (ArchivaltHitelesSz = 2)
•Fontos, hogy a menüparaméterrel mentett számlakép nem aláírt e-számla.
A Webáruház paraméterben beállított Ügynök generálása regisztrált vásárló esetén = Nem esetén nem szükséges, hogy az ügyfélhez ügynök tartozzon, míg Igen esetén:
•Csak olyan számlák esetén küldünk képet, melyeknél az Ügynök olyan Ügyfélhez kapcsolódik, ahol az ügyfél idegen azonosító a webáruház paraméterben szereplő Regisztrált ügyfél idegenazonosító típussal megegyezik.
o(Számlán szereplő Ügynök Ügyfél típusú és az ott megadott ügyfélnek van customer_webshop_code-ja)
Az XML tartalmazza a regisztrált ügyél azonosítót, a számla ügyfél azonosítót, a sERPa bizonylatszámot, a webshop rendelésszámot, hogy a webshop be tudja azonosítani melyik rendeléshez kapott számlát, illetve a Számla PDF képét base64 kódolással kódolva.
Adatátadás feltétele
Számlakép (Rest napló típus = NetGo-Számlakép) - customers/bill
Változást beindító esemény ([Uzenet].[SOAPSyncCall]): Vevőszámla aláírásnál és számlakép letöltésnél.
*Változás további feltétele, az összes feltételnek teljesülni kell:
- A webáruház paraméterben a webáruház használhatóra legyen állítva.
- A webáruház paraméter 'Általános adat' fülén található URL mező ne legyen üres.
- A webáruház paraméterben be van pipálva a számlakép kiküldése.
- A vevőszámla nyomtatott
- A számlakép archivált vagy hiteles
- A webáruház paraméterben a nem regisztrált ügyfél pipa értéke hamis vagy a számlán szereplő ügynök ügyfeléhez tartozik regisztrált ügyfél idegenazonosító, melynek típusa a webáruház paraméterben meghatározott.
- A számlához olyan szállítólevél tartozik, amelyhez bármilyen rendelés kapcsolódik.
*Megjegyzés:
- Aszinkron történik az üzenetek küldése. A kérés az optimalizálás miatt bekerül egy végrehajtási sorba (//sERPa/AUGAsync/TargetQueue). Tehát a küldéshez szükséges, hogy a Service Broker és az említett Queue engedélyezett legyen.
(ha 1 másodpercen belül több azonos típusú csomag kerülne küldésre, akkor összevonásra kerülnek egy üzenetbe).
Küldés XML leírás
serpa
<head
<token
<type ;
<time ; az xml készítésének időpontja
head>
<bill
<customer_webshop_code ; Regisztrált ügyfél idegenazonosító
<bill_webshop_code ; Számla ügyfél idegenazonosító
<erp_bill_number ; sERPa bizonylatszám
<invoice_authentic ; hitelesítes számla 1 - esetén e-számla hitelesített, 2 - esetén csak elmentett PDF kép, így az csak akkor válik hitelessé, ha a vevő kinyomtatja. Ezt a webáruáhznak kell kezelnie.
<bill_pdf ; Számla pdf képe base64ben
<orders
<order_code ; Webshop rendelés szám - rendelésben hivatkozási szám
Példa XML
<bill>
<customer_webshop_code>regidegen1</customer_webshop_code>
<erp_bill_number>2021-BV/000040</erp_bill_number>
<invoice_authentic>0</invoice_authentic>
<bill_pdf></bill_pdf>
<orders>
<order id="1" order_code="0000004" serpa_order_code="2021-NETG/000003" />
</orders>
</bill>
<bill>
<customer_webshop_code>NETGidegen</customer_webshop_code>
<bill_webshop_code>NETSzamlaidegen</bill_webshop_code>
<erp_bill_number>2021-NETV/000005</erp_bill_number>
<invoice_authentic>1</invoice_authentic>
<bill_pdf></bill_pdf>
<orders>
<order id="1" order_code="0000002" serpa_order_code="2021-NETG/000001" />
</orders>
</bill>
