地址验证与纠正

地址验证与纠正

无效的地址会导致投递失败、退货和额外费用。atoship 的地址验证功能可以帮你在发货前发现问题。

为什么地址验证很重要

地址错误带来的成本：

• 退货运费（每件包裹 $5-15）
• 重新发货的费用
• 货物丢失
• 客户不满
• 承运商附加费

常见的地址问题：

• 街道名称拼写错误
• 邮编（ZIP code）填错
• 缺少公寓/门牌号
• 地址已过期
• 地址根本不存在

验证是如何工作的

USPS 地址匹配： atoship 会比对官方的 USPS 地址数据库进行验证：

1. 解析地址各个组成部分
2. 标准化格式
3. 与数据库进行匹配
4. 返回验证状态
5. 给出纠正建议

验证结果：

使用地址验证

验证单个地址：

1. 在发货表单中填写地址
2. 点击 "Validate Address"（验证地址）
3. 查看系统给出的建议
4. 接受或修改

批量验证：

1. 导入订单
2. 点击 "Validate All"（全部验证）
3. 查看被标记的地址
4. 批量处理纠正结果

理解纠正内容

自动纠正：

• 邮编补全（5 位 → 9 位）
• 街道后缀标准化（Street → ST）
• 方位缩写（North → N）
• 州名缩写
• 城市名称拼写

示例：

Input:  123 Main Street North, Anytown, California 90210
Output: 123 N MAIN ST, ANYTOWN, CA 90210-1234

住宅地址 vs 商业地址

为什么这很重要：

• 适用的承运商费率不同
• 投递时效不同
• 可选的服务不同
• 部分承运商对住宅地址收取附加费

识别方式： atoship 会自动识别地址类型：

• 住宅：住家、公寓
• 商业：企业、办公室
• 混合用途：逐案判断

地址核验级别

第 1 级 - 基础：

• 格式验证
• 邮编是否存在
• 州与邮编是否对应
• 快速、免费

第 2 级 - USPS DPV：

• 投递点验证（Delivery Point Validation）
• 确认是否可投递
• 识别空置地址
• 更准确

第 3 级 - 完整：

• 完整核验
• 套房/单元号验证
• 地址类型识别
• 准确度最高

处理无法投递的地址

当地址无法通过验证时：

1. 检查是否有拼写错误

   • 常见混淆：O/0、I/1 等相似字符
   • 门牌号与邮编填反

2. 向客户核实

   • 发送确认邮件
   • 提供建议的纠正内容
   • 请客户补充地标/备注

3. 使用承运商工具

   • USPS 邮编查询
   • UPS 地址验证
   • Google Maps 核验

地址簿功能

保存已验证的地址：

• 为回头客保存地址
• 免去重复验证
• 输入时自动补全
• 有纠正时同步更新

管理地址簿：

Dashboard → Address Book → Add/Edit

国际地址验证

难点：

• 各国格式不同
• 邮政编码体系多样
• 存在本地语言差异
• 数据标准化程度较低

最佳实践：

• 始终填写国家代码
• 使用英文转写
• 单独核对邮政编码
• 填写电话号码

常见的验证错误

"Address Not Found"（未找到地址）：

• 新建建筑
• 乡村路线（rural routes）
• 填错的 PO Box（邮政信箱）
• 街道近期有变更

"Multiple Matches"（多个匹配）：

• 地址含义不明确
• 缺少单元号
• 街道名称重复
• 需要更具体的信息

最佳实践

发货前：

1. 对新地址务必进行验证
2. 核对所有 "partial"（部分匹配）结果
3. 用纠正后的内容更新客户资料
4. 保存已验证的地址

与客户沟通：

• 索要完整地址
• 请客户提供公寓/单元号
• 确认街道名称拼写
• 核实邮编

地址验证 API

面向接入 atoship 的开发者：

POST /api/v1/addresses/validate
{
  "address": {
    "line1": "123 Main St",
    "city": "Anytown",
    "state": "CA",
    "zip": "90210"
  }
}

返回结果包含：

• 验证状态
• 纠正后的地址
• 置信度分数
• 地址类型（住宅/商业）