Porter 司机端数据 API：收入、发票与 TDS

SmartShift Logistics Solutions Private Limited · 出行

Porter Driver Partner App 是 Porter 的司机端应用。Porter 是起家于班加罗尔的印度同城货运平台，由 SmartShift Logistics Solutions Private Limited 运营。拥有两轮摩托、三轮车、Tata Ace 级小型货车及更大卡车的司机合作伙伴用它承接 Porter 货运订单、完成行程，并在专门的界面上查看收入：首页卡片显示当日收入，收入透明页把每周拆成逐日明细并列出在线时长与完成单量，月度发票列表可下载 PDF 结算发票，TDS 横幅显示每单的源头代扣税，Muneemji 钱包充值流程则用来结清司机欠 Porter 的现金款项。它服务于 Porter 仅在印度运营的司机车队，为各城市的小商户和家庭运送货物；在同城货运市场上，Porter 与 Lalamove、Borzo 等平台竞争。

逐单收入、月度结算发票与每单代扣税，构成了每位 Porter 司机的合作伙伴财务记录。首页收入卡片包含 today_earning 与 total_earnings_with_credit_txns；周报在 start_date 至 end_date 区间内汇总 total_earnings、num_login_minutes 与 num_trips_completed，并可下钻到 daily_earning_reports 与 work_unit_earning_reports。月度结算发票以 invoice_number、month、year 索引，拆分出 total_billed_amount、porter_platform_fees、vat、other_levies_debited、other_levies_credited、total_settlement 与 total_completed_trips，并附发票文件的 pdf_uri。每单代扣税记录把 order_id 与 partner_earnings、tds_applicable_percent、tds_amount 关联起来，Muneemji 现金代收充值则记录 driver_uuid、amount_rs、initiated_at 及充值 state。

报税应用把逐单 TDS 代扣汇入司机的季度申报，不必再从截图里重建扣税明细；记账集成导入结算发票与结算明细，核对 Porter 开票金额与司机实收；车队经理读取在线时长、完成单量与逐日明细，按出车效率而不只是收入来指导司机。openData Studio 将这些 Porter 司机收入、发票与 TDS 记录变成可调用的开放数据。

应用截图

API 端点一览

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

查询当日司机收入
GET /v1/earnings/today openfinance
返回司机当日收入及含贷方调整的累计总额。
认证方式： OTP 登录会话签发的 Bearer 令牌（Authorization 头）。
- today_earning
- total_earnings_with_credit_txns
```
GET /v1/earnings/today HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "today_earning": 1840.5,
  "total_earnings_with_credit_txns": 2215.0
}
```

查询每周收入报告

GET /v1/earnings/weekly-report openfinance

加载收入透明 / 每周收入界面：周总额、登录分钟数与逐单拆分。

认证方式： OTP 登录会话签发的 Bearer 令牌（Authorization 头）。

weekly_earning_reports
offset_week
weekly_summary
total_earnings
num_login_minutes
num_trips_completed
start_date
end_date
daily_earning_reports
date
daily_summary
work_unit_earning_reports

GET /v1/earnings/weekly-report?start_date=2026-09-14&end_date=2026-09-20&type=WEEKLY HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "weekly_earning_reports": [
    {
      "weekly_summary": {
        "total_earnings": 12840.0,
        "num_login_minutes": 2460,
        "num_trips_completed": 37,
        "start_date": "2026-09-14",
        "end_date": "2026-09-20"
      },
      "daily_earning_reports": [
        {
          "date": "2026-09-18",
          "daily_summary": {
            "total_earnings": 2140.0,
            "num_login_minutes": 420,
            "num_trips_completed": 6,
            "date": "2026-09-18"
          },
          "work_unit_earning_reports": []
        }
      ]
    }
  ],
  "offset_week": "2026-09-14"
}

列出结算发票
GET /v1/payouts/invoices openfinance
列出司机的月度结算发票（发票号、月份、年份）及可查的年度范围。
认证方式： OTP 登录会话签发的 Bearer 令牌（Authorization 头）。
- status
- result
- invoices_list
- years_list
- invoice_number
- month
- year
```
GET /v1/payouts/invoices?year=2026&month=8 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "status": "ok",
  "result": {
    "invoices_list": [
      {"invoice_number": "INV-2026-08-44102", "month": 8, "year": 2026}
    ],
    "years_list": [2026, 2025]
  }
}
```
查询发票结算明细
GET /v1/payouts/invoices/{invoice_id} openfinance
返回单张结算发票的开票金额、平台费、增值税、其他税费与净结算额。
认证方式： OTP 登录会话签发的 Bearer 令牌（Authorization 头）。
- other_levies_debited
- porter_platform_fees
- vat
- other_levies_credited
- total_billed_amount
- total_settlement
- total_completed_trips
- pdf_uri
```
GET /v1/payouts/invoices/INV-2026-08-44102 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "other_levies_debited": 120.0,
  "porter_platform_fees": 980.5,
  "vat": 176.49,
  "other_levies_credited": 40.0,
  "total_billed_amount": 14820.0,
  "total_settlement": 13583.01,
  "total_completed_trips": 142,
  "pdf_uri": "/media/invoices/INV-2026-08-44102.pdf"
}
```

查询司机 TDS 代扣税

GET /v1/tax/withholding openfinance

查询某订单的源头代扣税（税率、金额、状态与说明）。

认证方式： OTP 登录会话签发的 Bearer 令牌（Authorization 头）。

