Raw schema
{
"type": "object",
"properties": {
"kind": {
"description": "invoice (default), proforma (non-fiscal payment request) or prepayment (down-payment invoice).",
"type": "string",
"enum": [
"invoice",
"proforma",
"prepayment"
]
},
"preview": {
"description": "true = only return a preview PDF, create no document.",
"type": "boolean"
},
"fulfillment_date": {
"type": "string",
"description": "Date of delivery / service (teljesítés), yyyy-mm-dd."
},
"due_date": {
"type": "string",
"description": "Payment due date, yyyy-mm-dd."
},
"issue_date": {
"description": "Issue date, yyyy-mm-dd (default: today).",
"type": "string"
},
"payment_method": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "Payment method text, e.g. Átutalás (bank transfer), Készpénz (cash), Bankkártya (card)."
},
"currency": {
"description": "Currency code (default HUF). Not HUF: exchange_rate_bank and exchange_rate are required.",
"type": "string",
"pattern": "^[A-Za-z]{2,3}$"
},
"exchange_rate_bank": {
"description": "Bank of the exchange rate, e.g. MNB (foreign currency only).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"exchange_rate": {
"description": "Exchange rate, HUF per 1 unit of the currency (foreign currency only).",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"language": {
"description": "Language of the invoice (default hu).",
"type": "string",
"enum": [
"hu",
"en",
"de",
"it",
"ro",
"sk",
"hr",
"fr",
"es",
"cz",
"pl",
"bg",
"nl",
"ru",
"si"
]
},
"comment": {
"description": "Comment printed on the invoice.",
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"order_number": {
"description": "Order number; also usable to find the invoice later. The account may forbid repeating an order number.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"external_id": {
"description": "Your own id for the invoice (szamlaKulsoAzon); lets you query it later.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"prefix": {
"description": "Invoice number prefix; must be registered in the account (Beállítások → Előtagok).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"paid": {
"description": "Mark the invoice as already paid.",
"type": "boolean"
},
"e_invoice": {
"description": "Issue an e-invoice (electronically signed). Default false; needs the e-invoice feature, else error 54.",
"type": "boolean"
},
"buyer_name": {
"type": "string",
"minLength": 1,
"maxLength": 512,
"description": "Buyer name."
},
"buyer_country": {
"description": "Buyer country name (default Magyarország).",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"buyer_postal_code": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Buyer postal code."
},
"buyer_city": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Buyer city."
},
"buyer_address": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "Buyer street address."
},
"buyer_email": {
"description": "Buyer e-mail address.",
"type": "string",
"maxLength": 254,
"pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
},
"buyer_tax_number": {
"description": "Hungarian tax number of a business buyer, e.g. 12345678-1-42. Not allowed on new-KATA accounts with protection on (error 491).",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"buyer_eu_tax_number": {
"description": "EU VAT number of the buyer.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"buyer_phone": {
"description": "Buyer phone.",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"buyer_comment": {
"description": "Note about the buyer.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"send_email_to_buyer": {
"description": "E-mail the invoice to buyer_email (default false).",
"type": "boolean"
},
"email_reply_to": {
"description": "Reply-to address of that e-mail.",
"type": "string",
"maxLength": 254,
"pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
},
"email_subject": {
"description": "Subject of that e-mail.",
"type": "string",
"minLength": 1,
"maxLength": 256
},
"email_body": {
"description": "Text of that e-mail.",
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"lines": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 512,
"description": "Line item name."
},
"quantity": {
"type": "number",
"minimum": 0.0001,
"maximum": 1000000000,
"description": "Quantity (up to 4 decimals are meaningful)."
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Unit of the quantity, e.g. db (pieces), óra (hours), kg."
},
"net_unit_price": {
"type": "number",
"minimum": -1000000000,
"maximum": 1000000000,
"description": "NET price of one unit in the document's currency (may have decimals; in HUF the line totals are rounded to whole forints)."
},
"vat_rate": {
"description": "VAT rate in percent as a number or text (27, 18, 5, 0), or a VAT code: AAM (VAT-exempt person), TAM (exempt supply), TAHK, EUT, EUKT, F.AFA (reverse charge), K.AFA, ... A code means no VAT amount.",
"type": [
"string",
"number"
]
},
"comment": {
"description": "Optional note printed on the line.",
"type": "string",
"minLength": 1,
"maxLength": 512
}
},
"required": [
"name",
"quantity",
"unit",
"net_unit_price",
"vat_rate"
]
},
"description": "Invoice lines."
}
},
"required": [
"fulfillment_date",
"due_date",
"payment_method",
"buyer_name",
"buyer_postal_code",
"buyer_city",
"buyer_address",
"lines"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}