qimen.alibaba.uni.trade.precreate (全域收单交易预创建接口)

预下单接口,该接口可返回待交易商品交易金额,以及可以享受的优化,以及折后实付

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
storeId String 可选 100004 门店ID。
goodsList RcGoodsParam [] 必须
  • 最大列表长度:999
  • 商品列表,列表元素格式为:商品标识:商品数量
    • └ goodsId
    • String
    • 必须
    • 69534523423
    • 商品标识
    • └ quantity
    • String
    • 必须
    • 1
    • 商品数量,支持浮点。唯一码模式下固定为1
    • └ price
    • Number
    • 可选
    • 13850
    • 商品价格,单位:分(人民币)
    • └ idType
    • String
    • 必须
    • CUSTOM
    • 商品标识类型。UNIQUE:唯一码;ITEM_SKU:sku模式;CUSTOM:商家自有编码
    • └ guider
    • String
    • 可选
    • 9527
    • 导购员编号
    • └ outSubTradeNo
    • String
    • 可选
    • OTS5435643
    • 商品所属外部子单号
    storeIdType String 可选 RPLUS 门店Id类型,RPLUS:零售+门店ID; PLACE:商户中心门店ID; CUSTOM:自有门店ID,须在商户中心有映射关系

    响应参数

    名称 类型 示例值 描述
    success Boolean true 业务失败或成功 true|false
    errCode String 20887 错误码
    errMsg String 无效参数 错误信息
    data RcTradePreCreateDTO 业务数据
    • └ totalAmount
    • String
    • 15000
    • 商品总金额,单位:分(人民币)
    • └ actualPayAmount
    • String
    • 10000
    • 实付金额,单位:分(人民币)
    • goodsList
    • RcGoods []
    • 商品详情列表
    • └ goodsId
    • String
    • 69534523423
    • 商品标识
    • └ quantity
    • String
    • 1
    • 商品数量,支持浮点。唯一码模式下固定为1
    • └ price
    • Number
    • 13850
    • 商品价格,单位:分(人民币)
    • └ idType
    • String
    • CUSTOM
    • 商品标识类型。UNIQUE:唯一码;ITEM_SKU:sku模式;CUSTOM:商家自有编码
    • └ itemId
    • Number
    • 4354355
    • itemId
    • └ skuId
    • Number
    • 12321431
    • skuId
    • └ title
    • String
    • 如意金箍棒
    • 商品标题
    • └ storeId
    • String
    • 100004
    • 门店ID
    • └ saleable
    • Boolean
    • true
    • 是否可售卖(预下单有效)
    • └ reason
    • String
    • 已售出
    • 不可售卖的原因(预下单有效)
    • └ originPrice
    • Number
    • 13850
    • 商品原价
    • └ guider
    • String
    • 9527
    • 导购员编号
    promotionList RcPromotion [] 权益列表
    • └ promotionId
    • Number
    • 45346547
    • 零售核心权益标识
    • └ promotionTitle
    • String
    • 满100减10
    • 零售核心权益标题
    • └ promotionDesc
    • String
    • 不可叠加使用
    • 零售核心权益描述
    • └ deductedAmount
    • Number
    • 1000
    • 对应权益扣减的金额,单位:分(人民币)
    • └ type
    • Number
    • true
    • 权益类型 0:平台权益 1:外部权益 默认为1

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlibabaUniTradePrecreateRequest req = new AlibabaUniTradePrecreateRequest();
    req.setStoreId("100004");
    List<AlibabaUniTradePrecreateRequest.RcGoodsParam> list2 = new ArrayList<AlibabaUniTradePrecreateRequest.RcGoodsParam>();
    AlibabaUniTradePrecreateRequest.RcGoodsParam obj3 = new AlibabaUniTradePrecreateRequest.RcGoodsParam();
    list2.add(obj3);
    obj3.setGoodsId("69534523423");
    obj3.setQuantity("1");
    obj3.setPrice(13850L);
    obj3.setIdType("CUSTOM");
    obj3.setGuider("9527");
    obj3.setOutSubTradeNo("OTS5435643");
    req.setGoodsList(list2);
    req.setStoreIdType("RPLUS");
    AlibabaUniTradePrecreateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <success>true</success>
    <errCode>20887</errCode>
    <errMsg>无效参数</errMsg>
    <data>
        <totalAmount>15000</totalAmount>
        <actualPayAmount>10000</actualPayAmount>
        <goodsList>
            <rc_goods>
                <goodsId>69534523423</goodsId>
                <quantity>1</quantity>
                <price>13850</price>
                <idType>CUSTOM</idType>
                <itemId>4354355</itemId>
                <skuId>12321431</skuId>
                <title>如意金箍棒</title>
                <storeId>100004</storeId>
                <saleable>true</saleable>
                <reason>已售出</reason>
                <originPrice>13850</originPrice>
                <guider>9527</guider>
            </rc_goods>
        </goodsList>
    </data>
    <promotionList>
        <rc_promotion>
            <promotionId>45346547</promotionId>
            <promotionTitle>满100减10</promotionTitle>
            <promotionDesc>不可叠加使用</promotionDesc>
            <deductedAmount>1000</deductedAmount>
            <type>true</type>
        </rc_promotion>
    </promotionList>
    

    异常示例

    • 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

    返回
    顶部