API DocsCreate Ticket

批量创建运输标签

借助 atoship 强大的批处理工具,规模化你的发货作业。

概览

批量创建标签让你可以:

  • 每批处理最多 1,000 个订单
  • 从 CSV 或已连接的平台导入
  • 应用统一的发货规则
  • 一键生成所有标签
  • 导出以便批量打印

方式一:CSV 导入

第 1 步:下载模板

  1. 进入 Orders(订单)> Import(导入)
  2. 点击 Download CSV Template(下载 CSV 模板)
  3. 选择模板类型:
    • Basic(基础):仅地址 + 重量
    • Full(完整):包含选项在内的所有字段

第 2 步:准备数据

必填列:

示例说明
recipient_nameJohn Smith收件人全名
address_line1123 Main St街道地址
cityNew York城市名称
stateNY2 位州代码
zip100015 位或 9 位邮编
countryUS2 位 ISO 国家代码
weight_oz16重量(盎司)

可选列:

示例说明
address_line2Apt 4B单元/套房
phone555-123-4567用于派送
email[email protected]物流跟踪通知
length10英寸
width8英寸
height6英寸
order_idORD-12345你的订单参考号
carrierUSPS首选承运商
servicepriority服务代码
declared_value50.00用于保险

第 3 步:上传并映射

  1. 点击 Upload CSV(上传 CSV)
  2. 选择文件(最大 10MB,5000 行)
  3. 将各列映射到 atoship 字段
  4. 预览前 10 行
  5. 点击 Validate(校验)

第 4 步:查看校验结果

输出示例:

  • 487 个订单有效
  • 12 个订单需要处理
  • 1 个订单失败

常见问题:

  • 邮编无效:5 个订单
  • 缺少重量:3 个订单
  • 找不到地址:4 个订单

在界面中修正问题,或重新上传修正后的 CSV。

第 5 步:获取运费

  1. 点击 Get Rates for All(获取全部运费)
  2. 等待比价(500 个订单约需 30–60 秒)
  3. 查看运费汇总:
    • 预计总费用
    • 承运商分布
    • 服务等级明细

第 6 步:购买标签

  1. 查看最终汇总
  2. 确认钱包余额足以支付总额
  3. 点击 Purchase All Labels(购买全部标签)
  4. 进度条会显示完成情况

方式二:选择订单

从订单页面操作

  1. 进入 Orders(订单)> All Orders(全部订单)
  2. 筛选出需要标签的订单:
    • 状态:Awaiting Shipment(待发货)
    • 日期范围
    • 平台来源
  3. 勾选订单(复选框)
  4. 点击 Actions(操作)> Create Labels(创建标签)

批量设置

将设置应用到所有选中的订单:

  • Carrier(承运商):全部相同,或各取最优运费
  • Service(服务):指定服务,或自动比价
  • Package(包裹):默认,或按单设置
  • Insurance(保险):全部添加,或跳过

方式三:平台自动导入

已连接的平台

连接 Shopify、eBay 等平台后:

  1. 订单会自动导入
  2. 进入 Orders(订单)> Ready to Ship(可发货)
  3. 选择订单并批量处理
  4. 跟踪号会回传到平台

自动化规则

设置规则,实现无人值守发货:

规则:"Auto-ship standard orders"(自动发货标准订单)

  • 触发条件:导入新订单
  • 前提条件:订单金额 < $100、国内运输、无定制商品
  • 执行动作:选择最便宜的 USPS 服务、创建标签、发送跟踪邮件、标记为已发货

方式四:API 集成

批量接口

POST /api/v1/labels/batch Authorization: Bearer YOUR_API_KEY Content-Type: application/json

请求体包含订单数组,每个订单含 to_address、from_address 及 parcel 详情。

响应

返回 batch_id、status、total_orders 以及 estimated_completion(预计完成时间)。

批量打印

合并 PDF

  1. 批处理完成后,点击 Download All Labels(下载全部标签)
  2. 选择格式:
    • 单个 PDF(所有标签)
    • 独立 PDF(每个标签一份)
    • ZPL 文件(热敏打印机)
  3. 打印设置:
    • 4x6 标签:选择 "Actual Size"(实际尺寸)
    • Letter 纸:选择 "2 per page"(每页 2 个)

热敏打印机批量打印

适用于 Zebra、ROLLO、Dymo 打印机:

  1. 下载 ZPL 文件
  2. 直接发送到打印机
  3. 标签按顺序依次打印

打印队列集成

连接打印机以实现自动打印:

  1. 进入 Settings(设置)> Printers(打印机)
  2. 添加网络打印机
  3. 启用 "Auto-print new labels"(自动打印新标签)
  4. 标签会在创建时自动打印

错误处理

部分成功

如果部分标签生成失败:

  • 成功的标签会被保存
  • 失败的订单仍留在队列中
  • 可下载错误报告

常见批量错误

错误原因解决方法
Address validation(地址校验)地址无效检查并修正
Insufficient funds(余额不足)钱包余额偏低充值后重试
Carrier unavailable(承运商不可用)该服务不可用更换承运商/服务
Weight exceeds limit(超重)包裹过重改用货运或拆分
Rate not found(找不到运费)承运商无法派送尝试其他承运商

重试失败的订单

  1. 进入 Orders(订单)> Failed Labels(失败标签)
  2. 逐个修正问题,或批量编辑
  3. 点击 Retry Selected(重试选中项)

最佳实践

批处理之前

  1. 校验地址 —— 先运行地址校验
  2. 核对库存 —— 确认所有商品有货
  3. 核实重量 —— 抽样称重包裹
  4. 小批量测试 —— 先试跑 10 个订单

优化性能

  1. 错峰处理 —— 在低流量时段批处理
  2. 合理的批量大小 —— 500 个订单最为理想
  3. 稳定的网络连接 —— 确保网络良好
  4. 充足的余额 —— 预存预计费用的 110%

批处理之后

  1. 核验所有标签 —— 抽查几份
  2. 生成交运清单(manifest) —— 用于承运商揽收
  3. 更新库存 —— 同步库存水平
  4. 通知客户 —— 发送跟踪邮件

各套餐限额

套餐每批订单数每日批次数
Starter505
Professional500无限
Enterprise1,000无限
Custom5,000+无限

需要帮助?

  • CSV 问题:下载我们的官方校验模板
  • 在线客服:通过聊天获取批处理帮助
  • 邮箱[email protected]
  • 优先支持:面向 Enterprise 客户

Was this article helpful?