自在服务开放平台使用手册

bohe

1．服务商账号
1.1 注册流程

注册自在服务开放平台账号 → 填写服务商资料，提交审核 → 审核通过 → 服务商注册成功。

1.2 修改服务商资料

前往服务商中心可以修改资料：修改个人信息或者提现信息，需要重新审核，审核通过后才能修改成功；修改联系人信息，不需要重新审核，点击修改即可修改成功。

2. 我的服务
2.1 创建服务

服务商注册成功后才能创建服务，一个账号最多只能创建5个服务。

2.1.1 创建流程

进入【我的服务】 → 点击【创建新服务】 → 填写服务基本信息 → 提交审核 → 审核通过 →审核通过，创建成功。

点击创建新服务

填写服务基础信息

服务审批中

审批通过

2.1.2 服务基本信息

服务范围：可选择多个社区，在服务范围中的社区才可以使用该服务。

有硬件需要入驻到社区内：是指类似小蜜蜂邮包包的服务，需要“投递箱”等硬件资源入驻社区。

社区用户覆盖范围：选择范围中的用户才能在自在社区app中使用服务。可只选择社区认证用户，也可选择全部用户。社区认证用户为该社区的住户，全部用户包括认证用户以及社区周边关注了该社区的用户。

需要的社区资源：自在服务开放平台为服务商提供了丰富的社区资源——社区内摆摊宣传；公共进出区域的张贴广告、易拉宝、x展架、LED屏等；社区内拉横幅；社区会所：会议室、棋牌室、运动场等资源。如果对以上资源或其他资源有需求的，可以填写该项告诉我们。

2.1.3服务接入方式

服务的接入方式有2种选择：技术开发和使用服务模板。

1.技术开发方式适合有开发能力的商家，需要自行开发服务、申请接口等，通过丰富的API可以自行实现更加灵活丰富的功能；

2.使用服务模板适合没有开发能力的商家，无需技术开发，直接对服务使用模板，即可马上创建一个线上商店。

2.1.4 修改基本信息

服务上架前后都可以修改服务的基本信息，修改后需要重新提交审核，审核过程中不会影响服务的使用，审核通过后信息才更改成功。

2.2接入模式——技术开发

若接入模式选择的是“技术开发”，创建服务后该服务会出现7个tag，保证金及平台服务费，图标素材，文档中心，服务链接，支付接入，应用调试以及上架管理。

2.2.1 ServiceID/Key

填上并保存服务链接后，才可以获得service ID和service key，在服务的基本信息tab可以查看，使用方法请查看开发文档。

2.2.2 图标素材

包括服务图标和服务截图。 服务截图将在服务介绍中展示。

2.2.3 服务链接

开发完成后，开发者需要填写该服务对应H5页面的链接，供平台审核测试使用。

2.2.4 应用调试

开发者开发完服务后，在【应用调试】中按照调试方法的指示，进行程序的调试。

调试方法：
1、下载自在社区APP：
2、注册成为自在社区会员；
3、将自在社区的注册帐号添加到调试帐号，最多可以添加5个调试帐号。
4、使用自在社区APP扫描调试页面的二维码，进入服务页面进行调试。

2.2.5 支付接入

若服务需要使用平台的支付功能时，需要进行以下操作：

1、  在服务的“支付接入”中申请支付接入，填写收款项目介绍、回调地址，点击“申请开通”。等待支付接入申请成功后，获得PAYACCONUT ID，并根据开发文档配置到服务中。

2、  服务申请上架时，接口权限中勾选“社区支付服务”，提交上架申请。接口权限审批通过后，服务即可调用自在社区APP的支付接口。

如果已上架的服务需要申请支付接入，整个服务重新提交审批，审批中旧服务正常运行。审批通过后，服务商可收到一个PAYACCONUT ID，使用方法请查看开发文档。

2.3接入模式——使用服务模板

若接入模式选择的是“使用服务模板”，创建完服务后，在我的服务中会出现4个tag，保证金及平台服务费，图标素材，服务模板以及上架管理。

2.3.1 图标素材

包括服务图标和服务截图，服务截图将在服务介绍中展示。

2.3.2 服务模板

可以在此挑选服务模板，以及进入该模板的管理后台。

