Skip to main content

Asset Type Import

Bulk create or update asset type definitions (cooler and freezer models). Existing asset types are matched by Model Number + Manufacturer and updated in place.

See Overview for authentication, file formats, response structure, and import order.

Endpoint

POST https://portal.coolrgroup.com/Controllers/Import.ashx?type=AssetType

UI access

  • Playbook App: Master Data → Asset Types → Manage Data → Import

Columns

Formats: .csv, .xlsx / .xls, .jsonDownload template

ColumnAliasRequiredType / Max LengthValidationNotes
General Information
Asset TypeAssetTypeYesString, max 100Must be non-emptyAsset type name
Model NumberModelNumberYesString, max 270Must be non-emptyCombined with Manufacturer to match existing records
ManufacturerYesString, max 300Must be non-empty
Orientation TypeChestCoolerTypeYesString, max 200Horizontal or VerticalCase-insensitive
Door Handle LocationDoorHandleLocationTypeYesString, max 200Left, Right, Magnet, Shelf, or Under ShelfCase-insensitive
Capacity & Structure
No. Of DoorsDoorsNoInteger, ≥ 0
ShelvesNoInteger, ≥ 0
ColumnsNoInteger, ≥ 0
Lifecycle
LifeNoInteger, ≥ 0Expected lifespan (years or months per system config)
WarrantyNoInteger, ≥ 0Warranty period (years or months per system config)
Physical Dimensions
Cabinet HeightCabinetHeightNoDecimalHeight measurement
Cabinet WidthCabinetWidthNoDecimalWidth measurement
Configuration
Temperature OffsetTemperatureOffsetNoDecimal, -5 to 5-5 to 5Temperature calibration adjustment
Integration
External CodeExternalAssetTypeCodeNoString, max 200Your internal system's identifier for this asset type. Used as an alternative match key — see Overview

Examples

CSV

Asset Type,Model Number,Manufacturer,Orientation Type,Door Handle Location,No. Of Doors,Shelves,Columns,Life,Warranty,Cabinet Height,Cabinet Width,Temperature Offset,External Code
Vertical Cooler,VC-2000X,CoolTech Industries,Vertical,Left,2,5,3,10,2,180.5,80.0,0.5,EXT-VC-2000X
Horizontal Freezer,HF-5000,FreezeCorp,Horizontal,Shelf,1,3,2,8,1,150.0,120.0,-0.5,EXT-HF-5000

JSON

{
"data": [
{
"AssetType": "Vertical Cooler",
"ModelNumber": "VC-2000X",
"Manufacturer": "CoolTech Industries",
"ChestCoolerType": "Vertical",
"DoorHandleLocationType": "Left",
"Doors": 2,
"Shelves": 5,
"Columns": 3,
"Life": 10,
"Warranty": 2,
"CabinetHeight": 180.5,
"CabinetWidth": 80.0,
"TemperatureOffset": 0.5,
"ExternalAssetTypeCode": "EXT-VC-2000X"
},
{
"AssetType": "Horizontal Freezer",
"ModelNumber": "HF-5000",
"Manufacturer": "FreezeCorp",
"ChestCoolerType": "Horizontal",
"DoorHandleLocationType": "Shelf",
"Doors": 1,
"Shelves": 3,
"Columns": 2,
"Life": 8,
"Warranty": 1,
"CabinetHeight": 150.0,
"CabinetWidth": 120.0,
"TemperatureOffset": -0.5,
"ExternalAssetTypeCode": "EXT-HF-5000"
}
]
}

API import

curl -X POST 'https://portal.coolrgroup.com/Controllers/Import.ashx?type=AssetType' \
-H 'Cookie: .ASPXAUTH=your-auth-token' \
-F 'file=@asset-types.csv'

Replace asset-types.csv with asset-types.xlsx or asset-types.json as needed.

Response

See Overview - Response format for response structure and error handling.

Common errors

ErrorCauseFix
Missing required field: Asset TypeEmpty asset type nameFill in Asset Type for every row
Missing required field: Model NumberEmpty model numberFill in Model Number for every row
Missing required field: ManufacturerEmpty manufacturerFill in Manufacturer for every row
Orientation Type must be either 'Horizontal' or 'Vertical'Invalid orientation valueUse only Horizontal or Vertical
Door Handle Location must be one of - Left, Right, Magnet, Shelf, Under ShelfInvalid handle locationUse only: Left, Right, Magnet, Shelf, Under Shelf

For support, contact support@coolrgroup.com