在途商旅
  1. 四、事件订阅
在途商旅
  • 关于本文档
  • API调用指南
    • API列表
    • 接入流程
    • 接口通用说明
    • 通用错误码
  • 服务端接口
    • 一、鉴权管理
      • 1、接口鉴权
        • a、获取token
      • 2、单点登录
        • a、目标页概述
        • b、单点登录
    • 二、企业信息
      • 1、概述
      • 2、组织单位
        • a、概述
        • b、常见问题
        • c、场景说明
        • d、组织同步
        • f、负责人同步
      • 3、员工信息
        • 概述
        • 场景说明
        • 常见问题
        • 手机号国家编码表
        • 员工同步
        • 员工直属主管同步
        • 员工常住地同步
        • 获取职级列表
        • 获取证件类型
        • 员工信息查询
      • 4、成本中心
        • 概述
        • 常见问题
        • 场景说明
        • 成本中心(部门所属)
        • 成本中心(员工所属)
      • 5、项目
        • 概述
        • 常见问题
        • 场景说明
        • 项目同步
      • 6、法人
        • 概述
        • 常见问题
        • 法人同步
    • 三、业务数据
      • 1.出行前
        • 概述
        • 差旅申请
          • 申请单同步
          • 申请单变更前校验
          • 取消申请单提前验证
          • 申请单状态变更
          • 获取申请单
          • 获取申请单使用状态
          • 获取申请单出行概况
          • 获取差旅类型
          • 获取费用类型
      • 2.出行中
        • 订单
          • 客票状态
          • 订单查询(全量)
          • 订单查询(分页)
          • 订单确认-V1
          • 订单确认-V2
      • 3.出行后
        • 账单
          • 获取账单主信息
          • 分页获取账单主信息
          • 获取账单订单明细
          • 账单中疑异订单通知
          • 确认账单通知
        • 票据
          • 订单开票信息
          • 个付电子发票查询
          • OCR票据查询
          • 订单数电票
      • 4.工作流
        • 查询审批记录
        • 审批结束通知
        • 审批记录同步
    • 四、事件订阅
      • 1、概述
      • 2、事件列表
      • 3、数据推送
      • 4、示例代码
      • 5、需求单服务类型
      • 8、openapi-sdk
      • 6、事件订阅接口
        • a、订阅事件
        • b、删除订阅
        • c、查询订阅
    • 五、通用数据
      • 国家编码对照表
      • 获取城市列表(废弃)
      • 获取城市列表V2
    • 六、其他
      • 补贴查询
      • 自定义补贴场景明细同步
  1. 四、事件订阅

3、数据推送

订单推送 - 业务数据详解#

