格物开放 API结算与下单

REST API · 接口参考

REST API 参考 · 员工福利购物 / 企业采购

结算与下单

结算与下单都收内联商品与收货人，购物车与地址簿可以用平台的，也可以自己做。下单固定传 payWith: "auto"，付款方式由平台按企业配置（全额扣员工额度，或员工在企业购收银台付现金：支付宝 / 微信 / 对公）；扣款与建单在同一事务里，idempotencyKey 同键重试不会重复建单。要员工付现金时，结算预览返回 cash（金额与可选的支付方式 payTypes）。

#行政区划逐级查

GET/v1/divisions

行政区划逐级查（省 → 市 → 区县 → 乡镇街道）：收货地址的 province / city / area / street 用这里选出的名称

鉴权appKey

出现在福利 / 采购 · 额度与下单消费者 · 用户与地址

从 parent=1（全国）开始逐级下钻：省 → 市 → 区县（divisionCode）→ 乡镇街道（townDivisionCode）。与福利GO 小程序、网页商城的地址选择同一份数据。老路径 /v1/lm/divisions 仍可用，返回相同。企业购下单的 receiver.province / city / area 用这里选出的名称，乡镇街道名称放进 receiver.street；也可以把带区划码的地址存进地址簿，下单传 addressId。

查询参数

字段	类型	必填	说明
`parent`	string	否	上一级区划码。默认 `"1"`

返回字段

字段	类型	说明
`ok`	boolean
`items`	object[]
`items[].code`	string
`items[].name`	string
`items[].parentCode`	string
`items[].hasChildren`	boolean
`items[].level`	integer	2 省 / 3 市 / 4 区县 / 5 乡镇街道

调用示例

1curl -X GET "https://api.gowu.net/v1/divisions?parent=1" \2  -H "x-app-key: $GOWU_APP_KEY"

返回示例

1{2  "ok": true,3  "items": [4    {5      "code": "string",6      "name": "string",7      "parentCode": "string",8      "hasChildren": true,9      "level": 010    }11  ]12}

#结算预览：权威价、运费、库存、额度是否足够

POST/v1/enterprise/checkout/render

鉴权用户态

出现在福利 / 采购 · 额度与下单

权威价、库存与可售状态；员工已绑定企业时返回 points（额度是否足够）。不需要收货地址。

请求体application/json

字段	类型	必填	说明
`items`	object[]	是
`items[].productId`	string	是	商品接口返回的 id
`items[].skuId`	string	否	商品详情 skus[].skuId；skuId 为 null 的商品不要传
`items[].qty`	integer	否	默认 `1`。≥ 1
`device`	string	否	（员工付现金 · 网页 / H5）场景，决定 `cash.payTypes` 里有没有微信；缺省按 appKey 登记的端。可选值：`pc` / `mobile`

返回字段30 个，点击展开

字段	类型	说明
`ok`	boolean
`render`	object
`render.totalFee`	number
`render.postFee`	number
`render.payable`	number
`render.lines`	object[]
`items`	object[]
`items[].productId`	string
`items[].title`	string
`items[].imageUrl`	string
`items[].skuId`	string
`items[].skuText`	string
`items[].price`	number
`items[].qty`	integer
`items[].lineTotal`	number
`availabilityOk`	boolean
`issues`	object[]
`issues[].productId`	string
`issues[].title`	string
`issues[].reason`	string	可选值：`OFF_SHELF` / `OUT_OF_STOCK` / `PRICE_CHANGED`
`issues[].detail`	string
`points`	object	员工已绑定企业时返回
`points.required`	number	这单需要的额度（100 = 1 元）
`points.balance`	number
`points.sufficient`	boolean
`points.canUsePoints`	boolean
`cash`	object	这单要员工付现金时返回（企业配置为全额现金或混合，且当前端已开通）。全额现金时 `cent` 就是应付总额；混合时 `points.required` 是企业承担的那部分
`cash.cent`	integer	员工自付的现金（分）
`cash.ratioBp`	integer	企业承担比例（万分比）；0 = 全额由员工付。混合支付暂未开放，目前恒为 0
`cash.payTypes`	string[]	这个 appKey 在当前场景下可用的现金支付方式（支付宝 / 微信 / 对公），按它在你的下单页展示，员工选中的作为下单的 `payType` 传回。可选值：`ALIPAY` / `WECHAT_H5` / `DGZF`

