批量修改合同

  • 接口：/corp/contract/update

  • Method：POST

  • 数据格式：JSON

  • 请求参数：

参数 类型 是否必填 描述
contractId String Y 合同编号
totalAmount BigDecimal N 合同总金额
agentUserEmployeeIds array N 责任人工号,不传入参数则不修改责任人,不能与active同时为空
agentDepartmentBizCodes array N 责任部门
active boolean N 停用/终止(false)/启用合同(true),不传则不修改合同的状态，不能与agentUserEmployeeIds同时为空
cancel boolean N 作废合同(true),不传或者false不生效
customFormValues CustomFormValue数组 N 自定义表单内容

image-分期付款导入合同示意图.png

  • 返回数据：

    该接口采用单条失败的处理方式，即整批数据中，如果只有其中的几条因为各种原因失败，那么只有那几条数据不会被保存；其它的数据仍然会被正常处理；错误数据的位置会被放在errorData里面errorData为结构体，包含出错记录位置, 以及与之对应的出错信息； 类似 {"请检查第1条数据": "供合同编号不存在"}; 具体参见失败实例; 当使用该接口终止合同时，如果该采购合同占用了预算，会释放占用的预算，但是通过本接口启用该合同时不会占用预算。

CustomFormValue 参数 （详细说明请参考-自定义字段参数说明）
参数 类型 描述
identifier string 自定义字段占位符
value string 自定义字段内容
installmentFieldValues List<Map<String,String>> 分期付款类型字段
detailFieldValues List<Map<String,String>> 明细类型字段

installmentFieldValues 参数

参数 类型 描述
installmentFieldValues List<Map<String,String>> 分期付款类型字段
fieldXX-1 付款金额
fieldXX-2 付款日期
fieldXX-3 支付状态（PAID-已支付）（UNPAID-未支付）
componentDataCode 更新付款计划对应期数编码（不传表示新增）
customRowNo 若用户系统维护了合同付款计划期数行ID,可传该参数与每刻期数行ID（componentDataCode）映射
  • 请求示例：
{
  "timestamp": "1523274893703",
  "data": [
    {
      "contractId": "CC20180409",
      "totalAmount": 30000,
      "agentUserEmployeeIds":["001","10006"],
      "active":true,
      "customFormValues":[
                {
                    "identifier":"field5",
                    "value":"",
                    "installmentFieldValues":[
                        {
                            "field5-1":10000,
                            "field5-2":"2021-03-29",
                            "field5-3":"PAID",
                            "componentDataCode":"CDC2207061NTN0V40"
                        },
                        {
                            "field5-1":20000,
                            "field5-2":"2021-03-30",
                            "field5-3":"UNPAID",
                            "componentDataCode":"CDC2207061NTN17R4"
                        }
                    ]
                },{
               "identifier":"field12",
               "value":"1234测试"
}
            ]
    }
  ]
}
  • 返回示例:上传成功的返回
{
    "code": "ACK",
    "message": "",
    "data": {},
    "args": null,
    "linkDetail": false,
    "nonBizError": false
}
  • 返回示例2:上传失败的返回
{
    "code": "NACK",
    "message": null,
    "data": {
        "请检查第1条数据": "合同编号不存在"
    },
    "args": null,
    "linkDetail": false,
    "errorData": {
        "请检查第1条数据": "合同编号不存在"
    },
    "nonBizError": false
}

results matching ""

    No results matching ""