Skip to main content
Version: 2.0.0

Settings

Open Pohoda → Settings. The screen has two sections in the sidebar tabs, General and Advanced; changes on either tab are saved together.

General

FieldDescription
mServer EndpointFull URL to the POHODA mServer endpoint, e.g. https://example.tld:444/mserver/service. Required to enable the integration.
Username / PasswordBasic-auth credentials sent as an STW-Authorization header. Leave blank if the mServer doesn't require auth.
API keyOptional secret sent as X-API-Key when the POHODA gateway sits behind an API-key-checking proxy.
Company ID (ICO)POHODA company identifier (ico), included on every generated data pack when set.
Application nameIdentifies this integration to POHODA in the application attribute of every request. Required; defaults to Craft CMS.
Default currencyISO 4217 code (e.g. EUR) used when an order/item doesn't specify its own currency.
Default country codeISO 3166-1 alpha-2 code (e.g. SK) used for customer addresses that omit a country.
Default VAT codePOHODA VAT rate id (e.g. high, low, none) used when an item/order line doesn't specify its own.
Default warehousePOHODA warehouse (storage) identifier used on stock exports when an item doesn't specify one.
EnableMaster switch (in the sidebar Details pane). Every export/import call fails fast with a clear error while disabled.

Advanced

FieldDescription
HTTP timeout (seconds)Request timeout passed to the underlying Guzzle client. Defaults to 30.
List batch sizeDefault page size used by listStockRequest/listOrdersRequest when a console command or service call doesn't override limit. Defaults to 100.
Log XML payloadsWhen on, every request/response XML body is written to Craft's log — invaluable for diagnosing mapping/schema issues, but verbose; leave off in normal operation.

Use mServer API, Export path, and Stock export request XML also appear on this tab and are saved on the plugin's settings model, but as of v1.2.0 no active service reads them — ItemsService and OrdersService always send XML to the mServer endpoint regardless of these values. Changing them currently has no effect. Use the Import POHODA XML action below for the supported no-mServer stock workflow instead.

The Advanced tab also has two actions:

  • Test connection — sends a minimal pohodaTest request using the values currently in the form (including unsaved edits) and reports success/failure inline. Run this after any endpoint or credential change, before relying on scheduled sync.
  • Import POHODA XML — uploads a POHODA list-response XML file and parses it straight into the item buffer, without calling the mServer API. Use this when POHODA can produce an export file but the server running Craft can't reach the mServer directly (see Use Cases).

Permissions

The Items and Settings CP sections require the accessPlugin-pohoda permission on top of general CP access, same as any other yStore/craft-core plugin section.