阿里云LinkedMall企业购业务分销商入驻与对接开发，包含多个步骤。通过阅读本文档，分销商将对接流程具备一定的了解；并可参考本文介绍，逐步进行对接与开发工作，完成业务上线。
本文档适合分销商负责LinkedMall入驻的商务、运营、开发、测试等同学阅读。
预备材料
分销商在入驻和对接开发前，可提前预备下表中所述材料，以提高入驻和开发效率。
前置条件 | 数量 | 说明 |
企业支付宝账号 | 1个 | 企业支付宝账号用于分销商店铺支付货款（付款账号），请注意以下约束条件： 1、天猫旗舰店收款支付宝账号不可用于分销店铺付款账号； 2、分销商付款类型如为实时支付类型，分销商应保证付款账号中余额充足，以免扣款失败； 支付宝企业账号注册与实名认证，请参考支付宝官方文档。 |
阿里云企业账号 | 1个 | 需完成企业实名认证，用于分销商企业入驻。阿里云账号注册与企业实名认证，请参考账号注册（PC端）。 |
阿里云账号RAM用户 | 1个 | |
身份账号及访问密钥（AccessKey） | 1对 | 在使用API前，需要准备好身份账号及访问密钥（AccessKey），才能有效通过客户端工具（SDK、CLI等）访问API。详情参考创建AccessKey。 说明 请注意AccessKey ID和AccessKey Secret需在生成时保存在本地，控制台无法二次查看AccessKey Secret。 |
对接流程
Step1：商务对接
商务洽谈
介于LinkedMall企业购的特殊性，分销商在入驻前，应先联系阿里云运营小二协助推进分销商、渠道供应商以及阿里云等三方商务洽谈。
创建服务群
阿里云运营小二将为分销商创建专属技术服务钉钉群，用于支持分销商对接与开发工作。
Step2：分销商企业入驻与店铺开通
企业入驻
请参考分销商企业入驻指引。
店铺开通
请参考分销店铺开通指引。
请注意，店铺开通后，需要完成选择渠道业务并完成线上合同签订。合同签订完成后渠道运营小二将会为分销商导入商品。
完成后，可获取分销商ID和分销商店铺ID。
支付方式为实时付款类型的分销商，应保证使用的付款支付宝账号余额充足，以免在对接过程中因余额不足引发支付失败问题。
Step3：API调试（可选）
使用阿里云OpenAPI门户应先完成LinkedMall企业入驻和分销店铺开通。
分销商开发者登录阿里云OpenAPI 门户，调用LinkedMall企业购API并查看请求和返回结果，OpenAPI 门户会自动生成相应的API调用示例，帮助开发者熟悉和使用API。
企业商城LinkedMall API版本：建议选择最新版本（目前为2023-09-30）；
服务地址：服务接入点地址选择华北3（张家口），接入点信息可参考服务接入点说明；
SDK版本：建议选择最新版本（目前为V2.0）；
API列表：可点击选择需要调试的API接口，API详情可参考API目录或点击文档按钮查看；
参数配置：接口参数，详情可参考API目录或点击文档按钮查看。
Step4：开发环境安装
下文以Java语言为例。
安装JDK
安装1.8或以上版本JDK。具体操作，请参见安装JDK。
安装Maven
安装2.5或以上版本Maven。具体操作，请参见安装Maven。
下载SDK
分销商开发者可通过下载SDK直接调用本产品OpenAPI。
Step5：消息接入配置
分销商开发者可通过kafka订阅商品、订单的消息，并消费消息进行业务处理。建议分销商在业务对接开发前，完成消息接入相关配置。
获取接入信息
分销商在完成分销企业和店铺开通后，可进入LinkedMall开放平台查看基本信息获取Kafka消息接入信息。
接入方式配置
获取接入信息后，分销商开发者可进行下列配置：
安装依赖库；
创建与配置kafka.properties文件。
配置详情请参考接入方式。
Step6：开发与联调测试
上述各项工作完成后，分销商即可投入对接开发。开发者可通过API参考和消息目录直达帮助文档，并可通过阅读LinkedMall API V2.0 最佳实践中的文档帮助理解API接口在业务场景中的应用方法（订单相关接口的最佳实践即将上线）。
开发阶段
接入指南
分销商技术同学可阅读接入指南获取更多如正/逆向交易状态机（参考接入指南-第二阶段：接入开发相关说明）、拆单逻辑、售后情景介绍、错误信息获取方法等说明。
请注意接入指南文档可能对于理解LinkedMall系统的正逆向交易有较高重要性，建议技术同学仔细阅读。
联调测试
对于接入阿里体育系（如橙狮体育、上海乐动力、杭州乐动力等渠道业务）的分销商伙伴，渠道商提供了可供测试的商品并可协助完成商品编辑、订单发货、售后处理等项目，帮助分销商技术同学完成技术联调。
如何获取测试商品
在技术服务钉钉群中@服务小钉唤起。
请注意，测试订单同样会正常结算并进入订单，请技术同学在完成测试后及时完成售后退款。
上线发布
上线前，请确认支付宝代扣账号余额充足，以免扣款失败。
LinkedMall再不支持二次扣款，对于扣款失败的订单会在创单30分钟后自动关闭。
其他事项
关于发货时效
发货时效以分销商与渠道供应商沟通达成的协议为准，通常时效规则如下：
普通商品：一般是买家付款后24小时内上传物流单号,买家付款后48小时内发货 ；
定制、预售及其他特殊情形等另行约定发货时间的商品：约定时间内发货。
关于对账与开票
实时付款支付方式分销商，根据分销店铺开通指引开通分销店铺时设置的对账周期按时完成对账，同时联系渠道供应商完成开票。
关于技术支持
1、在开发阶段或上线后，分销商可通过专属技术沟通钉钉群服务助手获得自助服务。
2、如服务助手无法解决问题，可通过提交工单方式获取人工技术支持。
工单中应尽量描述清楚问题现象，并提供如订单ID、商品ID、RequestID等有效的能帮助技术支持同学快速定位问题的信息。
