文档中心 > API类目 > 本地生活API

alibaba.alsc.crm.open.order.backflow (订单回流接口)

回流isv订单接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_order_backflow_open_req OrderBackflowOpenReq 可选 入参
  • └ action
  • String
  • 必须
  • PAID
  • 待支付动作-WAIT_PAY, 支付动作-PAID, 订单成功动作-SUCCESS, 订单关闭动作-CLOSE, 退款动作-REFUND
  • └ brand_id
  • String
  • 必须
  • 243542
  • 品牌id
  • └ ext_info
  • String
  • 可选
  • {}
  • 扩展
  • invoice_info
  • InvoiceInfo
  • 可选
  • 发票信息
  • └ invoice
  • String
  • 可选
  • 3123545
  • 发票抬头
  • └ invoice_type
  • String
  • 可选
  • COMPANY
  • 发票类型: 个人-PERSONAL公司-COMPANY
  • └ tax_payer_id
  • String
  • 可选
  • 12334354
  • 纳税人识别码
  • logistical_info
  • LogisticalInfo
  • 可选
  • 物流信息
  • └ arrive_time
  • Date
  • 可选
  • 2020-03-05 12:00:00
  • 送达时间
  • └ logistics_status
  • String
  • 可选
  • WAIT_DELIVERY
  • 物流状态:WAIT_DELIVERY("WAIT_DELIVERY", "待发货"), WAIT_RECEIVE("WAIT_RECEIVE", "待收货"), SUCCESS("SUCCESS", "确认收货"), REFUND("REFUND", "退货");
  • └ receive_address
  • String
  • 可选
  • 杭州市西湖区
  • 收款地址
  • └ receive_phone
  • String
  • 可选
  • 13990899898
  • 联系人手机
  • └ operator_id
  • String
  • 可选
  • 2342
  • 操作人
  • order_info
  • OrderInfo
  • 必须
  • 订单信息
  • └ active_time
  • Date
  • 可选
  • 2020-03-05 12:00:00
  • 订单生效时间(外卖单)
  • └ biz_channel
  • String
  • 可选
  • KM
  • 渠道
  • └ gmt_create
  • Date
  • 可选
  • 2020-03-05 12:00:00
  • 订单创建时间
  • └ gmt_modified
  • Date
  • 可选
  • 2020-03-05 12:00:00
  • 订单更新时间
  • item_list
  • Item []
  • 可选
  • 11
  • 商品信息
  • └ actual_fee
  • Number
  • 可选
  • 2334
  • 实际费用
  • └ goods_name
  • String
  • 可选
  • 测试商品
  • 商品名称
  • └ price
  • Number
  • 可选
  • 3443
  • 价格
  • └ prom_fee
  • Number
  • 可选
  • 422
  • 优惠金额
  • └ sku
  • String
  • 可选
  • P
  • 商品规格,需保证唯一
  • └ spu
  • String
  • 可选
  • 23
  • 商品码
  • └ total_fee
  • Number
  • 可选
  • 12323
  • 总金额
  • └ unit
  • String
  • 可选
  • T
  • 单位
  • └ quantity
  • String
  • 可选
  • 1
  • 数量
  • └ primary_class
  • String
  • 可选
  • 1
  • 一级分类
  • └ secondary_class
  • String
  • 可选
  • 2
  • 二级分类
  • └ memo
  • String
  • 可选
  • 订单备注
  • 订单备注,长度不超过256
  • └ order_source
  • String
  • 可选
  • ELEME_TAKEOUT
  • pos点餐:POS_ORDER 扫码点餐:CODE_ORDER 线上点餐到店(美团):MEITUAN_ONLINE 线上点餐到店(口碑):KOUBEI_ONLINE 线上点餐到店(其他):OTHER_ONLINE 到家外卖(美团):MEITUAN_TAKEOUT 到家外卖(饿了么):ELEME_TAKEOUT 其他:OTHER
  • └ order_status
  • String
  • 可选
  • WAIT_PAY
  • 订单状态: WAIT_PAY("WAIT_PAY", "订单待支付"), PAID("PAID", "订单已支付"), SUCCESS("SUCCESS", "订单完成"), CLOSED("CLOSED", "已关闭"), REFUND("REFUND", "订单已退款");
  • out_buyer
  • OrderUser
  • 可选
  • 外部买家基础信息
  • └ email
  • String
  • 可选
  • test@163.com
  • 邮箱
  • └ name
  • String
  • 可选
  • 海底捞
  • 名称
  • └ nick_name
  • String
  • 可选
  • 海底捞
  • 昵称
  • └ phone
  • String
  • 可选
  • 13894532232
  • 手机号
  • └ type
  • String
  • 可选
  • ALIPAY
  • 用户类型: WECHAT-微信 ALIPAY-支付宝OTHER-其他
  • └ user_id
  • String
  • 可选
  • 20882399203402
  • 用户userId(支付宝ID/微信ID)
  • out_seller
  • OrderUser
  • 可选
  • 外部卖家基础信息
  • └ email
  • String
  • 可选
  • test@163.com
  • 邮箱
  • └ name
  • String
  • 可选
  • 刘德华
  • 名称
  • └ nick_name
  • String
  • 可选
  • 华仔
  • 昵称
  • └ phone
  • String
  • 可选
  • 13829202904
  • 手机号
  • └ type
  • String
  • 可选
  • ALIPAY
  • 用户类型: WECHAT-微信 ALIPAY-支付宝OTHER-其他
  • └ user_id
  • String
  • 可选
  • 20882399203402
  • 用户userId(支付宝ID/微信ID)
  • └ outer_order_id
  • String
  • 可选
  • 3423
  • 外部订单号
  • └ shop_address
  • String
  • 可选
  • 杭州市西湖区
  • 门店地址
  • └ shop_id
  • String
  • 可选
  • 349323
  • 门店id
  • └ shop_name
  • String
  • 可选
  • 银泰城店
  • 门店名称
  • └ performance_way
  • String
  • 可选
  • LVYUE
  • 履约方式
  • payment_info_list
  • PaymentInfo []
  • 可选
  • 12
  • 支付信息
  • fee_detail_list
  • FeeDetail []
  • 可选
  • 12
  • 费用明细
  • └ amount
  • Number
  • 可选
  • 2323
  • 金额
  • └ operator
  • String
  • 可选
  • PLUS
  • 计算方式 : 加-PLUS 加-MINUS
  • └ type
  • String
  • 可选
  • MERCHANT_ADJUST
  • MERCHANT_ADJUST 商家调整 PLATFORM_PROM 平台优惠 MERCHANT_PROM 商家优惠 CHARGE 储值 POINT 积分 OTHER 其他
  • └ order_total_amount
  • Number
  • 可选
  • 999999
  • 订单总金额
  • out_payer
  • OrderUser
  • 可选
  • 外部付款方基础信息
  • └ email
  • String
  • 可选
  • test2@email.com
  • 邮箱
  • └ name
  • String
  • 可选
  • 呵呵
  • 名称
  • └ nick_name
  • String
  • 可选
  • 呵呵
  • 昵称
  • └ phone
  • String
  • 可选
  • 18783992393
  • 手机号
  • └ type
  • String
  • 可选
  • WECHAT
  • 用户类型: WECHAT-微信 ALIPAY-支付宝OTHER-其他
  • └ user_id
  • String
  • 可选
  • 131233
  • 用户userId(支付宝ID/微信ID)
  • └ out_payment_no
  • String
  • 可选
  • 34212901203
  • 外部付款单号
  • └ pay_channel
  • String
  • 可选
  • ALIPAY
  • 支付宝-ALIPAY 微信-WECHAT 其他-OTHER
  • └ pay_method
  • String
  • 可选
  • CASH
  • 现金-CASH, 代扣-DEDUCT, 银行卡支付-BANK, 储值-STOREDVALUE, 微信-WECHAT, 支付宝 -ALIPAY, 积分-POINTS, 线下券-VOUCHER, 其他方式-OTHER;
  • └ payment_status
  • String
  • 可选
  • INITIAL
  • 支付状态: INITIAL("INITIAL", "初始状态"), WAIT_PAY("WAIT_PAY", "待支付状态"), SUCCESS("SUCCESS", "支付成功状态"), CANCEL("CANCEL", "支付冲正状态"), CLOSE("CLOSE", "关闭状态");
  • └ payment_time
  • Date
  • 可选
  • 2020-03-16 12:00:00
  • 支付时间
  • └ seller_receive_amount
  • Number
  • 可选
  • 300
  • 商家实收
  • └ user_pay_amount
  • Number
  • 可选
  • 200
  • 付款方实付金额
  • refund_info_list
  • RefundInfo []
  • 可选
  • 12
  • 退款信息
  • └ refund_amount
  • Number
  • 可选
  • 1000
  • 退款金额
  • refund_item_list
  • Item []
  • 可选
  • 12
  • 退款商品
  • └ actual_fee
  • Number
  • 可选
  • 2332
  • 实收费用
  • └ goods_name
  • String
  • 可选
  • 测试商品
  • 商品名称
  • └ price
  • Number
  • 可选
  • 23
  • 单价
  • └ prom_fee
  • Number
  • 可选
  • 3940
  • 优惠价格
  • └ sku
  • String
  • 可选
  • P
  • 规格
  • └ spu
  • String
  • 可选
  • 2323
  • 商品码
  • └ total_fee
  • Number
  • 可选
  • 39013
  • 总金额
  • └ unit
  • String
  • 可选
  • T
  • 计量单位
  • └ quantity
  • String
  • 可选
  • 1
  • 数量
  • └ refund_pay_no
  • String
  • 可选
  • 2334344242
  • 退款流水号(支付宝单号、微信单号、三方单号)
  • └ refund_status
  • String
  • 可选
  • INITIAL
  • 退款状态: INITIAL("INITIAL", "退款初始状态"), PROCESSING("PROCESSING", "处理中状态"), SUCCESS("SUCCESS", "退款成功状态"), FAIL("FAIL", "退款失败状态");
  • └ refund_time
  • Date
  • 可选
  • 2020-03-02 12:00:02
  • 退款时间
  • └ refund_type
  • String
  • 可选
  • ALL
  • 退款类型 : 整单-ALL 部分-PART
  • └ out_refund_no
  • String
  • 可选
  • 131433
  • 退款单号,必填
  • └ request_id
  • String
  • 必须
  • 23ab823992bd23923c223
  • 请求id
  • └ shop_id
  • String
  • 必须
  • 2323443
  • 门店id
  • └ operator_name
  • String
  • 可选
  • 星空
  • 操作人姓名
  • └ service_person_category
  • String
  • 可选
  • CESHI
  • 服务人员类别
  • └ service_person_name
  • String
  • 可选
  • liyan
  • 服务人员名称
  • └ service_person_id
  • String
  • 可选
  • 23434
  • 服务人员ID
  • └ order_channel
  • String
  • 可选
  • RESTAURANT
  • 订单类型-餐饮-RESTAURANT 生服-LIFE_SERVICE

