PriceDetailLevel

PriceDetailLevel is a parameter used in pricing and cataloging systems to control the granularity of price information that is returned or calculated. It dictates which price components are included in results or in calculations, such as base price, taxes, discounts, surcharges, shipping, currency, and the validity range of a price.

In practice, priceDetailLevel provides a spectrum from minimal to full detail. Commonly, systems offer levels like basic, summary, detailed, and full (or equivalents). A basic level might return only the base price and currency, while a summary level could include taxes or a final total. A detailed level typically includes taxes, discounts, surcharges, and currency, and a full level may expose all elements, including shipping costs, promotional adjustments, and the final payable amount. Exact names and available options vary by implementation, and some systems use separate flags to enable specific components (for example, taxIncluded or discountsApplied) in addition to a general level.

Usage and performance considerations: higher detail levels may incur more computation and data transfer, so selecting the appropriate level can improve response time and reduce payload size. PriceDetailLevel often interacts with localization, tax rules by jurisdiction, and promotions, so consistency between the requested level and the pricing rules is important for accuracy.

Examples: requesting SUMMARY might return base price plus total taxes in a localized currency, while requesting FULL could return base price, all tax components, discounts, shipping, and the final total. The exact behavior is implementation dependent.