参数类型说明
partnerId            int64 企业ID
partnerNamestring企业名称
idint64订单id
originalOrderIdint64原始订单号
本订单的关联订单中最原始的订单
parentOrderIdint64关联订单号,比如退单关联的正单,改签单关联的原单
bizOrderIdint64关联业务订单号,需求单火车票代打所关联的业务单号
bizTypeint3210-机票;
11-酒店;
12-火车;
13-国际酒店;
14-需求单;
15-保险;
16-用车;
17-国际机票;
20-服务费订单
orderTypeint32订单类型
1-正向订单;
2-改签订单;
3-抢票订单;
9-退单
bizOrderTypeEnumStringROUTINE:常规出票;CHANGE:直接改签;REFUND_TICKET_REPURCHASE:退票重出;GRAB:抢票单; REFUND:退单
statusstring订单状态:已完成/已退款-COMPLETED;已取消-CANCELED
orderOriginTypestring订单来源类型
WWW:官网
CC_WWW:客服代订
CC_H5:H5客服代订
CC_MANUAL:客服手工录单
CC:客服后台代订
ANDROID:安卓
IOS:IOS
WEIXIN:微信公众号
H5:H5端
WEIXIN_APP:微信小程序
OPEN_API:渠道分销商
empCodestring预订人员工编码
empNamestring预订人姓名
empMobilestring预订人手机
empOrgNamestring预订人部门
contacterEmpCodestring联系人员工编码
contacterNamestring联系人姓名
contacterMobilestring联系人手机号
contacterEmailstring联系人邮箱
salePricedouble订单销售价
serviceChargeAmountdouble订单服务费总金额
totalAmountdouble订单应付总金额
receivedAmountdouble订单已实收金额
bpPayAmountdouble企业账户支付金额
bpBearAmountdouble企业应承担金额
paymentMethodstring支付方式 如有多种方式,会使用逗号隔开:
BP_ACCOUNT企业支付,
P_ACCOUNT个人账户,
ALIPAY支付宝,
ALIPAY_M支付宝,
WECHATPAY微信支付,
WECHATPAY_M微信支付,
UNDER_LINE_PAY线下支付,
PERSONAL_GUARANTEE信用卡担保,
CMB_PAY招行一网通
personalPayAmountdouble个人支付金额
dealFeedouble手续费
taxFeedouble税费
refundFeedouble退票费
travelPlanNostring差旅计划号
travelTypestring出行类别
travelReasonstring差旅事由
invoiceModestring发票模式
changeReasonTagString订单的改签事由标签
changeReasonString订单的改签事由描述,员工手动填写的
refundReasonTagString订单的退票事由标签
refundReasonString订单的退票事由描述,员工手动填写的
agreementCodestring大客户编码
travelStartTimestring行程开始时间: "2020-03-03 12:33:33"
travelEndTimestring行程结束时间: "2020-03-03 12:33:33"
createTimestring创建订单时间: "2020-03-01 12:33:33"
paymentTimestring支付时间: "2020-03-01 12:33:33"
completeTimestring订单完成时间: "2020-03-01 12:33:33"
expenseCategoryobject费用类别
└─codestring编码
└─namestring名称
orderEconomizearray订单节支信息
└─bookerEmpCodestring预订人人员编码
└─travellerEmpCodestring出行人人员编码
└─economizeTypestring节省方式,
LOW_PRICE-低价节支,
STANDARD-差标节支,
CUSTOMER_AGREEMENT 大客户协议价节支
└─statisticsTypestring统计类型,CAN-能节支,ALREADY-已节支
└─amountdouble节支金额
└─orderSaleNetAmountdouble订单销售净价(不含服务费)
└─orderSummarystring订单摘要
"2380/SHA-CTU/中国国航
/CA1941/2021-12-08 07:35/Y/立轩.汪"
└─extraInfostring原/推荐航班数据等附属信息
"500/中国国航/CA1941/2021-12-08 07:35/Y/2.2折"
flightOrderProductInfoarray机票订单产品/行程
└─fromCitystring出发城市名
└─fromCityCodestring出发城市编码
└─toCitystring到达城市名
└─toCityCodestring到达城市编码
└─fromDatestring出发时间
└─toDatestring到达时间
└─expectedFromDatestring预期出发时间
└─expectedToDatestring预期到达时间
└─serviceProviderstring供应商(航司)
└─pricedouble销售价
└─flightNostring航班号
└─cabinNamestring仓位等级
└─discountRatestring折扣率
└─cabinCodestring仓位编码
└─fromAirportstring出发机场三字码
└─fromAirportNamestring出发机场名称
└─toAirportstring到达机场三字码
└─toAirportNamestring到达机场三字码
intlFlightOrderProductInfoarray国际机票订单产品/行程
└─fromCitystring出发城市名
└─fromCityCodestring出发城市编码
└─toCitystring到达城市
└─toCityCodestring到达城市编码
└─fromDatestring出发时间
└─toDatestring到达时间
└─expectedFromDatestring预计出发时间
└─expectedToDatestring预计到达时间
└─serviceProviderstring供应商(航司)
└─pricedouble销售价
└─flightNostring航班号
└─cabinNamestring仓位等级
└─discountRatestring折扣率
└─cabinCodestring仓位编码
└─fromAirportstring出发机场三字码
└─fromAirportNamestring出发机场名称
└─toAirportstring到达机场三字码
└─toAirportNamestring到达机场三字码
hotelOrderProductInfoobject酒店订单产品/行程
└─checkInDatestring入住时间: "2020-03-01 12:33:33"
└─checkOutDatestring离店时间: "2020-03-01 12:33:33"
└─cityNamestring入住城市
└─hotelNamestring酒店名称
└─roomCountint32房间数量
└─roomDaysint32入住天数
└─roomNamestring房型
└─starRatestring酒店星级
└─starRateNamestring酒店星级名称
└─hotelAddressstring酒店地址
└─breakfastCountint32早餐数量
└─pricedouble销售价
└─isAgreementBoolean是否是协议酒店
trainOrderProductInfoarray火车票订单产品/行程
└─fromCitystring出发城市
└─toCitystring到达城市
└─fromDatestring出发时间
└─toDatestring到达时间
└─seatNamestring座席
└─trainNostring车次
└─fromStationstring出发车站
└─toStationstring到达车站
└─pricedouble销售价
insuranceOrderProductInfoarray保险订单产品/行程
└─insuranceNostring保单号
└─effectiveTimestring保险生效时间: "2020-02-25"
└─failureTimestring报险失效时间: "2020-02-25"
└─flightNostring航班号
└─insuranceNamestring保险产品名称
└─insuranceTypeNamestring保险类型名称
└─premiumTextstring保费额度
generalOrderProductInfoobject需求单订单产品/行程
└─serviceTypestring需求单服务类型编码,见附表
└─serviceNamestring服务品类名称
└─travellerCountint32出行人数
└─travelStartTimestring2020-03-03 12:33:33
└─destinationstring出行地点
carOrderProductInfoobject用车订单产品/行程
└─fromCitystring出发城市名称
└─toCitystring到达城市名称
└─startCityIdString出发城市在途ID
└─endCityIdString到达城市在途ID
└─startCityAdCodeString出发城市国家编码
└─endCityAdCodeString到达城市国家编码
└─startNamestring出发地名称
└─startAddressstring出发地地址
└─startLongitudestring出发地经度
└─startLatitudestring出发地纬度
└─endNamestring目的地名称
└─endAddressstring目的地地址
└─endLongitudestring目的地经度
└─endLatitudestring目的地纬度
└─driverNamestring司机姓名
└─driverTelstring司机手机号
└─vehicleNostring车牌号
└─productIdstring服务产品ID
└─carSceneCodestring用车场景Code
└─carSceneNamestring用车场景名称
└─carTypeCodestring滴滴:(100舒适型,400商务型, 200豪华型,500优选型,600快车,900优享型)
高德:(ECONOMIC经济型,PREMIUM优享型,SPECIAL_VEHICLE专车型,BUSINESS六座商务,LUXURY豪华型)
└─carTypeNamestring车型
舒适型,
商务型,
豪华型,
优选型,
快车,
优享型)
└─isReservationsBoolean是否预约用车(0 实时、1 预约)
└─reservationsTimeDate预约时间(时间戳)
└─productNamestring服务产品名
1即时打车
2预约打车
3接送机
4接送站
└─carUseTimeDate用车开始时间 计划用车时间(时间戳)
└─carEndTimeDate用车结束时间 计划用车时间(时间戳)
└─actualTimeLengthint实际时长:分
└─drivingKilometresdouble行驶公里数
└─actualStartNamestring实际出发地(司机点击开始的位置)
└─actualFlngstring实际出发地纬度(司机点击开始的位置)
└─actualEndNamestring实际目的地(司机点击结束的位置)
└─actualTlngstring实际目的地经度(司机点击结束的位置)
└─actualTlatstring实际目的地纬度(司机点击结束的位置)
└─departureTimestring司机出发时间
└─ruleint计价模型分类
201(专车);
301(快 车);
203(专车接机);
204(专车送\n机)
└─striveLevelint叫单车型
100 舒适型
400 六座商务
200 行政级
600 普通快车
900 优享快车
└─bpRefundAmountdouble企业实退金额
└─startPricedouble起步价
└─mileagePricedouble里程费
└─driverTakingTimeDate司机接单时间(时间戳)
└─refundTimeDate退款时间(时间戳)
└─isFixedPricestring是否一口价
└─estimatePricedouble用车预估打车费
travellersarray订单出行人
└─empCodestring员工编码
└─empNamestring员工姓名
└─mobilestring员工电话
└─employeeboolean是否员工
└─deptNamestring部门
└─statusstring客票状态
└─deptCodestring部门编码
└─subCompanyNamestring所属公司名称
└─subCompanyCodestring所属公司编码
└─totalAmountdouble分摊总金额
└─bpPayAmountdouble分摊企业账户支付金额
└─bpBearAmountdouble分摊企业应承担金额
└─personalPayAmountdouble个人支付金额,精确到分
└─standardAmountdouble出行人差标等级金额
└─travelStandarddouble差标等级,举例:机票的经济舱、火车的二等座、酒店 300.0/天
└─facePricedouble票面价
└─salePricedouble销售价
└─dealFeedouble手续费
└─taxFeedouble税费
└─refundFeedouble退票费
└─serviceChargeAmountdouble单人服务费汇总
└─fuelTaxdouble机票燃油费
└─departureTaxdouble机票基建费
└─productstring机票:票号;
火车票:车厢/座位号;
酒店:入住房间编号;
保险:保单号
└─credentialTypestring证件类型
└─credentialNostring证件号码
└─empExtend1string员工对应的扩展字段: {"oaAccount":"OA"}
└─travellerTypestring出行人类别
0-成人
1-儿童
2-幼儿
└─settlementStatusstring结算状态
已结算:SETTLEMENT
未结算:UN_SETTLEMENT
└─planNostring申请单号
└─travelMoldCodestring出行类型
└─travelTypestring差旅类型
└─receiptNolistarray行程单号列表
illegalInfosarray订单违规信息
└─empCodestring员工编码
└─empNamestring员工姓名
└─orgNamestring部门名称
└─issueCodestring违规编码
└─issueInfostring违规信息
└─reasonstring违规原因
└─extraInfostring附属信息,json
└─extraInfoExtstring附属信息
└─standardInfostring差标标准
costBreaksarray订单成本分摊
└─costNamestring成本中心名称
└─orgNamestring成本中心所属组织名称
└─orgCodestring成本中心所属组织编码
└─costUnitIdint64成本中心ID
└─costUnitCodestring成本中心编码
└─projectCodeString项目编码
└─projectNameString项目名称
└─orderIdint64订单号
└─percentint32成本分摊比例,值用万分位表示
└─totalAmountdouble分摊总金额
└─userCodestring用户编码
└─userNamestring用户名
└─corpCodestring法人编码
└─corpNamestring法人名称
└─chiefBoolean是否为主属成本归属
travelPlanobject订单差旅计划
└─planNostring差旅计划号
└─travelTypestring出行类别编码
└─travelTypeNamestring出行类别名称
└─expensestring费用预算
└─consumedAmountstring已消耗金额
└─travelReasonstring出差事由
└─projectCodestring项目编码
└─projectNamestring项目名称
└─paymentCorpstring费用支付公司
└─extend2string扩展字段,json格式: {"accountingEntity":"B-571B-010","budgetAccount":"GL02.06","groupCode":"CIFI"}”
└─createUserNamestring创建人姓名
└─itemsarray差旅计划行项目
└─partnerIdint64企业id
└─planIdint64差旅计划id
└─originPlacestring出发地
└─originNamestring出发地名称
└─originCountryint32出发地所属国家
└─destPlacestring目的地
└─destNamestring目的地名称
└─destCountryint32目的地所属国家
└─departureTimestring出发时间
接口同步差旅计划过程中,
往返程的第二程存在出发和到达时间倒序,
需要用到getMinDepartureTime(),
获取最小时间 作为出发时间
└─arrivalTimestring到达时间
接口同步差旅计划过程中,
往返程的第二程存在出发和到达时间倒序,
需要用到getMaxArrivalTime(),
获取最大时间 作为到达时间
└─travelModestring出行方式
FLIGHT-飞机
TRAIN-火车
└─remarkstring备注
└─applyStatusint32应用状态 取值:
0-未应用
1-部分应用
2-已应用
└─travelReasonstring出行原因
└─planNostring差旅计划号
└─travelExpenseItemsarray费用类别
└─planIdint64差旅计划id
└─expenseItemIdint64费用id
└─expenseItemNamestring费用名称
└─amountint32费用预算
└─consumedAmountint32已消耗费用
└─budgetAccountstring预算科目
orderSummarystring销售订单,订单摘要
originalOrderInfoobject原单摘要关键信息, 改签支付违规审批才有值
└─orderIdLong原单订单号
└─originPlaceString出发地
└─destPlaceString目的地
└─fromDateString出发时间
└─toDateString到达时间
└─classesNoString航班号、车次
参数示例:
{
    "partnerId":196,
    "partnerName":"立轩.汪",
    "id":474,
    "tmcId":333,
    "originalOrderId":593,
    "bizType":899,
    "orderType":724,
    "orderOriginType":"xgl269",
    "empCode":"61420",
    "empName":"立轩.汪",
    "empMobile":"15821145999",
    "empOrgName":"立轩.汪",
    "contacterEmpCode":"61420",
    "contacterName":"立轩.汪",
    "contacterMobile":"15821145999",
    "contacterEmail":"鹏飞.贺@yahoo.com",
    "parentOrderId":288,
    "salePrice":28.02,
    "serviceChargeAmount":60.89,
    "totalAmount":89.61,
    "receivedAmount":54.06,
    "bpPayAmount":16.49,
    "bpBearAmount":1.86,
    "paymentMethod":"t2efff",
    "personalPayAmount":17.44,
    "dealFee":36.24,
    "taxFee":82.88,
    "refundFee":87.64,
    "travelPlanNo":"o8mqao",
    "travelType":"fuhxk3",
    "travelReason":"3idm8s",
    "agreementCode":"61420",
    "travelStartTime":"2020-03-23 17:07:25",
    "travelEndTime":"2020-03-23 17:07:25",
    "createTime":"2020-03-23 17:07:25",
    "paymentTime":"2020-03-23 17:07:25",
    "completeTime":"2020-03-23 17:07:25",
    "expenseCategory":{
        "code":"61420",
        "name":"立轩.汪"
    },
    "orderEconomize":[
        {
            "bookerEmpCode":"1234",
            "travellerEmpCode":"1234",
            "economizeType":"LOW_PRICE",
            "statisticsType":"CAN",
            "amount":1830,
            "orderSaleNetAmount":2330,
            "orderSummary":"2380/SHA-CTU/中国国航/CA1941/2021-12-08 07:35/Y/立轩.汪",
            "extraInfo":"500/中国国航/CA1941/2021-12-08 07:35/Y/2.2折"
        }
    ],
    "flightOrderProductInfo":[
        {
            "fromCity":"4rlrsk",
            "fromCityCode":"61420",
            "toCity":"h45u85",
            "toCityCode":"61420",
            "fromDate":"2020-03-23 17:07:25",
            "toDate":"2020-03-23 17:07:25",
            "expectedFromDate":"2020-03-23 17:07:25",
            "expectedToDate":"2020-03-23 17:07:25",
            "serviceProvider":"ra0pta",
            "flightNo":"zqt2l1",
            "cabinName":"立轩.汪",
            "discountRate":"54t5m2",
            "cabinCode":"61420",
            "fromAirport":"ozukvv",
            "fromAirportName":"立轩.汪",
            "toAirport":"hzz2u3",
            "toAirportName":"立轩.汪"
        }
    ],
    "intlFlightOrderProductInfo":[
        {
            "fromCity":"hhiggh",
            "fromCityCode":"61420",
            "toCity":"0ri83v",
            "toCityCode":"61420",
            "fromDate":"2020-03-23 17:07:25",
            "toDate":"2020-03-23 17:07:25",
            "expectedFromDate":"2020-03-23 17:07:25",
            "expectedToDate":"2020-03-23 17:07:25",
            "serviceProvider":"doq890",
            "price":"rka1ag",
            "flightNo":"0vqtdm",
            "cabinName":"立轩.汪",
            "discountRate":"7ej29p",
            "cabinCode":"61420",
            "fromAirport":"rq33mi",
            "fromAirportName":"立轩.汪",
            "toAirport":"zla4v6",
            "toAirportName":"立轩.汪"
        }
    ],
    "hotelOrderProductInfo":{
        "checkInDate":"2020-03-23 17:07:25",
        "checkOutDate":"2020-03-23 17:07:25",
        "cityName":"立轩.汪",
        "hotelName":"立轩.汪",
        "roomCount":326,
        "roomDays":948,
        "roomName":"立轩.汪",
        "starRate":"yk6263",
        "starRateName":"立轩.汪",
        "hotelAddress":"顾桥02854号, 淄博, 皖 061375",
        "breakfastCount":714
    },
    "trainOrderProductInfo":[
        {
            "fromCity":"hk9qzs",
            "toCity":"ylgu43",
            "fromDate":"2020-03-23 17:07:25",
            "toDate":"2020-03-23 17:07:25",
            "seatName":"立轩.汪",
            "trainNo":"32tqzx",
            "fromStation":"bxplmo",
            "toStation":"e2k33e"
        }
    ],
    "insuranceOrderProductInfo":[
        {
            "insuranceNo":"v9xdpb",
            "effectiveTime":"2020-03-23 17:07:25",
            "failureTime":"2020-03-23 17:07:25",
            "flightNo":"7rn33u",
            "insuranceName":"立轩.汪",
            "insuranceTypeName":"立轩.汪",
            "premiumText":"4t1ci5"
        }
    ],
    "generalOrderProductInfo":{
        "serviceName":"立轩.汪",
        "travellerCount":825,
        "travelStartTime":"2020-03-23 17:07:25",
        "destination":"mv3iwl"
    },
    "carOrderProductInfo":{
        "actualEndName":"金沙江路xxx",
        "actualFlat":"39.916527",
        "actualFlng":"116.397128",
        "actualStartName":"金沙江路xxx",
        "actualTimeLength":34,
        "actualTlat":"116.397128",
        "actualTlng":"39.916527",
        "bpRefundAmount":0,
        "carEndTime":1641897220795,
        "carSceneCode":"wsjdeuyfavcjaavhdsf",
        "carSceneName":"出差用车",
        "carTypeCode":"asdhjieehwiuhweqweqe",
        "carTypeName":"舒适型",
        "carUseTime":1641897220795,
        "departureTime":"2022-01-11 18:30:00",
        "driverName":"张三",
        "driverTakingTime":1641897220795,
        "driverTel":"13818181818",
        "drivingKilometres":3.58,
        "endAddress":"102号",
        "endLatitude":"116.397128",
        "endLongitude":"39.916527",
        "endName":"金沙江路xxx",
        "fromCity":"上海",
        "isFixedPrice":"1",
        "isReservations":true,
        "mileagePrice":20,
        "productId":"123",
        "productName":"即时打车",
        "refundTime":1641897220795,
        "reservationsTime":1641897220795,
        "rule":301,
        "startAddress":"101号",
        "startLatitude":"39.916527",
        "startLongitude":"116.397128",
        "startName":"真北路xxx",
        "startPrice":15,
        "striveLevel":100,
        "toCity":"上海",
        "vehicleNo":"沪f123123",
        "estimatePrice":20
    },
    "travellers":[
        {
            "empCode":"61420",
            "empName":"立轩.汪",
            "mobile":"15821145999",
            "employee":true,
            "deptName":"立轩.汪",
            "deptCode":"61420",
            "subCompanyName":"立轩.汪",
            "subCompanyCode":"61420",
            "totalAmount":51.71,
            "bpBearAmount":4.52,
            "personalPayAmount":23.22,
            "standardAmount":94.65,
            "salePrice":49.15,
            "dealFee":63.26,
            "taxFee":42.29,
            "refundFee":24.87,
            "serviceChargeAmount":72.32,
            "fuelTax":48.36,
            "departureTax":24.87,
            "product":"odofik",
            "credentialType":"gzr4g9",
            "credentialNo":"w56u2b",
            "empExtend1":"a689qh",
            "travellerType":"ml8djl",
            "settlementStatus":"SETTLEMENT",
            "planNo":"20239387299923",
            "travelMoldCode":"GHJKYUI",
            "travelType":"ERTYUFGH"
        }
    ],
    "illegalInfos":[
        {
            "empCode":"61420",
            "empName":"立轩.汪",
            "issueCode":"61420",
            "issueInfo":"1jonkk",
            "reason":"kej8zc",
            "extraInfo":"x25cu6",
            "extraInfoExt":"x25cu6sss"
        }
    ],
    "costBreaks":[
        {
            "costName":"立轩.汪",
            "orgName":"立轩.汪",
            "orgCode":"61420",
            "costUnitId":805,
            "costUnitCode":"61420",
            "projectCode":"110",
            "projectName":"2T企业",
            "orderId":7,
            "percent":498,
            "totalAmount":56.19,
            "userCode":"61420",
            "userName":"立轩.汪",
            "chief":true
        }
    ],
    "travelPlan":{
        "planNo":"rl8nzj",
        "travelType":"r89tno",
        "travelTypeName":"立轩.汪",
        "expense":"mdwlgh",
        "consumedAmount":"q5n9o1",
        "travelReason":"4co6ay",
        "projectCode":"61420",
        "projectName":"立轩.汪",
        "paymentCorp":"d81rzj",
        "extend2":"cqeg2t",
        "createUserName":"立轩.汪",
        "items":[
            {
                "partnerId":76,
                "planId":878,
                "originPlace":"dwt149",
                "originName":"立轩.汪",
                "originCountry":592,
                "destPlace":"18ye52",
                "destName":"立轩.汪",
                "destCountry":532,
                "departureTime":"2020-03-23 17:07:25",
                "arrivalTime":"2020-03-23 17:07:25",
                "travelMode":"yc3vp8",
                "remark":"hmgu2a",
                "applyStatus":683,
                "travelReason":"g2es9q",
                "planNo":"9kugvm"
            }
        ],
        "travelExpenseItems":[
            {
                "planId":397,
                "expenseItemId":416,
                "expenseItemName":"立轩.汪",
                "amount":334,
                "consumedAmount":447,
                "budgetAccount":"5xoecv"
            }
        ]
    },
    "orderSummary":"t4ksx4",
    "originalOrderInfo":{
        "orderId":103121812443264,
        "originPlace":"上海",
        "destPlace":"北京",
        "fromDate":"2020-03-23 17:07:25",
        "toDate":"2020-03-24 17:07:25",
        "classesNo":"D956"
    }
}

