Bill Of Materials

A Bill of Materials (BOM) is a list of materials and quantities that are estimated to be needed for a job. Contractors already make materials estimates in order to bid on jobs, and these estimates can be used in Kojo once the job is won to guide procurement decisions and track spending throughout the project.

Project managers and purchasing agents can view and edit the BOM and track spending. Foremen can requisition from the BOM on their mobile devices, quickly choosing from a job-specific list of planned, approved, and in-spec materials every time.

Schema

`BillOfMaterials`

Name	Type	Description	Example
id	`ID`	Unique BOM identifier	`"ckmnpybisiy5x08abky4g2d1f"`
createdAt	`DateTime`	When this Bill of Materials was created	`"2021-03-24 17:26:46.983Z"`
updatedAt	`DateTime`	When this Bill of Materials was updated	`"2021-03-24 17:26:46.983Z"`
name	`string`	Name of the Bill of Materials	`"Rough-in"`
jobId	`ID`	The ID of the job this BOM is associated with	See Jobs docs
jobCode	`string`	The code of the job this BOM is associated with	See Jobs docs

REST Endpoints

GET `/jobs/:idOrCode/billsOfMaterials`

Gets a list of all of the Bill Of Materials for a job.

Example Request

GET https://api.kojo.tech/jobs/clk8ms0mp000ksswy5ibhekos/billsOfMaterials

Example Response

[
  {
    "createdAt": "2022-01-13T17:42:40.019Z",
    "id": "ckyd9f1jn4332914x62igytcx",
    "name": "Rough-in",
    "jobId": "clk8ms0mp000ksswy5ibhekos",
    "jobCode": "01-100",
    "updatedAt": "2022-01-13T17:42:40.020Z"
  }
]

POST `/jobs/:idOrCode/billOfMaterials`

Creates a new Bill Of Materials on a job.

Parameters

Name	Type	Description	Example
name	`string?`	Name of the Bill of Materials	`"Rough-in"`

Example Request

POST https://api.kojo.tech/jobs/clk8ms0mp000ksswy5ibhekos/billOfMaterials
{
  "name": "Rough in"
}

Example Response

{
  "createdAt": "2022-01-13T17:42:40.019Z",
  "id": "ckyd9f1jn4332914x62igytcx",
  "name": "Rough-in",
  "jobId": "clk8ms0mp000ksswy5ibhekos",
  "jobCode": "01-100",
  "updatedAt": "2022-01-13T17:42:40.020Z"
}

Schema​