1.首先进入明沐阳erp,新增一个自有商城类型店铺

2.新增成功后系统自动生成appkey,secret,公钥和私钥,供对接商城使用,店铺回调域名填写需要对接的商城域名即可

3.接口调用全局说明

apipost接口文档地址

https://doc.apipost.net/docs/detail/36352715bc01000?target_id=2347efa9b63016

用户只需要按照规范拼装一个正确的HTTP请求包，使用POST方法发送到指定的url地址上，即能获取到所需的数据。

erp加密解密代码参考路径

..\src\main\java\net\jjjerp\framework\util\OpenUtils.java

参数说明

appKey erp系统生成AppKey,创建自有店铺时获得

nonce 随机数

sign 传参使用sha256的方式生成的签名

timestamp 13位时间戳

appSign 使用sha256withRSA的方式对header中的内容加签

注意同步快递信息需要自有商城的快递绑定erp系统的承运商,承运商表请联系管理员获取

商城接入示例

调用API时需要对请求参数进行签名，服务器端会验证请求参数是否合法。加密规则为：

3.1 sign签名规则

body对象转json字符串后使用sha-256的方式生成签名sign

3.2 appSign签名规则

把header请求参数(除appSecret和thirdStoreId外)按照字母先后顺序排列,参数名和参数值进行拼装（最后加入appSecret = xxxxxxx）

使用SHA256withRSA算法进行签名后，再进行base64编码形成签名信息

例如

appKey=a65d2038ed62481393af31589ec470e1&nonce=2dfca490978d4c95933137a9b5d23e9d&sign=b2174f6e38cba791e48ade679950b80b35490f0314b29e9e750e3408608fa9ec×tamp=1729750377828&appSecret=8ad6c3f32c0863377a81bdf8d47774174c8c5501

请求示例

String appKey = supplier.getJjyAppkey();

String appSecret = supplier.getJjySecret();

//三方店铺id

String thirdStoreId = supplier.getShopSupplierId().toString();

//时间戳

String timestamp = String.valueOf(System.currentTimeMillis());

//随机数

String nonce = UUIDUtil.getUuid();

// 传参使用sha256的方式生成签名

String sign = ErpOpenUtils.getSHA256Str(json);

// 使用sha256withRSA的方式对header中的内容加签

String appSign = ErpOpenUtils.sha256withRSASignature(supplier.getJjyPrivatekey(), appKey,nonce,sign,timestamp,appSecret);

HttpResponse response = HttpRequest.post(url)

.header("Content-Type", "application/json;charset=UTF-8")

.header("appKey", appKey)

.header("nonce", nonce)

.header("sign", sign)

.header("timestamp", timestamp)

.header("appSign", appSign)

.header("thirdStoreId", thirdStoreId)

.body(json).execute();

4.接口调用逻辑

4.1 商城调用erp自有商城绑定店铺接口绑定店铺

单商户绑定页面

多商户绑定页面

4.2 erp调用商城获取商品列表接口拉取商品,并建立erp商品对应关系

erp商品对应关系页面

4.3 如果erp开启了库存同步,erp商品库存变化且绑定了商城商品时,调用商城同步商品库存接口

4.4 商城订单支付或者发货后调用erp自有商城订单同步接口

4.5 商城用户申请售后或者售后单发生变化时调用erp自有商城售后单同步接口

4.6 erp同步的订单发货时调用商城线上销售单发货通知接口

4.7 erp同步的售后单同意退款时调用商城售后单商家同意退款接口

erp线上售后单页面

4.8 erp同步的售后单同意退货时调用商城售后单商家同意退货接口

4.9 erp同步的售后单退货或者换货入库成功调用商城退货通知店铺入库成功接口

4.10 erp同步的换货售后单下单并且发货时调用商城售后单商家换货发货接口