官方微信
微信服务号二维码
扫码加盟
加盟入网申请
扫码下单
顺心捷达+小程序
在线客服

顺心捷达-全网零担快运服务供 应商

4000 300 688

全国统一服务热线

开放接口文档

  • 基本协议
  • API文档
  • SDK
  • 面单打印模板

1 基本协议

  1. 1.1 访问协议

    http(post) Accept=Content-Type: application/x-www-form-urlencoded

  2. 1.2 数字签名

    采用MD5和BASE64相结合签名

  3. 1.3 请求示例

  4. 1.4 错误业务代码

    代码
    说明
    备注

    暂无数据

  5. 1.5 接口类型

    CP:company partner, 指顺心捷达的客户,也就是接入开放平台的客户系统

    SX:shunxin,指顺心捷达平台

    接口类型按照调用方向可分为两类:① CP→SX:客户——>顺心捷达 ②SX→CP:顺心捷达——>客户

    编码
    名称
    类型

    暂无数据

  6. 1.6 请求报文

    通用参数

    参数名称
    类型
    是否必填
    说明
    apiTypeString接口类型,见1.5
    dataDigestString加密验证信息,见1.2
    timestamplong时间戳
    messageIdString请求ID
    dataString请求内容:JSON字符串

    专属参数

    区别不同的接入客户类型,必填项不同。

    1、通过自研系统接入的客户

    参数名称
    类型
    是否必填
    说明
    appKeyString平台应用Key(开放平台创建应用后,在应用详情内查看,点击查看示意图
    sxCustomerCodeString客户编码(沙箱环境:C50022457 ;测试联调环境:C20002014 ; 正式环境可在开放平台绑定网点审核通过后生成、或网点添加电子面单客户获取, 点击查看示意图

    2、通过第三方平台与顺心捷达网点签约的客户,使用第三方平台客户编码下单

    参数名称
    类型
    是否必填
    说明
    appKeyString平台应用Key(开放平台创建应用后,在应用详情内查看,点击查看示意图
    platformCustomerCodeString合作商商户编码(商户的唯一ID、例如:mall_id)
    siteCodeString网点编码(在第三方平台与网点签约审核通过后生成)

    3、通过第三方平台,网点已经在电子面单客户添加的客户,联系网点获取客户编码

    参数名称
    类型
    是否必填
    说明
    appKeyString平台应用Key(开放平台创建应用后,在应用详情内查看,点击查看示意图
    sxCustomerCodeString客户编码(沙箱环境:C50022457 ;测试联调环境:C20002014 ; 正式环境可在开放平台绑定网点审核通过后生成、或网点添加电子面单客户获取, 点击查看示意图
  7. 1.7 响应报文

    参数名称
    类型
    长度
    说明
    successBoolean10true 表示请求成功,false表示请求失败
    codeString10业务代码
    messageString300信息说明
    dataObject数据对象
  8. 1.8 服务器地址

    沙箱环境:https://oms.sxjdfreight.com/api/gateway/sandbox

    测试环境:https://oms.sit.sf-express.com:9010/api/gateway/service

    正式环境:https://oms.sxjdfreight.com/api/gateway/service

2 SDK

SDK名称
语言
描述
顺心捷达开放平台SDKJAVA点击下载
顺心捷达开放平台SDK.NET点击下载

3 接口列表

4 面单打印模板打印规则文件下载

调用 3.2.1 订单打印接口[SX_EWB_ORDER_PRINT],可生成电子面单打印机指令,通过C-Lodop打印插件驱动打印。

5 问题反馈群(用企业微信或微信扫描)