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
extPriceFloatIncludingTaxfloat?EXT price of the item inclusive of tax130.00
hasExceptionbooleanIndicates whether the invoice item has any exceptionstrue
invoiceInvoice?Invoice associated with this itemSee Invoice docs
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"Set this aside."
shipQuantityfloat?Quantity of this item100
unitPriceFloatfloat?Unit price of this item1.25
unitsOfMeasurestring?Unit of measurement for this itemEA
creditMemoItemsCreditMemoItem[]Credit memo items associated with this invoice itemSee CreditMemoItem
orderItemsItem[]Order items associated with this invoice itemSee Item docs
taxCodestring?Tax code applicable to this invoice item"CA"
taxRatefloat?Tax rate applied to this invoice item0.04
phaseCodestring?Phase code associated with this invoice item"450"
costCategorystring?Cost category code associated with this invoice item"M"
glCodeGLCode?GL code associated with this invoice item"5000"

Queries​

invoiceItem​

Get a single invoice item by ID.

Parameters​

NameTypeDescription
idIDID of the invoice item to fetch

Response​

A single InvoiceItem.

Example Request​

query {
invoiceItem(id: "ckb91igzt01e90733giki0v0p") {
id
lineNumber
shipQuantity
unitPriceFloat
description
}
}

Example Response​

{
"id": "ckb91igzt01e90733giki0v0p",
"lineNumber": 1,
"shipQuantity": 100,
"unitPriceFloat": 1328.22,
"description": "3/4\" EMT",
}

invoiceItems​

Get the items on an invoice.

Parameters​

NameTypeDescription
invoiceIdIDID of the invoice to retrieve items for

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 InvoiceItem objects.

Example Request​

query {
invoiceItems(invoiceId: "ckb91igzt01e90733giki0v0p") {
id
lineNumber
shipQuantity
unitPriceFloat
description
}
}

Example Response​

[
{
"id": "ckb91igzt01e90733giki0v0p",
"lineNumber": 1,
"shipQuantity": 100,
"unitPriceFloat": 1328.22,
"description": "3/4\" EMT",
}
]