文档中心 > API类目 > 天猫服务商品API

tmall.servicecenter.workcard.identify (工单核销)

核销对应的服务工单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
latitude String 可选 36.241689 核销地点纬度
memo String 可选 备注 核销备注
type Number 可选 2
  • 默认值:2
  • 2:服务商,3:门店
    service_store_id Number 可选 1232323 汽车门店id,其他场景不需要
    pic_urls String [] 可选 ["url1","url2"]
  • 最大列表长度:20
  • 核销图片url列表
    identify_code String 可选 1234 核销码
    workcard_complete_tuples WorkcardCompleteTuple [] 必须
  • 最大列表长度:20
  • 工单完成信息列表
    • └ workcard_id
    • Number
    • 必须
    • 123456
    • 工单id
    • └ complete_count
    • Number
    • 必须
    • 1
    • 核销份数
    • └ sequence
    • Number
    • 可选
    • 1
    • 核销序列号,默认为1
    longitude String 可选 s 核销地点经度
    identify_task_id Number 可选 21345678 核销单id

    响应参数

    名称 类型 示例值 描述
    result Result - -
    • └ display_msg
    • String
    • 核销码错误
    • 错误信息
    • └ success
    • Boolean
    • false
    • 是否成功
    • └ msg_code
    • String
    • 1200
    • 错误码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallServicecenterWorkcardIdentifyRequest req = new TmallServicecenterWorkcardIdentifyRequest();
    req.setLatitude("36.241689");
    req.setMemo("备注");
    req.setType(2L);
    req.setServiceStoreId(1232323L);
    req.setPicUrls(""url1","url2"");
    req.setIdentifyCode("1234");
    List<TmallServicecenterWorkcardIdentifyRequest.WorkcardCompleteTuple> list2 = new ArrayList<TmallServicecenterWorkcardIdentifyRequest.WorkcardCompleteTuple>();
    TmallServicecenterWorkcardIdentifyRequest.WorkcardCompleteTuple obj3 = new TmallServicecenterWorkcardIdentifyRequest.WorkcardCompleteTuple();
    list2.add(obj3);
    obj3.setWorkcardId(123456L);
    obj3.setCompleteCount(1L);
    obj3.setSequence(1L);
    req.setWorkcardCompleteTuples(list2);
    req.setLongitude("s");
    req.setIdentifyTaskId(21345678L);
    TmallServicecenterWorkcardIdentifyResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_servicecenter_workcard_identify_response>
        <result>
            <display_msg>核销码错误</display_msg>
            <success>false</success>
            <msg_code>1200</msg_code>
        </result>
    </tmall_servicecenter_workcard_identify_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

    返回
    顶部