滴滴企业版

接口说明

说明

审批事件：滴滴企业级内部审批各个环节所产生的事件。（审批流程的触发与操作，均在滴滴企业版 APP 内完成）

有两种用法：

（1）需通过客户的IM、OA平台提请审批流程相关人员及时关注审批进度。如果需要更多订单信息辅助决策，可通过审批事件回调+订单详情使用。注意，订单详情产生可能晚于回调，可在收到回调后，延迟一段时间后再获取订单。

（2）获取审批流程发起情况，客户将审批流程集成到自己的系统中，并写入审批结果。可结合外部审批处理接口使用，但请注意，此时滴滴内部审批流依然需要配置审批人，且仅有部分场景支持，详情参见外部审批处理结果文末的说明。

接入方式：

客户需要提供地址，并监听对应类型的回调

注意

消息接收方，需要按照本文档开发接口，并提供对应的接收地址
需要项目上联系滴滴企业版对接人，申请对外推送的权限，并配置回调地址

基本信息

HTTP URL	对接方提供
HTTP Method	POST
权限要求

请求头

参数名称	参数值
Content-Type	application/json

请求参数

字段名	字段说明	字段类型	必填	备注
company_id	租户唯一标识	string	Y	滴滴企业版租户唯一 ID，代表当前操作的企业主体
timestamp	当前时间戳	int	Y	当前时间戳，精确到秒级
sign	签名	string	Y	根据规则生成的接口签名，用于校验请求合法性与完整性；生成方式参见【接口认证-授权认证】
notify_type	通知类型	int	Y	审批事件回调，需监听notify_type=2的回调，其他回调如果未配置白名单则不会推送，无需关注枚举值数字： 0：商旅超标审批回调 1：预订中审批单取消回调 2：审批事件回调 3：用车行后审批催办回调
desc	回调描述	string	Y
uniq_id	回调唯一key	string	Y
callback_data	回调数据	call_back	Y	参考callback详情描述

callback详情描述

字段名	字段说明	字段类型	必填	备注
company_id	租户唯一标识	int	Y	滴滴企业版租户唯一 ID，代表当前操作的企业主体
requisition_id	审批单ID	string	Y	滴滴侧审批单ID
type	单据类型	int	Y	枚举值数字： 1：用车 2：差旅 3：用车行后审批 7：机票预订审批 8：酒店预订审批 9：机票改签审批 10：国际机票预订审批 11：国际酒店预订审批 12：国际机票改签审批 13：火车票预订审批 14：用车付前审批 15：火车票改签审批 16：机票退票费用归属审批
action_type	审批动作类型	int	Y	枚举值数字： 1：创建（流程发起） 2：驳回（任意一个节点驳回） 3：通过并转交（审批流配置了多个节点，一个节点通过，到下一个节点审批） 4：通过（审批流所有节点都通过） 5：取消（行后时为申诉取消） 6：超时驳回 7：申诉 8：会签部分通过（节点为会签模式，其中部分人员通过） 13：知会
last_action_id	最后一次审批操作 ID	string	Y
curr_action_id	当前审批操作ID	string	Y
approval_info	触发当前动作的审批人信息	approval_info	Y	参考approval_info
requisition_info	申请单详情	requisition_info	Y	参考requisition_info
create_time	消息创建时间，毫秒级时间戳	int	Y
uniq_id	唯一标识	string	Y

approval_info

字段名	字段说明	字段类型	必填	备注
approval_id	申请单滴滴侧ID	string	Y
out_approval_id	外部申请单编号	string	N	如果通过API创建申请单，为客户侧自定义的申请单编号
event_create_person	事件触发人信息	person_info	Y	事件触发人信息，可能为null，自动审批场景；格式参考person_info
inform_infos	当前知会人列表	`list<person_info>`	N	当前节点知会人列表，无知会时为空；格式参考person_info
curr_approver_infos	当前节点审批人列表	`list<person_info>`	Y	当前节点审批人列表，创建审批单节点为空；格式参考person_info
next_approver_infos	下一级审批人信息	`list<person_info>`	Y	下一级审批人信息，可能多人，可能为空；格式参考person_info
desc	驳回原因	desc_info	Y	格式参考desc_info

person_info

字段名	字段说明	字段类型
member_id	滴滴侧员工主键	string
name	员工姓名	string
phone	手机号	string
employee_number	工号	string
email	邮箱	string

desc_info

字段名	字段说明	字段类型	必填	备注
remark	审批备注信息	string	Y

requisition_info

字段名	字段说明	字段类型	必填	备注
pre_info	预订申请单	pre_info	Y	预订申请单（机酒火），格式参考pre_info
after_info	行后审批单	after_info	Y	行后审批单（用车），格式参考after_info
travel_request	差旅申请单	travel_request	Y	差旅审批单，格式参考travel_request
car_request	用车申请单	car_request	Y	用车审批单，格式参考car_request

pre_info

字段名	字段说明	字段类型	必填	备注
order_id	订单号	string	Y
applier	申请人	person_info	Y
create_time	创建时间	int	Y	秒级的时间戳

after_info