错误

400 EMPTY / PRODUCT_NOT_FOUND / RENDER_FAILED / ORG_EGP_NOT_READY（企业的交易尚未开通）

调用示例

1curl -X POST "https://api.gowu.net/v1/enterprise/checkout/render" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001" \8  -H "content-type: application/json" \9  -d '{"items":[{"productId":"ep_800000000001","skuId":"…","qty":2}]}'

返回示例

1{2  "ok": true,3  "render": {4    "totalFee": 0,5    "postFee": 0,6    "payable": 0,7    "lines": [8      null9    ]10  },11  "items": [12    {13      "productId": "string",14      "title": "string",15      "imageUrl": "string",16      "skuId": "string",17      "skuText": "string",18      "price": 0,19      "qty": 0,20      "lineTotal": 021    }22  ],23  "availabilityOk": true,24  "issues": [25    {26      "productId": "string",27      "title": "string",28      "reason": "OFF_SHELF",29      "detail": "string"30    }31  ],32  "points": {33    "required": 0,34    "balance": 0,35    "sufficient": true,36    "canUsePoints": true37  },38  "cash": {39    "cent": 0,40    "ratioBp": 0,41    "payTypes": [42      "ALIPAY"43    ]44  }45}

#下单

POST/v1/enterprise/orders

下单（payWith: auto，付款方式按企业配置；要员工付现金时返回付款链接 launchUrl）

鉴权用户态

出现在福利 / 采购 · 额度与下单

`payWith` 固定传 `"auto"`：付款方式完全由平台按企业配置决定——全额扣员工额度、全额由员工付现金，还是按比例混合（混合暂未开放，开放后无需改接入）；该 appKey 没开通员工付现金时一律扣额度。扣额度与建单在同一事务里。要员工付现金时响应带 launchUrl（24 小时有效）——支付方式（payType）由你在下单页让员工选（可选项见结算预览的 cash.payTypes），会产生现金时必填；把员工带到 launchUrl 即进入付款（对公为转账信息）。发起后默认沿用这种方式，可在继续支付时更换。付完平台核实到账、扣额度、结清订单（付款页由企业购提供，不一定跳回你的页面；以订单详情的 mixedPay.status 与 order.status 推送为准）。员工付现金需要该 appKey 已开通（找平台在访问管理里开）。过期或中途关闭了用 POST /v1/enterprise/orders/{bizOrderId} action=resume-pay 重新取链接；结果以订单详情的 mixedPay.status 与 order.status 推送为准。收货地址 receiver 与 addressId（地址簿）二选一，同时传以 addressId 为准。幂等：强烈建议传 idempotencyKey，响应丢失时用同一个 key 重试，返回同一张单；不传时服务端按内容生成，只在 2 分钟内去重。

请求体application/json

字段	类型	必填	说明
`items`	object[]	是
`items[].productId`	string	是	商品接口返回的 id
`items[].skuId`	string	否	商品详情 skus[].skuId；skuId 为 null 的商品不要传
`items[].qty`	integer	否	默认 `1`。≥ 1
`receiver`	object	否	收货人。省、市、区用名称（不是区划码），全部必填；名称请用 `GET /v1/divisions` 逐级选（乡镇街道放 `street`），叫法不一致上游会以 `321000 地址没有找到` 拒单
`receiver.name`	string	是
`receiver.mobile`	string	是
`receiver.province`	string	是	省名称，取自 /v1/divisions。例：`浙江省`
`receiver.city`	string	是	市名称，取自 /v1/divisions。例：`杭州市`
`receiver.area`	string	是	区 / 县名称，取自 /v1/divisions。例：`西湖区`
`receiver.street`	string	否	乡镇街道名称（/v1/divisions 第四级），建议传：会拼在详细地址前面，地址更容易被上游认出
`receiver.addressDetail`	string	是
`addressId`	string	否
`payWith`	string	否	固定传 `auto`：付款方式由平台按企业配置——全额扣员工额度、全额由员工在企业购收银台付现金，或两者按比例混合（混合暂未开放）；appKey 没开通员工付现金时扣额度。可选值：`auto`
`payType`	string	否	（员工付现金时）现金的支付方式：支付宝 / 微信 / 对公。这单会产生现金时必填（不传 400 `PAY_TYPE_REQUIRED`，响应带可选的 `payTypes`）。请在你的下单页按结算预览返回的 `cash.payTypes` 让员工选。必须在该 appKey 允许的范围内（平台在访问管理配置；没配时按登记的端：支付宝小程序为支付宝 + 对公，微信小程序为微信 + 对公，网页为全部、电脑上不含微信），否则 400 `PAY_TYPE_NOT_ALLOWED`。可选值：`ALIPAY` / `WECHAT_H5` / `DGZF`
`returnUrl`	string	否	（员工付现金 · 网页 / H5）收银台与结果页的「返回」地址：须 https，且是该 appKey 登记的回调地址的域名或其子域。会追加 `bizOrderId` 与 `result`（success / pending / failed / cancel，只是提示）。现金在企业购收银台付，付完不一定跳回这里——以订单查询或 order.status 推送为准
`device`	string	否	（员工付现金 · 网页 / H5）收银台形态；缺省按 appKey 登记的端。可选值：`pc` / `mobile`
`idempotencyKey`	string	否	建议用你系统的订单号
`remark`	string	否

