Skip to main content

BulkCostPrice

Volume-based cost pricing tier for quantity-dependent cost calculations.

Represents cost prices that apply to specific quantity ranges, enabling volume purchasing advantages and margin calculations based on purchase quantities. Used for inventory management and pricing optimization.

type BulkCostPrice implements IDiscount {
  id: String!
  createdAt: DateTime!
  lastModifiedAt: DateTime!
  value: Float!
  quantityFrom: Int!
  validFrom: DateTime
  validTo: DateTime
  priceId: String!
}

Fields​

BulkCostPrice.id ● String! non-null scalar​

Unique identifier for the bulk cost price record.

Auto-generated UUID that serves as the primary key for bulk cost price management operations, linking to price records and quantity-based cost calculations.

BulkCostPrice.createdAt ● DateTime! non-null scalar​

Timestamp when the bulk cost price record was initially created.

Automatically set when the bulk cost price is first saved to the system. Used for audit trails and cost price management.

BulkCostPrice.lastModifiedAt ● DateTime! non-null scalar​

Timestamp when the bulk cost price record was last updated.

Automatically updated whenever any field in the bulk cost price record is modified. Essential for tracking cost price changes and synchronization.

BulkCostPrice.value ● Float! non-null scalar​

Cost price value applied to the specified quantity range.

The actual cost per unit when purchasing within the defined quantity tier. Used for margin calculations and pricing decisions based on volume purchasing power.

BulkCostPrice.quantityFrom ● Int! non-null scalar​

Minimum quantity required to qualify for this cost price tier.

Defines the lower bound of the quantity range where this cost price applies. Creates tiered cost structures that reflect volume purchasing advantages. Minimum value is 1.

BulkCostPrice.validFrom ● DateTime scalar​

Date when this bulk cost price becomes active and available for cost calculations.

If not specified, the bulk cost price is immediately effective. Used for scheduling cost price changes and managing time-based pricing strategies.

BulkCostPrice.validTo ● DateTime scalar​

Date when this bulk cost price expires and is no longer available for cost calculations.

If not specified, the bulk cost price remains active indefinitely. Used for temporary cost pricing and promotional cost structures.

BulkCostPrice.priceId ● String! non-null scalar​

Price record identifier for bulk cost price association.

Links the bulk cost price to a specific product price, enabling quantity-based cost calculations and margin analysis for volume purchases.

Interfaces​

IDiscount interface​

Returned By​

bulkCostPriceCreate mutation ● bulkCostPriceUpdate mutation

Member Of​

BulkCostPriceResponse object