酒店

【国内酒店】特殊取消工单接入指南更新时间:2023/02/09

一、订单模块

    1、hotel.order.detail接口

    增加Options(String)入参,不传时原逻辑,包含1时返回SpecialCancelApply(Boolean)字段,当为true时表示此时订单可以发起工单特殊取消。


二、工单模块

    1、hotel.sr.finddic接口

    分销商通过此接口获取自助工单类型,前端展示给用户。

    增加ShowType(String)入参,1、ToB:艺龙与分销商客服内部系统使用的工单类型 ;2、ToC:展示给C端客人服务类型。

    

    2、hotel.sr.create接口

    用户点选工单类型后调用创建工单接口完成工单生成,记录下对应SrId。


    3、hotel.sr.visual接口

    通过工单可视化信息接口获取工单进展信息。

    增加出参SrCategory(String) 工单类别,ProcessList(List<SrProcessBO>) 工单处理信息。


    示例:

        "SrCategory": "变更/取消",

        "ProcessList": [

            {

                "ProcessTime": "2022-09-02 16:34:38",

                "ProcessTitle": "申请已受理",

                "ProgressContent": "您的取消/修改申请已收到,马上为您分配专人跟进,请您耐心等待。",

                "Status": 1

            },

            {

                "ProcessTime": "2022-09-02 16:34:38",

                "ProcessTitle": "已完成",

                "ProgressContent": "您的取消/修改申请已结束,谢谢!",

                "Status": 5

            }

        ],

        

注意:

    1、需要区分获取SpecialCancelApply字段和不获取字段的订单详情调用请求,严格限制获取SpecialCancelApply字段的请求次数

      (仅客人真实请求订单详情时获取)。

    2、To B类型工单不可展示给客人;目前客人用于规则外取消的工单类型id(SrTypeId)为3558,变更取消(分销客人自助申请)。

    3、工单修改、工单催单可详见接口说明:hotel.sr.modifyhotel.sr.urge

    4、本次新增出入参字段将于近期上线,以更新后文档为准。(已上线)