Porter 物流服务 App 数据 API

SmartShift Logistics Solutions Private Limited · 出行

Porter - Logistics Service App 是 Porter 的客户端应用。Porter 由 SmartShift Logistics Solutions Private Limited 运营，2014 年创立，总部位于班加罗尔，是印度的同城货运平台。用户在地图上设定取货点与送达点，可沿途添加途经点并选择货物类型，随后在同一个确认下单页看到各车型的预付运费：从适合小件包裹的两轮车、三轮车，到 Tata Ace 微型卡车和更大的卡车，同时显示附近车辆与预计行程时长。除即时叫车外，应用还提供按小时/里程计费的租车套餐，让车辆与司机在一段时间内随叫随用；支持小批量货物的拼载请求；运费页可输入优惠码，也会自动套用奖励折扣。支付可使用合并了 Porter 余额与已绑定 Paytm 余额的钱包、在线支付或现金；未结清的现金欠款需先付清才能再次下单。下单后，实时行程页跟踪订单直至送达，支持一键再次下单，行程结束后可为司机评分并选择评价原因。它面向印度市场，用户包括搬运家具与电器的家庭、在城内调运库存的商铺与批发商，以及承担城市货运的企业；在同类服务中，它与 Blowhorn、LetsTransport、TruckGuru、BlackBuck、Borzo、Delhivery Direct 和 Vahak 等竞争。

按车型拆分的运费报价是核心记录：针对一组以 geo_region_id 和 from_address_lat/to_address_long 坐标标识的收发地址，每个车型返回一个 quotation_uuid 及 fare_info 块——含 fare、fare_before_discount、total_discount、applied_coupon，以及用钱包支付所需的 min_paytm_amount——另附以 porter_duration_in_mins 表示的行程时长估计、route_polyline 路线和取货点附近的 nearby_vehicle_drivers。优惠券与自动奖励折扣的重新计价会在同一报价上追加 applied_discounts；按小时/里程的租车套餐则以 fare、time、distance 与 totalDiscount 列出各车型的套餐。

确认的订单生成 order_crn，带有 order_status、order_created_at、is_cod_order 与 cash_payable。登录后的账户快照包含 porter_wallet（amount、payable）与 paytm_wallet（login_status、balance）、客户的 dues_amount 与 blacklisting_info、其 default_goods_types，以及驱动行程后 rating_reasons 评价的 open_or_live_order_ids 和 unrated_order_ids。地理区域可将任意经纬度解析为 Porter 城市记录，其 pickup_polygon 与 drop_polygon 标出可取货与可送达的范围。

3PL 与电商平台据此在确定线路前，对比同一线路上两轮车与小货车的报价，连同优惠后总额和 Porter 预计分钟数一并比较；财务机器人把 Porter 余额、Paytm 余额与未结欠款对账，标记须先结清现金欠款才能下单的客户；运营控制台在下单后轮询进行中与待评价订单，并在行程结束时提交评价原因；预订组件则拒绝为 Porter 可服务多边形之外的取货点报价。openData Studio 将这些报价、钱包、订单与地理区域记录转化为可调用的开放数据，支撑上述集成。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

按需车型报价

POST /v1/quotes/on-demand opendata

针对一组收发地址返回各车型按需运费报价（quotation_uuid、fare_info、route_polyline），即确认下单页。

认证方式：客户会话：JSON 请求体字段 mobile 与 auth_token。

vehicle_ids
selected_vehicle_id
service_type
part_load_only_request
customer_mobile
geo_region_id
from_address_lat
from_address_long
to_address_lat
to_address_long
waypoints_attributes
payment_mode
use_porter_credits
vehicle_wise_quotations
quotation_uuid
vehicle_id
fare_info
fare
min_paytm_amount
total_discount
applied_coupon
fare_before_discount
nearby_vehicle_drivers
route_polyline
select_vehicle_id
wallet_info
porter_duration_in_mins

POST /v1/quotes/on-demand HTTP/1.1
Content-Type: application/json

{
  "mobile": "9876543210",
  "auth_token": "<auth_token>",
  "vehicle_ids": [1, 2, 5],
  "selected_vehicle_id": 2,
  "service_type": "spot",
  "part_load_only_request": false,
  "order": {
    "customer_mobile": "9876543210",
    "geo_region_id": 3,
    "from_address_lat": 12.9716,
    "from_address_long": 77.5946,
    "to_address_lat": 12.9352,
    "to_address_long": 77.6245,
    "waypoints_attributes": [],
    "value_added_services": [],
    "payment_mode": "online",
    "business_order_info": null,
    "use_porter_credits": true
  }
}

