文档中心 > API类目 > 新零售供应链API

alibaba.ascp.channel.sales.order.create (供应链渠道销售单创建接口)

阿里巴巴供应链渠道销售订单创建接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
create_order_request ExternalCreateSalesOrderRequest 可选 请求参数
  • └ currency_type
  • String
  • 可选
  • CNY
  • 币种
  • out_sub_orders
  • ExternalCreateSubSalesOrderRequest []
  • 可选
  • _
  • 子订单列表
  • └ quantity
  • Number
  • 必须
  • 1
  • 购买数量
  • └ out_sku_id
  • String
  • 可选
  • qsk12234
  • 外部前端sku id
  • └ out_item_id
  • String
  • 可选
  • qsk12234
  • 外部前端宝贝id
  • └ sku_id
  • Number
  • 可选
  • 632553634653
  • 产品skuId
  • └ product_id
  • Number
  • 必须
  • 332553634653
  • 产品id
  • └ out_sub_order_no
  • String
  • 可选
  • qsk12244554555
  • 外部子订单号, 外部一定要设置,如果外部没有,则设置为outOrderNo+productId+productSkuId
  • └ attributes
  • String
  • 可选
  • {"key":"value"}
  • 扩展字段
  • receiver
  • ExternalReceiverRequest
  • 可选
  • _
  • 收货人信息
  • └ contact_name
  • String
  • 必须
  • 李小二
  • 收货人名称
  • └ province_code
  • Number
  • 可选
  • 110100
  • 省对应编码
  • └ city_code
  • Number
  • 可选
  • 110101
  • 市对应编码
  • └ street_code
  • Number
  • 可选
  • 1101011
  • 街道对应编码
  • └ area_code
  • Number
  • 可选
  • 11010111
  • 区对应编码
  • └ street_name
  • String
  • 可选
  • 北京市丰台区公主坟街道
  • 街道对应名称
  • └ mobile_phone
  • String
  • 必须
  • 13429165304
  • 收货人手机号
  • └ post
  • String
  • 可选
  • 310027
  • 邮编
  • └ city_name
  • String
  • 可选
  • 北京市
  • 市对应的名称
  • └ phone
  • String
  • 可选
  • 13429165304
  • 收货人 固定电话
  • └ area_name
  • String
  • 可选
  • 丰台区
  • 区对应名称
  • └ detail_address
  • String
  • 必须
  • 公主坟街道
  • 收货人地址
  • └ province_name
  • String
  • 可选
  • 北京市
  • 省对应的名称
  • └ division_id
  • Number
  • 可选
  • 110100
  • 区域编码
  • sender
  • ExternalSenderRequest
  • 可选
  • _
  • 发货人
  • └ mobile_phone
  • String
  • 可选
  • 13429165305
  • 发货人 手机号
  • └ contact_name
  • String
  • 可选
  • 王小二
  • 发货人名称
  • └ sales_mode
  • String
  • 必须
  • dealer
  • 经销、代销、寄售
  • └ out_order_no
  • String
  • 必须
  • qsk9938
  • 外部订单号
  • └ sub_channel_code
  • String
  • 必须
  • tmallglobal_blackUnique
  • 二级渠道
  • └ channel_code
  • String
  • 必须
  • tmallglobal
  • 授权渠道(市场)
  • └ attributes
  • String
  • 可选
  • {"key":"value"}
  • 扩展字段

响应参数