客票状态推送 - 新事件#

事件编码可选项:
新客票状态推送事件
请求 data 参数说明:
参数类型说明
partnerIdint64企业ID
empUniqueIdstring订单员工唯一id,与订单出行人上的empUniqueId一致
orderIdint64订单id
travellerStatusstring客票状态,对应订单出行人上的status
请求参数示例:
{
	"partnerId":493,
	"empUniqueId":"qwedasdqde123",
	"orderId":1032312312343123,
	"travellerStatus":"ISSUED"
}

支付审批推送 - 工作流业务数据详解#

事件编码可选项:
START_WORKFLOW
请求 data 参数说明:
参数类型说明
partnerIdint64企业ID
idint64支付编号
empCodestring支付人员工编码
empNamestring支付人姓名
empExtend1string员工对应的扩展字段: {"oaAccount":"OA"}
datestring支付发生时间: "2019-07-03 12:30:08"
amountnumber本次支付金额: 2000.22
orderInfosarray订单信息同订单推送 - 业务数据详解
请求参数示例:
{
	"partnerId":493,
	"id":400,
	"empCode":"61420",
	"empName":"立轩.汪",
	"empExtend1":"rl4src",
	"date":"2020-03-23 17:07:25",
	"amount":325,
	"orderInfos":[`订单推送业务数据详解`],
}
响应 data 参数说明:
参数类型说明
thirdWorkflowIdstring工作流ID,主要在调用删除工作流时使用
nextUsersstring审批人姓名,多人逗号分隔
响应参数示例:
{
	"thirdWorkflowId":"493ss",
	"nextUsers":"曹操,刘备,孙权,陆逊"
}

