alibaba.idle.appraise.order.perform (闲鱼验货宝服务商订单履约)

闲鱼验货担保业务中,外部服务商作为鉴定方 需要驱动交易节点变化

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
appraise_order_syn_dto AppraiseOrderSynDto 可选 AppraiseOrderSynDto
  • └ biz_order_id
  • String
  • 必须
  • biz_order_id
  • biz_order_id
  • attribute
  • Attribute
  • 可选
  • 根据订单状态不同,传递不同的内容
  • └ conclusion1
  • String
  • 可选
  • CERTIFIED_FLAW
  • 结构化一级结论枚举值 新品:'CERTIFIED_FLAW':真货有瑕疵;'CERTIFIED_NO_FLAW':真货无瑕疵;'FAKE':假货。 二手:'CERTIFIED_FLAW':真货有瑕疵;'FAKE':假货 主状态为4 ac已收货后,服务商调用履约接口传入
  • └ conclusion2
  • String
  • 可选
  • SELLER_NO_FAULT
  • 结构化二级结论枚举值 新品:无需该字段 二手:'SELLER_FAULT':卖家责任;'SELLER_NO_FAULT':卖家无责 主状态为4 ac已收货后,服务商调用履约接口传入
  • └ degree
  • String
  • 可选
  • 99新
  • 成色,奢侈品类需要填写" example="99新"。主状态为4 ac已收货后,服务商调用履约接口传入
  • └ report_url
  • String
  • 可选
  • http://report_url.com/123.html
  • 鉴定报告URL地址。主状态为4 ac已收货后,服务商调用履约接口传入
  • └ summary
  • String
  • 可选
  • 真货有瑕疵
  • 验货结论,真假、有无瑕疵等。主状态为4 ac已收货后,服务商调用履约接口传入
  • └ ac2seller_mail_no
  • String
  • 可选
  • 135316432667
  • 逆向流程发货给卖家的单号。买家发货后的任意一个逆向状态 服务商调用履约接口传入
  • └ ac2buyer_mail_no
  • String
  • 可选
  • 87684363241
  • 发货给买家的单号。主状态为6 买家确认购买,服务商调用履约接口传入
  • └ idle_appraise_checkpoints_result
  • String
  • 可选
  • [{\"keyId\":\"1001\",\"valueId\":\"1\",\"consistent\":true},{\"keyId\":\"1002\",\"valueId\":\"2\",\"consistent\":true},{\"keyId\":\"9999\",\"valueId\":\"5\",\"consistent\":true},{\"keyId\":\"9999\",\"valueId\":\"6\",\"consistent\":true}]
  • 验货项结论。keyId表示验货项Id,比如1001可能代表内存,valueId指出验货值的id,比如1可能代表存储64G的id,consistent代表实际此值是否为真。关于keyId、valueId的取值由其他对接文档给出
  • └ refuse_reason_code
  • String
  • 可选
  • 1
  • 拒绝识别场景原因枚举值
  • └ platform_sale_paid_zfb_id
  • String
  • 可选
  • 2022122022001156421456745507
  • 帮卖打款卖家支付宝流水号
  • └ order_status
  • String
  • 必须
  • 2
  • (主状态,子状态,状态说明)示例如下: ("1", "1", "买家拍下未付款") ("2", "1", "买家拍下已付款") ("3", "1", "卖家已发货") 等,详情参考对接文档
  • └ order_sub_status
  • String
  • 必须
  • 1
  • 见order_status字段说明
  • └ trigger_event
  • String
  • 可选
  • AC_REPORT
  • 3.0 必填

响应参数

名称 类型 示例值 描述
result Result 接口返回model
  • └ err_code
  • String
  • isp.service-unavailable
  • 错误码
  • └ err_msg
  • String
  • 服务不可用
  • 错误信息
  • └ succ
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleAppraiseOrderPerformRequest req = new AlibabaIdleAppraiseOrderPerformRequest();
AlibabaIdleAppraiseOrderPerformRequest.AppraiseOrderSynDto obj1 = new AlibabaIdleAppraiseOrderPerformRequest.AppraiseOrderSynDto();
obj1.setBizOrderId("biz_order_id");
AlibabaIdleAppraiseOrderPerformRequest.Attribute obj2 = new AlibabaIdleAppraiseOrderPerformRequest.Attribute();
obj2.setConclusion1("CERTIFIED_FLAW");
obj2.setConclusion2("SELLER_NO_FAULT");
obj2.setDegree("99新");
obj2.setReportUrl("http://report_url.com/123.html");
obj2.setSummary("真货有瑕疵");
obj2.setAc2sellerMailNo("135316432667");
obj2.setAc2buyerMailNo("87684363241");
obj2.setIdleAppraiseCheckpointsResult("[{\\"keyId\\":\\"1001\\",\\"valueId\\":\\"1\\",\\"consistent\\":true},{\\"keyId\\":\\"1002\\",\\"valueId\\":\\"2\\",\\"consistent\\":true},{\\"keyId\\":\\"9999\\",\\"valueId\\":\\"5\\",\\"consistent\\":true},{\\"keyId\\":\\"9999\\",\\"valueId\\":\\"6\\",\\"consistent\\":true}]");
obj2.setRefuseReasonCode("1");
obj2.setPlatformSalePaidZfbId("2022122022001156421456745507");
obj1.setAttribute(obj2);
obj1.setOrderStatus("2");
obj1.setOrderSubStatus("1");
obj1.setTriggerEvent("AC_REPORT");
req.setAppraiseOrderSynDto(obj1);
AlibabaIdleAppraiseOrderPerformResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_idle_appraise_order_perform_response>
    <result>
        <err_code>isp.service-unavailable</err_code>
        <err_msg>服务不可用</err_msg>
        <succ>true</succ>
    </result>
</alibaba_idle_appraise_order_perform_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部