力程商旅

# 使用指南

参数编码格式：UTF-8

# 示例代码

  1. 下载示例代码 下载地址 (opens new window)
  2. 安装nodejs 环境 [可选] 下载地址 (opens new window)
  3. 在当前目录开启命令行并执行 npm run demo

# 使用方案

# 1. 生成审批单后再发起预定流程

  1. 【获取授权(刷新)】获取服务端api access-token 用于调用后续服务端api
  2. 【获取基础数据】OA系统生成审批单时需要用到的机场 城市 车站等基础数据
  3. 【保存员工信息】将OA审批单中的员工信息同步到我方系统
  4. 【审批管控预约】基于OA审批单在我方系统生成预约单 后续凭预约单发起预定流程
  5. 【获取授权(刷新) 】获取客户端web access-token 用于调用后续页面跳转功能
  6. 【网页免登入口】通过免登接口进入我方系统 并跳转到预定流程
  7. 【执行预定跳转接口】客户端页面跳转到OA系统
  8. 【消息通知接口】下单成功后会发送 booking通知到OA系统 booking通知内容中包含 OrderID 我方订单号 及 ClientOrderID客户订单号
  9. 【获取订单详情】[可选] 如果需要获取更多订单信息 可以调用订单详情接口
  10. 【订单审批接口】[可选] 审批管控预约单中如果传入了审批人则需要调用审批接口 免审批不需要调用

# 2. 预定成功后生成审批单

  1. 【获取授权(刷新)】获取服务端api access-token 用于调用后续服务端api
  2. 【保存部门信息】需要将所有部门信息同步到我方系统(默认员工权限为可以查看本部门员工 没有部门结构每个员工都可以看到公司内其他人的信息)
  3. 【保存员工信息】需要将所有员工信息同步到我方系统
  4. 【审批管控预约】固定限制规则 固定系统虚拟审批人(通过)
  5. 【获取授权(刷新) 】获取客户端web access-token 用于调用后续页面跳转功能
  6. 【网页免登入口】通过免登接口进入我方系统 并跳转到预定流程
  7. 【执行预定跳转接口】客户端页面跳转到OA系统
  8. 【消息通知接口】下单成功后会发送 booking通知到OA系统 booking通知内容中包含 OrderID 我方订单号 及 ClientOrderID客户订单号
  9. 【获取订单详情】根据订单详情信息生成OA系统内的审批单
  10. 【订单审批接口】OA系统内审批通过后 使用虚拟审批人触发我方审批接口审批通过

# 3. 使用商旅系统审批功能

  1. 【获取授权(刷新)】获取服务端api access-token 用于调用后续服务端api
  2. 【保存部门信息】需要将所有部门信息同步到我方系统(默认员工权限为可以查看本部门员工 没有部门结构每个员工都可以看到公司内其他人的信息)
  3. 【保存员工信息】需要将所有员工信息同步到我方系统
  4. 【获取授权(刷新) 】获取客户端web access-token 用于调用后续页面跳转功能
  5. 【网页免登入口】通过免登接口进入我方系统 并跳转到预定首页
  6. 【消息通知接口】下单成功后会发送 booking通知到OA系统 booking通知内容中包含 OrderID 我方订单号 及 ClientOrderID客户订单号
  7. 【获取订单详情】根据订单详情信息生成OA系统内的审批单
  8. 【订单审批接口】OA系统内审批通过后 使用虚拟审批人触发我方审批接口审批通过

# 4.自由组合接口自定义功能

  1. 调用审批管控预约接口时至少需要将订单中的旅客信息保存到我方系统
  2. 需要审批管控时调用我方审批管控接口并使用接口返回的地址作为免登后的跳转地址进入我方系统

# 审批方式

# 先审批后预定方式

调用审批管控接口时将审批人参数传入空数组

# 先预定后审批方式

调用审批管控接口时将审批人参数传入一个固定审批人 OA审批完成后 使用固定审批人触发审批通过接口

# 预定前后两段审批

例如 主管审批》预定下单》财务审批 的需求 可以在审批人参数中传入固定审批人 当接收到下单通知后 再通知代码中触发OA的财务审批流程 OA财务审批通过后使用固定审批人触发我方系统的审批通过接口

# 使用我方商旅系统审批功能

调用审批管控接口时将所有审批人编号按照索引0为一级审批人的方式依次排列传入 我方系统将再需要指定审批人审批时发送短信 微信(已绑定情况下) 通知审批人审批 审批人编号必须要先通过员工接口保存到我方系统

# 常见问题

# 临客下单功能

审批管控接口中不指定旅客 返回的预定链接将会变成预定中心的地址 预定人可以在预定中添加临时旅客

# 只能为自己下单功能

审批管控接口中指定旅客为下单人的编号

# 为指定一个或多个旅客下单

审批管控接口中指定一个或多个旅客编号 系统将限制预定人只能将已指定的员工作为旅客进行下单

# 进入我方系统页面

  1. 【获取授权(刷新) 】获取客户端web access-token 用于调用后续页面跳转功能
  2. 【网页免登入口】通过免登接口进入我方系统 并跳转到指定页面 目前提供支持跳转的页面包括【订单列表，订单详情】具体跳转时需要携带的参数 请参考接口文档的 前端接口 部分 理论上通过该方式可以跳转进入我方系统任何页面 如有使用 订单列表及详情以为的页面地址 请告知我方 以免我方系统变更页面地址时造成功能不可用问题

# 免登成功后,没有跳转到产品列表

不同业务场景调用审批管控预约时需要传入的参数 缺少参数将会生成预定中心页面的地址

航班列表：出发城市 到达城市 出发日期 旅客

车次列表：出发城市 到达城市 出发日期 旅客

酒店列表：入住城市 入住日期 离店日期 旅客

# 接口返回签名错误时请检查

# 服务端接口

是否将 signature access-token 添加到 http header 信息中

是否将 timestamp 添加到业务参数中传入

请求类型 content-type:application/json 验签数据是完整的请求数据 请勿将json按属性拆开分别签名

# 客户端接口

请将 signature access-token timestamp 采用 URL query 的方式传输