Carrier SDK 概览

推荐：新项目使用 ZymeupClient 统一 SDK，支持商户/物流商多角色切换，覆盖全部功能。

Carrier SDK（ZymeupCarrierSDK）面向物流商、承运商，提供 Headless 电子签收、地址簿、轨迹查询、单据上传、关务合规、运单管理等能力。

快速入口

• EPOD 电子签收 — 送达/失败上报、证据采集
• Address 地址簿 — 承运商地址簿 CRUD
• Tracking 轨迹追踪 — 运单轨迹查询
• Document 单据 — 标签/发票/装箱单上传
• Compliance 合规 — 海关申报、合规检查
• Shipment 运单管理 — 运单管理、标签、轨迹
• Activation 激活 — 承运商入驻与配置
• Age Verification — 年龄验证事件记录

ZymeupClient 统一 SDK

ZymeupClient 将 Merchant SDK 与 Carrier SDK 合并为单一入口，通过 role: 'carrier' 启用物流商模式：

import { ZymeupClient } from '@zymeup/sdk'

const sdk = new ZymeupClient({
  apiKey: 'carrier-api-key',
  baseUrl: 'https://api.zymeup.com',
  role: 'carrier',
  carrierCode: 'DHL'
})

// 物流商模块
const epod = await sdk.carrierEpod.list({ status: 'pending' })
const tracking = await sdk.tracking.list({ status: 'in_transit' })
const customs = await sdk.compliance.createCustoms({ shipment_id: 'ship-123', declarations: [] })