合作方创建/回复事件接口

更新时间：2022-11-06 在中国大陆提供服务的供应商必须接入，在中国港澳台地区及中国境外提供服务的供应商建议接入。在线调试（沙箱环境）

接口概述

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

请求地址

地址格式: {Domain}/JNT-{vendorID}/event/push/2.0/{ctripPurchaseOrderID}/{timeStamp}/{sign}

请求内容

ConfirmOrderRequest

参数	类型	必传	描述	示例	备注
ctripPurchaseOrderId	Long	是	携程订单号，下单接口中返回
vendorOrderId	String	是	供应商订单号
serviceProviderId	Long	是	服务商ID
eventSource	Integer	是	事件来源：1-客服事件，2-判罚事件
pushType	Integer	是	推送类型 1-创建，2-回复，注：判罚事件仅支持回复（即申诉）
vendorEventId	String	是	客服或判罚事件传输后，供应商提供的唯一ID（仅用于排障）
ctripEventId	Long	否	用于回复事件场景，客服事件填最新的事件id，判罚事件填申诉id，表明回复的是哪一个事件或判罚
eventTypeId	Integer	否	事件类型ID，eventSource = 1 时必填	事件类型清单
content	String	是	事件单的回复内容或者判罚申诉补充内容，HTML语法
singleCallBack	Bool	否	回执结果，仅在eventSource=1&&pushType=2时有值，通常用于核实类事件，true=属实/同意，false=不属实/不同意
operator	String	是	处理人ID，用于线上排查问题
punishId	long	否	判罚id，申诉时传值（即eventSource==2&&pushType==2）
appealId	long	否	申诉id，申诉时不为空（即eventSource==2&&pushType==2）
appealOperate	String	否	申诉操作： "CONFIRM"-接受处罚， "APPEAL"-发起申诉，回复判罚事件时不为空
appealCode	String	否	申诉code，填判罚时接口中的AppealLabelDTO的code，申诉时不为空
appealReason	String	否	申诉原因，填判罚接口中的AppealLabelDTO的标签名称，申诉时不为空
enclosure	List<EnclosureDTO>	否	附件

EnclosureDTO

参数	类型	必传	描述	示例	备注
fileType	String	是	文件类型（全小写）	文件类型清单
fileName	String	是	文件名
fileUrl	string	否	文件地址，申诉判罚事件时必填，填上传至携程服务器后生成的文件链接

返回内容

ConfirmOrderResponse

参数	类型	必传	描述	示例	备注
msgCode	String	是	响应码	OK	响应码
message	String	否	响应详情	成功	响应码
eventId	String	是	客服事件场景下为携程侧的事件ID，判罚场景下为判罚单ID

请求示例

{
    "content": "您反馈的问题，经核实订单全程录音及行程相关信息，投诉成立【退车费 30.6元】，非常抱歉给您带来不好的体验，司机问题已按平台规则对司机做出严肃处理，平台将持续加强监管，感谢您的理解与支持。",
    "ctripEventId": "231277355",
    "ctripPurchaseOrderId": "145564098833989758",
    "eventSource": 1,
    "eventTypeId": "",
    "operator": "阳光客服",
    "pushType": 2,
    "serviceProviderId": 1000009,
    "vendorEventId": "23C21118312",
    "vendorOrderId": "23C4PPEE1BWS0BT"
}

响应示例

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

异常示例

{
    "msgCode": "ERROR_URL_PARAM",
    "massage": "错误的URL格式"
}

results matching ""

No results matching ""