日历库存批量更新

该接口用于商家批量更新马蜂窝旅行商城产品“新库存”结构下与日历相关的库存价格等信息;
如果日期为未增加过的日期,会自动新增库存,此时price,remain,min_num,max_num四个参数均为必填项
请求URL

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

请求Action

action:sales.sku.calendar.batch.update

请求参数
参数名称 参数类型 必填 示例 描述
[] array 0 需要更新的sku,单次最多1个sku
calendar_items array date_arr[] 日历库存每天数据,天数最多180天,单次最多540条数据(目前单天数据对应最多的费用项为3个:成人、儿童、单房差)
{} object 0 单天数据项
└ max_num int 10 最大购买数
└ min_num int 1 最小购买数
└ remain int 50 日历库存余量
└ price number 2000 售卖价格
└ price_type int 8 费用项 具体说明请见 费用类型说明表
└ date date 2018-05-10 日期
└ ota_sku_id string S123335 外部商家编码,马蜂窝sku_id与外部商家编码二选一
└ sku_id int 247801 马蜂窝sku_id,马蜂窝sku_id与外部商家编码二选一
响应参数
参数名称 参数类型 示例 描述
success array success_sku_arr[] 执行成功的sku
{} object 0 items
└ ota_sku_id string S123335 马蜂窝sku_id,马蜂窝sku_id与外部商家编码请求接口是传的哪个,哪个有值。
└ sku_id int 2478001 马蜂窝sku_id,马蜂窝sku_id与外部商家编码请求接口是传的哪个,哪个有值。
fail array fail_sku_arr[] 执行失败的sku
{} object 0 items
└ sku_id int 2478001 马蜂窝sku_id,马蜂窝sku_id与外部商家编码请求接口是传的哪个,哪个有值。
└ ota_sku_id string s12335 马蜂窝sku_id,马蜂窝sku_id与外部商家编码请求接口是传的哪个,哪个有值。
└ errno int 10020002 单个错误码
└ message string 日期格式错误 单个错误信息
响应示例
{
    "success":[
        {
            "ota_sku_id":"S123335",
            "sku_id":"2478001"
        }
    ],
    "fail":[
        {
            "sku_id":"2478001",
            "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 没有该库存的权限
马蜂窝旅游小管家
为您免费提供目的地旅游咨询服务
出行基本信息
联系人信息
换一换
返回顶部
意见反馈
页面底部