删除工作流推送 - 业务数据详解#

事件编码可选项:
DELETE_WORKFLOW
data 参数说明:
参数类型说明
partnerIdint64企业ID
ztIdint64在途工作流唯一标识
thirdWorkFlowIdstring工作流ID
empCodestring员工编码
参数示例:
{
	"partnerId":468,
	"ztId":14156478,
	"thirdWorkFlowId":"55",
	"empCode":"61420"
}

支付前校验 - 业务数据详解#

事件编码:
PAY_PRE_CHECK
data 参数示例
{
	"checkOrderInfos": [{
		"amount": "488.00",
		"costCode": "B-029A-08",
		"projectCode":"项目编码",
		"empCode": "gaoxxx",
		"empName": "高xx",
		"extend2": "{"budgetVar":{"accountingEntity":"B-029B-001","invoicesType":"0","budgetAccount":"GL02.06","groupCode":"CIFI"}}",
		"orderNo": "116224886206848",
		"orderSummary": "太原 全季酒店(太原西矿街店)-零压-高级双床房-三星级/舒适 2020-12-08 ~ 2020-12-10 高向前",
		"partnerId": 1965,
		"useTravelPlan": false
	}],
	"partnerId": 1965
}
data 参数说明:
字段名类型说明
checkOrderInfosjsonArrayjson数组
└─partnerIdint64企业ID
└─amountString总金额,多订单之和
└─costCodeString成本中心编码
└─projectCodeString项目编码
└─travelPlanNoString差旅单号
└─empCodeString预订人员工编码
└─empNameString预订人姓名
└─extend2Json扩展字段,来源于差旅计划的扩展字段,企业可以自定义
└─orderNoString订单号
└─orderSummaryString订单摘要

