Skip to main content
A courier account connects Omnilinker to your account with a carrier. Omnilinker uses it to create shipments, fetch labels and poll tracking. You need at least one courier account before you can create a shipment from an order; see Shipments, labels and tracking. You can connect several accounts of the same carrier, for example two InPost organizations. Each account of a carrier needs its own name.

Before you start

  • The Shipping module is enabled. Look for Shipments in the main menu. If it is missing, the module is turned off for your organization (the feature Enable the Shipping module). Ask Omnilinker to enable it; see Modules and feature availability.
  • You have the permissions. To see the page you need Courier accounts. To add, edit, test or delete accounts and to save the InPost Geowidget token you need Manage courier accounts. See Permissions.
  • You have the carrier’s API credentials. They are listed per carrier in What each carrier asks for.

Supported carriers

Apaczka is an aggregator: one Apaczka account gives you the services of the carriers available in your Apaczka account. Omnilinker stores every label as a PDF. The ZPL copy, when the carrier provides one, is for thermal label printers at a station; see Print labels. Furgonetka is named on the page as coming soon. It is not available yet and does not appear in the list of providers.

Add a courier account

1

Open the courier accounts page

Open Shipments > Courier accounts.
2

Start a new account

Click Add courier account. If you have no accounts yet, the page shows Connect your first courier account with a tile per carrier; click the carrier’s tile instead.
3

Name the account and choose the carrier

  • Name: a name your team will recognize, for example “InPost — main store”. Required, up to 128 characters, and different from your other accounts of the same carrier.
  • Provider: choose InPost, DPD or Apaczka. You cannot change the provider after you save the account.
4

Choose the environment

For InPost, choose Production (the default) or Sandbox under Environment. Choose Sandbox only if you have InPost sandbox credentials: production credentials do not work in the sandbox.DPD and Apaczka show Production only. instead. For Apaczka, every shipment you create is a real charge.
5

Enter the credentials

Fill in the fields under Credentials. They differ per carrier; see What each carrier asks for. Fields marked * are required.
6

Save and test

Click Save and test to save the account and check the connection straight away, or Save to save it only.
Omnilinker stores the credentials encrypted. After you save, it never shows them again; the Credentials column only says Configured or None. Below the form, Provider capabilities shows what the carrier supports in Omnilinker: Cancellation, Point picker, Rate quoting, Sandbox and Aggregator. A capability marked ✕ is not available for that carrier.

What each carrier asks for

A successful test shows “Connected to InPost ShipX as organization ’…’.” with your organization’s name.If you use InPost parcel lockers, also add the Geowidget token; see InPost settings.

Sender address and pickups

The courier account form has no sender address, default service or pickup settings.
  • InPost: Omnilinker does not send a sender address; the shipment is created in your InPost organization.
  • DPD and Apaczka need a sender address, and you cannot enter one in Omnilinker yet.
Until a sender address can be set, creating a DPD or Apaczka shipment fails with “The shipment draft is invalid.”. You can still add the account and test the connection.
Omnilinker does not order courier pickups. Arrange a pickup in the carrier’s own panel, or drop the parcels off yourself. Apaczka shipments are booked with Apaczka’s SELF pickup type.

Test the connection

Click Test on the account’s row, or Save and test in the form. While the test runs, the row shows Testing…. The result appears in a strip under the row, Connection works or Test failed, with the carrier’s message. The strip closes by itself after 15 seconds, or when you click ×. The Connection state column keeps the last result and when it was taken: Connection health above the table counts your accounts as connected, needing attention or not tested. The test only runs when you click it. Omnilinker does not re-test accounts on a schedule.

Edit an account

1

Open the form

Click the pencil icon (Edit) on the account’s row. The form is titled **Edit account — ** followed by the account name.
2

Change the name or environment

You can change Name and, for InPost, Environment. Provider is locked.
3

Replace the credentials, if needed

The saved credentials are hidden. To replace them, click Change credentials and fill in every required field: the new values replace the whole saved set. If you leave a required field blank, Omnilinker keeps the current credentials. Click Cancel credential change to go back.
4

Save

Click Save or Save and test.

Delete an account

1

Start the delete

Click the trash icon (Delete) on the account’s row. The Delete this courier account? dialog opens.
2

Confirm

Tick I understand the consequences and click Delete account.
After you delete an account:
  • Its shipments and their tracking history stay in Omnilinker.
  • You cannot create new shipments on it.
  • Omnilinker stops polling tracking for its shipments, and you can no longer cancel them from Omnilinker.
You cannot switch an account off without deleting it. To use it again, add it again with the same credentials.

InPost settings

Once you have at least one InPost account, the InPost settings section appears below the accounts table. It holds the InPost Geowidget token, which turns on the map for choosing a parcel locker when you create an InPost locker shipment.
  • The token is optional. Without it, you type the locker code by hand in the shipment form.
  • It is a public site token for InPost’s Geowidget, not your ShipX access token. The field suggests taking it from the InPost Manager panel.
  • One token applies to your whole organization, even if you have several InPost organizations connected.
To save it, paste the token into InPost Geowidget token and click Save. You need Manage courier accounts.

Permissions

The shipment permissions are listed in Shipments, labels and tracking. See Permissions reference for how to grant permissions.

Create a shipment

Create a shipment from an order, print its label and follow tracking.