Shipping Providers: how this screen works
The Shipping Providers screen holds your carrier accounts, for example UPS or PostNL. Each account tells QrX which carrier to use, with which login details, and which shipping methods (method profiles) you can choose when you create a shipment. This guide explains the list and the account editor.
What you see on this screen
Add Provider (top right): add a new carrier account.
Search by name, provider…: start typing and the list updates.
Refresh (the round arrow): reloads the list.
Customs (below the list): your default HS code for shipments outside the EU (see below).
The account list: one row per carrier account. Click a row to open it. The list loads more accounts automatically as you scroll. Changes made elsewhere (for example by a colleague) show up on their own.
The columns in the list
The carrier logo.
Display Name: the name you gave the account, for example "UPS Europe Account".
Provider: the carrier.
Channel: the merchant channel the account is for, or All channels.
Default Method: the method profile that is used by default for new shipments with this account.
Contract: Own contract means you ship on your own carrier contract. QrX priced means the account runs on a QrX carrier contract and QrX sets the shipping price.
Active: the switch turns the account on or off. Inactive accounts cannot be used to create shipments. The change is saved right away.
Updated and Created: when the account was last changed and when it was added.
Click a column title (Display Name, Provider, Updated, Created) to sort the list by it. Click again to reverse the order.
Edit or delete an account
Move your mouse over a row to see the icons at the end of it:
Edit (pencil): opens the account.
Delete (bin): asks you to confirm, then removes the account. Tip: switch an account off with the Active switch if you might need it again later.
Add or edit a provider account
Click Add Provider or click an account in the list. At the top you see Create Provider Account or Edit Provider Account and two buttons:
Save: saves the account. After you create a new account, it stays open so you can add method profiles.
Cancel or the back arrow: go back to the list without saving.
Account Details
Shipping Provider (required): the carrier. It cannot be changed after the account is created.
Display Name (required): a name you recognise.
Merchant Channel: link the account to one channel, or leave it on None (all channels).
Sender address (optional): the sender address for shipments with this account. Leave it on Use the default sender address to use your default. A sender you pick on a shipment still comes first. You manage addresses on the Addresses screen.
Active: inactive accounts are not available when you create shipments.
Customer's own contract (for carriers other than UPS and PostNL): keep it on when you ship on your own carrier contract. QrX then only creates the label and does not price or block the shipment. If QrX prices this carrier for you, the switch is locked and shows "QrX prices this carrier, contact QrX to change." When you switch it off and press Save, QrX first asks Let QrX price this carrier?. After you confirm with Yes, let QrX price it, you cannot switch back to your own contract yourself; only QrX support can. Shipments with this carrier are blocked while QrX has no price for a lane.
UPS account settings
For a UPS account the right side shows UPS account settings. The box at the top shows the contract type:
Your own UPS contract: labels are created with your UPS login details. Fill in Client ID, Client secret, Account number and Shipper number from your UPS developer account. Once the secret is saved, the field stays empty and shows "Secret configured. Leave blank to keep it."
QrX UPS Payment On Delivery: QrX manages the UPS account for you. You can only change the printing options.
The contract type is marked Locked; you cannot change it here.
Test mode: use the UPS test environment. On a QrX managed account only QrX Support can turn this on.
Label format: Standard (4x6) or Extended (4x8 combined).
Label print mode: ZPL (for label printers) or PDF.
Carrier document copies: how many copies of carrier documents to print (1 to 20).
Print carrier documents with labels: send carrier documents to the printer together with the shipping labels.
UPS dangerous goods agreement (only on your own UPS contract): switch it on only when your UPS contract has a dangerous goods agreement. Parcels with dangerous goods (for example lithium batteries) are then declared to UPS on UPS Standard within the EU. QrX needs the UPS dangerous goods declaration of each item (Stock, the item, tab Storage and dangerous goods); a label is refused while a value UPS needs is missing. With the switch off, orders with dangerous goods follow your dangerous-goods rules as before.
QrX's UPS contract (QrX UPS Payment On Delivery) cannot ship dangerous goods. An order with dangerous goods never gets a label on it: choose another shipping method for such orders.
UPS Track Alert
On a saved UPS account you also see the UPS Track Alert card. It lets UPS send tracking updates to QrX in real time. On your own UPS contract, click Show webhook setup to see the Webhook URL, Client ID, Client Secret and Token Endpoint. Paste these in your UPS developer app under Manage Webhook Credentials, UPS Track Alert, choose OAuth 2.0 and save. On a QrX managed account QrX sets this up for you.
PostNL account settings
For a PostNL account the right side shows PostNL account settings.
When you create the account, choose Your own PostNL contract or, when it is offered, QrX PostNL account (QrX manages its login details and environment).
For your own contract fill in Customer number (up to 10 digits), Customer code (up to 4 letters), Sandbox API key and Production API key. A saved key shows "Key saved. Leave blank to keep it."
Environment: Sandbox (test) or Production (real shipments). Each environment uses its own API key.
Verify: checks your account and barcode access by reserving one barcode. No label or shipment is created.
Label format: PDF or ZPL.
Other carriers: Settings JSON
For other carriers the right side shows Provider Settings (JSON), the technical settings of the account. QrX fills in a template when you pick the carrier. Only change it if you know the carrier's settings; invalid JSON is not saved. When QrX manages the account, the settings are locked and only QrX can change them.
Method profiles
Method profiles are the shipping methods of this account, for example "Standard Ground" or "Express". You pick a method profile when you create a shipment, and shipping rules can set one automatically. This section appears after the account is saved.
The table shows Name, Profile Code, Code, Carrier Service, Active, Default and Updated. Use the switches to turn a profile on or off or make it the default.
Add Profile opens the Add Method Profile window:
Load from template: fill in name, code and settings from a ready-made method of the carrier.
Profile Name (required) and Profile Code | Use with API Calls (required, a fixed code that must be unique in your account).
Code and Carrier Service Code: the carrier's own code for this service, for example UPS_GROUND.
Default profile: use this profile by default for new shipments.
For the In-house delivery provider (your own drivers): In-house ZPL label, with the ZPL label, Print mode and Copies to print.
Settings JSON: technical settings of the method.
Use the pencil to edit a profile and the bin to delete it.
On a QrX managed account the method profiles are read only.
Customs: default HS code
The Customs card below the list holds customs data for shipments outside the EU. For UPS shipments outside the EU, QrX sends a commercial invoice with the HS code of every line. It takes the HS code of the order line first, then the one of the stock item.
Default HS code: used when a product has no HS code of its own. 6 to 10 digits; dots and spaces are fine, for example 8507.60.00. Click the X to clear it.
Click Save on the card. You need permission to manage shipping to change it; others see it read only.
Without any HS code the label is still bought, and the order shows a customs warning so you can check the invoice.
Tips and common questions
"Please select a shipping provider." or "Display name is required.": fill in the field and press Save again.
"Settings must be valid JSON.": the Settings JSON has a typing error, for example a missing comma or quote.
"Select an available sender address for this customer and channel.": the chosen sender address belongs to another channel. Pick another one or use the default.
"Client ID is required.", "Account number is required.": fill in all UPS details for your own UPS contract.
"The account could not be verified." (PostNL): check the customer number, customer code and the API key of the chosen environment.
"Failed to toggle active status.": the switch went back. Try again or refresh the list.
Someone else saved the account at the same time: QrX shows a message and lets you reload the latest version.
"The default HS code is 6 to 10 digits.": type only the digits of the code (dots and spaces are fine), at least 6 and at most 10.
"UPS dangerous goods can only be declared on UPS Standard within the EU.": use UPS Standard for parcels with dangerous goods inside the EU, or another shipping method.
"This parcel holds more than one dangerous-goods item." or "... in a shipment of more than one package.": ship each dangerous-goods item in its own parcel, in one package.
Need help? Click Chat at the bottom of the Help Center.