预算占用推送 - 业务数据详解#

事件编码:
BUDGET_USE
data 参数示例:
 {
 	"budgetDetailInfos": [{
 		"bpPayAmount": 44200,
 		"budgetOrderInfos": [{
 			"amount": "442.00",
 			"costCode": "B-512Y-04",
 			"projectCode":"项目编码",
 			"empCode": "daixy",
 			"empName": "代绪英",
 			"extend2": "{}",
 			"orderNo": "116224927428992",
 			"orderSummary": "苏州 苏州金鸡湖博览中心亚朵酒店",
 			"useTravelPlan": false
 		}],
 		"orderAmount": 44200,
 		"orderId": "116224927428992",
 		"personPayAmount": 0
 	}],
 	"partnerId": 1965,
 	"planId": 1335877181779529729
 }
 
data 参数说明:
字段名类型说明
partnerIdint64企业ID
planIdstring支付计划号
orderOperTypeclass操作类型
CHANGE_PRICE:变价订单
REFUNDED_ISSUE_ORDER:退票重出订单
budgetDetailInfosarray订单信息
  └─orderAmountInteger订单金额*100
  └─bpPayAmountInteger企业支付金额*100
  └─originalBpPayAmountInteger原企业支付金额*100
  └─personPayAmountInteger个人支付金额*100
  └─originalOrderAmountInteger原订单金额*100
  └─refundIdInteger退单号
  └─orderIdstring订单号
  └─budgetOrderInfosjson array预算订单明细
      └─amountInteger订单金额
      └─costCodeString成本中心编码
      └─projectCodeString项目编码
      └─travelPlanNoString差旅单号
      └─empCodeString预订人员工编码
      └─empNameString预订人姓名
      └─extend2Json差旅计划扩展字段,企业可以自定义
      └─orderNoString订单号
      └─orderSummaryString订单摘要

