> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luxima.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Katana

> Bring products, variants and SKUs in from Katana MRP.

Katana MRP is a manufacturing system. If you plan production in Katana, your products, their variants and their bills of materials are already there.

## Why connect Katana

* **Products and variants in one step.** Each Katana product comes in with its sizes, colours, SKUs and barcodes.
* **Composition from your bills of materials.** LUXIMA works out what a product is made of from its Katana BOM.
* **Only what you sell.** Parts, work-in-progress items and archived products are left out to start with.

## What you need

* The **Enterprise** plan.
* The Owner or Admin role in LUXIMA.
* A **Katana API key**. In Katana, go to Settings > API and create a key. A read-only key is enough.

## Connect

**1. Open Katana**

Go to **Integrations**. On the **Katana MRP** card, click **Connect**.

**2. Paste your key**

Paste the key into **Katana API key** and click **Connect Katana**.

**3. Check it worked**

LUXIMA checks the key. When it works you see "Katana connected", with the number of products in your Katana account.

Each company connects its own Katana account. Your key is stored encrypted and is never shown again. LUXIMA only reads from Katana.

## Import your Katana products

Click **Import** on the Katana row, then **Import with a workflow**. Katana is added as a source in an [import workflow](https://docs.luxima.io/import-export/import-overview.md).

### What Katana brings in

* Product name and category
* A style code, worked out from the SKUs
* Variants, each with its SKU, barcode (GTIN), size, colour and other attributes
* Composition, worked out from the bill of materials

### What is left out to start with

LUXIMA unticks these, because they are usually not products you sell. You can tick any of them again.

* Products archived in Katana
* Products marked as not sellable
* Parts and work-in-progress items that are used to make other products
* Gift cards and vouchers
* Items with no SKU or bill of materials, such as bundles and placeholders

LUXIMA reads Katana when you run an import. To pick up new products later, run the import again.

## Change or remove the key

Open **Settings** on the Katana row.

* **Replace key:** paste a new key and click **Save new key**.
* **Forget key:** removes the connection. Products you already imported stay in your catalogue.

## Messages you might see

| Message | What to do |
| - | - |
| "Katana rejected the API key. Check it was copied in full and is still active." | Copy the key again from Katana, or create a new one. |
| "Katana rate limit reached. Wait a minute and sync again." | Wait a minute, then continue. |
| "Could not reach the Katana API" | Katana may be unavailable. Try again later. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.