批量保存合同详情

• 接口：/corp/contract/save

• Method：POST

• 数据格式：JSON

• 请求参数：

BudgetExecutingForm结构

CustomFormValue 结构（详细说明请参考-自定义字段参数说明）

AttachmentDto结构

注：fileUrl 与 base64 二选一必填一个,fileUrl优先

• 该接口采用单条失败的处理方式，即整批数据中，如果只有其中的几条因为各种原因失败，那么只有那几条数据不会被保存；其它的数据仍然会被正常处理；错误数据的位置会被放在errorData里面errorData为结构体，包含出错记录位置, 以及与之对应的出错信息； 类似 {"请检查第1条数据": "供应商编码不正确"}; 具体参见失败实例;

• 请求示例：包含分期付款组件导入

installmentFieldValues 参数

• 请求示例：

{
    "data":[
        {
            "contractId":"22",
            "contractName":"openApi导入分期合同名字",
            "totalAmount":999,
            "applicantUserEmployeeId":"200070",
            "agentUserEmployeeIds":[
                "200070"
            ],
            "supplierBizCode":"FW00001900",
            "departmentBizCode":"www",
            "subsidiaryBizCode":"test",
            "formSubTypeBizCode":"PLC2112281HR4V7NK",
            "externalLink":"",
            "freezeBudget":false,
            "contractType":"append",
            "mainContractBizCode":"MK822036121",
            "attachmentDtoList":[
                            {
                                "fileName":"picture1.png",
                                "fileUrl":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fc-ssl.duitang.com%2Fuploads%2Fitem%2F202105%2F29%2F20210529001057_aSeLB.thumb.1000_0.jpeg&refer=http%3A%2F%2Fc-ssl.duitang.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1661331430&t=4ccd64b1b51c96f6d8cb8e73851072ab"
                            },
 {
                                "fileName":"picture1.png",
                                "base64":"UEsDBBQACAgIAEZYpVQAAAAAAAAAAAAAAAAJAAAAZG9jUHJvcHMvAwBQSwc..."
                            }

],
            "customFormValues":[
                {
                    "identifier":"field10",
                    "value":"",
                    "installmentFieldValues":[
                        {
                            "field10-1":100,
                            "field10-2":"2021-03-29",
                            "field10-3":"PAID",
                            "customRowNo":"" 
                        },
                        {
                            "field10-1":200,
                            "field10-2":"2021-03-30",
                            "field10-3":"UNPAID",
                            "customRowNo":""
                        }
                    ]
                }
            ]
        }
    ]
}

• 请求示例1:不控制金额的合同（不能占用预算）

{
  "timestamp": "1488522206",
  "data": [
    {
      "contractId": "AA0044",
      "contractName": "不控金额示例合同",
      "totalAmount": "",//可以是任意数值
      "fulfillAmount": 0,
      "applicantUserEmployeeId": "EM10001",
      "agentUserEmployeeIds": [
        "EM10000",
        "EM10002"
      ],
      "supplierBizCode": "1231",
      "externalLink": "www.test.com/AA0044",
      "subsidiaryBizCode": "EM-SUB1",
      "departmentBizCode": "EM-DEP1",
      "formSubTypeBizCode": "EM-FORM",
      "freezeBudget": false//必须为false
    }
  ]
}

• 请求示例2：控制金额但不占预算的合同

{
  "timestamp": "1488522206",
  "data": [
    {
     "contractId": "AA0044",
      "contractName": "控制金额不占预算示例合同",
      "totalAmount": "100",
      "fulfillAmount": 0,
      "applicantUserEmployeeId": "EM10001",
      "agentUserEmployeeIds": [
        "EM10000",
        "EM10002"
      ],
      "supplierBizCode": "1231",
      "externalLink": "www.test.com/AA0044",
      "subsidiaryBizCode": "EM-SUB1",
      "departmentBizCode": "EM-DEP1",
      "formSubTypeBizCode": "EM-FORM",
      "freezeBudget": false
    }
  ]
}

• 请求示例1：控制金额并且占预算的合同

{
  "timestamp": "1488522206",
  "data": [
    {
      "contractId": "AA0044",
      "contractName": "占预算示例合同",
      "totalAmount": "100",
      "fulfillAmount": 0,
      "applicantUserEmployeeId": "EM10001",
      "agentUserEmployeeIds": [
        "EM10000",
        "EM10002"
      ],
      "supplierBizCode": "1231",
      "externalLink": "www.test.com/AA0044",
      "subsidiaryBizCode": "EM-SUB1",
      "departmentBizCode": "EM-DEP1",
      "formSubTypeBizCode": "EM-FORM",
      "freezeBudget": true,
      "budgetExecutingForms": [{
        "budgetaryAccountBizCode": "EM-BA1",
        "budgetEntryTargetType": "SUBSIDIARY",
        "budgetAttributionDate": "2018-06-15",
        "departmentBizCode": "111",
        "auxAccountingBizCode": "",
        "subsidiaryBizCode": "SUB1",
        "employeeId": ""
      }]
    }
  ]
}

• 返回示例:上传成功的返回

{
    "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
}

合同单据类型的详情页面：

有一个开关---根据合同金额对关联对公支付单的支付金额进行控制

1、开关打开，合同控制金额，接口传入该类型的合同：合同金额必填，值大于0，可以占用预算；

2、当开关关闭时，合同不控制金额，接口传入该类型的合同：合同金额不必填（可以填写任意数值），不可以占预算（即"freezeBudget"字段的值必须为false ）