How to Connect Your Online Store

Connect the online store you already run — Shopify, WooCommerce, BigCommerce, Squarespace, Wix, Ecwid, Magento, PrestaShop, Shift4Shop or OpenCart — and Kamo brings its products, stock, customers and orders into one of your Retail markets.

Before You Start

• You need the Manage Subscription Settings permission.
• You need a Retail market for the store to sell in (see How to Create a Market).
• You need to be able to sign in to your store's admin, to create a key or token for Kamo. Kamo only needs permission to read your store.

Steps

1. Open Settings, then Lines of Business, then Provider Integrations.
2. Click Connect a Store and choose your store's platform.
3. Give the connection a name you'll recognise, like "Main Street Online", and choose the Retail market it sells for.
4. Follow the help on the right of the screen to create the key or token in your store's admin, and paste it in. Each platform asks only for what Kamo needs.
5. Choose how often Kamo should sync (every 15 minutes to once a day) and click Connect Store.
6. Open the connection again and click Test Connection. If it says the store did not accept the details, check the key and that it may read products, orders and customers.
7. Click Sync Now to bring everything in for the first time. After that, Kamo syncs on its own.

Which Way Data Goes

One way only: from your store into Kamo. Kamo never changes anything in your store. Change products, prices and stock in your store, and the changes come into Kamo on the next sync.

What Comes Into Kamo

• Products. Each product becomes one product in the market. A product with sizes or colours becomes one product per size or colour, because each has its own price and stock. A product already in the market with the same SKU is used instead of making a copy. A product you remove from your store is turned off in Kamo, never deleted. If you change a product in Kamo, your change stays until the store changes that product.
• Stock. The store's count for each product is kept at its own place, named after the connection, so it never overwrites the counts of your own shelves. Every change appears in the stock history as "Synced from" and the connection's name.
• Customers. Each store customer is matched to an account you already have, by email address. Anyone new gets a new account. Accounts are never merged or deleted, and a blank in the store never replaces a name or phone number you have in Kamo.
• Orders. Each store order becomes an order in the market, with the store's own order number and status (paid, cancelled, refunded and so on) and its customer's account. An order with no customer details is a walk-in sale. Store orders don't take stock a second time, because the store already did. The first sync brings in the last 90 days of orders; after that, each sync brings in what is new or changed.

Syncing again never makes duplicates: Kamo remembers which store product, order and customer became which record in Kamo.

How Often

• Automatically, at the interval you chose, while Automatic sync is on. Turn it off to pause; Sync Now still works.
• Any time you click Sync Now. Use the arrow next to it to sync only products, stock, customers or orders.
• For Shopify and WooCommerce, also within minutes of a change in your store, if you copy the connection's webhook address into your store's webhook settings and enter the webhook signing secret.

Reading the Results

Each card on the Provider Integrations screen says what the last sync did, for example "Last synced 3 minutes ago — 12 products updated, 2 orders added". Open a connection to see its Sync History. Each sync shows, for products, stock, customers and orders:

• Added — new in Kamo.
• Updated — changed in the store since the last sync.
• Unchanged — already up to date.
• Problems — items that could not be saved, listed under What Went Wrong in plain words.

A sync marked Done finished everything. Partly Done means some items could not be saved, the store stopped answering part-way, or a very large store reached the limit for one sync; everything that was saved stays saved, and the next sync tries the rest. Failed means the store could not be read at all — usually a key that was removed or no longer has permission.

Disconnecting

Click the bin on a connection's card, then Disconnect. Kamo stops syncing and the sync history is removed. The products, orders, stock and customers it brought in stay in Kamo. Connecting the same store to the same market again carries on where it left off, without duplicates.