1. Retail & E-Commerce CPQ
  2. Data model
Reference

The tables behind Retail & E-Commerce CPQ

Retail & E-Commerce CPQ ships with 11 tables, grouped here by the feature that uses them. Every record your team works with lives in one of them, and you can add fields and tables in Proto.

Tables
11
Features
6
Change it
Add fields and tables in Proto

How the model is organised

Quote Preparation

Quotes references Organizations, Customers through Counterparty, and team members through Owner. Customers and team members each reference Organizations; team members.User identifies the platform identity in Users.

Line Pricing

Quote lines belongs to Quotes through Parent. Quantity, unit price USD and discount USD produce net line USD, which contributes to Quotes.net amount USD. Exchange rates holds read-only rates with effective from and Overridden context.

Channel Bundles

Bundle offers references Quotes through Parent and Organizations through Organization. Channel, promotion code, bundle quantity and valid until describe the offer being reviewed.

Pricing Review

Review decisions belongs to Quotes and identifies Reviewer in team members. Source revision and operation key tie the decision to its request and commercial revision.

Order Handoff

Operation receipts belongs to Quotes. Expected revision, Action and operation key identify the request; result state and external reference describe its recorded outcome.

Evidence and Reconciliation

Record attachments belongs to Quotes and identifies uploaded by in team members. Visibility and evidence type describe the evidence; operation receipts retains effect references and failure reason for investigation.

Every table, by feature

Quote Preparation

7 tablesAbout this feature
  • Quotes

    Customer quotes with lifecycle, validity, revision and USD net amount

    Linked to Organizations, Team members, Customers
  • Customers

    Eligible active customer parties in the same organization

    Linked to Organizations
  • Organizations

    Retail and e-commerce selling organizations with time zone and currency scope

  • Team members

    Authenticated platform identities with organization membership and role scope

    Linked to Organizations, Users
  • Users

    Users

    Linked to Users
  • Quote lines

    Priced quote lines with quantity, unit price, discount, cost and net line USD

    Linked to Quotes
  • Record attachments

    Uploaded evidence files with visibility and evidence type

    Linked to Quotes, Team members

Line Pricing

5 tablesAbout this feature
  • Quote lines

    Priced quote lines with quantity, unit price, discount, cost and net line USD

    Linked to Quotes
  • Quotes

    Customer quotes with lifecycle, validity, revision and USD net amount

    Linked to Organizations, Team members, Customers
  • Organizations

    Retail and e-commerce selling organizations with time zone and currency scope

  • Exchange rates

    Read-only effective exchange rates for this app.

  • Operation receipts

    Stable operation receipts recording action, expected revision and result state

    Linked to Quotes

Channel Bundles

6 tablesAbout this feature
  • Bundle offers

    Channel bundle offers supporting price a channel bundle

    Linked to Quotes, Organizations
  • Quotes

    Customer quotes with lifecycle, validity, revision and USD net amount

    Linked to Organizations, Team members, Customers
  • Quote lines

    Priced quote lines with quantity, unit price, discount, cost and net line USD

    Linked to Quotes
  • Organizations

    Retail and e-commerce selling organizations with time zone and currency scope

  • Review decisions

    Independent review decisions with source revision and operation key

    Linked to Quotes, Team members
  • Operation receipts

    Stable operation receipts recording action, expected revision and result state

    Linked to Quotes

Pricing Review

6 tablesAbout this feature
  • Quotes

    Customer quotes with lifecycle, validity, revision and USD net amount

    Linked to Organizations, Team members, Customers
  • Quote lines

    Priced quote lines with quantity, unit price, discount, cost and net line USD

    Linked to Quotes
  • Review decisions

    Independent review decisions with source revision and operation key

    Linked to Quotes, Team members
  • Team members

    Authenticated platform identities with organization membership and role scope

    Linked to Organizations, Users
  • Record attachments

    Uploaded evidence files with visibility and evidence type

    Linked to Quotes, Team members
  • Operation receipts

    Stable operation receipts recording action, expected revision and result state

    Linked to Quotes

Order Handoff

4 tablesAbout this feature
  • Quotes

    Customer quotes with lifecycle, validity, revision and USD net amount

    Linked to Organizations, Team members, Customers
  • Quote lines

    Priced quote lines with quantity, unit price, discount, cost and net line USD

    Linked to Quotes
  • Operation receipts

    Stable operation receipts recording action, expected revision and result state

    Linked to Quotes
  • Review decisions

    Independent review decisions with source revision and operation key

    Linked to Quotes, Team members

Evidence and Reconciliation

6 tablesAbout this feature
  • Operation receipts

    Stable operation receipts recording action, expected revision and result state

    Linked to Quotes
  • Record attachments

    Uploaded evidence files with visibility and evidence type

    Linked to Quotes, Team members
  • Review decisions

    Independent review decisions with source revision and operation key

    Linked to Quotes, Team members
  • Quotes

    Customer quotes with lifecycle, validity, revision and USD net amount

    Linked to Organizations, Team members, Customers
  • Quote lines

    Priced quote lines with quantity, unit price, discount, cost and net line USD

    Linked to Quotes
  • Team members

    Authenticated platform identities with organization membership and role scope

    Linked to Organizations, Users

Keys and references

Preserve Id values on the records that expose them, and the uppercase ID on exchange rates. Use Quotes.record number as the human quote reference. Customer and organization Code values identify business parties, while reference fields carry the actual record relationship.

Users.User is a self-reference in the account model. Resolve real platform identities before linking team members.User. My Quotes must resolve the authenticated user to the authorized team members record used by Quotes.Owner; a display-name comparison is insufficient.

Review decisions.source revision and operation receipts.expected revision must match the revision they describe. A handoff uses the stable operation key pattern handoff:<quoteId>:<revision>. Preserve old evidence when a new revision or compensating action is introduced.

Migration order

  1. Establish Organizations and authorized Users, then link team members to those identities and organizations.
  2. Load Customers with their Organization, Active flag, Code and eligibility note. Confirm ownership and scope before creating offers.
  3. Load Quotes with Counterparty and Owner references, then quote lines and bundle offers under the correct Parent.
  4. Attach record attachments with uploader and visibility. Preserve review decisions and operation receipts as historical evidence rather than regenerating decisions from current status.
  5. Load or connect the approved exchange rates source as read-only context and rehearse the USD pricing and downstream currency mapping.

Set up Retail & E-Commerce CPQ your way.

Start free, then use Proto to change fields, steps and approvals before your team goes live.

How to get started