插件介绍

gd_saudi_short_address 是一款面向沙特阿拉伯发货场景的地址增强插件。

当顾客的收货国家为沙特阿拉伯时，插件会自动要求填写 Saudi National Address Short Code（短地址码），并在整个订单流程中保存和展示该信息，帮助商家满足当地发货要求，减少因地址信息不完整导致的发货失败、物流异常和人工沟通成本。

本插件专门针对沙特地址规则设计，不依赖固定国家 ID。系统会优先通过国家代码 SA 自动识别沙特阿拉伯；如果国家代码不存在，则会自动通过国家名称 Saudi Arabia 进行兜底匹配。即使后台国家数据被删除、重建或重新导入，插件仍然具备更好的兼容性和稳定性。

在顾客结账时，只要国家为沙特阿拉伯，插件就会自动显示短地址输入框。在保存地址和提交订单时，插件会通过后端逻辑进行校验，确保关键字段不会遗漏。短地址信息还会被写入订单快照中，因此前台订单详情页、下单成功页以及后台订单详情页都可以查看到对应的短地址信息，方便运营、客服和仓储团队协同处理订单。

核心功能

• 自动识别沙特阿拉伯国家，不依赖固定国家 ID
• 顾客选择沙特阿拉伯时自动显示短地址输入框
• 支持将短地址保存到会员地址簿
• 支持游客结账场景
• 保存地址时通过后端校验短地址
• 提交订单时再次进行后端校验
• 在订单中分别保存配送短地址和账单短地址
• 前台订单详情页显示短地址
• 下单成功页显示短地址
• 后台订单详情页显示短地址
• 支持自定义字段标签

截图：

适用场景

• 面向沙特阿拉伯市场的独立站
• 需要对接沙特本地物流或国际快递发货的站点
• 必须采集 Saudi National Address Short Code 的商家
• 希望减少客服人工补充地址信息的跨境卖家

工作机制

当系统识别到顾客填写的国家为沙特阿拉伯时，插件会自动启用短地址规则。

如果顾客保存的是会员地址，短地址会随地址一起保存；如果顾客使用游客结账，短地址会在结账流程中直接参与校验并写入订单。订单创建完成后，短地址信息也会同步写入订单快照，避免后续修改地址时影响历史订单数据。

插件优势

• 贴合沙特阿拉伯真实发货需求
• 自动识别目标国家，减少后台配置成本
• 不依赖容易变化的国家 ID，稳定性更高
• 地址与订单双链路保存，数据更完整
• 前后台订单信息同步展示，便于发货和售后处理
• 采用后端校验，确保关键地址数据可靠

兼容说明

本插件适用于 BeikeShop 地址与订单流程扩展场景。

如果站点国家数据中存在代码为 SA 的国家，插件会直接自动识别；如果国家代码缺失，则会通过名称 Saudi Arabia 进行兜底匹配。建议商家保持国家数据完整、规范，以获得最佳使用效果。

一句话卖点

自动为沙特订单补齐短地址规则，让地址采集、订单校验和前后台展示一次到位。