发单接口
一、接口名称:
issueOrder
二、输入参数:
| 父节点 | 名称 | 编码 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|
| 请求者信息 | requestor | 是 | |||
| requestor | 版本号 | invoker | string | 是 | |
| requestor | 操作人名称 | operatorName | string | 是 | |
| requestor | 操作IP | opClientIP | string | 是 | |
| requestor | 用户ID | userId | int | 是 | |
| requestor | 语言 | languageType | string | 是 | |
| 版本号 | version | String | 否 | 传入2时候走新版,使用新版代理通订单号替换之前代理通订单号,如果接入直连订单,必须使用版本2 | |
| issueOrder | IssueOrderEntity | 是 | |||
| IssueOrderEntity | 供应商ID | supplierId | int | 是 | |
| IssueOrderEntity | 代理通订单ID | dltOrderId | string | 是 | |
| 新版代理通订单号 | newDltOrderId | String | 否 | 输入版本号2时候必填 | |
| IssueOrderEntity | 销售方订单ID | orderId | string | 是 | |
| IssueOrderEntity | 订单类型 | orderType | String | 是 | N-新订,M-修改,C-取消,D-续住 |
| IssueOrderEntity | 房费付款方式 | roomPaymentType | int | 是 | 0-我司预付,1-我司挂账 |
| IssueOrderEntity | 杂费付款方式 | exPaymentType | int | 是 | 0-客人自理,1-我司预付,2-我司挂账 |
| IssueOrderEntity | 客人姓名 | clientName | string | 是 | |
| IssueOrderEntity | 客人联系方式 | ContactInformation | string | 是 | |
| IssueOrderEntity | 订单对应静态信息 | staticInfo | HotelAndRoomStaticEntity | 是 | |
| HotelAndRoomStaticEntity | 酒店ID | hotelId | string | 是 | |
| HotelAndRoomStaticEntity | 酒店名称 | hotelName | string | 是 | |
| HotelAndRoomStaticEntity | 酒店英文名 | hotelEName | string | 是 | |
| HotelAndRoomStaticEntity | 酒店地址 | hotelAddress | string | 否 | |
| HotelAndRoomStaticEntity | 酒店英文地址 | hotelAddressEn | string | 否 | |
| HotelAndRoomStaticEntity | 房型ID | roomId | string | 是 | |
| HotelAndRoomStaticEntity | 房型名称 | roomName | string | 是 | |
| HotelAndRoomStaticEntity | 房型英文名称 | roomEName | string | 否 | |
| HotelAndRoomStaticEntity | 基础房型名称 | basicRoomName | string | 是 | |
| HotelAndRoomStaticEntity | 床型 | bedType | string | 否 | |
| IssueOrderEntity | 订单备注 | remark | string | 是 | |
| IssueOrderEntity | 预订说明 | bookDescription | String | 否 | |
| IssueOrderEntity | 发单类型 | issueType | String | 是 | 0-Ebk,1-传真,2-Email,5-PMS |
| IssueOrderEntity | 传真发单模板号 | faxFormatNo | int | 是 | 1,2,3,4,5,9 |
| IssueOrderEntity | 收件人邮箱或者Fax | receiverFaxOrEmail | string | 是 | 发单方式为1或2是必传 |
| IssueOrderEntity | 发单人信息 | senderInfo | ContactsEntity | 是 | |
| ContactsEntity | 发单方名称 | name | string | 是 | |
| ContactsEntity | 发单方传真号 | fax | string | 是 | issueType=5&& faxFormatNo=5时必传 |
| ContactsEntity | 发单方邮箱 | string | 是 | (issueType=5&& faxFormatNo=5)or issueType=2时必传 | |
| ContactsEntity | 发单方联系方式 | contacts | string | 是 | |
| IssueOrderEntity | 发单人BID号码 | bIDCode | string | 是 | issueType=5&& faxFormatNo=5时必传 |
| IssueOrderEntity | 接单人信息 | receiverInfo | ContactsEntity | 是 | |
| ContactsEntity | 接单方名称 | name | string | 是 | |
| ContactsEntity | 接单方传真号 | fax | string | 是 | issueType=5&& faxFormatNo=5时必传 |
| ContactsEntity | 接单方邮箱 | string | 是 | (issueType=5&& faxFormatNo=5)or issueType=2时必传 | |
| ContactsEntity | 接单方联系方式 | contacts | string | 是 | |
| IssueOrderEntity | 入住时间 | checkinDate | datetime | 是 | |
| IssueOrderEntity | 离店时间 | checkoutDate | datetime | 是 | |
| IssueOrderEntity | 币种 | currency | string | 是 | CNY,USD等 |
| IssueOrderEntity | 发单总金额 | sendAmount | decimal | 是 | |
| IssueOrderEntity | 间数 | quantity | int | 是 | |
| IssueOrderEntity | 是否隐藏房费 | IsHideRoomAmount | 是 | F-否,T-是,C-采购编码发单 | |
| ArrivalRoomEntity | 每日房价列表 | arrivalRoomList | list |
是 | |
| ArrivalRoomEntity | 价格日期 | effectDate | datetime | 是 | |
| ArrivalRoomEntity | 餐食类型 | mealType | int | 是 | 4早餐 int转换二进制,第一位是早餐,第二位是午餐,第三位是晚餐 每一位1代表包含,0代表不包含 |
| ArrivalRoomEntity | 早餐 | breakfast | string | 是 | 早餐的描述 |
| ArrivalRoomEntity | 早餐数 | breakfastNum | int | 是 | |
| ArrivalRoomEntity | 币种 | currency | string | 是 | |
| ArrivalRoomEntity | 采购房价 | agreementPrice | decimal | 是 | |
| ArrivalRoomEntity | 采购编码 | purchaseCode | string | 是 | IsHideRoomAmount=C时必传 |
示例: 请使用version=2版本
{
"requestor": {
"invoker": "String",
"operatorName": "String",
"opClientIP": "String",
"userId": 0,
"languageType": "String"
},
"issueOrder": {
"supplierId": 0,
"dltOrderId": "String",
"orderId": "String",
"orderType": "String",
"roomPaymentType": 0,
"exPaymentType": 0,
"clientName": "String",
"contactInformation": "String",
"staticInfo": {
"cityId": "String",
"cityName": "String",
"cityEName": "String",
"hotelId": "String",
"hotelName": "String",
"hotelEName": "String",
"hotelAddress": "String",
"hotelAddressEn": "String",
"roomId": "String",
"roomName": "String",
"roomEName": "String",
"basicRoomName": "String",
"bedType": "String"
},
"remarks": "String",
"bookDescription": "String",
"issueType": "String",
"faxFormatNo": 0,
"receiverFaxOrEmail": "String",
"senderInfo": {
"name": "String",
"tel": "String",
"fax": "String",
"email": "String",
"contacts": "String"
},
"bIDCode": "String",
"receiverInfo": {
"name": "String",
"tel": "String",
"fax": "String",
"email": "String",
"contacts": "String"
},
"checkinDate": "/Date(1638782068133+0800)/",
"checkoutDate": "/Date(1638782068133+0800)/",
"currency": "String",
"sendAmount": 0,
"quantity": 0,
"arrivalRoomList": [
{
"effectDate": "/Date(1638782068133+0800)/",
"mealType": 0,
"breakfast": "String",
"breakfastNum": 0,
"currency": "String",
"agreementPrice": 0,
"purchaseCode": "String"
}
],
"isHideRoomAmount": "String",
"certificateEntities": [
{
"clientName": "String",
"certificateType": "String",
"certificateTypeDesc": "String",
"certificateContent": "String",
"status": false,
"certificateKey": "String"
}
],
"newDltOrderId": "11111",
"version": "2" // version=2时,订单号字段使用newDltOrderId
}
}
四、输出参数:
| 父节点 | 名称 | 编码 | 类型 | 默认值 | 描述 |
|---|---|---|---|---|---|
| 状态信息 | responseStatus | 系统校验信息 | |||
| 状态信息 | resultStatus | 业务校验信息 | |||
| resultStatus | 错误码 | resultCode | 除了0是正确,别的都是错误 | ||
| resultStatus | 错误信息 | resultMsg | 错误信息 | ||
| 发单唯一ID | issueOrderId | 无用 |
示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1517819274464+0800)/",
"Ack": "Success",
"Errors": [],
"Version": "v1"
},
"resultStatus": {
"resultCode": 0,
"resultMsg": "success"
},
"issueOrderId": "String"
}