批量创建物料

批量创建物料基础数据

请求参数

Body 参数application/json

body

array[object (ItemSaveParamV2) {23}] | null

必需

code

string | null

物料编码

必需

name

string | null

名称

必需

>= 1 字符<= 200 字符

categoryCode

string | null

物料分类编码

必需

unit

string | null

单位

必需

type

enum<string> | enum<null>

物料类型

必需

枚举值:

PRODUCTSSEMI_PRODUCTSMATERIALS

allowSale

boolean

允许销售

可选

allowPurchase

boolean

允许采购

可选

allowProduction

boolean

允许生产

可选

allowOutsource

boolean

允许委外

可选

auditStatus

enum<string>

可选

物料审核状态
默认为已审核

枚举值:

TO_BE_SUBMITAUDITINGAUDITED

status

enum<string>

可选

物料状态
默认为已启用

枚举值:

DISABLEDENABLETO_BE_DISABLEDTO_BE_ENABLE

attributes

array[object (Spec) {3}]

可选

规格属性,最多 5 条

inventoryAttributes

object (InventoryAttributes)

库存属性

可选

manufactureAttributes

object (ManufactureAttributes)

计划&生产属性

可选

itemSupplyChainAttributes

object (ItemSupplyChainAttributes)

供应链属性

可选

itemQualityInspectionAttributes

object (ItemQualityInspectionAttributes)

采购收货检验属性

可选

updateItemSpecificationConfig

boolean

可选

是否更新配置属性项，默认false

itemSpecificationConfigParams

array[object (ItemSpecificationConfigParam) {3}]

可配置规格

可选

itemAssistUnits

array[object (ItemAssistUnitParam) {3}]

辅助单位

可选

<= 10 items

itemUnit

object (ItemUnit)

多单位属性

可选

itemAttachmentAttributes

object (ItemAttachmentAttributes)

物料附件属性

可选

itemCustomizeFields

object (MapObject)

自定义字段

可选

itemUnitParam

object (ItemUnitParam)

物料单位

可选

示例

