Leírás
Számla információ átadás. Webshop kérdez, mi válaszolunk.
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:
Az első kérdés (szamla_1.xml) lekéri az összes számla fej adatát, melyben a customer_webshop_code alapján beazonosított ügyfélhez tartozó ügynök szerepel, megmondja hogy egy oldalon hány db számlát szeretne látni és megmondja hogy hányadik oldaltól kéri a számlákat. A válaszban (szamla_1_response.xml) megadjuk a kért adatokat - lásd alább.
A második kérdés részletei: Számlatételek - Szamla_2.xml
A bill_balance-ban ádatjuk a számla egyenlegét (Számla kiegyenlítés fül Egyenleg mező). Abban az esetben, ha előre utalásos, vagy bankkártyás fizetési móddal jön be a rendelés, akkor a számla kiegyenlített rögtön (függetlenül attól, hogy a bankot még nem könyvelték le az elkészült számlához), tehát azokban az esetekben a bill_balance 0.
A lekérdezés xml-ben szereplhet agent mező. A mezőben átadott Ügynök kódhoz tartozó számlákat adjuk vissza az eredményben, ilyenkor nem nézzük a customer_webshop_code-ban átadott azonosítót.
Algoritmus
- Csak nyomtatott számlákat adunk át.
Kérdés (szamla_1) XML leírás
Számlák listázására vonatkozó kérdés
<serpa>
<content>
<bills>
<customer_webshop_code>szbenetgo02</customer_webshop_code> ; Regisztrált ügyfél idegenazonosító
<agent>ugynokkod</agent>
<quantity>100</quantity> ; Egy oldalon hány db számlát szeretnének látni
<list>1</list> ; Hányadik oldaltól
</bills>
</content>
</serpa>
Válasz (szamla_1_response) XML leírás
Számlaszám szerint fordított sorrendben adjuk vissza a számlák fejadatait. Csak nyomtatott számlák adatait adjuk át.
<serpa
<head
<token
<type ;
<time ; az xml készítésének időpontja
head>
<response
<ok ; 1 sikeres, 0 sikertelen (pl. ha nem találjuk az idegenazonosító alapján az ügyfelet)
<response_text ; Egyéb üzenet (nem használjuk)
<customer_webshop_code ; Regisztrált ügyfél idegenazonosító
<total ; Hány db. számla van összesen
<bills
<bill
<bill_webshop_code> ; Számla ügyfél idegenazonosító
<erp_bill_number ; sERPa bizonylatszám
<order_code ; Webshop rendelés szám - Számlázás alapja mező értéke
<bill_name ; A számlán szereplő vevő neve
<bill_zip ; A számlán szereplő irányítószám
<bill_city ; A számlán szereplő város
<bill_street ; A számlán szereplő utca és házszám
<bill_date ; Számla kelte
<bill_due ; Számla esedékesség
<bill_payment_name ; Számla fizetési mód (Számlanév)
<bill_net_total ; Számla nettó végösszeg
<bill_gross_total ; Számla bruttó végösszeg
<bill_balance ; Számla kiegyenlítés fülén látható egyenleg
Válasz (szamla_1_response) XML példa
<serpa>
<head>
<token></token>
<type>bills</type>
<time>2020-09-24T12:53:55.750</time>
</head>
<response>
<ok>1</ok>
<customer_webshop_code>szbenetgo02</customer_webshop_code>
<total>1</total>
<bills>
<bill>
<bill_webshop_code>szbenetgo02</bill_webshop_code>
<erp_bill_number>2020-A01/000112</erp_bill_number>
<bill_name>szbenetgonév02</bill_name>
<bill_zip>1234</bill_zip>
<bill_city>Budapest</bill_city>
<bill_street>Nagy Sándor u. 1.</bill_street>
<bill_date>2020-09-24</bill_date>
<bill_due>2020-10-02</bill_due>
<bill_payment_name>Folyamatos szolg. / Határ</bill_payment_name>
<bill_net_total>1341.96</bill_net_total>
<bill_gross_total>1653</bill_gross_total>
<bill_balance>0</bill_balance>
</bill>
</bills>
</response>
</serpa>
