> For the complete documentation index, see [llms.txt](https://support.ordereazi.com/central/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.ordereazi.com/central/apps/supplier-feeds/miro.md).

# MiRO

Bring MiRO's catalogue, cost prices, and stock into OrderEazi Central with the MiRO Feed Integrator app.

If you buy IT hardware and networking products from MiRO, recapturing its catalogue and stock by hand takes time. The MiRO app (**MiRO Feed Integrator** in the App Gallery) brings MiRO's full catalogue, cost prices, and stock into OrderEazi Central, linked to MiRO as a supplier.

### Before you start

You'll need:

* **MiRO account details:** A MiRO dealer account with access to MiRO's product feed, and your **MiRO User**, **MiRO Key**, and **MiRO Dataset** from MiRO.
* **MiRO as a supplier in OrderEazi:** The feed's products are linked to it. If you don't have one, create it first. See [Suppliers](/central/order-management/suppliers.md).
* **Permissions:** You need **View Installed Apps** and **Configure and Open Installed Apps**, in the **App Gallery** permission group. See [App Gallery](/central/apps/app-gallery.md).

### How to set up MiRO

1. In the main menu, select **Apps**.
2. If **Installed Apps** opens, select **View Gallery**.
3. Find **MiRO Feed Integrator**, and select **Install**.
4. On **Installed Apps**, select **Open** on **MiRO Feed Integrator**.
5. Under **MiRO Feed Configuration**, enter your **MiRO User**.
6. Enter your **MiRO Key**.
7. Enter your **MiRO Dataset**, the dataset number MiRO gave you.
8. Choose the **MiRO Linked Supplier**.
9. Select **Save**.

The app only starts syncing once all four fields are filled in. If you see **Invalid configuration detected**, email <support@ordereazi.com>.

Your **MiRO Key** is linked to your MiRO account. Keep it private, and ask MiRO for a new one if you think it has been shared.

### What MiRO brings in

The feed brings in MiRO's full catalogue each time it runs:

| MiRO                     | OrderEazi                                    |
| ------------------------ | -------------------------------------------- |
| SKU                      | Product code                                 |
| Title                    | Product name, or the SKU if there's no title |
| Subtitle or description  | Product description                          |
| Brand                    | Brand                                        |
| Categories               | Categories, by name                          |
| Price                    | Supplier cost                                |
| Stock quantity           | Supplier stock level                         |
| Barcode                  | Barcode, where MiRO has one                  |
| Main and extra images    | Product images                               |
| Width, height, and depth | Dimensions, in centimetres                   |
| Weight                   | Weight, in kilograms                         |
| Manufacturer SKU         | Extra product information                    |
| Datasheet link           | Extra product information                    |

* **Cost:** The price is what MiRO charges your account. Your selling prices are left for you to set.
* **Stock:** It's MiRO's total across all its branches, not per branch.
* **Dimensions:** If MiRO has none for a product, the dimensions you already have are kept.

The feed doesn't include variants, tiered pricing, minimum order quantities, or branding. The **MiRO Feed Features** section of the app shows what's included.

### How often MiRO syncs

Products sync every 6 hours. Stock and cost sync every hour, because MiRO updates its feed hourly. Each sync is then processed by OrderEazi, so changes can take a few minutes to show. Administrators can also select **Sync Feed Now** or **Sync Stock Now**.

**Example:** MiRO drops a router's cost from R1 450 to R1 390 at 10:00. By about 11:00, the router's supplier cost in OrderEazi is R1 390. If its pricelist is linked to MiRO, the selling price follows.

If MiRO's feed can't be reached or returns no products, the sync stops without changing anything.

### When MiRO stops listing a product

The product stays in OrderEazi, and its stock stops updating. With **Auto-remove stale feed suppliers** on, the default, MiRO is removed as the product's supplier once the feed hasn't listed it for 48 hours. See [Document options](/central/order-management/settings/organization-setup/system-settings/document-options.md).

### Related pages

* [Supplier feeds](/central/apps/supplier-feeds.md): how feeds work, and every feed app
* [Product suppliers and cost tiers](/central/order-management/products/product-management/product-suppliers-and-cost-tiers.md): see a product's supplier cost and stock
* [Linking Suppliers to a Price List](/central/order-management/pricelists/linking-suppliers-to-a-price-list.md): set selling prices for feed products