跳到主要内容

POST 按出库单号批量查询出库明细(按商品行展平)

POST 查询。body 为筛选条件 JSON(分页类含 pageNum、pageSize)。

接口编码所需范围后端接口
inventory.outbound.detail-by-nosinventory:readPOST /v1/outbound-order/detail-by-nos(comap-srm)

请求体字段(body)

字段类型必填说明
outboundNosstring[]—出库单号列表(精确匹配,最多 200 个)
orderIdinteger(int64)—销售订单 ID(可选,单订单/多订单合并发货均支持,单订单时 oi.order_id 可能为 NULL 此时按 o.sales_order_id 匹配)

「必填」仅反映接口规格声明的部分。服务内还有未体现在规格里的校验, 标「—」不等于可以不传;租户在主站配置的字段必填不约束本接口。 详见必填字段的判定与字段清单与自定义字段。

请求示例

curl -X POST https://open.risemap.cn/v1/api/invoke \
-H "Authorization: Bearer <访问令牌>" \
-H "Content-Type: application/json" \
-d '{
"apiCode": "inventory.outbound.detail-by-nos",
"body": {}
}'

响应 data 字段

字段类型必填说明
outboundIdinteger(int64)—---- 出库单信息 ----
outboundNostring—出库单号
outboundDatestring—出库日期
categoryinteger(int32)—分类:1=销售出库, 2=生产领料, 3=采购退货, 4=其他出库, 5=生产管理出库, 6=销售直接出库
statusinteger(int32)—状态
storeNamestring—仓库名称
customerNamestring—客户名称
creatorNamestring—创建人名称
shipmentNostring—发货编号
deliveryMethodinteger(int32)—交货方式:1=物流, 2=快递, 3=自提, 4=送货
carrierstring—承运商
carrierPhonestring—承运商电话
trackingstring—物流跟踪
deliveryContactNamestring—交付联系人名称
deliveryContactPhonestring—交付联系人电话
itemIdinteger(int64)—---- 商品行信息 ----
productIdinteger(int64)—物料ID
productNostring—物料编号
productNamestring—物料名称
bundleIdinteger(int64)—物料组合 ID(快照关联键)
bundleNostring—物料组合编码(快照,仅组合行有值)
bundleNamestring—物料组合名称(快照)
bundleModelstring—物料组合型号(快照)
bundleSpecNamestring—物料组合规格名称(快照)
bundleCategoryNamestring—物料组合分类名称(快照)
bundleQtynumber—物料组合套数
bundleUnitPricenumber—物料组合含税单价
bundleUnitNamestring—物料组合单位名称(快照)
modelstring—型号
skuLabelstring—规格(SKU 快照)
mainUnitNamestring—主单位名称
useUnitIdinteger(int64)—使用单位ID
useUnitNamestring—使用单位名称
useConversionRatenumber—使用换算率
primaryQtynumber—主单位数量
outNumnumber—出库数量
unitPricenumber—单价
totalAmountnumber—总金额
taxRatenumber—税率(%)
unitPriceTaxnumber—含税单价
taxAmountnumber—税额
totalAmountTaxnumber—含税总额
locationNamestring—库位名称
reasonstring—出库原因(仅其他出库有值)

错误处理​

响应统一信封 { code, message, data },code == 200 为成功。以下是本接口可能返回的开放平台层错误:

错误码说明可重试
92101访问凭证无效否
92201接口未登记或已停用否
92202超出凭证授权范围——本接口需 inventory:read否
92204绑定员工无此接口的功能权限否
92203上游服务调用失败是
92301请求过于频繁是

除此之外,comap-srm 自身的业务校验失败会原样透传其业务码与提示 (如字段校验、状态不允许、数据不存在),这类码不在开放平台的号段内, 以响应里的 message 为准。完整的平台层错误码见错误码说明。

← 返回出库单