## 接口说明
/erp/goods/spec/open/query/goodswithspeclist 查询万里牛 ERP 的商品档案及规格明细:SPU(商品)与 SKU(规格)两级结构一次返回,包含商品编码、名称、条码、规格编码、参考进价、标准售价等字段,是商品主数据同步的标准出数口。
### 请求要点
1. 系统参数 _app/_t/_sign 按调用规范构造;分页参数 page/limit。
2. 返回 data 中商品数组,每个商品带规格列表(spec):item_code(商品编码)、item_name、barcode(条码)、spec_code(规格编码)、sale_price(标准售价)、prime_price(参考进价)等。
3. 商品推送(建档/更新)走反向接口 /erp/goods/add/item;查询与推送配合可完成"ERP 商品主数据 → 万里牛"的双向对齐。
4. 编码映射是商品集成成败的关键:万里牛 spec_code 需与 ERP 物料编码、电商平台商家编码一一对应,映射缺失会在订单行级别产生"未匹配商品"异常。
### 典型链路
ERP 商品档案 → 轻易云清洗(计量单位、条码、类目标准化)→ 万里牛建档;每日用本接口回拉商品与规格,生成编码映射完整性报告,缺映射商品自动进入待处理队列。
### 规格层级注意
无规格商品在万里牛中也以“默认规格”的形式挂在 spec 列表下,处理时不要因为 spec 长度为 1 就跳过规格层映射;多规格商品的条码维护在规格层,条码与 ERP 对齐时要逐规格校验,规格映射缺失会在订单行级别产生“未匹配商品”异常,进入人工处理队列。