马蜂窝开放平台

获取订单信息

根据筛选信息获取马蜂窝订单
订单同步说明，参考：http://open.mafengwo.cn/support/1450.html

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.order.list.get

请求参数

参数名称	参数类型	必填	示例	描述
page_no	int	是	1	当前页数
page_size	int	否	20	单页条数（最大值20）
params	object	否	{}
└ time_from	date	否	2017-12-17	用户下单起始时间
└ time_to	date	否	2017-12-26	用户下单结束时间
└ sales_type	int	否	1	订单关联产品品类具体说明请见马蜂窝品类说明表
└ color	int	否	1	订单标记的颜色 0-白色,1-红色,2-橙色,3-黄色,4-绿色,5-蓝色,6-紫色,7-灰色
└ order_status	int	否	1	订单状态：1-待支付，2-待出单，4-已出单，5-已完成，6-已关闭

响应参数

参数名称	参数类型	示例	描述
list	array	[]	订单列表
{}	object	0	订单信息
└ orderId	string	2124976201711275278834	旅行商城业务订单号
status	object	{}
└ orderStatus	int	1	订单状态：1-待支付，2-待出单，4-已出单，5-已完成，6-已关闭
└ allRefundFlag	int	0	全退标识：0 无退款 1 未全部退款 2 已全部退款
└ refundStatus	int	2	退款状态 1-已完成退款 2-已申请退款 3-拒绝退款 4-已确认退款 0-可发起退款
└ goDate	dateTime	2017-12-17	旅行出行日期
└ endDate	date	2018-03-16	旅行结束日期
└ paytime	dateTime	2017-12-26 12:30:33	订单支付时间
└ ctime	dateTime	2018-03-09 17:54:43	订单创建时间
bookingPeople	object	{}	预订人信息
└ uid	int	91276	预订人马蜂窝的UID
└ name	string	郗小雨	预订人姓名
└ email	string	91276@qq.com	预订人邮箱
└ phone	string	139127654321	预订人手机号
└ phone_area	string	0086	预订人手机区号
└ wechat	string	139127654321	预订人微信
└ remark	string		用户下单时添加的订单备注
└ salesId	string	2989234	马蜂窝产品id，产品唯一标识
└ salesName	string	大熊猫研究基地门票	产品名称
└ otaSalesName	string	产品名称	商家设置的产品外部编码
└ salesType	int	1	订单关联产品品类具体说明请见马蜂窝品类说明表
└ mdd	string	成都	目的地
└ from	string	成都	订单关联产品出发地
└ skuId	int	1125234	马蜂窝SKU ID，SKU唯一标识
└ otaSkuId	string	S22908792090902	商家设置的SKU外部编码
└ skuName	string	门票成人票	SKU名称
└ totalPrice	number	120.00	订单原始金额
└ paymentFee	number	118.00	用户实际支付金额
items	array	[]	订单购买项详细信息
{}	object	0
└ remain_payment_fee	number	90	剩余可退金额
└ remain_num	int	1	剩余可退数量
└ skuId	int	1125234	马蜂窝SKU ID，SKU唯一标识
└ price_type	int	1	费用项具体说明请见费用类型说明表
└ payment_fee	number	24	本项支付金额
└ total_price	number	24	本项总金额
└ name	string	房间	购买项描述
└ price	number	3	本项单价金额
└ num	int	8	本项购买个数
└ id	int	8	购买项ID
promotionDetail	object	{}	订单优惠信息
└ reduce_mfw	number	1.50	马蜂窝补贴金额
└ reduce_ota	number	0.50	商家补贴金额
skus	array	[]	库存信息
{}	object	0
└ stockName	string	不限量套餐	库存名称
└ otaSkuId	string	SKU1	商家设置的SKU外部编码
└ skuId	int	1125234	马蜂窝SKU ID，SKU唯一标识
confirmInfo	object	{}	确认方式信息
└ type	number	1	确认方式：0-普通确认，1-即时确认，2-二次确认
└ over_time	dateTime	2020-07-16 15:57:00	类型为二次确认时，需进行确认的时限
issueInfo	object	{}	出单方式信息
└ type	int	1	出单方式：1-商家出单，2-自动出单
└ days	int	1	出单期限天数，0表示不限制
total	int	1	订单总个数

响应示例

{
    "list":[
        {
            "orderId":"2124976201711275278834",
            "status":{
                "orderStatus":"1",
                "allRefundFlag":"0",
                "refundStatus":"2"
            },
            "goDate":"2017-12-17",
            "endDate":"2018-03-16",
            "paytime":"2017-12-26 12:30:33",
            "ctime":"2018-03-09 17:54:43",
            "bookingPeople":{
                "uid":"91276",
                "name":"郗小雨",
                "email":"91276@qq.com",
                "phone":"139127654321",
                "phone_area":"0086",
                "wechat":"139127654321",
                "remark":""
            },
            "salesId":"2989234",
            "salesName":"大熊猫研究基地门票",
            "otaSalesName":"产品名称",
            "salesType":"1",
            "mdd":"成都",
            "from":"成都",
            "skuId":"1125234",
            "otaSkuId":"S22908792090902",
            "skuName":"门票 成人票",
            "totalPrice":"120.00",
            "paymentFee":"118.00",
            "items":[
                {
                    "remain_payment_fee":"90",
                    "remain_num":"1",
                    "skuId":"1125234",
                    "price_type":"1",
                    "payment_fee":"24",
                    "total_price":"24",
                    "name":"房间",
                    "price":"3",
                    "num":"8",
                    "id":"8"
                }
            ],
            "promotionDetail":{
                "reduce_mfw":"1.50",
                "reduce_ota":"0.50"
            },
            "skus":[
                {
                    "stockName":"不限量套餐",
                    "otaSkuId":"SKU1",
                    "skuId":"1125234"
                }
            ],
            "confirmInfo":{
                "type":"1",
                "over_time":"2020-07-16 15:57:00"
            },
            "issueInfo":{
                "type":"1",
                "days":"1"
            }
        }
    ],
    "total":"1"
}

异常错误码

异常码	异常信息
10010034	系统异常
10010032	每页记录数不能超过20，查询多条记录请分页查询
10010031	这不是你的订单
10010030	该订单版本不支持
10010025	订单账号异常
10010024	没有操作权限
10010023	订单状态异常
10010022	订单出行日期有误
10010021	订单号异常