预算释放推送 - 业务数据详解#

事件编码:
BUDGET_RELEASE
data 参数示例:
{
	"budgetDetailInfos": [{
		"budgetOrderInfos": [{
			"costCode": "B-029A-08",
			"projectCode":"项目编码",
			"extend2": "{}"
		}],
		"orderId": "116224679408000"
	}],
	"partnerId": 1965
}
data 参数说明:
字段名类型说明
partnerIdint64企业ID
orderIdString订单号
budgetDetailInfosjsonArray订单信息
  └─budgetOrderInfosjsonArray预算订单明细
   └─costCodeString成本中心编码
   └─travelPlanNoString差旅单号
   └─projectCodeString项目编码
   └─extend2Json差旅计划扩展字段,企业可以自定义

开票成功通知推送 - 业务数据详解#

事件编码可选项
EC_INVOICE_SUCCESS
data 参数说明:
参数类型说明
partnerCodeString企业编码
orderIds[Long]成功开票的订单号
参数示例:
{
	"partnerCode":"your_partner_code",
	"orderIds":[123, 456, 789]
}

账单推送 - 业务数据详解#

事件编码可选项
LIQ_BILL_SEND 发送
LIQ_BILL_REVOKE 撤销
LIQ_BILL_MODIFIED 修改
LIQ_BILL_CONFIRMED 确认
LIQ_BILL_COMPLETED 完成
LIQ_BILL_INVOICED 开票
推送账单的结构如下(其中bizData是密文):
参数类型说明
bizDataString加密的推送的数据报文
noncestring随机数,盐值
partnerCodestring企业编码
signaturestring签名
timestampstring时间戳
{
    "bizData": "EWJIFJWIGJEWIGJWEIJGIWEJGIWEJGWIEJGIEW",
    "nonce": "SOAot",
    "partnerCode": "测试企业",
    "signature": "EEE8F3AE92732795E2F8E544D10088CB4F0CD28E",
    "timestamp": "1725525786096"
}
如上 bizData 调用 示例代码 中的 decrypt 方法解密后得到的结果如下:
参数类型说明
partnerCodeString企业编码
partnerAccountNamestring企业支付账户名称
billCodestring账单code
operateEmpCodestring操作人员工编号
eventCodestring账单事件编码
参数示例:
{
	"partnerCode":"your_partner_code",
	"partnerAccountName":"企业支付账户名称",
	"billCode":"账单code",
	"operateEmpCode":"操作人员工编号",
	"eventCode":"账单事件编码"
}
账单接口文档

