Skip to main content

Miscellaneous Items

Overview​

Miscellaneous items represent general costs that don't fit into other modules (concrete, labor, equipment, materials, subcontractors). These are simple quantity × rate calculations.

Endpoints​

List Miscellaneous Items​

GET /api/misc/scope/:scopeId
Cookie: sAccessToken=...; sRefreshToken=...

Roles: ADMIN, ESTIMATOR, PM

Create Miscellaneous Item​

POST /api/misc
Cookie: sAccessToken=...; sRefreshToken=...
Content-Type: application/json

{
  "scopeId": "uuid",
  "description": "Permits and Fees",
  "quantity": 1,
  "ratePerUnit": 1500.00
}

Roles: ADMIN, ESTIMATOR

Required Fields:

  • scopeId (string, UUID) - Parent scope
  • description (string) - Item description
  • quantity (number) - Quantity
  • ratePerUnit (number) - Cost per unit

Update Miscellaneous Item​

PUT /api/misc/:id
Cookie: sAccessToken=...; sRefreshToken=...
Content-Type: application/json

{
  "quantity": 3,
  "ratePerUnit": 500.00
}

Roles: ADMIN, ESTIMATOR

Delete Miscellaneous Item​

DELETE /api/misc/:id
Cookie: sAccessToken=...; sRefreshToken=...

Roles: ADMIN, ESTIMATOR

Cost Calculation​

totalCost = quantity × ratePerUnit

Simple multiplication - no taxes, no waste factors, no markups at item level.

Common Use Cases​

Miscellaneous items typically cover:

DescriptionTypical QuantityRate Type
Permits and Fees1Lump sum
Site CleanupDaysPer day
Temporary FacilitiesMonthsPer month
Bonding/Insurance1Percentage
Mobilization/Demobilization1Lump sum
Testing and InspectionTestsPer test
Traffic ControlDaysPer day
Dust ControlDaysPer day
Utility Relocation1Lump sum
Contingency1Percentage

Data Model​

interface MiscItem {
  id: string           // UUID
  scopeId: string      // Parent scope UUID
  description: string  // Item description
  quantity: number     // Quantity
  ratePerUnit: number  // Cost per unit
  totalCost: number    // Calculated (quantity × ratePerUnit)
  
  // Relations
  scope: Scope
}

PM Export Mapping​

In PM exports, miscellaneous items are grouped under "GENERAL CONDITIONS" section.

Comparison to Other Modules​

ModuleCalculation ComplexityTax?Waste?Markup?
ConcreteHigh (cubic yards, rebar)✅✅✅
LaborHigh (soft costs, auto)❌❌✅
EquipmentMedium (rental, fuel)✅❌✅
MaterialsMedium (waste factor)✅✅✅
SubcontractorMedium (buffer)❌✅✅
MiscSimple (qty × rate)❌❌✅
info

Miscellaneous items are the simplest module - just quantity × rate with no additional complexity.

Example: Permit Fee​

{
  "description": "Building Permit",
  "quantity": 1,
  "ratePerUnit": 2500.00
}

Calculation:

  • Total: 1 × $2,500 = $2,500.00

Example: Daily Site Cleanup​

{
  "description": "Daily Site Cleanup",
  "quantity": 10,
  "ratePerUnit": 150.00
}

Calculation:

  • Total: 10 × $150 = $1,500.00

Module Markups​

While the item-level calculation is simple, bid-level markups still apply:

  • Workers Compensation (WC)
  • Overhead
  • Profit
  • GL Pollution

View Cost Rollup Details →