修改

请求地址

https://api.es.xiaojukeji.com/river/Approval/update

返回数据格式

JSON

请求类型

POST

请求参数

travel_detail

trips

business_trip_detail（按次数）

business_trip_detail（按日期）

注意事项

1. 计算签名时候，需要对travel_detail或者business_trip_detail值做 json_encode 处理成字符串格式，再参与签名；
2. approval_type=1时，用过车的城市之后的城市可以修改，之前的无法修改；
3. 修改时，凡是涉及到有日期规定的，规定的最晚时间必须大于修改时的时间。

可修改内容

1. 修改申请单开始时间
   仅当申请单内行程未开始时（开始时间>当前时间，且审批单下未产生有效订单），审批单开始时间允许修改，可以修改到的时间为当天之后，审批单结束时间之前
   
   
2. 修改申请单结束时间
   结束时间可以修改为当天及以后，即 newEndTime ≥ 当前日期 ，时间修改后，所有已用车城市的规则有效时间会被更新，未用车城市规则被删除然后重新创建
   
   
3. 修改差旅行程
   a. 当差旅制度-出差城市配置为“需填写城市，无需填写具体出行时间”（city_type = 1）或“需填写城市，需填写具体出行时间”（city_type = 2）时，未发生用车/机酒火订单时：删除旧的差旅行程信息和规则，生成新的行程和规则； 已发生用车/机酒火订单时：已预订城市行程不允许修改，未预订城市行程可以修改。比如差旅行程为：北京-上海，上海-北京。如果上海发生了预订，那么北京-上海的行程是不允许修改的，上海-北京允许修改。
   b. 当差旅制度-出差城市配置为无需员工填写时出发地、目的地城市传空
   
   
4. 修改用车总次数
   增加总次数无校验；减少总次数时，校验已使用次数，若小于已使用次数，无法修改
   
   
5. 修改用车总限额
   总限额需大于0，修改后的总限额需大于等于已用额度
   
   
6. 修改每单限额
   a. 每单限额需大于0
   b. 修改后的限额需大于等于已用额度
   c. 每单限额是否生效取决于制度内配置是否启用每单限额
   
   
7. 修改机票酒店火车票总次数
   修改后的次数需大于等于已用次数
   
   
8. 修改行程起点终点城市是否包含市内用车和酒店

差旅请求参数示例：

{   
    "client_id": "xxxxxx", 
    "access_token": "xxxxx", 
    "timestamp": 1583487394, 
    "company_id": "xxxxxx", 
    "approval_id": "xxxxxx",
    "approval_type": "1",
    "travel_detail": {
        "start_date": "xxxxxx",
        "end_date": "xxxxxx",
        "end_city_rule": "xxx",
        "trips": [
            {
                "departure_city_id": "110000",
                "departure_city": "北京",
                "destination_city_id": "310000",
                "destination_city": "上海",
                "start_time": "2017-03-01",
                "end_date": "2017-03-03"
            },
           {
                "departure_city_id": "310000",
                "departure_city": "上海",
                "destination_city_id": "410000",
                "destination_city": "深圳",
                "start_time": "2017-03-03",
                "end_date": "2017-03-05"
            },
            {
                "departure_city_id": "410000",
                "departure_city": "深圳",
                "destination_city_id": "110000",
                "destination_city": "北京",
                "start_time": "2017-03-05",
                "end_date": "2017-03-08"
            }
        ]
    },
    "sign": "xxxxxxxx"
}

请求示例

curl -X POST -H "content-type:application/json" \
-d '{"client_id":"client_id_test","access_token":"access_token_test","timestamp":1583487394,"company_id":"12345678980","phone":"11000001234","approval_id":"781948394919012","approval_type":1,"travel_detail":{"start_time":"2019-08-25","end_time":"2019-08-29","end_city_rule":1,"trips":[{"departure_city":"\u5317\u4eac\u5e02","departure_city_id":1,"destination_city":"\u4e0a\u6d77\u5e02","destination_city_id":11,"start_date":"2019-08-25","end_date":"2019-08-29"}]},"sign":"e54dbce9b2c6a60f6544507e280df77c"}' \
https://api.es.xiaojukeji.com/river/Approval/update

返回示例

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": null

}

接口错误解决方案

通用错误解决文档

1. 4xx 错误
2. 1xxx 错误

50503(请求失败(审批单更新失败))

1. 审批单id不在company_id这个公司中(请检查approval_id填写是否正确)
2. 修改的某个行程正在使用中
3. 修改的某个行程已经被使用过