全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

物流发货-自己联系物流发货


接口地址: http://api.vv-tool.com/tool/erps/1688offline-send-order


接口介绍: 物流发货-自己联系物流发货


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 联系运营


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf

请求参数

参数 类型 必选 描述
shop_id string 店铺 id
send_goods array 发货对象列表
--source_id string 发货对象 id,一般是订单 id
--send_good_entries array 发货对象明细列表
----source_entry_id string 发货对象明细 id,对应子订单 Id
----amount int 发货对象实发数量
----weight int 发货对象实发重量,重量单位默认为千克
remarks string 备注
gmt_send string 发货时间
ext_body string JSON 字符串,cpCode 为物流公司 code,对应物流公司信息获取接口的 companyNo(非数字 Id); logisticsCpName:物流公司名称,对应物流公司信息获取接口的 companyName; mailNo:运单号; 可以通过获取 '物流公司列表-自联物流' 接口查询到数据。
ext_param string JSON 字符串
receiver_info object 收货地址,优先级大于订单收货地址,为空时,使用订单收货地址
--province_code string 省编码
--city_code string 市编码
--area_code string 地区编码
--town_code string 镇或街道编码
--province string 省名称,如果传了 code,则可以不传
--city string 市名称,如果传了 code,则可以不传
--area string 区名称,如果传了 code,则可以不传
--town string 镇或街道名称
--address string 详细地址
--full_name string 姓名
--corp_name string 公司名称
--post string 邮编
--phone string 固定电话
--mobile string 移动电话
--warehouse string 仓库
--code_type string 地址编码类型,默认菜鸟标准编码

请求示例

{
  'send_goods': [
    {
      'source_id':'12345611111',
      'sendGoodEntries':[
        {
          'source_entry_id':'111111111',
          'amount':1,
          'weight':1
        }
      ]
    }
  ],
'ext_param': '{'cpCode':'SF','logisticsCpName':'顺丰','mailNo':'a123'}'
}

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/1688offline-send-order' --header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf' --data-raw '{
    'send_goods': [
        {
            'source_id': '12345611111',
            'sendGoodEntries': [
                {
                    'source_entry_id': '111111111',
                    'amount': 1,
                    'weight': 1
                }
            ]
        }
    ],
    'ext_param': '{'cpCode':'SF','logisticsCpName':'顺丰','mailNo':'a123'}'
}'
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/1688offline-send-order',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    'send_goods': [
        {
            'source_id': '12345611111',
            'sendGoodEntries': [
                {
                    'source_entry_id': '111111111',
                    'amount': 1,
                    'weight': 1
                }
            ]
        }
    ],
    'ext_param': '{\'cpCode\':\'SF\',\'logisticsCpName\':\'顺丰\',\'mailNo\':\'a123\'}'
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse('text/plain');
RequestBody body = RequestBody.create(mediaType, '{
    'send_goods': [
        {
            'source_id': '12345611111',
            'sendGoodEntries': [
                {
                    'source_entry_id': '111111111',
                    'amount': 1,
                    'weight': 1
                }
            ]
        }
    ],
    'ext_param': '{\'cpCode\':\'SF\',\'logisticsCpName\':\'顺丰\',\'mailNo\':\'a123\'}'
}');
Request request = new Request.Builder()
  .url('http://api.vv-tool.com/tool/erps/1688offline-send-order')
  .method('POST', body)
  .addHeader('Authorization', 'Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf')
  .build();
Response response = client.newCall(request).execute();

响应参数

名称 类型 描述
code int 返回状态码
msg string 返回码描述
msec int 接口执行时间
time int 接口返回时间
data object 数据信息
--logistics_id string 物流编号
--send_goods array 发货明细
----source_id int 发货对象 id,一般是订单 id
----send_good_entries array 发货对象明细列表
------source_entry_id int 发货对象明细 id,对应子订单 Id
------amount int 发货对象实发数量
------weight int 发货对象实发重量,重量单位默认为千克
--withholding_money int 该接口扣费金额(点券)

返回数据


{
    'code': 0,
    'msg': '操作成功',
    'msec': 1469,
    'time': 1617270403,
    'data': {
        'logistics_id':'zx113988430670174',
        'send_goods':[
            {
                'source_id':206026099675498520,
                'send_good_entries':[
                    {
                        'source_entry_id':206026099675498520,
                        'amount':80,
                        'weight':10
                    }
                ]
            }
        ]
    }
}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权