字段名	字段说明	字段类型	必填	备注
order_id	订单号	string	Y
applier	申请人	person_info	Y
create_time	创建时间	int	Y	秒级的时间戳

travel_request

字段名	字段说明	字段类型	必填	备注
applier	申请人	person_info	Y
create_time	创建时间	int	Y	秒级的时间戳

car_request

字段名	字段说明	字段类型	必填	备注
applier	申请人	person_info	Y
create_time	创建时间	int	Y	秒级的时间戳

callback_data示例

预订审批单示例

{
        "company_id":"1125915646167936",
        "requisition_id":"1125923953605571",
        "type":13,
        "action_type":3,
        "last_action_id":"1125923953635010",
        "curr_action_id":0,
        "approval_info":{
            "approval_id":"1125923953579333",
            "event_create_person":{
                "member_id":"1125915646212716",
                "phone":"11100011245",
                "email":"caozhengbo@didi.com",
                "employee_number":"caozhengbo01"
            },
            "curr_approver_infos":[
                {
                    "member_id":"1125915646212716",
                    "phone":"11100011245",
                    "email":"caozhengbo@didi.com",
                    "employee_number":"caozhengbo01"
                }
            ],
            "next_approver_infos":[
                {
                    "member_id":"1125915646212716",
                    "phone":"11100011245",
                    "email":"caozhengbo@didi.com",
                    "employee_number":"caozhengbo01"
                }
            ],
            "desc":{
                "remark":""
            }
        },
        "requisition_info":{
            "pre_info":{
                "order_id":"1125923953548512",
                "applier":{
                    "member_id":"1125915646212716",
                    "phone":"11100011245",
                    "email":"caozhengbo@didi.com",
                    "employee_number":"caozhengbo01"
                },
                "create_time":1693826543
            },
            "after_info":null
        }
    }

行后审批单示例

{
        {
        "company_id":"1125915646167936",
        "requisition_id":"1125923953605571",
        "type":13,
        "action_type":3,
        "last_action_id":"1125923953635010",
        "curr_action_id":0,
        "approval_info":{
            "approval_id":"1125923953579333",
            "event_create_person":{
                "member_id":"1125915646212716",
                "phone":"11100011245",
                "email":"caozhengbo@didi.com",
                "employee_number":"caozhengbo01"
         },
            "curr_approver_infos":[
                {
                    "member_id":"1125915646212716",
                    "phone":"11100011245",
                    "email":"caozhengbo@didi.com",
                    "employee_number":"caozhengbo01"
                }
            ],
            "next_approver_infos":[
                {
                    "member_id":"1125915646212716",
                    "phone":"11100011245",
                    "email":"caozhengbo@didi.com",
                    "employee_number":"caozhengbo01"
                }
            ],
            "desc":{
                "remark":"自动驳回"
            }
        },
        "requisition_info":{
            "after_info":{
                "order_id":"1125923953548512",
                "applier":{
                    "member_id":"1125915646212716",
                    "phone":"11100011245",
                    "email":"caozhengbo@didi.com",
                    "employee_number":"caozhengbo01"
                },
                "create_time":1693826543
            },
            "pre_info":null
        }
    }

付前审批示例

{
    “callback_data“: {
        “action_type“: 1,
        “approval_info“: {
            “approval_id“: “1125930713453307“,
            “curr_approver_infos“: [],
            “desc“: {
                “remark“: ““
            },
            “event_create_person“: null,
            “next_approver_infos“: [
                {
                    “email“: ““,
                    “employee_number“: “zhoucailin2“,
                    “member_id“: “1125924541410947“,
                    “name“: “周彩林“,
                    “phone“: “00016197654“
                }
            ]
        },
        “company_id“: “1125915646167936“,
        “create_time“: 1712114482033,
        “curr_action_id“: “1125930713436873“,
        “last_action_id“: ““,
        “requisition_id“: “1125930713401562“,
        “requisition_info“: {
            “after_info“: {
                “applier“: {
                    “email“: ““,
                    “employee_number“: “zhoucailin2“,
                    “member_id“: “1125924541410947“,
                    “name“: “周彩林“,
                    “phone“: “00016197654“
                },
                “create_time“: 1712114479,
                “order_id“: “1125930713317420“
            },
            “car_request“: null,
            “pre_info“: null,
            “travel_request“: null
        },
        “type“: 14,
        “uniq_id“: “7861ffaa-3001-4dec-bce7-2cf62b0338f1“
    },
    “company_id“: “1125915646167936“,
    “desc“: ““,
    “notify_type“: 2,
    “sign“: “357aea2f150b36e4b402dac2d60c3ac3“,
    “timestamp“: 1712114482,
    “uniq_id“: “7861ffaa-3001-4dec-bce7-2cf62b0338f1“
}

版本记录

日期	更新人	更新内容	上线时间
2024.02.18	陈继诗	迁移文档
2024.04.07	陈继诗	增加付前审批callback信息
2025.08.06	唐腾飞	单据类型新增 15：火车票改签审批 16：机票退票费用归属审批	2025.08.06
2025.09.08	唐腾飞	增加知会对象	2025.09.08
2025.04.17	谢朱莉	更新文档描述