响应参数

名称 类型 示例值 描述
result CommonResult 接口结果
  • └ biz_success
  • Boolean
  • true
  • 是否成功
  • └ result
  • Boolean
  • true
  • 结果
  • └ result_code
  • String
  • 0
  • 结果码
  • └ result_desc
  • String
  • 成功
  • 结果详情
  • └ result_view
  • String
  • 成功
  • 结果描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlscCrmOpenOrderBackflowRequest req = new AlibabaAlscCrmOpenOrderBackflowRequest();
AlibabaAlscCrmOpenOrderBackflowRequest.OrderBackflowOpenReq obj1 = new AlibabaAlscCrmOpenOrderBackflowRequest.OrderBackflowOpenReq();
obj1.setAction("PAID");
obj1.setBrandId("243542");
obj1.setExtInfo("{}");
AlibabaAlscCrmOpenOrderBackflowRequest.InvoiceInfo obj2 = new AlibabaAlscCrmOpenOrderBackflowRequest.InvoiceInfo();
obj2.setInvoice("3123545");
obj2.setInvoiceType("COMPANY");
obj2.setTaxPayerId("12334354");
obj1.setInvoiceInfo(obj2);
AlibabaAlscCrmOpenOrderBackflowRequest.LogisticalInfo obj3 = new AlibabaAlscCrmOpenOrderBackflowRequest.LogisticalInfo();
obj3.setArriveTime(StringUtils.parseDateTime("2020-03-05 12:00:00"));
obj3.setLogisticsStatus("WAIT_DELIVERY");
obj3.setReceiveAddress("杭州市西湖区");
obj3.setReceivePhone("13990899898");
obj1.setLogisticalInfo(obj3);
obj1.setOperatorId("2342");
AlibabaAlscCrmOpenOrderBackflowRequest.OrderInfo obj4 = new AlibabaAlscCrmOpenOrderBackflowRequest.OrderInfo();
obj4.setActiveTime(StringUtils.parseDateTime("2020-03-05 12:00:00"));
obj4.setBizChannel("KM");
obj4.setGmtCreate(StringUtils.parseDateTime("2020-03-05 12:00:00"));
obj4.setGmtModified(StringUtils.parseDateTime("2020-03-05 12:00:00"));
List<AlibabaAlscCrmOpenOrderBackflowRequest.Item> list6 = new ArrayList<AlibabaAlscCrmOpenOrderBackflowRequest.Item>();
AlibabaAlscCrmOpenOrderBackflowRequest.Item obj7 = new AlibabaAlscCrmOpenOrderBackflowRequest.Item();
list6.add(obj7);
obj7.setActualFee(2334L);
obj7.setGoodsName("测试商品");
obj7.setPrice(3443L);
obj7.setPromFee(422L);
obj7.setSku("P");
obj7.setSpu("23");
obj7.setTotalFee(12323L);
obj7.setUnit("T");
obj7.setQuantity("1");
obj7.setPrimaryClass("1");
obj7.setSecondaryClass("2");
obj4.setItemList(list6);
obj4.setMemo("订单备注");
obj4.setOrderSource("ELEME_TAKEOUT");
obj4.setOrderStatus("WAIT_PAY");
AlibabaAlscCrmOpenOrderBackflowRequest.OrderUser obj8 = new AlibabaAlscCrmOpenOrderBackflowRequest.OrderUser();
obj8.setEmail("test@163.com");
obj8.setName("海底捞");
obj8.setNickName("海底捞");
obj8.setPhone("13894532232");
obj8.setType("ALIPAY");
obj8.setUserId("20882399203402");
obj4.setOutBuyer(obj8);
AlibabaAlscCrmOpenOrderBackflowRequest.OrderUser obj9 = new AlibabaAlscCrmOpenOrderBackflowRequest.OrderUser();
obj9.setEmail("test@163.com");
obj9.setName("刘德华");
obj9.setNickName("华仔");
obj9.setPhone("13829202904");
obj9.setType("ALIPAY");
obj9.setUserId("20882399203402");
obj4.setOutSeller(obj9);
obj4.setOuterOrderId("3423");
obj4.setShopAddress("杭州市西湖区");
obj4.setShopId("349323");
obj4.setShopName("银泰城店");
obj4.setPerformanceWay("LVYUE");
obj1.setOrderInfo(obj4);
List<AlibabaAlscCrmOpenOrderBackflowRequest.PaymentInfo> list11 = new ArrayList<AlibabaAlscCrmOpenOrderBackflowRequest.PaymentInfo>();
AlibabaAlscCrmOpenOrderBackflowRequest.PaymentInfo obj12 = new AlibabaAlscCrmOpenOrderBackflowRequest.PaymentInfo();
list11.add(obj12);
List<AlibabaAlscCrmOpenOrderBackflowRequest.FeeDetail> list15 = new ArrayList<AlibabaAlscCrmOpenOrderBackflowRequest.FeeDetail>();
AlibabaAlscCrmOpenOrderBackflowRequest.FeeDetail obj16 = new AlibabaAlscCrmOpenOrderBackflowRequest.FeeDetail();
list15.add(obj16);
obj16.setAmount(2323L);
obj16.setOperator("PLUS");
obj16.setType("MERCHANT_ADJUST");
list13.setFeeDetailList(list15);
obj12.setOrderTotalAmount(999999L);
AlibabaAlscCrmOpenOrderBackflowRequest.OrderUser obj18 = new AlibabaAlscCrmOpenOrderBackflowRequest.OrderUser();
obj18.setEmail("test2@email.com");
obj18.setName("呵呵");
obj18.setNickName("呵呵");
obj18.setPhone("18783992393");
obj18.setType("WECHAT");
obj18.setUserId("131233");
list17.setOutPayer(obj18);
obj12.setOutPaymentNo("34212901203");
obj12.setPayChannel("ALIPAY");
obj12.setPayMethod("CASH");
obj12.setPaymentStatus("INITIAL");
obj12.setPaymentTime(StringUtils.parseDateTime("2020-03-16 12:00:00"));
obj12.setSellerReceiveAmount(300L);
obj12.setUserPayAmount(200L);
obj1.setPaymentInfoList(list11);
List<AlibabaAlscCrmOpenOrderBackflowRequest.RefundInfo> list20 = new ArrayList<AlibabaAlscCrmOpenOrderBackflowRequest.RefundInfo>();
AlibabaAlscCrmOpenOrderBackflowRequest.RefundInfo obj21 = new AlibabaAlscCrmOpenOrderBackflowRequest.RefundInfo();
list20.add(obj21);
obj21.setRefundAmount(1000L);
List<AlibabaAlscCrmOpenOrderBackflowRequest.Item> list24 = new ArrayList<AlibabaAlscCrmOpenOrderBackflowRequest.Item>();
AlibabaAlscCrmOpenOrderBackflowRequest.Item obj25 = new AlibabaAlscCrmOpenOrderBackflowRequest.Item();
list24.add(obj25);
obj25.setActualFee(2332L);
obj25.setGoodsName("测试商品");
obj25.setPrice(23L);
obj25.setPromFee(3940L);
obj25.setSku("P");
obj25.setSpu("2323");
obj25.setTotalFee(39013L);
obj25.setUnit("T");
obj25.setQuantity("1");
list22.setRefundItemList(list24);
obj21.setRefundPayNo("2334344242");
obj21.setRefundStatus("INITIAL");
obj21.setRefundTime(StringUtils.parseDateTime("2020-03-02 12:00:02"));
obj21.setRefundType("ALL");
obj21.setOutRefundNo("131433");
obj1.setRefundInfoList(list20);
obj1.setRequestId("23ab823992bd23923c223");
obj1.setShopId("2323443");
obj1.setOperatorName("星空");
obj1.setServicePersonCategory("CESHI");
obj1.setServicePersonName("liyan");
obj1.setServicePersonId("23434");
obj1.setOrderChannel("RESTAURANT");
req.setParamOrderBackflowOpenReq(obj1);
AlibabaAlscCrmOpenOrderBackflowResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alsc_crm_open_order_backflow_response>
    <result>
        <biz_success>true</biz_success>
        <result>true</result>
        <result_code>0</result_code>
        <result_desc>成功</result_desc>
        <result_view>成功</result_view>
    </result>
</alibaba_alsc_crm_open_order_backflow_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

返回
顶部