点击挑选模板，进入服务模板页面，在该页面可以预览模板效果，并且选择某个服务应用模板。

点击进入按钮，可以跳到该服务的模板编辑管理后台，开始编辑店铺资料。

2.3.3 管理后台编辑

2.3.3.1管理后台入口

有2个入口，分别是:

1.服务管理-我的服务-服务模板-点击进入按钮，可以直接进入该服务的后台

2.服务管理-服务模板-进入管理后台（页面右上角），选择某个服务进入后台

2.3.3.2店铺资料

包括运费、店铺联系方式、首页banner图片等的设置，以及服务的调试预览功能。

若修改运费、联系方式、首页banner图，修改后需要点击保存，才能修改成功。

2.3.3.3门店信息

此功能板块只适用于周边商家模板，使用微商城模板的服务在app端将不会展示此板块内容。

此页面用来编辑门店地址、营业时间、以及门店照片等门店信息，修改时需要点击保存才能修改成功。

2.3.3.4优惠宣传

此功能板块只适用于周边商家模板，使用微商城模板的服务在app端将不会展示此板块内容。

1.     在此页面商家可以添加、管理优惠券。可用来吸引顾客前往线下门店消费，顾客出示处于有效期内的优惠券时，商家应予以对应的优惠。

2.     商家可以通过创建时间、优惠券标题、优惠券编号、优惠券状态等内容来筛选优惠券。

2.3.3.5商品管理

此功能板块只适用于微商城模板，使用周边商家模板的服务在APP端无法看到商品。

1.在此页面，可以管理查看所有已添加的商品，通过商品编号、商品名称、商品创建时间来搜索商品记录，也可以编辑、上下架、或者删除商品。

2.当商品在出售中时，支持编辑商品，不会影响商品的出售，编辑后商品信息随之更新。

3.用户下单后将订单中相关商品下架或者删除不会影响用户的订单，仍旧可以对该订单进行发货等操作。

2.3.3.6添加商品

此功能板块只适用于微商城模板，使用周边商家模板的服务在APP端无法看到商品。

1.可以直接点击左侧导航的“添加商品”tab或者商品管理页的“添加商品”按钮，创建新商品；

2.在此页面，填写完所有的资料，包括商品图、标题、编号、价格、详情等，点击创建即可创建成功。

2.3.3.7订单管理

在此页面，可以查看所有交易订单，通过下单时间、买家姓名、手机、订单编号等搜索订单记录，并对订单进行发货操作。

2.3.3.8切换模板后台

点击页面右上角的切换模板后台按钮，可以切换到其他接入模式为“使用服务模板”的服务管理后台。

2.4上架服务
2.4.1 上架说明

服务开发完成后，在【上架管理】中点击提交审批，审批通过后即可自动上架或手动上架。上架后，可以在自在社区APP的社区（服务范围中的社区）服务列表中看到该服务。

提交审批之前，若选择技术开发模式，必须保证图标素材、服务链接、应用调试账号等资料全部填写。若选择使用服务模板模式，必须保证在管理后台编辑完模板内容，包括应用调试账号等资料。

2.4.2 社区支付接口

接入模式为技术开发的服务，在服务申请支付接入后，还不能在自在社区中收款，还需要申请调用支付窗口的接口。

1、  服务未上架：上架时在接口权限中勾选“社区支付服务”，并提交审批；

2、  服务已上架：在上架管理->上架审批->接口权限中，找到“社区支付服务”，点击右侧的申请按钮，等待平台申请通过即可。申请服务接口不会影响已上架的服务正常运行。

注意：申请社区支付接口成功，也会成功开通取消订单接口、退款状态回查接口。通过这两个接口，服务商可以开发取消订单的功能，也可以回查订单的退款状态等。

2.4.3 上架方式

有2种服务上架方式，立即上架和手动上架。选择后，请注意点击“保存”！

立即上架，即在平台审核通过之后，立即自动上架到服务池。

手动上架，是指在平台审核通过之后，由服务商自己在合适的时间手动点击上架。

2.5上架状态

1.成功上架之后，可以看到该服务的上架状态，包括社区添加情况和用户评价等。

2.在社区添加情况中，可以查看每个社区对应的服务二维码。用户使用自在社区APP扫描此二维码，会自动关注对应的社区并进入本服务。

