马蜂窝开放平台

新增/编辑产品

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

请求URL

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

请求Action

action：sales.htoken.product.update

请求参数

参数名称	参数类型	必填	示例	描述
sales_id	int	否	2256337	马蜂窝商品ID 【sales_id 为空时为新增产品信息,sales_id 不为空时为修改产品信息】
type	int	是	146	商品品类请传递固定值:146
name	string	是	测试商品	商品名称
ota_product_name	string	否	马蜂窝-测试产品	供应商自定义产品名称
highlights	array	否	[]	亮点词信息最多四个每个亮点词长度不能超过8个字【亮点词不能重复】
└ 亮点词	string	否	0	亮点词
img_top	string	是	https://n3-mafengwo.jpeg	商品头图
img_list	array	否	[]	轮播图
└ https://n3-mafengwo.jpeg	string	否	0	轮播图片地址
service_provider	string	是	马蜂窝	服务提供商
goods_info_imgs	array	否	[]	产品图文详情【只能传图片】
└ https://n3-mafengwo.jpeg	string	否	0	图片地址
primary_mddto	int	是	12341	主目的地ID
others_mddto	array	否	[]	其他目的地信息
└ 10099	int	否	0	目的地ID
instruction	string	否		使用说明
reminder	string	否		温馨提示
token_type	int	是	1	券码类型 1-客房、2-餐饮、3-温泉、4-门票（除温泉外）、99-其他
mfw_hotel_ids	array	是	[]	马蜂窝酒店ID
└ 17643	int	否	0	马蜂窝酒店ID
token_provider	int	是	2	1-马蜂窝发券，2-马蜂窝不发券
valid_start_date	date	是	2019-12-20	有效期起始日期
valid_end_date	date	是	2019-12-31	有效期-截止日期
suitable_date_list	array	否	[]	可用日期段，可填多组
{}	object	否	0
└ start_date	date	否	2019-11-11	可用日期段-起始日期
└ end_date	date	否	2019-12-12	可用日期段-截止日期
unsuitable_date_list	array	否	[]	不可用日期段，可填多组
{}	object	否	0
└ start_date	date	否	2019-11-11	不可用日期段-起始日期
└ end_date	date	否	2019-12-12	不可用时间段-截止日期
suitable_time_list	array	否	[]	可用时间段，可填多组
{}	object	否	0
└ start_time	string	否	12:00	可用时间段-起始时间
└ end_time	string	否	14:00	可用时间段-截止时间
unsuitable_time_list	array	否	[]	不可用时间段，可填多组
{}	object	否	0
└ start_time	string	否	12:00	不可用时间段-起始时间
└ end_time	string	否	14:00	不可用时间段-截止时间
invoice_provider	int	是	1	发票说明， 1-商家提供，2-酒店提供
appointment_type	int	是	1	预约方式，1-无需预约，2-电话预约
appointment_codition	int	否	0	电话预约提前天数值区间：1-99，默认：0 当 appointment_type 为 2 时可用
cancel_type	int	是	1	1-随时退，3-不可退，5-条件退
rule_checked	int	是	1	1 同意 2 不同意是否阅读并同意品类及商品发布规范

响应参数

参数名称	参数类型	示例	描述
sales_id	int	765372	马蜂窝商品ID

响应示例

{
    "sales_id":"765372"
}

异常错误码

异常码	异常信息
10140020	[券码有效期]结束时间格式错误
10140019	[券码有效期]开始时间格式错误
10140018	[券码有效期]开始结束时间不能为空
10140017	[发券方]不能为空
10140016	[不适用时段]开始结束时间格式错误
10140015	[适用时段]开始结束时间格式错误
10140014	[不适用日期]开始结束时间格式错误
10140013	[适用日期]开始结束时间格式错误
10140012	[发票说明]不能为空
10140011	[预约方式]无需预约时无需填写提前预约时间
10140010	[预约方式]提前预约时间1-99
10140009	[预约方式]提前预约时间不能为空
10140008	[预约方式]不能为空
10140007	服务出错