5.3 物料创建及更新

test-测试环境

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

POST

/api/hitf/v2/rest/async/invoke/MATERIALS/

创建及更新物料，异步接口。2025.11.4（4.24.0）上线

请求参数

Header 参数

Body 参数application/json

示例

{
    "userIdType": "LOGINNAME",
    "userId": "zhenling_openapi_admin",
    "data": [
        {
            "materialsCode": "P23479126",
            "isActive": true,
            "materialsName": "螺旋浆叶1",
            "materialsClassification": "INV",
            "materialsType": "CM",
            "materialsUnit": "PCS",
            "proposedPrice": 124,
            "noTaxAmount": 12421,
            "taxRate": 13,
            "includingTaxPrice": 14035.73,
            "taxAmount": 1614.73
        },
        {
            "materialsCode": "P23479125",
            "isActive": true,
            "materialsName": "螺旋浆叶2",
            "materialsClassification": "INV",
            "materialsType": "CM",
            "materialsUnit": "PCS",
            "proposedPrice": 124,
            "noTaxAmount": 12421,
            "taxRate": 13,
            "includingTaxPrice": 14035.73,
            "taxAmount": 1614.73
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://oc-test.onecontract-cloud.com/api/hitf/v2/rest/async/invoke/MATERIALS/' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userIdType": "LOGINNAME",
    "userId": "zhenling_openapi_admin",
    "data": [
        {
            "materialsCode": "P23479126",
            "isActive": true,
            "materialsName": "螺旋浆叶1",
            "materialsClassification": "INV",
            "materialsType": "CM",
            "materialsUnit": "PCS",
            "proposedPrice": 124,
            "noTaxAmount": 12421,
            "taxRate": 13,
            "includingTaxPrice": 14035.73,
            "taxAmount": 1614.73
        },
        {
            "materialsCode": "P23479125",
            "isActive": true,
            "materialsName": "螺旋浆叶2",
            "materialsClassification": "INV",
            "materialsType": "CM",
            "materialsUnit": "PCS",
            "proposedPrice": 124,
            "noTaxAmount": 12421,
            "taxRate": 13,
            "includingTaxPrice": 14035.73,
            "taxAmount": 1614.73
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

失败响应成功响应

{
    "code": "100250",
    "data": {
        "results": [
            {
                "proposedPrice": "124",
                "materialsClassification": "INV",
                "active": true,
                "materialsType": "CM",
                "isActive": true,
                "noTaxAmount": "12421",
                "attributeVarchar1": "测试1",
                "taxRate": "13",
                "includingTaxPrice": "14035.74",
                "subCode": "410001",
                "flex": {},
                "subMessage": "物料必输字段不能为空",
                "taxAmount": "1614.73",
                "materialsName": "螺旋浆叶2445",
                "materialsUnit": "PCS"
            }
        ]
    },
    "message": "简单校验失败"
}

4.5 独立值集值查询

3.27 查询合同相对方