携程创建/回复事件接口

更新时间： 2024-01-19 必须接入 在线调试（沙箱环境）

接口概述

1、该接口用于携程向合作方发起事件工单，包含客服事件和判罚事件。
2、客服事件仅支持一来一回，不支持多轮往复沟通，即携程发起事件→合作方回复事件、合作方发起事件→携程回复事件，回复后就会关闭当前事件
3、判罚事件支持多轮沟通，如：携程发起判罚→合作方发起申诉→携程回复申诉→合作方继续申诉，直至达到最大次数→判罚执行结果通知

请求地址

地址格式:  {Domain}/JNT/createorderevent/2.0/{timeStamp}/{sign}

请求内容

CancelOrderRequest

参数 类型 必传 描述 示例 备注
ctripPurchaseOrderID Long 是 携程采购单号 881823967638342968 18位
masterOrderId Long 是 携程用户订单号 12744251457  
vendorOrderId String 否 供应商订单号 客服事件必传，判罚事件可能为空  
parentCategoryCode String 否 产线：接送机 jnt, 包车 day, 打车 rtn 无单判罚可能为空  
serviceProviderId Long 是 服务商ID    
ctripEventId Long 是 携程事件唯一ID或判罚唯一ID，事件+每次交互时都是个新id，判罚为固定id    
ctripOldEventId Long 否 用于事件回复场景，表明回复的是哪一个事件    
eventSource Integer 是 事件来源：1-客服事件 2-判罚事件    
content String 是 事件单通知或回复时的内容 或 判罚单的内容(判罚单的长度最长为1200)，支持HTML语法    
eventSubject String 否 事件主题，系统针对进线内容自动做的诉点总结，用于快速预览事件内容，仅在eventSource=1时有值 包含多个标签，|分隔；如："司机迟到|服务态度差|接驳点难找"  
deadLine String 是 回复截止事件或者判罚下的申诉截止时间，格式"yyyy-MM-dd HH:mm:ss",判罚不可申诉时为空    
eventDetail EventDetailDTO 否 客服事件详情，eventSource=1时必填    
punishDetail PunishDetailDTO 否 判罚详情，eventSource=2时必填    
enclosure List<EnclosureDTO> 否 附件，判罚不发附件    

EventDetailDTO

参数 类型 必传 描述 示例 备注
eventTypeId Integer 是 事件类型ID    
eventTypeName String 否 事件类型名称，如：司机迟到    
operator String 否 处理人id，如：S60805    
singleCallBack Bool 否 回执结果，通常用于核实类事件，true=属实/同意，false=不属实/不同意    

PunishDetailDTO

参数 类型 必传 描述 示例 备注
noticeType Integer 是 1为判罚单变更，2为判罚回复申诉    
appealId long 否 申诉id，在appealable=1时，该id不为空，申诉时需携带该id    
punishCreateTime string 是 判罚创建时间，yyyy-MM-dd HH:mm:ss    
maxAppealTime Integer 是 最大申诉次数    
appealTime Integer 是 已申诉次数    
punishContentDetail List<PunishContent> 是 处罚明细    
appealReplyContent string 否 回复申诉的内容，最长为500个字符    
surplusAppealCount Integer 是 剩余可申诉次数    
appealable Integer 是 申诉状态 0-不可申诉,1-可申诉    
appealStatus string 是 appealing 待申诉对象处理，auditing 待申诉专员回复,failed 申诉失败，passed 申诉成功    
appealResult String 是 申诉结果    
firstFoulReasonCode String 是 一级违规原因code    
firstFoulReasonName String 是 一级违规原因名称    
secondFoulReasonCode String 是 二级违规原因code    
secondFoulReasonName String 是 二级违规原因名称    
appealReason List<AppealLabelDTO> 是 可供选择的申诉原因及code    
punishOrderStatus Integer 是 判罚单状态 0-待执行,1-已执行,2-已取消    
punishObjectType Integer 是 处罚对象类型 1-司机，2-供应商 3-都罚    
punishTargetId String 是 处罚对象ID    

EnclosureDTO

参数 类型 必传 描述 示例 备注
fileType String 是 文件类型（全小写），详见文件类型页签    
fileName String 是 文件名    
fileUrl string 否 文件地址    

PunishContent

参数 类型 必传 描述 示例 备注
punishWeight String 是 处罚力度，数字字符串    
punishWeightUnit String 是 处罚力度单位，时间单位：point分 hour时 day天；金额单位：CNY人民币 USD美元等    
punishWeightUnitType String 是 处罚力度单位类型 point分，time时间，currency货币，percent百分比（代表按订单金额的百分比罚款）  
punishWay String 是 处罚方式：1罚款 2下线 3冻结，后两种方式的处罚以时间为单位    

AppealLabelDTO

参数 类型 必传 描述 示例 备注
labelCode String 是 标签code    
labelName String 是 标签名称    
needAppealCertificate bool 是 是否必传凭证    
appealCertificateRequirement String 是 材料要求描述    
tips list<String> 否 其他提示    

返回内容

CancelOrderResponse

参数 类型 必传 描述 示例 备注
msgCode String 是 响应码 OK 响应码
message String 否 响应详情 成功 响应码
vendorEventId String 是 供应商的事件ID（仅用于排障）    

请求示例

{
    "ctripPurchaseOrderId": 145904152397791301,
    "masterOrderId": 29111813706,
    "vendorOrderId": "23C4Q5K9SKWTW32",
    "parentCategoryCode": "jnt",
    "serviceProviderId": "1000009",
    "ctripEventId": 231943412,
    "eventSource": 1,
    "content": "客人表示：我们是七点四十五到上海虹桥站，约八点能走到停车场，请王师傅准时到停车场位置，并告知在哪个停车场，不要迟到，我们后续还有事情。烦请通知司机准时服务，提前联系客人。我处联系司机电话无人接听。谢谢",
    "deadLine": "2023-12-28 15:47:37",
    "eventDetail": {
        "eventTypeId": 8892,
        "eventTypeName": "反馈司机服务",
        "operator": "N14604"
    },
    "ctripParentEventId": "231943412"
}

响应示例

{
    "msgCode": "OK",
    "massage": "成功",
    "vendorEventId":"21139262"
}

异常示例

{
    "msgCode": "Error",
    "massage": ""
}

results matching ""

    No results matching ""