Lockstock

Docs / Move in

Switch in from Katana

Eight CSV exports: products, suppliers, customers, recipes, orders, locations and serial numbers.

In the demo

Built, using CSV files. Lockstock has no live connection to Katana.

Which files to bring

Export each of these from Katana as a CSV. You do not need all of them. A file you leave out is simply not moved, and the dry run shows it as "not in file".

FileBecomesColumns the sample uses
Katana-Products.csvItems (an In stock column becomes opening stock)SKU, Product name, Unit of measure, Type, Default purchase price, Sales price, In stock, Reorder point, Barcode
Katana-Suppliers.csvVendorsSupplier name, Email, Phone, Payment terms
Katana-Customers.csvCustomersCustomer name, Email, Phone
Katana-Recipes.csvBills of materialsProduct SKU, Ingredient SKU, Quantity, Unit of measure
Katana-Purchase-orders.csvOpen purchase ordersPurchase order no, Supplier, Item SKU, Quantity, Price per unit, Expected arrival, Received quantity
Katana-Sales-orders.csvOpen sales ordersSales order no, Customer, Item SKU, Quantity, Price per unit, Delivery deadline, Shipping address
Katana-Locations.csvLocations and binsWarehouse, Bin, Bin name, Bin type
Katana-Serial-numbers.csvSerial numbersSerial number, SKU, Status, Bin

Download all 8 samples as one zip from Switch in (pick Katana, then Sample exports) or one by one from /api/switch-in/samples/katana/<file name>. Add all.zip as the file name for the zip.

Good to know

  • A Katana recipe is a bill of materials in Lockstock: the product SKU is the parent and each ingredient SKU is a component.
  • The sample has no separate stock file, so opening stock comes from the In stock column on the products file. If your export has stock per location, include it and match the columns.
  • Price lists and unit conversions are not part of the Katana layout here.

Steps

  1. Sign in as the owner and open Switch in. Only the owner can switch a shop in.
  2. Pick Katana at the top.
  3. Drop your CSV files in the box. Up to 4 MB together; split a bigger shop into two runs.
  4. Check the column matches. Each pair shows a sample value and how sure the match is. Change any pair you do not agree with, and pick a file type if Lockstock could not tell.
  5. Press Build dry run. Nothing is written yet.
  6. Read the totals, then the changes by record type. Approve and import when it looks right.

The dry run and approval are explained in How a switch-in works.