时间

修改内容

修改人

5.11

收集并新增5月份新接入供应商接口常见报错，已同步群聊-小精灵机器人

子持、吴德怀

7.30

收集并新增6、7月新接入供应商常见报错

子持

场景/表象

问题+解法

推送酒店报错/无效

【高频】上传酒店未带supplier vendor字段（必传），需询问产运获得supplier vendor参数，推送带参数

【高频】在产运配置供应商账号之前推送的酒店都需要联系产运删除重新推送，否则会有脏数据

上传酒店/房型的时候参数中包含异常特殊字符（小语种、上标）

开放平台账号未申请酒店商品API权限包，导致推送酒店报错

推送房型报错

上传房型时vendor未传

场景

问题+解法

校验规则

早餐

1. 【高频】无早的话Board传了American/Breakfast，数量0，无早需要传No而不是American，只有有餐食的情况下才会传除了No之外的参数。

2. 【高频】早餐传了no但是数量返回1，no的时候就是无早，有早餐的时候需要用其他早餐参数，不能用no。

早餐的类型（有无早餐）和份数需要一致。

多晚连住

多晚场景下，试单中返回的日历房价格为两个第一天的价格，应该返回2晚价格

询价返回的日期需要和请求中的日期一致

儿童价

1. 【高频】含儿童的rate询价返回为空

2. 儿童入住场景下，试单是1个8岁儿童，但供应商返回变成1个10岁儿童

3. 试单返回的儿童年龄固定为8导致报错

4. 儿童年龄参数传了 <int>8</int>，应该传 <Age>8</Age>

5. 儿童年龄，传了两层<ChildrenAges>包裹一个age

6. 询价没有儿童但是带了childrenage字段

询价的返回中，成人人数、儿童人数、每个儿童的年龄需要和询价请求中一致。

人数

1. 2成人1儿童入住，试单返回的房间最大人数配了2导致报错，最大入住人数应该返回3

2. 询价返回最大入住人数是0

3. 询价2成人1儿童，返回了3成人
   

询价返回的maxoccupancy字段需要大于等于请求中的成人人数和儿童人数之和

取消政策

1. 【高频】是否可取消填了false但是下面又是正常的两段式取消政策，不可取消的不需要返回cancelpolicy

2. 【高频】可取消的情况下，refundable 未传true

3. 【高频】取消政策中amount和nightcount同时存在，注意二选一，只允许使用其中一个

4. 询价返回的取消政策格式包含异常公式，报错酒店无效报价

5. 取消政策多了一个CancelPolicyInfos字段

6. 取消政策整体格式不对，只有一段

7. 第一段和第二段的startwindowhours和amout字段配置反了

8. 询价取消政策缺少<CancelPolicyInfo>节点

9. 取消政策有3段，其中有2段是一样的
   

/

参数问题

1. ratekey中包含竖杠，导致后台参数处理有问题，试单失败

2. 询价paymenttype返回了none,实际需要按照1 预付、5信用住，按照枚举值返回

3. TimeZone 返回格式不正确，返回了+9：00 实际需要格式为+09：00

4. 询价接口没有返回房型数据

5. 异常返回了RateComments字段

6. 返回内的Adults于请求的不一致 ,请求得1成人0儿童的，PaxPriceRoom 内的成人数为2成人0儿童

7. daylyinfo里面的时间格式异常，为 <Day>2024-05-28T00:00:00</Day>，正确的应该是 <Day>2016-12-24</Day>

8. ResponseTimestamp 按照毫秒返回导致报错，需要按照秒来返回

/

返回明显报错

1. 【高频】询价返回无库存

2. 【高频】询价接口报错无法找到资源，提供的服务地址错误，请确保在产运提供的供应商账号配置表格中填写的服务地址正确

3. 【高频】询价接口鉴权失败，提供的账号密码错误，请确保在产运提供的供应商账号配置表格中填写的账号密码正确

4. 【高频】询价返回数据超时，目前接口超时时间为3s

/

场景

问题+解法

儿童价

1. 试单1成人0儿童，返回儿童人数0，但是异常返回了儿童年龄导致报错

2. 【高频】儿童入住场景下，试单未返回儿童年龄

3. 试单返回的儿童年龄固定为8导致报错

人数

试单接口的maxoccupancy为成人和儿童总和，当2成人1儿童入住情况下，maxoccupancy需要是3，商家返回2导致报错

多晚连住

【高频】多晚试单接口返回的日历房价格只有一晚，试单报错，多晚需要返回多晚的日历房价格

取消政策

1. 【高频】同一个rate，询价和试单返回的退改政策不一致

参数问题

1. 试单的日历房报价中没有币种

2. 试单接口返回的时候异常返回了此房型下所有rate的信息，这边注意试单本身就是针对某一个ratekey进行的试单，只需要返回我们请求的ratekey的信息即可

3. 试单返回了询价完全相同的内容，导致试单直接报错

4. 试单返回多了minprice/mintaxprice参数

5. 试单返回没有日历房价格字段

返回明显报错

1. 试单返回报错Parameters error: RoomTypeCode does not match with RateKey

2. 【高频】询价有库存的情况下，试单返回无库存

3. 试单报错系统异常

4. 试单返回error：价格变价
   

场景

问题+解法

订单状态不一致

【高频】top接口确认完订单之后，供应商内部订单系统没有同步，查单返回的还是confirm pending，此时应该返回CONFIRMED

参数问题

下单后的查单没有返回外部订单号orderid，反而返回了两次taobaoorderid，注意查单必须要返回外部订单号

订单推送状态为已确认，但是未返回外部订单号orderid

下单接口返回的taobaoorderid和请求的不一致导致报错

返回明显报错

1. 下单超时，15.63s未返回数据

2. 查单返回报错PARA_ERROR

3. 查单返回报错ORDER NOT FOUND

问题+解法

【高频】订单没有用top接口发货

【高频】top发货接口推送不及时，必须订单一确认就及时给飞猪推送订单确发货信息

淘宝开放平台账号未申请酒店订单管理权限包导致订单发货接口调用时报错没有权限

场景

问题+解法

订单状态不一致

1. 【高频】取消成功，但查单接口仍然返回状态为confirmed

2. 【高频】订单取消之后，供应商查单返回的也是confirm pending，此时应该返回 CANCELLED

参数问题

1. 【高频】取消接口，免费取消的订单返回了cancelfee参数，免费取消时段取消费用应该为0（目前飞猪未对cancelfee参数做处理）

2. 【高频】取消接口未返回外部订单号orderid，反而返回了两次taobaoorderid

3. 查单接口返回异常未返回orderstatus

返回明显报错

取消接口报错系统异常（反复出现）