How to Interpret Different Order Creation Failure Errors?

When an error appears in the Courier Response, identify the type of issue and take the appropriate action:

Serviceability Error
The courier is not serviceable to a specific pincode.
→ Retry the order with another courier, or confirm serviceability with the existing courier.

Incorrect Data Passed
Some input data is invalid (e.g., weight, invoice value, etc.).
→ Cross-check the payload sent to the courier against the error field.
→ Verify the Clickpost payload to confirm what data was passed.
→ If incorrect data was sent to Clickpost, coordinate with your source system (Tech/WMS) to correct it.

Authentication or Token Issues
Credentials are invalid or the token has expired.
→ Review courier partner settings in the Clickpost dashboard and validate credentials with the courier partner.

Timeout Error

The courier API takes longer than the standard/defined time (usually <10 secs) to respond.
→ Retry the order once.
→ If the error persists, raise a thread with the courier POC to optimize response times.
→ If the order was created at the courier’s end and we receive the error message "AWB Already Exists" from the courier (if they have a duplicate check system in place):

• When AWB details are shared in the response: Clickpost will capture and process the order using these details.

• When AWB details are missing: Clickpost will coordinate with the courier to enable sharing of AWB-level details for smoother handling.

Waybill does not exist

When the Pre-Assign AWB series is fully exhausted, the Order Creation attempt returns a Clickpost error:

“Waybill does not exist.”

→ Navigate to the Pre-Assign AWB page for the courier.

→ Check whether Auto-Fetch is enabled.

• If enabled, but the series is not fetched: Initiate a thread with Clickpost Support to get this checked

• If not enabled: Verify if the courier supports auto-fetch.
  

  • If yes: Enable auto-fetch in the dashboard and retry order creation after 2 hours (Clickpost fetches AWBs every 2 hours).

  • If no: Reach out to the courier panel to fetch the AWB series and upload it manually and retry order creation

Unknown or Unmapped Errors
The courier returned an error that doesn’t clearly fall into the above categories (e.g., data format mismatch, invalid fields).
→ Initiate a thread with the courier partner POC for clarification.
→ Share the Courier Request and Courier Response logs to help them identify the discrepancy.

Still stuck? Write to support@clickpost.in for assistance.