Open Settings → Plugins → iDoklad. Settings are grouped into four tabs: General, API
Credentials, Diagnostics, and Settings, plus an always-visible sidebar with core toggles.
General
| Field | Description |
|---|
| Invoice name | The invoice name shown in iDoklad. {increment_id} is replaced with the order's increment ID. Required. |
| Invoice number (Formatted) | Formatted invoice number pattern (max 10 characters). Supports YYYY (current year) and OOOO (order number). Required. |
| Due date days | Number of days added to the invoice creation date to calculate the due date. 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. |
| Send Invoice when order is Paid | Present in the settings form, but not yet wired to any invoice-sending logic in v1.3.0 -- enabling it has no effect. |
| Show iDoklad 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 |
|---|
| Client ID | The OAuth2 Client ID from your iDoklad application. Required. |
| Client Secret | The OAuth2 Client Secret from your iDoklad application. Required. |
| Redirect Uri | Must exactly match the Redirect URI configured for your iDoklad OAuth2 app (protocol, host, path, and trailing slash all included). Defaults to the current settings page URL. Required. |
Once all three fields are filled in, an Authentication button appears. It sends you through iDoklad's
OAuth2 consent screen; on return, the plugin exchanges the authorization code for an access/refresh token
pair and stores it. If iDoklad reports the client application as unknown or unauthorized, double-check the
Client ID/Secret and make sure the Redirect URI is identical in both places -- authorization codes are
single-use, so a failed attempt requires starting the Authentication flow again.
Diagnostics
| Item | Description |
|---|
| Test Connection | Runs a lightweight iDoklad API request (a 1-row NumericSequences lookup) using the saved OAuth credentials, and reports success or failure as a CP notice/error. |
| Recent API Errors | Table of the last 10 iDoklad-related error log entries (timestamp, message, request context), sourced from the store's error logs. Empty when no errors have been logged. |
Settings
| Field | Description |
|---|
| Market (Country) | The country the store operates from: Slovak or Czech. Required, but not yet read by invoice creation in v1.3.0 -- every invoice is currently created with the contact country hard-coded to Slovakia. |
| Language | The invoice language. Options: Czech, German, English, Slovak. Required, but not yet applied to the report language sent to iDoklad in v1.3.0 -- invoices are currently always requested in Slovak. |
| Tax Payer | Whether the store is registered as a VAT/tax payer. Required, but not read by invoice creation in v1.3.0 -- VAT is calculated from the store-wide Tax Payer setting (yStore core), not from this plugin field. |
| Tax Class | The store tax category (or None (0%)) applied to the invoice by default. Required, and genuinely applied when calculating item, shipping, and payment line amounts. |
| Rounding type | Options: Whole document, Per item (default), or Retail. Required, but not yet read by invoice creation in v1.3.0 -- changing it has no effect on the generated invoice. |
| Signature | Whether to show a signature line on the invoice. |
| Payment Info | Whether to show payment information on the invoice. |
| By Square | Whether to show a Pay by Square QR payment code on the invoice (Slovakia). |
| 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. |
Shown in the settings page sidebar regardless of the active tab:
| Field | Description |
|---|
| Enabled | Master on/off switch for the iDoklad integration and its invoice provider. |
| Show in CP Section | Adds the Dashboard and Invoices pages to the iDoklad CP navigation. The Settings and License pages are always shown. |
| Sandbox Mode | Present in the settings form, but not yet read by the API or invoice services in v1.3.0 -- enabling it does not change invoice-creation behavior. |
Where this is used
- Client ID, Client Secret, and Redirect Uri are used for the OAuth2 handshake and every
subsequent iDoklad API call, whether triggered automatically by Generate invoice when or through a
manual/MCP-driven invoice action.
- Tax Class affects how each invoice line's tax and totals are calculated. Tax Payer, Rounding
type, Market (Country), and Language are configurable but not yet applied by invoice creation in
v1.3.0 -- VAT is instead controlled by the store-wide Tax Payer setting.
- Show iDoklad Button controls whether the order edit page exposes manual create/update/download
actions -- see the Developer API for the underlying component.
- See the iDoklad overview for how these settings fit into the invoice provider and MCP
tools.