{
  "fetchedAt": "2026-07-03T03:14:04.486Z",
  "commandShape": "GET /oapi/v1/projex/organizations/{org}/workitems/VWCG-1072",
  "httpStatus": 200,
  "workItem": {
    "creator": {
      "name": "李潇",
      "id": "63575519287a2b849fa9a642"
    },
    "modifier": {
      "name": "李潇",
      "id": "63575519287a2b849fa9a642"
    },
    "gmtCreate": 1783045382000,
    "gmtModified": 1783045382000,
    "serialNumber": "VWCG-1072",
    "subject": "【滨州项目】一卡通系统对接：人员余额同步、消费订单与退款信息推送",
    "description": "## 需求背景\n\n滨州项目需要与客户原有一卡通系统对接。客户侧一卡通作为人员、卡和余额的主数据来源；智慧营养健康餐厅系统负责产生消费订单、消费明细和退款/冲正数据，并同步给一卡通用于扣款、对账和留痕。\n\n## 需求范围\n\n### 1. 一卡通同步给本系统\n\n- 人员基础信息：一卡通人员唯一ID、工号/人员编号、姓名、手机号、性别、证件号等。\n- 部门组织信息：部门ID、部门名称、上级部门ID。\n- 身份与状态：身份类别、人员启停状态、在职/离职状态。\n- 卡信息：物理卡号/IC卡号、卡状态（正常、挂失、冻结、退卡）。\n- 余额信息：现金余额、补贴/餐补余额、总余额、更新时间。\n\n### 2. 本系统同步给一卡通\n\n- 消费订单主信息：订单号、设备流水号、人员/卡号、部门快照、消费日期、餐次、下单时间、支付时间、餐厅/档口、设备编号、订单来源、支付类型、在线/离线收款模式。\n- 金额信息：商品原价、订单金额、实付金额、现金支付金额、补贴支付金额、优惠金额、管理费、打包费、消费后现金余额、消费后补贴余额、消费后总余额。\n- 订单状态：支付状态、订单状态、退款状态、已退金额、备注、创建时间、更新时间。\n- 消费明细：订单号、菜品ID/UUID、菜品名称、分类、数量/份数、重量、单价、明细金额、明细优惠/实收金额（如需要）、营养字段（如一卡通需要）。\n- 退款/冲正信息：退款单号、原订单号、人员/卡号、退款总金额、现金退款金额、补贴退款金额、退款原因、申请人、申请时间、审核人、审核时间、退款状态、退款后余额快照。\n\n## 不包含范围\n\n- 本系统不做充值功能。\n- 本系统不做提现功能。\n- 本次不需要同步取餐柜相关信息，包括取餐柜设备编号、柜格编号、存餐/取餐/撤销时间和取餐柜状态。\n\n## 关键对接口径\n\n- 余额主账以一卡通为准，本系统只保存必要的余额快照。\n- 消费同步需支持幂等，建议消费用订单号 + 设备流水号，退款用退款单号。\n- 离线消费恢复后不得重复扣款。\n- 退款需要作为独立数据同步给一卡通，不能只更新原消费订单。\n- 人员离职、卡挂失、卡冻结后，本系统应按一卡通状态限制消费。\n\n## 验收要点\n\n- 能从一卡通同步人员、部门、卡、余额和状态数据，并在本系统消费链路中正确识别人员和卡。\n- 本系统消费订单可按约定字段推送给一卡通，包含现金/补贴拆分金额和消费后余额快照。\n- 本系统消费明细可按订单关联推送给一卡通，满足客户对账需要。\n- 退款/冲正信息可同步给一卡通，支持全额退款、部分退款、现金/补贴拆分退款。\n- 重复推送同一消费订单或退款单时，一卡通侧不会重复扣款或重复退款。\n- 不涉及充值、提现、取餐柜信息同步。",
    "formatType": "MARKDOWN",
    "assignedTo": {
      "name": "兰海军",
      "id": "635755195dc8531eeb2e33d9"
    },
    "status": {
      "name": "待处理",
      "nameEn": "To Do",
      "displayName": "待处理",
      "id": "100005"
    },
    "space": {
      "name": "【产品线】智慧营养健康餐厅",
      "id": "dd2f708d1702891ff45b6f5d99"
    },
    "workitemType": {
      "name": "产品类需求",
      "id": "9uy29901re573f561d69jn40"
    },
    "logicalStatus": "NORMAL",
    "customFieldValues": [
      {
        "fieldName": "优先级",
        "fieldFormat": "list",
        "values": [
          {
            "identifier": "04f8224daf4e1e1050bca2cd4c",
            "displayValue": "中"
          }
        ],
        "fieldId": "priority"
      }
    ],
    "updateStatusAt": null,
    "trackers": null,
    "participants": null,
    "verifier": null,
    "sprint": null,
    "labels": null,
    "versions": null,
    "id": "7bf53ba9a08e47f7d709f7c79c",
    "idPath": null,
    "statusStageId": "1",
    "categoryId": "Req",
    "parentId": null
  }
}