文档中心 > API类目 > pos交易api

alibaba.pos.order.create (pos交易创建订单)

阿里巴巴pos线下交易创建订单api

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
shop_id Number 必须 33571001 门店Id
create_order_request CreateOrderRequest 必须 下单入参
  • asset_list
  • AssetDto []
  • 可选
  • 资产信息
  • └ extra
  • String
  • 可选
  • {"key":"value"}
  • 额外属性
  • └ title
  • String
  • 可选
  • 提货券
  • 资产名称
  • └ status
  • String
  • 可选
  • 0
  • 状态
  • └ code
  • String
  • 可选
  • 9923413
  • 码值
  • └ type
  • String
  • 可选
  • VOUCHER
  • 资产类型
  • └ pay_code
  • String
  • 可选
  • 1
  • 付款码
  • └ cashier_num
  • String
  • 必须
  • 1
  • 收银工号
  • └ source
  • String
  • 必须
  • hema
  • 请求来源
  • item_list
  • ItemParamDto []
  • 可选
  • 购买商品信息
  • └ extra
  • String
  • 可选
  • {"key":"value"}
  • 商品自定义扩展信息
  • └ inv_quantity
  • String
  • 可选
  • 1
  • 商品重量
  • └ buy_quantity
  • Number
  • 可选
  • 1
  • 商品数量
  • └ sku_id
  • Number
  • 可选
  • 91111
  • sku对应id
  • └ item_id
  • Number
  • 可选
  • 98776345
  • 商品id
  • └ extra
  • String
  • 可选
  • {"key":"value"}
  • 请求扩展信息
  • └ shop_id
  • String
  • 必须
  • 33571001
  • 门店Id
  • └ machine_id
  • String
  • 必须
  • 1
  • pos级Id
  • └ business_type
  • String
  • 必须
  • 1
  • 业务类型
  • └ cashier_name
  • String
  • 必须
  • 收银员
  • 收银员名称
  • └ merchant_code
  • String
  • 必须
  • HM
  • 商家编码
  • └ buyer_id
  • Number
  • 必须
  • 1
  • 买家Id

响应参数

名称 类型 示例值 描述
result PosResult result result
  • model
  • CreateOrderRespDto
  • model
  • model
  • └ extra
  • String
  • {}
  • extra
  • └ is_card_order
  • Boolean
  • false
  • 是否礼品卡订单
  • └ biz_msg
  • String
  • bizMsg
  • └ biz_code
  • Number
  • bizCode
  • └ coupon_fee
  • Number
  • 优惠券抵扣金额
  • └ promotion_fee
  • Number
  • 优惠金额
  • └ total_fee
  • Number
  • 总价
  • └ actual_fee
  • Number
  • 应付金额
  • └ checkout_id
  • String
  • 支付单Id
  • └ biz_order_id
  • Number
  • 交易单Id
  • └ msg_code
  • String
  • msgCode
  • └ msg_info
  • String
  • msgInfo
  • └ success
  • Boolean
  • true
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaPosOrderCreateRequest req = new AlibabaPosOrderCreateRequest();
req.setShopId(33571001L);
AlibabaPosOrderCreateRequest.CreateOrderRequest obj1 = new AlibabaPosOrderCreateRequest.CreateOrderRequest();
List<AlibabaPosOrderCreateRequest.AssetDto> list3 = new ArrayList<AlibabaPosOrderCreateRequest.AssetDto>();
AlibabaPosOrderCreateRequest.AssetDto obj4 = new AlibabaPosOrderCreateRequest.AssetDto();
list3.add(obj4);
obj4.setExtra("{\"key\":\"value\"}");
obj4.setTitle("提货券");
obj4.setStatus("0");
obj4.setCode("9923413");
obj4.setType("VOUCHER");
obj1.setAssetList(list3);
obj1.setPayCode("1");
obj1.setCashierNum("1");
obj1.setSource("hema");
List<AlibabaPosOrderCreateRequest.ItemParamDto> list6 = new ArrayList<AlibabaPosOrderCreateRequest.ItemParamDto>();
AlibabaPosOrderCreateRequest.ItemParamDto obj7 = new AlibabaPosOrderCreateRequest.ItemParamDto();
list6.add(obj7);
obj7.setExtra("{\"key\":\"value\"}");
obj7.setInvQuantity("1");
obj7.setBuyQuantity(1L);
obj7.setSkuId(91111L);
obj7.setItemId(98776345L);
obj1.setItemList(list6);
obj1.setExtra("{\"key\":\"value\"}");
obj1.setShopId("33571001");
obj1.setMachineId("1");
obj1.setBusinessType("1");
obj1.setCashierName("收银员");
obj1.setMerchantCode("HM");
obj1.setBuyerId(1L);
req.setCreateOrderRequest(obj1);
AlibabaPosOrderCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_pos_order_create_response>
    <result>
        <model>
            <extra>{}</extra>
            <is_card_order>false</is_card_order>
            <biz_msg></biz_msg>
            <biz_code></biz_code>
            <coupon_fee></coupon_fee>
            <promotion_fee></promotion_fee>
            <total_fee></total_fee>
            <actual_fee></actual_fee>
            <checkout_id></checkout_id>
            <biz_order_id></biz_order_id>
        </model>
        <msg_code></msg_code>
        <msg_info></msg_info>
        <success>true</success>
    </result>
</alibaba_pos_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

返回
顶部