Qeasy Cloud
Get Started
POSThttps://open-api.hupun.com/api/erp/goods/spec/open/query/goodswithspeclistAppKey + Secret MD5 签名

Query Goods with Spec List (goodswithspeclist)

万里牛商品(SPU)及其规格(SKU)列表查询接口,分页拉取商品档案与规格明细,用于商品主数据对齐、编码映射与跨系统建档。

## Overview /erp/goods/spec/open/query/goodswithspeclist reads Hupun's goods master together with its spec (SKU) lines in one call: item code, name, barcode, spec code, reference purchase price and standard sale price — the standard extraction point for product master-data sync. ### Request essentials 1. Build _app/_t/_sign per the call convention; paginate with page/limit. 2. The data array lists goods each with a spec list: item_code, item_name, barcode, spec_code, sale_price and prime_price. 3. The reverse push API /erp/goods/add/item creates or updates goods; query and push together close the loop of ERP-master ↔ Hupun alignment. 4. Code mapping decides success: Hupun spec_code must map one-to-one to ERP material codes and marketplace merchant codes — unmapped items surface as "unknown product" exceptions at order-line level. ### Typical pipeline ERP item master → Qeasy cleansing (unit, barcode, category normalization) → Hupun creation; a daily pull via this API feeds a mapping-completeness report, and unmapped goods enter a work queue automatically. ### Mind the spec hierarchy Even spec-less goods carry a default entry under the spec list, so never skip spec-level mapping just because the list length is one. Barcodes live at spec level for multi-spec goods — validate barcode alignment with the ERP spec by spec rather than at the goods header, because unmapped specs surface later as unknown-product exceptions on order lines.

Code examples

curl
curl -X POST "https://open-api.hupun.com/api/erp/goods/spec/open/query/goodswithspeclist" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_app=AK&_t=1780000000&_sign=SIGN&page=1&limit=50"

Error codes

CodeMessageMeaning
0success成功
sign_error签名验证失败重算 _sign