全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
淘宝商家应用接口
1、淘宝商家应用接口适用于导购平台、礼品平台、试用平台、礼品发货平台、SCRM 管理平台等,可同步淘宝店铺订单,查询订单详情,物流信息、评价信息,同时平台提供解密接口,用于解密用户手机号等信息。
2、开通《淘宝商家应用接口》,即可使用:订单明细、订购时间查询、订单列表查询、订单备注、增量订单查询、评价列表查询、快递公司查询、查询物流详情、线下物流发货、修改快递单号、解密接口、获取店铺信息(淘)、淘宝店铺授权、店铺授权回调、云打印接口(淘)、电子面单模板(淘)、面单使用情况(淘)、订单明细升级版(淘)、取消电子面单号、店铺授权查询(淘)、匹配产品规则(淘)、product 匹配(淘)、schema 获取(淘)、发布规则(淘)、文件发布(淘)、授权品牌列表(淘)、规则信息(淘)、类目列表(淘)、商品发布(淘)、获取 schema(淘)、提交 schema(淘)、商品增量更新(淘)、商品上架(淘)、商品下架(淘)、商品删除(淘)、商品列表(淘)、出售商品列表(淘)、ID 获取商品(淘)、ID 取商品 SKU(淘)
3、使用《淘宝商家应用接口》,需要店铺进行授权,开通接口后请联系客服获取指定的授权链接,非客服指定的授权链接无法同步订单,切记!
4、首次调用请先获取 token(接口用户在 v 兔这边的唯一识别信息),如何获取 token 点击查看详情
公共错误码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
204 | 免费次数或点券余额不足,请充值 | 充值点券后再来 |
204 | 请求异常:接口已过期,请续费 | 接口月租到期请前往总 erp 续费 |
302 | 未授权店铺或则授权过期 | msg:未授权,data 返回专属的授权链接,请让店铺重新授权 |
303 | 店铺未订购该软件 | 店铺订购到期或则未订购请前往订购,接口返回的提示 msg,店铺订购到期或则未订购请前往订购 |
401 | 身份凭证无效 | 在请求头中添加 access_token,重新更新 token |
404 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |
614 | 必须是此交易的买家或卖家才能获取交易详细信息 | 保证传入的订单 ID 和卖家 SessionKey 信息是一致的 |
614 | 交易不存在 | 订单已进入历史库,不再提供实时查询,出现此错误请清除本地数据库该订单,不要重试 |
614 | 订单 ID 不存在,或者使用了子订单 ID 来查询 | 请填写正确的订单 ID,或使用主订单 ID 来查询 |
614 | 交易慢查询访问太频繁 | 缩短查询订单的时间范围,减少超时查询的次数,或者等待一段时间后再来查询 |
614 | 单位时间内慢查询过多,服务被降级 | 请稍后重试。 |
614 | 佣金服务不可用 | 重试 |
614 | 交易服务不可用 | 适当重试 |
614 | 服务不可用 | 重试 |
614 | 交易服务限流 | 请稍后重试 |
614 | 交易服务连接依赖的远程服务错误 | 请稍后重试 |
614 | 交易服务处理超时 | 请稍后重试 |
614 | 请求参数有误 | 请传入正确的参数 |
614 | 门店发货拦截订单 | 重试 |
614 | 交易服务不可用 | 重试 |
614 | 订单已经被星盘拦截 | 对接星盘发货系统 |
614 | 用户不存在 | 通过简单的判断可以减少此类错误:排除特殊字符的昵称,如包含空格,冒号之类的昵称或排除字符长度小于 5 个,大于 20 个的 |
614 | 参数:seller_nick 无效,格式不对、非法值、越界等 | 请填写正确的 nick |
614 | API 调用远程服务超时 | 1. 每次返回 50 条以下,时间跨度小于半个小时 2. 避开交易高峰期上午 9:30-11:00,下午 14:00-17:00,晚上 20:00-22:30 3.使用增量 API(tool/erps/increment)可以减少甚至避免超时问题 |
614 | 请求被拒绝。 | 可能原因为限流,请不要频繁调用,尽量避开高峰期。 |
614 | 数据库限流。 | 请求量较大,请避开高峰期。 |
614 | 服务访问频繁 | 请稍后重试 |
614 | 不合法的参数 | 创建时间和结束时间不能为空 |
614 | 非法的参数 | 卖家 ID 非法 |
614 | 限流 | 请调整请求频率 |
614 | 非法的参数 | 请检查传入参数 |
614 | 交易不存在 | 请填写正确的订单号 |
614 | 参数无效,格式不对、非法值、越界等 | 请填写正确的参赛 |
614 | 必须是此交易的卖家或买家才能添加交易备注 | |
614 | 查询条件(修改时间)跨度不能超过一天 | 只能查询 3 个月内并且跨度为一天的修改过的数据 |
614 | buyer_nick 无效 | 请填写正确的 buyer_nick。 |
614 | 限流 | 避开限流 |
614 | 用户未登录或者非法的用户昵称 | 使用正确的用户昵称登录 |
614 | 评价者角色非法;买家身份不能查询评价 | 使用合法的评价者角色 |
614 | 评价类型非法 | 使用合法的评价类型 |
614 | 评价结果非法 | 使用合法的评价结果 |
614 | 使用了非法参数 tid | 使用合法的交易父订单号 |
614 | 参数校验错误 | 根据返回的错误内容得到具体细节 |
614 | 订单不存在 | 使用正确的订单查询评价信息 |
614 | 参数:trade_id:P07 无效,格式不对、非法值、越界等 | 1. 在调用订单获取数据的时候,需要提前判断交易是否已经发货,对于没有发货的订单不要去取物流信息。2. 通过增量 API 接口同步订单的时候,不要同步 3 个月以外的订单,以防止取不到交易的情况。 |
614 | 参数:trade_id:P07 无效,格式不对、非法值、越界等 | 1. 在调用订单获取数据的时候,需要提前判断交易是否已经发货,对于没有发货的订单不要去取物流信息。2. 通过增量 API 接口同步订单的时候,不要同步 3 个月以外的订单,以防止取不到交易的情况。 |
614 | 物流订单不存在 | 调用发货接口前要先判断 tid 是不是属于自身的 tid,并且需要判断 tid 是否存在,最好用搜索出来的 tid 列表里面的数据传入。 |
614 | 无效订单: | 参数错误建议间隔 2 分钟继续请求填入正确的参数 |
614 | 没有权限进行发货 | 在发货前要判断好订单的状态,只有交易存在、属于自己、并且是等待卖家发货的才能发,其余的状态无需也不能调用这个接口。 |
614 | 订单状态不对 | 1.遇到 isv 开头的错误不要在程序重试; 2.建议在发货前先调用交易 API 如:taobao.trade.fullinfo.get 来查询这个订单的状态,根据订单状态再做相应的处理,避免状态为已发货订单进行重复发货 |
614 | 没有选择物流公司 | 在前端对是否选择物流公司(company_code)做好校验,没有选择 company_code 的不允许其发货。 |
614 | 运单号为空 | 在前端对是否填写运单号(out_sid)进行校验,没有传入 out_sid 不允许其发货。 |
614 | 运单号不符合规则或已经被使用 | 每个物流公司都有特定的运单号规则,参照该运单号规则在前端对运单号是否符合对应的规则进行校验,不符合规则的不允许其发货。 |
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 | top 接口不允许对拆单订单操作 | top 接口不允许对拆单订单进行操作 |
614 | 运单号被识别为假,无法发货 | 请使用正确的运单号 |
614 | 您填写的运单号已经过期无效,不允许用此物流运单号发货 | 请使用正确的运单号 |
614 | 您此笔交易订单付款时间晚于快递公司揽收时间,此物流运单号不能使用 | 请使用正确的运单号 |
614 | 您此笔交易订单收货人地址信息与快递公司签收地址信息不匹配,此物流运单号不能使用 | 请使用正确的运单号 |
614 | 运单号已被使用,当前订单非真, 此物流单号不能使用 | 请使用正确的运单号 |
614 | 您填写的运单号已被使用,不允许用此物流运单号发货 | 请使用正确的运单号 |
614 | 您的收货人信息与发货人信息一致,不允许发货 | 请确认信息 |
614 | 拆单标记 和子订单列表两者必须都填或者都不填 | 拆单标记 和子订单列表两者必须都填或者都不填 |
614 | 子订单交易号为空 | 当传递 isSplit 为 1 后,必须传递该订单下的子订单交易号。 |
614 | 订单已拆单,必须传入子交易号列表 | 这个是已经被拆单的,操作这个订单发货时,必须带有子订单列表 |
614 | 订单已拆单,请走拆单逻辑 | 订单已拆单,必须传入 issplit 和子订单列表 |
614 | 当前操作的订单是拆单订单,拆单标记和子订单列表都必须传递 | 当前操作的订单是拆单订单,拆单标记和子订单列表都必须传递 |
614 | 订单已经被拆单,isSplit 必须是 1 | 订单已经被拆单,isSplit 必须是 1 |
614 | 接入拆单异常 | 拆单逻辑未知错误,请确认发货参数 |
614 | 未查到物流订单 | 未查到物流订单,请确认参数后重试 |
614 | 当前操作的订单不是拆单订单,拆单标记和子订单列表都不能带入 | 当前操作的订单不是拆单订单,拆单标记和子订单列表都不能带入 |
614 | 子订单号没有精确匹配 | 传入的子订单交易号必须完全匹配物流包裹中的子订单 |
614 | 输入的用户 Id 或交易订单号不正确,未查到交易订单 | 请输入正确的用户 ID 和交易订单号 |
614 | 非拆单订单的物流订单数不等于 1 | 请联系淘宝物流开发 |
614 | 物流订单不存在 | sessionkey 对应的 nick 和订单(tid) 对应 nick 不一致导致报错,调用发货接口前要先判断 tid 是不是属于卖家自身的 tid 。 |
614 | 拆单校验未通过 | 检查拆单发货时参数,确认相关参数正确 |
614 | 发货类型不匹配。如虚拟商品订单、家装类订单(仅能通过卖家后台页面发货),如使用该接口发货,会出现这个报错。 | 报错后禁止重试,并提示用户通过虚拟发货接口或到页面操作发货 |
614 | feature 参数格式不对。 | 对照文档的示例检查 feature 参数 ,按文档说明确认正确后重试。 |
614 | 系统异常 | 1、先检查是参数是否正确。如 company_code 传人了 out_sid(运单号);订单号(tid)和 sessionkey 对应的不是同一个卖家等 。2、若参数无误,报错后可稍等后重试 1 次 。 |
614 | 非法的 nick,无权查询 | 入参时 tid 和 sessionkey 对应的卖家 nick 不是同一个导致, 确认一致后重试 |
614 | 发货异常,请稍等后重试 | 发货异常,请稍等后重试 |
614 | 物流公司不存在或被禁用 | 一般是发货时,非淘宝合作物流公司,company_code 传人 other 等英文字符导致 。发货时如非淘宝合作物流公司,请直接输入物流公司名称,不能填 other |
614 | 发货使用物流公司不支持 | 部分物流公司被清退导致(详细可参考http://bbs.taobao.com/catalog/thread/567766-317065096.htm?spm=0.0.0.0.ReLZOb),更换其它物流公司发货 |
614 | 物流订单状态不为新建状态,无需发货处理 | 发货时检查订单状态,已发货订单不要重复发货,仅对待发货的订单发货。 |
614 | 物流的订单状态为关闭状态,无需发货 | 发货时检查订单状态,非等待发货状态,无需发货 |
614 | 您的订单无法通过此接口进行发货操作 | 请联系淘宝小二进行咨询 |
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 速宝物流服务,再进行发货 |
1001 | ip 禁止访问 | 请求频率超过限制请降频调用或联系管理员 |
1002 | 请求频率超过限制请降频调用或联系管理员 | 调用接口频率超过上限或则调用接口次数超过当日上限 |