Suppliers & Linking
Learn how to connect suppliers, map quality attributes, and configure custom price rules for Dynamic Pricing in RepairPlugin easily.
What can you do with this?
- Enable or disable suppliers -- choose which suppliers contribute pricing data to your catalog.
- Filter suppliers by shipping country -- quickly find suppliers that ship to your region.
- Link device brands to suppliers -- control which categories and brands each supplier covers.
- Map quality attributes -- match supplier quality labels (e.g., "OEM", "Aftermarket") to your own repair attributes (e.g., "Official", "Compatible").
- Add custom price rules -- adjust supplier prices before your margin is applied, for example to account for customs tax or a negotiated discount.
Where to find it
- In your WordPress admin, go to RepairPlugin in the left sidebar.
- Click Settings.
- Open the Dynamic Pricing section.
- Select the Settings tab.
- The supplier list appears below the global settings on this same tab.
What you'll see for each supplier:
Each supplier is shown as a card with:
- Name and logo -- supplier identity
- Flag / country -- where the supplier ships from
- Description -- a brief summary of what they offer
- Currency badge -- the supplier's currency and conversion status
- Connection statistics -- a summary line showing how many models, parts, and repairs are linked (e.g., "From X models, we've linked Y parts to Z repairs")
- Four action buttons:
- Manage Devices -- opens a modal to link device brands
- Manage Attributes -- opens a modal to map quality attributes
- Price Rules -- opens a modal to add custom price adjustments
- External link -- opens the supplier's website in a new tab
How to set it up
Enable or disable a supplier
Each supplier card has a switch to turn it on or off.
- On: The supplier's product feed is included in Dynamic Pricing calculations during sync. Parts from this supplier are matched against your repairs and contribute to price selection.
- Off: The supplier's data is excluded entirely. No prices from this supplier are considered.
It's a good idea to enable as many suppliers as possible. More enabled suppliers means broader part coverage, which increases the chance that every repair in your catalog has at least one linked part with a live price.
Filter suppliers by country
- At the top of the supplier list, find the dropdown labeled "Filter suppliers who ship parts to:".
- Select a country to show only suppliers that ship to that destination.
- If no suppliers match, a message appears explaining that other suppliers can still be used -- automatic currency conversion handles the price difference.
The country filter only changes which suppliers you see in the list. It doesn't change which suppliers are enabled or disabled. You can still manage suppliers that are filtered out by clearing the country filter first.
A "Missing a supplier?" message at the bottom encourages you to contact RepairPlugin if your preferred supplier isn't listed.
Understand currency conversion
Each supplier card shows a currency status indicator. Three states are possible:
- Checkmark + currency code (e.g., "EUR"): The supplier uses the same currency as your plugin. No conversion needed.
- Arrow with conversion rate (e.g., "1 USD -> 0.92 EUR"): The supplier uses a different currency, but automatic conversion is available. Prices are converted during sync using the current exchange rate.
- X + currency code (e.g., "GBP"): Conversion isn't available for this currency pair. Parts from this supplier are skipped during sync because no valid price can be calculated.
Currency conversion is fully automatic. You don't need to enter exchange rates manually. The system handles conversion during each sync cycle, so prices reflect current rates.
Link device brands to a supplier
- Click the Manage Devices button on a supplier card.
- A modal opens showing a checkbox tree organized by category (e.g., Smartphones, Tablets, Laptops) and brand (e.g., Apple, Samsung, Huawei).
- Check or uncheck individual brands to include or exclude them from this supplier's linking scope.
- Checking a parent category automatically checks all brands within it. Unchecking a category unchecks all its brands.
- Use this to exclude categories or brands you don't service, or to limit a supplier to certain product lines.
- Click Update to save your selection.
If no categories or brands exist in your catalog yet, the modal shows a message explaining that you need to create them first through the device catalog.
Map quality attributes
- Click the Manage Attributes button on a supplier card.
- A modal opens with the heading "Attributes Linking."
- Attributes are organized into three groups: Screen, Battery, and Other.
- For each of your repair attributes, you'll see two columns:
- Your Linking -- a multi-select dropdown where you choose which supplier attributes should map to this repair attribute. You can select one or multiple.
- Our Suggestion -- read-only badges showing RepairPlugin's recommended mapping based on attribute name analysis.
- If any supplier attributes remain unmapped, they're flagged with an alert indicator so you don't miss anything.
- Click Update to save your custom mappings.
- Click Reset Linking to revert all mappings back to the suggested defaults. This button is disabled if you haven't made any custom changes.
For troubleshooting attribute mapping notifications that persist after review, see Dynamic Pricing FAQ.
Add custom price rules
Custom price rules adjust the supplier's base price before your margin is applied. This is useful for customs taxes, negotiated discounts, or shipping surcharges.
- Click the Price Rules button on a supplier card.
- A modal opens with the heading "Custom Price Rules."
- Click Add New to add a rule. Each rule has four fields:
- Description -- a label for the rule (e.g., "Customs Tax", "Special Discount")
- Action -- Add (+) or Subtract (-)
- Value -- the numeric amount
- Type -- Percent (%) or Fixed (currency amount)
- Use the up/down arrow buttons to reorder rules. Rules are applied one after another, so the order matters.
- Click the X button to delete a rule.
- Click Update to save.
How rules are applied:
Rules run in sequence -- each rule modifies the price produced by the previous rule, not the original base price. For example:
- Base supplier price: 200.00
- Rule 1: Subtract 5% --> 200.00 - 10.00 = 190.00
- Rule 2: Add 12% --> 190.00 + 22.80 = 212.80
The final adjusted price (212.80) is then passed to the margin calculation. The full price flow is: supplier base price --> custom price rules --> margin --> min/max cap --> rounding --> final customer price.
Settings reference
| Setting | Description | Default | Customers see |
|---|---|---|---|
| Supplier Switch | Turns a supplier's product feed on or off. Only enabled suppliers contribute data to Dynamic Pricing calculations during sync | off | When a supplier is enabled, its parts data influences the prices on your site. Disabling a supplier removes its data from price calculations, which may cause some repairs to fall back to manual prices or "Price on Request." |
| Country Filter | Filters the supplier list to show only suppliers that ship to the selected country. This is a display filter only -- it doesn't change which suppliers are enabled or disabled | none (all suppliers shown) | Nothing. The country filter has no effect on your website. |
| Currency Conversion | Converts supplier prices from their native currency to your plugin's configured currency during sync. If no conversion rate is available for a currency pair, that supplier's parts are skipped | active for all suppliers with supported currency pairs | Prices always appear in your plugin's configured currency, regardless of which supplier provided the underlying part price. |
| Manage Devices | Controls which device categories and brands are linked to a specific supplier. Unchecked categories or brands are excluded from that supplier's data matching | all categories and brands checked | Repairs for excluded devices won't receive price data from this supplier. If no other supplier covers those devices, prices fall back to manual values or "Price on Request." |
| Manage Attributes | Maps supplier quality attributes (e.g., "OEM", "Aftermarket", "Grade A") to your repair attributes (e.g., "Official", "Refurbished", "Compatible"). This determines which supplier parts match which quality tier in your repairs | RepairPlugin's suggested mappings | This affects which price appears for each quality option. Incorrect mapping can lead to mismatched prices (e.g., a compatible part price showing under the official quality tier). |
| Custom Price Rules | Applies sequential add/subtract adjustments (percentage or fixed) to the supplier's base part price before the global margin calculation. Useful for accounting for customs taxes, negotiated discounts, or shipping surcharges | no rules (base price used as-is) | Rules that increase the price result in higher customer prices. Rules that decrease the price result in lower customer prices. |
Frequently asked questions
Does the country filter affect which suppliers are enabled?
No. The country filter only changes which suppliers you see in the list. It doesn't enable or disable any supplier. You can still manage filtered-out suppliers by clearing the filter first.
What happens if currency conversion isn't available for a supplier?
Parts from that supplier are skipped during sync because no valid price can be calculated. You'll see an "X" next to the currency code on that supplier's card.
Can I display Dynamic Pricing statistics on my website?
Yes. Use the [rp_dp_stats] shortcode to show counts of connected models, repairs, or parts. The shortcode requires two attributes: type (one of models, repairs, or parts) and supplier (a supplier ID or all for all suppliers). For example, [rp_dp_stats type="models" supplier="all"] shows the total number of models connected to Dynamic Pricing across all suppliers.