下游分销商
- 签名失败
需要确认参数是否有进行排序，有没有空参数，前后有没有并上SECRET，SHA1加密是否正确，SHA1是否有大写。
- 调用登录接口密码错误
确认密码是否正确，密码是否有MD5加密
- 访问超时
确认参数timestamp是否正确
- APPKEY为空
除了登录接口，其他接口accountId、appkey、memberId、timestamp、token、topSign为必传字段
- 关于ID类字段
目前系统内的ID类字段都是32位字符型
- 关于贸易方式
目前系统用的贸易方式有：保税 1101，一般贸易2202，海外直邮1303，海外自提1404
- 关于价格
实际供货价是要结合收货地区、购买的规格、效期以及购买的数量才能最终确定的
3.3接口获取到的originalPrice 是商品原价 3.3 里的 price 是该商品所有规格效期中 折合单价最低的（包含活动价格）
3.6接口 是获取多规格的信息 用在列表鼠标以上商品上时展示 获取到的price 是每个规格最低价格
3.5 是获取动态价格的接口 当有些字段不传 返回是个价格区间 即 maxprice、minprice
当固定了 收货地区 购买的规格 效期 以购买的数量 3.5接口返回的价格maxprice、minprice 是相同的即为下单商品价格
- 关于地区库
海带现在的使用的地区信息是邮政部门发布的最新数据库
海带最新地区信息可以通过json格式获取
- 动态价格、获取运费与创建订单的地区编码有何不同
动态价格、获取运费接口的地区编码传市级编码，如 浙江省-杭州市-西湖区，只需要传杭州市的区域编码
创建订单接口的区域编码需要传区县级编码如 浙江省-杭州市-西湖区，需要传西湖区的区域编码
- 关于分类
海带支持无限级分类，目前系统用到两级
- 关于订单超时
保税订单2小时 其他订单12小时
- 保税商品对接
保税对接 需要到海带获取支付二维码 然后展示给客户 让客户支付到海带 不然海关通不过
- 关于请求
无特殊说明post和get都可以
- 购物车中有客户自营产品也有海带的保税产品如何批量支付
海带的保税商品不支持批量下单，自营商品是需要支付到客户平台，保税商品是需要通过二维码支付到海带的
- 效期指的是生成日期还是有效日期
一般贸易返回的是生产日期，保税、直邮返回的是 有效期
- 多少天内不完善身份信息会走售后流程处理?
48小时
- 直邮商品在未完善信息能否进行余额付款的操作？
可以
- “code”: “106”
需要重新登录，对比下返回的 token，本地缓存半个月有效期
- 商品供货价是否包括了税费？
含税
- 运费是否在订单推送成功后返回给分销商？
商品运费可以通过运费接口获取，订单结算价包含运费的
- 关于跳价问题
有两种方式
一、固定收益，用户打开你们的商品详情时 直接调用海带接口 获得价格 加一个加价 展示给用户
二、固定售价，提前将海带的价格获取过来 加一个加价比保存下来展示给用户，下单时校验是否负毛利因为海带的供货价是浮动的，如果选择固定收益的话，价格理论上是会出现跳价的
如果选择固定售价，只要预防负毛利就可以 - 自动确认收货时间
保税15，一般贸易15，直邮45
- 一键最低价
是根据单规格均价最低
param.put(“nums”, “1,2,3”);规格的购买数量
param.put(“productNums”, “1,2,3”);规格数量组数限制的是 nums
总数限制的是 nums * productNums
上游供应商
- 如何区分贸易方式
接口文档需要开放贸易方式这个字段
- 同一套系统多个店铺（用户）怎么实现？
海带为每个注册账号分配不同的appkey和secret。
- 订单里的商品商家货号可以修改吗？
订单已经生成了，如要修改我们需要打审批技术修改，不能随便人工修改
如果已经推到客户系统，建议客户自行修改
带这边的商品货号如果要调整，可以在海带云仓供货记录里修改下，之后的新进来的订单都是新的商品货号。但是像这单已经生成订单的货号还是老的，订单要改我们目前不支持手动修改
- 后台的库存对接有些问题 能不能更新一下库存？
库存现在只能登录海带云仓手动修改，供货的时候手动填写的，包括供货价这些资料，现在供货没有系统对接，靠手动
- 自动获取订单是不是要设置成单独的一个仓库？
一家供应商可以有多个仓库，每个仓库只要提供接收订单的路径，都可以自动推单
- 关于手机号注册账号问题
1）新主体的，可以全新注册一个新账号。
2）已有主体账号，需要换手机号的话，出具一份声明书，我们客服这边以修改掉。
- 合作平台订单系统异常需重推订单
需要合作方标记下退单，退单后我们再回退到正常单重新推送
总结
- 1、海带每隔15分钟自动推送订单至指定地址，非供应商自己拉取订单数据。
- 2、如推送失败，系统将标记成“异常订单”，此时不会计算供应商的处罚时效（延迟发货、延迟出物流信息）。
- 3、异常订单一般问题解决后，可以取消异常转变成正常单，走正常的推单/接单流程，客服也可能因为客户原因直接进行退款。
- 4、订单中 price指结算金额，主要用于非保税订单。
- 5、保税:
a 强制拆单，一个订单只有1个商品。
b 保税需要使用buyAmount作为支付金额，折算商品售价单价：商品单价=(buyAmount-tax税费-税前运费)/商品总数，并且保留小数点2位向前进一（不要四舍五入），差价放入“优惠”字段，保障商品单价*数量+运费+税费-优惠=实付款buyAmount。
c 保税允许的支付方式及支付公司在不同海关的备案号、电商平台备案号均在每个订单中返回信息，建议不要固定写死
- 6、SDK对接有key accountId memberId 不需要调用登录接口
- 7、重推订单，可以先观察下订单状态：
1）异常订单，直接取消异常——点击推送（不点击系统15分钟定时任务推送）
2）正常订单（海关审核中）——标记异常（内容随便填）——取消异常——点击推送 - 3）正常订单（已付款）——点击推送
贸易类型新系统将进行扩展，以支持更多应用场景，由4位数组成：
第1位表示类别：跨境 1/一般贸易 2 （不可变更）
第2位表示贸易方式：保税 1/ 一般贸易 2/直邮 3/海外自提 4 （不可变更）
第3、4位表示贸易类型名称：保税仓直供 01/ 一般贸易 02/海外直邮 03/海外自提 04/ 香港直邮 05/ 国内发货 06（可任意改名或按规则增加）
示例
- 1101 跨境（类别） 保税（贸易方式） 保税仓直供（贸易类型名）
- 2202 一般贸易（类别） 一般贸易（贸易方式） 一般贸易（贸易类型名）
- 1303 跨境（类别） 直邮（贸易方式） 海外直邮（贸易类型名）
- 1404 跨境（类别） 保税（贸易方式） 税仓直供（贸易类型名）
- 1305 跨境（类别） 直邮（贸易方式） 香港直邮（贸易类型名）
- 2206 一般贸易（类别） 一般贸易（贸易方式） 国内发货（贸易类型名）
- 保税 1101
- 一般贸易2202
- 海外直邮1303
- 海外自提1404
关于合作平台订单错误，退款流程：
- 1）供应商端：合作平台订单错误，海带客服这边会安排退款（在群里告诉合作平台，合作平台数据有问题，我们客服会去退款的）
- 2）推单群里发给客服，让他们安排退款，可以把订单标记异常（原因是:报关失败;异常说明:SaaS订单余额支付，无法支付报关，退款。）
- 3）推单群里@方正，让他看下这个SaaS客户能不保税商品不要同步过去
SaaS客户，同步了海带的保税商品售卖，没有用支付宝和微信支付，所以无法正常支付报关的，只能退款
‘’如有供应商要问memberId，可以从商家详情页的地址这边找，userId memberId=accountId=商家详情的userId
原因：非保税的商品上架到保税仓，只有保税需要该字段
解决办法：需要客服取消异常，然后让供应商手动接单，保税仓改为手动，供应商接单完毕后再改为自动
memberId=accountId=商家情的userId
对方系统已经有这一单了
1）跟供应商沟通，要不他系统删掉，我们重推。
2）如果供应商安排发货的，那我们取消异常，点击“手动推单”注：
对于供应商这边，下单客户不能给
利润（服务费）也最好不给出去
- 如何区分贸易方式