taobao.qimen.events.produce (批量发送奇门事件)

批量发送消息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
messages QimenEvent [] 必须
  • 最大列表长度:50
  • 奇门事件列表, 最多50条
    • event
    • Event
    • 可选
    • 奇门事件对象
    • └ tid
    • String
    • 必须
    • 12231221231232
    • 淘宝订单号
    • └ ext
    • String
    • 可选
    • JSON格式
    • 扩展属性
    • └ status
    • String
    • 必须
    • QIMEN_ERP_TRANSFER
    • 事件状态,如QIMEN_ERP_TRANSFER,QIMEN_ERP_CHECK
    • └ platform
    • String
    • 可选
    • JD
    • 商家平台编码.MAIN:官方渠道,JD:京东,DD:当当,PP:拍拍,YX:易讯,EBAY:ebay,AMAZON:亚马逊,SN:苏宁,GM:国美,WPH:唯品会,JM:聚美,MGJ:蘑菇街,YT:银泰,YHD:1号店,1688:1688,POS:POS门店,OTHER:其他
    • └ create
    • Number
    • 可选
    • 20170808
    • 订单创建时间,数字
    • └ nick
    • String
    • 可选
    • seller_001
    • 外部商家名称。必须同时填写platform
    • └ erp_order_id
    • String
    • 可选
    • erp_order_id
    • 主单号对应的erp单号,转单、审单、通知配货、出库 需要填。拆单、合单场景下不用填
    • └ taobao_sub_order_ids
    • String
    • 可选
    • taobao_sub_order_ids
    • 淘宝子订单id(拆单、合单场景下不用填,其他场景需要回传,用英文逗号隔开)
    • └ event_time
    • String
    • 可选
    • yyyy-mm-dd HH:mm:ss
    • 触发事件的时间

    响应参数

    名称 类型 示例值 描述
    is_all_success Boolean true 是否全部成功
    results QimenResult [] 发送结果,与发送时的参数顺序一致。如果is_all_success为true时,不用校验result是否成功
    • └ error_code
    • String
    • isv.invalid-paramter
    • 错误码
    • └ error_message
    • String
    • parameter required
    • 错误信息
    • └ is_success
    • Boolean
    • true
    • 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    QimenEventsProduceRequest req = new QimenEventsProduceRequest();
    List<QimenEventsProduceRequest.QimenEvent> list2 = new ArrayList<QimenEventsProduceRequest.QimenEvent>();
    QimenEventsProduceRequest.QimenEvent obj3 = new QimenEventsProduceRequest.QimenEvent();
    list2.add(obj3);
    QimenEventsProduceRequest.Event obj5 = new QimenEventsProduceRequest.Event();
    obj5.setTid("12231221231232");
    obj5.setExt("JSON格式");
    obj5.setStatus("QIMEN_ERP_TRANSFER");
    obj5.setPlatform("JD");
    obj5.setCreate(20170808L);
    obj5.setNick("seller_001");
    obj5.setErpOrderId("erp_order_id");
    obj5.setTaobaoSubOrderIds("taobao_sub_order_ids");
    obj5.setEventTime("yyyy-mm-dd HH:mm:ss");
    list4.setEvent(obj5);
    req.setMessages(list2);
    QimenEventsProduceResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <qimen_events_produce_response>
        <is_all_success>true</is_all_success>
        <results>
            <qimen_result>
                <error_code>isv.invalid-paramter</error_code>
                <error_message>parameter required</error_message>
                <is_success>true</is_success>
            </qimen_result>
        </results>
    </qimen_events_produce_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

    返回
    顶部