推送酒店申请单

接口（建议后缀）：/approval/hotel/save
Method：POST
数据格式：Json
调用方：每刻
接口说明：员工提交酒店申请单，经过每刻转换成申请单推送给第三方

请求参数

字段	类型	必填	描述
approvalNo	String	Y	申请单号
originalApprovalNo	String	N	原始申请单号（只有变更后的申请单有）
formCode	String	Y	单据编码（由多个申请单组成的大单据的编码）
formBizCode	String	Y	单据业务编码（通常为大单据在客户系统的编码）
externalCorpCode	String	Y	企业在第三方中唯一标识
externalEmployeeCode	String	Y	下单人在第三方中唯一标识
purpose	String	N	出差事由
cityList	List<City>	N	目的城市列表
cityCtrlLv	int	N	城市管控级别
internationalHotel	bool	N	是否国际酒店 [1]
clientList	List<Client>	Y	住店人列表 [2]
subsidiary	Subsidiary	N	申请单所属子公司
dept	Department	N	申请单所属部门
invTitle	InvoiceTitle	N	申请单开票抬头 [3]
minCheckInDate	String	N	最小入住日期 (yyyy-MM-dd) [4]
maxCheckOutDate	String	N	最大离店日期 (yyyy-MM-dd) [4]
dateCtrlLv	int	N	日期管控 (yyyy-MM-dd) [99]
totalRoomCount	int	N	总房间数
approvalAmount	BigDecimal	N	申请金额
avgRoomPrice	BigDecimal	N	申请单房间均价
approvalCurrency	String	N	币种，默认 CNY
amountCtrlLv	int	N	金额管控级别
amountCtrlType	int	[5]	金额管控类型
starCtrlLv	int	N	星级管控级别
star	int	N	最大可预定星级 [6]
orderIADays	int	N	提前预定天数 [7]
orderIADaysCtrlLv	int	N	提前预订天数管控级别
approvers	List<Approver>	N	超标审批人列表
costCenterList	List<CostCenter>	N	成本中心列表
custField1	String	[8]	自定义字段1
custField2	String	[8]	自定义字段2
custField3	String	[8]	自定义字段3
custField4	String	[8]	自定义字段4
custField5	String	[8]	自定义字段5
custField6	String	[8]	自定义字段6
custField7	String	[8]	自定义字段7
custField8	String	[8]	自定义字段8

[info] 说明：
[1] 如果酒店城市列表中包括国际城市，该字段为true。
[2] 如果该列表为空时，只允许为自己预定。
[3] 如果开票抬头没有传时，TMC 使用员工的默认开票抬头。
[4] 最大离店日期至少比最小入住日期多1天。
[5] 当金额管控明确表示管控（强管控或弱管控），该字段为必填。
[6] 员工最高能预订的酒店星级。
[7] 该字段表示，员工预订酒店需要在这个表示的天数前预订。
[8] 企业可能会有多个自定义字段，最多有8个。该字段需要提前固定含义，若要使用该字段，请先和每刻沟通。

OrderType

code	定义
ORDER	预订
REFUND	退票 (退订)

金额管控类型

code	定义	描述
1	单价管控	根据 avgRoomPrice 管控房间单价管控
2	总价管控	管控预定人预订的申请金额

酒店星级

code	定义
1	经济型
3	三星
4	四星
5	五星

响应结构

字段	类型	必填	描述
success	bool	Y	请求是否成功
errorMessage	String	N	失败信息（当success为false时，失败信息为必填）
data	ExternalApproval	N	关联申请单

ExternalApproval

目的是关联第三方系统中的申请单号，接下来所有使用到申请单号的地方，都将使用第三方提供的申请单号。

字段	类型	必填	描述
approvalNo	String	Y	每刻的申请单号
externalApprovalNo	String	Y	第三方系统中申请单的唯一标识 [9]

[info] 说明：
[9] 如果第三方不生成新的申请单号，使用每刻提供的 approvalNo，则按照 externalApprovalNo == approvalNo 返回。

示例

[warning] 重要：
示例维护并非和文档字段维护一样频繁，如果遇到示例和文档不一致，请以文档为准

请求头:

{
  "tokenId": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9pZCIsInN1YiI6IlBGMjAwNjIwMTI1NU5GTk8iLCJpYXQiOjE2MDQ2MzA5NjYsImF1ZCI6IlBMQVRGT1JNIiwiZXhwIjoxNjA0NjM0NTY2LCJwcm9kdWN0TGluZSI6IkRBVEFfSFVCIn0.AyNIwPtGUXxFMuHO8Bx-4XeXNyWYRcot40MfsL1swr4"
}

请求示例:

{
  "approvalNo": "AE2007091BAZ2FWG",
  "formCode": "PC96136422941",
  "formBizCode": "ABC2406B01",
  "originalApprovalNo": null,
  "externalCorpCode": "0123456",
  "externalEmployeeCode": "f715c1xxx",
  "purpose": "青岛歌剧院探访 & 沟通",
  "cityCtrlLv": 2,
  "clientList": [
    {
      "name": "xxx",
      "externalEmployeeCode": "f715c1xxx",
      "phone": "139xxxxxxxx"
    }
  ],
  "dateCtrlLv": 2,
  "approvalAmount": 0.0000,
  "approvalCurrency": "CNY",
  "amountCtrlLv": 0,
  "amountCtrlType": 1,
  "orderIADays": 0,
  "orderIADaysCtrlLv": 0,
  "plusDaysAhead": 2,
  "plusDaysLater": 2,
  "subsidiary": {
    "subsidiaryCode": "SIxxxxxxxxxxxxxxx",
    "subsidiaryName": "天津歌剧营销有限公司",
    "isDefault": false
  },
  "dept": {
    "departmentCode": "DHDI42803480284",
    "departmentName": "芭蕾编舞推广事业组",
    "departmentHeirCode": "DHDI12341433214.DHDI123132154234152.DHDI12342143245432.DHDI7890452797592.DHDI42803480284",
    "departmentHeirName": "天津歌剧有限公司/天津歌剧营销有限公司/芭蕾舞部/芭蕾编舞事业部/芭蕾编舞推广事业组"
  },
  "invTitle": {
    "invoiceTitleCode": "SIyyyyyyyyyyyyyyyy",
    "invoiceTitleName": "天津歌剧营销有限公司",
    "taxNo": "913112334234236867687686674423N",
    "isDefault": true
  },
  "minCheckInDate": "2024-06-26",
  "maxCheckOutDate": "2024-07-02",
  "cityList": [
    {
      "code": "CT510100",
      "name": "成都",
      "adminDivCode": "510100",
      "heirCode": "CHN001/P510000/CT510100",
      "heirName": "中国/四川/成都"
    }
  ],
  "totalRoomCount": 1,
  "avgRoomPrice": 0.00,
  "starCtrlLv": 0,
  "star": 4
}

响应示例:

{
  "success": true,
  "errorMessage": null,
  "data": {
    "approvalNo": "AE2007091BAZ2FWG",
    "externalApprovalNo": "xxxx"
  }
}

results matching ""

No results matching ""