马蜂窝开放平台

日历库存全量覆盖

SKU日历库存全量更新覆盖。
清空SKU历史日历库存数据，并以最近一次调用的日历库存数据进行全量覆盖。

调用频次

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

请求URL

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

请求Action

action：sales.sku.calendar.override

请求参数

参数名称	参数类型	必填	示例	描述
[]	array	是	0	需要全量覆盖的sku，单次最多1个sku
calendar_items	array	是	date_arr[]	日历库存每天数据，天数最多180天，单次最多540条数据（目前单天数据对应最多的费用项为3个：成人、儿童、单房差）
[]	array	是	0	单天数据项
└ max_num	int	否	10	最大购买数
└ min_num	int	否	1	最小购买数
└ remain	int	否	50	日历库存余量
└ price	number	是	2000	售卖价格
└ price_type	int	是	8	费用项具体说明请见费用类型说明表
└ date	date	是	2018-03-24	日期
└ ota_sku_id	string	否	S123335	商家设置的SKU外部编码，sku_id与ota_sku_id二选一
└ sku_id	int	否	247801	马蜂窝sku_id，马蜂窝sku_id与ota_sku_id商家编码二选一

响应参数

参数名称	参数类型	示例	描述
success	array	success_sku_arr[]	执行成功的sku
{}	object	0	items
└ sku_id	int	2478001	马蜂窝sku_id，马蜂窝sku_id与ota_sku_id商家编码二选一
└ ota_sku_id	string	S123335	商家设置的SKU外部编码，sku_id与ota_sku_id二选一
fail	array	fail_sku_arr[]	执行失败的SKU
{}	object	0	items
└ sku_id	int	247801	马蜂窝sku_id，马蜂窝sku_id与ota_sku_id商家编码二选一
└ ota_sku_id	string	s12335	商家设置的SKU外部编码，sku_id与ota_sku_id二选一
└ errno	int	10020002	单个错误码
└ message	string	日期格式错误	单个错误信息

响应示例

{
    "success":[
        {
            "sku_id":"2478001",
            "ota_sku_id":"S123335"
        }
    ],
    "fail":[
        {
            "sku_id":"247801",
            "ota_sku_id":"s12335",
            "errno":"10020002",
            "message":"日期格式错误"
        }
    ]
}

异常错误码

异常码	异常信息
10020062	库存日历价格费用项有误
10020056	您发布的商品价格可能涉及低价投诉，请合理设置价格
10020055	库存余量最大值为999999
10020050	库存费用项设置错误，请查看该库存所属的品类可以传哪些费用项 http://open.mafengwo.cn/support/1218.html
10020049	产品不存在或已被删除
10020048	暂不支持附加服务
10020047	最多只能上传半年的库存
10020046	单天数据项中的必填项不全
10020045	价格只能为数字
10020044	最小限购数必须小于等于最大限购数
10020043	要操作的数据项为空
10020042	超过单次最大长度限制
10020041	参数不全，请检查必填项
10020039	请填写每单最大购买数
10020038	请填写每单最小购买数
10020037	ota_sku_id和sku_id关联错误
10020035	未选择日期或选择的日期已经清位
10020034	数据并无变更
10020032	库存不可以更改，请联系马蜂窝BD
10020031	价格最大值为999999
10020030	库存余量不能为负数
10020029	库存余量只能为正整数或0
10020028	最大/小购买数只能为整数
10020027	最大/小购买数不能大于99
10020026	价格不能为0
10020025	全部执行失败
10020024	部分执行成功
10020022	蜂抢库存锁定,如需修改请联系BD解锁
10020014	费用类型不存在
10020010	sku_id/ota_sku_id参数错误
10020004	系统异常，请联系管理员
10020003	不支持旧的库存类型
10020002	日期格式错误
10020001	没有该库存的权限