QP Pricing Agreements
Description:
Report detailing QP Pricing Agreements
Parameters
Agreement Name, Agreement Number, Revision, Agreement Type, Price List, Invoice To, Invoice Contact, Customer, Customer Number, Contact, Salesperson, Item, Valid on Date, Display Price Breaks, Display Pricing Attributes
Used tables
qp_currency_lists_tl, oe_pricing_contracts_v, oe_agreements_b, qp_secu_list_headers_v, qp_list_lines_v, mtl_system_items_vl, qp_price_formulas_vl, mtl_customer_items_all_v, qp_price_breaks_v, qp_pricing_attributes, qpa, qll, qpb, qpat
Categories
Dependencies
If you would like to try one of these Oracle EBS SQLs without having Blitz Report installed, note that some of the reports require functions from utility package xxen_util.
Example Report
QP Pricing Agreements 01-Sep-2024 225031.xlsx
Report SQL
www.enginatics.com/reports/qp-pricing-agreements/
Blitz Report™ import options
Case Study & Technical Analysis: QP Pricing Agreements Report
Executive Summary
The QP Pricing Agreements report is a crucial sales and pricing configuration audit tool within Oracle Advanced Pricing (QP). It provides a comprehensive listing of customer-specific pricing agreements, detailing their terms, associated price lists, and any special pricing conditions. This report is indispensable for sales managers, pricing analysts, and contract administrators to understand and audit complex negotiated pricing, ensure compliance with contract terms, troubleshoot pricing discrepancies, and maintain accurate records of customer-specific pricing strategies.
Business Challenge
For businesses with negotiated customer pricing, managing these “agreements” is vital for sales effectiveness and profitability. However, the complexities of defining and auditing these agreements in Oracle EBS can present significant challenges:
- Opaque Agreement Terms: It’s often difficult to get a single, consolidated view of all the pricing terms, associated price lists, and specific item prices defined within a customer pricing agreement. This fragmentation hinders effective contract management.
- Ensuring Consistent Application: Without clear reporting, it’s challenging to ensure that sales orders for a specific customer consistently receive the correct negotiated prices as defined in their agreement.
- Date-Effective Agreement Management: Pricing agreements often have specific start and end dates or revisions. Accurately tracking which version of an agreement is valid on a given date is crucial for compliance and correct pricing.
- Troubleshooting Pricing Errors: When a customer is invoiced incorrectly, diagnosing whether the issue stems from the pricing agreement setup (e.g., wrong price list assigned, incorrect item price) requires precise information on the active terms.
- Sales Performance Analysis: Understanding the profitability of individual pricing agreements is essential for sales strategy, but often requires detailed data that is difficult to extract.
The Solution
This report offers a powerful, configurable, and auditable solution for analyzing and managing customer pricing agreements, transforming how sales and pricing teams oversee their negotiated terms.
- Comprehensive Agreement Overview: It presents a detailed list of pricing agreements, including their names, numbers, types, associated price lists, and key customer information. This provides a clear, at-a-glance understanding of customer-specific pricing.
- Date-Effective Term Visibility: The crucial
Valid on Dateparameter allows users to view pricing agreement terms as they were defined and active on any specific date, which is vital for historical analysis, troubleshooting, and audit purposes. - Configurable Detail Levels: Parameters like
Display Price BreaksandDisplay Pricing Attributesenable users to dynamically include more granular details about the prices and conditions within each agreement. - Streamlined Audit and Compliance: It serves as a robust audit trail for all pricing agreement configurations, facilitating compliance checks and ensuring that negotiated terms are accurately implemented and applied.
Technical Architecture (High Level)
The report queries core Oracle Advanced Pricing and Order Management tables to extract and present detailed pricing agreement configurations.
- Primary Tables/Views Involved:
oe_agreements_b(the central table for agreement headers).oe_pricing_contracts_v(a view that links agreements to pricing lists).qp_secu_list_headers_v(for price list headers associated with agreements).qp_list_lines_v(for individual item prices within the associated price list).mtl_system_items_vl(for item master details).hz_cust_accountsandhz_parties(for customer details).qp_price_breaks_vandqp_pricing_attributes(for detailed pricing conditions).
- Logical Relationships: The report starts by retrieving agreement headers from
oe_agreements_b. It then links these agreements to their associated price lists (viaoe_pricing_contracts_vandqp_secu_list_headers_v). For each price list, it retrieves item prices fromqp_list_lines_v. TheValid on Dateparameter is applied to these date-effective tables to ensure that only agreement terms and prices active on the specified date are retrieved.
Parameters & Filtering
The report offers extensive parameters for precise filtering and detailed data inclusion:
- Agreement Identification:
Agreement Name,Agreement Number,Revision,Agreement Typeallow for specific targeting of agreements. - Customer Context:
Customer,Customer Number,Invoice To,Invoice Contact,Contactidentify specific customer agreements. - Salesperson & Item Filters:
SalespersonandItemenable analysis by sales representative or product. - Date-Effective Filter:
Valid on Dateis the most critical parameter, allowing users to define the point in time for which they want to retrieve active agreement data. This ensures historical accuracy. - Detail Inclusion Flags:
Display Price BreaksandDisplay Pricing Attributesdynamically include granular pricing conditions within the report.
Performance & Optimization
As a configuration and master data report dealing with date-effective tables, it is optimized for efficient historical and current data retrieval.
- Date-Effective Table Querying: The core tables (
oe_agreements_b,qp_list_lines_v) are designed and indexed by Oracle to efficiently retrieve the correct version of agreement terms and prices for a givenValid on Date, ensuring fast performance. - Indexed Joins: The queries leverage standard Oracle indexes on
agreement_id,price_list_id,customer_id, anditem_idfor efficient joins between the various agreement, pricing, and customer master tables. - Parameter-Driven Scope: Filtering by
Agreement Name,Customer, andItemsignificantly reduces the data volume processed, preventing the report from attempting to process excessively broad datasets when detailed analysis is not required.
FAQ
1. What is the primary purpose of a ‘Pricing Agreement’ in Oracle EBS? A ‘Pricing Agreement’ (also known as a sales agreement or customer agreement in Order Management) defines specific, negotiated pricing and terms for a customer over a period. It allows organizations to offer special pricing to key customers that might differ from standard price list prices or promotional offers, ensuring consistent and agreed-upon pricing.
2. How does the ‘Valid on Date’ parameter ensure accurate agreement terms?
Pricing agreements can have revisions or date-effective changes to their terms. The Valid on Date parameter ensures that the report retrieves the exact terms, associated price list, and item prices that were active under that agreement on the specified date, which is crucial for accurate historical analysis, auditing, and troubleshooting.
3. Can this report help troubleshoot why a customer is not getting their agreed-upon price?
Yes. By running the report for the specific Customer, Agreement Name, and Item (with the relevant Valid on Date), you can verify if the item is included in the agreement, which price list is linked, and if there are any Price Breaks or Pricing Attributes that might be affecting the final price compared to what was expected.
Oracle E-Business Suite Reporting Library
We provide an open source Oracle EBS SQLs as a part of operational and project implementation support toolkits for rapid Excel reports generation.
Blitz Report™ is based on Oracle EBS forms technology, and hence requires minimal training. There are no data or performance limitations since the output files are created directly from the database without going through intermediate file formats such as XML.
Blitz Report can be used as BI Publisher and Oracle Discoverer replacement tool. Standard Oracle BI Publisher and Discoverer reports can also be imported into Blitz Report for immediate output to Excel. Typically, reports can be created and version tracked within hours instead of days. The concurrent request output automatically opens upon completion without the need for re-formatting.
The Filters, Columns, Rows and Values fields are used to create and deliver the data in pivot table format with full drill down to details.

The Excel template upload functionality in Blitz Report allows users to create their own layouts by uploading an Excel template with additional sheets and charts, automatically refreshed when the report runs again. This allows to create custom dashboards and more advanced visualizations of report data.

You can download and use Blitz Report free of charge for your first 30 reports.
The installation and implementation process usually takes less than 1 hour; you can refer to our installation and user guides for specific details.
If you would like to optimize your Oracle EBS implementation and or operational reporting you can visit www.enginatics.com to review great ideas and example usage in blog. Or why not try for yourself in our demo environment.
Useful Links
Blitz Report™ – World’s fastest data upload and reporting for Oracle EBS
Oracle Discoverer replacement – importing worksheets into Blitz Report™
Blitz Report™ Questions & Answers
Supply Chain Hub by Blitz Report™
© 2025 Enginatics