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

文档中心 > API类目 > 千牛业务API

taobao.message.fuwu.event.sync (服务事件同步)

服务中心事件同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
event_request_data EventRequestData 必须
  • 默认值:{}
  • 事件请求参数
    • └ event_id
    • String
    • 必须
    • wrk_ord
    • 服务工单型事件: wrk_ord 服务入口投放事件: entrance_delivery 非工单型服务事件: svc_proc
    • └ biz_type
    • Number
    • 可选
    • 0
    • 0-订单类 1-商品类
    • └ node_code
    • String
    • 必须
    • service_node
    • 服务节点code,必传,平台颁发
    • └ tenant_code
    • String
    • 必须
    • jushuitan
    • 调用租户code, 平台颁发,若无找租户,申请找运营@小呜,产品@摘星
    • └ buyer_open_id
    • String
    • 必须
    • dahjkdADHJKSALDH
    • 消费者账号ID
    • └ event_ts
    • Number
    • 可选
    • 1645162270000
    • 事件毫秒时间戳
    • └ content
    • String
    • 可选
    • {}
    • 事件明细内容
    • └ operator
    • String
    • 可选
    • 测试账号:a
    • 工单处理人账号名,如客服账号
    • └ scene_code
    • String
    • 必须
    • invoiceService
    • 服务场景code,平台定义,申请找运营@小呜,产品@摘星
    • └ out_work_id
    • String
    • 可选
    • 1234
    • 外部系统 工单ID 工单类服务场景 创建工单事件时必传 其他可选
    • └ biz_id
    • String
    • 可选
    • 111111111111
    • 对应业务ID,根据bizType可以判断是,可以是订单ID、商品ID,比如售后场景必须有对应订单ID
    • └ biz_data
    • String
    • 可选
    • {}
    • 扩展参数,默认不需要传递
    • └ creator
    • String
    • 可选
    • xxxxx
    • 创建者人账号,比如买家账号,工单创建节点必传,其他节点为空
    • └ work_order_id
    • String
    • 可选
    • xxxx
    • 平台工单id,工单创建节点必传,其他可选,非工单场景为空
    • └ work_order_result
    • Number
    • 可选
    • 2
    • 服务工单处理完结状态值:工单问题已解决、未解决、取消(买家取消、卖家取消、系统终止) 必须在工单完结时提供,调用方必须如实传值,虚假传值将直接影响服务供应质量分 2 = 完结-问题已解决 3 = 完结-问题未解决 -1 = 取消-买家终止 -2 = 取消-卖家终止 -3 = 取消-系统终止
    • └ work_order_result_remark
    • String
    • 可选
    • 工单处理完结备注说明
    • 工单处理完结备注说明,如果完结状态为问题未解决,工单取消时,则必须提供消费者可读的原因说明;若工单完结状态为问题已解决时,备注说明可选

    响应参数

    名称 类型 示例值 描述
    result FwResult {}
    • └ msg
    • String
    • msg
    • 整体返回信息
    • └ code
    • String
    • code
    • 整体返回码
    • └ biz_success
    • Boolean
    • true
    • 请求是否成功
    • value
    • FwEventHandleResult []
    • []
    • └ action
    • String
    • crt_wrk_ord
    • action名
    • └ success
    • Boolean
    • true
    • action是否成功
    • └ work_order_id
    • String
    • 111
    • 工单id,非工单场景为空
    • └ fail_code
    • String
    • failCode
    • action错误码
    • └ fail_msg
    • String
    • failMsg
    • action错误信息
    • └ data
    • String
    • work_order_id=%s, to_status=%s, node=%s
    • action data 可能为空
    • └ timestamp
    • Number
    • 1646722113902
    • 毫秒时间戳

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    MessageFuwuEventSyncRequest req = new MessageFuwuEventSyncRequest();
    MessageFuwuEventSyncRequest.EventRequestData obj1 = new MessageFuwuEventSyncRequest.EventRequestData();
    obj1.setEventId("wrk_ord");
    obj1.setBizType(0L);
    obj1.setNodeCode("service_node");
    obj1.setTenantCode("jushuitan");
    obj1.setBuyerOpenId("dahjkdADHJKSALDH");
    obj1.setEventTs(1645162270000L);
    obj1.setContent("{}");
    obj1.setOperator("测试账号:a");
    obj1.setSceneCode("invoiceService");
    obj1.setOutWorkId("1234");
    obj1.setBizId("111111111111");
    obj1.setBizData("{}");
    obj1.setCreator("xxxxx");
    obj1.setWorkOrderId("xxxx");
    obj1.setWorkOrderResult(2L);
    obj1.setWorkOrderResultRemark("工单处理完结备注说明");
    req.setEventRequestData(obj1);
    MessageFuwuEventSyncResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <message_fuwu_event_sync_response>
        <result>
            <msg>msg</msg>
            <code>code</code>
            <biz_success>true</biz_success>
            <value>
                <fw_event_handle_result>
                    <action>crt_wrk_ord</action>
                    <success>true</success>
                    <work_order_id>111</work_order_id>
                    <fail_code>failCode</fail_code>
                    <fail_msg>failMsg</fail_msg>
                    <data>work_order_id=%s, to_status=%s, node=%s</data>
                    <timestamp>1646722113902</timestamp>
                </fw_event_handle_result>
            </value>
        </result>
    </message_fuwu_event_sync_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

    返回
    顶部