小程序上传功能说明

本文档用于说明小程序上传功能的相关配置，包括上传密钥获取、IP 白名单设置、合法域名设置、隐私协议更新、订单中心页面路径配置，以及常见问题处理方法。

---

1. 获取上传密钥

进入微信小程序后台，配置小程序上传密钥。

操作路径：

微信小程序后台 → 开发管理 → 小程序上传目录

在该页面中设置上传密钥。

IP 白名单设置

IP 白名单可按以下方式处理：

• 关闭 IP 白名单；
• 或添加以下 IP 到白名单：

47.93.211.100

---

2. 合法域名设置

合法域名需要在鲸飞 PMS 总后台中进行设置。

操作路径：

鲸飞 PMS 总后台 → 客户管理 → 酒店列表 → 其他设置 ��� 版权设置

2.1 继承系统设置

选择「继承系统设置」时，酒店将使用系统安装时的初始域名。

该域名编辑功能即将开放。

2.2 独立设置

选择「独立设置」时，该酒店将使用单独配置的独立域名。

使用独立域名前，请确保：

1. 域名已正确解析到系统服务器；
2. 域名已绑定到系统站点；
3. 域名可以正常访问系统；
4. 域名已配置 HTTPS SSL 证书。

---

3. 更新隐私协议

进入系统设置页面，更新小程序隐私协议。

操作路径：

设置 → 隐私协议更新

---

4. 配置订单中心页面路径

进入系统设置页面，配置订单中心页面路径。

操作路径：

设置 → 订单中心页面路径

请填写以下路径：

packageA/hotelBill/hotelBill

---

5. 常见问题

5.1 预览时页面空白

可能原因

小程序预览时页面空白，通常与合法域名配置或缓存有关。

解决方案

请按以下方式排查：

1. 确认微信小程序后台是否已配置合法域名；
2. 确认合法域名是否填写正确；
3. 确认域名是否可以正常访问系统；
4. 如果合法域名已配置但仍无法预览，可能是缓存原因；
5. 可在小程序中打开调试模式，忽略合法域名验证后再进行预览测试。

---

操作流程总结

1. 登录微��小程序后台；
2. 进入「开发管理 → 小程序上传目录」；
3. 设置小程序上传密钥；
4. 关闭 IP 白名单，或添加 47.93.211.100；
5. 登录鲸飞 PMS 总后台；
6. 进入「客户管理 → 酒店列表 → 其他设置 → 版权设置」；
7. 配置合法域名；
8. 根据需要选择继承系统设置或独立设置；
9. 进入「设置 → 隐私协议更新」；
10. 更新小程序隐私协议；
11. 进入「设置 → 订单中心页面路径」；
12. 填写 packageA/hotelBill/hotelBill；
13. 预览小程序并检查页面是否正常。

---

注意事项

• 上传密钥需要在微信小程序后台获取并配置；
• IP 白名单可关闭，或添加指定 IP：47.93.211.100；
• 合法域名配置错误可能导致小程序无法正常预览；
• 独立域名必须能正常访问系统；
• 独立域名建议配置 HTTPS SSL 证书；
• 订单中心页面路径请严格填写为：packageA/hotelBill/hotelBill；
• 如预览页面空白，可尝试开启小程序调试模式。