返回字段35 个，点击展开

字段	类型	说明
`ok`	boolean
`bizOrderId`	string
`order`	object
`order.bizOrderId`	string	订单号
`order.outOrderId`	string
`order.unifiedStatus`	string	归一化订单状态，按它做业务判断。可选值：`CREATED` / `PAID` / `SHIPPED` / `DELIVERED` / `COMPLETED` / `CANCELED` / `REFUNDING` / `REFUNDED` / `REFUND_REJECTED`
`order.unifiedStatusLabel`	string
`order.displayStatus`	string
`order.totalFee`	number
`order.postFee`	number
`order.payable`	number
`order.items`	object[]
`order.items[].productId`	string
`order.items[].title`	string
`order.items[].imageUrl`	string
`order.items[].skuId`	string
`order.items[].skuText`	string
`order.items[].price`	number
`order.items[].qty`	integer
`order.items[].lineTotal`	number
`order.subOrders`	object[]	子订单；售后按子订单发起
`order.subOrders[].bizOrderId`	string	子订单号
`order.subOrders[].itemId`	string
`order.subOrders[].skuId`	string
`order.subOrders[].itemName`	string
`order.subOrders[].itemPrice`	number
`order.subOrders[].buyAmount`	number
`order.receiver`	object
`order.remark`	string
`order.createdAt`	string
`order.updatedAt`	string
`pointsCharged`	number	扣除的额度（100 = 1 元）。要员工付现金的单付完才扣，下单时不返回
`hybrid`	boolean	这单要员工付现金（字段名沿用旧称）
`cashCent`	integer	员工要付的现金（分）
`launchUrl`	string	付款链接（企业购收银台入口），24 小时有效

错误

400 EMPTY / BAD_RECEIVER / ADDRESS_NOT_FOUND / PRODUCT_NOT_FOUND / UNAVAILABLE / INSUFFICIENT_POINTS / POINTS_NOT_BOUND / ORG_NOT_ACTIVE / MEMBER_NOT_ACTIVE / ORG_EGP_NOT_READY / IN_PROGRESS（同 key 正在处理）/ CREATE_FAILED / CREATE_PENDING；员工付现金：BAD_RETURN_URL / PAY_TYPE_REQUIRED（会产生现金但没传 payType，响应带 payTypes）/ PAY_TYPE_NOT_ALLOWED（payType 不在该 appKey 的范围内）等

调用示例

1curl -X POST "https://api.gowu.net/v1/enterprise/orders" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001" \8  -H "content-type: application/json" \9  -d '{"items":[{"productId":"ep_800000000001","skuId":"…","qty":2}],"receiver":{"name":"张三","mobile":"138…","province":"浙江省","city":"杭州市","area":"西湖区","addressDetail":"…"},"payWith":"auto","idempotencyKey":"your-order-20260924-0001"}'

返回示例

