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

SmartShift Logistics Solutions Private Limited · 出行

Porter 司机端的收入界面由一套私有财务 API 驱动：GET /v1/earnings/today 返回当日收入与含贷方的累计总额，GET /v1/earnings/weekly-report 加载每周收入透明页（周总额、在线时长、逐单拆分）。

结算与税务同样在线可查：GET /v1/payouts/invoices 列出月度结算发票，GET /v1/tax/withholding 查询订单的 TDS 代扣税，POST /v1/wallet/collections 发起 Muneemji 钱包充值。

Porter Driver Partner App 是印度按需货运网络 Porter 的司机端应用（覆盖摩托、三轮车、Ace 与卡车）。在首页收入卡片、每周收入透明页与发票界面背后，是一套司机财务数据 API。

应用截图

API 端点一览

查询当日司机收入
GET /v1/earnings/today openfinance
返回司机当日收入及含贷方调整的累计总额。
认证方式： Bearer token from OTP login session (Authorization header)
- 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
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- reconstructed from the app's home-screen earnings card flow
- field names match the daily-earnings model backing that card

查询每周收入报告

GET /v1/earnings/weekly-report openfinance

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

认证方式： Bearer token from OTP login session (Authorization header)

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"
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

reconstructed from the app's weekly earning-transparency screen
mirrors the dated week-summary and day-by-day breakdown models

列出结算发票
GET /v1/payouts/invoices openfinance
列出司机的月度结算发票（发票号、月份、年份）及可查的年度范围。
认证方式： Bearer token from OTP login session (Authorization header)
- 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]
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- reconstructed from the app's invoice-list screen and its year/month filters
查询发票结算明细
GET /v1/payouts/invoices/{invoice_id} openfinance
返回单张结算发票的开票金额、平台费、增值税、其他税费与净结算额。
认证方式： Bearer token from OTP login session (Authorization header)
- 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"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- reconstructed from the invoice detail sheet opened from the invoice list
- settlement fields match the billed-vs-settled breakdown the app renders
查询司机 TDS 代扣税
GET /v1/tax/withholding openfinance
查询某订单的源头代扣税（税率、金额、状态与说明）。
认证方式： Bearer token from OTP login session (Authorization header)
- 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"}
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- reconstructed from the wallet TDS banner and trip settlement screens
- per-order lookup keyed by the order reference and the partner id
发起 Muneemji 钱包充值
POST /v1/wallet/collections openfinance
针对司机钱包发起 Muneemji（现金代收）充值，供 Porter 收取现金差额。
认证方式： Bearer token from OTP login session (Authorization header)
- 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
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- reconstructed from the wallet cash-collection (Muneemji) payment flow
- create-and-track shape: the response carries the new recharge state

数据类别

收入
发票
结算
税务
钱包

数据使用场景与案例

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

常见问题

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 据此向司机收取应付的现金差额。

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

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

获取报价

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

应用截图

API 端点一览

查询当日司机收入

查询每周收入报告

列出结算发票

查询发票结算明细

查询司机 TDS 代扣税

发起 Muneemji 钱包充值

数据类别

数据使用场景与案例

司机报税

结算记账

车队收入分析

常见问题

相关应用

相关主题

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