蔬东坡开放平台 V2 常见问题知识库

一、鉴权与服务开通#

Q1：调用接口时提示未开通 openapi 服务，应该怎么处理？#

相关接口：平台服务开通项，无具体业务接口。

Q2：鉴权接口 token 获取异常，优先排查什么？#

相关接口：鉴权接口（appid / secret 校验）。

Q3：接口 QPS 可以调整吗？#

相关接口：全局调用策略问题，无单一业务接口。

二、订单与溯源#

Q1：订单商品的溯源信息怎么获取？#

相关接口：GET /openApiV2/Order/detail（cloud_origin_url 需 17.1.0+）。

Q2：如果商品溯源报告存在多个批次，cloud_origin_url 返回的数据支持多批次吗？#

相关接口：GET /openApiV2/Order/detail -> commodity_list[].cloud_origin_url。

Q3：蔬东坡系统里订单已经发货了，但单据状态还是待收货，通常是什么原因？#

相关接口：GET /openApiV2/Order/detail（可关注 status、status_desc、sign_time）。

Q4：订单支持多个司机同时配送吗？#

相关接口：订单详情查询场景，无独立多司机接口。

三、收货与实收差异#

Q1：订单收货产生差异时，应该怎么通知平台方？#

相关接口：POST /openApiV2/Order/CreateModify；POST /openApiV2/Order/CreateChangeReceipts。

Q2：实收数量变更是否只能提交一次？#

相关接口：POST /openApiV2/Order/CreateModify；POST /openApiV2/Order/CreateChangeReceipts。

Q3：实收变更已经审核通过后，还能继续修改实收数量吗？#

相关接口：实收变更审核后按业务规则锁定。

四、财务对账与金额取数#

Q1：目前已经在调用销售出库接口，对账部分的数据应该从哪里获取？#

相关接口：GET /openApiV2/AccountBill/Detail；GET /openApiV2/PurchaseBill/Detail。

Q2：怎么获取订单的实际对账金额和实际成本金额？#

相关接口：GET /openApiV2/AccountBill/Detail；GET /openApiV2/out/detail；GET /openApiV2/in/detail。

Q3：采购退货接口里没有对应商品，怎么拿到采购入库中退货部分的信息？#

相关接口：GET /openApiV2/out/detail（采购退货场景可结合出库类型使用）。

五、商品主数据与单位#

Q1：商品支持重复单位吗？#

相关接口：GET /openApiV2/Commodity/pageList；GET /openApiV2/Commodity/pageSkuList。

Q2：商品存在多规格信息时，应该怎么创建？例如尺寸、规格、形状不同。#

相关接口：商品创建接口 + 商品 SPU / SKU 查询接口。

Q3：商品 SKU 接口和商品 SPU 接口的区别是什么？#

相关接口：GET /openApiV2/Commodity/pageList；GET /openApiV2/Commodity/pageSkuList。

Q4：创建商品时，什么场景需要勾选“按基础单位分拣”？#

相关接口：商品创建/编辑接口；订单详情与采购详情中也会返回 unit_convert 字段。

Q5：为什么商品勾选了“按基础单位分拣”后，采购单里不能再选择其他单位？#

相关接口：采购相关接口（商品单位识别依赖 unit / unit_convert / base_unit）。

Q6：同一个商品如果不按基础单位分拣，每个单位的库存是独立计算，还是合并计算？#

相关接口：库存查询接口；商品 SKU 查询接口。

Q7：新增商品时如果一次上传多个单位，返回的商品 id 是哪一个？#

相关接口：商品创建接口；GET /openApiV2/Commodity/pageList；GET /openApiV2/Commodity/pageSkuList。

六、仓库与配送#

Q1：如果一个客户实际对应多个仓库，应该怎么下单和发货？#

相关接口：当前无客户多仓专用接口，需结合仓库调拨与虚拟仓方案落地。