文件
Henglianshutong/docs/partner-api-contract.md

2.1 KiB

合伙股东前后端接口约定(两代理必须遵守)

profile GET user.user/profile 增补字段

{
  "identity_text": "品酒师",
  "identities": ["taster"],
  "is_partner": false,
  "maker_level_name": "",
  "madow": "0.00000000",
  "madow_rate": "0.00000075",
  "madow_value": "0.00",
  "voucher_available": "0.00",
  "active_30d": true
}

identities 取值:taster | maker | venue | county is_partner = 含 maker 或 venue 或 county identity_text 例:品酒师 / 合伙股东 · 创客V5 · 酒道馆

agent GET commission.agent 在原 agent 上增补

{
  "is_venue": 0,
  "is_county": 0,
  "county_code": "",
  "direct_order_seq": 0,
  "madow": "0.00000000",
  "madow_rate": "0.00000075",
  "madow_value": "0.00",
  "voucher_total": "0.00",
  "voucher_released": "0.00",
  "voucher_used": "0.00",
  "voucher_available": "0.00",
  "active_30d": true,
  "last_self_order_time": 0,
  "identities": ["taster"],
  "identity_text": "品酒师",
  "is_partner": false,
  "maker_level_name": ""
}

team 列表里每个 user.agent 同样带 is_venue / is_county / level_info

新接口前缀 /addons/shopro/partner.index

方法 路径 说明
GET partner.index overview
GET partner.index/rewards 分页流水 tab=all|push3|maker|venue|county|share
GET partner.index/madow 马豆+汇率+日流水
GET partner.index/voucher 券账户+计划列表

overview:

{
  "month_income": "0.00",
  "skip_count": 0,
  "active_30d": true
}

rewards 列表项:

{
  "id": 1,
  "reward_type": "push3",
  "reward_type_text": "推三返一",
  "amount": "398.00",
  "madow": "0.00000000",
  "status": 1,
  "status_text": "已入账",
  "skip_reason": "",
  "skip_reason_text": "",
  "buyer_nickname": "",
  "order_id": 1,
  "createtime": "2026-09-16 10:00:00",
  "formula": ""
}

madow:

{
  "madow": "0.00000000",
  "madow_rate": "0.00000075",
  "madow_value": "0.00",
  "list": []
}

voucher:

{
  "voucher_total": "0.00",
  "voucher_released": "0.00",
  "voucher_used": "0.00",
  "voucher_available": "0.00",
  "plans": []
}