---
title: "Business Manager Setup"
description: "Install SureBright in SFCC Business Manager: upload the cartridge, import the metadata, jobs and SureBright product catalogue, then check the installation."
---

On this page you install SureBright in Business Manager: you upload the cartridge, import four files from the SureBright integration package, and check that everything arrived.

- **What you get:** the SureBright cartridge on your site, the SureBright jobs ready to schedule, and the warranty products in your catalogue.
- **What you do:** the uploads and imports below, in your sandbox first. On the Full Business Manager Access path, SureBright does this configuration for you.

<Info>
  **Before you start**: you need administrative access to your SFCC Business Manager instance. Your storefront must follow SFRA guidelines: the integration is built on top of `app_storefront_base` and related modules.
</Info>

---

## Upload the cartridge and set the cartridge path

1. Upload the **surebright_sfra** cartridge to your SFRA sandbox environment.
2. Go to Business Manager **→** Administration **→** Site **→** Manage Sites. Select your desired site and go to Settings.
3. At the beginning of the Cartridge Path, add `surebright_sfra:` to include the cartridge in your current site's configuration.

![SFRA Cartridge Configuration](/images/sfra_cartridge.png)

<Warning>
  **Important**: Always test in your sandbox environment first before deploying to production. Ensure the cartridge is compatible with your SFCC version.
</Warning>

---

## Import the metadata files

1. Go to Business Manager **→** Administration **→** Site Development **→** Import & Export
2. Upload the following files from the SureBright integration package:
   - **system-objecttype-extensions.xml**
   - **custom-objecttype-definitions.xml**
3. Go to Business Manager **→** Administration **→** Site Development **→** Import & Export **→** Metadata **→** Import
4. You should see both files as available for import. Proceed to importing both files.
![SFRA Cartridge Configuration](/images/sfra_systemobject.png)

<Note>
  These files add the custom objects and system extensions the SureBright integration needs. Without them it does not function properly.
</Note>

---

## Import the SureBright jobs

1. Go to Business Manager **→** Administration **→** Operations **→** Import & Export
2. Upload the following file: **jobs.xml**
3. Go to Business Manager **→** Administration **→** Operations **→** Import & Export **→** Jobs **→** Import
4. You should see the jobs file as available for import. Proceed to importing it.

<Info>
  The jobs file adds the jobs that send your products and orders to SureBright. You set their site and schedule in the [Jobs Guide](./jobs).
</Info>

---

## Import the SureBright product catalogue

1. Select your site integrating with SureBright
2. Go to Business Manager **→** Merchant Tools **→** Products and Catalogs **→** Inventory List Import
3. Upload the following file: **catalog.xml**
4. This imports the warranty products as variants, one for each unique warranty tenure and price.

<Info>
  We recommend keeping the SureBright products as a separate master catalog for better visibility and management.
</Info>

---

## Check the installation

After all the imports, confirm these three things in Business Manager:

| Check | Where | What you should see |
|---|---|---|
| Cartridge | `Administration → Sites → [Your Site] → Cartridges` | `surebright_sfra` is listed and active, with no compatibility warnings or conflicts. |
| Jobs | `Administration → Jobs → Job Definitions` | `SureBrightProductsExport` and `SureBrightOrdersCreation` are imported. |
| Warranty products | `Merchant Tools → Products → Product Catalog` | The warranty products are imported with correct SKUs and are assigned to your site's catalogue. |

---

## Troubleshooting

| If | Check |
|---|---|
| The cartridge upload fails | You have administrative permissions, the cartridge is compatible with your SFCC version, and your sandbox has sufficient disk space. |
| The metadata import shows errors | The XML file format and structure, any existing custom objects that conflict, and the import logs for the specific error message. |
| The product catalogue import has issues | Inventory list and pricebook assignments, product SKU naming conventions, and that your site configuration is complete. |

If you are still stuck, check the [FAQs](./faqs), contact your SureBright representative for immediate assistance, or email [support@surebright.com](mailto:support@surebright.com) for technical support.

**Next**: go to the [Jobs Guide](./jobs) to schedule the data synchronisation jobs, then run the checks in the [Testing Guide](./testing).
