设置

设置区域汇集了业务的运营配置——订单管理器的行为、结账选项、配送区域的测距方式、Webhook，以及（适用于德国商家的）法律声明 Impressum。在门店视图中，您在此更改的设置适用于您当前操作的门店。

在哪里找到设置#

• 视图：门店视图（部分卡片也会出现在公司视图中，作用于整个公司）
• 菜单：店铺与设置 → 设置
• 访问权限：设置需要管理员级别的权限。该菜单入口仅对管理员账户显示；普通员工用户看不到。

设置页面本身由一组卡片组成；点击卡片即可打开对应的子页面。您能看到哪些卡片取决于当前的视图：

这些页面上的开关设置在点击后立即保存，并显示“设置保存成功”确认。

订单管理器#

用于接收和处理订单的订单管理器应用的设置。开关分为三张卡片：

常规#

• 禁用订单时间调整——“禁止在订单管理器应用中调整订单时间。只会设置默认订单时间”。开启后，员工在接单时无法更改备餐/配送时间。

• 显示外包配送的客户地址——即使配送由外部配送服务商处理，也在订单上显示顾客地址。

打印机设置#

• 在收据上隐藏司机小费
• 在收据上隐藏小费

餐桌预订设置#

• 禁用餐桌预订——关闭此门店的餐桌预订。

结账#

只有一个开关：

• 启用访客结账——允许顾客无需注册账户即可下单。

配送区域（仅公司视图）#

此卡片在未选择具体门店时显示，因为它是针对整个公司配置的：

• 在 Google 地图上启用路线距离测量——“按路线而非直线测量距离”。开启后，配送距离（以及基于距离的配送费）将按驾车路线计算，而不是按直线距离计算。
• Google Cloud API 令牌——上述开关打开后显示。输入您的令牌并点击保存。正如屏幕上的帮助说明：“我们使用 Google Cloud API 按路线测量距离。请确保您的 Google Cloud 账户已启用 Route API 服务。”

Webhook#

Webhook 会在发生某些事件时——例如新订单或餐桌预订——自动向您指定的网址发送通知。在门店视图中，Webhook 属于当前门店；在公司视图中，则属于整个公司。

Webhook 列表#

列包括：事件、URL、状态（启用/不活跃）、已签名（锁形图标，表示“负载已签名”）、更新时间和操作（编辑/删除）。列表为空时，页面显示“此分店还没有 Webhook。添加一个即可开始接收事件。”

添加或编辑 Webhook#

1. 点击添加 Webhook（或现有行上的编辑按钮）。
2. 事件（必填）——选择要接收通知的事件：已创建订位预订、已更新订位预订、已创建客户、已创建客户订单、客户订单已接受、客户订单已可取货、客户订单配送中、客户订单已完成、客户订单已拒绝或客户订单已取消。
3. 负载 URL（必填）——接收通知的地址。必须是有效的绝对网址，最长 1024 个字符；使用 http:// 地址会触发警告“使用 http:// 不安全。强烈建议使用 https:// 端点。”
4. 签名密钥（可选，最多 255 个字符）——“用于以 HMAC-SHA256 对负载签名，以便您验证其来自我们。”编辑已有密钥的 Webhook 时，该字段会保持锁定，直到您点击轮换密钥；保存一个新的空值会清除现有密钥，表单会在此之前提醒您。
5. 启用——打开或关闭此 Webhook 的推送。
6. 点击保存。会显示“已创建 Webhook”或“已更新 Webhook”。

删除 Webhook#

点击删除操作并确认“删除此 Webhook？”——“事件将不再推送到 [该 URL]。此操作无法撤销。”

推送机制#

页面上的一个可展开面板向您的开发人员说明技术约定：每个事件以 HTTP POST 方式发送，带有 JSON 封装和识别标头（包括 X-Webhook-Event、X-Webhook-Delivery-Id，以及设置了密钥时的 X-Webhook-Signature）。您的接收端应返回 HTTP 200；推送失败时会按递增的间隔重试最多 6 次（0 秒、15 秒、60 秒、120 秒、240 秒、600 秒）。推送保证至少送达一次，因此应使用 X-Webhook-Delivery-Id 过滤重复事件。

Impressum（仅限德国门店）#

“德国法律要求每个商业网站都显示 Impressum（法律声明）。以下信息将针对此门店发布。”此卡片仅在门店视图中对位于德国的公司显示，法律声明按门店分别保存。表单分为若干部分；字符串长度有限制，过长的值会显示“最多…个字符”：

提供方#

• 公司法定名称（必填，最多 500）——包括法律形式，例如“Oase Bistro GmbH”
• 商用名称（最多 200）、法律形式（最多 100）
• 授权代表（最多 500）——GmbH 等法人实体依法必须填写

注册地址#

• 街道和门牌号（必填，最多 250）——不允许使用邮政信箱
• 地址第二行（最多 250）、邮政编码（必填，最多 10）、城市（必填，最多 200）、国家（最多 200）

联系方式#

• 电子邮件（必填，必须为有效地址，最多 200）、电话（最多 100）、传真（最多 100）

注册与增值税#

“如果公司已注册（例如 GmbH）或拥有增值税号，则为必填。”字段：登记法院（最多 200）、登记号（最多 100）、增值税号（最多 50）、监管机构（最多 500，包括其地址；从事许可类经营活动时必填）。

内容负责人#

编辑内容的负责人（§ 18 Abs. 2 MStV）：名称（最多 200）和地址（最多 500）。

消费者纠纷解决#

• 参与消费者争议解决——一个开关，说明提供方是否参与消费者仲裁委员会的程序（§ 36 VSBG）

• 争议解决声明——如参与，请注明主管仲裁委员会
• 附加信息——用于填写其他法定声明的自由文本

点击保存发布（“Impressum 已创建”/“Impressum 已更新”）。可以用删除 Impressum 按钮删除现有的 Impressum；确认提示会警告“此门店的法律声明将被删除。此操作无法撤销。”

故障排除#

• 菜单中看不到设置。设置仅限管理员账户使用；请联系管理员为您进行更改。
• 配送区域卡片不见了。它只在公司视图中显示，选择了具体门店时不会显示。
• Impressum 卡片不见了。它只在门店视图中显示，且仅限位于德国的公司。
• Webhook 不再收到推送。检查它是否仍标记为启用，以及您的接收端是否返回 HTTP 200；请注意，连续 6 次尝试失败后，该次推送会被标记为失败。