Elektronikus számlázás (PayBill)

A PayBill segítségével elektronikus számlákat készíthet a BIG FISH Payment Gateway rendszerében keletkezett sikeres tranzakciókhoz. A számlákat a Számlázz.hu állítja elő azokból az adatokból, amelyeket a kereskedő oldala az Invoice API hívásban ad át. A PayBill kiegészítő szolgáltatás használatához regisztrálni kell a Számla Agent szolgáltatására is a Számlázz.hu rendszerében.

Az elkészült számlákat az Invoice API hívás válaszában adjuk vissza egyszeri alkalommal. Az így létrehozott számlákat utólag (az egyszeri API válasz után) kizárólag a Számlázz.hu rendszerében lehet elérni.

Speciális számlázási műveletek, mint például előleg számla készítése, sztornózás, stb., jelenleg nem elérhetők a PayBill szolgáltatásán keresztül.

Felhívjuk figyelmét, hogy a Számla Agent a Számlázz.hu szolgáltatása, így annak részleteiről és a regisztrációról kizárólag a Számlázz.hu nyújthat további információkat. A kiegészítő szolgáltatásokat, így a PayBill használatát is külön kell kérelmezni ügyfélszolgálatunkon, melyet a következő címre írt üzenettel tehet meg:

[e-mail]

Működés

Használja az Invoice műveletet elektronikus számlák elkészítéséhez a PayBill segítségével.

Próbálja ki ezt a funkciót!

API kérés paraméterek

Az API kérés általános információi

Művelet	HTTP kérés	Adatok
Invoice	POST	method=Invoice json={JSON encode-olt paraméterek}

Kötelező paraméterek

Paraméter	Típus	Érték	Leírás
TransactionId	string (32 karakter)	32 karakter hosszú md5 hash	A tranzakció azonosítója a BIG FISH Payment Gateway rendszerében.
InvoiceData	JSON object	egyedi értékek	A számlázás adatai a Számlázz.hu előírásainak megfelelően. A Számlázz.hu előírásokkal kapcsolatban a következő oldalakon tájékozódhat: https://www.szamlazz.hu/egyedi-megoldasok/szamla-agent/ https://docs.szamlazz.hu/

Mintakód

Számla készítése Invoice használatával:

curl --url 'https://system-test.paymentgateway.hu/api/payment/' \
  --user 'sdk_test:86af3-80e4f-f8228-9498f-910ad' \
  --user-agent 'Invoice | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Invoice' \
  --data 'json=
    {
        "TransactionId":"a4d6f6f27f2116da21da62d705dbd7ef",
        "InvoiceData":{
            "beallitasok":
            {
                "felhasznalo":"teszt01",
                "jelszo":"teszt01",
                "eszamla":"true",
                "szamlaLetoltes":"true",
                "szamlaLetoltesPld":2,
                "valaszVerzio":2
            },
            "fejlec":
            {
                "keltDatum":"2017-11-17",
                "teljesitesDatum":"2017-11-17",
                "fizetesiHataridoDatum":"2017-11-17",
                "fizmod":"Átutalás",
                "penznem":"HUF",
                "szamlaNyelve":"hu",
                "megjegyzes":"Számla megjegyzés",
                "rendelesSzam":"8169344",
                "elolegszamla":"false",
                "vegszamla":"false",
                "helyesbitoszamla":"false",
                "helyesbitettSzamlaszam":"",
                "dijbekero":"false",
                "szamlaszamElotag":"",
                "fizetve":"true"
            },
            "elado":
            {
                "bank":"OTP Bank",
                "bankszamlaszam":"11111111-22222222-33333333",
                "emailReplyto":"",
                "emailTargy":"",
                "emailSzoveg":"",
                "alairoNeve":""
            },
            "vevo":
            {
                "nev":"Kovács Bt.",
                "irsz":"2030",
                "telepules":"Érd",
                "cim":"Tárnoki út 23.",
                "adoszam":"12345678-1-42",
                "postazasiNev":"Kovács Bt. postázási név",
                "postazasiIrsz":"2040",
                "postazasiTelepules":"Budaörs",
                "postazasiCim":"Szivárvány utca 8. VI.em. 42.",
                "alairoNeve":"Vevő Aláírója",
                "telefonszam":"Tel:[phone], Fax:[phone]",
                "megjegyzes":"A portáról felszólni a 214-es mellékre."
            },
            "tetelek":
            [
                {
                    "megnevezes":"Eladó izé",
                    "mennyiseg":"1.0",
                    "mennyisegiEgyseg":"db",
                    "nettoEgysegar":"10000",
                    "afakulcs":"25",
                    "nettoErtek":"10000.0",
                    "afaErtek":"2500.0",
                    "bruttoErtek":"12500.0",
                    "megjegyzes":"tétel megjegyzés 1"
                },
                {
                    "megnevezes":"Eladó izé",
                    "mennyiseg":"2.0",
                    "mennyisegiEgyseg":"db",
                    "nettoEgysegar":"10000",
                    "afakulcs":"25",
                    "nettoErtek":"20000.0",
                    "afaErtek":"5000.0",
                    "bruttoErtek":"25000.0",
                    "megjegyzes":"tétel megjegyzés 2"
                }
            ]
        }
    }'

