华为商城

更新日志:

序号 内容 时间 维护人 备注
1 创建文档 2022/1/10
2 企业版对接 2022/1/10 客户端V2.6.6.3版本及以上
3 对接订金订单 2022/3/14
4 修改客户网名的存储方式 2022/4/12
5 企业版支持按照收件人姓名和手机号搜索订单 2022/4/12 客户端版本2.6.8.5版本及以上
6 对接拼团订单 2022/4/18
7 对接众测订单 2022/4/25
8 华为仓发货订单标记在客服备注 2022/5/9
9 对接原始退款单 2022/7/27

一、对接进度一览

序号 模块 对接情况 备注
平台支持情况 企业版对接进度
1 授权 店铺授权
2 平台货品 货品匹配
增量下载 × ×
按货品名称下载 × ×
按货品ID下载 × ×
按时间段下载 × ×
3 订单获取 订单推送 × ×
订单抓取—按原始单号
订单抓取-按时间段
标旗/备注回传 × ×
发票信息抓取 × ×
身份证 × ×
4 发货同步 整单发货
sku拆单发货 × ×
sku+数量拆单发货 × ×
5 售后单 售后单抓取
自动退款 × ×
6 库存 库存同步 × ×
7 换货 平台换货 × ×

二、ERP对接场景

1、仅抓取订单类型为:普通订单、订金订单(2022/3/14之后支持)、拼团订单(2022/4/18之后支持)、众测订单(2022/4/25之后)

2、暂不支持在ERP中拆单发货

3、请使用委外仓发货的商家务必注意:

由于华为商城平台为密文订单。使用委外仓发货的商家,请确认使用的委外仓支持后再使用该委外仓发货。委外仓参考对接方案如下:

  • 销售订单推送仍通过taobao.qimen.deliveryorder.create( 发货单创建接口 ),对于华为商城的订单,sourcePlatformCode平台来源编码字段推送“HWSC”
  • 所有华为商城订单,WMS需先调用qimen.taobao.receiverinfo.query( OAID 收件人信息解密接口 )获取解密后的收件人明文信息,再获取面单进行发货*

4、如果存在华为平台仓发货订单,会在ERP中客服备注中添加“华为仓订单”的说明,商家可以按照备注过滤、筛选出在平台发货无需在ERP系统内发货的订单。避免重复发货

三、ERP授权操作

企业版:

1、店铺创建

操作路径:设置-基本设置-店铺

点击“添加”,店铺平台选择“华为商城”,子平台选择“默认”,填写好必要信息之后点击“保存”。

2、店铺授权

联系平台获取 VmallDeviceType、VmallDeviceAccount、 VmallDevicePassword、VmallDevicePriKey

选中新建的华为商城平台的店铺,点击“新窗口授权”,按照提示填写授权信息。

注意SessionKey一项填写时需要将 VmallDeviceType、VmallDeviceAccount以“&”进行拼接

2022/2/25之前使用上述授权方式,2022/2/25及之后请使用下述授权方式

2022/2/25之后的授权方式:

在平台侧获取授权信息:

在BOP页面(bop.vmall.com)>开放平台文档中心>控制台注册成为开发者,并创建应用,然后通过查询应用获取开发账号(AK/SK)。

1)进入开放平台:

2) 进入控制台:

3) 创建应用,获取AK(APP key)及SK(APP secret):

获取到AK(APP key)及SK(APP secret)之后,在ERP中新建店铺与上述1店铺创建一致。授权店铺时,选中新建的华为商城平台的店铺,点击“新窗口授权”,按照提示填写授权信息AK(APP key)及SK(APP secret)

旗舰版:

请参考旗舰版wiki

四、对接常见问题

1、生成订单已经超过10分钟,为什么ERP中还是没有抓到该订单?

原因:订单在平台后台进行流转,会导致订单的更新时间变化。ERP按照更新时间进行抓取,故如果在ERP未成功抓取时,平台的订单更新时间会晚于订单生成时间,导致ERP在订单生成的10分钟之后还是抓取不到。而在订单更新时间后的,5-10分钟之后才抓取到。

2、为啥换货的换出订单、定金订单抓不进来?

原因:首次对接仅对接了普通订单和赠品,其他类型的订单暂不支持。如有需要,可联系自家实施同学提需求。