文档中心 > API类目 > 零售终端API

tmall.nrt.order.synchronize (第三方订单同步)

第三方订单同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_sync_order_req_dto TopSyncOrderReqDTO 可选 参数
  • └ buyer_phone
  • String
  • 必须
  • 123123123
  • 买家手机号
  • └ mall_id
  • String
  • 必须
  • 123123
  • 卖场id
  • └ out_order_id
  • String
  • 必须
  • 123123
  • 外部订单号
  • item_info
  • TopSyncOrderItemInfoReqDTO []
  • 可选
  • {}
  • 商品信息
  • └ unit_price
  • Number
  • 必须
  • 100
  • 单价(分)
  • └ item_id
  • Number
  • 必须
  • 123
  • 商品id
  • └ unit
  • Number
  • 必须
  • 1
  • 数量
  • └ sku_id
  • Number
  • 必须
  • 123
  • skuid
  • └ store_id
  • String
  • 必须
  • 123
  • 摊位id
  • └ open_id
  • Number
  • 可选
  • 123123
  • openId
  • └ login_type
  • String
  • 必须
  • PHONE
  • 登录类型(扫码登录:CERTIFICATE_CODE,手机号:PHONE)

响应参数

名称 类型 示例值 描述
data TopSyncOrderRspDTO 返回数据
  • └ out_order_id
  • String
  • DW123123123
  • 外部订单号
  • └ biz_order_id
  • String
  • 1234567890123
  • 淘宝订单号
errcode String SYS_ERROR 错误编码
succ Boolean true 是否调用成功
errmsg String 系统异常 错误文案

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrtOrderSynchronizeRequest req = new TmallNrtOrderSynchronizeRequest();
TmallNrtOrderSynchronizeRequest.TopSyncOrderReqDTO obj1 = new TmallNrtOrderSynchronizeRequest.TopSyncOrderReqDTO();
obj1.setBuyerPhone("123123123");
obj1.setMallId("123123");
obj1.setOutOrderId("123123");
List<TmallNrtOrderSynchronizeRequest.TopSyncOrderItemInfoReqDTO> list3 = new ArrayList<TmallNrtOrderSynchronizeRequest.TopSyncOrderItemInfoReqDTO>();
TmallNrtOrderSynchronizeRequest.TopSyncOrderItemInfoReqDTO obj4 = new TmallNrtOrderSynchronizeRequest.TopSyncOrderItemInfoReqDTO();
list3.add(obj4);
obj4.setUnitPrice(100L);
obj4.setItemId(123L);
obj4.setUnit(1L);
obj4.setSkuId(123L);
obj1.setItemInfo(list3);
obj1.setStoreId("123");
obj1.setOpenId(123123L);
obj1.setLoginType("PHONE");
req.setTopSyncOrderReqDto(obj1);
TmallNrtOrderSynchronizeResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nrt_order_synchronize_response>
    <data>
        <out_order_id>DW123123123</out_order_id>
        <biz_order_id>1234567890123</biz_order_id>
    </data>
    <errcode>SYS_ERROR</errcode>
    <succ>true</succ>
    <errmsg>系统异常</errmsg>
</tmall_nrt_order_synchronize_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

返回
顶部