Open Settings → Plugins → Kros. Settings are grouped into five tabs: General, API Credentials,
Invoices, Webhooks, and Settings, plus an always-visible sidebar with core toggles and
read-only rate-limit info.
General
| Field | Description |
|---|
| Due date days | The invoice due date is calculated from the invoice creation date plus this number of days. Required. |
| Invoice PDF Report ID | KROS report template ID used to render the invoice PDF. KROS report IDs: 17 (black and white), 19 (color), 101 (editable). Required. |
| Generate invoice when | Multi-select of order statuses. An invoice is generated automatically only when the order reaches one of the selected statuses. Required. |
| Configurable Product Pricing | How configuration prices are handled on the invoice: fold them into the main product price (invoice total unchanged, configuration price shown as zero), or keep them as separate, individually listed items. |
| Send Invoice when order is Paid | Present in the settings form, but as of v1.3.0 this toggle has no effect -- it isn't read by any invoice-creation or -sending code. Use Generate invoice when for automatic invoice creation. |
| Show Kros Button | When enabled, adds a button to the order edit page to manually create, update, or download the invoice for that order. |
API Credentials
| Field | Description |
|---|
| API Base URL | Base URL for the KROS OpenAPI, e.g. https://api-economy.kros.sk. Required. |
| API Token | Bearer token generated in KROS Fakturácia under "API prepojenia". Required. |
| Test Credentials | Button that sends a lightweight request to the KROS API using the saved base URL/token and reports success or failure as a CP notice/error. |
| Numbering Sequence | Optional numbering sequence code (e.g. OF). Leave empty to use the default KROS sequence. |
Invoices
| Field | Description |
|---|
| Invoice Language | The invoice language. Options: Czech, German, English, Slovak. Required. |
| Opening Text | Optional text shown above the invoice items. |
| Closing Text | Optional text shown below the invoice items. |
| Store Remote Invoices in Database | When enabled, invoices retrieved via the API are cached in the plugin's own database tables, reducing the number of KROS API requests needed to render the Kros → Invoices list. |
| Increment the last remote invoice number | When enabled, the remote invoice number is incremented automatically by KROS instead of using the order number as the variable symbol. |
The order's increment ID is used as the invoice's variable symbol and must be 10 characters or fewer
to be accepted by KROS; orders with a longer increment ID fail invoice creation with a validation error.
Webhooks
| Field | Description |
|---|
| Enable Webhooks | When enabled, the plugin accepts and processes incoming webhook events at kros/webhooks/receive. As of v1.3.0 saving this setting does not itself create, update, or delete the webhook on the KROS side -- the webhook must be registered manually in KROS Fakturácia, pointed at Webhook URL. |
| Webhook URL | Public URL KROS should call. Leave empty to use the plugin's default action URL. |
| Webhook Secret | Secret used to validate the HMAC-SHA256 signature of incoming webhook requests. Required for webhooks to function -- if Enable Webhooks is on and no secret is set, the settings page shows a security warning and every incoming webhook request is rejected (fails closed). |
| Signature Header | Header name carrying the request signature. Defaults to X-Kros-Signature. |
| Webhook ID | Read-only field intended to hold the ID KROS returns after registering the webhook. Since registration isn't automatic in v1.3.0, this stays empty unless set directly in the database/config. |
| Webhook Events | Multi-select of KROS events to subscribe to: Invoice created, updated, deleted, sent, paid. Only takes effect once webhook registration is wired up or performed manually. |
Settings
| Field | Description |
|---|
| VAT Payer Type | One of Non-payer, VAT payer, or Registered VAT payer (§7/7a). Required. |
| Tax Class | The store tax category (or None (0%)) applied to invoice items by default. Required. |
| Shipping Method as item | Adds the order's shipping method as its own line item on the invoice. |
| Payment Method as item | Adds the order's payment method as its own line item on the invoice. |
| Zero Total Orders | Whether an invoice should still be created when the order's grand total is zero. |
Shown in the settings page sidebar regardless of the active tab:
| Field | Description |
|---|
| Enabled | Master on/off switch for the Kros integration and its invoice provider. |
| Show in CP Section | Adds the Dashboard and Invoices pages to the Kros CP navigation. The Settings and License pages are always shown. |
| Rate Limit / Remaining / Reset | Read-only fields showing the request limit, remaining requests, and reset time reported by the KROS OpenAPI on the last response. Updated automatically; not editable. |
Where this is used
- API Base URL and API Token are used for every KROS API call, whether triggered automatically by
Generate invoice when, manually from the order edit page, or through an MCP-driven invoice action.
- VAT Payer Type, 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 Kros Button controls whether the order edit page exposes manual create/update/download actions
-- see the Developer API for the underlying component.
- Enable Webhooks, Webhook Secret, and Webhook Events control whether KROS-side invoice changes
are synced back into the plugin's local invoice cache -- see the Developer API for the
webhook flow.
- See the Kros overview for how these settings fit into the invoice provider and MCP tools.