Bulk pricing in iPaaS.com lets you sync quantity-based and time-bound pricing for your catalog - the kind of "buy more, pay less" pricing, promotional windows, and per-unit price breaks that many commerce and ERP systems support. A bulk price is defined once and then assigned to the products or variants it applies to.
What a Bulk Price Holds
Each bulk price record captures:
Quantity: the quantity threshold the price applies at (the "buy N" in a quantity break).
Bulk Price: the price at that quantity.
Discount Percent: a percentage discount, as an alternative or complement to a fixed price.
Currency: the currency the price is in (resolved via the Lookup API; defaults to the platform's standard currency if not supplied).
Start Date / End Date: an optional effective window, so promotional or seasonal pricing can begin and expire automatically.
Product Unit: the unit of measure the price is tied to, where a product is sold in multiple units.
Bulk prices also support custom fields and external IDs, like other iPaaS.com data types.
How a Bulk Price Is Assigned
A bulk price carries an applies-to list - the set of records the price applies to. Each assignment points at a specific catalog record, so a single bulk price can apply to one or many products or variants. This mirrors how images are assigned: the price is stored once and linked to the records that use it.
NOTE: The catalog records a bulk price applies to must already exist before the assignment can resolve. In a catalog sync, products and variants are created first, then bulk prices are written and assigned to them.
Effective Windows and Reactivation
Because bulk prices can carry start and end dates, they naturally support time-limited pricing. A bulk price that has been deactivated can be reactivated if the pricing needs to come back into effect, rather than being recreated from scratch.
Common Use Case
Syncing tiered or contract pricing from an ERP or B2B commerce platform: each price tier (for example, 10+ units at one price, 100+ at another) comes across as a bulk price with the appropriate quantity and amount, assigned to the products it covers, with an effective window where the source system uses one.