Ugrás a fő tartalomhoz

Válasz

Nyugta készítésére kapott válaszok​

A válasz mindig tartalmazza a létrehozott nyugta adatait XML-ben (<nyugta> blokk). A PDF (<nyugtaPdf>, base64 kódolással) csak akkor szerepel a válaszban, ha a kérésben <pdfLetoltes>true</pdfLetoltes> volt megadva.

A beküldött XML-ben érdemes <hivasAzonosito/> mezőt használni a hívás hibatűrővé tételéhez. Ha használod, egyedinek kell lennie, különben sikertelen lesz a hívás, így ugyanaz az XML többszöri beküldése nem hoz létre duplikált nyugtát.

Sikeres hívásnál <sikeres>true</sikeres> érkezik, ezt követően a <nyugta> blokk a nyugta adataival. Sikertelenségnél (<sikeres>false</sikeres>) <hibakod/> és <hibauzenet/> is jön.

Az általános hibák mellett ezek is előfordulhatnak:

HibakódLeírás
336A prefix már számlákhoz használatban van; nyugtához más prefix kell (a felületen nem látszik).
337Prefix formátum hibás: csak nagybetű és szám lehet.
338A hívásazonosító (hivasAzonosito) már létezik a szerveren.
339A nyugtaszám nem létezik (lekérdezés, küldés vagy törlés).
340A kifizetett összeg eltér a bruttótól.

Deviza esetén (<penznem/> nem Ft/HUF) árfolyamot és bankot is meg kell adni. Lásd: Támogatott devizanemek.

tanács

Ha a válasz hibát jelez, a kódot a Hibakezelés, hibakódok oldalon keresd meg. Ha nem találod a kódot, vagy váratlan hibát tapasztalsz, vedd fel a kapcsolatot az ügyfélszolgálattal.

<?xml version="1.0" encoding="UTF-8"?>
<xmlnyugtavalasz xmlns="http://www.szamlazz.hu/xmlnyugtavalasz" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlnyugtavalasz https://www.szamlazz.hu/szamla/docs/xsds/nyugtavalasz/xmlnyugtavalasz.xsd">
  <sikeres>true</sikeres>                                                <!-- kötelező, boolean -->
  <hibakod></hibakod>                                                    <!-- hibakód (ha van) -->
  <hibauzenet></hibauzenet>                                              <!-- hibaüzenet (ha van) -->

  <nyugtaPdf>...</nyugtaPdf>                                             <!--     string  --> <!-- nyugta PDF base64 kódolással -->
  
  <nyugta>                                                               <!-- kötelező -->
    <alap>                                                               <!-- kötelező -->
      <id>123456</id>                                                    <!-- kötelező, id -->
      <hivasAzonosito></hivasAzonosito>                                  <!-- ha a hívásazonosító meg lett adva a nyugta készítésekor -->
      <nyugtaszam>NYGT-2017-123</nyugtaszam>                             <!-- kötelező, string -->
      <tipus>NY</tipus>                                                  <!-- típus: NY = nyugta, SN = sztornó nyugta -->
      <stornozott>false</stornozott>                                     <!-- true, ha a nyugta sztornózva van; false egyébként -->
      <stornozottNyugtaszam>NYGT-2017-100</stornozottNyugtaszam>         <!-- sztornózott nyugta száma (SN típusnál) -->
      <kelt>2015-12-01</kelt>                                            <!-- kelte -->
      <fizmod>készpénz</fizmod>                                          <!-- kötelező, string -->
      <penznem>EUR</penznem>                                             <!-- üres, Ft, HUF, EUR, CHF, USD, ... -->
      <devizabank></devizabank>                                          <!--     string  -->
      <devizaarf>210</devizaarf>                                         <!--     double  -->
      <megjegyzes></megjegyzes>                                          <!--     string  -->
      <fokonyvVevo></fokonyvVevo>                                        <!-- könyvelési adat -->
      <teszt>false</teszt>                                               <!-- true = teszt cég, false = éles cég -->
      <rendelesSzam></rendelesSzam>                                      <!--     string  --> <!-- rendelésszám a nyugtán -->
    </alap>
    
    <tetelek>
      <tetel>
        <azonosito></azonosito>                                          <!-- tétel azonosító -->
        <megnevezes>Cicás lábtörlő</megnevezes>                       <!-- megnevezés -->
        <mennyiseg>2.0</mennyiseg>                                       <!-- mennyiség -->
        <mennyisegiEgyseg>db</mennyisegiEgyseg>                          <!-- mennyiségi egység -->
        <nettoEgysegar>10000</nettoEgysegar>                             <!-- nettó egységár -->
        <netto>20000.0</netto>                                           <!-- nettó érték (mennyiség × nettó egységár) -->
        <afakulcs>27</afakulcs>                                          <!-- áfakulcs; értékek: TAHK, TAM, AAM, EUT, EUKT, MAA, F.AFA, K.AFA, HO, EUE, EUFADE, EUFAD37, ATK, NAM, EAM, KBAUK, KBAET, 0, 5, 7, 18, 19, 20, 25, 27 -->
        <afa>5400.0</afa>                                                <!-- áfa összesen -->
        <brutto>25400.0</brutto>                                         <!-- bruttó összesen -->
        <fokonyv>                                                        <!-- főkönyvi adatok -->
          <arbevetel></arbevetel>                                        <!-- árbevétel főkönyvi azonosító -->
          <afa></afa>                                                    <!-- áfa főkönyvi azonosító -->
        </fokonyv>
      </tetel>
      <tetel>
        <megnevezes>Kutyás lábtörlő</megnevezes>
        <mennyiseg>2.0</mennyiseg>
        <mennyisegiEgyseg>db</mennyisegiEgyseg>
        <nettoEgysegar>10000</nettoEgysegar>
        <nettoErtek>20000.0</nettoErtek>
        <afakulcs>27</afakulcs>
        <afaErtek>5400.0</afaErtek>
        <bruttoErtek>25400.0</bruttoErtek>
      </tetel>
    </tetelek>
  
    <kifizetesek>
      <kifizetes>
        <fizetoeszkoz>utalvány</fizetoeszkoz>
        <osszeg>1000.0</osszeg>
        <leiras>OTP SZÉP kártya</leiras>
      </kifizetes>
      <kifizetes>
        <fizetoeszkoz>bankkártya</fizetoeszkoz>
        <osszeg>3000.0</osszeg>
      </kifizetes>
    </kifizetesek>
  
    <osszegek>
      <afakulcsossz>                                                     <!-- kötelező, int -->
        <afatipus>ÁKK</afatipus>                                         <!-- áfatípus / áfakulcs értékek (lásd generating_invoice/settings_and_rules/vat-rates) -->
        <afakulcs>0</afakulcs>                                           <!-- kötelező, double -->
        <netto>200</netto>                                               <!-- kötelező, double -->
        <afa>54</afa>                                                    <!-- kötelező, double -->
        <brutto>254</brutto>                                             <!-- kötelező, double -->
      </afakulcsossz>
      <totalossz>                                                        <!-- kötelező -->
        <netto>200</netto>                                               <!-- kötelező, double -->
        <afa>54</afa>                                                    <!-- kötelező, double -->
        <brutto>254</brutto>                                             <!-- kötelező, double -->
      </totalossz>
    </osszegek>
  </nyugta>

</xmlnyugtavalasz>