对公支付新增

接口: /corp/reimburse/save POST JSON

请求参数

参数 类型 必须 默认值 主键 描述
businessCode String N 单据号
formSubTypeBizCode String Y 单据类型编码
subsidiaryBizCode String Y 所属业务实体编码
collectionCurrency String Y 收款币种, 例:CNY,USD
departmentBizCode String Y 承担部门编码
coverUserEmployeeId String Y 承担员工工号
applyDepartmentBizCode String Y 申请部门编码
applyUserEmployeeId String Y 申请员工工号
agentUserEmployeeIds List<String> Y 责任人工号
corpReimburseName String Y 申请事由
comments String N 备注
remittanceNotes String N 汇款备注
supplierBizCode String Y 供应商编码 单供应商必须
supplierAccountBizCode String Y 供应商账号编码 单供应商必须
enterprisePaymentAccountBizCode String N 企业支付账号编码
costTrackings List<CostTrackingItemDto> N 辅助核算
corpFees List<CorpFeeDto> N 到票未支付业务
corpPayments List<CorpPaymentDto> N 未到票预付业务
completed boolean N false 是否已经完成
completedTime String 当completed = true时,必填 完成时间,格式:yyyy-MM-dd
customFormValues List<CustomFormValue> N 自定义表单内容 (不支持自定义字段-附件)
muchSupplier boolean N false 是否是多供应商,true/false,默认false必须
estimatedPaymentTime String N 要求支付时间,格式为yyyy-mm-dd
corpContractInfoDto CorpContractInfoDto N 关联合同信息

CorpContractInfoDto 结构

参数 类型 必须 默认值 主键 描述
businessCode String Y 合同单据号
contractComponentDataCodeList List N 关联分期期数编码(分期合同需必填)

CostTrackingItemDto 结构

参数 类型 必须 默认值 主键 描述
costTrackingItemBizCode String Y 辅助核算选项编码
costTrackingName String N 辅助核算名称(若系统中存在相同的辅助核算选项编码,可以使用该字段区分)

CorpFeeDto 结构

参数 类型 必须 默认值 主键 描述
feeTypeBizCode String Y 费用类型编码
feeAmount String Y 到票金额
consumeTime String Y 开票时间,格式:yyyy-MM-dd
currentDeductionAmount String Y 本期支付金额
comments String Y 消费事由
costTrackings List<CostTrackingItemDto> N 辅助核算
allocatedFlag boolean N false 是否分摊
allocatedType String N 分摊类型,可选值:
RATIO - 比例分摊
AMOUNT - 金额分摊
feeAllocations List<CorpFeeAllocationDto> N 分摊数据
supplierBizCode String N 供应商编码 多供应商必须
supplierAccountBizCode String N 供应商账号编码 多供应商必须
enterprisePaymentAccountBizCode String N 企业支付账号编码
remittanceNotes String N 汇款备注
customFormValues List<CustomFormValue> N 自定义表单内容 (不支持自定义字段-附件和明细)

CorpFeeAllocationDto 结构

参数 类型 必须 默认值 主键 描述
allocatedAmount String Y 分摊金额
allocatedRatio String Y 分摊比列, 0 ~ 100
coverUserEmployeeId String Y 承担人工号
coverDepartmentBizCode String Y 承担部门编码
costTrackings List<CostTrackingItemDto> N 辅助核算

CorpPaymentDto 结构

参数 类型 必须 默认值 主键 描述
corpPaymentTypeBizCode String Y 对公支付类型编码
paymentAmount String Y 支付金额
estimatedDate String Y 预计到票时间,格式:yyyy-MM-dd
feeTypeBizCode String N 费用类型编码
allocatedFlag boolean N false 是否分摊
allocatedType String N 分摊类型,可选值:
RATIO - 比例分摊
AMOUNT - 金额分摊
allocations List<CorpPaymentAllocationDto> N 分摊数据
supplierBizCode String N 供应商编码 多供应商必须
supplierAccountBizCode String N 供应商账号编码 多供应商必须
enterprisePaymentAccountBizCode String N 企业支付账号编码
remittanceNotes String N 汇款备注

