About this plugin
Számláma for WooCommerce connects your shop to Számláma, the Hungarian online invoicing service. Documents are issued in Számláma — with the numbering, the NAV Online Számla data reporting and the archiving handled there — automatically from your orders or with one click.
Documents
- Invoice (electronic or paper), pro forma invoice, receipt (e-receipt), delivery note, advance invoice
- Your own prefixes (numbering series) for each document type, chosen from your Számláma account
- Paid pro forma invoice → paid invoice automatically, in one step
- Storno of the invoice / voiding of the receipt when the order is cancelled or refunded
- Hungarian, English or German documents (or by the billing country)
Automation with rules
- Event: order created, payment completed, any order status (custom statuses of other plugins too)
- Conditions: payment method, shipping method, company / private customer, country, currency, order total, product category, receipt requested — all or any of them
- Fulfillment date (order / payment / completion date ± days), payment deadline, mark as paid
- Runs in the background with automatic retries; failures are reported in the order notes, in the admin and by e-mail
- Never twice: one live document per type and order, guaranteed on the Számláma side too
Payment and shipping methods
- Payment method on the document, payment deadline, “mark as paid” and the “Pay now” (online card payment) link per WooCommerce payment method
- Line name and VAT per shipping method
VAT
- Automatic from the WooCommerce tax rates, or with VAT markings in the tax rate name (AAM, TAM, FAD, KBAET, EUFAD37, ÁKK, ÁTHK, HO … and the EU / EUT / EUK / EUKT / MAA / F.AFA names used by other plugins)
- Mapping per tax class, subject-exempt (AAM) shops, EU company buyers (KBAET / EUFAD37), sales outside the EU (EAM / ÁTHK)
Checkout
- Tax number field: when a company name is entered, always, with a “company purchase” checkbox, or with private / company radio buttons
- Formal check of the Hungarian tax number and the EU VAT number
- Company name and address filled in from the NAV database after the tax number is typed
- “I ask for a receipt” option with hidden billing fields and disallowed payment methods
- Classic and block checkout (Cart & Checkout blocks), HPOS compatible
Payment notifications (webhook)
Számláma notifies the shop when a document is paid — by bank statement matching, online card payment or manually —, cancelled, or its NAV status changes. The plugin updates the order (status, notes) and makes the invoice from a paid pro forma invoice. The notification endpoint is registered in Számláma with one click; every notification is signed (HMAC-SHA256) and verified.
Sharing
- Download links in the WooCommerce e-mails; the order e-mail waits for the automatic document and goes out with its link
- Documents on the My account → Orders pages
- E-mail from Számláma, and forwarding of every new document to further addresses (e.g. your accountant)
Test mode
With a Számláma test API key every document is a TEST document: it gets a TESZT-… number, is not reported to NAV and does not use your numbering. You can try the whole flow — including the payment notifications — before going live.
External services
hu/api/v1 ), operated by Software-Wolf Kft. (Hungary), to issue and manage invoicing documents. It is required for the plugin to work, and it is only contacted after you enter your own Számláma API key.
What is sent and when:
- When a document is issued (automatically by your rules or when you click “Issue” / use a bulk action): the order number, the billing (and, if different, the shipping) name, company name, tax number, address, e-mail address and phone number of the customer, the ordered items with quantities, prices and VAT, the shipping and fee lines, the currency, the payment method and the dates of the document.
- When you check a document, mark it paid, cancel it, send it or download its PDF: the Számláma id of the document.
- When a customer types a Hungarian tax number at checkout and the NAV lookup is enabled: the first 8 digits of the tax number, to fetch the company’s name and address from the NAV database through Számláma.
- On the settings screen: requests to read your account status, numbering series, bank accounts and selectable values, and to register the notification (webhook) endpoint of your shop.
Számláma may send signed notifications to your shop’s REST endpoint ( /wp-json/szamlama/v1/webhook ) about your documents.
- Terms of use: https://szamlama.hu/aszf/
- Privacy policy: https://szamlama.hu/jogi/adatkezeles/