Ugrás a fő tartalomhoz

Kérés

információ

Fontos, hogy ezen az interfészen csak belső (Számlázz.hu-ban kiállított) kimenő számlák adatait lehet lekérni.

Lekérdezési lehetőségek​

A számlát az alábbi azonosítók egyikével lehet lekérdezni:

  • Számlaszám (szamlaszam): A Számlázz.hu által generált egyedi számlaszám
  • Rendelésszám (rendelesSzam): A számlához tartozó rendelésszám. Ha több számla is rendelkezik ugyanazzal a rendelésszámmal, akkor a legutolsó lesz visszaadva
  • Külső azonosító (szamlaKulsoAzon): Egyedi azonosító, amit a számla létrehozásakor megadhatsz. Ez lehetővé teszi, hogy a saját rendszered azonosítójával kérdezd le a számlát anélkül, hogy ismernéd a generált számlaszámot
Külső azonosító beállítása

Fontos: A számlák csak akkor kapják meg a szamlaKulsoAzon értéket, ha a számla létrehozásakor a Számla Agent-en keresztül beküldöd a szamlaKulsoAzon mezőt. Csak akkor lehet külső azonosítóval lekérdezni egy számlát, ha azt a számla létrehozásakor beállítottad.

Külső azonosító előnyei

A szamlaKulsoAzon mező hasznos a külső rendszerek számára, mert:

  • Egyedi azonosítót adhatsz meg a számláknak a külső rendszered szerint
  • Nem kell tudnod a generált számlaszámot a lekérdezéshez
  • Ez lehetővé teszi, hogy a külső rendszered saját szervezése alapján kezelje a számlákat
Hibakezelés

Ha olyan szamlaszam, rendelesSzam vagy szamlaKulsoAzon értékkel kérdezel le, ami nem létezik a számlázási fiókban, akkor az alábbi hibaüzenetet kapod:

Hiba (7): Hiányzó adat: számla xml (ismeretlen számlaszám, rendelésszám vagy külső azonosító).

A bizonylat lekéréséhez XML formátumban egy XML fájlt kell HTTP POST kérésben elküldeni.

Követelmények​

  • Alap URL: https://www.szamlazz.hu/szamla/ (a kérés célcíme)
  • Metódus: POST
  • Tartalomtípus: multipart/form-data
  • Form mező neve: pontosan action-szamla_agent_xml (egy fájl feltöltése)
  • Fájl tartalma: a kérés adatai XML formátumban (szerkezet: XSD séma; minta: Minta XML)

Minta HTML űrlap​

A kérés például ilyen űrlappal küldhető:

<html>
  <head><meta content="text/html; CHARSET=UTF-8"></head>
  <body>
    <form action="https://www.szamlazz.hu/szamla/" method="post" enctype="multipart/form-data">
      <input type="file" name="action-szamla_agent_xml">
      <input type="submit" name="generate" value="Bizonylat lekérése XML-ben">
    </form>
  </body>
</html>

Kipróbálás:

Töltsd fel a megszerkesztett XML fájlt
tanács

Javasoljuk, a küldés előtt validáld az XML-t az XSD alapján.