/bid/invoice/items
This action lists all active invoice items for which bids can be created.
Request
| Field | Description | Required |
|---|---|---|
report_id | Unique identifier for a work order | Yes |
Example:
{
"report_id": 4064
}
curl -H 'Content-Type: application/json' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-d '{"report_id": 4064}' \
https://ppw.web/svc/bid/invoice/items
Response
| Field | Description | Type |
|---|---|---|
report_id | Unique identifier for a work order | number |
invoice_items | Invoice items | array |
Each item in invoice_items is a JSON object; they’ll have the
following fields:
| Field | Description | Type |
|---|---|---|
invoice_item_id | Unique identifier for the invoice item | number |
description | Name of the invoice item | string |
client_price | Client price for the item | number |
contractor_price | Contractor price for the item | number |
uom | Default Unit of Measure (UOM) | number |
The client_price and contractor_price for a invoice item are
specific to the work order specified in the request.
Example successful response:
{
"report_id": 4064,
"invoice_items": [{
"invoice_item_id": "42921",
"description": "Locks-Padlocks",
"client_price": 3,
"contractor_price": 2,
"uom": 1
}, {
"invoice_item_id": "42922",
"description": "J120\/INSP: Exterior Inspection - Biweekly",
"client_price": 2.9,
"contractor_price": 3.4,
"uom": 1
}, {
"invoice_item_id": "42923",
"description": "Winterization (Dry)",
"client_price": 30.0,
"contractor_price": 40.0,
"uom": 0
}, {
"invoice_item_id": "42924",
"description": "Winterization (Wet)",
"client_price": 15.0,
"contractor_price": 30.20,
"uom": 1
}]
}
Errors
| Error Type | Description | Status Code |
|---|---|---|
access_denied | Access token is invalid or expired | 401 |
scope_invalid | Client app does not have the required OAuth scope | 403 |
wo_invalid | Work order is invalid | 400 |