Sign in
PurchaseOrders

Create a purchase order line item

Create a new purchase order line item (required scope finance:write)

post/v1/finance/purchaseorders/{purchaseOrderId}/lineItems

Path parameters

purchaseOrderIdinteger required

The purchase order id

Headers

Customer-Idinteger required

The customer identifier

Request body

contactIdinteger nullable

The unique identifier of the contact associated with this purchase order item

quantitynumber double required

The quantity of the purchase order item

descriptionstring

Description of the purchase order line item

taxIdinteger nullable

Tax identifier (must exist and not be deleted for customer). Nullable

unitCostnumber double nullable

Unit cost (nullable, non-negative)

unitSellingPricenumber double

Unit selling price (non-negative)

nominalCodeIdinteger nullable

Nominal code identifier (must exist and not be deleted for customer)

departmentCodeIdinteger nullable

Department code identifier (must exist and not be deleted for customer)

Example request

{
  "contactId": 54321,
  "quantity": 1,
  "description": "Replacement filter cartridge",
  "taxId": 1001,
  "unitCost": 5.5,
  "unitSellingPrice": 10.99,
  "nominalCodeId": 50001,
  "departmentCodeId": 20002
}

Response

Created

idinteger

Identifier of the newly created record