Minta XML + XSD séma
- Minta XML
- XSD séma
Az XML-ben a mezők sorrendje kötött, nem felcserélhetők.
<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlakifiz xmlns="http://www.szamlazz.hu/xmlszamlakifiz" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamlakifiz https://www.szamlazz.hu/szamla/docs/xsds/agentkifiz/xmlszamlakifiz.xsd">
<beallitasok>
<szamlaagentkulcs>Az azonosítókulcs helye. Kérlek, töltsd ki!</szamlaagentkulcs>
<szamlaszam>E-TST-2011-1</szamlaszam> <!-- számlaszám -->
<adoszam>12345678-1-13</adoszam> <!-- csak bejövő számlánál: a számla kiállítójának adószáma; saját (kimenő) számla vagy díjbekérő kifizetésénél hagyd el -->
<additiv>false</additiv> <!-- ha true, a korábbi jóváírások megmaradnak -->
</beallitasok>
<kifizetes>
<datum>2012-01-01</datum><!-- dátum -->
<jogcim>készpénz</jogcim><!-- jogcím / fizetési mód -->
<osszeg>1000</osszeg><!-- összeg -->
</kifizetes>
<kifizetes><!-- további kifizetés -->
<datum>2012-01-15</datum>
<jogcim>átutalás</jogcim>
<osszeg>2000</osszeg>
<leiras>Minta leírás</leiras> <!-- leírás, nem kötelező -->
</kifizetes>
</xmlszamlakifiz>
Az
adoszam mező: kimenő vagy bejövő bizonylatAz adoszam mező dönti el, hogy a rendszer a szamlaszam mezőben megadott bizonylatot hol keresi:
- Elhagyva vagy üresen: a rendszer a saját kiállított (kimenő) bizonylatok között keres, azaz számlák és díjbekérők között, számlaszám alapján, és a megtalált bizonylatra rögzíti a kifizetést.
- Kitöltve: a rendszer a bejövő számlák között keres. Ilyenkor az
adoszama számla kiállítójának adószáma (azé a cégé, amelyiktől a számla érkezett). A keresés a számlaszám és a kiállító adószáma alapján történik, és csak olyan számlát talál meg, amelynél a te fiókod a vevő.
Gyakori hiba, hogy saját számla vagy díjbekérő kifizetésekor is szerepel az adoszam mező. Ilyenkor a rendszer a bejövő számlák között keres, nem találja a bizonylatot, és a Hiányzó adat: kifizetett számla (ismeretlen számlaszám) hibát adja vissza.
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/xmlszamlakifiz" xmlns:tns="http://www.szamlazz.hu/xmlszamlakifiz" elementFormDefault="qualified">
<complexType name="beallitasokTipus">
<sequence>
<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>
<!-- Számlaszám. -->
<element name="szamlaszam" type="string" maxOccurs="1" minOccurs="1"></element>
<!-- A számla kiállítójának adószáma. Csak bejövő számlánál add meg: ha szerepel, a rendszer a bejövő számlák között keres; ha elhagyod, a saját kiállított (kimenő) bizonylatok között. -->
<element name="adoszam" type="string" maxOccurs="1" minOccurs="0"></element>
<!-- Ha true, a korábbi jóváírások megmaradnak; különben lecserélődnek. -->
<element name="additiv" type="boolean" maxOccurs="1" minOccurs="1"></element>
<element name="aggregator" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="valaszVerzio" type="int" maxOccurs="1" minOccurs="0"></element>
</sequence>
</complexType>
<!-- Kifizetés / jóváírás. -->
<complexType name="kifizetesTipus">
<sequence>
<element name="datum" type="date" maxOccurs="1" minOccurs="1"></element>
<element name="jogcim" 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>
</sequence>
</complexType>
<complexType name="szamlaKifizTipus">
<sequence>
<element name="beallitasok" type="tns:beallitasokTipus" maxOccurs="1" minOccurs="1"></element>
<element name="kifizetes" type="tns:kifizetesTipus" maxOccurs="5" minOccurs="0"></element>
</sequence>
</complexType>
<element name="xmlszamlakifiz" type="tns:szamlaKifizTipus"></element>
</schema>