名称 类型 示例值 描述
create_order_response ResultWrapper 返回值包装,result为返回具体消息内容
  • └ error_code
  • String
  • service not found
  • 错误码
  • └ error_message
  • String
  • 无对应服务
  • 错误信息
  • └ success
  • Boolean
  • true
  • 返回是否成功
  • data_list
  • Data []
  • 返回值主体
  • sub_order_list
  • Suborders []
  • 子单列表
  • └ out_sku_id
  • String
  • qsksku
  • 外部skuId
  • └ out_item_id
  • String
  • qskitem
  • 外部itemId
  • └ sku_id
  • Number
  • 23453535635
  • skuId
  • └ product_id
  • Number
  • 45564646464
  • 产品id
  • └ out_sub_order_no
  • String
  • qsk2334
  • 外部子订单号
  • └ sub_sale_order_no
  • String
  • qsk003e9
  • 外部订单号
  • └ sale_order_no
  • String
  • 3232342
  • 渠道订单号

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpChannelSalesOrderCreateRequest req = new AlibabaAscpChannelSalesOrderCreateRequest();
AlibabaAscpChannelSalesOrderCreateRequest.ExternalCreateSalesOrderRequest obj1 = new AlibabaAscpChannelSalesOrderCreateRequest.ExternalCreateSalesOrderRequest();
obj1.setCurrencyType("CNY");
List<AlibabaAscpChannelSalesOrderCreateRequest.ExternalCreateSubSalesOrderRequest> list3 = new ArrayList<AlibabaAscpChannelSalesOrderCreateRequest.ExternalCreateSubSalesOrderRequest>();
AlibabaAscpChannelSalesOrderCreateRequest.ExternalCreateSubSalesOrderRequest obj4 = new AlibabaAscpChannelSalesOrderCreateRequest.ExternalCreateSubSalesOrderRequest();
list3.add(obj4);
obj4.setQuantity(1L);
obj4.setOutSkuId("qsk12234");
obj4.setOutItemId("qsk12234");
obj4.setSkuId(632553634653L);
obj4.setProductId(332553634653L);
obj4.setOutSubOrderNo("qsk12244554555");
obj4.setAttributes("{\"key\":\"value\"}");
obj1.setOutSubOrders(list3);
AlibabaAscpChannelSalesOrderCreateRequest.ExternalReceiverRequest obj5 = new AlibabaAscpChannelSalesOrderCreateRequest.ExternalReceiverRequest();
obj5.setContactName("李小二");
obj5.setProvinceCode(110100L);
obj5.setCityCode(110101L);
obj5.setStreetCode(1101011L);
obj5.setAreaCode(11010111L);
obj5.setStreetName("北京市丰台区公主坟街道");
obj5.setMobilePhone("13429165304");
obj5.setPost("310027");
obj5.setCityName("北京市");
obj5.setPhone("13429165304");
obj5.setAreaName("丰台区");
obj5.setDetailAddress("公主坟街道");
obj5.setProvinceName("北京市");
obj5.setDivisionId(110100L);
obj1.setReceiver(obj5);
AlibabaAscpChannelSalesOrderCreateRequest.ExternalSenderRequest obj6 = new AlibabaAscpChannelSalesOrderCreateRequest.ExternalSenderRequest();
obj6.setMobilePhone("13429165305");
obj6.setContactName("王小二");
obj1.setSender(obj6);
obj1.setSalesMode("dealer");
obj1.setOutOrderNo("qsk9938");
obj1.setSubChannelCode("tmallglobal_blackUnique");
obj1.setChannelCode("tmallglobal");
obj1.setAttributes("{\"key\":\"value\"}");
req.setCreateOrderRequest(obj1);
AlibabaAscpChannelSalesOrderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ascp_channel_sales_order_create_response>
    <create_order_response>
        <error_code>service not found</error_code>
        <error_message>无对应服务</error_message>
        <success>true</success>
        <data_list>
            <data>
                <sub_order_list>
                    <suborders>
                        <out_sku_id>qsksku</out_sku_id>
                        <out_item_id>qskitem</out_item_id>
                        <sku_id>23453535635</sku_id>
                        <product_id>45564646464</product_id>
                        <out_sub_order_no>qsk2334</out_sub_order_no>
                        <sub_sale_order_no>qsk003e9</sub_sale_order_no>
                    </suborders>
                </sub_order_list>
                <sale_order_no>3232342</sale_order_no>
            </data>
        </data_list>
    </create_order_response>
</alibaba_ascp_channel_sales_order_create_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

返回
顶部