Kérés

kassza.invoices.create(input: CreateInvoiceInput, options?: { signal?: AbortSignal }): Promise<CreatedInvoice>

A kassza a bemenetből xmlszamla XML-t épít, és multipart/form-data POST kérésben, az action-xmlagentxmlfile form mezőben küldi el a https://www.szamlazz.hu/szamla/ címre. A mellékletek az attachfile1 … attachfile5 mezőkbe kerülnek.

Kötelező csak a vevő (buyer) és legalább egy tétel (items). Minden más mezőnek van alapértéke, vagy elhagyható.

Fejléc#

Vevő (buyer)#

Tételek (items)#

Minden tételnél a name, a vat és pontosan egy ár kell: netUnitPrice vagy grossUnitPrice. A nettó, áfa és bruttó értéket a kassza számolja ki a kerekítési szabályok szerint.

items: [
  { name: 'Webfejlesztés', quantity: 10, unit: 'óra', netUnitPrice: 15_000, vat: 27 },
  { name: 'Szakácskönyv', grossUnitPrice: 3_500, vat: 5 },
  { name: 'Kedvezmény', netUnitPrice: -5_000, vat: 27 },
]

Eladó (seller)#

Az eladó cégadatai a Számlázz.hu fiókból jönnek, a kérésben csak az alábbiakat írhatod felül. Ha minden számlán ugyanaz, tedd a defaults.invoice.seller-be.

Mellékletek (attachments)#

Az értesítő e-mailhez legfeljebb 5 fájlt csatolhatsz, fájlonként legfeljebb 2 MB-ot. A mellékletek csak e-mailben mennek ki, ezért a vevőnek kell e-mail cím, és a sendEmail nem lehet false.

attachments: [
  { filename: 'aszf.pdf', content: aszfPdf, contentType: 'application/pdf' },
  { filename: 'garancia.txt', content: 'A termékre 2 év garancia vonatkozik.' },
]

A content lehet Uint8Array, ArrayBuffer, Blob vagy szöveg.

Fuvarlevél (waybill)#

Szállítólevélnél vagy fuvarleveles számlaképnél (template: 'SzlaFuvarlevelesAlap') a waybill mező a fuvarlevel blokkot tölti ki.

Könyvelési adatok (ledger)#

A könyvelő programba exportált számlákhoz a vevőnél és a tételeknél főkönyvi adatokat is megadhatsz.

Speciális mezők#

Ezekre a legtöbb integrációnak nincs szüksége. Csak akkor használd őket, ha a könyvelőd vagy a Számlázz.hu ügyfélszolgálata kifejezetten kéri.

Amit a kassza a küldés előtt ellenőriz#

Ezeknél a hibáknál validation kategóriájú SzamlazzError jön, és kérés nem megy a Számlázz.hu-hoz:

• hiányzik a vevő neve, irányítószáma, települése vagy címe,
• nincs tétel, egy tételnek nincs neve vagy mennyiségi egysége, vagy a mennyisége 0,
• ismeretlen áfakulcs, vagy a netUnitPrice és a grossUnitPrice egyszerre, vagy egyik sincs megadva,
• a dueDate és a paymentDueInDays egyszerre szerepel, vagy egy dátum érvénytelen,
• forintos számlán árfolyam, devizás számlán árfolyam nélkül nem MNB bank,
• helyesbítő számla a helyesbített számla száma nélkül, végszámla előlegszámla-szám és rendelésszám nélkül,
• ismeretlen típus, nyelv vagy számlasablon,
• sendEmail: true e-mail cím nélkül, melléklet e-mail értesítő nélkül, 5-nél több vagy 2 MB-nál nagyobb melléklet,
• az egyszerűsített számlakép (simpleItems) szabályainak megsértése,
• hiányos MPL fuvarlevél adatok.

Alapértékek a kliensben#

A gyakran ismétlődő mezőket nem kell minden hívásnál megadni. A createKassza({ defaults: { invoice } }) alapértékei akkor érvényesülnek, ha a hívásban az adott mező hiányzik:

const kassza = createKassza({
  defaults: {
    invoice: {
      prefix: 'WEB',
      paymentDueInDays: 8,
      language: 'hu',
      seller: { bankAccount: '11773016-11111018-00000000', emailReplyTo: 'penzugy@example.hu' },
    },
  },
})

Az összes alapértelmezhető mezőt a Kliens beállítása oldal sorolja fel.