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

修改物流公司和运单


接口地址: http://api.vv-tool.com/tool/erps/resend


接口介绍: 修改物流公司和运单点击查看详情


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


请求方式: POST


返回格式: JSON


接口收费: 扣账户余额


频率限制: 10 次/秒


请求头参数

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

请求参数

名称 类型 必须 示例值 描述
shop_id String true 123456789 店铺 ID
tid Number true 123 淘宝交易 ID
sub_tids string false 1,2,3 需要拆单发货的子订单集合,针对的是一笔交易下有多个子订单需要分开发货的场景;1 次可传人多个子订单号,子订单间用逗号隔开;为空表示不做拆单发货。
out_sid String true 123456789 运单号。具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入;
company_code String true POST 物流公司代码。如"POST"就代表中国邮政,"ZJS"就代表宅急送。 快递简称快递简写列表
vvtype int false 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

请求示例

tid:123
out_sid:123456789
company_code:POST
shop_id:123

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/resend' \
--header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx' \
--header 'Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D' \
--form 'tid="123"' \
--form 'out_sid="123456789"' \
--form 'company_code="POST"' \
--form 'shop_id="123"'
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/resend',
  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 => array('tid' => '123','out_sid' => '123456789','company_code' => 'POST','shop_id' => '123'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;


JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("tid","123")
  .addFormDataPart("out_sid","123456789")
  .addFormDataPart("company_code","POST")
  .addFormDataPart("shop_id","123")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/resend")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Cookie", "__yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
code int 错误码 0 为成功
msg string 返回码描述
msec int 接口执行时间
time int 接口返回时间
is_success Boolean 返回发货是否成功。
withholding_money int 该接口扣费金额(点券)

返回数据

{
           "code": 0,
           "msg": "成功",
           "msec": 1193,
           "time": 1612416107,
           "data": [
					 {
					   "withholding_money": 1,
             "is_success":true
           }]
           
     
}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权
401 身份凭证无效 在请求头中添加 access_token,重新更新 token
404 请求路径或请求方式错误 请更换请求方式或者检查路径是否正确
614 物流订单不存在 调用发货接口前要先判断 tid 是不是属于自身的 tid,并且需要判断 tid 是否存在,最好用搜索出来的 tid 列表里面的数据传入。
614 没有权限进行发货 在发货前要判断好订单的状态,只有交易存在、属于自己、并且是等待卖家发货的才能发,其余的状态无需调用这个接口。
614 订单状态不对 1.遇到 isv 开头的错误不要在程序重试; 2.建议在发货前先调用交易 API 如:taobao.trade.fullinfo.get 来查询这个订单的状态,根据订单状态再做相应的处理,避免状态为已发货订单进行重复发货
614 没有选择物流公司 在前端对是否选择物流公司(company_code)做好校验,没有选择 company_code 的不允许其发货。
614 运单号为空 在前端对是否填写运单号(out_sid)进行校验,没有传入 out_sid 不允许其发货。
614 运单号不符合规则 每个物流公司都有特定的运单号规则,参照该运单号规则在前端对运单号是否符合对应的规则进行校验,不符合规则的不允许其发货。
614 参数无效,格式不对、非法值、越界等 请对照参数表
614 地址库不存在或该地址库不属于当前用户 可以通过此接口查询地址库 taobao.logistics.address.search
614 参数为空 必填参数为空,如 tid 为空,请确保传入的必选参数不为空,请对照参数表
614 已生成发货单 已经生成发货单的订单不能发货
614 物流公司不存在或被禁用 通过 taobao.logistics.companies.get 查询支持自已在线下单或货到款的物流公司
614 物流订单来源错误 非 c2c 的订单不支持款到付款发货
614 未补签货到付款补充协议 请与客服联系,补签补充协议!
614 该物流公司未开通 COD 服务 该物流公司不支持货到付款,通过 taobao.logistics.partners.get 查询支持货到付款的物流公司
614 该物流公司揽收或派送范围不支持 可以通过此接口 taobao.logistics.partners.get,查询支持揽收或派送范围的物流公司
614 系统异常 系统异常
614 该物流公司不支持在线下单 该物流公司不支持在线下单,通过 taobao.logistics.companies.get 查询支持在线下单的物流公司
614 该交易状态不正确,不能发货 建议在发货前先调用交易 API 如:taobao.trade.fullinfo.get 来查询这个订单的状态,根据订单状态再做相应的处理,避免状态为已发货订单进行重复发货
614 物流订单不存在 调用发货接口前要先判断 tid 是不是属于自身的 tid,并且需要判断 tid 是否存在,最好用搜索出来的 tid 列表里面的数据传入。
614 没有权限进行发货 在发货前要判断好订单的状态,只有交易存在、属于自己、并且是等待卖家发货的才能发,其余的状态无需调用这个接口。
614 订单状态不对 1.遇到 isv 开头的错误不要在程序重试; 2.建议在发货前先调用交易 API 如:taobao.trade.fullinfo.get 来查询这个订单的状态,根据订单状态再做相应的处理,避免状态为已发货订单进行重复发货
614 没有选择物流公司 在前端对是否选择物流公司(company_code)做好校验,没有选择 company_code 的不允许其发货。
614 运单号为空 在前端对是否填写运单号(out_sid)进行校验,没有传入 out_sid 不允许其发货。
614 运单号不符合规则 每个物流公司都有特定的运单号规则,参照该运单号规则在前端对运单号是否符合对应的规则进行校验,不符合规则的不允许其发货。
614 参数为空 必填参数为空,如 tid 为空,请确保传入的必选参数不为空,请对照参数表
614 地址库不存在或该地址库不属于当前用户 可以通过此接口查询地址库 taobao.logistics.address.search
614 没有用户 ID 检查用户是否登录,或 session 过期
614 已生成发货单 已经生成发货单的订单不能发货
614 物流公司名称过长 物流公司名称过长,长度在 20 个字符
614 该物流公司不支持自己联系 该物流公司不支持自己联系,通过 taobao.logistics.companies.get 查询支持自已联系的物流公司
614 该交易状态不正确,不能发货 建议在发货前先调用交易 API 如:taobao.trade.fullinfo.get 来查询这个订单的状态,根据订单状态再做相应的处理,避免状态为已发货订单进行重复发货
614 对不起,您尚未成功订购 E 速宝物流服务 订购 E 速宝服务
614 对不起,该订单超出了 E 速宝的服务范围,请联系小二处理 检查收货地址和发货地址
614 参数错误 校验入参是否正确
614 物流订单不存在 检查订单是否存在
614 无效的物流公司 物流公司和不合法,请选择一个正确的物流公司
614 无效的订单类型 检验 logist_type 不合法
614 订单未发货 请先发货后再修改
614 不支持的订单类型 只支持在线,COD,自己联系和保障速递的订单
614 当前订单状态不支持修改 检验订单状态
614 未作修改 确认是否需要调用本接口
614 该订单不支持修改。如不虚拟发货方式,这种方式该 API 是不支持修改的 报错后应用程序做好控制,禁止重试,并做相应提示。
614 top 接口不允许对拆单订单操作 top 接口不允许对拆单订单进行操作
614 运单号被识别为假,无法发货 请使用正确的运单号
614 您填写的运单号已经过期无效,不允许用此物流运单号发货 请使用正确的运单号
614 您此笔交易订单付款时间晚于快递公司揽收时间,此物流运单号不能使用 请使用正确的运单号
614 您此笔交易订单收货人地址信息与快递公司签收地址信息不匹配,此物流运单号不能使用 请使用正确的运单号
614 运单号已被使用,当前订单非真, 此物流单号不能使用 请使用正确的运单号
614 您填写的运单号已被使用,不允许用此物流运单号发货 请使用正确的运单号
614 您的收货人信息与发货人信息一致,不允许发货 请确认信息
614 订单已拆单,必须传入子交易号列表 这个是已经被拆单的,操作这个订单发货时,必须带有子订单列表
614 订单已拆单,请走拆单逻辑 订单已拆单,请走拆单逻辑,issplit 和子订单列表必须都传入
614 入参传入的主子交易号组合逻辑非法 入参传入的主子交易号组合逻辑非法,子订单列表不在对应的物流订单中,请传入对应的子订单列表
614 拆单标记 和子订单列表两者必须都填或者都不填 拆单标记 和子订单列表两者必须都填或者都不填
614 子订单交易号为空 当传递 isSplit 为 1 后,必须传递该订单下的子订单交易号。
614 订单已经被拆单,isSplit 必须是 1 订单已经被拆单,isSplit 必须是 1
614 接入拆单异常 拆单逻辑未知错误,请确认发货参数
614 未查到物流订单 拆单订单校验子订单过程中未查到物流订单
614 传入的子订单号不同时在一个物流包裹中 传入的子订单号不同时在一个物流包裹中。传入订单时请输入同一个
614 其他异常 请确认输入订单参数后重试
614 当前操作的订单不是拆单订单,拆单标记和子订单列表都不能带入 当前操作的订单不是拆单订单,拆单标记和子订单列表都不能带入
614 子订单号没有精确匹配 传入的子订单交易号必须完全匹配物流包裹中的子订单
614 输入的用户 Id 或交易订单号不正确,未查到交易订单 请输入正确的用户 ID 和交易订单号
614 非拆单订单的物流订单数不等于 1 请联系淘宝物流开发
614 运单号错误或已经被使用 请检查运单号是否正确,或联系物流公司更换运单号
614 运单号错误或已经被使用 请检查运单号是否正确,或联系物流公司更换运单号
614 不支持切换为该物流公司 请检查新切换的物流公司信息是否正确
614 物流公司不存在或被禁用 请检查新更换的物流公司信息是否正确
614 物流订单状态不为新建状态,无需发货处理 物流订单状态不为新建状态,无需发货处理
614 远程调用发生未知错误 请重试,重试不成功,联系相关小二解决
614 发货失败 请重试,重试不成功,联系相关小二解决
614 物流订单状态不为新建状态,无需发货处理 物流订单状态不为新建状态,无需发货处理
614 对不起,您尚未成功订购 E 速宝物流服务 请先订购 E 速宝物流服务,再进行发货