User Guide
Contents
Jump to a tool — or click 🔗 Copy link next to any tool heading to copy a shareable link straight to that section (handy for sending a customer to exactly the right tool).
Tools
- ⚡ Webhook Buttons
- 🔍 Customer Reference Search
- 🔍 PO Price Lookup
- 🧾 AI Order Import
- 📨 Email Templates
- 💸 PO Discount
- 🏭 Manufacturing Quantities
- 📦 Bin Transfer Import
- 📦 Bin Location Import
- 📥 PO Import
- 📜 Customer History
- 🚚 Supplier History
- 🏷️ Company Display Name Sync
Getting Started
1. Install the Extension
Install the Katana Extension Library from the Chrome Web Store. (Link coming soon; currently in review.)
Once installed, the extension icon will appear in your Chrome toolbar.
2. Grant Access to Katana
The first time you open a Katana page, the extension will ask you to authorise it with your Katana account. Click Connect and follow the OAuth prompt. This is a one-time step; the extension uses your existing Katana login and never stores your password.
3. Open the Side Panel
Navigate to any page in factory.katanamrp.com. The extension side panel opens automatically on supported pages. You can also click the extension icon in the toolbar to open it manually.
Each tool appears in the side panel only on the pages where it’s relevant, so the panel stays clean and focused.
Tools
⚡ Webhook Buttons 🔗 Copy link
Webhook Buttons now lives in the Advanced section of the Tool Library and is disabled by default — enable it from the library when you need it.
Available on: Sales Order, Manufacturing Order, Purchase Order, Product, Material, Customer, and Supplier detail pages.
Webhook Buttons lets you create custom action buttons that fire HTTP webhooks from any Katana detail page. Use them to trigger automations in Zapier, Make, or any webhook-compatible service.
Setting up a button:
- Open a supported detail page (e.g. a Sales Order).
- In the side panel, click Webhook Buttons.
- Click + Add Button.
- Enter:
- Button Label: the text displayed on the button (e.g. “Send to Warehouse”)
- Webhook URL: the endpoint to POST to
- Headers (optional): any custom HTTP headers (e.g.
Authorization: Bearer ...)
- Click Save. The button appears immediately in the panel.
Firing a webhook:
Click any configured button. The extension sends a POST request to your webhook URL with a JSON payload containing the current page’s resource ID:
{ "id": "abc123" }
Your receiving service can use this ID to look up or act on the Katana record.
Tips:
- Buttons are shared across your whole team (stored per Katana organisation).
- You can add multiple buttons per page type.
- To edit or delete a button, click the ⚙️ icon next to it.
🔍 Customer Reference Search 🔗 Copy link
Available on: Sales Orders list page (/sales).
Search all your sales orders by the customer reference number field (the reference your customer puts on their own purchase order). Katana’s native search doesn’t filter by this field, so this tool fills that gap.
How to use:
- Go to the Sales Orders list in Katana.
- Open the side panel; Customer Reference Search loads automatically.
- Type a customer reference number (or part of one) into the search box.
- Matching sales orders appear instantly as you type.
- Click any result to open that sales order.
Tips:
- Search is case-insensitive and matches partial strings.
- Results show the Katana order number, customer name, and customer reference side by side.
🔍 PO Price Lookup 🔗 Copy link
Available on: Purchase Order detail pages (/purchaseorder/*).
Before reordering, quickly check what you paid last time and how much stock you have on hand — without leaving the PO.
How to use:
- Open any Purchase Order in Katana.
- The PO Price Lookup panel loads automatically and lists all SKUs on the PO.
- Click Look Up Prices. For each SKU you’ll see:
- Last used price and average price (across recent POs)
- Price history table (3, 5, or 10 most recent POs)
- Current stock level and location
- Optionally filter by supplier or show only fully received POs using the controls under each SKU card.
- To update a PO row’s price to the last used price, select the row you want and click Update PO row.
Tips:
- Change the History selector (3 / 5 / 10) to see more or fewer historical POs — no extra network request needed.
- The Done only toggle filters history to fully received POs for a cleaner price signal.
- Prices and stock refresh each time you open a PO; click Look Up Prices again to re-fetch after making changes.
🧾 AI Order Import 🔗 Copy link
Available on: Sales Orders list page (/sales).
Upload a PDF or CSV (a customer quote, email attachment, or purchase order) and AI reads the line items and creates a draft Sales Order in Katana ready for your review.
How to use:
- Go to the Sales Orders list in Katana.
- Open the side panel and click AI Order Import.
- Click Upload File and select a PDF or CSV.
- The AI extracts the line items (SKU, quantity, price). Review the results in the panel.
- Correct any misread fields if needed.
- Click Create Sales Order. Katana creates the order and opens it for final review.
Supported file types: PDF, CSV
Tips:
- Works best with structured documents (quotes and POs with clear line item tables).
- The AI matches SKUs against your Katana product catalogue. Unrecognised SKUs are flagged for manual review before the order is created.
- Nothing is saved to Katana until you click Create Sales Order.
📨 Email Templates 🔗 Copy link
Available on: All Katana pages.
Save reusable email templates and inject them into Katana’s email composer with a single click; no more copy-pasting the same subject lines and bodies.
Injecting a template:
- Open the email composer on any Katana page (e.g. from a Sales Order, click Send Email).
- A Templates button appears inside the composer toolbar.
- Click Templates to see your saved templates.
- Click a template; the subject and body are injected instantly.
- Edit as needed before sending.
Managing templates:
- Open the side panel on any Katana page.
- Click Email Templates.
- Use + New Template to create one. Give it a name, subject, and body.
- Use the edit (✏️) or delete (🗑️) icons to manage existing templates.
Tips:
- Templates are saved per Katana organisation and shared with your whole team.
- You can create as many templates as you need; give them clear names so teammates know which to use.
💸 PO Discount 🔗 Copy link
Available on: Purchase Order detail pages — including Outsourced POs.
Apply a discount across all pending rows of a purchase order.
- Open a purchase order, open the side panel, and expand PO Discount.
- Choose Percent (%) or Flat ($) and enter the amount. The preview shows every row’s current → new unit price before anything is written. Rows that have already been received are locked and will be skipped.
- (Optional) Click + Add a reason to include a note like “Vendor delay credit” in the PO record.
- Click Apply. Unit prices update, a note is added to the PO’s Additional info (e.g. “A $500.00 flat discount was applied to this PO on 06/05/2026 02:10 PM.”), and the page refreshes automatically.
Good to know: flat discounts spread proportionally to each row’s value and land exact to the penny wherever Katana’s 4-decimal unit prices allow — if a small remainder can’t be applied, the tool says so and records the actual amount. There’s no undo; the preview and the PO note are your paper trail.
🏭 Manufacturing Quantities 🔗 Copy link
Available on: Inventory (/inventory), the Manufacturing Orders list (/manufacturingorders), and Product cards (/product/…).
Answers “how many units of each product can I build right now?” It reads each producible product’s recipe (BOM), sums your on-hand ingredient stock, and shows the manufacturable quantity — flagging the bottleneck ingredient that’s limiting it.
How to use:
- Open Inventory or the Manufacturing Orders list and open the side panel.
- The overview lists every manufacturable variant with its in-stock count and a Can make count (grey = buildable, red 0 = nothing can be made right now).
- Click a variant to drill into its recipe — each ingredient shows on-hand, committed, and expected stock, with the bottleneck flagged. The link icon opens that ingredient’s item card in Katana.
- Use the Committed toggle to switch between counting all on-hand stock and subtracting stock already committed to open orders.
- Click Make on any buildable variant to create a manufacturing order at the planned quantity, confirm the order number, and (after it’s created) open the new MO in a new tab.
Good to know: sub-assemblies are counted by their own on-hand stock, not by whether they could themselves be built. Purchase-only products show a friendly “nothing to plan” message.
📦 Bin Transfer Import 🔗 Copy link
Available on: Inventory (/inventory).
Move stock between bins in bulk using a spreadsheet, instead of editing bins one at a time in Katana.
How to use:
- Open Inventory, open the side panel, and expand Bin Transfer Import. It defaults to the location you have selected on the stock screen (or your primary location).
- Confirm the location and download the template — it lists every position with stock at that location, with the current bin pre-filled.
- Edit the target bin for any row offline. To split one SKU across several bins, duplicate its row and adjust the quantities.
- Upload the edited file. The tool imports each row whose target bin differs from its current bin as a bin transfer; bins that don’t exist yet are created automatically. When it finishes, click through to the created bin transfer in Katana.
Good to know: the tool is batch- and serial-number aware, so traceable stock keeps its batch/serial identity through the transfer. Katana assigns the transfer number automatically. Only changed rows are imported — unchanged rows are skipped.
📦 Bin Location Import 🔗 Copy link
Available on: Settings → Locations (/settings/locations).
Create bin locations in bulk to pre-load an account’s bins, without needing a stock transfer.
How to use:
- Go to Settings → Locations, open the side panel, and expand Bin Location Import.
- Choose the location and download the template — a single column, one bin name per row.
- Fill in the bin names you want to create and upload the file.
- Review the preview (new bins to create, plus any that already exist and are skipped), then create.
Good to know: bins that already exist at the location are skipped automatically, so it’s safe to re-run.
📥 PO Import 🔗 Copy link
Available on: the Purchase Orders list (/purchases) and the Outsourced POs list (/purchases-outsource-list).
Bulk-create purchase orders and outsourced POs from a CSV, instead of entering them one at a time.
- Open the list, open the side panel, expand PO Import, and download the template.
- Fill one row per line item: Supplier, Location, SKU, Quantity, Price Per Unit, optional Order Created / Expected Arrival dates, an
Outsource(true/false) column, and an optionalPO Number/Groupto control how rows combine into POs. - Drag the CSV onto the drop zone (or click to browse). The tool validates everything first — resolving supplier/location names and SKUs to Katana IDs — and writes nothing until the file is clean.
- A clean file imports immediately and reports how many POs were created. If any rows have problems, nothing is created and you get a downloadable error report with a reason per row.
Good to know: rows sharing a PO Number (or Group, or the same supplier when both are blank) become one PO; a blank PO Number lets Katana auto-number it. Outsourced POs auto-derive their recipe rows from the product’s BOM. Blank Location falls back to your primary location. Duplicate PO numbers are allowed (same as the Katana UI). Tax rates are out of scope — POs use your account default.
📜 Customer History 🔗 Copy link
Available on: Customer detail pages (/customer/…).
See a customer’s complete sales-order history without leaving the customer page.
- Open a customer, open the side panel, and expand Customer History.
- Click Load history — the panel appears on the customer page (below the address block) with summary stats (order count, lifetime value, last order date) and the full order list.
- Filter by status, date range, or a quick text search; click an order to open it in Katana; or Export the filtered list to CSV.
- (Optional) Expand Settings on the card and turn on Load automatically to have history load as soon as you open any customer.
Good to know: it’s read-only, loads all orders progressively (large customers fill in as they go), and the table scrolls within the card on narrow screens.
🚚 Supplier History 🔗 Copy link
Available on: Supplier detail pages (/supplier/…).
The supplier-side counterpart to Customer History — a supplier’s full purchase-order history on the supplier page.
- Open a supplier, open the side panel, and expand Supplier History.
- Click Load history — the panel appears with totals, lead-time stats (average days from order to receipt), and the full PO list.
- Filter, open individual POs (regular or outsourced), or Export to CSV.
- (Optional) Expand Settings and enable Load automatically.
Good to know: read-only; both regular and outsourced POs are included and link to the right Katana page.
🏷️ Company Display Name Sync 🔗 Copy link
Available on: the Sales Orders list (/sales).
When the Shopify integration creates a B2B sales order, it can overwrite the customer’s Display name with a person’s name. This tool restores the Company name as the Display name.
- Open the Sales Orders list, open the side panel, and expand Company Display Name Sync.
- Set the Start date — the sweep looks at sales orders created on or after this date.
- Click Sweep now. For each customer that has a Company name set, it restores that as the Display name; customers with no Company name are flagged for review (not modified).
- The card shows the last-sweep summary (checked / corrected / flagged) and a recent-activity log of every change.
Good to know: only customers with a Company name are changed — blank-company customers are flagged, never overwritten. There’s no undo, but the activity log records each before → after change.
Need Help?
Email taylor.hagel@katanamrp.com.