# Elektronikus számlázás (PayBill)

A *PayBill* segítségével elektronikus számlákat készíthet a *Nevogate* 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.

{% hint style="info" %}
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.
{% endhint %}

{% hint style="info" %}
A *PayBill* szolgáltatás használata megrendelés és díjköteles. A szolgáltatás igénybevételével kapcsolatos bővebb információért vegye fel a kapcsolatot az ügyfélszolgálatunkkal a <business@nevogate.com> címen.
{% endhint %}

### 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.

[<mark style="color:blue;background-color:blue;">**Próbálja ki ezt a funkciót!**</mark>](https://demo.nevogate.com/views/?action=invoice)

### **API kérés paraméterek**

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

<table data-full-width="true"><thead><tr><th width="223">Művelet</th><th>HTTP kérés</th><th>Adatok</th></tr></thead><tbody><tr><td><code>Invoice</code></td><td><code>POST</code></td><td>method=<code>Invoice</code><br><br>json={JSON encode-olt paraméterek}</td></tr></tbody></table>

**Kötelező paraméterek**

<table data-full-width="true"><thead><tr><th width="182">Paraméter</th><th width="135">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>TransactionId</code></td><td><p>string</p><p>(32 karakter)</p></td><td>32 karakter hosszú md5 hash</td><td>A tranzakció azonosítója a <em>Nevogate</em> rendszerében.</td></tr><tr><td><code>InvoiceData</code></td><td>JSON object</td><td>egyedi értékek</td><td><p>A számlázás adatai a <em>Számlázz.hu</em> előírásainak megfelelően.<br></p><p>A <em>Számlázz.hu</em> előírásokkal kapcsolatban a következő oldalakon tájékozódhat:</p><p><a href="https://www.szamlazz.hu/egyedi-megoldasok/szamla-agent/">https://www.szamlazz.hu/egyedi-megoldasok/szamla-agent/</a></p><p><a href="https://docs.szamlazz.hu/">https://docs.szamlazz.hu/</a></p></td></tr></tbody></table>

#### **Mintakód**

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

{% code overflow="wrap" %}

```php
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:+3630-555-55-55, Fax:+3623-555-555",
                "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"
                }
            ]
        }
    }'

```

{% endcode %}

### **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:

<table data-full-width="true"><thead><tr><th width="252">Paraméter</th><th width="129">Típus</th><th>Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>Data</code></td><td>JSON object</td><td>egyedi értékek</td><td>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).</td></tr><tr><td><code>ResultCode</code></td><td>string</td><td><ul><li>OK (a számla generálása sikeresen megtörtént)</li><li><em>Számlázz.hu</em> hibakódok</li></ul><p>Hiba esetén a következő eredménykódok jelölik a hiba okát a <em>Nevogate</em> rendszerében:</p><ul><li>AlreadyInvoicedTransaction</li><li>CurrencyError</li><li>InactiveStore</li><li>MissingParameter</li><li>MissingRemoteAddress</li><li>UnauthorizedAccess</li><li>UnauthorizedRemoteAddress</li><li>UnknownStore</li><li>UnknownTransaction</li><li>WrongApikey</li><li>WrongParameter</li><li>WrongTransactionStatus</li></ul></td><td>Jelzi a számla generálás eredményét.</td></tr><tr><td><code>ResultMessage</code></td><td>string</td><td>leírás</td><td>Az egyes <code>ResultCode</code> értékek szöveges magyarázata.</td></tr><tr><td><code>ResponseId</code></td><td>integer</td><td>egyedi értékek</td><td>A válaszüzenet egyedi azonosítója a <em>Nevogate</em> rendszerében.</td></tr></tbody></table>

#### Mintakód

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

{% code overflow="wrap" %}

```php
{
    "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"
}
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nevogate.com/kiegeszito-szolgaltatasok/elektronikus-szamlazas-paybill.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.