1{2  "ok": true,3  "bizOrderId": "string",4  "order": {5    "bizOrderId": "string",6    "outOrderId": "string",7    "unifiedStatus": "CREATED",8    "unifiedStatusLabel": "string",9    "displayStatus": "string",10    "totalFee": 0,11    "postFee": 0,12    "payable": 0,13    "items": [14      {15        "productId": "string",16        "title": "string",17        "imageUrl": "string",18        "skuId": "string",19        "skuText": "string",20        "price": 0,21        "qty": 0,22        "lineTotal": 023      }24    ],25    "subOrders": [26      {27        "bizOrderId": "string",28        "itemId": "string",29        "skuId": "string",30        "itemName": "string",31        "itemPrice": 0,32        "buyAmount": 033      }34    ],35    "receiver": null,36    "remark": "string",37    "createdAt": "string",38    "updatedAt": "string"39  },40  "pointsCharged": 0,41  "hybrid": true,42  "cashCent": 0,43  "launchUrl": "string"44}

#订单列表

GET/v1/enterprise/orders

鉴权用户态

当前员工的订单，新的在前。要员工付现金的订单带 mixedPay 摘要（不含收银台链接，继续支付请进详情或调 resume-pay）。

查询参数

字段	类型	必填	说明
`limit`	integer	否	默认 `50`。≥ 1，≤ 200

返回字段29 个，点击展开

字段	类型	说明
`items`	object[]
`items[].bizOrderId`	string	订单号
`items[].outOrderId`	string
`items[].unifiedStatus`	string	归一化订单状态，按它做业务判断。可选值：`CREATED` / `PAID` / `SHIPPED` / `DELIVERED` / `COMPLETED` / `CANCELED` / `REFUNDING` / `REFUNDED` / `REFUND_REJECTED`
`items[].unifiedStatusLabel`	string
`items[].displayStatus`	string
`items[].totalFee`	number
`items[].postFee`	number
`items[].payable`	number
`items[].items`	object[]
`items[].items[].productId`	string
`items[].items[].title`	string
`items[].items[].imageUrl`	string
`items[].items[].skuId`	string
`items[].items[].skuText`	string
`items[].items[].price`	number
`items[].items[].qty`	integer
`items[].items[].lineTotal`	number
`items[].subOrders`	object[]	子订单；售后按子订单发起
`items[].subOrders[].bizOrderId`	string	子订单号
`items[].subOrders[].itemId`	string
`items[].subOrders[].skuId`	string
`items[].subOrders[].itemName`	string
`items[].subOrders[].itemPrice`	number
`items[].subOrders[].buyAmount`	number
`items[].receiver`	object
`items[].remark`	string
`items[].createdAt`	string
`items[].updatedAt`	string

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/orders" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "items": [3    {4      "bizOrderId": "string",5      "outOrderId": "string",6      "unifiedStatus": "CREATED",7      "unifiedStatusLabel": "string",8      "displayStatus": "string",9      "totalFee": 0,10      "postFee": 0,11      "payable": 0,12      "items": [13        {}14      ],15      "subOrders": [16        {}17      ],18      "receiver": null,19      "remark": "string",20      "createdAt": "string",21      "updatedAt": "string"22    }23  ]24}

#订单详情

GETPOST/v1/enterprise/orders/{bizOrderId}

订单详情（要员工付现金的单带 mixedPay）/ 确认收货、取消、继续支付（action=resume-pay）

鉴权用户态

出现在福利 / 采购 · 额度与下单

GET

订单详情

要员工付现金的订单带 mixedPay；还没付完时给出 mixedPay.launchUrl。可用 returnUrl / device 覆盖下单时的设置。

路径参数

字段	类型	必填	说明
`bizOrderId`	string	是

查询参数

字段	类型	必填	说明
`returnUrl`	string	否	（员工付现金 · 网页 / H5）收银台与结果页的「返回」地址：须 https，且是该 appKey 登记的回调地址的域名或其子域。会追加 `bizOrderId` 与 `result`（success / pending / failed / cancel，只是提示）。现金在企业购收银台付，付完不一定跳回这里——以订单查询或 order.status 推送为准
`device`	string	否	（员工付现金 · 网页 / H5）收银台形态；缺省按 appKey 登记的端。可选值：`pc` / `mobile`

返回字段33 个，点击展开

