Issue an invoice (fiscal, cannot be undone)
szamlazz_create_invoiceISSUES a real invoice in Számlázz.hu. A final invoice is reported to NAV (Online Számla) and can only be cancelled by a reversal (szamlazz_reverse_invoice), never deleted. kind: invoice (default), proforma (díjbekérő; not fiscal, can be deleted with szamlazz_delete_proforma), prepayment (előlegszámla). The tool computes net, VAT and gross of every line from net_unit_price and vat_rate. preview true builds the PDF only and creates NO document (check the reply: a returned invoice_number means a document WAS created). This call is NEVER retried: if the result is unclear, look the invoice up (szamlazz_get_invoice by order_number or external_id) before issuing again; always send external_id or order_number so that you can. Setting send_email_to_buyer e-mails the PDF to the buyer. Számla Agent action-xmlagentxmlfile.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | invoice (default), proforma (non-fiscal payment request) or prepayment (down-payment invoice). | |
| paid | No | Mark the invoice as already paid. | |
| lines | Yes | Invoice lines. | |
| prefix | No | Invoice number prefix; must be registered in the account (Beállítások → Előtagok). | |
| comment | No | Comment printed on the invoice. | |
| preview | No | true = only return a preview PDF, create no document. | |
| currency | No | Currency code (default HUF). Not HUF: exchange_rate_bank and exchange_rate are required. | |
| due_date | Yes | Payment due date, yyyy-mm-dd. | |
| language | No | Language of the invoice (default hu). | |
| e_invoice | No | Issue an e-invoice (electronically signed). Default false; needs the e-invoice feature, else error 54. | |
| buyer_city | Yes | Buyer city. | |
| buyer_name | Yes | Buyer name. | |
| email_body | No | Text of that e-mail. | |
| issue_date | No | Issue date, yyyy-mm-dd (default: today). | |
| buyer_email | No | Buyer e-mail address. | |
| buyer_phone | No | Buyer phone. | |
| external_id | No | Your own id for the invoice (szamlaKulsoAzon); lets you query it later. | |
| order_number | No | Order number; also usable to find the invoice later. The account may forbid repeating an order number. | |
| buyer_address | Yes | Buyer street address. | |
| buyer_comment | No | Note about the buyer. | |
| buyer_country | No | Buyer country name (default Magyarország). | |
| email_subject | No | Subject of that e-mail. | |
| exchange_rate | No | Exchange rate, HUF per 1 unit of the currency (foreign currency only). | |
| email_reply_to | No | Reply-to address of that e-mail. | |
| payment_method | Yes | Payment method text, e.g. Átutalás (bank transfer), Készpénz (cash), Bankkártya (card). | |
| buyer_tax_number | No | Hungarian tax number of a business buyer, e.g. 12345678-1-42. Not allowed on new-KATA accounts with protection on (error 491). | |
| fulfillment_date | Yes | Date of delivery / service (teljesítés), yyyy-mm-dd. | |
| buyer_postal_code | Yes | Buyer postal code. | |
| exchange_rate_bank | No | Bank of the exchange rate, e.g. MNB (foreign currency only). | |
| buyer_eu_tax_number | No | EU VAT number of the buyer. | |
| send_email_to_buyer | No | E-mail the invoice to buyer_email (default false). |