Nationex

Nationex is a Canadian regional shipping carrier that provides delivery services primarily in Quebec and Ontario. This integration retrieves real-time rate quotes during checkout and order processing, allowing customers to see accurate shipping costs based on parcel dimensions, weight, and destination.

How to set it up

Where to find it: Admin → Settings → Shipping → Nationex

When you'd use this: When you need to offer Nationex shipping options to customers in Canada and want to display real-time calculated rates at checkout.

What you need first:

• A Nationex account with API access enabled
• Your Nationex Customer ID
• Your Nationex API key (obtained from Nationex support or your account dashboard)

Set it up:

1. Navigate to Admin → Settings → Shipping and select Nationex from the available carriers
2. Enter your Customer ID in the customerId field
3. Enter your API Key in the password field (this will be used for Basic authentication)
4. Set the Shipment Type to "Delivery" (default) or your preferred shipment type
5. Set the Units of Measurement to "LI" (pounds and inches) or your preferred unit system
6. Save the configuration
7. Test the integration by creating a test order with a valid Canadian postal code

Configuration options

Field	What it does	Default	Required
customerId	Your Nationex customer account identifier, used for authentication and routing API requests	None	Yes
shipmentType	The type of shipment service (e.g., "Delivery")	"Delivery"	Yes
uom	Units of measurement for weight and dimensions - "LI" for pounds/inches, "KC" for kilograms/centimeters	"LI"	Yes
username	Authentication username (automatically set to customerId)	customerId value	Yes
password	Your Nationex API key for Basic authentication	None	Yes
uri	The Nationex API endpoint base URL	https://apidev.nationex.com	Yes

Using it day-to-day

1. When a customer enters a Canadian shipping address during checkout, the integration automatically requests rate quotes from Nationex
2. The system sends parcel dimensions, weight, origin postal code, and destination postal code to calculate accurate shipping costs
3. If the order includes insurance, frozen protection, dangerous goods, or signature requirements, those accessory charges are included in the rate calculation
4. The calculated rate (in CAD) appears as a shipping option at checkout
5. Rates account for multiple parcels if the order is split into multiple boxes
6. Non-conveyable (oversized) parcels are flagged automatically based on dimensions
7. Weight is converted from grams to kilograms and dimensions from millimeters to centimeters when communicating with the Nationex API

Troubleshooting

• No rates returned at checkout: Verify that both the origin and destination postal codes are valid Canadian postal codes. Nationex primarily serves Quebec and Ontario.
• Authentication errors: Double-check that your Customer ID and API key are entered correctly. The API key should be entered in the password field.
• Incorrect rate calculations: Ensure your product weights and dimensions are configured correctly in grams and millimeters, as the system converts these to Nationex's expected units automatically.
• Missing accessory charges: Insurance, frozen protection, and dangerous goods flags are derived from order properties - verify these attributes are set correctly on products that require special handling.
• SNR (Signature Not Required) issues: The SNR flag is automatically set to the opposite of the isSignedFor property - if signature requirements aren't working as expected, check the order's signature requirement setting.