字段	类型	说明
`bizOrderId`	string	订单号
`outOrderId`	string
`unifiedStatus`	string	归一化订单状态，按它做业务判断。可选值：`CREATED` / `PAID` / `SHIPPED` / `DELIVERED` / `COMPLETED` / `CANCELED` / `REFUNDING` / `REFUNDED` / `REFUND_REJECTED`
`unifiedStatusLabel`	string
`displayStatus`	string
`totalFee`	number
`postFee`	number
`payable`	number
`items`	object[]
`items[].productId`	string
`items[].title`	string
`items[].imageUrl`	string
`items[].skuId`	string
`items[].skuText`	string
`items[].price`	number
`items[].qty`	integer
`items[].lineTotal`	number
`subOrders`	object[]	子订单；售后按子订单发起
`subOrders[].bizOrderId`	string	子订单号
`subOrders[].itemId`	string
`subOrders[].skuId`	string
`subOrders[].itemName`	string
`subOrders[].itemPrice`	number
`subOrders[].buyAmount`	number
`receiver`	object
`remark`	string
`createdAt`	string
`updatedAt`	string
`mixedPay`	object	员工付现金的状态（只有要员工付现金的订单才有，字段名沿用旧称）。pending = 现金还没付；paid = 现金已到账、正在结清；confirmed = 已付清；failed = 订单已关（已付的现金原路退回）
`mixedPay.status`	string	可选值：`pending` / `paid` / `confirmed` / `failed`
`mixedPay.cashCent`	integer	员工自付的现金（分）
`mixedPay.pointsCent`	integer	企业承担的额度（100 = 1 元）
`mixedPay.launchUrl`	string	（仅详情）收银台链接，24 小时有效；还没付完时给出

错误

404 资源不存在，或不归属你的 appKey / 当前用户

POST

取消 / 确认收货 / 继续支付

action 放在 query 或 body：cancel 取消（已发货不能取消）、receive 确认收货、resume-pay 继续付现金（重新取付款链接）。失败返回 400 { ok: false, message }。 resume-pay：现金已付完的直接结清，返回 state: "done"；还没付的返回 state: "need_pay" 与新的 launchUrl（同一张单，不会重复收钱）。可带 returnUrl / device / payType（已发起过的单沿用原支付方式，传别的不生效）。

路径参数

字段	类型	必填	说明
`bizOrderId`	string	是

查询参数

字段	类型	必填	说明
`action`	string	否	可选值：`cancel` / `receive` / `resume-pay`

请求体application/json

字段	类型	必填	说明
`action`	string	否	可选值：`cancel` / `receive` / `resume-pay`
`payType`	string	否	resume-pay：现金支付方式，须在 appKey 允许的范围内（同下单接口）。还没发起过付款的单必填（不传 400 `PAY_TYPE_REQUIRED`）；已发起过的不传就沿用原方式。可选值：`ALIPAY` / `WECHAT_H5` / `DGZF`
`returnUrl`	string	否	（员工付现金 · 网页 / H5）收银台与结果页的「返回」地址：须 https，且是该 appKey 登记的回调地址的域名或其子域。会追加 `bizOrderId` 与 `result`（success / pending / failed / cancel，只是提示）。现金在企业购收银台付，付完不一定跳回这里——以订单查询或 order.status 推送为准
`device`	string	否	（员工付现金 · 网页 / H5）收银台形态；缺省按 appKey 登记的端。可选值：`pc` / `mobile`

返回字段

字段	类型	说明
`ok`	boolean
`message`	string
`state`	string	resume-pay 才有。可选值：`done` / `need_pay`
`launchUrl`	string	resume-pay 且 need_pay 时给出，24 小时有效
`cashCent`	integer

错误

400 操作不允许，见 message；resume-pay 还可能是 BAD_RETURN_URL / PAY_TYPE_NOT_ALLOWED

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/orders/{bizOrderId}" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "bizOrderId": "string",3  "outOrderId": "string",4  "unifiedStatus": "CREATED",5  "unifiedStatusLabel": "string",6  "displayStatus": "string",7  "totalFee": 0,8  "postFee": 0,9  "payable": 0,10  "items": [11    {12      "productId": "string",13      "title": "string",14      "imageUrl": "string",15      "skuId": "string",16      "skuText": "string",17      "price": 0,18      "qty": 0,19      "lineTotal": 020    }21  ],22  "subOrders": [23    {24      "bizOrderId": "string",25      "itemId": "string",26      "skuId": "string",27      "itemName": "string",28      "itemPrice": 0,29      "buyAmount": 030    }31  ],32  "receiver": null,33  "remark": "string",34  "createdAt": "string",35  "updatedAt": "string",36  "mixedPay": {37    "status": "pending",38    "cashCent": 0,39    "pointsCent": 0,40    "launchUrl": "string"41  }42}

