Számláma for WooCommerce
| 开发者 | gelenfarkas |
|---|---|
| 更新时间 | 2026年11月13日 20:15 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
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)
- 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 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
- 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)
- Name on the invoice (with {name} for the name of the ordered product), unit, line note
- VAT marking of untaxed sales per product (e.g. TAM for an exempt training), goods or service
- "Intermediated service": the document gets the clause "The invoice includes intermediated services."
- 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
- 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)
安装:
- Install and activate the plugin (WooCommerce must be active).
- In Számláma, go to Settings → API keys and create a key with the WooCommerce plugin scope — one live and one test key.
- In WooCommerce go to Settings → Számláma, paste the keys, choose the mode (start with Test) and save.
- On the same page click Connect for the payment notifications (your shop must be on HTTPS).
- Set the document basics, the payment methods and the rules on the other tabs, then try a few test orders.
- Switch to Live mode.
屏幕截图:
常见问题:
Do I need a Számláma account?
Yes. The documents are issued in Számláma; the plugin is the connection between the shop and your account.
Is it free?
The plugin is free. Using Számláma is subject to its own terms.
What happens if Számláma cannot be reached?
The checkout never waits for Számláma: documents are issued in the background. Temporary errors are retried automatically (after 5, 30, 120 and 360 minutes); if a document still cannot be issued, you see it in the order notes, in an admin notice and optionally by e-mail.
Can an order be invoiced twice?
No. An order gets at most one live document of each type. Each request carries a unique identifier, so Számláma returns the existing document even if the same request arrives twice. After a storno the order can be invoiced again.
Can the customer ask for a receipt instead of an invoice?
Yes, enable receipts on the Checkout & receipts tab. A receipt cannot be issued above 900,000 HUF or to a customer with a tax number — then an invoice is issued (or an error is reported, as you choose).
Does it work with the block checkout?
Yes. The tax number, the company purchase checkbox and the receipt request appear in the "Additional order information" section of the block checkout. Hiding billing fields for receipts and the NAV lookup work in the classic checkout.
The payment notifications do not arrive. My shop is behind Cloudflare.
Cloudflare's bot protection may answer the notifications of Számláma with a challenge page ("Just a moment..."), which a server cannot pass. In Cloudflare, add a WAF custom rule with the action "Skip" for the path /wp-json/szamlama/v1/webhook (or allow the IP addresses of Számláma: 2.28.99.30 and 2a01:4f8:c016:d944::1). The notifications are signed, so the plugin only accepts genuine ones. Failed notifications are retried by Számláma for about 8 hours.
Does it work with WooCommerce Subscriptions?
Yes. Renewal orders get their own documents by the same rules (the "Order created" rules run for a new renewal order too), and the renewal e-mails wait for the document like the other order e-mails. The documents of the first order are never copied to the subscription or to the renewals.
Where do I see what happened?
In the order notes, in the Számláma box of the order and — in developer mode — in WooCommerce → Status → Logs (source: szamlama). API keys are never written to the log.
更新日志:
1.1.2
- Orders list, Számláma column: every document is shown on its own line with its type (e.g. "Pro forma invoice D-2026-7", "Invoice SZ-2026-15"). The pro forma stays in the list, muted, when an invoice is made from it, so the invoice appears below it and you can see which documents belong together.
- When the invoice was already made from the pro forma in Számláma (e.g. after the bank transfer was matched there) and the shop was not notified, setting the order to Completed no longer fails with "An invoice was already made from this document": the existing invoice is attached to the order (with an order note), and no second invoice is made.
- Payment methods table: a hint for cash on delivery and cash paid on the spot — tick "Mark as paid" when the invoice is issued after the money is received.
- New "Check for updates" link in the row of the plugin on the Plugins screen (next to "View details"). WordPress looks for plugin updates only twice a day; the link asks WordPress.org right away, and when there is a new version, the usual "Update now" link appears in the row. A notice on top of the screen tells the result, also when WordPress.org cannot be reached.
- New "Számláma" tab in the product data box: name on the invoice (with {name} for the product name), unit and line note (moved here from the Advanced tab), VAT marking of untaxed sales (e.g. TAM), goods or service, and "Intermediated service". When a product marked as intermediated service is on the order, the document gets the clause "The invoice includes intermediated services."
- Invalid product settings are not saved silently: a too long value is shortened and an invalid choice is refused, with an error notice on the product screen. A VAT marking set on a taxed product is not used on orders where WooCommerce charged tax (the invoice keeps the rate of the tax), and the order gets a note about it.
- WooCommerce Subscriptions: the renewal e-mails (processing / completed / on hold renewal order) wait for the automatic document and go out with its link — before, they were sent before the document was ready. A new renewal order runs the "Order created" rules. The documents of the first order are no longer copied to the subscription and its renewals (a renewal order with copied documents looked already invoiced and got no document); copies made by other plugins are ignored too.
- When a new document cannot be e-mailed to the customer, the order note says why (e.g. the "Links in e-mails" option is off, the order has no billing e-mail address, TEST document).
- A failure while sending a held order e-mail is written in the order notes instead of stopping the job.
- Clearer error messages: when a document cannot be issued, the order note, the admin notice and the e-mail now say what to do instead of developer texts. An invalid or revoked API key, a deleted document prefix or bank account, a live key without live invoicing or an unreachable server each get their own instruction; the hints sent by Számláma ("What to do") and the link of the Számláma page to fix it are shown too. A wrong customer tax number or address points to the billing details of the order.
- Failure e-mail: when the "Error notification" address is empty, the e-mail now goes to the site admin address (before, nobody got it). The e-mail says how to issue the document again. A document rejected by NAV gets its own e-mail subject and order note.
- The order note of a temporary error shows the reason and the attempt number.
- Security hardening: the NAV company lookup at checkout only works with a cart and is limited per visitor, per address and for the whole shop (it cannot be used to use up the API quota of the shop); payment notifications (webhooks) older than 28 days or without a delivery id are ignored, and a notification signed with the test secret cannot change a live document (or the other way round); a pro forma paid in Számláma and the automatic conversion of the order can no longer run at the same time; invalid signatures are logged at most every 10 minutes.
- Privacy: the PDF forwarded to further addresses is deleted from the server right after sending; the debug log no longer contains the customer's name, address, e-mail, phone or tax number.
- The manually entered webhook secret is checked (whsec_ + 40 characters).
- Uninstalling with "Delete the settings" also removes the cached data and the queued jobs of the plugin, and the temporary PDF folder is always removed.
- Automation: a note explains that the "Order created" event also issues documents for orders that are never paid.
- Tested with WordPress 7.1.4 and WooCommerce 11.2.2.
- Fix: a document issued automatically on a status change (e.g. the invoice made from the pro forma when the order is set to Completed) now reaches the customer. Automatic documents are issued in the background, after WooCommerce has sent the e-mail of the new status, so the e-mail went out without the new document. Now the On hold / Processing / Completed e-mail waits for the document (usually within a minute, at most 30 minutes) and goes out with its link; when no such e-mail is sent, the customer gets the "Order details" e-mail with the new document. New option on the Sharing tab, on by default.
- The documents are no longer attached to the e-mails as PDF: the customer gets the download link (the "PDF attachment" option was removed). Forwarding to further addresses (e.g. the accountant) still sends the PDF.
- Security hardening: the plugin itself also verifies the nonce of the settings, product and bulk order forms and of the checkout; the shop identifier is now random instead of being derived from the site salts.
- The failure notice is shown only on the WooCommerce order screens and on the Számláma settings tab.
- Translations are delivered by translate.wordpress.org.
- Fix: for a buyer outside the EU (e.g. Switzerland, USA, Serbia) the local tax ID given at checkout is now printed on the invoice and reported to NAV (third-country tax ID). Before, only the company name reached the invoice.
- Line note length: the WooCommerce data in the line note (variation attributes, item meta, e.g. long custom product options) is shortened with "…" above 200 characters by default. On the Line items tab it can be kept only when short, or left off entirely; the limit is adjustable (20–500 characters). The note of the product is always printed.
- Published on WordPress.org: updates now arrive through the WordPress updater.
- Tested with WordPress 7.1 and WooCommerce 11.2.
- FAQ: what to set in Cloudflare when the payment notifications do not arrive.
- OSS (EU One-Stop Shop): when WooCommerce charges the VAT rate of another EU country to a customer without an EU VAT number, an OSS invoice is issued with that rate (requires Számláma with the OSS registration date set in Company data). Számláma checks the rate for the destination country and the fulfilment date; an outdated rate (e.g. Romania 19%) is refused with the list of valid rates. OSS invoices are not reported to NAV. New option on the VAT tab (on by default).
- E-mails: download link of the storno invoice in the customer e-mails after the invoice of the order was cancelled (new option on the Sharing tab, on by default; own text in the "Own text and button" style).
- VAT: a tax rate that Számláma does not accept (e.g. the 19 % / 20 % / 23 % rate of an OSS sale to another EU country) is no longer rounded to the nearest Hungarian rate — the document is not issued, the order gets a note and the admin an e-mail, so no invoice is made with a wrong VAT rate.
- Buyer name: new option to print the company name even when no tax number was given (the buyer stays a private person for NAV).
- Notes: new condition "Customer note" (the customer wrote a note / no note), e.g. to print the note of the customer instead of the default text.
- E-mails: own text and button per document type (invoice, pro forma, receipt, advance invoice) instead of the "Documents" list, with {number} and {order_number}.
- Storno: new option to e-mail the storno invoice to the customer through Számláma (automatic and manual cancelling; never for test documents).
- HUF orders: line items are sent with whole-forint unit prices (a line is split when its total is not divisible by the quantity, e.g. 3 × 333.33 → 2 × 333 + 1 × 334), so the document total always equals the order total without fillér; discount, shipping and fee lines are whole forints; a rounding line is only sent for the cash 0/5 rounding.
- First release.