{
  "vehicle_wise_quotations": [{
    "quotation_uuid": "q-9f3a1c",
    "vehicle_id": 2,
    "fare_info": {
      "fare": 412.0,
      "min_paytm_amount": 50.0,
      "min_paytm_amount_with_credits": 0.0,
      "total_discount": 40.0,
      "applied_coupon": null,
      "description": "2-wheeler",
      "applied_discounts": [],
      "fare_before_discount": 452.0
    },
    "book_cta_info_text": "Book now",
    "value_added_services": [],
    "bill_details": {},
    "porter_duration_in_mins": 28,
    "price_differential_percentage": 0,
    "outstation_tag": null
  }],
  "nearby_vehicle_drivers": [],
  "route_polyline": "enc:polyline",
  "select_vehicle_id": 2,
  "wallet_info": {
    "paytm_wallet": {"login_status": true, "balance": 120.5, "balance_api_status": "ok"},
    "porter_wallet": {"amount": 80.0, "payable": true}
  },
  "partload_vehicle_wise_quotations": []
}

应用按需优惠券

POST /v1/quotes/coupons/apply opendata

为指定 vehicle_id 应用 coupon_code 后重新计算按需报价，返回含 applied_coupon 与 total_discount 的 fare_info。

认证方式：客户会话：JSON 请求体字段 mobile 与 auth_token。

coupon_code
vehicle_id
quotations_request
applied_coupon
total_discount
applied_discounts
fare
fare_before_discount
quotation_uuid

POST /v1/quotes/coupons/apply HTTP/1.1
Content-Type: application/json

{
  "mobile": "9876543210",
  "auth_token": "<auth_token>",
  "coupon_code": "PORTER40",
  "vehicle_id": 2,
  "quotations_request": {
    "vehicle_ids": [2],
    "selected_vehicle_id": 2,
    "service_type": "spot",
    "part_load_only_request": false,
    "order": {
      "customer_mobile": "9876543210",
      "geo_region_id": 3,
      "from_address_lat": 12.9716,
      "from_address_long": 77.5946,
      "to_address_lat": 12.9352,
      "to_address_long": 77.6245,
      "waypoints_attributes": [],
      "value_added_services": [],
      "payment_mode": "online",
      "use_porter_credits": false
    }
  }
}

{
  "vehicle_wise_quotations": [{
    "quotation_uuid": "q-9f3a1c",
    "vehicle_id": 2,
    "fare_info": {
      "fare": 372.0,
      "min_paytm_amount": 50.0,
      "min_paytm_amount_with_credits": 0.0,
      "total_discount": 80.0,
      "applied_coupon": "PORTER40",
      "description": "2-wheeler",
      "applied_discounts": [{"value": "PORTER40"}],
      "fare_before_discount": 452.0
    }
  }],
  "select_vehicle_id": 2,
  "wallet_info": {
    "paytm_wallet": {"login_status": true, "balance": 120.5, "balance_api_status": "ok"},
    "porter_wallet": {"amount": 80.0, "payable": true}
  }
}

应用按需折扣

POST /v1/quotes/discounts/apply opendata

对 quotations_request 应用优惠券与奖励折扣（should_use_auto_apply、requested_discounts），返回更新后的 fare_info。

认证方式：客户会话：JSON 请求体字段 mobile 与 auth_token。

discounts_request
should_use_auto_apply
requested_discounts
value
vehicle_id
quotations_request
applied_discounts
applied_coupon
total_discount

POST /v1/quotes/discounts/apply HTTP/1.1
Content-Type: application/json

{
  "mobile": "9876543210",
  "auth_token": "<auth_token>",
  "vehicle_id": 2,
  "discounts_request": {
    "should_use_auto_apply": true,
    "requested_discounts": [{"value": "PORTER40"}]
  },
  "quotations_request": {
    "vehicle_ids": [2],
    "selected_vehicle_id": 2,
    "service_type": "spot",
    "part_load_only_request": false,
    "order": {
      "customer_mobile": "9876543210",
      "geo_region_id": 3,
      "from_address_lat": 12.9716,
      "from_address_long": 77.5946,
      "to_address_lat": 12.9352,
      "to_address_long": 77.6245,
      "waypoints_attributes": [],
      "value_added_services": [],
      "payment_mode": "online",
      "use_porter_credits": true
    }
  }
}