差旅申请推送 - 业务数据详解#

事件编码:
EXP_TRAVEL_PLAN_APPROVED 差旅申请审批通过事件
EXP_TRAVEL_PLAN_CANCELED 差旅申请取消事件
EXP_TRAVEL_PLAN_UPDATED_REVOKE 差旅申请撤回事件
data 参数说明:
参数类型说明
planNoString差旅单号
empCodeString创建人人员编码
createUserExtend1String创建人的扩展字段
corpCodeString法人编码
companyCodeString公司代码
compNameString法人名称
costOrgCodeString成本中心所在的组织code
createUserNameString创建名称
strokeTypeInteger行程类型 1:单程 2:往返 3:多程
travelTypeString差旅类型编码
travelTypeNameString差旅类型名称
orgCodeString发起人所在的部门编号
orgFullNameString发起人所在的部门名称
costCenterCodeString成本中心编码
costCenterNameString成本中心名称
createDateDate创建时间 (时间戳)
costOrgIdLong成本中心所在的组织id
projectCodeString项目编码
projectNameString项目名称
expenseInteger预计总费用
paymentCorpString费用支付公司
extend1String扩展字段1 (职级)
extend2String扩展字段2
travelReasonString出差事由
stageInteger状态
10:审批中;
99:审批通过 ;
-99:审批驳回;
-100:已取消;
-98:待提交;
100:已取消(关联订单之后的取消)
travelUsers[Object]出行人列表
└─empCodeString员工编号,出行人非员工时为空
└─fullnameString出行人姓名
└─orgCodeString组织编码
└─orgNameString组织名称
└─extend1String扩展字段1
travelItems[Object]差旅行程计划列表
└─originPlacestring出发地
└─originNamestring出发地名称
└─originCountryInteger出发地所属国家
└─destPlacestring目的地
└─destNamestring目的地名称
└─destCountryInteger目的地所属国家
└─departureTimestring出发时间
└─arrivalTimestring到达时间
└─travelModestring出行方式,FLIGHT-飞机,TRAIN-火车,HOTEL-酒店
└─remarkstring备注
└─applyStatusInteger应用状态;取值:0-未应用,1-部分应用,2-已应用
└─travelReasonString出行原因
travelExpenseItems[Object]差旅费用明细
└─expenseItemIdLong费用id
└─expenseItemCodeString费用编码
└─expenseItemNameString费用名称
└─amountInteger费用预算
└─budgetAccountString预算科目
data 参数示例:
{
    "planNo": "202101100012",
    "empCode": "123321",
    "createUserExtend1": "",
    "corpCode": "931231231231323123",
    "companyCode": "ZT1",
    "costOrgCode": "33221",
    "createUserName": "张三",
    "strokeType": 1,
    "travelType": "10",
    "travelTypeName": "出差",
    "orgCode": "33221",
    "orgFullName": "研发部",
    "costCenterCode": "CL0009111",
    "costCenterName": "发展中部门",
    "createDate": "168237237231",
    "costOrgId": "456",
    "projectCode": "999",
    "projectName": "造地铁",
    "expense": 12323,
    "paymentCorp": "珠海xxxxx有限公司",
    "extend1": "",
    "extend2": "",
    "travelReason": "去看看",
    "stage": "10",
    "travelUsers": [{
      "fullname": "赵",
      "empCode": "A001",
      "orgCode": "45332",
      "orgName": "研发部",
      "extend1": ""
    }],
    "travelItems": [{
      "originPlace": "10801",
      "originName": "上海",
      "originCountry": 2,
      "destPlace": "11546",
      "destName": "洛阳",
      "destCountry": 2,
      "arrivalTime": "2019-01-10",
      "departureTime": "2019-01-10",
      "travelMode": "FLIGHT",
      "remark": "",
      "applyStatus": 2,
      "travelReason": "去看看"
    }],
    "travelExpenseItems": [{
      "expenseItemId": 123,
      "expenseItemCode": "32132",
      "expenseItemName": "出差费用",
      "amount": 100,
      "budgetAccount": "造地铁工程"
    }]
}

