Pénzszámítás

A kassza a számla tételeinek nettó, áfa és bruttó értékét maga számolja ki az egységárból és az áfakulcsból. Ugyanezek a függvények a kassza/money modulból is elérhetők, így a kosárban, a rendelés-összesítőben vagy a visszaigazoló e-mailben pontosan azt az összeget mutathatod, ami a számlára kerül. A modul nem hív hálózatot és nem kell hozzá Agent kulcs, ezért böngészőben is futtatható.

calculateInvoiceItem({ quantity: 3, grossUnitPrice: 5990, vat: 27 })

Az összes export#

A típusok is innen importálhatók: ItemPriceInput, ItemAmounts, DocumentKind, DocumentTotals, VatBreakdown, VatRate, NumericVatRate és SpecialVatCode.

Egy tétel kiszámolása#

import { calculateInvoiceItem, calculateReceiptItem } from 'kassza/money'

const b2b = calculateInvoiceItem({ quantity: 3, netUnitPrice: 500, vat: 27 })
const b2c = calculateInvoiceItem({ quantity: 3, grossUnitPrice: 500, vat: 27 })
const euro = calculateInvoiceItem({ quantity: 7, netUnitPrice: 12.35, vat: 27 }, 'EUR')
const nyugta = calculateReceiptItem({ grossUnitPrice: 1_000, vat: 27 })

A bemenet (ItemPriceInput) mezői:

Az eredmény (ItemAmounts) a quantity, vat, netUnitPrice, netAmount, vatAmount és grossAmount mezőt tartalmazza. Bruttó alapú számításnál a netUnitPrice a nettó értékből visszaszámolt egységár.

A második paraméter a pénznem. Ha elhagyod, vagy az isHuf() szerint forint, a forintos szabályok érvényesek, minden más pénznemnél a devizásak:

A lépések sorrendjét és a bruttó alapú visszaszámolást a Kerekítés oldal, a nyugta szabályait a Tételösszegek oldal írja le.

Kosár végösszege#

A kerekítés tételenként történik, ezért a végösszeget is a kiszámolt tételekből kell összeadni. Ezt csinálja a summarizeItems():

import { calculateInvoiceItem, summarizeItems } from 'kassza/money'

const kosar = [
  { name: 'Társasjáték', quantity: 2, grossUnitPrice: 5_990, vat: 27 },
  { name: 'Szakácskönyv', quantity: 1, grossUnitPrice: 3_500, vat: 5 },
  { name: 'Házhoz szállítás', quantity: 1, grossUnitPrice: 1_490, vat: 27 },
]

const tetelek = kosar.map((sor) => calculateInvoiceItem(sor))
const { netAmount, vatAmount, grossAmount, byVat } = summarizeItems(tetelek)

A byVat tömb az áfakulcsokat a tételekben való első előfordulásuk sorrendjében tartalmazza. Az összegeket a függvény 6 tizedesjegyre kerekíti, így a devizás tételek összeadásakor sem marad lebegőpontos zaj a végén.

Ha ugyanezekkel a tételekkel állítod ki a számlát, a kassza.invoices.create() válaszában a netTotal 13 939, a grossTotal 16 970 lesz, vagyis a kosárban mutatott összeg és a számla fillérre egyezik:

const szamla = await kassza.invoices.create({
  orderNumber: 'REND-2042',
  buyer: { name: 'Nagy Péter', zip: '1111', city: 'Budapest', address: 'Fő utca 1.' },
  items: kosar,
})

import { calculateInvoiceItem, calculateReceiptItem, summarizeItems } from 'kassza/money'

const nettoAlapu = calculateInvoiceItem({ quantity: 3, netUnitPrice: 1_999, vat: 27 })
const bruttoAlapu = calculateInvoiceItem({ quantity: 3, grossUnitPrice: 500, vat: 27 })
const nyugtaTetel = calculateReceiptItem({ grossUnitPrice: 1_000, vat: 27 })
const devizas = calculateInvoiceItem({ quantity: 7, netUnitPrice: 12.35, vat: 27 }, 'EUR')