{
  "vehicle_wise_quotations": [{
    "quotation_uuid": "q-9f3a1c",
    "vehicle_id": 2,
    "fare_info": {
      "fare": 372.0,
      "total_discount": 80.0,
      "applied_coupon": "PORTER40",
      "applied_discounts": [{"value": "PORTER40"}],
      "fare_before_discount": 452.0
    }
  }],
  "select_vehicle_id": 2
}

移除按需优惠券

POST /v1/quotes/coupons/remove opendata

从按需报价中清除已应用的 coupon_code，返回未折扣的 fare_info。

认证方式：客户会话：JSON 请求体字段 mobile 与 auth_token。

coupon_code
vehicle_id
quotations_request
applied_coupon
total_discount
fare

POST /v1/quotes/coupons/remove HTTP/1.1
Content-Type: application/json

{
  "mobile": "9876543210",
  "auth_token": "<auth_token>",
  "coupon_code": "PORTER40",
  "vehicle_id": 2,
  "quotations_request": {
    "vehicle_ids": [2],
    "selected_vehicle_id": 2,
    "service_type": "spot",
    "part_load_only_request": false,
    "order": {
      "customer_mobile": "9876543210",
      "geo_region_id": 3,
      "from_address_lat": 12.9716,
      "from_address_long": 77.5946,
      "to_address_lat": 12.9352,
      "to_address_long": 77.6245,
      "waypoints_attributes": [],
      "value_added_services": [],
      "payment_mode": "online",
      "use_porter_credits": false
    }
  }
}

{
  "vehicle_wise_quotations": [{
    "quotation_uuid": "q-9f3a1c",
    "vehicle_id": 2,
    "fare_info": {
      "fare": 452.0,
      "total_discount": 0.0,
      "applied_coupon": null,
      "applied_discounts": [],
      "fare_before_discount": 452.0
    }
  }],
  "select_vehicle_id": 2
}

租赁套餐

POST /v1/rentals/packages opendata

按车型列出按时长/里程的租赁套餐（uuid、fare、time、distance），供租赁预订流程使用。

认证方式：客户会话：JSON 请求体字段 mobile 与 auth_token。

n_waypoints
vehicle_ids
order
rentalVehicleData
uuid
fare
totalDiscount
time
distance
minPaytmBalance
vehicleInfoList
initSelectedVehicleId
description
walletInfo

POST /v1/rentals/packages HTTP/1.1
Content-Type: application/json

{
  "mobile": "9876543210",
  "auth_token": "<auth_token>",
  "n_waypoints": 0,
  "vehicle_ids": [4, 5],
  "order": {
    "customer_mobile": "9876543210",
    "geo_region_id": 3,
    "from_address_lat": 19.0760,
    "from_address_long": 72.8777,
    "to_address_lat": 19.1136,
    "to_address_long": 72.8697,
    "waypoints_attributes": [],
    "value_added_services": [],
    "payment_mode": "online",
    "use_porter_credits": false
  }
}

{
  "rentalVehicleData": [{
    "uuid": "rp-8h",
    "fare": 1499.0,
    "totalDiscount": 0.0,
    "time": "8 hrs",
    "distance": "80 km",
    "minPaytmBalance": 0.0
  }],
  "vehicleInfoList": [],
  "initSelectedVehicleId": 4,
  "description": "Full-day rental",
  "walletInfo": {
    "paytm_wallet": {"login_status": true, "balance": 120.5, "balance_api_status": "ok"},
    "porter_wallet": {"amount": 80.0, "payable": true}
  }
}

应用租赁优惠券

POST /v1/rentals/coupons/apply opendata

为 selectedVehicleId 应用 couponCode 后重新计算租赁套餐价格。

认证方式：客户会话：JSON 请求体字段 mobile 与 auth_token。

couponCode
selectedVehicleId
rentalPackagesRequest
uuid
fare
totalDiscount
initSelectedVehicleId

POST /v1/rentals/coupons/apply HTTP/1.1
Content-Type: application/json

{
  "mobile": "9876543210",
  "auth_token": "<auth_token>",
  "couponCode": "RENTAL100",
  "selectedVehicleId": 4,
  "rentalPackagesRequest": {
    "mobile": "9876543210",
    "auth_token": "<auth_token>",
    "n_waypoints": 0,
    "vehicle_ids": [4],
    "order": {
      "customer_mobile": "9876543210",
      "geo_region_id": 3,
      "from_address_lat": 19.0760,
      "from_address_long": 72.8777,
      "to_address_lat": 19.1136,
      "to_address_long": 72.8697,
      "waypoints_attributes": [],
      "value_added_services": [],
      "payment_mode": "online",
      "use_porter_credits": false
    }
  }
}