待办消息推送 - 业务数据详解#

事件编码:
WF_NOTIFY_USER 待办消息发起事件
WF_COMPLETE_TASK 待办消息状态变更事件
data 参数说明:
参数类型说明
partnerCodeString企业编码
notifyTaskIdString待办任务id
taskIdString任务id
titleString消息头
summaryString描述
createEmpCodeString创建人编码
createEmpNameString创建人名称
approvedEmpCodeString审批人编码
approvedEmpNameString审批人名称
taskDateString发起待办时间
statusString待办状态(TODO:待办;DONE:已办)
data 参数示例:
[
  {
    "partnerCode":"cddd",
    "notifyTaskId":"123",
    "taskId":"1234",
    "title":"张三发起的待办",
    "summary":"在途实施,2023年8月26日-2023年8月27日,高阳县、上海",
    "createEmpCode":"112233",
    "createEmpName":"张三",
    "approvedEmpCode":"223344",
    "approvedEmpName":"李四",
    "taskDate":"2023-09-13 00:00:00",
    "status":"TODO"
  },
  {
    "partnerCode":"cddd",
    "notifyTaskId":"124",
    "taskId":"1235",
    "title":"张三发起的待办",
    "summary":"在途实施,2023年8月26日-2023年8月27日,高阳县、上海",
    "createEmpCode":"112233",
    "createEmpName":"张三",
    "approvedEmpCode":"223355",
    "approvedEmpName":"王五",
    "taskDate":"2023-09-13 00:00:00",
    "status":"DONE"
  }
]
上一页
2、事件列表
下一页
4、示例代码
Built with