API válasz paraméterek

Az Invoice kérés eredményét JSON formában válaszoljuk meg. A válasz a következő paramétereket tartalmazza:

Paraméter	Típus	Érték	Leírás
Data	JSON object	egyedi értékek	Tartalmazza a számlázási adatokat és az elkészített PDF számlát base 64 kódolt formátumban (sikeres számla generálás esetén).
ResultCode	string	OK (a számla generálása sikeresen megtörtént) Számlázz.hu hibakódok Hiba esetén a következő eredménykódok jelölik a hiba okát a BIG FISH Payment Gateway rendszerében: AlreadyInvoicedTransaction CurrencyError InactiveStore MissingParameter MissingRemoteAddress UnauthorizedAccess UnauthorizedRemoteAddress UnknownStore UnknownTransaction WrongApikey WrongParameter WrongTransactionStatus	Jelzi a számla generálás eredményét.
ResultMessage	string	leírás	Az egyes ResultCode értékek szöveges magyarázata.
ResponseId	integer	egyedi értékek	A válaszüzenet egyedi azonosítója a BIG FISH Payment Gateway rendszerében.

Mintakód

A fenti Invoice kérésre adott válasz (formázást követően):

{
    "Data":
    {
        "header":"
            HTTP/1.1 100 Continue

            HTTP/1.1 200 OK
            Date: Fri, 17 Nov 2017 14:07:00 GMT
            Server: Apache/2.4.10 (Debian)
            Set-Cookie: JSESSIONID=3AF1FB51D96C6540CAC76FDD91C7F534.sas2; Path=/szamla/; Secure; HttpOnly
            Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0, max-age=0
            Pragma: public
            Set-Cookie: cookie_is_member=true; Expires=Sat, 17-Nov-2018 14:07:01 GMT; Path=/; Secure
            szlahu_kintlevoseg: 0
            szlahu_vevoifiokurl: https://www.szamlazz.hu/szamla/?page=vevoifiokpay&partguid=gbjx4pbzfmuaup98mv4r6d8jirii8y5yyyaa&szfejguid=vn8aibjtfdk8h548uxx5ixyg
            szlahu_nettovegosszeg: 30000
            szlahu_szamlaszam: E-2017-282
            szlahu_bruttovegosszeg: 37500
            Content-Disposition: attachment; filename=752_E-2017-282_782ebu7zrmqtmn9ycifgffh4.xml
            Content-Type: application/octet-stream
            Content-Length: 202488
            Expires: Fri, 17 Nov 2017 14:07:00 GMT",
        "xml":
        {
            "sikeres":"true",
            "szamlaszam":"E-2017-282",
            "szamlanetto":"30000",
            "szamlabrutto":"37500",
            "pdf":"\nJVBERi0xLjUKJdDUxdgKN
                ...
                yAw0OTM0MwolJUVPRgo=\n"
        }
    },
    "ResultCode":"OK",
    "ResultMessage":null,
    "ResponseId": "3202109280600047708"
}