基础 qianmi.cloudshop.d2c.logistics.send(云商城(D2C)订单在线发货处理)

用户调用该接口可实现云(D2C)在线自营订单发货(支持货到付款)和 代销订单发货(不支持货到付款,且只有当供货商已发货或采购单已退款的状态下才可以发货) ,订单状态会直接变更成卖家已发货,需要卖家授权
 用户授权类型
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://gw.api.qianmi.com/api https://api.qianmi.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 可选 用户登录授权以后,QMOP颁发给应用的授权信息,详细介绍请点击这里,当前API的用户授权类型标明:"需要授权",则此参数必传,"不需要授权",则此参数不需要传。
formatString 必须 指定响应格式,目前支持格式为json
appKeyString 必须 分配给应用的AppKey
vString 必须 API协议版本,当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
tidString 必须 T1213231231 千米网交易单编号
seller_nickString 必须 A000000 电商云商家编号,A开头
ship_type_idString 必须 express或自定义编号,如:100019173 配送方式 self:上门自提,express:快递, cityShip:同城配送,参见具体订单中该字段内容
company_idString 特殊可选 23123123101 商家物流公司编号,即对应LogistisCompany中的id字段
订单配送方式(ship_type_id)为快递(express)时必填
out_sidString 特殊可选 213123242 运单号,具体一个物流公司真实的运单号码
订单配送方式(ship_type_id)为快递(express)时必填
post_feeString 可选 12.00 物流费用,单位 元,整数部分不超过999999,精确到2位小数
delivery_man_codeString 特殊可选 配送员编码
当订单配送方式为cityShip(同城配送)时 必传
seller_remarkString 可选 2件商品,易碎 卖家发货备注
sender_idString 可选 12312 卖家用于发货的地址库ID,可以通过qianmi.cloudshop.logistics.address.search获取地址库列表,如果为空,取卖家默认发货地址
cancel_idString 可选 131231 卖家退货地址库编号,可以通过qianmi.cloudshop.logistics.address.search接口查询到地址库ID,如果为空,取卖家默认退货地址
seller_ipString 可选 192.168.10.1 商家的IP地址
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
D2cLogisticsSendRequest req = new D2cLogisticsSendRequest();
req.setTid("T20150723151006403");
req.setSellerNick("A857554");
req.setCompanyId("100001175");
req.setOutSid("SF1232123212321");
req.setPostFee("10.00");
req.setShipTypeId("express");
req.setShipTypeName("快递");
req.setSellerRemark("快");
D2cLogisticsSendResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new D2cLogisticsSendRequest;
$req->setTid("T20150723151006403");
$req->setSellerNick("A857554");
$req->setCompanyId("100001175");
$req->setOutSid("SF1232123212321");
$req->setPostFee("10.00");
$req->setShipTypeId("express");
$req->setShipTypeName("快递");
$req->setSellerRemark("快");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
D2cLogisticsSendRequest req = new D2cLogisticsSendRequest();
req.Tid = "T20150723151006403";
req.SellerNick = "A857554";
req.CompanyId = "100001175";
req.OutSid = "SF1232123212321";
req.PostFee = "10.00";
req.ShipTypeId = "express";
req.ShipTypeName = "快递";
req.SellerRemark = "快";
D2cLogisticsSendResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
shipping Shipping 返回发货是否成功 is_success
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效,格式不对、非法值、越界等"
        }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-cloudshop-d2c-logistics-send-service-error:01063013供货商未发货请确认采购单是否退款和供货商是否已发货,当前订单为代销订单,只有供货商发货或采购单退款的情况下才能进行发货操作
isv.qianmi-cloudshop-d2c-logistics-send-service-error:01063001物流费用格式不正确,只能为空或2位小数请根据提示信息重新设置物流费用
isv.qianmi-cloudshop-d2c-logistics-send-service-error:01063005该订单不能发货,请确认订单状态请点击物流发货说明查看满足订单的发货条件
isv.qianmi-cloudshop-d2c-logistics-send-service-error:01063012未查询到默认地址信息,请手动设置发货地址和退货地址卖家先设置好默认地址,再重新调用此接口进行发货。
isv.qianmi-cloudshop-d2c-logistics-send-service-error:01062009订单存在退货或退款申请单,不允许操作订单在发货前判断Trade中的is_sh_ship字段是否为false
isv.qianmi-cloudshop-d2c-logistics-send-service-error:01062007物流公司编号不存在确认传入的物流公司编号是否正确
isv.qianmi-cloudshop-d2c-logistics-send-service-error:01069003特殊可选参数异常,发货方式为非自提时,物流公司编号和运单号必填确认入参是否正确
isv.qianmi-cloudshop-d2c-logistics-send-service-error:01067002配送员编号不得为空当配送方式为同城配送(cityShip)时配送员编号不得为空
 FAQ