Ensure Order Accuracy

Learning Objectives

After completing this unit, you’ll be able to:

  • Explain how COA orders affect your invoice from Salesforce.
  • Describe how COA data can get out of sync with a customer’s license count.
  • Explain how to keep accurate license data.

Calculate Your Invoice

Your customers order products and you share a portion of your product revenue with Salesforce. Pricing terms from your product catalog determine how much you share. Let’s walk through how to use the COA to calculate your invoice.

The revenue-sharing details for every product you sell are in your COA product catalog (or catalogs). To calculate the shared amount, let’s look at the relevant catalog fields: pricing type, flat rate, percentage net revenue (PNR), floor price, and pricing unit.

Pricing type is either a fixed price flat rate or PNR. For fixed-price products, your per-unit revenue-sharing amount is the flat rate amount. If a product’s flat rate is $15, you pay Salesforce $15. For PNR-priced products, your revenue-sharing amount is the selling price multiplied by PNR. Let’s look at an example where the selling price is $100 and the PNR is 15%. Your customer pays you $100 and you pay Salesforce $15 ($100 multiplied by 15%).

You decide the amount to charge your customers. What if you decide to give away a product for free? Does that mean you owe Salesforce nothing? Not necessarily. If it’s a PNR-priced product, check your product catalog to see if it has a floor price. That’s the lowest amount you owe Salesforce regardless of what you charge your customer. If it does, you owe Salesforce the greater of the two amounts—either the floor price or the selling price multiplied by PNR.

When calculating your invoice, also factor in the product pricing unit, per user or per org. If the product is priced per user, multiply the fixed price or PNR by the user quantity. If it’s per org, multiply by the org quantity.

Earlier in this module, we looked at the contract term default billing frequency. It’s the frequency with which Salesforce invoices you. Submit all orders for a billing period before the start of the next period, to ensure that you receive accurate invoices.

React to Customer Needs

For a newly released app, the bulk of your COA orders onboard new customers. As your customer relationships mature, their app needs evolve, and you submit a wider variety of order types. Earlier in this module we stepped through how to create initial orders for new customers. Now let’s explore how to pick the correct order type to fulfill existing customers’ requests.

Order Scenario Order Type Details
Order an additional product for an existing customer
Add-On Customer Request: Your customer has an active installation of your original product and just ordered a second product.
Before You Submit: Verify that the product in their org is different than the one in the order.
Increase license quantity mid contract
Customer Request: Your mid contract customer has an active installation for 250 licenses and wants to add 50 more at the same price.
Before You Submit: Verify that the customer’s active contract is for the product in the order and the new license price is the same as their original licenses.
Switch a customer to a higher-priced product mid contract
Customer Request: Your mid contract customer wants to switch to the product’s new version.
Before You Submit: Verify that the product in their org is upgradeable to the product in the order.
Decrease license quantity on the contract renewal date
Customer Request: Your mid contract customer has an active installation for 250 licenses and wants to remove 50.
Before You Submit: Verify that the customer’s active contract is for more than 50 licenses and the product in their org matches the one in the order.
Change a product price on the renewal date
Customer Request: You change a product’s price and must apply the new price on your customer’s contract renewal date.
Before You Submit: Verify that the product in their org matches the one in the order.
Restart a contract not set to auto renew
Customer Request: Your customer wants to continue using your product after the end of their current contract, which is not set to auto renew.
Before You Submit: Verify that the product in their org matches the one in the order.
Terminate a customer contract on the renewal date
Customer Request: Your customer has an active installation for 250 licenses and wants to remove 250.
Before You Submit: Verify that the product in their org matches the one in the order.

Selecting the right type is like picking the right tool for the job. To hammer in a nail, use a hammer, not a screwdriver. Likewise, if your customer wants to add a different product, use add-on, not renewal.

Also consider the order’s environment—your customer’s contract terms and their org’s configuration. For example, verify that your customer has an active contract in their org before creating their COA order. With contract and org in mind, you’re sure to pick the correct order type and get the job done accurately and efficiently.

Gold star with person's head in the center

Ensure Agreement Between the LMA and the COA

You use the LMA to manage your customers’ licenses and the COA to share their license info with Salesforce. Salesforce uses the COA license info to create your invoices. The data in the COA must always reflect the current number of app and Salesforce platform licenses your customers use. If the LMA and COA get out of sync, your invoices also get out of sync with actual license use. Let’s look at how to keep them in sync.

In the COA, you can see customer details, including their product purchases. In the LMA’s support console, you can manage licenses in your customers’ orgs. When the LMA and COA match, you’re all set. Take a break to reward yourself for a job well done.

Don’t kick back for too long, though. Your app is a hit, and you must fill the valuable role of synchronizing COA license data with your customers’ LMA licenses.

To review COA license data, click the Customers tab in the COA’s primary navigation bar to display a list of customers. Select a specific customer Name (1) from that list to load the customer detail page.

Customer list page with a callout for customer name

The detail page contains three sections: a customer overview section, Billing Information, and Products. Scroll down to the Products section. Here you see the products your customer is licensed to use (1), the Quantity of each (2), and the Total Price (3). This COA data is the invoicing source of truth according to Salesforce. We use the total price to calculate your invoice, so it’s essential to update the COA as things change with your customers.

Products section of the customer detail page with product name, quantity and total price callouts

The product names on the customer details page, for example Lightning Platform Unlimited Edition (Additional Admin) - OEM, are the official names from our pricebooks. They are also the names we use on your revenue-sharing invoices.

Every product catalog is mapped to a specific pricebook entry. You can see the Product (1) to Pricebook (2) mapping in the order wizard when you add products to orders.

Order wizard page showing product to pricebook mapping

Compare COA data to your LMA records and your own records. Look for a mismatch—different COA and LMA license quantities—and fix them right away. The LMA is always correct. It’s the source of truth for your customers’ licenses.

If the LMA lists fewer licenses than the COA, submit a COA reduction order to remove the extra licenses. To avoid overcharging your customers and being overcharged yourself, promptly submit the order. Keep in mind that reductions are effective on your customer’s contract renewal date. You’re invoiced for the greater COA license quantity until the contract renews.

What if the LMA lists more licenses than the COA? You’re out of compliance with your Salesforce revenue-sharing agreement. To fix this mismatch, promptly submit an add-on order. Add-ons take effect when Salesforce processes the order. If you submit an add-on order mid contract, you’re only invoiced for the remaining contract duration. The invoice amount is prorated based on the service start date.

Correct COA data results in significant wins—accurate invoices and your good standing as a partner. Plus, you get to spend less time on billing inquiries and invoice reconciliation. And you have more time to do what you do best—create awesome products and sell them to happy customers.

Congratulations! You are now an order management superstar. Make the most of what you’ve learned. Use this module and the resources it references as you grow and manage your thriving business.


Keep learning for
Sign up for an account to continue.
What’s in it for you?
  • Get personalized recommendations for your career goals
  • Practice your skills with hands-on challenges and quizzes
  • Track and share your progress with employers
  • Connect to mentorship and career opportunities