Skip to main content

XML example

In the XML file, the order of the fields is fixed, they cannot be interchanged.

<?xml version="1.0" encoding="UTF-8"?>
<xmlnyugtacreate xmlns="http://www.szamlazz.hu/xmlnyugtacreate" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://www.szamlazz.hu/szamla/docs/xsds/nyugtacreate/xmlnyugtacreate.xsd">
  <beallitasok>                                                      <!-- REQ         -->
<szamlaagentkulcs>Please fill!</szamlaagentkulcs>
    <pdfLetoltes>false</pdfLetoltes>                       <!-- REQ boolean --> <!-- PDF download -->
  </beallitasok>
  <fejlec>                                               <!-- REQ         -->
    <hivasAzonosito></hivasAzonosito>    <!--     string  --> <!-- unique identifier of the call, duplication must be avoided-->
    <elotag>NYGTA</elotag>                   <!-- REQ string  --> <!-- receipt number prefix, required ==> NYGTA-2017-111 -->
    <fizmod>készpénz</fizmod>              <!-- REQ string  --> <!-- payment method, free text field, values ​​used on the interface are: átutalás, készpénz, bankkártya, csekk, utánvét, ajándékutalvány, barion, barter, csoportos beszedés, OTP Simple, kompenzáció, kupon, PayPal,PayU, SZÉP kártya, utalvány -->
    <penznem>Ft</penznem>                   <!-- REQ string  --> <!-- currency: Ft, HUF, EUR, USD stb. -->
    <devizabank>MNB</devizabank>       <!--     string  --> <!-- in case of foreign bill (not Ft/HUF) the name of the Bank -->
    <devizaarf>0.0</devizaarf>                 <!--     string  --> <!-- exchange rate -->
    <megjegyzes></megjegyzes>             <!--     string  --> <!-- free text description, shown on the receipt -->
    <pdfSablon></pdfSablon>            <!--     string  --> <!-- in case of custom PDF template, the identifier of the used template-->
    <fokonyvVevo></fokonyvVevo>                      <!--     string  --> <!-- general ledger ID of the customer -->
  </fejlec>
  <tetelek>                                        <!-- REQ         -->
    <tetel>                                         <!-- REQ         --> <!-- at least one item is required to issue a receipt -->
      <megnevezes>Kitten doormat</megnevezes>         <!-- REQ string  --> <!-- name of the receipt -->
      <azonosito></azonosito>                                        <!--     string  --> <!-- ID of the receipt -->
      <mennyiseg>2.0</mennyiseg>                               <!-- REQ double  --> <!-- item quantity -->
      <mennyisegiEgyseg>db</mennyisegiEgyseg>          <!-- REQ string  --> <!-- unit of quantity -->
      <nettoEgysegar>10000</nettoEgysegar>                <!-- REQ double  --> <!-- net unit price -->
      <netto>20000.0</netto>                                 <!-- REQ double  --> <!-- net value (quantity * net unit price) -->
      <afakulcs>27</afakulcs>  <!-- REQ string  --> <!-- VAT rate, values: 0, 5, 10, 27, AAM, TAM, EU, EUK, MAA, F.AFA, K.AFA, ÁKK,HO, EUE, EUFADE, EUFAD37, ATK, NAM, EAM, KBAUK, KBAET -->
      <afa>5400.0</afa>                                          <!-- REQ double  --> <!-- VAT total value -->
      <brutto>25400.0</brutto>                                     <!-- REQ double  --> <!-- gross total value -->
<megjegyzes>Példa megjegyzés</megjegyzes>
      <fokonyv>                                                      <!--             --> <!-- general ledger information -->
        <arbevetel>...</arbevetel>                                   <!--     string  --> <!-- sales general ledger ID -->
        <afa>...</afa>                                               <!--     string  --> <!-- VAT general ledger ID -->
      </fokonyv>
    </tetel>
    <tetel>
      <megnevezes>Puppy doormat</megnevezes>
      <mennyiseg>2.0</mennyiseg>
      <mennyisegiEgyseg>db</mennyisegiEgyseg>
      <nettoEgysegar>10000</nettoEgysegar>
      <netto>20000.0</netto>
      <afakulcs>ÁKK</afakulcs>
      <afa>5400.0</afa>
      <brutto>25400.0</brutto>
    </tetel>
  </tetelek>
  <!--
The <kifizetesek> section (payments) is not mandatory, but if present,
then the sum of the values should be equal with the total amount of the receipt.
  -->
  <kifizetesek>                                                      <!--     string  --> <!-- details of the payment method -->
    <kifizetes>
      <fizetoeszkoz>voucher</fizetoeszkoz>                    <!-- REQ string  --> <!-- name of the legal tender -->
      <osszeg>30000.0</osszeg>                                    <!-- REQ double  --> <!-- paid amount with legal tender -->
      <leiras>OTP SZÉP kártya</leiras>                            <!--     double  --> <!-- description of the legal tender -->
    </kifizetes>
    <kifizetes>
      <fizetoeszkoz>debit card</fizetoeszkoz>
      <osszeg>20800.0</osszeg>
    </kifizetes>
  </kifizetesek>
</xmlnyugtacreate>