C300-OpenAPI
  1. API
C300-OpenAPI
  • API 调用指南
  • 认证 API
    • 创建 Token
    • 刷新 Token
  • 制造域 MFR
    • 生产备料出库任务
      • API
        • 更新生产备料出库任务
        • 查询生产备料出库任务
      • 事件
    • 生产领料出库任务
      • API
        • 更新生产领料出库任务
      • 事件
    • 基础数据
      • BOM
        • API
          • 创建 BOM
          • 删除 BOM
          • 更新 BOM
          • 查询 BOM
        • 事件
      • 标准工序
        • API
          • 创建标准工序
          • 删除标准工序
          • 更新标准工序
          • 查询标准工序
          • 分批查询标准工序
        • 事件
      • 工艺路线
        • API
          • 创建工艺路线
          • 删除工艺路线
          • 更新工艺路线
          • 查询工艺路线
          • 上传工艺路线图纸信息
        • 事件
      • 生产小组
        • API
          • 创建生产小组
          • 更新生产小组
          • 查询生产小组
          • 分批查询生产小组
        • 事件
      • 工作中心
        • API
          • 创建工作中心
          • 删除工作中心
          • 更新工作中心
          • 查询工作中心
          • 分批查询工作中心
        • 事件
    • 生产单
      • API
        • 创建生产单
        • 批量删除生产单
        • 更新生产单
        • 修改计划用料
        • 完成生产单
        • 作废生产单
        • 查询生产单
        • 分批查询生产单
      • 事件
    • 生产领料单
      • API
        • 创建申请领料单
      • 事件
    • 生产补料出库任务
      • API
        • 更新生产补料出库任务
      • 事件
    • 生产还料入库任务
      • API
        • 更新生产还料入库任务
        • 查询生产还料入库任务
      • 事件
    • 生产入库任务
      • API
        • 更新生产入库任务
        • 查询生产入库任务
      • 事件
    • 生产报废入库任务
      • API
        • 更新生产报废入库任务
        • 完成生产报废入库任务
      • 事件
    • 生产报工记录
      • API
        • 创建生产报工记录
        • 删除生产报工记录
        • 查询报工记录
        • 分批查询报工记录
      • 事件
    • 委外管理
      • 委外采购单
        • API
          • 创建委外采购单
          • 更新委外采购单审核状态
        • 事件
      • 委外收料单
        • API
          • 创建委外收料单
          • 创建并自动完成委外收料单
        • 事件
      • 委外备料出库任务
        • API
          • 更新委外备料出库任务
        • 事件
      • 委外入库任务
        • API
          • 更新委外入库任务
        • 事件
  • 质量域QLTY
    • 生产检验报工记录
      • API
        • 创建生产检验报工记录
        • 删除生产检验报工记录
        • 作废生产检验报工记录
        • 查询检验记录
        • 分批查询检验记录
        • 查询检验记录行
        • 分批查询检验记录行
      • 事件
    • 收料检验单
      • API
        • 创建收料检验单
        • 作废收料检验单
        • 删除收料检验单
        • 更新收料检验单审核状态
      • 事件
  • 供应链域 SC
    • 基础数据
      • 客户
        • API
          • 创建客户
          • 删除客户
          • 更新客户
          • 查询客户列表
        • 事件
      • 客户分类
        • API
          • 创建客户分类
          • 删除客户分类
          • 更新客户分类
          • 查询客户分类列表
        • 事件
      • 供应商
        • API
          • 创建供应商
          • 删除供应商
          • 查询供应商
          • 更新供应商
          • 分批查询供应商
        • 事件
      • 供应商分类
        • API
          • 创建供应商分类
          • 删除供应商分类
          • 更新供应商分类
          • 查询供应商分类
          • 分批查询供应商分类
        • 事件
      • 企业地址
        • API
          • 创建企业地址
          • 删除企业地址
          • 更新企业地址
          • 查询企业地址
        • 事件
    • 销售管理
      • 销售订单
        • API
          • 创建销售订单
          • 删除销售订单
          • 更新销售订单
          • 作废销售订单
          • 查询销售订单
          • 更新销售订单审核状态
        • 事件
      • 发货单
        • API
          • 创建发货单
          • 删除发货单
          • 更新发货单
          • 作废发货单
          • 查询发货单
        • 事件
      • 退货单
        • API
          • 创建退货单
        • 事件
      • 销售出库任务
        • API
          • 确认销售发货出库任务
        • 事件
      • 销售退货入库任务
        • API
          • 更新销售退货入库任务
        • 事件
    • 采购管理
      • 采购订单
        • API
          • 创建采购订单
          • 删除采购订单
          • 更新采购订单
          • 查询采购订单
          • 作废采购订单
          • 审核采购订单
        • 事件
      • 采购收料单
        • API
          • 创建采购收料单
          • 删除采购收料单
          • 修改采购收料单
          • 查询采购收料单
          • 作废采购收料单
        • 事件
      • 采购入库任务
        • API
          • 更新采购入库任务
          • 撤销采购入库任务
        • 事件
      • 采购退料出库任务
        • API
          • 创建采购退料出库任务
          • 创建并自动完成采购退料出库任务
        • 事件
  • 厂内物流域 LOG
    • 基础数据
      • 物料
        • API
          • 创建物料
            POST
          • 创建物料单位
            POST
          • 批量创建物料
            POST
          • 删除物料
            POST
          • 删除物料单位
            POST
          • 更新物料单位
            POST
          • 更新物料
            POST
          • 更新物料审核状态
            POST
          • 启用物料
            POST
          • 禁用物料
            POST
          • 上传物料图纸
            POST
          • 查询物料
            POST
          • 分批查询物料
            POST
        • 事件
      • 物料分类
        • API
          • 创建物料分类
          • 删除物料分类
          • 更新物料分类
          • 查询物料分类
          • 分批查询物料分类
        • 事件
      • 单位
        • API
          • 查询单位
          • 分批查询单位
        • 事件
      • 规格
        • API
          • 创建规格
          • 删除规格
          • 更新规格
          • 查询规格
          • 分批查询规格
        • 事件
      • 仓库
        • API
          • 创建仓库
          • 删除仓库
          • 更新仓库
          • 查询仓库
          • 分批查询仓库
        • 事件
      • 库位
        • API
          • 创建库位
          • 查询库位
          • 分批查询库位
        • 事件
    • 库存申请单
      • API
        • 创建出库申请单
        • 作废出库申请单
        • 创建移库申请单
        • 创建入库申请单
        • 删除出库申请单
        • 创建并自动完成出库申请单
        • 创建并自动完成移库申请单
        • 查询出库申请单
        • 创建并自动完成入库申请单
        • 作废入库申请单
        • 删除入库申请单
        • 查询入库申请单
      • 事件
    • 申请出库任务
      • API
        • 更新申请出库任务
      • 事件
    • 申请入库任务
      • API
        • 更新申请入库任务
      • 事件
    • 直接移库任务
      • API
        • 更新移库任务
      • 事件
    • 库存任务
      • 确认备料出库任务
      • 确认领料出库任务
      • 确认补料出库任务
      • 创建领料申请
      • 确认还料入库任务
      • 确认生成报废任务
      • 确认生产入库任务
      • 确认库存申请入库任务
      • 确认库存申请出库任务
      • 确认移库任务
      • 确认销售发货出库任务
      • 确认销售退货入库任务
      • 完成报废入库
      • 确认生产委外入库
      • 查询还料入库任务
      • 查询生产入库任务
      • 查询备料任务
    • 供应链域SC
      • 基础数据
        • 客户分类
          • 删除客户分类
        • 客户
          • 删除客户
  • 设备域EQUIP
    • 基础数据
      • 设备
        • API
          • 创建设备
          • 更新设备
          • 删除设备
          • 查询设备
        • 事件
    • IOT对接
      • 对接设备数据
  • 用户与租户域 USER
    • 员工
      • API
        • 创建员工
        • 更新员工
      • 事件
    • 部门
      • API
        • 创建部门
        • 更新部门
      • 事件
  • 基础域DM
    • 文件管理
      • API
        • 上传文件
      • 事件
  1. API

更新物料

POST
/api/open/v3/items/update
更新物料基础数据

请求参数

Body 参数application/json
body
必需
Any of
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sit.newcoretech.com/api/open/v3/items/update' \
--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
  }
}'

返回响应

🟢200成功
application/json
Body
基础http返回信息
code
integer 
可选
message
string 
可选
示例
{
  "code": 0,
  "message": ""
}
上一页
更新物料单位
下一页
更新物料审核状态
Built with