Comprehensive Tipax Express Logistics & Waybills Integration Guide in Webito
Tipax is Iran's pioneer and largest private courier network with over 60 years of logistics excellence, operating more than 1,000 corporate branches nationwide. For e-commerce stores shipping physical goods across provinces, Tipax offers fast 24-to-48-hour delivery with door-to-door courier pickup.
The Webito Tipax plugin connects directly to the e-Tipax API (V3/V4), automating weight-based tariff calculations, declared value cargo insurance, statutory 10% VAT, thermal barcode waybills, and real-time checkpoint tracking.
1. Key Merchant Advantages
- Fast 24-48h Delivery: Ground and air routes connecting all Iranian provinces and major urban centers.
- Automated Thermal Waybills: Issue official Tipax consignment labels with scannable 12-digit barcodes directly from your dashboard.
- Cargo Insurance Coverage: Automated insurance calculation (0.2% of declared goods value) protecting your business against loss or transit damage.
- Warehouse Door Pickup (Pick-up Service): Tipax couriers collect packaged orders directly from your warehouse.
- Multi-Stage Checkpoint Tracking: Track milestones from origin branch deposit to central sorting hub, destination hub, and final recipient handover.
2. Official Tariff & Insurance Formula
Tipax applies a standardized multi-variable pricing formula implemented in Webito's calculateTariffTomans method:
$$\text{Total Fee} = \left( \text{Base Weight Tier Fee} + \text{Extra Kg Surcharge} + \text{Cargo Insurance} \right) \times 1.10\ (\text{10% VAT})$$
| Weight Tier | Base Fee (Tomans) | Goods Insurance (Declared Value) | Statutory VAT |
|---|---|---|---|
| Up to 1 kg | 58,000 IRT | 0.2% of declared cart value | 10% of subtotal fee |
| 1 to 3 kg | 78,000 IRT | 0.2% of declared cart value | 10% of subtotal fee |
| 3 to 5 kg | 98,000 IRT | 0.2% of declared cart value | 10% of subtotal fee |
| Over 5 kg | 98,000 + 18,000 per extra kg | 0.2% of declared cart value | 10% of subtotal fee |
3. API Configuration Parameters
Obtain your credentials from the e-Tipax portal or staging environment (omtest.tipax.ir):
| Parameter in Webito | e-Tipax Field | Description | Example |
|---|---|---|---|
| API Key | Web Service Key | Unique API Key generated in e-Tipax profile settings | tpx_live_apikey_998811 |
| Contract Code | Contract Number | Corporate contract identifier assigned by Tipax sales | TPX_CTR_44321 |
| Origin City | Origin City Name | Warehouse dispatch city name (English or Persian) | Tehran |
| Fallback Base Fee | Fallback Rate | Default flat rate if Tipax API is temporarily unreachable | 65000 |
| Service Type | Service Tier | Regular Ground or Express Air freight | GROUND or EXPRESS |
| Sandbox Mode | Test Mode | Enable to test against omtest.tipax.ir | true / false |
4. Dispatch & Waybill Lifecycle
- When an order transitions to fulfillment in Webito, click Dispatch with Tipax.
- Webito submits recipient address, 10-digit postal code, phone number, and package weight to e-Tipax.
- Tipax returns a unique Consignment Number and 12-digit barcode.
- Download and print the thermal PDF waybill, attach it to the parcel, and hand it to the Tipax courier.
5. Troubleshooting & Common Error Codes
| HTTP Status | Error Message | Root Cause | Resolution |
|---|---|---|---|
| 401 | Invalid API Key / Unauthorized | Key expired or incorrect | Generate a fresh API Key in e-Tipax and save in Webito. |
| 400 | Invalid Postal Code | Postal code is not exactly 10 digits | Update recipient address with a valid 10-digit Iranian postal code. |
| 422 | Destination City Not Covered | Remote rural destination not directly serviced | Route parcel via Iran Post Pishtaz or nearest Tipax regional hub. |
| 500 | Service Temporarily Unavailable | Upstream carrier maintenance | Webito applies the configured fallback fee so checkout never halts. |