淘宝开放平台

登录
文档中心 > API类目 > 五道口API

五道口API

qimen.alibaba.tcls.aelophy.bill.push (翱象核销单下发)

翱象核销单下发

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
merchant_code String 必须 CSSJ 商家编码
store_id String 必须 STORE001 业务经营店ID
shop_id String 可选 SHOP001 业务渠道店ID
out_shop_id String 可选 OUTSHOP001 渠道门店ID
order_from Number 可选 2 订单来源, 3：饿了么，2：美团，26：京东到家 30: 淘鲜达
bill_order_id String 必须 20210524152345000798 核销单ID
bill_type Number 必须 1 账单类型 1=正向 / 2=逆向
biz_id String 必须 2001577653109 核销业务单据ID 正向=渠道主订单ID / 逆向=渠道退款单ID
biz_order_id String 可选 500019819281413 业务主订单ID
out_order_id String 可选 2001577653109 渠道主订单ID
open_uid String 可选 AESDOI019_QW210 买家对应的open_uid
member_card_num String 可选 SA058 会员卡号
pay_time String 可选 2021-05-24 15:23:35 下单时间
actual_total_amt Number 可选 800 订单ERP入账金额, 值=子单商品行的actual_amt总和
sku_total_original_amt Number 可选 1000 商品原金额, 值=子单商品行的original_amt总和
discount_amt Number 可选 300 订单优惠金额(包含商品优惠、配送费优惠等)
package_amt Number 可选 100 包装费
post_amt Number 可选 400 配送费
sku_discount_platform_amt Number 可选 100 商品平台优惠金额
sku_discount_merchant_amt Number 可选 200 商品商家优惠金额
post_discount_platform_amt Number 可选 0 配送费平台优惠金额
post_discount_merchant_amt Number 可选 0 配送费商家优惠金额
order_status String 可选 SUCCESS 订单状态 PACKAGED=打包出库 SUCCESS=交易完成 REFUND=退款完成
pay_channels PayChannels [] 可选
  • 最大列表长度：999
    		•  支付信息
    • └ order_channel
    • String
    • 可选
    • APP|饿了么
    • 支付渠道名称
    • └ pay_amount
    • Number
    • 可选
    • 800
    • 支付金额
    • └ pay_type
    • String
    • 可选
    • 2
    • 支付方式
    sub_orders SubOrders [] 可选
  • 最大列表长度：999
    		•  子核销单列表
    • └ biz_order_id
    • String
    • 可选
    • 500019819280001
    • 业务子订单ID
    • └ out_order_id
    • String
    • 可选
    • 2001577653001
    • 渠道子订单ID
    • └ sku_code
    • String
    • 可选
    • 2501
    • 业务商品编码
    • └ quantity
    • String
    • 可选
    • 1.0
    • 下单数量(正向) / 退货数量(逆向) 标品按个数, 非标品按kg
    • └ original_price
    • Number
    • 可选
    • 600
    • 商品单价(优惠前价格)
    • └ original_amt
    • Number
    • 可选
    • 600
    • 子单商品总金额(正向) / 子单退商品总金额(逆向)
    • └ actual_price
    • Number
    • 可选
    • 550
    • 商品成交价(正/逆向, 参考价, 值=?actual_fee/quantity?)
    • └ actual_amt
    • Number
    • 可选
    • 550
    • 子单商品成交额
    • └ discount_amt
    • Number
    • 可选
    • 100
    • 子单总优惠 / 子单退总优惠
    • └ discount_merchant_amt
    • Number
    • 可选
    • 50
    • 子单优惠商家分摊 / 子单退优惠商家分摊
    • └ discount_platform_amt
    • Number
    • 可选
    • 50
    • 子单优惠平台分摊 / 子单退优惠平台分摊
    • └ pick_amt
    • Number
    • 可选
    • 500
    • 拣货金额
    • └ pick_amount_stock
    • String
    • 可选
    • 1.0
    • 拣货数量
    • └ barcode
    • String
    • 可选
    • 200211
    • 条形码
    • activitys
    • SubActivitys []
    • 可选
    • 子单活动类列表
    • └ merchant_activity_id
    • String
    • 可选
    • ERP_A001
    • 商家ERP上传活动id (非渠道独立活动 且商家ERP上传翱象 才有)
    • └ channel_activity_id
    • String
    • 可选
    • 200100981
    • 渠道活动id
    • └ discount_amt
    • Number
    • 可选
    • 100
    • 活动优惠金额
    • └ discount_platform_amt
    • Number
    • 可选
    • 80
    • 活动优惠金额
    • └ discount_merchant_amt
    • Number
    • 可选
    • 20
    • 活动商家优惠金额
    • └ activity_name
    • String
    • 可选
    • 营销活动
    • 活动名称
    • └ biz_activity_id
    • String
    • 可选
    • 5001001
    • 业务活动id (非渠道独立活动才有)
    • └ attribute
    • String
    • 可选
    • {"key":"value"}
    • 子单扩展属性
    • └ invoice_amount
    • Number
    • 可选
    • 10
    • 子单开票金额
    • └ actual_discount_amt
    • Number
    • 可选
    • 10
    • 子单不参与核销的金额
    activitys Activitys [] 可选
  • 最大列表长度：999
    		•  主单活动列表
    • └ merchant_activity_id
    • String
    • 可选
    • ERP_A001
    • 商家ERP上传活动id (非渠道独立活动 且商家ERP上传翱象 才有)
    • └ channel_activity_id
    • String
    • 可选
    • 200100981
    • 渠道活动id
    • └ discount_amt
    • Number
    • 可选
    • 100
    • 活动优惠金额
    • └ discount_platform_amt
    • Number
    • 可选
    • 80
    • 活动平台优惠金额
    • └ discount_merchant_amt
    • Number
    • 可选
    • 20
    • 活动商家优惠金额
    • └ activity_name
    • String
    • 可选
    • 营销活动
    • 活动名称
    • └ biz_activity_id
    • String
    • 可选
    • 5001001
    • 业务活动id (非渠道独立活动才有)
    invoice_amount Number 可选 100 开票金额
    attribute String 可选 {"invoiceServiceAmount":"10"} 扩展信息 JSON字符串 {key:value}
    actual_total_discount_amt Number 可选 10 主单不参与核销的金额
    refund_time String 可选 2021-10-24 15:23:35 退款时间
    user_amt Number 可选 100 用户支付金额

    响应参数

    名称 类型 示例值 描述
    success Boolean true 处理是否成功
    errCode String SUCCESS 返回码
    errMsg String 成功 返回码说明

    请求示例

    {"merchant_code":"CSSJ","sku_total_original_amt":1000,"sub_orders":[{"original_price":600,"quantity":"1.0","actual_price":550,"actual_amt":550,"original_amt":600,"discount_amt":100,"discount_platform_amt":50,"invoice_amount":10,"actual_discount_amt":10,"pick_amount_stock":"1.0","activitys":[{"activity_name":"营销活动","biz_activity_id":"5001001","discount_amt":100,"merchant_activity_id":"ERP_A001","discount_platform_amt":80,"discount_merchant_amt":20,"channel_activity_id":"200100981"}],"out_order_id":"2001577653001","pick_amt":500,"attribute":"{\"key\":\"value\"}","biz_order_id":"500019819280001","sku_code":"2501","barcode":"200211","discount_merchant_amt":50}],"post_amt":400,"discount_amt":300,"invoice_amount":100,"member_card_num":"SA058","order_status":"SUCCESS","out_shop_id":"OUTSHOP001","post_discount_merchant_amt":0,"bill_order_id":"20210524152345000798","pay_channels":[{"pay_amount":800,"pay_type":"2","order_channel":"APP|饿了么"}],"bill_type":1,"sku_discount_merchant_amt":200,"attribute":"{\"invoiceServiceAmount\":\"10\"}","biz_order_id":"500019819281413","actual_total_discount_amt":10,"store_id":"STORE001","sku_discount_platform_amt":100,"open_uid":"AESDOI019_QW210","pay_time":"2021-05-24 15:23:35","shop_id":"SHOP001","post_discount_platform_amt":0,"order_from":2,"actual_total_amt":800,"activitys":[{"activity_name":"营销活动","biz_activity_id":"5001001","discount_amt":100,"merchant_activity_id":"ERP_A001","discount_platform_amt":80,"discount_merchant_amt":20,"channel_activity_id":"200100981"}],"refund_time":"2021-10-24 15:23:35","user_amt":100,"out_order_id":"2001577653109","biz_id":"2001577653109","package_amt":100}

    响应示例

    {
    "success":true,
    "errCode":"SUCCESS",
    "errMsg":"成功"
}

    验签示例

    {"success":"false","errCode":"sign-check-failure","errMsg":"Illegal request"}

    错误码解释

    错误码 错误描述 解决方案
    isp.http-read-timeout
    response-body-parse-error
    isp.http-connection-timeout

    API工具

    错误码查询工具 SDK下载

    FAQ

    有用( 0 ) 我要提问
    返回
    顶部