Számlázz.hu MCP by usefulapi MCP Server

Look up a Hungarian taxpayer in the NAV register by the first 8 digits of the tax number (the törzsszám): whether the number is valid, the taxpayer's name, VAT status and addresses. Számla Agent action-szamla_agent_taxpayer (data from the NAV Online Invoice platform).

ISSUES 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.

ISSUES a real HUF receipt (nyugta). Receipts are fiscal (NAV reporting) and can only be cancelled by szamlazz_reverse_receipt, never deleted. Give each line's whole-forint gross_total and vat_rate: the tool derives net, VAT and unit price (net + VAT equals gross exactly, as the vendor demands). The receipt prefix must be a receipt-only prefix (capital letters and digits, e.g. NYGTA), not an invoice prefix. call_id is required: the vendor refuses a second receipt with the same call_id (error 338), which protects against a duplicate. NEVER retried automatically: if the result is unclear, ask the user, then repeat the call with the SAME call_id (error 338 means the receipt already exists; find it in Számlázz.hu). Számla Agent action-szamla_agent_nyugta_create.

DELETES one pro forma invoice (díjbekérő) by its number or by its order number (give exactly one). Only pro forma invoices can be deleted; a real invoice is never touched (use szamlazz_reverse_invoice). Cannot be undone. Számla Agent action-szamla_agent_dijbekero_torlese.

Read the data of one issued invoice (seller, buyer, lines, totals, VAT breakdown, payments) by invoice number, order number or your external id (give exactly one; for an order number with several invoices the last one is returned). Only invoices issued in this Számlázz.hu account. Also use it to check whether an invoice exists before issuing again. Számla Agent action-szamla_agent_xml.

Download the PDF of one issued document (invoice, pro forma, ...) by invoice number, order number or your external id (give exactly one). Returns the totals and the PDF as an embedded resource. Számla Agent action-szamla_agent_pdf.

Read one issued receipt (nyugta) by receipt number: lines, payments, totals, whether it was reversed. Optionally the PDF. Számla Agent action-szamla_agent_nyugta_get.

Records 1-5 payments (kifizetés) on one of your own issued invoices or pro forma invoices, which updates its paid amount and outstanding balance. By default the payments are ADDED to the existing ones; replace_existing true REPLACES all earlier payment entries of the invoice. Not fiscal. Számla Agent action-szamla_agent_kifiz.

ISSUES a reversal (storno) invoice that cancels one issued invoice. Fiscal: it is reported to NAV and cannot be undone; the original stays in the books. A reversal needs the invoice number of a real invoice. NEVER retried: if the result is unclear, check with szamlazz_get_invoice before trying again. Számla Agent action-szamla_agent_st.

ISSUES a reversal (storno) receipt that cancels one issued receipt. Fiscal and irreversible; a receipt can be reversed once, and a reversal receipt cannot be reversed. NEVER retried: if the result is unclear, check with szamlazz_get_receipt before trying again. Számla Agent action-szamla_agent_nyugta_storno.

E-MAILS an already issued receipt (PDF) to a customer. Without the e-mail fields, the vendor re-sends the receipt with the settings of the earlier e-mail. The e-mail cannot be recalled. Számla Agent action-szamla_agent_nyugta_send.