阿里云LinkedMall企业购业务分销商入驻与对接开发,包含多个步骤。通过阅读本文档,分销商将对接流程具备一定的了解;并可参考本文介绍,逐步进行对接与开发工作,完成业务上线。
预备材料
分销商在入驻和对接开发前,可提前预备下表中所述材料,以提高入驻和开发效率。
前置条件 | 数量 | 说明 |
企业支付宝账号 | ≥1个 | 企业支付宝账号用于分销商店铺支付货款(付款账号)和收取技术服务费(收款账号),请注意以下约束条件: 1、天猫旗舰店收款支付宝账号不可用于分销店铺付款账号; 2、分销商付款类型如为实时支付类型,分销商应保证付款账号中余额充沛,以免扣款失败; 3、收款账号和付款账号可以为同一支付宝账号(满足条件1前提下)。 支付宝企业账号注册与实名认证,请参考支付宝官方文档。 |
阿里云企业账号 | 1个 | 需完成企业实名认证,用于分销商企业入驻。阿里云账号注册与企业实名认证,请参考账号注册(PC端)。 |
阿里云RAM用户 | 1个 | 用于API对接开发。RAM用户创建,请参考创建RAM用户;关于LinkedMall企业商城RAM权限授权信息的更多内容,请参考授权信息。 |
身份账号及访问密钥(AccessKey) | / | 在使用API前,需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。详情参考创建AccessKey。 |
对接流程
商务对接
商务洽谈
介于LinkedMall企业购的特殊性,分销商在入驻前,应先联系阿里云运营小二协助推进分销商、渠道供应商以及阿里云等三方商务洽谈。在洽谈结束并达成合作意向后,分销商将会与渠道供应商签署线下合作协议。
创建沟通群
阿里云运营小二将为分销商创建专属技术沟通钉钉群,用于支持分销商对接与开发工作。
分销商企业入驻与店铺开通
企业入驻
请参考分销商企业入驻指引。
店铺开通
请参考分销店铺开通指引。
完成后,可获取分销商ID和分销商店铺ID。
支付方式为实时付款类型的分销商,应保证使用的付款支付宝账号余额充足,以免在对接过程中因余额不足引发支付失败问题。
API调试(可选)
分销商开发者登录阿里云OpenAPI 门户,调用LinkedMall企业购API并查看请求和返回结果,OpenAPI 门户会自动生成相应的API调用示例,帮助开发者熟悉和使用API。
企业商城LinkedMall API版本:建议选择最新版本(目前为2023-09-30);
服务地址:服务接入点地址选择华北3(张家口),接入点信息可参考服务接入点说明;
SDK版本:建议选择最新版本(目前为V2.0);
API列表:可点击选择需要调试的API接口,API详情可参考API目录或点击文档按钮查看;
参数配置:接口参数,详情可参考API目录或点击文档按钮查看。
开发环境安装
安装JDK
安装1.8或以上版本JDK。具体操作,请参见安装JDK。
安装Maven
安装2.5或以上版本Maven。具体操作,请参见安装Maven。
下载SDK
分销商开发者可通过下载SDK直接调用本产品OpenAPI。
消息接入配置
分销商开发者可通过kafka订阅商品、订单的消息,并消费消息进行业务处理。建议分销商在业务对接开发前,完成消息接入相关配置。
获取接入信息
目前,需要分销商在完成企业入驻并开通分销店铺后,提交入驻企业名称、分销商ID等信息至阿里云小二(钉钉号:qhmt5v8)后由阿里云技术支持进行配置。
配置成功后,分销商将获取下列信息:
接入点信息;
Topic;
Group;
用户名、密码等信息。
详情请参考接入信息获取说明。
接入方式配置
获取接入信息后,分销商开发者可进行下列配置:
安装依赖库;
创建与配置kafka.properties文件。
配置详情请参考接入方式。
开发与联调测试
上述各项工作完成后,分销商即可投入对接开发。开发者可通过API参考和消息目录直达帮助文档。
开发阶段
正、逆向交易状态机可参考接入指南-第二阶段:接入开发相关说明。
联调测试
请联系阿里云运营小二协调渠道供应商小二协助修改正、逆向订单状态,以完成订单联调测试。
售后退款退货逻辑:
联系渠道供应商运营小二,在专属技术沟通钉钉群中沟通,测试操作退款退货;
除特殊类目及场景,未发货申请天猫立即自动退款。
上线发布
上线前,联系渠道供应商运营小二,完成商品库更新与商品上架。
建议支付方式为实时付款类型的分销商,上线前再次确认付款支付宝账号余额是否充足,以免影响消费者下单。
其他事项
关于发货时效
发货时效以分销商与渠道供应商沟通达成的协议为准,通常时效规则如下:
普通商品:一般是买家付款后24小时内上传物流单号,买家付款后48小时内发货 ;
定制、预售及其他特殊情形等另行约定发货时间的商品:约定时间内发货。
关于对账与开票
实时付款支付方式分销商,根据分销店铺开通指引开通分销店铺时设置的对账周期按时完成对账,同时联系渠道供应商完成开票。
关于技术支持
在开发阶段或上线后,分销商可通过专属技术沟通钉钉群服务助手获得自助服务。
如服务助手无法解决问题,可通过提交工单方式获取人工技术支持。