Delete Location
Summary
Deletes a CI Location using its unique VUUID.
The location is deleted only if it is not referenced by inventory items, transactions, or other dependent records.
HTTP Method & Endpoint
Method: DELETE
Endpoint:
/ci-rest-api/jersey/v1/inventory-location/
Path Parameters
| Field | Type | Required | Example Value | Description |
|---|---|---|---|---|
| Vuuid | String | Yes | B710F10A4359F940E053508010ACC979 | Unique identifier of the CI Location |
Example Request
DELETE /ci-rest-api/jersey/v1/inventory-location/B710F10A4359F940E053508010ACC979
Notes
The VUUID must be valid.
Authentication and authorization are required.
The location cannot be deleted if it is referenced by inventory items, transactions, or other dependent entities.
Soft delete is not supported; the record is permanently removed.
Important Behavior
- If the delete operation is successful, no response body is returned.
Attributes
The request body must contain an items array.
Each object in the array represents one inventory location to be created.
All attributes are listed below for completeness.
Only attributes marked as Mandatory = True are required during creation.
| CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example | Mandatory |
|---|---|---|---|---|---|---|---|
| CilocCompCode | cilocation | cilocCompCode | Company code for the inventory location | String | 8 | CL02 | True |
| CilocCode | cilocation | cilocCode | Unique inventory location code | String | 7 | DRLC01 | True |
| CilocName | cilocation | cilocName | Name or description of the inventory location | String | 60 | Main Warehouse - Bin 01 | True |
| CilocDeptCode | cilocation | cilocDeptCode | Department code associated with the location | String | 6 | 00 | True |
| CilocTypeCode | cilocation | cilocTypeCode | Inventory location type (W = Warehouse, B = Bin) | String | 1 | W | True |
| CilocCtrlCode | cilocation | cilocCtrlCode | Control code for bin locations (required only when type is B) | String | 7 | BIN01 | Conditional |
| CilocBinCtrlFlag | cilocation | cilocBinCtrlFlag | Indicates whether bin control is enabled (Y/N) | String | 1 | Y | False |
| CilocPctUsed | cilocation | cilocPctUsed | Percentage of storage capacity used | Number | 6,2 | 0.00 | False |
| CilocDeptDistFlag | cilocation | cilocDeptDistFlag | Department distribution flag (Y/N) | String | 1 | N | True |
| CilocHier | cilocation | cilocHier | Hierarchical structure of the inventory location | String | 255 | WH1/BIN1 | False |
| CilocInvSerCode | cilocation | cilocInvSerCode | Inventory serialization code | String | 4 | SER1 | False |
| CilocMszoneCode | cilocation | cilocMszoneCode | Material staging zone code | String | 10 | ZONE1 | False |
| CilocIuCreateDate | cilocation | cilocIuCreateDate | Date and time when the record is created | String | N/A | System generated | False |
| CilocIuCreateUser | cilocation | cilocIuCreateUser | User who created the inventory location | String | 30 | System user | False |
| CilocIuUpdateDate | cilocation | cilocIuUpdateDate | Date and time of last update | String | N/A | System generated | False |
| CilocIuUpdateUser | cilocation | cilocIuUpdateUser | User who last updated the record | String | 30 | System user | False |
| CilocVUuid | cilocation | cilocVUuid | Virtual unique identifier generated by the system | String | 64 | Generated | False |
Basic authentication
Internal Server Error
"{\n \"uuid\": \"f094a38f-cc85-4355-a1df-99c555579075\",\n \"status\": \"Error\",\n \"errorCode\": \"CI-000215-ERR\",\n \"errorMessage\": \"Cannot delete the record because the location code is currently in use.\",\n \"timestamp\": \"2026-01-06 15:16:28.980\",\n \"moreDetails\": {\n \"ecid\": \"9632c15c-8440-4986-bd72-39da746cd3cb-0000014e\"\n }\n}"