console.log('Nettó alapú (B2B):', nettoAlapu)
console.log('Bruttó alapú (B2C):', bruttoAlapu)
console.log('Nyugta tétel:', nyugtaTetel)
console.log('Euró:', devizas)

const osszesen = summarizeItems([
  nettoAlapu,
  bruttoAlapu,
  calculateInvoiceItem({ grossUnitPrice: 3_500, vat: 5 }),
])
console.log('Áfabontás:', osszesen)

Nettó alapú (B2B): {
  quantity: 3,
  vat: 27,
  netUnitPrice: 1999,
  netAmount: 5997,
  vatAmount: 1619,
  grossAmount: 7616
}
Bruttó alapú (B2C): {
  quantity: 3,
  vat: 27,
  netUnitPrice: 393.67,
  netAmount: 1181,
  vatAmount: 319,
  grossAmount: 1500
}
Nyugta tétel: {
  quantity: 1,
  vat: 27,
  netUnitPrice: 787.4,
  netAmount: 787.4,
  vatAmount: 212.6,
  grossAmount: 1000
}
Euró: {
  quantity: 7,
  vat: 27,
  netUnitPrice: 12.35,
  netAmount: 86.45,
  vatAmount: 23.34,
  grossAmount: 109.79
}
Áfabontás: {
  netAmount: 10511,
  vatAmount: 2105,
  grossAmount: 12616,
  byVat: [
    {
      vat: 27,
      netAmount: 7178,
      vatAmount: 1938,
      grossAmount: 9116
    },
    { vat: 5, netAmount: 3333, vatAmount: 167, grossAmount: 3500 }
  ]
}

Kerekítés és összeadás#

A JavaScript beépített kerekítése pénzösszegeknél meglepetéseket okoz. A roundMoney() kereskedelmi kerekítést használ (a fél érték nulláról elfelé kerekedik), és a lebegőpontos pontatlanságot 15 értékes jegyre normalizálja. Az addMoney() összead, és az eredményt a bemenetek közül a legtöbb tizedesjegyre kerekíti.

import { addMoney, decimalPlaces, roundMoney } from 'kassza/money'

const ketTizedes = roundMoney(1.005, 2)
const negativ = roundMoney(-2.5)
const osszeg = addMoney(0.1, 0.2)
const tizedesek = decimalPlaces(12.35)

A roundMoney() második paramétere a tizedesjegyek száma, alapból 0. NaN vagy végtelen értékre RangeError-t dob.

Áfakulcsok és pénznem#

Az isVatRate() típusőr megmondja, hogy egy érték a Számlázz.hu által elfogadott áfakulcs-e: szám a NUMERIC_VAT_RATES listából, vagy szöveg a SPECIAL_VAT_CODES listából. Számot tartalmazó szövegre ('27') false-t ad, ezért adatbázisból vagy CSV-ből olvasott értéket előbb alakíts át:

import { isVatRate, type VatRate } from 'kassza/money'

export function afakulcs(ertek: string): VatRate {
  const szoveg = ertek.trim()
  const szam = Number(szoveg)
  const jelolt = szoveg !== '' && Number.isFinite(szam) ? szam : szoveg
  if (!isVatRate(jelolt)) throw new Error(`Ismeretlen áfakulcs: ${ertek}`)
  return jelolt
}

Ezzel a '27' és az ' 5.5 ' számmá, az 'AAM' kóddá alakul, a '28' pedig hibát dob. A kulcsok jelentését és a szöveges kódokat az Áfakulcsok oldal sorolja fel.

A vatPercentage() a számmal megadott kulcsot adja vissza, a szöveges kódoknál 0-t, és a kassza ezzel a százalékkal számolja a tétel áfáját. Az isHuf() akkor ad true-t, ha a pénznem hiányzik, vagy a szóközök levágása után HUF, huf, Ft, FT vagy ft. Más írásmódot, például Huf-ot, devizának vesz.