购买面单
POST 购买
购买一个草稿面单。
钱包购买:金额将从您的 atoship 钱包中扣除。响应中的 rate = 您实际支付的金额。
BYOCA 购买:当草稿包含 carrier_account_id 时,货件将通过您自己的承运商凭证创建。响应中的 rate = 承运商报出的费率。您的 atoship 钱包不会被扣除货件费用——承运商会直接向您的承运商账户(或您通过 billing 指定的第三方)收费。
第三方计费(仅限 UPS):设置 billing.payer = "third_party",并提供第三方的 UPS 账户号码、国家/地区和邮政编码。UPS 将向该账户而非您的账户收费。这是 ERPNext/ERP 集成的标准模式,运费会回流到客户自己的 UPS 账户。
授权:提交第三方计费请求即表示您确认第三方已授权您向其 UPS 账户收费。atoship 会记录授权时间戳,以用于审计/争议处理。
参数
路径参数
id
string
必填
来自
POST /v1/labels 的面单 ID。必须处于 draft 状态。请求体参数(可选)
billing
object
在购买时覆盖或提供计费信息。与
payer:
accountNumber:recipient/third_party 时必填
countryCode:2 位 ISO 代码。third_party 时必填
postalCode:third_party 时必填
POST /v1/labels 上的 billing 结构相同。优先级高于草稿中保存的计费信息。payer:
shipper | recipient | third_partyaccountNumber:recipient/third_party 时必填
countryCode:2 位 ISO 代码。third_party 时必填
postalCode:third_party 时必填
返回
200
成功
401
需要身份验证
500
服务器内部错误
相关
Labels
POST/api/v1/labels/[id]/purchase