# 获取快递公司列表

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:getdeliverycompanylistnew

可通过该接口获取快递公司列表

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/order/deliverycompanylist/new/get?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用。

# 第三方调用

# 2. 请求参数

# 查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用)

# 请求体 Request Payload

参数名类型必填示例说明
ewaybill_onlybooleanfalse是否仅返回支持电子面单功能的快递公司

# 3. 返回参数

# 返回体 Response Payload

参数名类型示例说明
errcodenumber0错误码
errmsgstringok错误信息
company_listobjarray快递公司列表

# Res.company_list(Array) Object Payload

快递公司列表

参数名类型示例说明枚举
delivery_idstringSF快递公司ID枚举值
delivery_namestring顺丰速运快递公司名称-

# 4. 枚举信息

# Res.company_list(Array).delivery_id Enum

快递公司ID

delivery_id快递公司名称类型
ZTO中通加盟
YTO圆通加盟
YUNDA韵达加盟
JTSD极兔加盟
STO申通加盟
SF顺丰自营
JD京东自营
EMS中国邮政自营
CNSD菜鸟速递(丹鸟)自营
DBKD德邦快递自营
SXJD顺心捷达加盟
ZTOKY中通快运加盟
YDKY韵达快运加盟
ANEKY安能物流加盟
BTWL百世快运加盟
KYSY跨越速运直营
YMDD壹米滴答加盟
RJTCSD锐界同城速递直营
ZJS宅急送直营
JSD吉时达加盟
XFEX信丰物流加盟
JGSD京广速递加盟

# 5. 注意事项

自营性快递公司陆续会接入

# 6. 代码示例

请求示例

{
   "ewaybill_only": false
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "company_list": [
        {
            "delivery_id": "SF",
            "delivery_name": "顺丰速运"
        },
        {
            "delivery_id": "YTO",
            "delivery_name": "圆通快速"
        },
        {
            "delivery_id": "ZTO",
            "delivery_name": "中通快速"
        }
    ]
}

# 7. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述解决方案
42001access_token expired重新拉取access_token
43002require POST method需要用POST方式拉取
44002empty post data传递的参数为空
47001post data format error参数格式错误

# 8. 适用范围

本接口在不同账号类型下的可调用情况:
微信小店小店供货商
  • ✔:该账号可调用此接口。
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口。