#物流轨迹

GET/v1/enterprise/orders/{bizOrderId}/logistics

鉴权用户态

一单可能分多个包裹。未发货时 shipped: false、packages 为空。

路径参数

字段	类型	必填	说明
`bizOrderId`	string	是

返回字段17 个，点击展开

字段	类型	说明
`bizOrderId`	string
`shipped`	boolean
`packages`	object[]
`packages[].packageId`	string
`packages[].logisticsCompany`	string
`packages[].invoiceNo`	string	运单号
`packages[].statusDesc`	string
`packages[].consignTime`	string
`packages[].deliveredTime`	string
`packages[].items`	object[]
`packages[].items[].itemName`	string
`packages[].items[].skuName`	string
`packages[].items[].quantity`	integer
`packages[].tracks`	object[]
`packages[].tracks[].time`	string
`packages[].tracks[].desc`	string
`packages[].tracks[].city`	string

错误

400 UPSTREAM：上游查询失败
404 资源不存在，或不归属你的 appKey / 当前用户

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/orders/{bizOrderId}/logistics" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "bizOrderId": "string",3  "shipped": true,4  "packages": [5    {6      "packageId": "string",7      "logisticsCompany": "string",8      "invoiceNo": "string",9      "statusDesc": "string",10      "consignTime": "string",11      "deliveredTime": "string",12      "items": [13        {}14      ],15      "tracks": [16        {}17      ]18    }19  ]20}

#在路上的订单与最新物流节点

GET/v1/enterprise/orders/in-transit

在路上的订单与最新物流节点（最近 3 单）

鉴权用户态可选

「我的」页「N 个订单正在路上」：count 为在途订单数（在最近 50 单里统计），items 只给最近 3 单及各自最新物流节点（节点缓存 60 秒）。

返回字段

字段	类型	说明
`count`	integer
`items`	object[]	最多 3 项
`items[].bizOrderId`	string
`items[].unifiedStatus`	string
`items[].unifiedStatusLabel`	string
`items[].title`	string	第一件商品的标题
`items[].imageUrl`	string
`items[].latest`	object	最新物流节点；查不到为 null。可能为 null
`items[].latest.desc`	string
`items[].latest.time`	string

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/orders/in-transit" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "count": 0,3  "items": [4    {5      "bizOrderId": "string",6      "unifiedStatus": "string",7      "unifiedStatusLabel": "string",8      "title": "string",9      "imageUrl": "string",10      "latest": {11        "desc": "string",12        "time": "string"13      }14    }15  ]16}

#购物车

GETDELETE/v1/enterprise/cart

购物车（含合计与额度是否够）/ 清空

鉴权用户态可选

GET

购物车

可选。服务端购物车，按员工保存、换设备不丢。合计只统计还能买的行。员工已绑定企业时带 points：这车需要多少额度、够不够（企业为 active 且余额足够才为 true）。

返回字段18 个，点击展开

字段	类型	说明
`items`	object[]
`items[].productId`	string
`items[].externalItemId`	string
`items[].title`	string
`items[].imageUrl`	string
`items[].skuId`	string
`items[].skuText`	string	规格文案，如「黑色 / L」
`items[].price`	number
`items[].qty`	integer
`items[].lineTotal`	number
`items[].available`	boolean	缺省 = 能买；加购后下架、不可售、售罄时为 false
`items[].unavailableReason`	string	不能买的原因，可直接展示
`totalQty`	integer	只统计还能买的行
`totalAmount`	number	元；只统计还能买的行
`points`	object	员工已绑定企业时返回
`points.required`	number	需要的额度（100 = 1 元）
`points.balance`	number
`points.sufficient`	boolean

DELETE

清空购物车

可选。

返回字段

字段	类型	说明
`ok`	boolean	例：`true`

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/cart" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "items": [3    {4      "productId": "string",5      "externalItemId": "string",6      "title": "string",7      "imageUrl": "string",8      "skuId": "string",9      "skuText": "string",10      "price": 0,11      "qty": 0,12      "lineTotal": 0,13      "available": true,14      "unavailableReason": "string"15    }16  ],17  "totalQty": 0,18  "totalAmount": 0,19  "points": {20    "required": 0,21    "balance": 0,22    "sufficient": true23  }24}

