Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rxscale.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
ProductSKU VariantSKU
Medication A30 tablets, 10mgMED-A-30-10
Medication A60 tablets, 10mgMED-A-60-10
Medication A30 tablets, 20mgMED-A-30-20
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.

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.

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 products and SKUs to blacklist.
  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:
# List blacklisted SKUs for a doctor
curl -X GET "https://api.rxscale.com/v1/admin/doctors/{doctor_uid}/blacklisted-skus" \
  -H "Authorization: Bearer {token}"

# Add a SKU to the blacklist
curl -X POST "https://api.rxscale.com/v1/admin/doctors/{doctor_uid}/blacklisted-skus" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"sku_uid": "sku-uid-here"}'

# Remove a SKU from the blacklist
curl -X DELETE "https://api.rxscale.com/v1/admin/doctors/{doctor_uid}/blacklisted-skus/{sku_uid}" \
  -H "Authorization: Bearer {token}"
The list endpoint supports pagination (page, limit) and search (search) query parameters.