分页查询查询物料列表

POST

/api/open/v4/items/page/query

请求参数

Header 参数

Body 参数application/json

示例

{
    "body": {
        "pagingParam": {
            "start": 0,
            "length": 0
        },
        "itemIds": [
            0
        ],
        "rootItemIds": [
            0
        ],
        "code": "string",
        "codes": [
            "string"
        ],
        "codeLike": "string",
        "name": "string",
        "nameLike": "string",
        "status": [
            "DISABLED"
        ],
        "auditStatuses": [
            "TO_BE_SUBMIT"
        ],
        "attributeQueryParams": [
            {
                "key": "string",
                "valueLike": "string",
                "values": [
                    "string"
                ]
            }
        ],
        "itemCustomizeFields": {
            "key": {}
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://c2.xinheyun.com/api/open/v4/items/page/query' \
--header 'Cookie;' \
--header 'Content-Type: application/json' \
--data '{
    "body": {
        "pagingParam": {
            "start": 0,
            "length": 0
        },
        "itemIds": [
            0
        ],
        "rootItemIds": [
            0
        ],
        "code": "string",
        "codes": [
            "string"
        ],
        "codeLike": "string",
        "name": "string",
        "nameLike": "string",
        "status": [
            "DISABLED"
        ],
        "auditStatuses": [
            "TO_BE_SUBMIT"
        ],
        "attributeQueryParams": [
            {
                "key": "string",
                "valueLike": "string",
                "values": [
                    "string"
                ]
            }
        ],
        "itemCustomizeFields": {
            "key": {}
        }
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "message": "string",
    "data": {
        "list": [
            {
                "rootItemId": 0,
                "itemId": 0,
                "code": "string",
                "name": "string",
                "category": {
                    "code": "string",
                    "name": "string",
                    "inventoryCycle": 0,
                    "parentCode": "string",
                    "parentName": "string"
                },
                "unit": "string",
                "type": "string",
                "allowProduction": 0,
                "allowPurchase": 0,
                "allowSale": 0,
                "allowOutsource": 0,
                "status": "DISABLED",
                "auditStatus": "TO_BE_SUBMIT",
                "attributes": [
                    {
                        "key": "string",
                        "value": "string"
                    }
                ],
                "supplyChain": {
                    "procurementPriceType": "INCLUDE_TAX_PRICE",
                    "procurementPrice": 0,
                    "procurementTax": 0,
                    "overReceiveRate": 0,
                    "salePriceType": "INCLUDE_TAX_PRICE",
                    "salePrice": 0,
                    "saleTax": 0,
                    "overDeliveryRate": 0,
                    "isConfigurable": "ON",
                    "purchaser": 0
                },
                "inventory": {
                    "useBatch": true,
                    "batchType": "SYSTEM",
                    "useSN": "ON",
                    "snType": "CATEGORY",
                    "useKey": true,
                    "shelfLife": 0,
                    "useOverdueMessage": "ON",
                    "useSafetyInventory": true,
                    "maxInventory": 0,
                    "safetyInventory": 0,
                    "minInventory": 0,
                    "rePurchasePoint": 0,
                    "defaultWarehouseCode": "string",
                    "defaultWarehouseName": "string",
                    "defaultWarehouseBinName": "string",
                    "abcCategory": "NON",
                    "materialStatus": "NORMAL",
                    "cost": 0,
                    "realCostPrice": 0,
                    "minPackQuantity": 0,
                    "useLockInventory": true,
                    "inventoryAccountType": "DEFAULT",
                    "enableInteger": "ON",
                    "integerWay": "UP",
                    "useBomVersion": true,
                    "fifo": "NONE",
                    "fifoRule": "STOCK_BATCH_CREATE",
                    "fifoScanCheck": "ON"
                },
                "itemSpecificationConfigs": [
                    {
                        "key": "string",
                        "values": [
                            "string"
                        ]
                    }
                ],
                "itemAssistUnits": [
                    {
                        "seq": 0,
                        "unitId": 0,
                        "unitName": "string",
                        "baseToAssistRatioVal": 0,
                        "assistToBaseRatioVal": 0
                    }
                ],
                "itemUnitDTO": {
                    "itemIdOriginal": "string",
                    "baseUnit": {
                        "id": 0,
                        "name": "string",
                        "defaultProductUnit": 0,
                        "defaultMaterialUnit": 0,
                        "defaultSemiProductUnit": 0,
                        "unitRelations": [
                            {
                                "id": 0,
                                "baseUnit": {},
                                "transUnit": {},
                                "equivalentValue": 0
                            }
                        ],
                        "updateTime": "string",
                        "deleted": "ON"
                    },
                    "inventoryUnit": {
                        "id": 0,
                        "name": "string",
                        "defaultProductUnit": 0,
                        "defaultMaterialUnit": 0,
                        "defaultSemiProductUnit": 0,
                        "unitRelations": [
                            {
                                "id": 0,
                                "baseUnit": {},
                                "transUnit": {},
                                "equivalentValue": 0
                            }
                        ],
                        "updateTime": "string",
                        "deleted": "ON"
                    },
                    "inventoryToBaseQuantity": 0,
                    "baseToInventoryQuantity": 0,
                    "productionUnit": {
                        "id": 0,
                        "name": "string",
                        "defaultProductUnit": 0,
                        "defaultMaterialUnit": 0,
                        "defaultSemiProductUnit": 0,
                        "unitRelations": [
                            {
                                "id": 0,
                                "baseUnit": {},
                                "transUnit": {},
                                "equivalentValue": 0
                            }
                        ],
                        "updateTime": "string",
                        "deleted": "ON"
                    },
                    "productionToBaseQuantity": 0,
                    "baseToProductionQuantity": 0,
                    "jbkUnit": {
                        "id": 0,
                        "name": "string",
                        "defaultProductUnit": 0,
                        "defaultMaterialUnit": 0,
                        "defaultSemiProductUnit": 0,
                        "unitRelations": [
                            {
                                "id": 0,
                                "baseUnit": {},
                                "transUnit": {},
                                "equivalentValue": 0
                            }
                        ],
                        "updateTime": "string",
                        "deleted": "ON"
                    },
                    "productionToJbkQuantity": 0,
                    "jbkToProductionQuantity": 0,
                    "saleUnit": {
                        "id": 0,
                        "name": "string",
                        "defaultProductUnit": 0,
                        "defaultMaterialUnit": 0,
                        "defaultSemiProductUnit": 0,
                        "unitRelations": [
                            {
                                "id": 0,
                                "baseUnit": {},
                                "transUnit": {},
                                "equivalentValue": 0
                            }
                        ],
                        "updateTime": "string",
                        "deleted": "ON"
                    },
                    "saleToBaseQuantity": 0,
                    "baseToSaleQuantity": 0,
                    "purchaseUnit": {
                        "id": 0,
                        "name": "string",
                        "defaultProductUnit": 0,
                        "defaultMaterialUnit": 0,
                        "defaultSemiProductUnit": 0,
                        "unitRelations": [
                            {
                                "id": 0,
                                "baseUnit": {},
                                "transUnit": {},
                                "equivalentValue": 0
                            }
                        ],
                        "updateTime": "string",
                        "deleted": "ON"
                    },
                    "purchaseToBaseQuantity": 0,
                    "baseToPurchaseQuantity": 0
                },
                "attachment": {
                    "album": [
                        {}
                    ],
                    "blueprint": [
                        {}
                    ],
                    "attachment": [
                        {}
                    ],
                    "comments": "string"
                },
                "itemSpecifications": [
                    {
                        "specId": 0,
                        "name": "string",
                        "value": "string",
                        "code": "string",
                        "seq": 0,
                        "creator": 0,
                        "createTime": "string"
                    }
                ],
                "productionAndPlan": {
                    "dailyProduction": 0,
                    "defectiveRate": 0,
                    "planStrategy": "MTO",
                    "planBatchSize": 0,
                    "batchSize": 0,
                    "incrementSize": 0,
                    "enableInteger": "ON",
                    "integerWay": "UP"
                },
                "qualityInspection": {
                    "useProcurementInspect": true,
                    "useInventoryInspect": true,
                    "inspectionMethod": "NIL",
                    "procurementInspectDetail": {
                        "procurementInspectionSchemeId": 0,
                        "procurementInspectionSchemeName": "string",
                        "procurementInspectionStandardId": 0,
                        "procurementInspectionStandardName": "string",
                        "inspectionSchemeList": [
                            {
                                "id": 0,
                                "name": null
                            }
                        ],
                        "inspectionStandardList": null
                    }
                },
                "itemPurchaseInformationDTO": {
                    "id": 0,
                    "rootItemId": 0,
                    "rootItemIdOriginal": "string",
                    "supplierName": "string",
                    "supplierId": 0,
                    "item": {
                        "uniqueKey": "string",
                        "errorMsg": "string",
                        "errorCode": 0,
                        "extendErrorInfo": {
                            "systemItemCodes": [
                                "string"
                            ]
                        },
                        "itemIdOriginal": "string",
                        "rootItemIdOriginal": "string",
                        "name": "string",
                        "code": "string",
                        "type": "PRODUCTS",
                        "category": {
                            "id": 0,
                            "name": "string",
                            "code": "string",
                            "inventoryCycleDays": 0,
                            "parentId": 0,
                            "parentCategory": {},
                            "specTemplateId": 0,
                            "specificationTemplate": {
                                "id": 0,
                                "name": "string"
                            },
                            "level": 0,
                            "updateTime": "string",
                            "deleted": "ON",
                            "inventoryAccountType": "DEFAULT",
                            "snType": "SYSTEM",
                            "tenantId": "string"
                        },
                        "unit": "string",
                        "unitId": 0,
                        "allowSale": true,
                        "allowPurchase": true,
                        "allowProduction": true,
                        "allowOutsource": true,
                        "status": "DISABLED",
                        "issueStatus": "EDEN",
                        "auditStatus": "TO_BE_SUBMIT",
                        "reject": "YES",
                        "itemId": 0,
                        "rootItemId": 0,
                        "wipKey": "string",
                        "createTime": "string",
                        "updateTime": "string",
                        "latest": true,
                        "deleted": "ON",
                        "nameAttrMd5": "string",
                        "creator": 0,
                        "itemSpecifications": [
                            {
                                "specId": 0,
                                "name": "string",
                                "value": "string",
                                "code": "string",
                                "seq": 0,
                                "creator": 0,
                                "createTime": "string"
                            }
                        ],
                        "productionAndPlan": {
                            "dailyProduction": 0,
                            "defectiveRate": 0,
                            "planStrategy": "MTO",
                            "planBatchSize": 0,
                            "batchSize": 0,
                            "incrementSize": 0,
                            "enableInteger": "ON",
                            "integerWay": "UP"
                        },
                        "inventory": {
                            "rootItemId": 0,
                            "useBatch": true,
                            "batchType": "SYSTEM",
                            "useSN": "ON",
                            "snType": "CATEGORY",
                            "useKey": true,
                            "shelfLife": 0,
                            "useOverdueMessage": "ON",
                            "useSafetyInventory": true,
                            "maxInventory": 0,
                            "safetyInventory": 0,
                            "minInventory": 0,
                            "rePurchasePoint": 0,
                            "defaultWarehouseId": 0,
                            "defaultWarehouseIdStr": "string",
                            "defaultWarehouseBin": 0,
                            "defaultWarehouseBinStr": "string",
                            "defaultWarehouseName": "string",
                            "defaultWarehouseBinName": "string",
                            "abcCategory": "NON",
                            "materialStatus": "NORMAL",
                            "cost": 0,
                            "realCostPrice": 0,
                            "minPackQuantity": 0,
                            "useLockInventory": true,
                            "inventoryAccountType": "DEFAULT",
                            "enableInteger": "ON",
                            "integerWay": "UP",
                            "useBomVersion": true,
                            "fifo": "NONE",
                            "fifoRule": "STOCK_BATCH_CREATE",
                            "fifoScanCheck": "ON",
                            "useOverdue": true,
                            "overdueDays": 0,
                            "overdueAlertDays": 0
                        },
                        "supplyChain": {
                            "procurementPriceType": "INCLUDE_TAX_PRICE",
                            "procurementPrice": 0,
                            "procurementTax": 0,
                            "overReceiveRate": 0,
                            "salePriceType": "INCLUDE_TAX_PRICE",
                            "salePrice": 0,
                            "saleTax": 0,
                            "overDeliveryRate": 0,
                            "isConfigurable": "ON",
                            "purchaser": 0
                        },
                        "qualityInspection": {
                            "useProcurementInspect": true,
                            "useInventoryInspect": true,
                            "inspectionMethod": "NIL",
                            "procurementInspectDetail": {
                                "procurementInspectionSchemeId": 0,
                                "procurementInspectionSchemeName": "string",
                                "procurementInspectionStandardId": 0,
                                "procurementInspectionStandardName": "string",
                                "inspectionSchemeList": [
                                    {
                                        "id": 0,
                                        "name": null
                                    }
                                ],
                                "inspectionStandardList": null
                            }
                        },
                        "attachment": {
                            "album": [
                                {}
                            ],
                            "blueprint": [
                                {}
                            ],
                            "attachment": [
                                {}
                            ],
                            "comments": "string"
                        },
                        "itemUnitDTO": {
                            "itemIdOriginal": "string",
                            "baseUnit": {
                                "id": 0,
                                "name": "string",
                                "defaultProductUnit": 0,
                                "defaultMaterialUnit": 0,
                                "defaultSemiProductUnit": 0,
                                "unitRelations": [
                                    {
                                        "id": 0,
                                        "baseUnit": {},
                                        "transUnit": {},
                                        "equivalentValue": 0
                                    }
                                ],
                                "updateTime": "string",
                                "deleted": "ON"
                            },
                            "inventoryUnit": {
                                "id": 0,
                                "name": "string",
                                "defaultProductUnit": 0,
                                "defaultMaterialUnit": 0,
                                "defaultSemiProductUnit": 0,
                                "unitRelations": [
                                    {
                                        "id": 0,
                                        "baseUnit": {},
                                        "transUnit": {},
                                        "equivalentValue": 0
                                    }
                                ],
                                "updateTime": "string",
                                "deleted": "ON"
                            },
                            "inventoryToBaseQuantity": 0,
                            "baseToInventoryQuantity": 0,
                            "productionUnit": {
                                "id": 0,
                                "name": "string",
                                "defaultProductUnit": 0,
                                "defaultMaterialUnit": 0,
                                "defaultSemiProductUnit": 0,
                                "unitRelations": [
                                    {
                                        "id": 0,
                                        "baseUnit": {},
                                        "transUnit": {},
                                        "equivalentValue": 0
                                    }
                                ],
                                "updateTime": "string",
                                "deleted": "ON"
                            },
                            "productionToBaseQuantity": 0,
                            "baseToProductionQuantity": 0,
                            "jbkUnit": {
                                "id": 0,
                                "name": "string",
                                "defaultProductUnit": 0,
                                "defaultMaterialUnit": 0,
                                "defaultSemiProductUnit": 0,
                                "unitRelations": [
                                    {
                                        "id": 0,
                                        "baseUnit": {},
                                        "transUnit": {},
                                        "equivalentValue": 0
                                    }
                                ],
                                "updateTime": "string",
                                "deleted": "ON"
                            },
                            "productionToJbkQuantity": 0,
                            "jbkToProductionQuantity": 0,
                            "saleUnit": {
                                "id": 0,
                                "name": "string",
                                "defaultProductUnit": 0,
                                "defaultMaterialUnit": 0,
                                "defaultSemiProductUnit": 0,
                                "unitRelations": [
                                    {
                                        "id": 0,
                                        "baseUnit": {},
                                        "transUnit": {},
                                        "equivalentValue": 0
                                    }
                                ],
                                "updateTime": "string",
                                "deleted": "ON"
                            },
                            "saleToBaseQuantity": 0,
                            "baseToSaleQuantity": 0,
                            "purchaseUnit": {
                                "id": 0,
                                "name": "string",
                                "defaultProductUnit": 0,
                                "defaultMaterialUnit": 0,
                                "defaultSemiProductUnit": 0,
                                "unitRelations": [
                                    {
                                        "id": 0,
                                        "baseUnit": {},
                                        "transUnit": {},
                                        "equivalentValue": 0
                                    }
                                ],
                                "updateTime": "string",
                                "deleted": "ON"
                            },
                            "purchaseToBaseQuantity": 0,
                            "baseToPurchaseQuantity": 0
                        },
                        "itemAssistUnits": [
                            {
                                "seq": 0,
                                "unitId": 0,
                                "unitName": "string",
                                "baseToAssistRatioVal": 0,
                                "assistToBaseRatioVal": 0
                            }
                        ],
                        "itemPurchaseInformationDTO": {},
                        "itemSpecificationConfigs": null,
                        "itemCustomizeFields": null
                    },
                    "isDefault": null,
                    "isStandard": null,
                    "purchaseLeadTime": null,
                    "purchaseLeadTimeUnit": null,
                    "minPurQuantity": null,
                    "minPackQuantity": null,
                    "minBagQuantity": null,
                    "promotionInfoDtoList": null,
                    "unitId": null,
                    "unitName": null,
                    "promotionItemName": null,
                    "promotionItemCode": null,
                    "promotionAdditionalRate": null,
                    "promotionFreeQtyRoundType": "NORMAL",
                    "quotas": null
                },
                "itemCustomizeFields": null,
                "extendMap": null
            }
        ],
        "start": null,
        "length": null,
        "recordsTotal": null
    }
}

修改于 2026-06-10 11:12:44

上传物料图纸

查询系统二维码物料