---
title: "Create a part line item on a sales order"
method: POST
path: "/api/sales-orders/{salesOrderId}/part-line-items"
tags: ["Sales Order Part Line Item"]
---

# Create a part line item on a sales order

`POST /api/sales-orders/{salesOrderId}/part-line-items`

## Path parameters

- `salesOrderId` string, required

## Request body

- SalesOrderPartLineItemCreateDto — Represents a part line item on a sales order.
  - `itemId` string, required — Item id associated with this line item.
  - `quantity` number, double — The line item quantity
  - `price` number, double, nullable — The line item price. Note, if a price break exists for the item being added (vendor price breaks, item price breaks, etc), this value will be ignored as it is quantity-driven based on the price breaks that do/will exist. If this value is not provided and no price breaks exist, the default will be 0.
  - `isTaxable` boolean, nullable — Dictate if this line item is taxable.
  - `taxCodeId` string, nullable — Tax code key identifier. Please reference /api/tax-rates endpoint.
  - `taxRate` number, double, nullable — Tax rate to use for this entity. If a FulcrumProduct.PublicApi.Dto.SalesOrder.PartLineItem.PartLineItemCreateDto.TaxCodeId is provided, the provided FulcrumProduct.PublicApi.Dto.SalesOrder.PartLineItem.PartLineItemCreateDto.TaxRate will supercede the defined tax rate.
  - `overrideTaxRate` boolean, nullable — Indicate if the tax supplied is intended to be an override.
  - `description` string, nullable — The part line item description. Defaults to the item's description if none specified.
  - `internalNotes` string, nullable — The line item internal notes
  - `itemNotes` string, nullable — The line item notes (visible in job tracking).
  - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for this line item.
  - `isPercentageDiscount` boolean, nullable — Indicates whether FulcrumProduct.PublicApi.Dto.SalesOrder.PartLineItem.PartLineItemCreateDto.DiscountAmount discount is percentage based (else, it's an absolute amount).
  - `discountAmount` number, double, nullable — The amount of the discount.
  - `links` CommonUrlDto[], nullable — A list of links/urls to associated with the line item.
    - `uri` string, uri, required — The uri to save. e.g. https://fulcrumpro.com
    - `name` string, nullable
  - `deliveryDate` string, date-time, nullable — The delivery date for the line item. Only the calendar date is used, exactly as written; any time or UTC offset is ignored.
  - `unitOfMeasureName` string, nullable — The unit of measure to apply. If left blank, the default unit of measure for the item will be applied.
  - `accountingCodeId` string, nullable — Accounting code key identifier. Please reference /api/accounting-codes endpoint. If this value is not provided and the name matches a defined "default fee", the accounting code on the "default fee" will be used.
  - `isCustomerItem` boolean, nullable — Determines whether or not to display the customer part number and customer part description.
  - `customerPartNumber` string, nullable — Used for the part number on customer facing documents when IsCustomerItem is true
  - `customerPartDescription` string, nullable — Used for the description on customer facing documents when IsCustomerItem is true

## Response `200`

Part line item added to sales order

- CreatedResponseDto — Response for a created record
  - `id` string, required — The id of the created record

## Other responses

- `400` — Validation issues with input

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/revisions/016c1fd45a3f/schema)