API 字典用于外部系统对接易抵达开放接口时,理解常见请求字段、业务字段和返回字段。不同客户、不同接口版本可能会有差异,最终字段以接口文档和实际联调报文为准。
| 字段类别 | 常见字段 | 说明 |
|---|---|---|
| 鉴权信息 | appKey / token / sign / timestamp | 用于识别调用方和校验请求合法性。 |
| 单号信息 | systemNo / customerNo / trackingNo / transferNo | 分别对应系统单号、客户单号、转单号或其它跟踪单号。 |
| 客户信息 | customerCode / customerName | 用于确认运单归属客户,需与易抵达客户档案一致。 |
| 渠道信息 | channelCode / channelName / warehouseCode | 用于指定发货渠道、仓库或业务线路。 |
| 收件人信息 | country / province / city / zip / address / name / phone | 用于下单和派送,国家、邮编、地址是常见校验重点。 |
| 包裹信息 | weight / length / width / height / pieces | 用于计费、查价、打单和仓库操作。 |
| 申报信息 | declareName / hsCode / quantity / unitPrice / currency | 用于清关、发票、面单和承运商申报。 |
| 状态信息 | status / trackStatus / eventTime / description | 用于查单、轨迹查询和回传状态同步。 |
| 文件信息 | labelUrl / invoiceUrl / podUrl / fileType | 用于下载面单、发票、POD 或其它附件。 |