CorpPaymentAllocationDto 结构

参数 类型 必须 默认值 主键 描述
allocatedAmount String Y 分摊金额
allocatedRatio String Y 分摊比列, 0 ~ 100
coverUserEmployeeId String Y 承担人工号
coverDepartmentBizCode String Y 承担部门编码
costTrackings List<CostTrackingItemDto> N 辅助核算

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

参数 类型 是否必填 描述
identifier string Y 字段占位符
value string 字段内容
detailFieldValues List<Map<String,String>> 明细类型字段

该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(businessCode)会被放在errorData里面;

errorData为结构题, 包含出错记录主键(businessCode), 以及与之对应的出错信息; 类似 {"项目": "部门不存在"}; 具体参见失败实例;

为保持向后兼容, data也会包含有和errorData相同的记录,但后续可能会改变;

请求参数示例:

{
    "timestamp":1579085665,
    "data": [
        {
            "businessCode":"MK10020200",
            "formSubTypeBizCode": "FT1706021HW3W2KG",
            "subsidiaryBizCode": "S0001",
            "collectionCurrency": "CNY",
            "departmentBizCode": "DI1911191FRU6G23",
            "coverUserEmployeeId": "E999",
            "applyDepartmentBizCode": "DI1911191FRU6G23",
            "applyUserEmployeeId": "E999",
            "agentUserEmployeeIds": ["dadas"],
            "corpReimburseName": "openApi测试",
            "comments": "adsdasd",
            "supplierBizCode": "SUP1907181PMSH9XC",
            "supplierAccountBizCode": "A190716666600",
            "enterprisePaymentAccountBizCode": null,
            "costTrackings": [
                {
                    "costTrackingItemBizCode": "AIRPORT"
                }
            ],
            "corpFees": [],
            "corpPayments": [
                {
                    "corpPaymentTypeBizCode": "adsadas",
                    "paymentAmount": "0",
                    "estimatedDate": "2020-01-16",
                    "feeTypeBizCode": "T001"
                }
            ],
            "completed": true,
            "completedTime": "2020-01-15"
        }
    ]
}

返回成功参数示例:

{
    "code": "ACK",
    "message": "操作成功!",
    "data": null,
    "args": null,
    "linkDetail": false,
    "nonBizError": false
}

返回失败参数示例:

{
    "code": "NACK",
    "message": null,
    "data": {
        "MK10020200": "责任人[dadas]不存在"
    },
    "args": null,
    "linkDetail": false,
    "errorData": {
        "MK10020200": "责任人[dadas]不存在"
    },
    "warningData": null,
    "requestErrorData": [
        {
            "businessCode": "MK10020200",
            "formSubTypeBizCode": "FT1706021HW3W2KG",
            "subsidiaryBizCode": "S0001",
            "collectionCurrency": "CNY",
            "departmentBizCode": "DI1911191FRU6G23",
            "coverUserEmployeeId": "E999",
            "applyDepartmentBizCode": "DI1911191FRU6G23",
            "applyUserEmployeeId": "E999",
            "agentUserEmployeeIds": [
                "dadas"
            ],
            "corpReimburseName": "openApi测试",
            "comments": "adsdasd",
            "supplierBizCode": "SUP1907181PMSH9XC",
            "supplierAccountBizCode": "A190716666600",
            "enterprisePaymentAccountBizCode": null,
            "costTrackings": [
                {
                    "costTrackingName": null,
                    "costTrackingItemBizCode": "AIRPORT",
                    "costTrackingItemName": null,
                    "createdAt": null,
                    "updatedAt": null,
                    "active": false,
                    "subsidiaryCodes": null,
                    "visibleDepartmentCodes": null,
                    "visibleEmployeeIds": null
                }
            ],
            "corpFees": [],
            "corpPayments": [
                {
                    "corpPaymentTypeBizCode": "adsadas",
                    "paymentAmount": 0,
                    "estimatedDate": 1579132800000,
                    "feeTypeBizCode": "T001"
                }
            ],
            "completed": true,
            "completedTime": 1579046400000,
            "remittanceNotes": null
        }
    ],
    "nonBizError": false
}

results matching ""

    No results matching ""