Skip to main content

How to setup and manage Altria Pricebook Integration

This article outlines the process set up and use Altria Pricebook Integration in Cstore Essentials.

Updated over a week ago

To avoid taking several hours to update tobacco pricing each month, C-store Essentials has partnered with Altria and integrated their new price promotion API, providing customers with a tool to update tobacco prices with just a click.

This is a 2-part process which includes the following:

Step-By-Step Process

Intergration Setup

  1. Required API Consent Form

    • To start, you’ll need to sign Altria’s AGDC Price Promotion API consent form, available through DocBox at AGDC.

      • Please contact your Altria representative for additional details

    • You may need to wait 2-3 weeks before beginning the integration

      • Confirm with your Altria Representative for the exact date to start

2. Go to C-Store Essentials Web Account

  • You can access C-Store Essentials by clicking here or going to https://secure.cstorepro.com

  • Click the Forgot Password button if you need help resetting your password

A screenshot of a login form

Description automatically generated

3. Go to the Integrations Page

  • On the top right side of the screen, click on the User icon

A screenshot of a computer

Description automatically generated
  • Next click on the Integration option

A screenshot of a computer

Description automatically generated

4. Connect Altria Pricebook Integration

  • On the Integrations screen, click on the blue Connect button under the Altria Pricebook Integration section

A screenshot of a computer

Description automatically generated

5. Enter Your Altria RCN Number

  • Input your Altria RCN number in the textbox and click Connect

✅ Note: Make sure the store address and RCN number in C-Store Essentials match the Altria records or there may be errors that impact accurate reporting

A screenshot of a computer

Description automatically generated
  • Once connected, the Altria Pricebook Integration toggle will activate and show the activation date

A screenshot of a computer

Description automatically generated

Updating Pricebook Data with Altria Tobacco Pricing

  1. Check for New Pricing Notifications

    • When Altria updates tobacco pricing, a red notification dot will appear on the Notification Bell in your application

    • Open it to see the new Altria Tobacco Pricing notification

    • You can also click on the Pricebook option from the left side of the screen

    • Next click on the Items option

A screenshot of a computer

Description automatically generated
  • On the Manage Pricebook page, click on Review New Prices in the Altria banner to see the proposed updates

2. Update Prices

  • Review the suggested changes

  • If you agree, click Update Prices to apply Altria's max suggested retail pricing to matched items in your Pricebook

Note: The integration only updates prices for items already in your Pricebook. It won’t add new items. Price updates will not take effect until you complete the final Update Prices step.

💡 Tip: You can discard or snooze any pricing updates if they’re not relevant to your store. C-Store Essentials will only make changes when you approve.


Frequently Asked Questions

Do I have to sign a consent form to use the Altria integration?

  • Yes, you must complete Altria’s AGDC Price Promotion API consent form, for approval from Altria to complete this integration

What happens if my C-Store Essentials address doesn’t match my Altria address?

  • Both addresses must match, including the Altria RCN number otherwise you may experience inaccurate reporting

  • Update your information in C-Store Essentials under Manage My Store if needed.

Will new items be added to my Pricebook automatically?

  • No, the integration only updates pricing for existing items.

  • You will need to update new items to your Pricebook.

Can I turn off price updates once they’re available?

  • Yes, you can snooze or discard specific updates.

  • Price changes require your action, so C-Store Essentials won’t make adjustments without your confirmation.

Did this answer your question?