XML + XSD
- XML example
- XSD schema
In the XML file, the order of the fields is fixed, they cannot be interchanged.
In the fejlec block you can identify the receipt to query by receipt number (nyugtaszam) or by order number (rendelesSzam). The receipt number is generated by the system and returned in the receipt creation response. The order number is the value you can provide in the receipt creation request. hivasAzonosito is an optional unique call identifier; pdfSablon is an optional PDF template code (A | N | J | L).
<?xml version="1.0" encoding="UTF-8"?>
<xmlnyugtaget xmlns="http://www.szamlazz.hu/xmlnyugtaget" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlnyugtaget http://www.szamlazz.hu/docs/xsds/nyugtaget/xmlnyugtaget.xsd">
<beallitasok>
<szamlaagentkulcs>Please fill!</szamlaagentkulcs>
<pdfLetoltes>false</pdfLetoltes> <!-- REQ boolean --> <!-- if true, the receipt PDF is included in the response -->
</beallitasok>
<fejlec>
<nyugtaszam>NYGT-2020-1</nyugtaszam> <!-- receipt number -->
<!-- or, instead of nyugtaszam, you can use the order number: -->
<!-- <rendelesSzam>ORDER-123</rendelesSzam> -->
<!-- optional: custom PDF template code (A | N | J | L) -->
<!-- <pdfSablon></pdfSablon> -->
</fejlec>
</xmlnyugtaget>
The sent XML file must comply with the following XSD schema.
warning
Elements marked minOccurs="1" must be present in the XML (the tag cannot be omitted). Elements marked minOccurs="0" may be omitted.
<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.szamlazz.hu/xmlnyugtaget" xmlns:tns="http://www.szamlazz.hu/xmlnyugtaget" 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>
<!-- If true, the receipt PDF is returned in the response. -->
<element name="pdfLetoltes" type="boolean" maxOccurs="1" minOccurs="1"></element>
</all>
</complexType>
<complexType name="fejlecTipus">
<all>
<!-- Receipt number to query. -->
<element name="nyugtaszam" type="string" maxOccurs="1" minOccurs="0"></element>
<!-- Order number to query (same as on create). -->
<element name="rendelesSzam" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="hivasAzonosito" type="string" maxOccurs="1" minOccurs="0"></element>
<!-- Codomain: 'A' | 'N' | 'J' | 'L' -->
<element name="pdfSablon" type="string" maxOccurs="1" minOccurs="0"></element>
</all>
</complexType>
<element name="xmlnyugtaget">
<complexType>
<all>
<element name="beallitasok" type="tns:beallitasokTipus" maxOccurs="1" minOccurs="1"></element>
<element name="fejlec" type="tns:fejlecTipus" maxOccurs="1" minOccurs="1"></element>
</all>
</complexType>
</element>
</schema>