2.6 申请社区添加服务

服务上架后，服务范围中的每个社区会默认选用该服务，故社区的添加状态都会默认为已添加。但是当服务上架后，若服务商修改了服务基本信息中的服务范围，例如增加了某一个社区，此时该社区不会默认选用此服务，服务商可以向该社区申请选用服务。在社区处理完申请后，服务商将收到处理结果通知。如果一直没有收到结果通知，可使用“提醒对方”功能，每5天可提醒一次。若超过15天，仍旧没有收到结果通知，服务商将收到该社区的商务人员联系方式，可通过商务人员来联系社区。

2.7 下架服务

服务商在【上架管理】中，可以执行服务下架操作。提交下架申请时，需要填写下架原因。申请后的30天内，服务商需要处理完该服务的相关订单，逐步暂停客户下单功能。平台也会在30天内进行审核，发出审核结果。

2.8 删除服务

删除服务前必须下架服务，并且提现完该服务对应的资金。服务删除后，除了资金流水，其他基本信息都会被删除。若该服务缴纳过保证金，在服务成功删除后，平台将会退还保证金到服务商中心中填写的银行账号中。

2.9 迭代服务

若服务商选择了技术开发的服务接入模式，需要自行维护、更新服务的代码。若服务更新会影响到用户的使用，请提前通知用户，避免影响用户正常使用。

服务上架后，“应用调试”板块看到的内容将与上架后的服务保持一致，若服务商需要在自在社区环境中调试新版本，可以进行以下操作：

1、  在我的服务中，创建新服务。（若已创建5个服务，请联系平台）

2、  填写服务相关信息，在服务分类中选择“仅限应用调试”。

3、  点击创建服务，等待服务审核通过。

4、  服务审核通过后不需要缴纳保证金，服务商可以在此新的服务中测试、调试其他服务。

5、  “仅限应用调试”的服务不允许上架，也不能申请开通相应的接口。

3. 费用说明
3.1 保证金
3.1.1 保证金说明

缴纳保证金是为了保障平台及用户的利益。终止平台服务时，保证金将会退回。一个服务对应一份保证金，若要上架多个服务，平台将在新服务提交上架审批后增加应缴保证金数额。

3.1.2 缴纳保证金

服务商提交服务的基本资料后，若审核通过，可以在“保证金及平台服务费”tab看到应交的保证金金额。

缴纳保证金，可以通过线上或者线下2种方式提交。选择线上支付，支付成功后，状态会自动更新为已提交。选择线下支付，则转账到平台提供的银行账号，转账成功后，需要上传转账回执，等待平台审核转账结果，审核通过后，保证金状态将更新为已提交。

保证金确认缴纳后，服务商会收到一封保证金收据邮件。

3.1.3 退还保证金

保证金在删除服务后才能退还，平台将会把保证金自动退到服务商中心中填写的银行账号中。

3.2 平台服务费

用户使用服务并支付成功时，将产生平台服务费，该费用由自在服务开放平台收取。提现时将扣除平台服务费。

4. 资金流水

服务商可以在资金流水模块查看所有服务的订单详情，包括订单号，订单创建时间，订单来源服务，订单来源社区，订单金额，平台服务费，商家实收金额，退款金额，支付状态，退款状态，以及提现状态等。

5. 资金提现
5.1 提现规则

提现是按照服务以及月份来提取。服务商在每个月的16号可以对上个月的订单发起提现申请。例如2月16号后，可对A服务1月份的所有订单申请提现，而2月16号之前不能对1月份的订单进行提现。

5.2 发票申请

服务商申请的每一笔提现都可以在【资金提现】的列表中看到，并且可以对已提现成功的单号申请发票。可通过点击发票申请状态中的【申请】按钮来实现。个人类型的服务商只能申请开增值税普通发票，公司类型的服务商可选择开增值税普通发票或者增值税专用发票。申请提交后，平台相关人员会线下联系服务商反馈发票邮寄信息。

5.3 提现单导出

提现单列表中的每一个提现单，都可以导出详细信息。可通过操作中的【查看详情】，详情页面中列出了提现单中包含的所有订单条目，页面有导出下载功能。提现在审批中状态时，可以撤销提现。