Minta XML + XSD séma
- Minta XML
- XSD séma
Az XML-ben a mezők sorrendje kötött, nem felcserélhetők. A <penznem> pénznemkódjaihoz és a devizás nyugta <devizaarf> / <devizabank> mezőihez lásd a Támogatott devizanemek oldalt.
Forintos nyugtánál a tétel összegmezőit kerekítve kell megadnod: a <brutto> csak egész szám lehet, a <netto> és az <afa> legfeljebb 2 tizedesjegyet tartalmazhat, és a <netto> + <afa> összegének pontosan ki kell adnia a <brutto> értéket. Részletek: Tételösszegek és kerekítés.
<?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>Az azonosítókulcs helye. Kérlek, töltsd ki!</szamlaagentkulcs>
<pdfLetoltes>false</pdfLetoltes> <!-- kötelező, boolean; PDF letöltés a válaszban -->
</beallitasok>
<fejlec> <!-- REQ -->
<hivasAzonosito></hivasAzonosito> <!-- string --> <!-- a hívás egyedi azonosítója, ismétlést el kell kerülni -->
<elotag>NYGTA</elotag> <!-- REQ string --> <!-- nyugtaszám előtag, kötelező ==> NYGTA-2017-111 -->
<fizmod>készpénz</fizmod> <!-- REQ string --> <!-- fizetési mód, szabad szöveges mező, felületen használt értékek: á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 --> <!-- pénznem: Ft, HUF, EUR, USD stb. -->
<devizabank>MNB</devizabank> <!-- string --> <!-- devizás számla esetén (nem Ft/HUF) a bank neve -->
<devizaarf>0.0</devizaarf> <!-- string --> <!-- árfolyam -->
<megjegyzes></megjegyzes> <!-- string --> <!-- szabad szöveges leírás, a nyugtán jelenik meg -->
<pdfSablon></pdfSablon> <!-- string --> <!-- opcionális: egyedi PDF sablon azonosítója (A=alap A4, J=jegy, L=jegy logóval, N=80 mm); üres vagy érvénytelen → alap (A) -->
<fokonyvVevo></fokonyvVevo> <!-- string --> <!-- a vevő főkönyvi azonosítója -->
<rendelesSzam></rendelesSzam> <!-- string --> <!-- rendelésszám a nyugtán -->
</fejlec>
<tetelek> <!-- REQ -->
<tetel> <!-- REQ --> <!-- legalább egy tétel szükséges a nyugta kiállításához -->
<megnevezes>Cicás lábtörlő</megnevezes> <!-- REQ string --> <!-- a tétel megnevezése -->
<azonosito></azonosito> <!-- string --> <!-- a tétel azonosítója -->
<mennyiseg>2.0</mennyiseg> <!-- REQ double --> <!-- mennyiség -->
<mennyisegiEgyseg>db</mennyisegiEgyseg> <!-- REQ string --> <!-- mennyiségi egység -->
<nettoEgysegar>10000</nettoEgysegar> <!-- REQ double --> <!-- nettó egységár -->
<afakulcs>27</afakulcs> <!-- REQ string --> <!-- áfakulcs; értékek: 0, 5, 10, 27, AAM, TAM, EU, EUK, MAA, F.AFA, K.AFA, ÁKK, HO, EUE, EUFADE, EUFAD37, ATK, NAM, EAM, KBAUK, KBAET -->
<netto>20000.0</netto> <!-- REQ double --> <!-- nettó érték (mennyiség × nettó egységár), Ft-nál max 2 tizedes -->
<afa>5400.0</afa> <!-- REQ double --> <!-- áfa összesen, Ft-nál max 2 tizedes -->
<brutto>25400.0</brutto> <!-- REQ double --> <!-- bruttó összesen, Ft-nál egész szám, pontosan netto + afa -->
<fokonyv> <!-- --> <!-- főkönyvi adatok -->
<arbevetel>...</arbevetel> <!-- string --> <!-- árbevétel főkönyvi azonosító -->
<afa>...</afa> <!-- string --> <!-- áfa főkönyvi azonosító -->
</fokonyv>
<megjegyzes>Példa megjegyzés</megjegyzes>
<torloKod>123</torloKod> <!-- opcionális: adattörlőkód tételenként -->
</tetel>
<tetel>
<megnevezes>Kutyás lábtörlő</megnevezes>
<mennyiseg>2.0</mennyiseg>
<mennyisegiEgyseg>db</mennyisegiEgyseg>
<nettoEgysegar>10000</nettoEgysegar>
<afakulcs>ÁKK</afakulcs>
<netto>20000.0</netto>
<afa>5400.0</afa>
<brutto>25400.0</brutto>
</tetel>
</tetelek>
<!--
A <kifizetesek> blokk (kifizetések) nem kötelező; ha meg van adva, az összegeknek a nyugta végösszegével kell megegyezniük.
-->
<kifizetesek> <!-- string --> <!-- fizetési mód részletei -->
<kifizetes>
<fizetoeszkoz>utalvány</fizetoeszkoz> <!-- REQ string --> <!-- a fizetési eszköz megnevezése -->
<osszeg>30000.0</osszeg> <!-- REQ double --> <!-- a fizetési eszközzel fizetett összeg -->
<leiras>OTP SZÉP kártya</leiras> <!-- double --> <!-- a fizetési eszköz leírása -->
</kifizetes>
<kifizetes>
<fizetoeszkoz>bankkártya</fizetoeszkoz>
<osszeg>20800.0</osszeg>
</kifizetes>
</kifizetesek>
</xmlnyugtacreate>
A küldött XML fájlnak meg kell felelnie az alábbi XSD séma követelményeinek.
fontos
A minOccurs="1" jelölésű elemeknek szerepelniük kell az XML-ben (a tag nem hagyható el). A minOccurs="0" jelölésűek opcionálisak, elhagyhatók.
<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.szamlazz.hu/xmlnyugtacreate" xmlns:tns="http://www.szamlazz.hu/xmlnyugtacreate" elementFormDefault="qualified">
<complexType name="beallitasokTipus">
<all>
<element name="felhasznalo" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="jelszo" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="szamlaagentkulcs" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="pdfLetoltes" type="boolean" maxOccurs="1" minOccurs="1"></element>
</all>
</complexType>
<complexType name="fejlecTipus">
<all>
<element name="hivasAzonosito" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="elotag" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="fizmod" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="penznem" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="devizaarf" type="double" maxOccurs="1" minOccurs="0"></element>
<element name="devizabank" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="megjegyzes" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="pdfSablon" type="string" maxOccurs="1" minOccurs="0"></element> <!-- értékkészlet: 'A' | 'N' | 'J' | 'L' -->
<element name="fokonyvVevo" type="string" maxOccurs="1" minOccurs="0"></element>
<!-- rendelésszám a nyugtán -->
<element name="rendelesSzam" type="string" maxOccurs="1" minOccurs="0"></element>
</all>
</complexType>
<complexType name="tetelTipus">
<all>
<element name="megnevezes" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="azonosito" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="mennyiseg" type="double" maxOccurs="1" minOccurs="1"></element>
<element name="mennyisegiEgyseg" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="nettoEgysegar" type="double" maxOccurs="1" minOccurs="1"></element>
<element name="afakulcs" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="netto" type="double" maxOccurs="1" minOccurs="1"></element>
<element name="afa" type="double" maxOccurs="1" minOccurs="1"></element>
<element name="brutto" type="double" maxOccurs="1" minOccurs="1"></element>
<element name="fokonyv" type="tns:tetelFokonyvTipus" maxOccurs="1" minOccurs="0"></element>
<element name="megjegyzes" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="torloKod" maxOccurs="1" minOccurs="0">
<simpleType>
<restriction base="int">
<minInclusive value="0"/>
</restriction>
</simpleType>
</element>
</all>
</complexType>
<complexType name="tetelFokonyvTipus">
<all>
<element name="arbevetel" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="afa" type="string" maxOccurs="1" minOccurs="0"></element>
</all>
</complexType>
<complexType name="tetelekTipus">
<sequence>
<element name="tetel" type="tns:tetelTipus" maxOccurs="unbounded" minOccurs="1"></element>
</sequence>
</complexType>
<!-- jóváírások -->
<complexType name="kifizetesTipus">
<all>
<element name="fizetoeszkoz" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="osszeg" type="double" maxOccurs="1" minOccurs="1"></element>
<element name="leiras" type="string" maxOccurs="1" minOccurs="0"></element>
</all>
</complexType>
<complexType name="kifizetesekTipus">
<sequence>
<element name="kifizetes" type="tns:kifizetesTipus" maxOccurs="unbounded" minOccurs="1"></element>
</sequence>
</complexType>
<element name="xmlnyugtacreate">
<complexType>
<all>
<element name="beallitasok" type="tns:beallitasokTipus" maxOccurs="1" minOccurs="1"></element>
<element name="fejlec" type="tns:fejlecTipus" maxOccurs="1" minOccurs="1"></element>
<element name="tetelek" type="tns:tetelekTipus" maxOccurs="1" minOccurs="1"></element>
<element name="kifizetesek" type="tns:kifizetesekTipus" maxOccurs="1" minOccurs="0"></element>
</all>
</complexType>
</element>
</schema>