1、调用方法
Method：HTTP-POST
Url：{API_Url}/1.1/basic/addOrModify
Data_Type:json
2、系统参数
API调用参数分为系统参数和业务参数，请求时，系统参数是必传的，否则无法成功请求，业务参数由具体业务接口定义。
入参格式
| 系统参数
|
| 名称
|
类型
|
必填
|
描述
|
| apiKey |
String |
是 |
分配给供应商的唯一身份标识 |
| sign |
String |
是 |
请求签名，生成规则参见签名机制 |
| timestamp |
String |
是 |
时间戳，参见时间戳 |
3、业务参数
接口入参
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| agencyProductId |
Varchar(100) |
是 |
test10001 |
供应商产品编号：由供应商自行保证每个操作的产品都存在这个值，且该值在该供应商所有产品下无重复。 |
| groupNum |
Varchar(100) |
否 |
“0” |
支持供应商一个产品id对应多个团的情况，如不传该字段，表明只支持单个团 |
| type |
Integer |
是 |
0 |
标示供应商当前对草稿的操作类型。0：新增；1：修改 |
| basicInfo |
BasicInfo |
否 |
|
基本信息的tab，如果是新增，则必须存在 |
| recommendInfo |
RecommendInfo |
否 |
|
推荐信息的tab |
| importantInfo |
ImportantInfo |
否 |
|
重要信息的tab |
| departInfo |
DepartInfo |
否 |
|
发车信息的tab |
| budgetIncludeInfo |
BudgetIncludeInfo |
否 |
|
费用包含信息的tab |
| budgetExcludeInfo |
BudgetExcludeInfo |
否 |
|
费用不包含信息的tab |
| specialPeopleInfo |
SpecialPeopleInfo |
否 |
|
特殊人群限制的tab |
| selfChargeInfo |
SelfChargeInfo |
否 |
|
活动推荐信息的tab |
| attentionInfo |
AttentionInfo |
否 |
|
预定须知信息的tab |
| otherInfo |
OtherInfo |
否 |
|
其他信息的tab |
入参示例
{
"agencyProductId":"test10001",
"groupNum":"",
"type":0,
"basicInfo":{
"agencyProductName":"product_name_001",
"festaName":"元旦",
"mainName":"",
"lastName":"",
"catType":1,
"productMode":1,
"startCity":"",
"bookingCity":"宁波,上海",
"agencyManagerName":"",
"recommend":"",
"isDefault":0,
"productBaseScheduleId":"test10002",
"tripNum":1
},
"recommendInfo":{
"detail": {
"proType": 8,
"description": "",
"sortOrder": 1
},
"characteristic": {
"proType": 12,
"description": "",
"sortOrder": 1
},
"recommendDetails": [
{
"description": "吃的推荐信息描述",
"proType": 1,
"sortOrder": 1
},
{
"description": "住的推荐信息描述",
"proType": 2,
"sortOrder": 1
},
{
"description": "出行的推荐信息描述",
"proType": 3,
"sortOrder": 1
},
{
"description": "游玩的推荐信息描述",
"proType": 4,
"sortOrder": 1
},
{
"description": "购物的推荐信息描述",
"proType": 5,
"sortOrder": 1
},
{
"description": "娱乐的推荐信息描述",
"proType": 6,
"sortOrder": 1
},
{
"description": "赠的推荐信息描述",
"proType": 7,
"sortOrder": 1
},
{
"description": "详情的推荐信息描述",
"proType": 8,
"sortOrder": 1
},
{
"description": "特别优惠的的推荐信息描述",
"proType": 9,
"sortOrder": 1
},
{
"description": "重要提示的推荐信息描述",
"proType": 10,
"sortOrder": 1
},
{
"description": "交通信息的推荐信息描述",
"proType": 11,
"sortOrder": 1
},
{
"description": "产品特色的推荐信息描述",
"proType": 12,
"sortOrder": 1
}
]
},
"importantInfo":{
"teamType":0,
"independentTeam":1,
"isJoinGroup":0,
"joinGroupInfo":{
"joinType":1,
"joinCount":2,
"scheduleDesc":""
},
"localTourFlag":0,
"carpoolFlag":0,
"carpoolRemark":"",
"changeCarOrGuideFlag":0,
"changeRemark":"",
"updateSchemeFlag":1,
"updateRemark":""
},
"departInfo":{
"departTitle":"",
"emergencyContactInfo":"",
"autoSendNoticeFlag":0,
"departList":[{
"startPos":"发车地点",
"startTime":"HH:mm:ss",
"returnPos":"返回地点",
"remark":"备注"
}],
"pickUpFlag":0,
"pickUpType":0,
"pickUpTraffic":1,
"pickUpNotes":"",
"contactList":[{
"type":3,
"name":"联系人姓名",
"phone":"联系人电话",
"remark":"备注"
}],
"routeInfoRemark":""
},
"budgetIncludeInfo":{
"trafficInfo":{
"teamTicketFlag":0,
"teamTicketType":0,
"ticketInclueTax":0,
"trainTicketsFlag":0,
"trainTicketsList":[{
"trainTicketsType":0,
"trainSiteType":0
}],
"busFlag":0,
"busType":0,
"localBusFlag":0,
"roundTripFlag":0,
"shipFlag":0,
"shipType":1,
"shipRemark":""
},
"innerTrafficInfo":{
"innerTrafficFlag":0,
"innerTrafficType":0,
"innerTrafficRemark":"小交通描述",
"scenicCarFlag":1,
"scenicCarRemark":"景区内用车描述"
},
"visaExplain":{
"visaType":0,
"visaCost":0
},
"liveInfo":{
"liveType":0,
"hotelStar":0,
"roomCapacity":0,
"hotelList":[{
"destination":"目的地",
"hotelStar":0,
"roomCapacity":0,
"nightTimes":0
}],
"aimHotelFlag":0,
"aimHotelList":[{
"destination":"",
"nightTimes":0,
"remark":""
}]
},
"mealInfo":{
"mealType":0,
"mealRemark":""
},
"ticketFlag":0,
"ticketRemark":"",
"guideInfo":{
"guideType":0,
"guideRemark":""
},
"childStdInfo":{
"childStdType":0,
"excludeMinAge":0,
"excludeMaxAge":0,
"excludeMinHeight":0,
"excludeMaxHeight":0,
"useBedFlag":0,
"remark":""
},
"tipInfo":{
"tipFlag":0,
"tipCost":10,
"remark":""
},
"presentInfo":"",
"otherInfo":""
},
"budgetExcludeInfo":{
"innerTrafficInfo":{
"innerTrafficFlag":0,
"innerTrafficType":0,
"innerTrafficRemark":"",
"scenicCarFlag":0,
"scenicCarRemark":""
},
"airTicketTax":{
"roundTripFlag":0,
"roundTripCost":0,
"foreignTaxFlag":0,
"foreignTaxCost":0
},
"endorsement":{
"visaInfo":{
"visaType":0,
"visaCost":0
},
"personalEndorsement":0,
"teamEndorsement":0,
"permit":0,
"roundTripPermit":0
},
"roomAddBudgetFlag":0,
"roomAddBudgetRemark":"",
"ticketFlag":0,
"ticketRemark":"",
"other":"",
"supplementDetail":{
"upholdFeeFlag":0,
"governmentRegulationFlag":0,
"customsFeeFlag":1,
"extraCostFlag":0,
"personalConsumptionFlag":0,
"selfChargeFlag":0
},
"accidentInsurance":0
},
"specialPeopleInfo":{
"numMinFlag":0,
"numMinValue":0,
"numMaxFlag":0,
"numMaxValue":0,
"ageMinFlag":0,
"ageMinValue":0,
"ageMaxFlag":0,
"ageMaxValue":0,
"ageMaxDealFlag":0,
"ageMaxDealValue":0,
"ageLimitFlag":0,
"ageMinLimit":0,
"ageMaxLimit":0,
"allowForeignerFlag":0,
"areaLimitFlag":0,
"areaLimitType":0,
"areaLimitList":[{
"limitType":0,
"limitName":"江苏"
},{
"limitType":1,
"limitName":"南京"
}]
},
"selfChargeInfo":{
"shoppingList":[{
"shoppingName":"",
"businessProduct":"",
"remark":""
}],
"activeList":[{
"activeName":"",
"activeCost":0,
"activeContent":"",
"remark":""
}],
"remark":""
},
"attentionInfo":{
"selfDrivingFlag":0,
"selfDrivingRemark":"",
"paymentAttention":{
"type":0,
"hourLimit":0
},
"groupCancelFlag":0,
"groupCancelNumLimit":1,
"groupCancelDayLimit":1,
"leaveTeamFlag":0,
"liquidatedDamagesFlag":0,
"liquidatedCost":100,
"saleNoteFlag":0,
"allowPeopleType":0,
"selfVisaNoteFlag":0,
"extraNoteList":[],
"timeDelayNoteFlag":0,
"bookingCannelGroupNoteFlag":0,
"orderCannelGroupNoteFlag":0,
"airTicketNoteFlag":0,
"consumeBlameNoteFlag":0,
"specialNoteFlag":0,
"flightNoteFlag":0,
"guaranteeGoldNoteFlag":0,
"liveAttentionInfo":{
"type":0,
"washFlag":0
},
"mealAttentionFlag":0,
"foodNum":0,
"differenceAttentionFlag":0,
"differenceAttentionType":0,
"highRiskTips": "0,1,2,3"
}
"otherInfo:"{
"operateAttention":"产品注意事项",
"warnAttention":"温馨提示"
}
}
接口出参
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| success |
boolean |
是 |
true |
是否执行成功 |
| returnCode |
int |
是 |
000000 |
返回码 |
| errorMsg |
Varchar(256) |
否 |
执行成功 |
执行结果 |
| data |
BaseInfoResultDate |
否 |
|
执行结果 |
出参示例
{
"success":true,
"returnCode":000000,
"errorMsg":"执行成功",
"data":{
"basicInfoResult":{
"success":true,
"msg":"",
"errorCode":000000
},
"recommendInfoResult":{
"success":true,
"msg":"",
"errorCode":000000
},
"importantInfoResult":{
"success":true,
"msg":"",
"errorCode":000000
},
"departInfoResult":{
"success":true,
"msg":"",
"errorCode":000000
},
"budgetInclueResult":{
"success":true,
"msg":"",
"errorCode":000000
},
"budgetExclueResult":{
"success":true,
"msg":"",
"errorCode":000000
},
"specialInfoResult":{
"success":true,
"msg":"",
"errorCode":000000
},
"selfChargeResult":{
"success":true,
"msg":"",
"errorCode":000000
},
"attentionReslut":{
"success":true,
"msg":"",
"errorCode":000000
}
}
}
4、自定义数据类型说明
BasicInfo（基础信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| agencyProductName |
Varchar(256) |
是 |
product_name_001 |
供应商产品名称 |
| festaName |
Varchar(8) |
是 |
元旦 |
途牛产品名称中的节日 |
| mainName |
Varchar(128) |
是 |
|
途牛产品名称中的主名称 |
| lastName |
Varchar(100) |
是 |
|
途牛产品名称中的副名称 |
| catType |
Integer |
否 |
|
产品类型： 1、周边2、国内长线3、国内当地参团 4、出境当地参团5、出境短线6、出境长线新增是存在，修改时不存在
|
| productMode |
Integer |
是 |
|
采购方式：1、打包产品2、机票+地接3、火车票+地接
|
| startCity |
Varchar(128) |
否 |
|
出发城市 |
| bookingCity |
Varchar(1024) |
否 |
宁波,上海 |
预定城市名称，多个以逗号分割 |
| agencyManagerName |
Varchar(45) |
是 |
|
供应商产品负责人 |
| recommend |
Varchar(128) |
否 |
|
特色词（最好在6个单词以内） |
| isDefault |
Integer |
否 |
0 |
是否默认行程，1表示默认行程，0表示多行程,默认为1,默认行程 |
| productBaseScheduleId |
Varchar(128) |
否 |
test10002 |
供应商基本产品编号,如果isDefault为0,为必填 |
| tripNum |
Integer |
否 |
1 |
行程排序，默认行程行程排序为0 |
RecommendInfo（推荐信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| detail |
RecommendRecord |
否 |
|
详情（移到recommendDetails中，不在解析该字段） |
| characteristic |
RecommendRecord |
否 |
|
产品特色推荐（移到recommendDetails中，不在解析该字段） |
| recommendDetails |
RecommendRecord[] |
是 |
|
产品推荐类型为1-12的全部信息 |
ImportantInfo（重要信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| teamType |
Integer |
是 |
|
发团地点：0:出发地成团,1:目的地成团 |
| independentTeam |
Integer |
是 |
|
组团形式：1:途牛独家发团,0:联合发团 2:无 |
| isJoinGroup |
Integer |
是 |
|
是否拼团：0：非行程中拼团，1：行程中拼团 |
| joinGroupInfo |
JoinGroupInfo |
否 |
|
拼团附注信息，仅当行程中拼团此值存在 |
| localTourFlag |
Integer |
是 |
0 |
是否存在当地参团人员：0：不存在：1：存在 |
| carpoolFlag |
Integer |
是 |
0 |
是否拼车：0：否，1：是 |
| carpoolRemark |
Varchar(128) |
否 |
|
拼车备注。如果不拼车，此值不存在 |
| changeCarOrGuideFlag |
Integer |
是 |
0 |
是否更换当地车或导游：0：否，1：是 |
| changeRemark |
Varchar(128) |
否 |
|
换车/导游备注，如果不换，此值不存在 |
| updateSchemeFlag |
Integer |
是 |
0 |
升级行程：0：不升级，1：升级 |
| updateRemark |
Varchar(128) |
否 |
|
升级备注，当不升级行程时此值不存在 |
DepartInfo（发车信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| departTitle |
Varchar(128) |
否 |
|
发车基本信息 |
| emergencyContactInfo |
Varchar(128) |
否 |
|
紧急联系人及电话 |
| autoSendNoticeFlag |
Integer |
是 |
0 |
自动发送出团通知：0：否，1：是 |
| departList |
DepartDetail[] |
否 |
|
发车信息详情 |
| pickUpFlag |
Integer |
是 |
0 |
接送机（站）服务：0：不提供，1：提供 2：有条件提供 |
| pickUpType |
Integer |
否 |
0 |
接送服务：1：接送都含2：只接不送3：只送不接 |
| pickUpTraffic |
Varchar(16) |
否 |
1,2 |
指定交通方式：:1:飞机，2：火车，逗号分割 |
| pickUpNotes |
Varchar(256) |
否 |
|
接车信息备注（条件备注） |
| contactList |
ContactDetail[] |
否 |
|
联系人信息 |
| routeInfoRemark |
Varchar(256) |
否 |
|
线路信息备注 |
BudgetIncludeInfo（费用包含信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| trafficInfo |
TrafficDetail |
否 |
|
费用包含的交通信息 |
| innerTrafficInfo |
InnerTrafficInfo |
否 |
|
费用包含的小交通信息 |
| visaExplain |
VisaExplain |
否 |
|
费用包含的签证，当产品类型为出境时此值存在 |
| liveInfo |
LiveDetail |
否 |
|
费用包含住宿信息 |
| mealInfo |
MealDetail |
否 |
|
费用包含用餐信息用餐支持：中式餐或自助餐或特色餐，自由活动期间用餐请自理；如因自身原因放弃用餐，则餐费不退这个条件 ，则存在此字段 |
| ticketFlag |
Integer |
是 |
0 |
是否包含门票：0：不包含，1：包含 |
| ticketRemark |
Varchar(256) |
否 |
|
门票说明，包含门票是此值存在 |
| guideInfo |
GuideDetail |
否 |
|
费用包含的导服信息 |
| childStdInfo |
ChildStdDetail |
否 |
|
费用包含的儿童价标准 |
| tipInfo |
TipDetail |
否 |
|
费用包含的小费信息 |
| presentInfo |
Varchar(256) |
否 |
|
费用包含的赠送信息 |
| otherInfo |
Varchar(256) |
否 |
|
费用包含的其他信息 |
BudgetExcludeInfo（费用不包含信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| innerTrafficInfo |
InnerTrafficInfo |
否 |
|
费用不包含的小交通信息 |
| airTicketTax |
AirTicketTaxDetail |
否 |
|
机票税信息 |
| endorsement |
Endorsement |
否 |
|
签证/签注信息 |
| roomAddBudgetFlag |
Integer |
是 |
|
是否包含单房差：0：不包含，1：包含 |
| roomAddBudgetRemark |
Varchar(256) |
否 |
|
单房差说明，仅在包含单房差信息时存在 |
| ticketFlag |
Integer |
是 |
0 |
是否包含门票：0：不包含，1：包含 |
| ticketRemark |
Varchar(256) |
否 |
|
门票说明，包含门票是此值存在 |
| other |
Varchar(256) |
否 |
|
其他信息 |
| supplementDetail |
SupplementDetail |
否 |
|
补充信息 |
| accidentInsurance |
Integer |
是 |
|
是否存在旅游意外险：0：不存在，1：存在 |
SpecialPeopleInfo（特殊人群限制信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| numMinFlag |
Integer |
是 |
|
是否存在单订单出游人数少于？人，需现询确认：0：不存在，1：存在 |
| numMinValue |
Integer |
否 |
0 |
最少人数。存在但订单最小人数限制时存在 |
| numMaxFlag |
Integer |
是 |
|
是否存在单订单出游人数大于？人，需现询确认：0：不存在，1：存在 |
| numMaxValue |
Integer |
否 |
0 |
最大人数。存在但订单最大人数限制时存在 |
| ageMinFlag |
Integer |
是 |
|
是否存在出游人年龄小于？岁（含），不接收：0：不存在，1：存在 |
| ageMinValue |
Integer |
否 |
0 |
最小年龄。存在出游人年龄最小限制时存在 |
| ageMaxFlag |
Integer |
是 |
|
是否存在出游人年龄超过？岁（含），不接收：0：不存在，1：存在 |
| ageMaxValue |
Integer |
否 |
0 |
最大年龄。存在出游人年龄最大限制时存在 |
| ageMaxDealFlag |
Integer |
是 |
|
是否存在出游人年龄超过？岁（含），需要签署健康协议：0：不存在，1：存在 |
| ageMaxDealValue |
Integer |
否 |
0 |
年龄。存在出游人年龄最大限制须签署协议时存在 |
| ageLimitFlag |
Integer |
是 |
0 |
年龄限制，0：无限制，1：存在限制 |
| ageMinLimit |
Integer |
否 |
0 |
年龄最小限制， 存在年龄限制时有意义 |
| ageMaxLimit |
Integer |
否 |
0 |
年龄最大限制， 存在年龄限制时有意义 |
| allowForeignerFlag |
Integer |
是 |
0 |
是否不接受外籍游客：0：是，1：否 |
| areaLimitFlag |
Integer |
是 |
|
是存在地域限制：0：不存在，1：存在 |
| areaLimitType |
Integer |
否 |
0 |
0：包含的地域存在限制，1：不包含的地域存在限制；当不存在地域限制时，此值无意义 |
| areaLimitList |
AreaLimitDetail[] |
否 |
|
限制的地域列表 |
SelfChargeInfo（活动信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| shoppingList |
ShoppingDetail[] |
否 |
|
购物店信息 |
| activeList |
ActiveDetail[] |
否 |
|
活动推荐 |
| remark |
Varchar(1024) |
否 |
|
说明 |
AttentionInfo（提示信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| selfDrivingFlag |
Integer |
是 |
|
是否自驾游手动编写内容，0：否，1：是 |
| selfDrivingRemark |
Varchar(1024) |
否 |
|
自驾游手动编写的内容，仅在selfDrivingFlag为1时，此字段存在意义 |
| paymentAttention |
PaymentAttention |
否 |
|
（出境）付款的预定须知 |
| groupCancelFlag |
Integer |
是 |
0 |
（出境）是否在此团收客人数不足？人时，取消行程：0：否，1：是 |
| groupCancelNumLimit |
Integer |
否 |
|
（出境）取消行程的最小人数限制，仅当允许取消行程时，此值有意义 |
| groupCancelDayLimit |
Integer |
否 |
|
（出境）取消行程的通知提前天数，仅当允许取消行程时，此值有意义 |
| leaveTeamFlag |
Integer |
是 |
|
（出境）团队游览中是否允许擅自离队：0：允许，1：不允许 |
| liquidatedDamagesFlag |
Integer |
否 |
|
（出境）擅自离队是否需要支付违约金，0：否，1：是，尽在不允许擅自离队时存在意义 |
| liquidatedCost |
Integer |
否 |
|
（出境）需要支付的违约金金额，仅在需要支付违约金时有意义 |
| saleNoteFlag |
Integer |
是 |
0 |
（出境）是否包含销签说明：0：不包含，1：包含 |
| allowPeopleType |
Integer |
是 |
0 |
（出境）允许人群：0：全部，1：只接受持各地签发的中国大陆因私护照客人，不接受港澳台及外籍客人预订2：只接受持各地签发的港澳通行证客人，不接受港澳台及外籍客人预订 |
| selfVisaNoteFlag |
Integer |
是 |
0 |
（出境）自备签证说明：0：不存在，1：存在 |
| extraNoteList |
Varchar[] |
否 |
|
附加提示 |
| timeDelayNoteFlag |
Integer |
是 |
0 |
（出境）因甲方原因发生拒签、延时交签造成本次出境行程变更或取消的，乙方不承担违约责任，甲方需承担申办 签证费用____/人 是否存在，0：不存在，1：存在 |
| bookingCannelGroupNoteFlag |
Integer |
是 |
0 |
（出境）出签前，顾客取消行程说明是否存在：0：不存在，1：存在 |
| orderCannelGroupNoteFlag |
Integer |
是 |
0 |
（出境）出签后，顾客取消行程说明是否存在：0：不存在，1：存在 |
| airTicketNoteFlag |
Integer |
是 |
0 |
（出境）机票说明是否存在：0：不存在，1：存在 |
| consumeBlameNoteFlag |
Integer |
是 |
0 |
（出境）甲方原因无法出游乙方免责说明是否存在：0：不存在，1：存在 |
| specialNoteFlag |
Integer |
是 |
0 |
（出境）特别提醒说明是否存在：0：不存在，1：存在 |
| flightNoteFlag |
Integer |
是 |
0 |
（出境）航班信息说明是否存在：0：不存在，1：存在 |
| guaranteeGoldNoteFlag |
Integer |
是 |
0 |
（出境）担保金说明是否存在：0：不存在，1：存在 |
| liveAttentionInfo |
LiveAttentionDetail |
否 |
|
（非出境）住宿说明 |
| mealAttentionFlag |
Integer |
是 |
0 |
是否包含用餐说明：0：不包含，1：包含 |
| foodNum |
Integer |
否 |
0 |
？道菜，仅当包含用餐说明是存在 |
| differenceAttentionFlag |
Integer |
是 |
0 |
（非出境）是否存在差价说明：0：不存在，1：存在备注：存在插件说明，则必须支持1. （1）如遇国家政策性调整门票、交通价格等，按调整后的实际价格结算。2. （2）赠送项目因航班、天气等不可抗因素导致不能赠送的，费用不退。3. 这两个必要因素 |
| differenceAttentionType |
Integer |
否 |
|
（非出境）差价说明：0：景点门票为旅行社折扣价，如持优待证件（如老年证、军官证、教师证等）产生折扣退费的，按实际差额退还，1：云南当地景点实行套票制，如持优待证件（如老年证、军官证、教师证等）或没有游览完行程景点，产生差价不退2：本线路价格为团队行程综合旅游报价，持有任何优惠证件的游客均不再享受景区门票的优惠政策。仅在包含差价说明是存在意义 |
| highRiskTips |
Varchar(64) |
否 |
0,1,2,3 |
高危项提示,： 0，漂流1，浮潜3，高原4，快艇5，潜水6，滑雪 多个以逗号分割 |
OtherInfo（其他信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| operateAttention |
Varchar(5000) |
否 |
|
产品注意事项 |
| warnAttention |
Varchar(5000) |
否 |
|
温馨提示 |
TrafficDetail（交通信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| teamTicketFlag |
Integer |
是 |
0 |
交通包含团队经济舱机票,0：不包含，1：包含 |
| teamTicketType |
Integer |
是 |
0 |
机票类型：0：往返，1：去程，2：回程，3：中间段如果交通不包含团队经济舱机票，则此字段不存在 |
| ticketIncludeTax |
Integer |
是 |
0 |
是否含税：0：不含税，1：含税，2：其他 |
| trainTicketsFlag |
Integer |
是 |
0 |
交通包含火车票,0：不包含，1：包含 |
| trainTicketsList |
TrainTicketsDetail[] |
否 |
|
如果不包含火车票，则字段不存在 |
| busFlag |
Integer |
是 |
0 |
交通包含旅游巴士,0：不包含，1：包含 |
| busType |
Integer |
是 |
0 |
汽车票类型：0：往返，1：全程，2：去程，3：回程如果交通不包含旅游巴士，则此字段不存在 |
| localBusFlag |
Integer |
是 |
0 |
交通包含当地旅游巴士,0：不包含，1：包含 |
| roundTripFlag |
Integer |
是 |
0 |
交通包含往返车票：0：不包含，1：包含 |
| shipFlag |
Integer |
是 |
0 |
交通包含船票,0：不包含，1：包含 |
| shipType |
Integer |
是 |
0 |
船票类型：0：往返，1：全程，2：去程，3：回程如果交通不包含船票，则此字段不存在 |
| shipRemark |
Varchar(256) |
否 |
|
船票的备注信息 |
TrainTicketsDetail（火车票信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| trainTicketsType |
Integer |
是 |
0 |
火车票类型 0:往返,1:去程,2:回程,3:中间段 |
| trainSiteType |
Integer |
是 |
0 |
坐席类型：0：-------，1：动车一等座，2：（动车二等座），3：（硬座），4：（软座），5：（硬卧），6：（软卧），7：（高铁），8：（城际列车一等座），9：（城际列车二等座 |
PaymentAttention（支付提示信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| type |
Integer |
是 |
0 |
类型：:0：为了确保您能够按时出行，产品确认后请在？小时内付款，同时请按要求尽快提供出游所需的材料并签订出境旅游合同。，1：为了确保您能够按时出行，产品确认后请在？小时内付预付款签订报名意向书，同时请按要求尽快提供出游所需的材料，并于出团前5个工作日交齐尾款并签订出境旅游合同。2：预订时请告之您的出游人数、出发日期、住宿、用餐标准、以及您的特殊需求。,0：不包含，1：包含 |
| hourLimit |
Integer |
否 |
0 |
时间限制，当type不为2是存在 |
LiveAttentionDetail（住宿提示信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| type |
Integer |
是 |
0 |
拼房选择：0：不愿拼房，1：与亲友加床 |
| washFlag |
Integer |
是 |
0 |
是否提供洗漱用品：0：不提供，1：提供 |
JoinGroupInfo（拼团附注信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| joinType |
Integer |
是 |
|
拼团次数类型：准确值为0，估算值为1 |
| joinCount |
Integer |
是 |
|
拼团次数 |
| scheduleDesc |
Varchar(1024) |
|
|
拼团备注，如果拼团次数为估算值，此字段不存在 |
DepartDetail（发车信息详情）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| startPos |
Varchar(64) |
是 |
|
发车地点 |
| startTime |
Varchar(19) |
是 |
|
发车时间 HH:mm:ss |
| returnPos |
Varchar(64) |
是 |
|
返回地点 |
| remark |
Varchar(256) |
否 |
|
备注 |
ContactDetail（联系人信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| type |
Integer |
是 |
|
联系人类型：5：送站/机联系人，3：接站/机联系人，6：导游，1：出发地联系人，2：当地联系人，4：其他 |
| name |
Varchar(64) |
是 |
|
联系人姓名 |
| phone |
Varchar(16) |
是 |
|
联系人电话 |
| remark |
Varchar(256) |
否 |
|
备注 |
InnerTrafficInfo（小交通信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| innerTrafficFlag |
Integer |
是 |
|
包含小交通：0：不包含，1：包含 |
| innerTrafficType |
Integer |
是 |
|
小交通类型：0：往返，1：去程，2：回程， 如果交通不包含小交通，则此字段不存在 |
| innerTrafficRemark |
Varchar(256) |
否 |
|
小交通描述（从某地到某地） |
| scenicCarFlag |
Integer |
是 |
|
是否存在景区内用车，0：不存在，1：存在 |
| scenicCarRemark |
Varchar(256) |
否 |
|
景区内用车描述 |
LiveDetail（费用包含住宿信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| liveType |
Integer |
是 |
0 |
住宿类型：0：行程所列酒店，1：星级酒店，2：酒店，3：当地酒店，4：目的地星级酒店 |
| hotelStar |
Integer |
否 |
0 |
酒店星级，当liveType为1,3时此值有存在 |
| roomCapacity |
Integer |
否 |
0 |
房间标准容量（几人间），当liveType是1,2,3时此值有效 |
| hotelList |
HotelDetail[] |
否 |
|
目的地酒店信息，仅当liveType为4时此字段存在 |
| aimHotelFlag |
Integer |
是 |
0 |
目的地邮轮/酒店等信息是否存在，0：不存在，1：存在 |
| aimHotelList |
AimHotelDetail[] |
否 |
|
目的地邮轮/酒店等信息详情，仅当flag存在时有意义 |
HotelDetail（目的地酒店信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| destination |
Varchar(64) |
是 |
|
目的地 |
| hotelStar |
Integer |
是 |
|
酒店星级 0:普通,:3星级,4:4星级,5:5星级,9:----（即未知） |
| roomCapacity |
Integer |
否 |
|
房间标准容量（几人间） |
| nightTimes |
Integer |
否 |
|
入住多少晚 |
AimHotelDetail（邮轮/酒店等信息详情）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| destination |
Varchar(64) |
是 |
|
目的地 |
| nightTimes |
Integer |
否 |
|
入住多少晚 |
| remark |
Varchar(256) |
否 |
|
备注 |
VisaExplain（签证信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| visaType |
Integer |
是 |
0 |
签证类型：0：免签证，1：团队旅游签证，2：落地签费/人（现付）3: 落地签费/人（预付） |
| visaCost |
Integer |
否 |
0 |
签证费用 元/人,如果免签证，此字段不存在 |
MealDetail（费用包含中的用餐信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| mealType |
Integer |
是 |
0 |
是否包含飞机上用餐：0：不包含，1：包含 |
| mealRemark |
Varchar(256) |
否 |
|
用餐说明 |
GuideDetail（导服信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| guideType |
Integer |
是 |
0 |
导服类型：0：当地中文导游，1：专职中文领队兼导游（境外），全程陪同中文导游（境内），2：专职领队和当地中文导游（境外），全陪和当地中文导游（境内） |
| guideRemark |
Varchar(256) |
否 |
|
导服说明 |
ChildStdDetail（儿童价标准信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| childStdType |
Integer |
是 |
0 |
儿童价标准类型：0：年龄限制，1：身高限制，2：特说说明 |
| excludeMinAge |
Integer |
否 |
0 |
当Type为0是，不包含的最小的儿童年龄 |
| excludeMaxAge |
Integer |
否 |
0 |
当Type为0是，不包含的最大的儿童年龄 |
| excludeMinHeight |
Integer |
否 |
0 |
当Type为1是，包含的最小的儿童身高 |
| excludeMaxHeight |
Integer |
否 |
0 |
当Type为1是，包含的最大的儿童身高 |
| useBedFlag |
Integer |
否 |
0 |
是否占床：0：默认不填（------），1：不占床，此值在type为0,1时有效 |
| remark |
Varchar(1024) |
否 |
|
备注 |
TipDetail（小费信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| tipFlag |
Integer |
是 |
0 |
是否存在司机导游小费：0：不存在，1存在 |
| tipCost |
Integer |
否 |
|
当存在小费时的价格 元/人 |
| remark |
Varchar(256) |
否 |
|
当存在小时费的说明 |
AirTicketTaxDetail（机票税信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| roundTripFlag |
Integer |
是 |
|
往返机票税：0：不存在，1：存在 |
| roundTripCost |
Integer |
否 |
0 |
当存在往返机票税时的价格 元/人 |
| foreignTaxFlag |
Integer |
是 |
|
境外机场回程机场税：0：不存在，1：存在 |
| foreignTaxCost |
Integer |
否 |
0 |
当存在境外机场回程机场税的价格 元/人 |
Endorsement（签注信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| visaInfo |
VisaExplain |
否 |
|
签证信息 |
| personalEndorsement |
Integer |
是 |
|
是否个人签证，自行办理，0：否，1：是 元/人 |
| teamEndorsement |
Integer |
是 |
|
是否团队签证，自行办理，0：否，1：是 |
| permit |
Integer |
是 |
|
是否存在港澳通行证置证费：0：不存在，1：存在 |
| roundTripPermit |
Integer |
是 |
|
是否存在往来台湾通行证置证费：0：不存在，1：存在 |
SupplementDetail（补充信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| upholdFeeFlag |
Integer |
是 |
|
是否存在丽江古城维护费80元/人：0不存在，1存在(国内存在) |
| governmentRegulationFlag |
Integer |
是 |
|
是否存在海南政府调节金：0不存在，1存在(国内存在) 元/人 |
| customsFeeFlag |
Integer |
是 |
|
是否存在出入境个人物品海关征税，超重行李的托运费、保管费，0：不存在，1：存在(出境存在) |
| extraCostFlag |
Integer |
是 |
|
是否存在港澳通行证置证费：0：不存在，1：存在 |
| roundTripPermit |
Integer |
是 |
|
因交通延阻、战争、政变、罢工、天气、飞机机器故障、航班取消或更改时间等不可抗力原因所引致的额外费用，0：不存在，1：存在 |
| personalConsumptionFlag |
Integer |
是 |
|
酒店内洗衣、理发、电话、传真、收费电视、饮品、烟酒等个人消费，0：不存在，1：存在 |
| selfChargeFlag |
Integer |
是 |
|
当地参加的自费以及以上“费用包含”中不包含的其它项目0：不存在，1：存在 |
AreaLimitDetail（地域限制信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| limitType |
Integer |
是 |
|
限制类型：0：省，1：市 |
| limitName |
Varchar(64) |
是 |
|
名称（如果是省则填省的名字，市则填市的名字） 元/人 |
RecommendRecord（推荐信息详情）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| proType |
Integer |
是 |
12 |
推荐类型，1为吃，2为住，3为行，4为游，5为购，6为娱，7为赠，8详情，9特别优惠，10重要提示，11交通信息，12表示产品特色 |
| description |
Varchar |
是 |
推荐信息描述 |
内容详情 |
| sortOrder |
Integer |
否 |
1 |
排序(出境存在) |
ShoppingDetail（购物店信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| shoppingName |
Varchar(256) |
是 |
|
购物店名称 |
| businessProduct |
Varchar(256) |
是 |
|
营业产品 |
| remark |
Varchar(256) |
否 |
|
说明 |
ActiveDetail（活动信息）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| activeName |
Varchar(256) |
否 |
|
活动名称 |
| activeCost |
Integer |
否 |
0 |
参考价格 |
| activeContent |
Varchar(256) |
否 |
|
活动内容 |
| remark |
Varchar(256) |
否 |
|
备注信息 |
BaseInfoResultDate（基础信息返回结果）
| 名称
|
类型
|
必填
|
示例值
|
描述
|
| basicInfoResult |
CommonResult |
否 |
|
基础信息执行结果 |
| recommendInfoResult |
CommonResult |
否 |
|
推荐信息执行结果 |
| importantInfoResult |
CommonResult |
否 |
|
重要信息执行结果 |
| departInfoResult |
CommonResult |
否 |
|
发车信息执行结果 |
| budgetInclueResult |
CommonResult |
否 |
|
费用包含执行结果 |
| budgetExclueResult |
CommonResult |
否 |
|
费用不包含执行结果 |
| specialInfoResult |
CommonResult |
否 |
|
特殊人群执行结果 |
| selfChargeResult |
CommonResult |
否 |
|
活动信息执行结果 |
| attentionReslut |
CommonResult |
否 |
|
预定须知执行结果 |
5、常见问题
| API返回码
|
问题描述
|
解决方案
|
备注
|
| 231008 |
入参异常 |
检查入参格式是否正确及必填参数是否传入 |
|
| 231008 |
入参异常 |
检查basicInfo参数，如果是新增产品，则必须传入此参数 |
|
