What is a Vendor Code? How does the Vendor Code logic works?

What is a Vendor Code?

A Vendor Code (also known as Pickup Location ID or Pickup Location Name) is a unique identifier assigned by courier partners like Delhivery, Shiprocket, Ithink, Loginext, etc. It is used to link a pickup/warehouse address with the courier’s system.

When a brand registers a pickup location or warehouse address on the courier’s panel, the courier generates and shares this Vendor Code.

How Vendor Code Logic Works in Clickpost

1. Brand Registers Pickup Address

   • The brand first adds the pickup/warehouse address directly on the courier partner’s panel.

   • The courier generates and shares a Vendor Code for that address.

2. Brand Shares Vendor Code with Clickpost

   • The brand provides this Vendor Code to Clickpost against the respective pickup address.

   • Clickpost stores the mapping internally.

   • Important: The brand must ensure that the pickup address being passed in the Clickpost API is an exact match with the one mapped internally (no character-level differences, extra spaces, or mismatches).

3. Order Creation Flow

   • When an order is created, the pickup address is passed in the Clickpost API request.

   • Clickpost fetches the Vendor Code mapped to that address and passes it to the courier’s API.

4. Possible Outcomes:

   • Vendor Code Exists → Order is processed successfully.

   • Vendor Code Missing →

     • If the courier has a Warehouse API → Clickpost tries to register the address and fetch a new Vendor Code.

     • If the courier does not support Warehouse API → The Order Creation API returns an error: “Vendor code mapping does not exist.”

What to Do if a Vendor Code is Missing?

If you encounter the “Vendor code mapping does not exist” error:

1. Fetch the Vendor Code for the new pickup address from your courier’s panel.

2. Add it manually on the Clickpost Dashboard under:
   Menu → Carrier → Carrier Integrations → [Courier Name] → Select Account Code → Vendor Code → Add New

3. Retry placing the order.

This ensures the Vendor Code is mapped correctly and prevents failures in future order creation.