申请单同步

[info] 说明：
员工有行程需求时，需要提交申请单到 TMC 后才能预定。TMC 接收到申请单后，对接下来的员工预定进行限制。
申请单作废（过期）时，将由每刻通知 TMC 将对应申请单作废（过期）。

管控字段（以 CtrlLv 结尾）定义：

[warning] 管控含义：

  1. 对于金额类，定义为不大于；
  2. 对于时间类、地址类与其他，表示符合。
code 定义 描述
0 or 不传 不管控 员工不需要提前预订
1 强管控 强制管控 [1]
2 弱管控 填写原因后可预订 [2]
3 超出审批 超出后审批 [3]
4 超过自付超出金额 [4]
5 超出自付全部金额 [5]

[info] 管控说明：

对于申请单中的审批字段，目前对接有两种方式：

  1. 全部或者部分对接申请单上的管控字段（CtrlLv 结尾），以列表形式告知每刻对接人哪些管控级别对接了，并且标明出支持的管控级别有哪些（如：酒店金额管控 amountCtrlLv 支持不管控 0 和强管控 1），每刻会放开对应管控配置项给企业管理员进行配置。
  2. 不对接管控字段，以企业在第三方差标进行管控，对接时忽略管控字段。

[1] 强制管控，要么预订符合申请单，要么不符合。
[2] 只需要填写原因后，员工就可以预订。
[3] 预订超出申请单范围，需要审批成功后才可预订。
[4] 预订超出申请单范围，需要自付超出的那部分金额。
[5] 预订超出申请单范围，需要自付全部（可能地点或时间偏差，企业有可能需要员工自付全部金额）。

公共定义

City

字段 类型 必填 描述
code String Y 每刻城市编码
name String Y 每刻城市名称
heirCode String Y 每刻城市继承链编码
heirName String Y 每刻城市继承链名称
adminDivCode String N 行政区划编码（仅国内城市有）

Client

乘客住店人对象定义

字段 类型 必填 描述
externalEmployeeCode String [6] 员工在第三方中唯一标识
name String Y 中文名
phone String N 手机号 [7]
identityNo String N 身份证号 [7]
firstName String N 英文名
middleName String N 英文中间名
lastName String N 英文姓氏
subsidiary Subsidiary N 申请单所属子公司
dept Department N 申请单所属部门
costCenterList List<CostCenter> N 成本中心列表

[info] 说明：
[6] 当传输字段中含有externalEmployeeCode，将认为这是一个员工，第三方使用 externalEmployeeCode 来识别；如果 externalEmployeeCode 不存在于传输字段中时，将识别为外部同行人。
[7] 不建议第三方使用这两个值，企业不一定会要求员工填写这两个值。对于用车应用，大多第三方会要求手机号字段必填，请先和客户沟通是否能传该字段。

Subsidiary

字段 类型 必填 描述
subsidiaryCode String Y 子公司唯一标识
subsidiaryName String N 子公司名称

Department

字段 类型 必填 描述
departmentCode String Y 部门唯一标识
departmentName String N 部门名称
departmentHeirCode String N 部门继承链（编码）[以 . 分隔]
departmentHeirName String N 部门继承链（名称）[以 / 分隔]
departmentBizCode String N 部门业务编码（部门在客户系统或者上游系统中的编码）

InvoiceTitle

字段 类型 必填 描述
invoiceTitleCode String Y 开票抬头唯一标识
invoiceTitleName String N 开票抬头名称
taxNo String N 税号

Approver

字段 类型 必填 描述
externalEmployeeCode String Y 审批人在第三方中唯一标识
approverType OrderType Y 审批人管控的预定类型

OrderType

code 定义
ORDER 预订
CHANGE 改签
REFUND 退票 (退订)

CostCenter

字段 类型 必填 描述
costCenterCode String N 成本中心唯一标识
costCenterName String N 成本中心名称

[warning] 注意：
第三方如果需要对接申请单成本中心，需要提前跟每刻沟通，才会放开让企业管理员进行配置，如不提前沟通，上线时将不具备传成本中心的能力

results matching ""

    No results matching ""