Skip to content

Settings

Open Add-ons > Manage add-ons > InPost Shipping & Labels > Settings.

Setting Default Description
Enable On When off, no new work is started. Jobs and webhooks of work that is already under way are still processed.
Marketplace owner mode On On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account.
Debug log Off Also stores every HTTP call with masked request and response. Secrets are never stored.
Log retention (days) 90 Older log entries are removed by the cron run.
Default locker size A (small) Template used when the products have no box size: A (8 x 38 x 64 cm), B (19 x 38 x 64 cm), C (41 x 38 x 64 cm), up to 25 kg.
Locker price, size A / B / C empty The price the customer pays for a parcel of that size (store currency).
Courier price empty The price for InPost Courier.
Courier parcel size (cm) 40x30x15 Length x width x height used for courier parcels when the products have no box size.
Sending method (lockers) parcel_locker How you hand the parcels to InPost (ShipX sending_method: parcel_locker, any_point, pop, branch, dispatch_order). With dispatch_order you must also order a courier pick-up in the Parcel Manager.
Label format PDF PDF or ZPL (thermal printers).
Label type (lockers) Normal Normal or A6. Courier labels are always A6 (InPost documents no A4 type).
Cash on delivery payment method empty Orders paid with this method are sent with the order total as COD in PLN. Empty = no COD.
Insure at the order total Off Adds an insurance amount equal to the order total (PLN). Courier shipments with COD are always insured (InPost requires it).
Create the label when the order status becomes empty Empty = create labels by hand on the order page.
Also create a CS-Cart shipment On Records the tracking number as a regular shipment so the customer’s notifications show it.
Fallback shipping rate empty Used when the size rate is empty. Empty = hide the method.

Prices: ShipX has no public price list for a shop’s customers, so the shipping price at checkout is the rate you enter. COD and insurance are sent in PLN; if the store’s main currency is not PLN, add the currency PLN to the store and the amount is converted with your store’s exchange rate.

Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again; leave a secret field empty to keep the saved value.

Field Description
Mode Test uses the sandbox values and the ShipX sandbox host; Live uses the production values and the production host.
Organization ID From Parcel Manager > My Account > API. Part of every ShipX path.
API token From the same page; sent as Authorization: Bearer.
Geowidget token Public token of the InPost Geowidget map (same page, Geowidget). Without it customers type the locker code instead of using the map.
Webhook URL Shown for copying into the Parcel Manager. Contains a secret key.

The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:

  • php /path/to/store/admin.php --dispatch=kv_inpost.cron
  • https://your-store.example/index.php?dispatch=kv_inpost.cron&key=<secret>
  • Log lists every call, job and webhook with filters (level, action, text, dates) and a CSV export.
  • Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again.

In the vendor panel a vendor sees only their own records. With the marketplace owner mode off the vendor also gets the Connection tab for their own organization.