Overview
The InvoiceFailed status is an internal-only alert indicating that the system cannot automatically calculate a shipping charge for an order to your 3PL client. This status is used internally for billing purposes only.
Important: The external order status remains as Despatched for customer visibility on websites and sales platforms. Your clients will not see the InvoiceFailed status.
For example, if courier pricing covers orders only up to 7kg and an order exceeds that weight without corresponding pricing, the system defaults to InvoiceFailed status because it cannot assign an appropriate charge.
Reasons for InvoiceFailed Status
Orders enter InvoiceFailed status when the system cannot find matching courier pricing. The main reasons are:
No shipping price exists for the Courier Service.
The order has exceeded the Maximum Weight for the pricing setup.
Pricing has been set on a Zone basis, and the Destination Country for the order is not included in any of the specified zones.
The Warehouse on the Courier Pricing is set to All instead of the individual Warehouse.
Courier pricing configurations might not include certain weight ranges, such as orders exceeding a specific threshold without a corresponding price setup.
Note: The system uses volumetric weight calculation if enabled in Customer Account Settings. Pricing calculations use the greater value between dead weight and volumetric weight, which may cause orders to exceed configured weight ranges.
Diagnosing the Issue
Follow these checks to identify which pricing configuration is causing the InvoiceFailed status:
Check if courier service has any pricing configured.
Navigate to the courier service settings.
Verify that at least one price entry exists.
Check if order weight is within configured weight ranges.
Review the order weight (including volumetric weight if applicable).
Confirm that your pricing includes the weight range for this order.
Look for gaps in weight ranges (e.g., 0-5kg and 10-20kg configured, but order is 7kg).
Check if destination country is included in shipping zones.
Review the order's destination country.
Verify the country is added to at least one shipping zone in your courier pricing.
Check if warehouse is configured correctly.
Confirm whether the Courier Pricing Warehouse setting should be set to a specific warehouse or All.
If the order is from a specific warehouse, ensure pricing is not restricted to All when it should specify that warehouse.
Check if postcode matches configured zones (for postcode-based pricing).
Review the delivery postcode.
Verify the postcode matches any configured postcode zones in your pricing.
Correcting InvoiceFailed Orders
Prerequisites
Permission Required: You must have the AdminAccountsAddCourierPrice permission enabled to view and manage orders awaiting courier prices.
Important Limitation: Recalculation only works for unconfirmed invoices. Orders that have already been confirmed cannot be recalculated and must be corrected manually.
Option 1: Add Correct Pricing Then Auto-Recalculate
To fix orders in InvoiceFailed status, first add the correct pricing to the affected Courier Service(s), then recalculate the orders.
Adding New Courier Pricing in Bulk
For complex or first-time pricing setup, use the spreadsheet loader to add Courier Service pricing:
Click Shipping Management then Extras.
Click Uploads, select the CourierServicePrices template then click Download.
Populate the spreadsheet to your requirements.
Save the spreadsheet as a CSV.
On the Uploads page within Mintsoft, select CourierServicePrices as the Type to upload.
Browse for the spreadsheet then click Upload.
Recalculating Orders
Once you have added courier pricing:
Click 3PL Accounting then Overview.
Click Orders Awaiting Courier Prices.
Click Auto ReCalc against the orders affected.
If recalculation fails: The order will remain in InvoiceFailed status with the message "No Valid Courier Price could be calculated!". You must either fix the pricing configuration and retry or manually enter the cost using Option 2 below.
Option 2: Add Prices Manually
If you do not want to add pricing to the courier services and instead prefer to correct the InvoiceFailed orders manually:
Click 3PL Accounting then Overview.
Click Orders Awaiting Courier Prices.
Select the checkboxes of the orders affected.
Enter the required Postage Cost for each order.
Select Invoice from the Bulk Actions drop-down then click Go.
Warehouse User Roles
Permissions within the Accounts and Shipping role group must be enabled to view and manage orders awaiting a courier price (InvoiceFailed orders) as a Warehouse or Admin user.
The specific permission required is: AdminAccountsAddCourierPrice.