Skip to main content

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:
  1. Define the product details (name, description, category).
  2. Create the associated medical questionnaire if one does not already exist.
  3. Add one or more SKUs with pricing and stock information.
  4. 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.
If RxScale has not received that product from Shopify yet, it is imported from your Shopify shop when you connect it, together with all of its variants. If Shopify does not know the ID, or your shop’s Shopify connection is incomplete, the Admin Tool shows an error and nothing is connected.

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.
To make a product available, set it to Active in Shopify. Unlisted products are treated like active ones. The status counts per shop, so a product that is still a draft in one shop can be ordered in another shop where it is active. An order that already contains a product keeps it if the product goes back to Draft, and you can still change its quantity. A telemedicine partner that sends the SKU directly to the Public API is not refused.

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.
From then on, when a pharmacy changes its stock in the Pharmacy Portal or through the API, or an order it fulfills is completed, RxScale sets that pharmacy’s new stock at its location in Shopify. No other location is changed.
  • 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_all list. 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.
Shopify picks up the change with the next stock update for a SKU: the next product feed run, or the pharmacy’s next stock change.

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:
  1. Navigate to Doctors in the Admin Portal.
  2. Select the doctor you want to manage.
  3. Scroll to the Blacklisted SKUs section.
  4. 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.
  5. Use the Remove button on any entry to unblock a SKU.
You can search the blacklist by SKU name, product name, or PZN to quickly find specific entries.

API Access

You can also manage the blacklist programmatically via the Admin API:
The list endpoint supports pagination (page, limit) and search (search) query parameters.