Create Inventory

Endpoint

POST /inventories

Authentication

Required: Authorization header with valid token

Request Body

JSON format with the following structure:

{
  "title": "string",
  "additionalInformation": "string",
  "productId": "uuid",
  "idNumber": "string",
  "specifications": [],
  "mediaId": "uuid",
  "externalId": "string",
  "stocks": [
    {
      "warehouseId": "uuid",
      "quantity": "number"
    }
  ]
}

Required Fields

title - The name or title of the inventory item

Fields descriptions

See Inventory Management documentation for field details.

Response

Returns InventoryEntity Schema

Error

See Error Schema documentation

Example Usage

Create inventory

Bash

curl -X POST "https://integration-api.ram.syniotec.com/master-data/v1/inventory-management/inventories" \
 -H "Authorization: Bearer YOUR_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{
 "title": "Excavator CAT 320",
 "additionalInformation": "Heavy duty excavator for construction sites",
 "productId": "123e4567-e89b-12d3-a456-426614174000",
 "idNumber": "EXC-2024-001",
 "specifications": [{"key": "weight", "value": "20000kg"}],
 "mediaId": "123e4567-e89b-12d3-a456-426614174002",
 "externalId": "external-inventory-123",
 "stocks": [
   {
     "warehouseId": "123e4567-e89b-12d3-a456-426614174003",
     "quantity": 5
   }
 ]
 }'