Ugrás a tartalomra
kassza

Devizás számla EU-s cégnek

Egy magyar fejlesztőcég egy német ügyfélnek dolgozik, és havonta euróban számlázza a ledolgozott órákat. A számla angol nyelvű, a vevő közösségi adószámmal szerepel rajta, az áfát pedig a vevő fizeti meg a saját országában. Az árfolyamot a Számlázz.hu az MNB-től veszi, ha nem adsz meg mást.

A recept a Fizetett rendelés számlája recept egyszerSzamlaz() függvényét használja, így a havi számla egy megbízáshoz csak egyszer készül el.

A számlázó függvény#

lib/eu-szamla.ts
import type { InvoiceLanguage, Kassza } from 'kassza'
import { isValidEuVatNumber, normalizeEuVatNumber } from 'kassza/validators'
import { kassza as alapKliens } from '@/lib/kassza'
import { egyszerSzamlaz } from '@/lib/szamlazas'

export interface EuMegbizas {
  readonly id: string
  readonly cegnev: string
  readonly orszag: string
  readonly iranyitoszam: string
  readonly varos: string
  readonly cim: string
  readonly kozossegiAdoszam: string
  readonly email: string
  readonly nyelv: InvoiceLanguage
  readonly szolgaltatas: string
  readonly orak: number
  readonly oradijEur: number
}

export async function euSzolgaltatasSzamla(
  megbizas: EuMegbizas,
  kliens: Kassza = alapKliens,
): Promise<string> {
  const euTaxNumber = normalizeEuVatNumber(megbizas.kozossegiAdoszam)
  if (!isValidEuVatNumber(euTaxNumber)) {
    throw new Error(`Érvénytelen közösségi adószám: ${megbizas.kozossegiAdoszam}`)
  }
  if (euTaxNumber.startsWith('HU')) {
    throw new Error('Magyar vevőre ez a recept nem vonatkozik.')
  }

  return egyszerSzamlaz(
    {
      orderNumber: `EU-${megbizas.id}`,
      currency: 'EUR',
      language: megbizas.nyelv,
      paymentDueInDays: 15,
      seller: {
        emailSubject: 'Your invoice',
        emailText: 'Please find your invoice attached. Thank you for your business.',
      },
      buyer: {
        name: megbizas.cegnev,
        country: megbizas.orszag,
        zip: megbizas.iranyitoszam,
        city: megbizas.varos,
        address: megbizas.cim,
        email: megbizas.email,
        euTaxNumber,
        taxpayerType: 'euBusiness',
      },
      items: [
        {
          name: megbizas.szolgaltatas,
          quantity: megbizas.orak,
          unit: 'hour',
          netUnitPrice: megbizas.oradijEur,
          vat: 'EUFAD37',
        },
      ],
    },
    kliens,
  )
}

A hívás így néz ki egy havi elszámolásból:

scripts/havi-szamlak.ts
import { euSzolgaltatasSzamla } from '@/lib/eu-szamla'

const szamlaszam = await euSzolgaltatasSzamla({
  id: '2026-09-HAFENBLICK',
  cegnev: 'Hafenblick Software GmbH',
  orszag: 'Germany',
  iranyitoszam: '20457',
  varos: 'Hamburg',
  cim: 'Am Sandtorkai 12',
  kozossegiAdoszam: 'DE 123 456 789',
  email: 'billing@example.de',
  nyelv: 'en',
  szolgaltatas: 'Software development, September 2026',
  orak: 42.5,
  oradijEur: 95,
})

console.log(`Kiállítva: ${szamlaszam}`)

A nettó egységárból a kassza számolja ki a tételösszegeket, devizában két tizedesjegyre kerekítve. Az EUFAD37 kódos áfakulcs áfája 0, így a bruttó összeg megegyezik a nettóval.

Devizás számla EU-s vevőnek

Euróban kiállított angol nyelvű számla, közösségi adószámmal és MNB árfolyammal.

Futtatás a sandboxban
devizas-szamla.ts
import {  } from 'kassza'

const  = ()

const  = await ..({
  : 'EUR',
  : 'en',
  : 'EU-2026-3',
  : 30,
  : {
    : 'Hafenblick Software GmbH',
    : 'Germany',
    : '20457',
    : 'Hamburg',
    : 'Am Sandtorkai 12',
    : 'DE123456789',
    : 'euBusiness',
    : 'billing@example.de',
  },
  : [{ : 'Consulting', : 8, : 'hour', : 95, : 'EUFAD37' }],
})

.(., ., .)
.(.[0])

Árfolyam#

Ha az exchangeRate mezőt elhagyod, az árfolyamot jegyző bank MNB lesz, és a Számlázz.hu az aznapi MNB árfolyamot használja. Ha a szerződésed más bank árfolyamát írja elő, az egyszerSzamlaz() hívásban add meg az exchangeBank mezőt (például 'OTP') és az exchangeRate mezőt is. Árfolyam nélkül a kassza más bankot nem fogad el, és a kérés elküldése előtt validation hibát ad.

Buktatók#

Kapcsolódó#

Támogatott devizanemek

Pénznemkódok, árfolyam és árfolyamot jegyző bank.

Áfakulcsok

A kódos áfakulcsok jelentése és a közösségi áfa.

Kerekítés

Hogyan kerekít a kassza forintban és devizában.

Validátorok

Közösségi adószám formátumának ellenőrzése.

Oldal szerkesztéseUtoljára frissítve: