马蜂窝开放平台

获取补款单列表

根据订单ID或者补款单创建时间获取补款单列表
注意：本接口可以根据 “订单ID”和“补款单创建时间”(begin_date 和 end_date)进行查询。这三个参数的作用是平级的，如果都传入数据的话，均会作为筛选条件。

调用频次

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

请求URL

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

请求Action

action：sales.replenish.list.get

请求参数

参数名称	参数类型	必填	示例	描述
order_id	string	否	201234201801011245334	旅行商城业务订单号
begin_date	dateTime	否	2018-01-01 12:23:23	[条件-起始时间]补款单创建时间
end_date	dateTime	否	2018-01-03 12:23:23	[条件-结束时间]补款单创建时间

响应参数

参数名称	参数类型	示例	描述
list	array	[]
{}	object	0
└ order_id	string	2124976201711275278834	旅行商城业务订单号
└ replenish_id	string	51171212004136372	旅行商城业务订单号关联补款单号
└ status	int	1	补款单状态0-待支付；1-已支付；2-申请退款中；3-部分退款成功；4-全部退款成功；5-已关闭
└ ctime	dateTime	2017-12-25 10:23:01	补款单创建时间
└ reason	int	1	创建补款单原因/类型：0-酒店升级/变更；1-房型升级/变更；2-航班升级/变更；3-产品服务升级/变更；4-套餐变更；5-增订项目；6-其他；
└ fee	number	20.00	补款单具体金额，精确到小数点后两位
└ remark	string	补款单备注	补款单备注
total	int	1

响应示例

{
    "list":[
        {
            "order_id":"2124976201711275278834",
            "replenish_id":"51171212004136372",
            "status":"1",
            "ctime":"2017-12-25 10:23:01",
            "reason":"1",
            "fee":"20.00",
            "remark":"补款单备注"
        }
    ],
    "total":"1"
}

异常错误码

异常码	异常信息
10050100	补款单其他错误
10050012	补款订单不存在
10050011	订单不存在
10050010	供应商没有获取权限
10050009	查询参数错误
10050005	主订单不存在