{
  "name": "Contractor Calculator",
  "id": "contractor-calculator",
  "publisher": "FieldRanger",
  "description": "Prices a contracting job from labor, materials, subcontractors and equipment at the contractor's own labor cost, overhead and margin, with permits passed through.",
  "page": "https://fieldranger.ai/templates/contractor-calculator",
  "endpoint": "https://fieldranger.ai/api/tools/contractor-calculator",
  "usage": "GET with query parameters, or POST a JSON object with the same names, returns the computed result. GET with no parameters returns this description.",
  "inputs": [
    {
      "name": "laborHours",
      "label": "Labor hours",
      "type": "number",
      "unit": "hours",
      "required": false,
      "default": 40,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 1000000,
      "description": "The business's own labor hours on the job, added together."
    },
    {
      "name": "laborRate",
      "label": "Loaded labor cost",
      "type": "number",
      "unit": "USD per hour",
      "required": false,
      "default": 50,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 1000,
      "description": "Wage plus payroll taxes, insurance and benefits, per labor hour."
    },
    {
      "name": "overheadPercent",
      "label": "Overhead",
      "type": "number",
      "unit": "% of direct cost",
      "required": false,
      "default": 12,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 300,
      "description": "Rent, vehicles, insurance, software and office time, as a share of direct cost."
    },
    {
      "name": "marginPercent",
      "label": "Target margin",
      "type": "number",
      "unit": "% of price",
      "required": false,
      "default": 18,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 90,
      "description": "Profit as a share of the price, not a markup on cost."
    },
    {
      "name": "materials",
      "label": "Materials",
      "type": "number",
      "unit": "USD",
      "required": false,
      "default": 4000,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 100000000,
      "description": "Materials at cost, delivery included."
    },
    {
      "name": "subcontractors",
      "label": "Subcontractors",
      "type": "number",
      "unit": "USD",
      "required": false,
      "default": 1500,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 100000000,
      "description": "Quoted subcontract work."
    },
    {
      "name": "equipment",
      "label": "Equipment",
      "type": "number",
      "unit": "USD",
      "required": false,
      "default": 300,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 100000000,
      "description": "Rentals, dumpsters and disposal for this job."
    },
    {
      "name": "permitFees",
      "label": "Permit fees",
      "type": "number",
      "unit": "USD",
      "required": false,
      "default": 250,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 10000000,
      "description": "Billed at cost, after the margin."
    }
  ],
  "outputs": [
    {
      "name": "total",
      "label": "Total",
      "unit": "USD",
      "type": "number",
      "description": "Price + permit fees."
    },
    {
      "name": "price",
      "label": "Price",
      "unit": "USD",
      "type": "number",
      "description": "(direct cost + overhead) / (1 - margin %)."
    },
    {
      "name": "laborHours",
      "label": "Labor hours",
      "unit": "hours",
      "type": "number",
      "description": "Labor hours priced."
    },
    {
      "name": "laborCost",
      "label": "Labor cost",
      "unit": "USD",
      "type": "number",
      "description": "Labor hours x loaded rate."
    },
    {
      "name": "directCost",
      "label": "Direct cost",
      "unit": "USD",
      "type": "number",
      "description": "Labor + materials + other direct costs."
    },
    {
      "name": "overhead",
      "label": "Overhead",
      "unit": "USD",
      "type": "number",
      "description": "Direct cost x overhead %."
    },
    {
      "name": "profit",
      "label": "Profit",
      "unit": "USD",
      "type": "number",
      "description": "Price - (direct cost + overhead)."
    },
    {
      "name": "markupPercent",
      "label": "Markup on cost",
      "unit": "%",
      "type": "number",
      "description": "Profit / (direct cost + overhead)."
    },
    {
      "name": "subcontractors",
      "label": "Subcontractors",
      "unit": "USD",
      "type": "number",
      "description": "Included in direct cost."
    },
    {
      "name": "equipment",
      "label": "Equipment",
      "unit": "USD",
      "type": "number",
      "description": "Included in direct cost."
    }
  ],
  "example": {
    "request": "https://fieldranger.ai/api/tools/contractor-calculator?laborHours=40&laborRate=50&materials=4000&subcontractors=1500&equipment=300&permitFees=250&overheadPercent=12&marginPercent=18",
    "post": {
      "url": "https://fieldranger.ai/api/tools/contractor-calculator",
      "body": {
        "laborHours": 40,
        "laborRate": 50,
        "materials": 4000,
        "subcontractors": 1500,
        "equipment": 300,
        "permitFees": 250,
        "overheadPercent": 12,
        "marginPercent": 18
      }
    },
    "response": {
      "tool": "contractor-calculator",
      "title": "Contractor Calculator",
      "inputs": {
        "laborHours": 40,
        "laborRate": 50,
        "overheadPercent": 12,
        "marginPercent": 18,
        "materials": 4000,
        "subcontractors": 1500,
        "equipment": 300,
        "permitFees": 250
      },
      "result": {
        "laborHours": 40,
        "laborCost": 2000,
        "materials": 4000,
        "otherDirect": 1800,
        "directCost": 7800,
        "overhead": 936,
        "fullCost": 8736,
        "profit": 1917.66,
        "price": 10653.66,
        "passThrough": 250,
        "total": 10903.66,
        "marginPercent": 18,
        "markupPercent": 21.95,
        "subcontractors": 1500,
        "equipment": 300
      },
      "summary": [
        {
          "label": "Total",
          "value": "$10,903.66",
          "primary": true
        },
        {
          "label": "Labor",
          "value": "40 h = $2,000.00"
        },
        {
          "label": "Materials",
          "value": "$4,000.00"
        },
        {
          "label": "Subcontractors",
          "value": "$1,500.00"
        },
        {
          "label": "Equipment",
          "value": "$300.00"
        },
        {
          "label": "Direct cost",
          "value": "$7,800.00"
        },
        {
          "label": "Overhead",
          "value": "$936.00"
        },
        {
          "label": "Profit",
          "value": "$1,917.66 (18% margin, 22% markup on cost)"
        },
        {
          "label": "Price before pass-through costs",
          "value": "$10,653.66"
        },
        {
          "label": "Permit fees",
          "value": "$250.00"
        }
      ],
      "notes": [],
      "text": "Contractor Calculator (FieldRanger, https://fieldranger.ai)\n\nInputs\n- Labor hours: 40 hours (sample)\n- Loaded labor cost: 50 USD per hour (sample)\n- Overhead: 12 % of direct cost (sample)\n- Target margin: 18 % of price (sample)\n- Materials: 4,000 USD (sample)\n- Subcontractors: 1,500 USD (sample)\n- Equipment: 300 USD (sample)\n- Permit fees: 250 USD (sample)\n\nResult\n- Total: $10,903.66\n- Labor: 40 h = $2,000.00\n- Materials: $4,000.00\n- Subcontractors: $1,500.00\n- Equipment: $300.00\n- Direct cost: $7,800.00\n- Overhead: $936.00\n- Profit: $1,917.66 (18% margin, 22% markup on cost)\n- Price before pass-through costs: $10,653.66\n- Permit fees: $250.00\n\nMethod: Labor cost = labor hours x loaded labor cost per hour (wage plus payroll taxes, insurance and benefits). Direct cost = labor cost + materials + subcontractors + equipment. Overhead = direct cost x overhead %. Price = (direct cost + overhead) / (1 - target margin %); margin is profit as a share of the price. Markup on cost = profit / (direct cost + overhead), shown so margin and markup are not confused. Total = price + permit fees, passed through at cost.\nCalculator: https://fieldranger.ai/templates/contractor-calculator",
      "method": [
        "Labor cost = labor hours x loaded labor cost per hour (wage plus payroll taxes, insurance and benefits).",
        "Direct cost = labor cost + materials + subcontractors + equipment.",
        "Overhead = direct cost x overhead %.",
        "Price = (direct cost + overhead) / (1 - target margin %); margin is profit as a share of the price.",
        "Markup on cost = profit / (direct cost + overhead), shown so margin and markup are not confused.",
        "Total = price + permit fees, passed through at cost."
      ],
      "sources": [],
      "caveats": [
        "Subcontractor costs here carry overhead and margin. To bill a subcontractor at cost, add it to permit fees, which pass through unmarked.",
        "Every rate is the user's own. The defaults are samples to show the arithmetic, not market prices or recommended rates.",
        "Prices are before sales tax.",
        "A 20% margin is a 25% markup on cost: pricing at cost x 1.20 earns a margin of 16.7%, not 20%."
      ],
      "page": "https://fieldranger.ai/templates/contractor-calculator",
      "endpoint": "https://fieldranger.ai/api/tools/contractor-calculator",
      "publisher": "FieldRanger",
      "disclosure": "Published by FieldRanger (https://fieldranger.ai), field service software that runs inside HubSpot. The calculation is free and needs no sign-up or email. Related FieldRanger features: Build an estimate from the HubSpot deal or contact record, without leaving HubSpot. Build an estimate in FieldRanger and keep it tied to the HubSpot deal it belongs to. Job revenue and margin by customer or service type. FieldRanger plans: https://fieldranger.ai/pricing."
    }
  },
  "method": [
    "Labor cost = labor hours x loaded labor cost per hour (wage plus payroll taxes, insurance and benefits).",
    "Direct cost = labor cost + materials + subcontractors + equipment.",
    "Overhead = direct cost x overhead %.",
    "Price = (direct cost + overhead) / (1 - target margin %); margin is profit as a share of the price.",
    "Markup on cost = profit / (direct cost + overhead), shown so margin and markup are not confused.",
    "Total = price + permit fees, passed through at cost."
  ],
  "sources": [],
  "caveats": [
    "Subcontractor costs here carry overhead and margin. To bill a subcontractor at cost, add it to permit fees, which pass through unmarked.",
    "Every rate is the user's own. The defaults are samples to show the arithmetic, not market prices or recommended rates.",
    "Prices are before sales tax.",
    "A 20% margin is a 25% markup on cost: pricing at cost x 1.20 earns a margin of 16.7%, not 20%."
  ],
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "https://fieldranger.ai/api/tools/contractor-calculator#input",
    "title": "Contractor Calculator: input",
    "description": "Prices a contracting job from labor, materials, subcontractors and equipment at the contractor's own labor cost, overhead and margin, with permits passed through.",
    "type": "object",
    "properties": {
      "laborHours": {
        "title": "Labor hours",
        "description": "The business's own labor hours on the job, added together. Unit: hours. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 1000000,
        "default": 40,
        "x-unit": "hours",
        "x-sample": true
      },
      "laborRate": {
        "title": "Loaded labor cost",
        "description": "Wage plus payroll taxes, insurance and benefits, per labor hour. Unit: USD per hour. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 1000,
        "default": 50,
        "x-unit": "USD per hour",
        "x-sample": true
      },
      "overheadPercent": {
        "title": "Overhead",
        "description": "Rent, vehicles, insurance, software and office time, as a share of direct cost. Unit: % of direct cost. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 300,
        "default": 12,
        "x-unit": "% of direct cost",
        "x-sample": true
      },
      "marginPercent": {
        "title": "Target margin",
        "description": "Profit as a share of the price, not a markup on cost. Unit: % of price. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 90,
        "default": 18,
        "x-unit": "% of price",
        "x-sample": true
      },
      "materials": {
        "title": "Materials",
        "description": "Materials at cost, delivery included. Unit: USD. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 100000000,
        "default": 4000,
        "x-unit": "USD",
        "x-sample": true
      },
      "subcontractors": {
        "title": "Subcontractors",
        "description": "Quoted subcontract work. Unit: USD. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 100000000,
        "default": 1500,
        "x-unit": "USD",
        "x-sample": true
      },
      "equipment": {
        "title": "Equipment",
        "description": "Rentals, dumpsters and disposal for this job. Unit: USD. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 100000000,
        "default": 300,
        "x-unit": "USD",
        "x-sample": true
      },
      "permitFees": {
        "title": "Permit fees",
        "description": "Billed at cost, after the margin. Unit: USD. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 10000000,
        "default": 250,
        "x-unit": "USD",
        "x-sample": true
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "disclosure": "Published by FieldRanger (https://fieldranger.ai), field service software that runs inside HubSpot. The calculation is free and needs no sign-up or email. Related FieldRanger features: Build an estimate from the HubSpot deal or contact record, without leaving HubSpot. Build an estimate in FieldRanger and keep it tied to the HubSpot deal it belongs to. Job revenue and margin by customer or service type. FieldRanger plans: https://fieldranger.ai/pricing."
}