--- title: "Partially update a specific blanket line item for a sales order" method: PATCH path: "/api/sales-orders/{salesOrderId}/blanket-line-items/{lineItemId}" tags: ["Sales Order Blanket Line Item"] --- # Partially update a specific blanket line item for a sales order `PATCH /api/sales-orders/{salesOrderId}/blanket-line-items/{lineItemId}` ## Path parameters - `salesOrderId` string, required - `lineItemId` string, required ## Response `200` Blanket line item - SalesOrderBlanketLineItemDto — Represents a blanket line item on a sales order. - `id` string, required — Unique id associated to this entity. - `name` string, required — The line item name. - `quantity` number, double, required — The line item quantity - `price` number, double, required — The line item price. - `discountedPrice` number, double, required — The discounted line item price. - `dueDate` string, date-time, nullable — Customer delivery date - `isTaxable` boolean, required — Dictate if this line item is taxable. - `overrideTaxRate` boolean, nullable — Dictate if the tax rate is overridden. - `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.PartLineItemDto.TaxCodeId is provided, the provided FulcrumProduct.PublicApi.Dto.SalesOrder.PartLineItem.PartLineItemDto.TaxRate will supercede the defined tax rate. - `itemId` string, required — Item id associated with this line item. - `description` string, nullable — The part line item description. Defaults to the item's description if none specified. - `accountingCodeId` string, nullable — Accounting code key identifier. Please reference /api/accounting-codes endpoint. - `internalNotes` string, nullable — The line item internal notes. Aka production notes. - `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.PartLineItemDto.DiscountAmount discount is percentage based (else, it's an absolute amount). - `discountAmount` number, double, nullable — The amount of the discount. - `links` CommonUrlDto[], nullable — List of links associated with the line item - `uri` string, uri, required — The uri to save. e.g. https://fulcrumpro.com - `name` string, nullable - `customFields` object, nullable — Custom fields that have been defined for the part line item; - `parentLineId` string, nullable — Identifier pointing to the parent line item (if this part line was sourced from a blanket line item). Please reference /api/sales-order/{salesOrderId}/blanket-line-items/list endpoint. - `subTotal` number, double, required — Total line item cost, including applicable discounts - `preDiscountSubTotal` number, double, required — Total line item cost, before discounts - `customerPartNumber` string, nullable — The customer's known part line item number. - `customerPartDescription` string, nullable — The customer's known part line item description. - `number` integer — Line number - `accountingDetails` CommonAccountingDetailsDto, required — An object that contains all accounting details. - `classId` string, nullable — Item class identifier. Please reference /api/item-classes endpoint. - `incomeAccountId` string, nullable — Income account (chart of accounts) key identifier. Please reference /api/chart-of-accounts endpoint. - `assetAccountId` string, nullable — Asset account (chart of accounts) key identifier. Please reference /api/chart-of-accounts endpoint. - `expenseAccountId` string, nullable — Expense account (chart of accounts) key identifier. Please reference /api/chart-of-accounts endpoint. - `cogsAccountId` string, nullable — COGS account (chart of accounts) key identifier. Please reference /api/chart-of-accounts endpoint. - `isFullyInvoiced` boolean — Indicate if this item has been fully invoiced. - `isInvoiced` boolean — Indicate if this item has ANY invoices. - `quantityInvoiced` number, double, nullable — Indicate the total quantity that have been invoiced (issued/paid). - `quantityOnInvoices` number, double, nullable — Indicate the total quantity that exists on any invoice (including open). - `costBreakdown` CommonCostBreakdownDto — Cost breakdown - `id` string, required — The id of the parent item. - `type` 'estimated' | 'inProgressJob' | 'completedJob' | 'cancelledJob', required - `quantity` integer, required — Number of units. - `quantityScrapped` integer, nullable — Number of units scrapped. - `calculatedOn` string, date-time, required — When was this cost breakdown last calculated/aggregated. - `time` CommonTimeDto, required — Time information - `labor` number, double, required — Total - `machine` number, double, required — Cost per unit - `setup` number, double, required — Cost per unit - `cumulative` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `cumulativeMaterial` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `cumulativeLabor` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `cumulativeMachine` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `cumulativeOutsideProcessing` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `itemMaterial` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `itemLabor` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `itemMachine` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `itemOutsideProcessing` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `shopRateSetup` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `shopRateRun` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `shopRateMachine` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `componentMaterial` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `componentLabor` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `componentMachine` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `componentOutsideProcessing` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `lines` CommonCostBreakdownLineDto[], required — Cost breakdown line details. - `costType` 'material' | 'labor' | 'setup' | 'machine' | 'outsideProcessing' | 'componentMaterial' | 'componentLabor' | 'componentMachine' | 'componentOutsideProcessing' | 'nestPartMaterialUsage' | 'nestPartMaterialScrap' | 'overhead' | 'unknown', required — Cost breakdown types - `operationType` 'labor' | 'setup' | 'machine' | 'outsideProcessing' — Operation type - `name` string, required — Decription of this line. - `cost` number, double, required — Cost. - `quantity` number, double, nullable — Quantity (if applicable) - `itemId` string, nullable — Id of the item that was picked. Please reference /api/items endpoint. - `itemName` string, nullable — The name of the item that was picked. - `accountingCodeId` string, nullable — Accounting code affected. Please reference /api/accounting-codes endpoint. - `operationInformation` CommonCostBreakdownOperationDto — Operation information - `operationId` string, required — Operation id. Please reference /api/operations - `name` string, nullable — Operation name. - `timeInSeconds` number, double, nullable — Time in seconds. - `timeInHours` number, double, nullable — Time in hours - `ratePerSecond` number, double, nullable — Rate per second - `ratePerHour` number, double, nullable — Rate per hour - `children` SalesOrderPartLineItemDto[] — Underlying part line items associated to this blanket line. - `id` string, required — Unique id associated to this entity. - `name` string, required — The line item name. - `quantity` number, double, required — The line item quantity - `price` number, double, required — The line item price. - `discountedPrice` number, double, required — The discounted line item price. - `dueDate` string, date-time, nullable — Customer delivery date - `isTaxable` boolean, required — Dictate if this line item is taxable. - `overrideTaxRate` boolean, nullable — Dictate if the tax rate is overridden. - `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.PartLineItemDto.TaxCodeId is provided, the provided FulcrumProduct.PublicApi.Dto.SalesOrder.PartLineItem.PartLineItemDto.TaxRate will supercede the defined tax rate. - `itemId` string, required — Item id associated with this line item. - `description` string, nullable — The part line item description. Defaults to the item's description if none specified. - `accountingCodeId` string, nullable — Accounting code key identifier. Please reference /api/accounting-codes endpoint. - `internalNotes` string, nullable — The line item internal notes. Aka production notes. - `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.PartLineItemDto.DiscountAmount discount is percentage based (else, it's an absolute amount). - `discountAmount` number, double, nullable — The amount of the discount. - `links` CommonUrlDto[], nullable — List of links associated with the line item - `uri` string, uri, required — The uri to save. e.g. https://fulcrumpro.com - `name` string, nullable - `customFields` object, nullable — Custom fields that have been defined for the part line item; - `parentLineId` string, nullable — Identifier pointing to the parent line item (if this part line was sourced from a blanket line item). Please reference /api/sales-order/{salesOrderId}/blanket-line-items/list endpoint. - `subTotal` number, double, required — Total line item cost, including applicable discounts - `preDiscountSubTotal` number, double, required — Total line item cost, before discounts - `customerPartNumber` string, nullable — The customer's known part line item number. - `customerPartDescription` string, nullable — The customer's known part line item description. - `number` integer — Line number - `accountingDetails` CommonAccountingDetailsDto, required — An object that contains all accounting details. - `classId` string, nullable — Item class identifier. Please reference /api/item-classes endpoint. - `incomeAccountId` string, nullable — Income account (chart of accounts) key identifier. Please reference /api/chart-of-accounts endpoint. - `assetAccountId` string, nullable — Asset account (chart of accounts) key identifier. Please reference /api/chart-of-accounts endpoint. - `expenseAccountId` string, nullable — Expense account (chart of accounts) key identifier. Please reference /api/chart-of-accounts endpoint. - `cogsAccountId` string, nullable — COGS account (chart of accounts) key identifier. Please reference /api/chart-of-accounts endpoint. - `isFullyInvoiced` boolean — Indicate if this item has been fully invoiced. - `isInvoiced` boolean — Indicate if this item has ANY invoices. - `quantityInvoiced` number, double, nullable — Indicate the total quantity that have been invoiced (issued/paid). - `quantityOnInvoices` number, double, nullable — Indicate the total quantity that exists on any invoice (including open). - `costBreakdown` CommonCostBreakdownDto — Cost breakdown - `id` string, required — The id of the parent item. - `type` 'estimated' | 'inProgressJob' | 'completedJob' | 'cancelledJob', required - `quantity` integer, required — Number of units. - `quantityScrapped` integer, nullable — Number of units scrapped. - `calculatedOn` string, date-time, required — When was this cost breakdown last calculated/aggregated. - `time` CommonTimeDto, required — Time information - `labor` number, double, required — Total - `machine` number, double, required — Cost per unit - `setup` number, double, required — Cost per unit - `cumulative` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `cumulativeMaterial` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `cumulativeLabor` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `cumulativeMachine` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `cumulativeOutsideProcessing` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `itemMaterial` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `itemLabor` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `itemMachine` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `itemOutsideProcessing` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `shopRateSetup` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `shopRateRun` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `shopRateMachine` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `componentMaterial` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `componentLabor` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `componentMachine` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `componentOutsideProcessing` CommonCostDto, required — Cost information - `total` number, double, required — Total - `perUnit` number, double, required — Cost per unit - `lines` CommonCostBreakdownLineDto[], required — Cost breakdown line details. - `costType` 'material' | 'labor' | 'setup' | 'machine' | 'outsideProcessing' | 'componentMaterial' | 'componentLabor' | 'componentMachine' | 'componentOutsideProcessing' | 'nestPartMaterialUsage' | 'nestPartMaterialScrap' | 'overhead' | 'unknown', required — Cost breakdown types - `operationType` 'labor' | 'setup' | 'machine' | 'outsideProcessing' — Operation type - `name` string, required — Decription of this line. - `cost` number, double, required — Cost. - `quantity` number, double, nullable — Quantity (if applicable) - `itemId` string, nullable — Id of the item that was picked. Please reference /api/items endpoint. - `itemName` string, nullable — The name of the item that was picked. - `accountingCodeId` string, nullable — Accounting code affected. Please reference /api/accounting-codes endpoint. - `operationInformation` CommonCostBreakdownOperationDto — Operation information - `operationId` string, required — Operation id. Please reference /api/operations - `name` string, nullable — Operation name. - `timeInSeconds` number, double, nullable — Time in seconds. - `timeInHours` number, double, nullable — Time in hours - `ratePerSecond` number, double, nullable — Rate per second - `ratePerHour` number, double, nullable — Rate per hour ## Other responses - `404` — Sales order or line item did not exist --- [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)