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.
What each carrier asks for
- InPost
- DPD
- Apaczka
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.
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.
- 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.
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.
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.