注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 电子凭证平台

taobao.vmarket.eticket.manage.notify (主动发起通知接口)

外部合作商家主动发起通知接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id Number 必须 1231223333 订单编号
notify_method String 必须 send 需要调用的通知方法,目前仅支持是send(发码)或resend(重新发码)
codemerchant_id Number 可选 2054573190 码商ID,如果是码商,必须传,如果是信任卖家,不需要传

响应参数

名称 类型 示例值 描述
ret_code Number 1 1:成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
VmarketEticketManageNotifyRequest req = new VmarketEticketManageNotifyRequest();
req.setOrderId(1231223333L);
req.setNotifyMethod("send");
req.setCodemerchantId(2054573190L);
VmarketEticketManageNotifyResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<vmarket_eticket_manage_notify_response>
    <ret_code>1</ret_code>
</vmarket_eticket_manage_notify_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.eticket-invalid-parameter:invalid-notify-method 无效的notify_method参数 调用接口的时候必须传递有效的notify_method参数
isv.eticket-order-not-found:invalid-orderid 传递的订单ID参数找不到对应的电子凭证订单信息 传递正确的订单ID参数
isv.eticket-seller-error:invalid-eticket-seller 码商/信任卖家没有入驻 入驻淘宝电子凭证平台
isv.eticket-privilege-error:order-not-belongto-seller 订单不属于用户授权登录的卖家/码商,卖家/码商没有权限操作这个订单 检查用户授权是否生效,并且授权的用户是否和订单所属的店铺的用户/绑定的码商一致
isv.eticket-service-unavailable:op-failed 接口回调失败 参考具体的错误信息处理

API工具

如何获得此API

FAQ

返回
顶部