#加购

POSTPUTDELETE/v1/enterprise/cart/items

加购（累加）/ 设数量 / 移出（DELETE ?productId=&skuId=）

鉴权用户态可选

POST

加入购物车

可选。同一商品 + SKU 已在车里时数量累加。qty 缺省 1。

请求体application/json

字段	类型	必填	说明
`productId`	string	是
`skuId`	string	否	商品详情 skus[].skuId；skuId 为 null 的商品不要传
`qty`	integer	否	≥ 0

返回字段成功，返回最新购物车

字段	类型	说明
`ok`	boolean
`cart`	object
`cart.items`	object[]
`cart.items[].productId`	string
`cart.items[].externalItemId`	string
`cart.items[].title`	string
`cart.items[].imageUrl`	string
`cart.items[].skuId`	string
`cart.items[].skuText`	string	规格文案，如「黑色 / L」
`cart.items[].price`	number
`cart.items[].qty`	integer
`cart.items[].lineTotal`	number
`cart.items[].available`	boolean	缺省 = 能买；加购后下架、不可售、售罄时为 false
`cart.items[].unavailableReason`	string	不能买的原因，可直接展示
`cart.totalQty`	integer	只统计还能买的行
`cart.totalAmount`	number	元；只统计还能买的行

错误

400 缺少 productId

PUT

设置数量

可选。把该商品 + SKU 的数量设为 qty；qty 为 0 即删除。

请求体application/json

字段	类型	必填	说明
`productId`	string	是
`skuId`	string	否	商品详情 skus[].skuId；skuId 为 null 的商品不要传
`qty`	integer	否	≥ 0

返回字段成功，返回最新购物车

字段	类型	说明
`ok`	boolean
`cart`	object
`cart.items`	object[]
`cart.items[].productId`	string
`cart.items[].externalItemId`	string
`cart.items[].title`	string
`cart.items[].imageUrl`	string
`cart.items[].skuId`	string
`cart.items[].skuText`	string	规格文案，如「黑色 / L」
`cart.items[].price`	number
`cart.items[].qty`	integer
`cart.items[].lineTotal`	number
`cart.items[].available`	boolean	缺省 = 能买；加购后下架、不可售、售罄时为 false
`cart.items[].unavailableReason`	string	不能买的原因，可直接展示
`cart.totalQty`	integer	只统计还能买的行
`cart.totalAmount`	number	元；只统计还能买的行

错误

400 缺少 productId

DELETE

移出购物车

可选。

查询参数

字段	类型	必填	说明
`productId`	string	是
`skuId`	string	否

返回字段成功，返回最新购物车

字段	类型	说明
`ok`	boolean
`cart`	object
`cart.items`	object[]
`cart.items[].productId`	string
`cart.items[].externalItemId`	string
`cart.items[].title`	string
`cart.items[].imageUrl`	string
`cart.items[].skuId`	string
`cart.items[].skuText`	string	规格文案，如「黑色 / L」
`cart.items[].price`	number
`cart.items[].qty`	integer
`cart.items[].lineTotal`	number
`cart.items[].available`	boolean	缺省 = 能买；加购后下架、不可售、售罄时为 false
`cart.items[].unavailableReason`	string	不能买的原因，可直接展示
`cart.totalQty`	integer	只统计还能买的行
`cart.totalAmount`	number	元；只统计还能买的行

错误

400 缺少 productId

调用示例

1curl -X POST "https://api.gowu.net/v1/enterprise/cart/items" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001" \8  -H "content-type: application/json" \9  -d '{"productId":"ep_800000000001","skuId":"…","qty":1}'

返回示例

1{2  "ok": true,3  "cart": {4    "items": [5      {6        "productId": "string",7        "externalItemId": "string",8        "title": "string",9        "imageUrl": "string",10        "skuId": "string",11        "skuText": "string",12        "price": 0,13        "qty": 0,14        "lineTotal": 0,15        "available": true,16        "unavailableReason": "string"17      }18    ],19    "totalQty": 0,20    "totalAmount": 021  }22}