CStoreOffice® and RJR API

CStoreOffice® can automatically retrieve and apply discounts and promotions on R.J. Reynolds Tobacco Company products via integration with the RJR Discount API. This integration ensures that discounts are applied in a timely manner, eliminates manual entry, and improves overall data accuracy.

To start working with RJR Discount API, follow the steps below.

1. Check the RJR API prerequsites.
2. Enroll for RJR Discount API.
3. Pilot integration.
4. Integrate RJR Discount API with CStoreOffice®

Important considerations

• Promotions and discounts are pulled from the RJR Discount API once a day.
• The RJR Discount API provides information on the following types of promotions:
• Manufacturer buy-downs
• Mix and match

Check the RJR API prerequisites

To integrate your locations (stations) with RJR Discount API, check that the following requirements are met:

• The RJR Discount API is available for integration.
• Scan Data subscription is purchased and activated for all locations that will automatically receive promotional data via the API.

Enroll for RJR Discount API

To enroll for the RJR Discount API service:

1. Register on the RJR Engage API Portal if you have not done so already.
2. Sign in to the Engage API Portal with the credentials created on Step 1.
3. On the main page of the Engage API Portal, subscribe to Discount API.
4. Set Petrosoft as the third-party provider to allow it to access the API on your behalf.

Purchase Scan Data subscription

RJR discounts / promotions integration requires an active Scan Data subscription for every location that will automatically receive promotional data via the API. This subscription can be purchased through the Petrosoft Marketplace or by contacting a Petrosoft sales representative.

If you are successfully using Tobacco Scan Data Supporting RJR report for the location, you already have an active Scan Data subscription for it. In this case, you can skip the following steps.

1. Open the Scan Data Subscription page at Petrosoft Marketplace.
2. Sign in to your account.
3. Select the duration for which the subscription will be active (1 month or 1 year).
4. Purchase the subscription by following the on-screen instructions. The purchased Scan Data Subscription will appear in your subscriptions list.
5. By default, the purchased subscription is not automatically assigned to your business unit. Open the subscription and click the Assign License button.
6. Select the location to which the Scan Data API subscription will be assigned to and click the Done button.

Pilot integration

After enrolling in the RJR Discount API and purchasing a Scan Data subscription, you are ready to try out the integration at a pilot location.

At the moment, self-service integration with the RJR Discount API is not supported in CStoreOffice®. Please contact Petrosoft Support for assistance with setup and configuration changes.

Provide information to Petrosoft

Depending on your store type, send the following details to Petrosoft Support.

Single-store

You must explicitly enroll as a single store in the RJR Discount API to use this option.

• Outlet ID from the RJR Engage API Portal
• Outlet Name from the RJR Engage API Portal
• The email you have used to sign up for RJR API.

Multi-store (chain)

1. Get the RJR Discount API access credentials from the RJR Engage API Portal:
2. Retailer account number;
3. Client ID;
4. Secret.
2. Pick a CStoreOffice® location to pilot the RJR Discount API integration.

The pilot location must have an active Scan Data subscription!

3. Sent the request to Petrosoft Support with the following information:
4. Pilot location name;
5. Pilot location address;
6. RJR account number (see Step 1);
7. RJR API Client ID (see Step 1);
8. RJR API Secret (see Step 1);

Test the integration

1. Petrosoft will configure the integration using the provided parameters and notify you once it is ready.
2. Petrosoft Cloud retrieves promotions from the RJR Discount API for the pilot location. The data is refreshed once a day.
3. Review and confirm the promotions from RJR appeared in CStoreOffice®:
4. From the CStoreOffice® home page:
1. Go to Items Updates.
2. Click the name of the pilot location.

   

3. In the Cash Register Updates Manager form:
1. Go to Changes > Updates.
2. In the Updates section, click Promotions.
3. Review promotions data and click Accept Changes to push updates to the location's cash register.

   

   For more information about accepting changes, see Reviewing and Accepting Changes.

Integrate RJR Discount API with CStoreOffice®

When promotions are reviewed and confirmed at the pilot location, inform Petrosoft Support that you are ready to roll out the integration for the remaining locations.