Settings

Open Settings → Plugins → Szamlazz.hu. Fields are laid out under three tabs -- General, API Credentials, and Settings -- plus a details sidebar shown on every tab.

Sidebar (every tab)

Field	Description
Enabled	Turns the plugin's invoicing behavior on. When disabled, API Key is not required.
Show in CP Section	Adds the Dashboard and Invoices pages to the Szamlazz.hu CP navigation. The Settings and License pages are always shown. Default: on.
Sandbox Mode	Reduces the Szamlazz.hu API client's log level to errors only, useful while testing. Site-overridable.

General

Field	Description
Invoice name	The invoice name shown only inside the Szamlazz.hu system. {increment_id} is replaced with the order number. Required. Default: Invoice for order #{increment_id}.
Invoice number (Formatted)	Formatted invoice number pattern (max 10 characters). Supports YYYY (current year) and OOOO (order number). Required. Default: YYYYOOOO.
Due date days	The due date is calculated from the invoice creation date plus this number of days. Required. Default: 8.
Generate invoice when	Multi-select of order statuses. Invoice creation is triggered through yStore's shared invoicing system only when the order reaches one of the selected statuses. Required. Default: complete.
Delete invoice when the order status is	Multi-select of order statuses. When an order reaches one of these, its existing invoice is deleted (stornoed) automatically. Default: canceled.
Hide Szamlazz controls when an order has one of these statuses	Multi-select. Orders in any of these statuses hide the plugin's order-edit buttons and restrict the manual create/preview/download/regenerate/delete actions. Does not affect automatic invoice creation or deletion, which are controlled independently by Generate invoice when and Delete invoice when the order status is. Required. Default: canceled, closed, fraud, holded, payment_review.
Configurable Product Pricing	How configuration/variant prices are represented on the invoice: exclude (default; keep configuration prices as separate, individually listed items) or include (fold all configuration prices into the main product price, configurable item price set to zero).
Send Invoice to customer in email	When enabled, the invoice PDF is emailed to the customer automatically once created. Reveals Send invoice when.
Send invoice when	Multi-select of order statuses (shown only when the above is on). The invoice is emailed only when the order reaches one of these statuses. Required if shown.
Soft delete invoices	When enabled (default: on), deleting an invoice archives its local record instead of removing it, keeping a read-only copy available to admins.
Use queue for invoice generation	When enabled, invoice generation runs via Craft's queue instead of inline, so a slow API call doesn't block order completion.
Show Szamlazz Button	Adds a menu to the order edit page to manually create, preview, download, delete, or regenerate the invoice for that order.

API Credentials

Field	Description
API Key	The Agent API key provided by Szamlazz.hu. Required whenever the plugin is enabled. Site-overridable.
Log E-mail	An email address Szamlazz.hu notifies if something goes wrong during an Agent API operation. Site-overridable.

Settings

Field	Description
Invoice Creation Type	Order (default) generates a single invoice for the whole order; Item generates a separate invoice per line item, useful for multi-supplier or partner-based fulfillment. Required.
Market (Country)	The Szamlazz.hu market to invoice against: Slovak or Czech. Required. Site-overridable.
Language	The invoice language: Czech, German, English, or Slovak (default). Required. Site-overridable.
Tax Payer	Whether the store is a VAT payer; select No to omit VAT from invoices entirely. Default: Yes. Required.
Tax Class	The tax category applied to invoice items, or None (0%). Required.
Shipping Method as item	Adds the order's shipping method as its own invoice line item. Default: on.
Payment Method as item	Adds the order's payment method as its own invoice line item. Default: on.
Zero Total Orders	Whether an invoice should still be created when the order's grand total is zero. Default: on.
Resync invoices	Button. Queues a background job that relinks stored invoice PDFs to their database records by matching the order number -- use this after restoring assets or a database that lost the PDF/record link.

Company ID is also site-overridable, alongside API Key, Log E-mail, Sandbox Mode, Market (Country), and Language (Settings::siteOverridableAttributes()), so a multi-site store can invoice against different Szamlazz.hu accounts/markets per site.

License

Szamlazz.hu → License activates and displays the status of the plugin's commercial license, shared with the rest of the yStore plugin suite's license activation/status UI.

Where this is used

• API Key (resolved per site) is used for every Szamlazz.hu API call, whether triggered automatically through yStore's invoicing system, manually from the order edit page, or via the console commands and MCP tools -- see the Developer API.
• Tax Payer, Tax Class, Shipping/Payment Method as item, and Configurable Product Pricing affect how each invoice line's tax and totals are calculated and presented.
• Show Szamlazz Button controls whether the order edit page exposes manual create/preview/download/ delete/regenerate actions -- see the Developer API for the underlying component.
• Use queue for invoice generation and Soft delete invoices affect operational behavior (blocking vs. asynchronous creation, and whether deleted invoices are recoverable) without changing what's sent to Szamlazz.hu.
• Every invoice creation attempt (success, failure, or error) reports invoice.created, invoice.failed, or invoice.error notifications through yui/craft-core's shared notification system, visible wherever the store surfaces plugin notifications.
• See the Szamlazz overview for how these settings fit into the invoice provider, dashboard, and MCP tools.