Skip to main content

Invoice Items

Invoice Item represents an individual line item on an Invoice

Schema​

InvoiceItem​

NameTypeDescriptionExample
idIDUnique identifier for invoice items"ckmnpybisiy5x08abky4g2d1f"
createdAtDateTimeWhen this invoice item was created"2021-03-24 17:26:46.983Z"
updatedAtDateTimeWhen this invoice item was updated"2021-03-24 17:26:46.983Z"
descriptionstring?Description of the invoice item3/4" EMT
extPriceFloatfloat?EXT price of the item125.00
hasExceptionbooleanIndicates whether the invoice item has any exceptionsfalse
invoiceIdIDThe ID of the invoice this item is attached to"ckmnpybisiy5x08abky4g2d1f"
lineNumberintNumber representing the index of the line item within it's invoice3
notesstring?Additional handwritten details attached to this item"This item is important"
shipQuantityfloat?Quantity of this item100
unitPriceFloatfloat?Unit price of this item1.25
unitsOfMeasurestring?Unit of measurement for this itemEA
taxCodestring?Tax code applicable to this invoice item"CA"
taxRatefloat?Tax rate applied to this invoice item0.075
phaseCodestring?Phase code associated with this invoice item"100"
costCategorystring?Cost category code associated with this invoice item"M"

REST Endpoints​

GET /invoices/:id/items​

Read the items associated with an invoice

Accepts all standard pagination parameters.

Allowed orderBy fields: createdAt, id, lineNumber, updatedAt.

Default (direction, orderBy): (lineNumber, ASC)

Allowed filter fields: createdAt, description, hasException, id, notes, updatedAt.

Response​

A list of Invoice Item objects.

Example Request​

GET https://api.kojo.tech/invoices/ckmnpybisiy5x08abky4g2d1f/items

Example Response​

[
{
"id": "clku7gtqt000cpwtzv6e971xg",
"createdAt": "2021-03-24 17:26:46.983Z",
"updatedAt": "2021-03-24 17:26:46.983Z",
"description": "LUT CABLE",
"extPriceFloat": 1328.22,
"hasException": false,
"invoiceId": "ckmnpybisiy5x08abky4g2d1f",
"lineNumber": 1,
"notes": null,
"shipQuantity": 1,
"unitPriceFloat": 1328.22,
"unitsOfMeasure": "EA",
"taxCode": "test",
"taxRate": 0,
"phaseCode": "1-010",
"costCategory": "L"
}
]