API开放平台 | Eyf - 半字节科技 - 物流快递系统接口文档

订单接口

订单接口提供完整的订单生命周期管理，支持创建、修改、取消订单操作，可与您的ERP/WMS系统无缝对接。

1. 创建订单

POST https://api.eyfbyte.com/v1/orders/create

参数名	类型	必填	说明
order_no	string	是	外部订单号
sender_name	string	是	寄件人姓名
sender_phone	string	是	寄件人电话
receiver_name	string	是	收件人姓名
receiver_address	string	是	收件人详细地址
weight	decimal	是	重量(kg)
service_type	string	否	服务类型：标准/加急/冷链

{

  "code": 0,

  "message": "success",

  "data": {

    "tracking_no": "EYF202503210001",

    "order_status": "created",

    "create_time": "2025-03-21 10:30:00"

  }

}

2. 修改订单

PUT https://api.eyfbyte.com/v1/orders/{tracking_no}

支持修改收件人信息、重量、备注等，订单已揽收后不可修改。

3. 取消订单

DELETE https://api.eyfbyte.com/v1/orders/{tracking_no}

取消未揽收的订单，已揽收订单需联系客服处理。

快件跟踪接口

实时查询物流轨迹，支持单号查询、手机号查询，并提供轨迹同步能力。

1. 根据物流单号查询

GET https://api.eyfbyte.com/v1/tracking/{tracking_no}

{
  "code": 0,
  "data": {
    "tracking_no": "EYF202503210001",
    "status": "in_transit",
    "current_location": "广州分拨中心",
    "traces": [
      {"time": "2025-03-21 08:00:00", "location": "深圳", "status": "已揽收"},
      {"time": "2025-03-21 14:30:00", "location": "广州分拨中心", "status": "已到达"}
    ]
  }
}
                

2. 根据手机号查询

GET https://api.eyfbyte.com/v1/tracking/phone/{phone}

根据收件人或寄件人手机号查询关联的快件列表，支持分页。

3. 同步平台物流轨迹

POST https://api.eyfbyte.com/v1/tracking/sync

将第三方物流轨迹同步至Eyf系统，需提供原始轨迹数据。

海关提货单接口

跨境物流专用接口，支持海关提货单下载及清关资料上传。

1. 下载提货单

GET https://api.eyfbyte.com/v1/customs/delivery-order/{order_id}

返回提货单PDF文件流，用于海关提货。

2. 上传清关资料

POST https://api.eyfbyte.com/v1/customs/upload

参数名	类型	必填	说明
order_id	string	是	订单号
file_type	string	是	文件类型：invoice/packing_list/declaration
file_content	base64	是	文件Base64编码

财务结算接口

提供账单查询、费用明细、结算对账等功能，支持多维度财务核算。

1. 查询账单汇总

GET https://api.eyfbyte.com/v1/finance/bill/summary

按时间范围查询账单汇总，包括运费、代收货款、手续费等。

2. 获取费用明细

GET https://api.eyfbyte.com/v1/finance/bill/detail

查询单票费用明细，支持按单号、时间筛选。

3. 结算对账

POST https://api.eyfbyte.com/v1/finance/reconciliation

上传外部账单，系统自动比对差异并返回对账结果。

{
  "code": 0,
  "data": {
    "total_freight": 12500.00,
    "total_collect_fee": 3200.00,
    "total_handling_fee": 156.00,
    "reconciliation_result": "matched",
    "difference_list": []
  }
}
                

开放平台 API

订单接口

1. 创建订单

2. 修改订单

3. 取消订单

快件跟踪接口

1. 根据物流单号查询

2. 根据手机号查询

3. 同步平台物流轨迹

海关提货单接口

1. 下载提货单

2. 上传清关资料

财务结算接口

1. 查询账单汇总

2. 获取费用明细

3. 结算对账

API调用流程

立即接入Eyf开放平台

开放平台 API

订单接口

1. 创建订单

2. 修改订单

3. 取消订单

快件跟踪接口

1. 根据物流单号查询

2. 根据手机号查询

3. 同步平台物流轨迹

海关提货单接口

1. 下载提货单

2. 上传清关资料

财务结算接口

1. 查询账单汇总

2. 获取费用明细

3. 结算对账

API调用流程

立即接入Eyf开放平台

法律声明

Cookies政策

知识产权声明

隐私政策

用户协议