轻易云
注册体验
GEThttps://api.kingdee.com/jdy/v2/bd/materialapp-token + X-Api-* 签名头

商品列表查询(/jdy/v2/bd/material)

金蝶云星辰基础资料域商品(物料)列表接口,GET 分页查询商品编码、名称、规格、条码、计量单位等档案,用于商品主数据对齐与库存/订单映射。

来源：https://open.jdy.com/
## 接口说明 /jdy/v2/bd/material 属于星辰基础资料域(bd),分页查询商品(物料)档案:编码 number、名称 name、规格型号 specification、条码 barcode、计量单位、参考成本与售价等。商品主数据是订单、库存、采购所有链路的对齐基础,编码映射缺失是集成失败的第一大原因。 ### 请求要点 1. 鉴权同鉴权文档:app-token + X-Api-* 签名头 + X-GW-Router-Addr。 2. 分页:page、page_size;常用过滤:number(编码)、name(名称模糊)、barcode(条码)、enable(启用状态)、modify_time(增量游标)。 3. 返回 errcode=0 时,data.rows 为商品数组;多单位商品注意基本单位与辅助单位的换算率字段,数量同步前统一换算到基本单位。 4. 商品写入(反向)用 POST /jdy/v2/bd/material;编码为空时由星辰编码规则自动生成,更新时必须带编码。 ### 典型链路 星辰商品档案 → 轻易云标准化(编码、条码、类目、单位)→ 聚水潭/旺店通/微盟建档;每日回拉商品列表做映射完整性校验(电商平台商家编码 ↔ 星辰 number),缺映射 SKU 自动告警,防止订单行匹配失败进入人工队列。 ### 条码与辅助属性 启用辅助属性(颜色、尺码等)的商品,库存与订单行都精确到属性组合,商品档案中的属性字段必须一并同步;条码可能维护在商品级,也可能维护在属性组合级,取数时注意两层的优先级,避免下游系统拿到空条码导致扫码入库失败。

代码示例

curl
curl -G "https://api.kingdee.com/jdy/v2/bd/material" \
  --data-urlencode "page=1" --data-urlencode "page_size=100" \
  -H "X-Api-ClientID: xxx" -H "X-Api-TimeStamp: 1780000000000" \
  -H "X-Api-Nonce: 1234567" -H "X-Api-SignHeaders: X-Api-TimeStamp,X-Api-Nonce" \
  -H "X-Api-Auth-Version: 2.0" -H "X-Api-Signature: SIGN" \
  -H "app-token: TOKEN" -H "X-GW-Router-Addr: DOMAIN"

错误码

错误码消息含义
1030002006授权信息错误app-token 失效,重新获取
401验签失败重算 X-Api-Signature
商品列表查询(/jdy/v2/bd/material) | 轻易云