{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh-Hans/v2/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"更新日志","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"更新日志","__idx":0},"children":["更新日志"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["本文件记录了该项目的所有重要变更。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["更新日志格式遵循 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://keepachangelog.com/en/1.0.0/"},"children":["Keep a Changelog"]},"，"," ","版本号管理遵循 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://semver.org/spec/v2.0.0.html"},"children":["语义化版本规范（Semantic Versioning）"]},"。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["版本：2.1.0"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1213---2026-07-21","__idx":1},"children":["[1.2.13] - 2026-07-21"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added","__idx":2},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/scan_form/create_scan_form"]},"：新增接口，为一组已购买的 USPS 运单创建 USPS SCAN Form（PS Form 5630），并在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scan_form_image"]}," 中返回 SCAN Form PDF 的 URL。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1212---2026-07-14","__idx":3},"children":["[1.2.12] - 2026-07-14"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-1","__idx":4},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/submit_pod"]},"：新增接口，为 USPS 运单提交 Proof of Delivery 请求，并将 POD 信件发送给 1–3 位收件人。返回 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_message"]},"，如 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Your Proof of Delivery record is complete and will be processed shortly."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/shipment/direct/tracking_by_tracking_no"]},"：响应新增字段 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipient_name"]},"，为签收人姓名（如 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Alice"]},"）。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1211---2026-07-02","__idx":5},"children":["[1.2.11] - 2026-07-02"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"changed","__idx":6},"children":["Changed"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["运单请求 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["options.signature"]},"：新增两个枚举值 —— ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_signature_restricted"]},"（限制投递的签名确认）和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_adult_signature_restricted"]},"（限制投递的成人签名，需 21 岁及以上）。原有值 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signature"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adult_signature"]}," 保持不变。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1210---2026-06-23","__idx":7},"children":["[1.2.10] - 2026-06-23"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-2","__idx":8},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/shipment/direct/tracking_by_tracking_no"]},"：响应新增字段 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status_summary"]},"，为物流状态的可读摘要（如 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Your item has been delivered and is available at a PO Box at 9:34 am on June 22, 2026 in GRANITEVILLE, SC 29829."]},"）。该字段可空，无摘要时返回 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/create_and_pay"]},"：响应新增两个字段 —— ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_data"]},"，为每个面单 PNG 的 base64 内容，与 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_urls"]}," 一一对应（如 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iVBORw0KGgoAAAANSUhEUgAA...AElFTkSuQmCC"]},"）；",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_qr_code_data"]},"，为每个二维码面单 PNG 的 base64 内容，与 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qrcode_urls"]}," 一一对应。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_qr_code_data"]}," 仅在 USPS 二维码面单场景下返回。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/direct_buy"]},"：响应同样新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_data"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_qr_code_data"]}," 两个字段。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"129---2026-05-19","__idx":9},"children":["[1.2.9] - 2026-05-19"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-3","__idx":10},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增西班牙语文档支持，用户可在西班牙语下浏览 ShipSaving API 文档。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"128---2026-05-13","__idx":11},"children":["[1.2.8] - 2026-05-13"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"updated","__idx":12},"children":["Updated"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/pickup/add"]}," 接口中的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup_location"]}," 参数补充了字段级说明（长度限制、格式规则及必填要求），并为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_location_ext"]}," 字段新增最大长度限制（255 字符）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/pickup/add"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/pickup/cancel"]}," 接口新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," 响应示例。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在附录中新增「",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["预约取件错误码（Pickup Error Codes）"]},"」章节，列出 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/pickup/add"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/pickup/cancel"]}," 接口可能返回的全部错误码。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"127---2026-04-09","__idx":13},"children":["[1.2.7] - 2026-04-09"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-4","__idx":14},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在「集成指南」章节新增可下载的 Postman 合集（ZIP），包含 API 合集及环境文件（Sandbox 和 Production），方便快速测试。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"126---2026-04-02","__idx":15},"children":["[1.2.6] - 2026-04-02"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-5","__idx":16},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增文档页面 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["错误与限流（Errors & Rate Limits）"]},"，涵盖错误响应格式、HTTP 状态码、错误码命名规则、限流机制及错误处理建议。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在附录（Appendix）中新增 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["错误码参考表"]},"。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"125---2026-02-03","__idx":17},"children":["[1.2.5] - 2026-02-03"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-6","__idx":18},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["在以下接口的响应中新增了 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_to_sender"]}," 字段："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/shipment/tracking_by_platform_uk_id"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["该字段为布尔类型，用于表示运单是否已被退回给发件人。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["在以下接口中新增对 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["USPS Returns"]}," 服务类型的支持："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/direct_buy"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["当前支持的 USPS Returns 服务级别包括："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USPS_GROUND_ADVANTAGE_RETURN"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USPS_PRIORITY_MAIL_RETURN"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USPS_PRIORITY_MAIL_EXPRESS_RETURN"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["具体的服务级别枚举定义请参考附录（Appendix）。"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"124---2026-01-23","__idx":19},"children":["[1.2.4] - 2026-01-23"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-7","__idx":20},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["在以下接口的请求体中新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_address_data"]}," 对象："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/direct_buy"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/get_rates"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["该字段 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["仅支持 USPS"]},"，用于指定当包裹无法投递或被退回给发件人时的退回地址。"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"123---2026-01-13","__idx":21},"children":["[1.2.3] - 2026-01-13"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"changed-1","__idx":22},"children":["Changed"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["为新 API（v2）新增了版本专属的 Appendix，用于说明仅适用于 v2 的枚举定义和参考表。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["已弃用顶层 Appendix 页面，并保留其作为向后兼容的入口，引导用户访问新 API（v2）的 Appendix。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"122---2026-01-03","__idx":23},"children":["[1.2.2] - 2026-01-03"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-8","__idx":24},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增中英文双语文档支持，支持在 ShipSaving API 文档中进行语言切换。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"121---2025-12-24","__idx":25},"children":["[1.2.1] - 2025-12-24"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-9","__idx":26},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增物流追踪接口 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/shipment/direct/tracking_by_tracking_no"]},"，该接口返回包含UTC偏移量的ISO 8601格式物流事件时间戳，支持在不同时区环境下准确解析和还原事件发生的本地时间。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"120---2025-12-16","__idx":27},"children":["[1.2.0] - 2025-12-16"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fixed","__idx":28},"children":["Fixed"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["修正字段拼写错误：API 中字段 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additional_handing"]}]}," 更名为 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additional_handling"]}]},"。受影响的接口包括：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/batch/quick_rate"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/direct_buy"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/get_rates"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-10","__idx":29},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_package_code"]}," 枚举中新增 UPS Canada 预定义包裹编码。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增布尔参数 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["require_saturday_delivery"]},"，用于指示在承运商和服务等级支持的情况下是否优先选择周六投递。",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"当该参数设置为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," 时，可能会产生承运商附加费或更高的运费报价。受影响的接口包括：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/batch/quick_rate"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/direct_buy"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/get_rates"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"updated-1","__idx":30},"children":["Updated"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["以下接口新增对 UPS Canada 运费查询及运单面单购买的支持：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/batch/quick_rate"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/get_rates"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/direct_buy"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"113---2025-12-10","__idx":31},"children":["[1.1.3] - 2025-12-10"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update","__idx":32},"children":["Update"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["更新承运商列表，新增对 SwiftX Express 承运商及其服务等级的支持。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["更新 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/batch/quick_rate"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/get_rates"]},"：",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"客户端可通过在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_rate_carrier_data"]}," 中指定 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provider_id=\"SWIFTX\""]}," 且 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_levels=\"SWIFTX_EXP\""]}," 来获取 SwiftX Express 的运费报价。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["更新 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/direct_buy"]},"：",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"现已支持使用 SwiftX Express 购买运单面单。提交请求时需设置 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_code=\"SWIFTX\""]}," 且 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_level=\"SWIFTX_EXP\""]},"。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"112---2025-12-04","__idx":33},"children":["[1.1.2] - 2025-12-04"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-1","__idx":34},"children":["Update"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["更新 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/batch/quick_rate"]},"：",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"新增可选参数 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_rate_carrier_data"]},"，允许客户端按指定承运商和服务等级获取运费报价，而非默认的 USPS Ground Advantage。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["更新 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/direct_buy"]},"：",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_code"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_level"]}," 字段，这两个字段共同决定用于购买面单的承运商服务等级。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"111---2025-11-24","__idx":35},"children":["[1.1.1] - 2025-11-24"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-2","__idx":36},"children":["Update"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["增强 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/tracking_by_tracking_no"]},"：",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["estimate_delivery_date"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["original_tracking_location"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_tracking_location"]}," 字段，以提供更清晰的预计送达时间及更完整的承运商上报的始发地和目的地信息。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"110---2025-11-21","__idx":37},"children":["[1.1.0] - 2025-11-21"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-11","__idx":38},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增 USPS 承运商取件 API 套件，支持商户预约、取消及查询 USPS 取件请求：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/pickup/add"]}," —— 创建 USPS 取件请求"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/shipment/pickup/cancel"]}," —— 取消已有取件请求"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/shipment/pickup/list"]}," —— 获取取件记录分页列表"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/shipment/pickup/package/location/list"]}," —— 获取可用的 USPS 包裹放置位置枚举值"]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"108---2025-11-19","__idx":39},"children":["[1.0.8] - 2025-11-19"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-3","__idx":40},"children":["Update"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["扩展 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/tracking_by_tracking_no"]},"：",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"新增对 Amazon Shipping 物流追踪的支持，包括状态查询及事件历史。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"107---2025-11-11","__idx":41},"children":["[1.0.7] - 2025-11-11"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-12","__idx":42},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/tracking_by_tracking_no"]},"：",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"支持通过 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tracking_no"]}," 查询 USPS 和 UPS 的物流信息，返回当前物流状态、最新扫描信息及完整的物流事件历史。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"changed-2","__idx":43},"children":["Changed"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["更新 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/direct_buy"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/create_and_pay"]},"：",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"当购买 USPS 服务且设置 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"label_print_type\": \"qrcode\""]}," 时，接口将同时返回标准面单和二维码面单。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"106---2025-10-30","__idx":44},"children":["[1.0.6] - 2025-10-30"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-13","__idx":45},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/direct_buy"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/get_rates"]}," 接口中引入 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_return_label"]}," 参数，",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"用于指定面单是否为退货运单，默认值为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},"。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"105---2025-09-23","__idx":46},"children":["[1.0.5] - 2025-09-23"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-14","__idx":47},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/tracking"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/tracking_by_platform_uk_id"]}," 接口响应中新增字段 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tracking_events"]},"（数组），",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"用于表示完整的运单物流追踪时间线（所有追踪事件）。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"104---2025-09-23","__idx":48},"children":["[1.0.4] - 2025-09-23"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-15","__idx":49},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/tracking"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/tracking_by_platform_uk_id"]}," 接口响应中的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.status"]}," 字段补充详细说明，",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"并引入带描述的枚举状态值：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["available_for_pickup"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_transit"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["out_for_delivery"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivered"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_to_sender"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["voided"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["seized_by_law_enforcement"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unknown"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"103---2025-08-29","__idx":50},"children":["[1.0.3] - 2025-08-29"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-16","__idx":51},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/batch/quick_rate"]}," 接口，支持批量运单运费查询（每次请求最多10条）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/direct_buy"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/create_and_pay"]}," 中新增重复创建校验机制。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"102---2025-08-27","__idx":52},"children":["[1.0.2] - 2025-08-27"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-17","__idx":53},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在物流追踪接口中新增响应字段 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scanned_time"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/address/validate"]}," 接口，用于校验美国地址、返回标准化地址组件，并提供错误及修正信息。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"101---2025-08-25","__idx":54},"children":["[1.0.1] - 2025-08-25"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-18","__idx":55},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/tracking_by_platform_uk_id"]}," 接口，支持通过 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform_uk_id"]}," 查询运单物流状态。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-19","__idx":56},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/void_label"]}," 接口新增对 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform_uk_id"]}," 的支持，用于作废运单面单。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"100---2025-08-13","__idx":57},"children":["[1.0.0] - 2025-08-13"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-20","__idx":58},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ShipSaving 新版 API 初始发布，支持运费查询、面单购买、面单作废以及运单物流追踪等核心功能。"]}]}]},"headings":[{"value":"更新日志","id":"更新日志","depth":1},{"value":"[1.2.13] - 2026-07-21","id":"1213---2026-07-21","depth":2},{"value":"Added","id":"added","depth":3},{"value":"[1.2.12] - 2026-07-14","id":"1212---2026-07-14","depth":2},{"value":"Added","id":"added-1","depth":3},{"value":"[1.2.11] - 2026-07-02","id":"1211---2026-07-02","depth":2},{"value":"Changed","id":"changed","depth":3},{"value":"[1.2.10] - 2026-06-23","id":"1210---2026-06-23","depth":2},{"value":"Added","id":"added-2","depth":3},{"value":"[1.2.9] - 2026-05-19","id":"129---2026-05-19","depth":2},{"value":"Added","id":"added-3","depth":3},{"value":"[1.2.8] - 2026-05-13","id":"128---2026-05-13","depth":2},{"value":"Updated","id":"updated","depth":3},{"value":"[1.2.7] - 2026-04-09","id":"127---2026-04-09","depth":2},{"value":"Added","id":"added-4","depth":3},{"value":"[1.2.6] - 2026-04-02","id":"126---2026-04-02","depth":2},{"value":"Added","id":"added-5","depth":3},{"value":"[1.2.5] - 2026-02-03","id":"125---2026-02-03","depth":2},{"value":"Added","id":"added-6","depth":3},{"value":"[1.2.4] - 2026-01-23","id":"124---2026-01-23","depth":2},{"value":"Added","id":"added-7","depth":3},{"value":"[1.2.3] - 2026-01-13","id":"123---2026-01-13","depth":2},{"value":"Changed","id":"changed-1","depth":3},{"value":"[1.2.2] - 2026-01-03","id":"122---2026-01-03","depth":2},{"value":"Added","id":"added-8","depth":3},{"value":"[1.2.1] - 2025-12-24","id":"121---2025-12-24","depth":2},{"value":"Added","id":"added-9","depth":3},{"value":"[1.2.0] - 2025-12-16","id":"120---2025-12-16","depth":2},{"value":"Fixed","id":"fixed","depth":3},{"value":"Added","id":"added-10","depth":3},{"value":"Updated","id":"updated-1","depth":3},{"value":"[1.1.3] - 2025-12-10","id":"113---2025-12-10","depth":2},{"value":"Update","id":"update","depth":3},{"value":"[1.1.2] - 2025-12-04","id":"112---2025-12-04","depth":2},{"value":"Update","id":"update-1","depth":3},{"value":"[1.1.1] - 2025-11-24","id":"111---2025-11-24","depth":2},{"value":"Update","id":"update-2","depth":3},{"value":"[1.1.0] - 2025-11-21","id":"110---2025-11-21","depth":2},{"value":"Added","id":"added-11","depth":3},{"value":"[1.0.8] - 2025-11-19","id":"108---2025-11-19","depth":2},{"value":"Update","id":"update-3","depth":3},{"value":"[1.0.7] - 2025-11-11","id":"107---2025-11-11","depth":2},{"value":"Added","id":"added-12","depth":3},{"value":"Changed","id":"changed-2","depth":3},{"value":"[1.0.6] - 2025-10-30","id":"106---2025-10-30","depth":2},{"value":"Added","id":"added-13","depth":3},{"value":"[1.0.5] - 2025-09-23","id":"105---2025-09-23","depth":2},{"value":"Added","id":"added-14","depth":3},{"value":"[1.0.4] - 2025-09-23","id":"104---2025-09-23","depth":2},{"value":"Added","id":"added-15","depth":3},{"value":"[1.0.3] - 2025-08-29","id":"103---2025-08-29","depth":2},{"value":"Added","id":"added-16","depth":3},{"value":"[1.0.2] - 2025-08-27","id":"102---2025-08-27","depth":2},{"value":"Added","id":"added-17","depth":3},{"value":"[1.0.1] - 2025-08-25","id":"101---2025-08-25","depth":2},{"value":"Added","id":"added-18","depth":3},{"value":"Added","id":"added-19","depth":3},{"value":"[1.0.0] - 2025-08-13","id":"100---2025-08-13","depth":2},{"value":"Added","id":"added-20","depth":3}],"frontmatter":{"seo":{"title":"更新日志"}},"lastModified":"2026-07-16T18:45:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh-hans/v2/changelog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}