Skip to main content

priceCalculateBulk

Calculate prices for many order lines in one request, under a single customer context.

Returns exactly one result per distinct (productId, quantity) pair requested — never a shorter list. Each result carries either a price or an error; a line that cannot be priced does not fail the request or affect its siblings.

Prefer this over issuing many priceCalculate calls: the customer context and the underlying discount, tax and price lookups are resolved once for the whole request.

Possible errors:

  • PRICE_CALCULATION_ERROR: the request as a whole could not be processed
  • UNAUTHENTICATED: Invalid or missing authentication
  • FORBIDDEN: Insufficient permissions, or unauthorized use of contactId/customerId/companyId

AUTH: Role=[pricing.OWNER,pricing.EDITOR,pricing.VIEWER]

priceCalculateBulk(
input: PriceCalculateBulkInput!
): [PriceCalculateBulkLine!]!

Arguments​

priceCalculateBulk.input ● PriceCalculateBulkInput! non-null input​

Type​

PriceCalculateBulkLine object​

The outcome for one requested line. Exactly one of price and error is set.

Every requested (productId, quantity) pair comes back exactly once, priced or explained — a short list is never returned. Callers that treat a missing price as zero depend on this.