6.5 付款计划创建-新合同履行

test-测试环境

https://oc-test.onecontract-cloud.com

POST

/api/hitf/v2p/rest/invoke/SFpFUk86T1JDSEVTVFJBVElPTjpISVRGLkFQSS5EQVRBX0lNUE9SVA==

应付台账外部系统回传付款计划创建-可批量进行数据处理

请求参数

Query 参数

domain

string

可选

示例值:

FULFILL_PAYMENTPLAN

Header 参数

Authorization

string

可选

默认值:

Body 参数application/json

data

array [object {20}]

批量数据集合

可选

contractUuid

string

合同UUID

可选

contractId

string

合同ID

可选

invoiceType

string

发票类型

必需

参考数据字典 600-INVOICE_TYPE

partyUuid

string

付款对象UUID（即收款方）

可选

相对方数据的uuid

planAmount

number

计划付款金额

必需

以元为单位，精确到分

sourceScheduleId

string

源付款计划ID

可选

根据此字段后续进行更新操作外部系统付款计划标识ID，该字段为空是默认为新增一条

paymentName

string

款项名称

必需

值集：HOCF_PAYMENT_PLAN_TERM_TYPE，通过【4.5 独立值集值查询】查询可用值

expenseItem

string

款项分类

可选

值集：CCFF.FUND_CATEGORY_PAYMENT
，通过【4.5 独立值集值查询】查询可用值

period

integer

期数

必需

planDate

string

计划付款日期

可选

格式：yyyy-MM-dd HH:mm:ss

startDate

string

计划开始时间

可选

格式：yyyy-MM-dd HH:mm:ss

endDate

string

计划结束时间

可选

格式：yyyy-MM-dd HH:mm:ss

contractNumber

string

合同编号

必需

合同uuid，合同ID 合同编号三者必填其中一个

currency

string

币种

可选

参考数据字典 1-CURRENCY

feeWithoutTax

number

不含税金额

可选

以元为单位，精确到分

tax

number

税额

可选

以元为单位，精确到分

taxRate

number

税率

可选

示例：0.1300

paymentStatus

string

支付状态

可选

固定"ALL_PAID" 全部支付

paidAmount

number

付款金额

可选

以元为单位，精确到分

receivedAmount

number

收票金额

可选

以元为单位，精确到分，仅该字段支持更新(注意：sourceScheduleId需有值)

示例

{
    "data": [
        {
            "contractUuid": "40bc458e7b6c4e7e9cdedc46c1eae35d",
            "contractId": "",
            "invoiceType": "03",
            "partyUuid": "0d575281caf84fd9b1c103440a7fcfcd",
            "planAmount": 100,
            "sourceScheduleId": "1626774519240",
            "paymentName": "RENT",
            "expenseItem": "LEASE",
            "period": 2,
            "planDate": "2022-05-08 23:00:00",
            "startDate": "2022-05-08 23:00:00",
            "endDate": "2023-05-08 23:00:00",
            "contractNumber": "CON_0120250425002",
            "taxRate": 0.13,
            "currency": "CNY",
            "feeWithoutTax": 87,
            "tax": 13,
            "paymentStatus": "",
            "paidAmount": 0,
            "receivedAmount": 0
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://oc-test.onecontract-cloud.com/api/hitf/v2p/rest/invoke/SFpFUk86T1JDSEVTVFJBVElPTjpISVRGLkFQSS5EQVRBX0lNUE9SVA==?domain=FULFILL_PAYMENTPLAN' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
            "contractUuid": "40bc458e7b6c4e7e9cdedc46c1eae35d",
            "contractId": "",
            "invoiceType": "03",
            "partyUuid": "0d575281caf84fd9b1c103440a7fcfcd",
            "planAmount": 100,
            "sourceScheduleId": "1626774519240",
            "paymentName": "RENT",
            "expenseItem": "LEASE",
            "period": 2,
            "planDate": "2022-05-08 23:00:00",
            "startDate": "2022-05-08 23:00:00",
            "endDate": "2023-05-08 23:00:00",
            "contractNumber": "CON_0120250425002",
            "taxRate": 0.13,
            "currency": "CNY",
            "feeWithoutTax": 87,
            "tax": 13,
            "paymentStatus": "",
            "paidAmount": 0,
            "receivedAmount": 0
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

message

string

接口返回信息

必需

result

object

接口返回结果

必需

data

array [object {1}]

业务数据集合

可选

batchId

string

批次ID

必需

数据追踪查询

success

boolean

接口返回状态

必需

true 表示成功，false表示失败

示例

{"message":"execute success","result":{"data":[{"expenseItem":"LEASE","objectVersionNumber":2,"supplierId":"12555668","feeWithoutTax":"87","endDate":"2023-05-08 23:00:00","lastUpdateDate":"2025-05-06 17:16:43","sourceSystem":"DEFAULT","contractUuid":"40bc458e7b6c4e7e9cdedc46c1eae35d","batchId":"7ecb6832-f2f0-41b3-9dff-7d6cf3ed51be","partyUuid":"0d575281caf84fd9b1c103440a7fcfcd","signSubjectId":"12555621","receiverId":"12556106","contractCreatedBy":"695643182304997376","invoiceType":"03","currency":"CNY","originData":"{\"contractUuid\":\"40bc458e7b6c4e7e9cdedc46c1eae35d\",\"contractId\":\"\",\"invoiceType\":\"03\",\"partyUuid\":\"0d575281caf84fd9b1c103440a7fcfcd\",\"planAmount\":100,\"sourceScheduleId\":\"1626774519240\",\"paymentName\":\"RENT\",\"expenseItem\":\"LEASE\",\"period\":2,\"planDate\":\"2022-05-08 23:00:00\",\"startDate\":\"2022-05-08 23:00:00\",\"endDate\":\"2023-05-08 23:00:00\",\"contractNumber\":\"CON_0120250425002\",\"taxRate\":0.13,\"currency\":\"CNY\",\"feeWithoutTax\":87,\"tax\":13,\"paymentStatus\":\"\",\"paidAmount\":0,\"receivedAmount\":0}","id":"3315","lang":"zh_CN","paymentName":"RENT","paymentStatus":"","lastUpdatedBy":"0","period":"2","sourceScheduleId":"1626774519240","contractNumber":"CON_0120250425002","tax":"13","receivedAmount":"0","creationDate":"2025-05-06 17:16:43","planDate":"2022-05-08 23:00:00","taxRate":"0.13","createdBy":"0","contractId":"320190341213676712","tenantId":"1273","partyNumber":"202504270003","paidAmount":"0","planAmount":"100","startDate":"2022-05-08 23:00:00","syncStatus":"PERSISTED"}],"batchId":"7ecb6832-f2f0-41b3-9dff-7d6cf3ed51be"},"success":true}

6.4 付款计划支付回调-新合同履行

6.6 收款计划查询