{
  "rentalVehicleData": [{
    "uuid": "rp-8h",
    "fare": 1399.0,
    "totalDiscount": 100.0,
    "time": "8 hrs",
    "distance": "80 km",
    "minPaytmBalance": 0.0
  }],
  "initSelectedVehicleId": 4,
  "description": "Full-day rental",
  "walletInfo": {
    "porter_wallet": {"amount": 80.0, "payable": true}
  }
}

创建按需订单

POST /v1/bookings/create opendata

根据 quotation_uuid 创建按需订单，返回实时行程页所用的 order_crn 与 order_status。

认证方式：客户会话：JSON 请求体字段 mobile 与 auth_token。

quotation_uuid
vehicle_id
customer_mobile
geo_region_id
from_address_lat
from_address_long
to_address_lat
to_address_long
payment_mode
use_porter_credits
order_crn
order_created_at
order_status
rebooking_enabled
pay_online_enabled
is_cod_order
amount
cash_payable

POST /v1/bookings/create HTTP/1.1
Content-Type: application/json

{
  "mobile": "9876543210",
  "auth_token": "<auth_token>",
  "quotation_uuid": "q-9f3a1c",
  "vehicle_id": 2,
  "customer_mobile": "9876543210",
  "geo_region_id": 3,
  "from_address_lat": 12.9716,
  "from_address_long": 77.5946,
  "to_address_lat": 12.9352,
  "to_address_long": 77.6245,
  "waypoints_attributes": [],
  "value_added_services": [],
  "payment_mode": "online",
  "use_porter_credits": true
}

{
  "order_crn": "CRN240918001",
  "order_created_at": 1726632000000,
  "geo_region_id": 3,
  "order_status": {"name": "finding_driver"},
  "rebooking_enabled": false,
  "pay_online_enabled": true,
  "is_cod_order": false,
  "total_amount": {"amount": 372.0, "cash_payable": 0.0}
}

账户快照、钱包与欠款

POST /v1/account/snapshot openfinance

加载登录后的首页快照：Porter/Paytm 钱包余额、dues_amount、进行中订单 ID、未评价行程与 blacklisting_info。

认证方式：客户会话：JSON 请求体字段 mobile 与 auth_token。

for_blacklisting
blacklisting_info
is_blacklisted
wallet_info
paytm_wallet
login_status
balance
balance_api_status
porter_wallet
amount
payable
category
unrated_order_ids
open_or_live_order_ids
goods_type_info
all_goods_types
default_goods_types
dues_info
dues_amount

POST /v1/account/snapshot HTTP/1.1
Content-Type: application/json

{
  "mobile": "9876543210",
  "auth_token": "<auth_token>",
  "for_blacklisting": false
}

{
  "blacklisting_info": {
    "is_blacklisted": false,
    "skip_blacklisting": false,
    "type": null,
    "message": null,
    "balance": 0.0
  },
  "wallet_info": {
    "paytm_wallet": {"login_status": true, "balance": 120.5, "balance_api_status": "ok"},
    "porter_wallet": {"amount": 80.0, "payable": true}
  },
  "category": "retail",
  "unrated_order_ids": ["CRN240917014"],
  "open_or_live_order_ids": ["CRN240918001"],
  "app_update_data": {},
  "goods_type_info": {
    "all_goods_types": ["Household", "Electronics"],
    "default_goods_types": ["Household"]
  },
  "share_app": {},
  "dues_info": {"message": "",
    "dues_amount": 0.0}
}

获取地理区域
POST /v1/regions/resolve opendata
把经纬度解析为报价与下单所用的 Porter geo_region（id、name、pickup_polygon、drop_polygon）。
认证方式：可选客户会话（mobile、auth_token）。请求体为经纬度。
- lat
- long
- geo_region
- id
- name
- pickup_polygon
- drop_polygon
```
POST /v1/regions/resolve HTTP/1.1
Content-Type: application/json

{
  "lat": 12.9716,
  "long": 77.5946
}
```
```
{
  "geo_region": {
    "id": 3,
    "name": "Bengaluru",
    "pickup_polygon": "12.97,77.59 ...",
    "drop_polygon": "12.97,77.59 ..."
  }
}
```
保存司机评价
POST /v1/trips/rating opendata
为 unrated_order_ids 中的 order_crn 提交行程后司机反馈（含 id/name 的 rating_reasons）。
认证方式：客户会话：JSON 请求体字段 mobile 与 auth_token。
- order_crn
- rating_reasons
- id
- name
- unrated_order_ids
```
POST /v1/trips/rating HTTP/1.1
Content-Type: application/json

{
  "mobile": "9876543210",
  "auth_token": "<auth_token>",
  "order_crn": "CRN240917014",
  "rating_reasons": [{"id": 11, "name": "On time"}]
}
```
```
{
  "order_crn": "CRN240917014",
  "unrated_order_ids": []
}
```

