订单详情：发票类型接入说明

更新：2026-11-05。适用：用户、商家和骑手 App 的外卖订单详情。

接口与字段

请求参数保持不变，均需携带 token 请求头。

使用端	GET 接口	订单号参数
用户、商家	`/system/order/getorderxq`	`ddid`
骑手	`/system/orderQsOprate/getOrderDetial`	`ddId`

两个接口在 data 中增加 invoiceChoice，类型为字符串或 null。

invoiceChoice	页面显示
`PAPER`	纸本发票
`PHONE_BARCODE`	手机条码载具
`CITIZEN`	自然人凭证载具
`MEMBER`	会员发票
`LOVE_CODE`	捐赠发票
`COMPANY`	公司发票
`null`、空值或未识别值	暂无发票信息

页面显示“发票类型：纸本发票”等文案，标题和类型名称使用客户端现有国际化机制。

响应示例

下面只展示与本次接入相关的字段，订单详情原有字段保持不变。

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": 1001,
    "ddId": "991793757396125",
    "invoiceChoice": "PAPER"
  }
}

展示规则

直接读取 data.invoiceChoice，不需要额外调用发票详情接口获取类型。
尚未开票时也可能已有发票类型；显示类型不代表已经开票或已交付。
无类型时显示“暂无发票信息”，不要默认显示纸本发票。
MEMBER 表示会员选择，当前流程实际开立纸本；不能仅凭名称判断为电子载具票。
商家打印入口继续使用 canPrintInvoice 和 invoicePrintCount，不要根据 invoiceChoice 单独开放打印。
本字段用于显示类型，不包含载具号码、统编、邮箱或发票凭证。

联调检查

用户、商家与骑手查看同一订单时，发票类型一致。
六种选择及无类型订单均显示对应文案，未开票订单可显示已保存类型。
请求失败时按现有逻辑显示错误，不把无访问权限当作“暂无发票信息”。
商家原有打印入口和其他订单详情字段正常。