Products and SKUs
Your product catalog is the foundation of your RxScale integration. This page explains how products and SKUs work and how to manage them.Understanding Products and SKUs
Products
A product represents a medication or treatment that patients can request through your shop. Each product has:- Name — The display name patients will see.
- Description — Information about the product.
- Category — How the product is classified.
- Associated questionnaire — The medical questionnaire patients must complete when requesting this product.
SKUs (Stock Keeping Units)
Each product can have one or more SKUs. A SKU represents a specific variant of a product. For example:
Each SKU has its own price, stock level, and availability settings.
Managing Your Product Catalog
You can manage your products and SKUs through the Management API or by working with your RxScale account manager. Common tasks include:Adding Products
New products are typically set up during your initial onboarding. To add products later:- Define the product details (name, description, category).
- Create the associated medical questionnaire if one does not already exist.
- Add one or more SKUs with pricing and stock information.
- Link the product to your shop.
Adding new products usually requires coordination with your account manager, especially when a new medical questionnaire needs to be created.
Managing SKU Variants
You can add, update, or deactivate SKU variants for existing products. When managing SKUs, keep in mind:- Each SKU must have a unique identifier.
- Price and stock levels are managed per SKU.
- Deactivating a SKU removes it from your shop without deleting historical data.
Linking Products to Shops
Products need to be linked to a shop before patients can see and order them. If you operate multiple shops, each shop can have its own selection of products.- A product can be linked to multiple shops.
- Each shop can display different products based on its target audience or region.
- Product availability is controlled at the SKU level, so a product can be available in one shop but out of stock in another.
Connecting products and SKUs to your Shopify shop
In the Admin Tool, open a product and connect it to the matching product in your shop. Then connect each SKU to the matching variant. Both dialogs list the shop products and variants that are not connected yet. If the product or variant you need is not in the list, connect it by ID:- For a product, enter its Shopify product ID.
- For a SKU, enter the variant’s Shopify variant ID or its SKU code. If several variants share the SKU code, use the variant ID.
Editing a connected shop SKU
On a connected shop SKU you can correct the SKU code, the variant ID (Shop SKU ID), the product ID (Shop Product ID), the price and the image. Each variant ID and each product ID can be used only once per shop. If the ID you enter already belongs to another shop SKU or shop product in that shop, the Admin Tool tells you which ID is taken, saves nothing, and keeps what you typed so you can correct it. If the shop SKU that already has that variant ID is the one you actually want, disconnect the current shop SKU and connect that one instead — a SKU can be connected to one shop SKU per shop.Draft and archived products in Shopify
RxScale keeps each Shopify product’s status (Active, Draft, Archived or Unlisted) per shop. Products in Draft or Archived are still synced to RxScale, but nobody is offered them for an order in that shop:- Doctors don’t see them when they create a direct prescription in the Doctor Portal.
- The Admin Tool doesn’t list them when you change a product on an order.
- The Public API product list leaves them out.
Price and Stock Management
Pricing
Prices are set per SKU. When updating prices:- Price changes apply to new orders immediately.
- Existing orders are not affected by price changes.
- Make sure your prices are consistent with your shop’s display to avoid confusion.
Stock Levels
Stock levels determine whether a product can be ordered. The stock for each SKU is managed by the pharmacy that fulfills orders for that product.- When stock reaches zero, the SKU is marked as out of stock and cannot be ordered.
- Stock is automatically reduced when orders are completed.
- Pharmacies can update their stock levels through the Pharmacy Portal or API.
Stock per pharmacy location in Shopify
If your Shopify shop has a location for each pharmacy, RxScale can keep each pharmacy’s stock at its own location instead of writing one number for the whole shop. In the Admin Tool, under Settings → Shops:1
Map the locations
Open Location Mappings for the shop and map each Shopify location ID to its pharmacy. A pharmacy can have one location per shop.
2
Turn on stock sync per pharmacy
Open Stock sync and turn it on for each pharmacy whose stock should reach the shop.
3
Turn on the shop setting
Open the shop’s settings and turn on Sync pharmacy stock to its Shopify location.
- A pharmacy without a location in the shop, or with stock sync turned off, sends no stock to the shop. The pharmacy that supplies the shop’s product feed is the exception: its stock still reaches its location, because the feed writes it.
- A pharmacy mapped to more than one location in the same shop sends no stock, because the same number at each location would add up to more than the pharmacy has.
- If your shop has a CanDoc product feed, the feed decides which pharmacies may sell a product at all: those in its
pharmacy_uid_alllist. A pharmacy the feed does not list for a product shows 0 for it at its location, even if the pharmacy has stock. When the feed stops listing a pharmacy, the next feed run sets its location to 0; when the feed starts listing it, the next run sets the pharmacy’s current stock. - Every feed run also brings each pharmacy’s location back in line, so a stock value lost on its way to Shopify is sent again.
- If the pharmacy’s location exists and is active, RxScale activates the product there when it is not stocked yet and sets the stock, including 0. If the location does not exist, or the location itself is deactivated, RxScale does not change the stock.
- A digital SKU (
digital: true) has no pharmacy stock. Its stock comes only from the product feed, and RxScale sets it at your shop’s default location in Shopify (Settings → Locations), never at a pharmacy’s location. A pharmacy’s stock changes do not touch it. In Shopify, the digital variant must be stocked at the default location; if it is not, Shopify refuses the update.
Before switching an existing shop over, check the stock at your Shopify locations. If RxScale has written stock to the shop before, it wrote the shop’s total to one location, and that number stays there until you change it. The same goes for digital SKUs: RxScale does not set their stock at a pharmacy’s location, so a number already there stays until you change it.
Hide digital or physical SKUs of a pharmacy
A shop can stop offering one type of SKU from a linked pharmacy: its digital SKUs, its physical SKUs, or both. In the Admin Tool, under Settings → Shops, open Hidden SKU types for the shop and choose Hide digital SKUs or Hide physical SKUs for each pharmacy. For a hidden type:- The pharmacy’s stock counts as 0 in this shop. On a shop with stock per pharmacy location, the pharmacy’s location shows 0 for those SKUs. On a shop with one stock number, the pharmacy’s stock is left out of the total, and so it is in the Dr. Ansay and docnow24 product feeds.
- Automatic routing no longer sends an order of this shop that contains such a SKU to the pharmacy. Another linked pharmacy that carries the SKU receives it. If there is none, the order is not sent to any pharmacy and shows a fulfillment issue.
- An order that already names the pharmacy still goes to it: one where the patient chose the pharmacy, a partner set it, or Shopify routed the order to the pharmacy’s location.
- The setting applies to this shop only. The same pharmacy can show both types in another shop.
Doctor SKU Blacklist
The Doctor SKU Blacklist allows you to restrict specific SKUs from being prescribed by individual doctors. This is useful for:- Specialization restrictions — Limiting doctors to SKUs within their area of expertise.
- Licensing requirements — Ensuring doctors only prescribe medications they are licensed for.
- Compliance — Enforcing organizational or regulatory restrictions on a per-doctor basis.
How It Works
When a SKU is blacklisted for a doctor, that doctor will no longer be able to prescribe it. The blacklist operates at the SKU level (not the product level), giving you fine-grained control over which specific variants a doctor can prescribe.Blacklisting a SKU does not affect other doctors. Each doctor has their own independent blacklist.
Managing the Blacklist
The SKU blacklist is managed through the Admin Portal under the doctor detail page:- Navigate to Doctors in the Admin Portal.
- Select the doctor you want to manage.
- Scroll to the Blacklisted SKUs section.
- Use the Add button to select one or more SKUs to blacklist in one step. SKUs that are already on this doctor’s blacklist stay visible but cannot be selected again.
- Use the Remove button on any entry to unblock a SKU.
API Access
You can also manage the blacklist programmatically via the Admin API:page, limit) and search (search) query parameters.
Related Topics
- Orders and Prescriptions — How orders flow through the system.
- Management API — Manage products programmatically.
- Management API Products Reference — Full API documentation for product endpoints.