PApaperlessparts
Quote Items

Create a new quote item

Creates a new quote item on an existing quote by attaching a part from the part library.

By default, the part is imported with the process, material, and quantities you specify, and pricing is calculated fresh using your current pricing rules.

When use_latest_pricing is true, the part is imported with the process, material, and quantities from the most recent quote on which this part appeared, including all subcomponents and subassemblies; no live pricing refresh is performed. Part must be root part to add to a quote.

post/quotes/public/items

Request

Request body

quotestring required

The UUID of the quote to add the line item to.

partstring required

The UUID of the part to import from the part library. Required in all cases, including when use_latest_pricing is true.

use_latest_pricingboolean

When false (the default), the part is imported with fresh pricing using the process, material, and quantities you supply. When true, costing and pricing are copied from the most recent quote on which this part appeared, including all subcomponents and subassemblies. See endpoint description for details on mutual exclusions and fallback behaviour.

quantitiesinteger[]

The quantities to price the part at. Required when use_latest_pricing is false or omitted. Must not be provided when use_latest_pricing is true.

processstring nullable

The UUID of the process to apply to the part. Optional. Must not be provided when use_latest_pricing is true.

materialstring nullable

The UUID of the supplier material to apply to the part. Optional. Must not be provided when use_latest_pricing is true.

public_notesstring nullable

Notes visible to the customer. Optional. Must not be provided when use_latest_pricing is true.

private_notesstring nullable

Internal notes not visible to the customer. Optional. Must not be provided when use_latest_pricing is true.

estimated_annual_usageinteger nullable

Estimated annual usage quantity. Optional; only valid when the estimated annual usage feature is enabled for your account. Must not be provided when use_latest_pricing is true.

metadataobject

Arbitrary key-value metadata to attach to the quote item. Optional. Must not be provided when use_latest_pricing is true.

unit_price_precisioninteger

The number of decimal places used when displaying unit prices (2–4). Optional; if the selected process defines a precision, that value takes precedence. Must not be provided when use_latest_pricing is true.

Example request

{
  "quote": "8f14e45f-ceea-467a-a866-ad5ef0911473",
  "part": "1679091c-5a88-46af-9fbe-81e0e6b21533",
  "quantities": [
    1,
    5,
    10
  ],
  "process": "45c48cce-2e2d-4e5a-8ee2-9c1e6b1b5b1e",
  "material": "d3d94468-fc4a-4670-b5c7-56c3d26a9a79",
  "estimated_annual_usage": 500,
  "unit_price_precision": 2
}

Response

Successful response

idinteger
type'automatic' | 'manual'

Indicates whether the quote item is associated with a part (automatic pricing), or not (manual pricing).

root_component_idinteger

ID of the root component. A root component houses the pricing information for a quote item. Every quote item has a root component. In the case of an automatic quote item, the root component corresponds to a part; in the case of a manual quote item, which does not have an associated part, the root component stores the manual pricing data. As the name 'root component' implies, it is possible for a quote item to have many components, as in the case of an assembly of nested parts.

positioninteger

The position of the quote item in the quote display, indexed from 1.

export_controlledboolean

Whether or not this quote item contains data that is export controlled (ITAR) by the US Government.

component_idsinteger[]
metadataobject nullable
private_notesstring nullable
public_notesstring nullable
workflow_statusstring nullable
root_componentobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.