数据类别

报价
运费
优惠券
钱包
地理区域
订单
评价

数据使用场景与案例

货主运费洞察
3PL 或电商平台可在确定线路前快照各车型运费报价、优惠券后总额与 Porter 预计分钟数，并对比同一收发的两轮车与小货车报价。
钱包与欠款对账
财务机器人可拉取 Porter 钱包 amount/payable、Paytm login_status 与 balance，以及 dues_amount，标记需结清欠款才能下单的客户。
进行中订单运营台
运营控制台可在下单后轮询 open_or_live_order_ids 与 unrated_order_ids，并在行程结束后提交 rating_reasons 完成闭环。
可服务城市校验
预订组件可把取货坐标解析为地理区域（id、name、取/送多边形），并在展示车型前拒绝 Porter 覆盖范围外的报价。

常见问题

Porter 客户 API 暴露哪些数据？

按需报价（quotation_uuid、fare、vehicle_id）、优惠券与折扣调整、按时长/里程的租赁套餐、Porter 与 Paytm 钱包余额、地理区域多边形、进行中/未评价订单 ID、欠款，以及行程后评价原因。

Porter 如何认证客户调用？

登录请求在 JSON 请求体中发送登录流程签发的客户 mobile 与 auth_token。地理区域查询以经纬度为键，请求体无需这些字段。

Porter 客户 API 是否同时覆盖租赁与按需下单？

是的。租赁流程按车型列出按时长/里程的套餐（uuid、fare、time、distance）并在应用优惠券后重新定价，与用于即时行程的按需报价和下单流程相互独立。

哪个端点驱动 Porter 首页的钱包与欠款卡片？

POST /v1/account/snapshot 返回登录快照：wallet_info 含 paytm_wallet.balance 与 porter_wallet.amount、dues_info.dues_amount，以及驱动实时行程与评价提示的 open_or_live_order_ids 和 unrated_order_ids。

与 Porter - Logistics Service App 相似的应用

Blowhorn — 总部位于班加罗尔的同城物流服务，提供小型货车预订与当日达配送，被认为是 Porter 在货车板块的直接竞争对手。
LetsTransport — 总部位于班加罗尔、面向企业货主的同城公路物流平台，被列为 Porter 在城市货运领域的主要竞争对手之一。
TruckGuru — 专注整车货运的数字订车应用，在印度货运应用横评中常与 Porter 并列比较。
BlackBuck — 连接货主与货车司机的印度在线货运市场，在货运预订类目中经常与 Porter 被放在一起比较。
Delhivery Direct — Delhivery 推出的按需同城配送应用，率先在德里国家首都辖区和班加罗尔上线，与 Porter 的同城配送业务竞争。
Borzo — 在印度运营同城按需包裹配送的快递应用，与 Porter 同处竞争激烈的同城配送市场。
Vahak — 面向整车与零担货运的在线订车平台，在印度货运应用比较中常与 Porter 归为一类。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Porter 物流服务 App 数据 API

应用截图

API 端点一览

按需车型报价

应用按需优惠券

应用按需折扣

移除按需优惠券

租赁套餐

应用租赁优惠券

创建按需订单

账户快照、钱包与欠款

获取地理区域

保存司机评价

数据类别

数据使用场景与案例

货主运费洞察

钱包与欠款对账

进行中订单运营台

可服务城市校验

常见问题

与 Porter - Logistics Service App 相似的应用

更多出行类应用

Amazon Flex

Australia Post

Careem Captain

DHL Express Mobile

相关主题

需要集成这个 App 的数据 API？

Porter 物流服务 App 数据 API

应用截图

API 端点一览

按需车型报价

应用按需优惠券

应用按需折扣

移除按需优惠券

租赁套餐

应用租赁优惠券

创建按需订单

账户快照、钱包与欠款

获取地理区域

保存司机评价

数据类别

数据使用场景与案例

货主运费洞察

钱包与欠款对账

进行中订单运营台

可服务城市校验

常见问题

相关应用

与 Porter - Logistics Service App 相似的应用

更多出行类应用

Amazon Flex

Australia Post

Careem Captain

DHL Express Mobile

相关主题

需要集成这个 App 的数据 API？