tds_deduction_response
timestamp
order_id
partner_earnings
tds_applicable_percent
tds_amount
status
info_message
info_message_subtext
content
know_more_video

GET /v1/tax/withholding?order_crn=CRN-9f2a1c&partner_uuid=drv_7c81 HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "tds_deduction_response": {
    "timestamp": "2026-09-18T14:22:01Z",
    "order_id": "CRN-9f2a1c",
    "partner_earnings": 640.0,
    "tds_applicable_percent": 1.0,
    "tds_amount": 6.4,
    "status": "DEDUCTED",
    "info_message": "TDS deducted on this trip",
    "info_message_subtext": "As per IT Act section 194C",
    "content": {
      "reduction_banner": {"enabled": true}
    },
    "know_more_video": {"url": "/media/tds/know-more.mp4"}
  }
}

发起 Muneemji 钱包充值

POST /v1/wallet/collections openfinance

针对司机钱包发起 Muneemji（现金代收）充值，供 Porter 收取现金差额。

认证方式： OTP 登录会话签发的 Bearer 令牌（Authorization 头）。

driver_uuid
amount_rs
initiated_at
uuid
type
success
muneemji_recharge
state
status
error_code
wallet_version_id

POST /v1/wallet/collections?wallet_version_id=3 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "driver_uuid": "drv_7c81",
  "amount_rs": 500.0,
  "initiated_at": 1758614400,
  "uuid": "mj_recharge_01H9",
  "type": "COLLECT"
}

{
  "success": true,
  "muneemji_recharge": {
    "driver_uuid": "drv_7c81",
    "amount_rs": 500.0,
    "initiated_at": 1758614400,
    "state": "Initiated"
  },
  "status": 200,
  "error_code": null
}

数据类别

收入
发票
结算
税务
钱包

数据使用场景与案例

司机报税
税务应用拉取每笔订单的预扣税（适用税率、扣税额、订单号）汇入季度申报，司机不再靠截图拼扣税记录。
结算记账
记账集成导入打款发票与结算明细（平台费、增值税、总结算额、完成单量），核对平台应收与司机实收。
车队收入分析
车队经理读取当日收入与周报——完成单量、在线时长、每日明细——用以指导司机提升出车效率，而非只盯流水。

常见问题

Porter 司机端使用什么数据 API？

应用调用一套私有 JSON API 覆盖司机财务：当日 / 每周收入（GET /v1/earnings/today、GET /v1/earnings/weekly-report）、月度结算发票、TDS 代扣税查询与 Muneemji 钱包充值。

每周收入透明页的数据来自哪里？

GET /v1/earnings/weekly-report 按周返回总额、登录分钟数与逐单拆分，对应应用内的收入透明界面，帮助司机核对每一单的收入构成。

如何查询某单的 TDS 代扣税？

GET /v1/tax/withholding 按订单返回源头代扣税（税率、金额、状态与说明文案），对应印度税法下的 TDS 扣除。

Muneemji 钱包充值是什么？

POST /v1/wallet/collections 针对司机钱包发起一笔 Muneemji（现金代收）充值，Porter 据此向司机收取应付的现金差额。

与 Porter Driver Partner App 相似的应用

MOVER Delivery Partner Driver — MOVER 的司机端应用招募摩托车、三轮货运车以及 Tata Ace 等小型货车，在德里国家首都辖区、海得拉巴等印度城市承接按需货运订单。
BlackBuck — BlackBuck（Zinka Logistics）是印度的货运平台，卡车车主可通过其货源市场接单，并管理过路费、加油支付与车队追踪。
LetsTransport — LetsTransport 是印度的物流服务平台，为企业提供小货车预订，是三轮车和小货车车主获取货运订单的另一渠道。
Vahak — Vahak 是印度的运输撮合平台，将货主与商用车车主连接起来，承接整车与零担货运订单。
Blowhorn — Blowhorn 总部位于班加罗尔，提供城内物流服务，为电商卖家和个人用户承接当日达配送。
Ola Driver App — Ola 的司机端应用让印度各地的出租车、三轮车和网约摩的司机接单并查看当日收入。
Shadowfax — Shadowfax 是印度的末端配送平台，服务电商与同城即时配送订单，并招募自由配送员合作。
Rapido — Rapido 的车主端应用让印度摩托车主以网约摩的司机身份按单计费，也可接配送订单。

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

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

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

获取报价

Porter 司机端数据 API：收入、发票与 TDS

应用截图

API 端点一览

查询当日司机收入

查询每周收入报告

列出结算发票

查询发票结算明细

查询司机 TDS 代扣税

发起 Muneemji 钱包充值

数据类别

数据使用场景与案例

司机报税

结算记账

车队收入分析

常见问题

与 Porter Driver Partner App 相似的应用

更多出行类应用

99 Motorista e Entregador

Australia Post

Careem Captain

DHL Express Mobile

相关主题

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

Porter 司机端数据 API：收入、发票与 TDS

应用截图

API 端点一览

查询当日司机收入

查询每周收入报告

列出结算发票

查询发票结算明细

查询司机 TDS 代扣税

发起 Muneemji 钱包充值

数据类别

数据使用场景与案例

司机报税

结算记账

车队收入分析

常见问题

相关应用

与 Porter Driver Partner App 相似的应用

更多出行类应用

99 Motorista e Entregador

Australia Post

Careem Captain

DHL Express Mobile

相关主题

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