{
    "body": [
        {
            "code": "IC-CHIP-5NM",
            "name": "5纳米制程芯片",
            "categoryCode": "SEMI-IC",
            "unit": "PCS",
            "type": "MATERIALS",
            "allowSale": 0,
            "allowPurchase": 1,
            "allowProduction": 1,
            "allowOutsource": 0,
            "auditStatus": "AUDITED",
            "status": "ENABLE",
            "attributes": [
                {
                    "code": "PACKAGE-005",
                    "key": "package_type",
                    "value": "BGA256"
                },
                {
                    "code": "TEMP-RANGE-003",
                    "key": "operating_temp",
                    "value": "-40℃~125℃"
                }
            ],
            "inventoryAttributes": {
                "abcCategory": 1,
                "cost": 22,
                "defaultWarehouseCode": "WH-SEMI-01",
                "defaultWarehouseLocation": "WH-SEMI-01-A001",
                "enableFifoScanCheck": true,
                "enableInteger": 1,
                "fifo": "DOWN",
                "fifoRule": "1",
                "integerWay": 1,
                "maxInventory": 50000,
                "minInventory": 5000,
                "minPackQuantity": 0,
                "realCostPrice": 3,
                "rePurchasePoint": null,
                "safetyInventory": 10000,
                "shelfLife": 730,
                "snType": "CATEGORY",
                "useBatch": true,
                "useKey": true,
                "useLockInventory": false,
                "useOverdueMessage": true,
                "useSafetyInventory": true,
                "useSN": true
            },
            "itemAssistUnits": [
                {
                    "assistToBaseRatioVal": 100,
                    "baseToAssistRatioVal": 0.01,
                    "unitCode": "TRAY"
                }
            ],
            "itemAttachmentAttributes": {
                "attachments": [
                    {
                        "name": "技术规格书.pdf",
                        "size": 2048000,
                        "type": "TECH_DOC",
                        "url": "https://docs.xxx.com/IC-CHIP-5NM-spec.pdf"
                    }
                ],
                "blueprints": [
                    {
                        "name": "封装设计图.dwg",
                        "size": 5120000,
                        "type": "BLUEPRINT",
                        "url": "https://design.xxx.com/IC-CHIP-5NM.dwg"
                    }
                ],
                "comments": ""
            },
            "itemCustomizeFields": {
                "key": {}
            },
            "itemQualityInspectionAttributes": {
                "procurementInspectionScheme": "IC-AQL-LEVEL-II",
                "procurementInspectionStandard": "IPC-A-610 Class 3",
                "useProcurementInspection": true
            },
            "itemSpecificationConfigParams": [
                {
                    "key": "规格",
                    "valueSet": [],
                    "valuesFrom": "CUSTOM"
                }
            ],
            "itemSupplyChainAttributes": {
                "isConfigurable": false,
                "overDeliveryRate": 0.03,
                "overReceiveRate": 0.05,
                "procurementPrice": 15.8,
                "procurementPriceType": "INCLUDE_TAX_PRICE",
                "procurementTax": 13,
                "salePrice": 25,
                "salePriceType": "INCLUDE_TAX_PRICE",
                "saleTax": 13
            },
            "itemUnit": {
                "inventoryUnit": "PCS",
                "jbkUnit": "G",
                "productionUnit": "G",
                "purchaseUnit": "PCS",
                "saleUnit": "PCS"
            },
            "itemUnitParam": {
                "baseToInventoryQuantity": 1,
                "baseToProductionQuantity": 1,
                "baseToPurchaseQuantity": 1,
                "baseToSaleQuantity": 1,
                "baseUnitName": "PCS",
                "inventoryToBaseQuantity": 1,
                "inventoryUnitName": "PCS",
                "jbkToProductionQuantity": 1000,
                "jbkUnitName": "G",
                "productionToBaseQuantity": 1000,
                "productionToJbkQuantity": 1,
                "productionUnitName": "G",
                "purchaseToBaseQuantity": 1,
                "purchaseUnitName": "PCS",
                "saleToBaseQuantity": 1,
                "saleUnitName": "PCS"
            },
            "manufactureAttributes": {
                "batchSize": 500,
                "dailyProduction": 10000,
                "defectiveRate": 0.01,
                "incrementSize": 100,
                "planBatchSize": 1000,
                "planStrategy": "MTO"
            },
            "updateItemSpecificationConfig": false
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sit.newcoretech.com/api/open/v3/items/batchCreate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "body": [
        {
            "code": "IC-CHIP-5NM",
            "name": "5纳米制程芯片",
            "categoryCode": "SEMI-IC",
            "unit": "PCS",
            "type": "MATERIALS",
            "allowSale": 0,
            "allowPurchase": 1,
            "allowProduction": 1,
            "allowOutsource": 0,
            "auditStatus": "AUDITED",
            "status": "ENABLE",
            "attributes": [
                {
                    "code": "PACKAGE-005",
                    "key": "package_type",
                    "value": "BGA256"
                },
                {
                    "code": "TEMP-RANGE-003",
                    "key": "operating_temp",
                    "value": "-40℃~125℃"
                }
            ],
            "inventoryAttributes": {
                "abcCategory": 1,
                "cost": 22,
                "defaultWarehouseCode": "WH-SEMI-01",
                "defaultWarehouseLocation": "WH-SEMI-01-A001",
                "enableFifoScanCheck": true,
                "enableInteger": 1,
                "fifo": "DOWN",
                "fifoRule": "1",
                "integerWay": 1,
                "maxInventory": 50000,
                "minInventory": 5000,
                "minPackQuantity": 0,
                "realCostPrice": 3,
                "rePurchasePoint": null,
                "safetyInventory": 10000,
                "shelfLife": 730,
                "snType": "CATEGORY",
                "useBatch": true,
                "useKey": true,
                "useLockInventory": false,
                "useOverdueMessage": true,
                "useSafetyInventory": true,
                "useSN": true
            },
            "itemAssistUnits": [
                {
                    "assistToBaseRatioVal": 100,
                    "baseToAssistRatioVal": 0.01,
                    "unitCode": "TRAY"
                }
            ],
            "itemAttachmentAttributes": {
                "attachments": [
                    {
                        "name": "技术规格书.pdf",
                        "size": 2048000,
                        "type": "TECH_DOC",
                        "url": "https://docs.xxx.com/IC-CHIP-5NM-spec.pdf"
                    }
                ],
                "blueprints": [
                    {
                        "name": "封装设计图.dwg",
                        "size": 5120000,
                        "type": "BLUEPRINT",
                        "url": "https://design.xxx.com/IC-CHIP-5NM.dwg"
                    }
                ],
                "comments": ""
            },
            "itemCustomizeFields": {
                "key": {}
            },
            "itemQualityInspectionAttributes": {
                "procurementInspectionScheme": "IC-AQL-LEVEL-II",
                "procurementInspectionStandard": "IPC-A-610 Class 3",
                "useProcurementInspection": true
            },
            "itemSpecificationConfigParams": [
                {
                    "key": "规格",
                    "valueSet": [],
                    "valuesFrom": "CUSTOM"
                }
            ],
            "itemSupplyChainAttributes": {
                "isConfigurable": false,
                "overDeliveryRate": 0.03,
                "overReceiveRate": 0.05,
                "procurementPrice": 15.8,
                "procurementPriceType": "INCLUDE_TAX_PRICE",
                "procurementTax": 13,
                "salePrice": 25,
                "salePriceType": "INCLUDE_TAX_PRICE",
                "saleTax": 13
            },
            "itemUnit": {
                "inventoryUnit": "PCS",
                "jbkUnit": "G",
                "productionUnit": "G",
                "purchaseUnit": "PCS",
                "saleUnit": "PCS"
            },
            "itemUnitParam": {
                "baseToInventoryQuantity": 1,
                "baseToProductionQuantity": 1,
                "baseToPurchaseQuantity": 1,
                "baseToSaleQuantity": 1,
                "baseUnitName": "PCS",
                "inventoryToBaseQuantity": 1,
                "inventoryUnitName": "PCS",
                "jbkToProductionQuantity": 1000,
                "jbkUnitName": "G",
                "productionToBaseQuantity": 1000,
                "productionToJbkQuantity": 1,
                "productionUnitName": "G",
                "purchaseToBaseQuantity": 1,
                "purchaseUnitName": "PCS",
                "saleToBaseQuantity": 1,
                "saleUnitName": "PCS"
            },
            "manufactureAttributes": {
                "batchSize": 500,
                "dailyProduction": 10000,
                "defectiveRate": 0.01,
                "incrementSize": 100,
                "planBatchSize": 1000,
                "planStrategy": "MTO"
            },
            "updateItemSpecificationConfig": false
        }
    ]
}'

请求参数

示例代码

返回响应