E-commerce

Connect your store and Machool pulls the orders in, so you can ship them and push tracking back without retyping anything.

The E-commerce page in Machool, showing the supported store platforms
Manage > E-commerce, where every supported platform is connected.

How does it work?

Machool integrates directly with your e-commerce store to automatically sync your orders into the Machool platform. Once a shipment has been made in Machool, your order is fulfilled and updated with tracking details.

Once you connect your store you will be able to:

  • Pull orders live from your e-commerce store
  • Make shipments and print labels in seconds
  • Manage shipments, viewing payments and shipping status
  • Review shipments and their status in your e-commerce store

Connecting your platform

Ten platforms are supported. Open the one you use.

Shopify

How to connect your store

  1. Log in to your account and go to Manage then E-commerce.
  2. Click the store logo.
  3. Enter your shop name and click Connect.
WooCommerce

How to connect your store

  1. Log in to your account and go to Manage then E-commerce.
  2. Click the store logo.
  3. Enter your shop name and click Connect.

Why use Machool live checkout shipping rates?

  • Show real time, accurate rate quotes to your customers
  • Protect your margins by quoting accurately
  • Customize your rates by dollar amount or percentage
  • Boost conversion rates
  • Easy to use, quick setup with no modifications required

How to activate the plugin

  1. Install the plugin from the WordPress registry and activate it: Machool plugin for WooCommerce.
  2. Make sure your store is connected to Machool, then click the folder + icon.
  3. Generate an API key.
  4. Paste and save the key in WooCommerce > Settings > Shipping > Shipping with Machool.
The folder plus icon on the Machool E-commerce page
The folder + icon, on the connected store.
The Machool dialog for generating a WooCommerce API key
The generated API key shown in the Machool dialog
The Shipping with Machool settings screen in WooCommerce, with the API key field
WooCommerce > Settings > Shipping > Shipping with Machool.

Set up your shipping zones and rates

Go to WooCommerce > Shipping > Shipping zones and customize your rates according to your shipping areas and additional costs.

The Shipping zones list in WooCommerce

Edit your shipping details.

Editing the shipping details for a zone in WooCommerce

What your customer will see at checkout

The options selected in your shipping zone settings will be visible at checkout. You can choose to display both standard and expedited, or only one of those options.

A WooCommerce checkout page showing Machool shipping options

What you will see in Machool

When a customer has paid for one of the Machool shipping rates, this is displayed on the e-commerce page with an icon showing which service was selected, along with the amount paid for shipping.

The orders list in Machool showing the shipping service a customer paid for

What you should know

Define your product details. The plugin needs accurate dimensions and weight to provide a cost estimate.

The product dimensions and weight fields on a WooCommerce product page

Check your store address. Make sure the address in WooCommerce > Settings > General matches the address you ship from in Machool, or the rates will be wrong.

The store address fields in the WooCommerce general settings

Check your enabled providers. The rates at checkout are the ones you would get in Machool, using the weights and dimensions from your WooCommerce product descriptions. They come from the providers enabled on Manage > Couriers.

The Couriers page in Machool, with providers enabled or disabled
Wix

How to connect your Wix store

  1. Make sure you are logged in to your Wix store, then open a new browser tab and go to dev.wix.com.
  2. Click Build an app. You will be asked to log in to your Wix account if you have not already.
  3. On the left, select Custom Apps. In the top right, click Create New App and choose Build from scratch.
  4. Select Self-Hosted, then click Get Started.
  5. You are redirected to the App Dashboard. In the left menu, click OAuth.
  6. Under Advanced OAuth (optional), add an App URL of https://app.machool.com/signin and a Redirect URL of https://app.machool.com/shipping/e-commerce/callbacks. Save your changes.
  7. In the left menu, click Permissions, then + Add Permissions in the upper right.
  8. Select Wix Stores from the Permission Category dropdown, then select Manage Stores – all permissions and save.
  9. Return to the OAuth page. In another tab, log in to Machool, go to the E-Commerce page and click the Wix logo. Copy your App ID and App Secret Key from the OAuth page, paste them into Machool and click Submit.

You should now be able to view and fulfill orders from your Wix store in Machool.

The Wix developers site, with the Build an app link
Step 2: the Wix developers site.
The Custom Apps page in the Wix developer dashboard
Step 3: Custom Apps.
The Wix app framework choice, with Self-Hosted selected
Step 4: choose Self-Hosted.
The OAuth page in the Wix app dashboard, with the App URL and Redirect URL fields
Step 6: the OAuth page.
The Wix permissions screen with Wix Stores selected
Step 8: permissions.
Magento

How to connect your Magento store

First create a Machool integration in your Magento store admin.

  1. Go to your Magento store and log in as store admin.
  2. Go to System and select Integrations under Extensions.
  3. Click Add New Integration.
  4. Under General, enter a name for the integration, for example “Machool app”. The name is only for your reference. Under Current User Identity Verification, enter your store admin password again.
  5. Click Save.
  6. You are redirected to the Integrations page. Find the integration you just created, click Activate, then Allow.
  7. You will see the Integration Tokens for Extension. Copy the Access Token and click Done.

With the access token in hand, log in to Machool, go to the E-Commerce page, click the Magento logo, paste your access token along with your Magento storefront URL, and click Connect.

The System menu in Magento, with Integrations under Extensions
Step 2: System > Integrations.
The Add New Integration button in Magento
Step 3.
The new integration form in Magento
Step 4.
The Integrations list in Magento with the Activate link
Step 6.
The integration tokens dialog in Magento, showing the access token
Step 7: copy the Access Token.
Panierdachat

How to connect your Panierdachat store

There is a walkthrough video for this one. Watch it on Vimeo. It cannot be embedded inside a collapsible section, so it is a link.

First go to your Panierdachat store administration to get the API and secret keys, as described on their support page.

With the keys in hand, add them in Machool under Manage > E-commerce > Panierdachat, paste both keys into the fields and click Connect.

The Panierdachat connection dialog in Machool

Once the store has been added, enable Machool rates in your Panierdachat store by clicking the folder + icon.

The folder plus icon on the connected Panierdachat store in Machool

Adjust your rates if necessary and save the settings.

The Panierdachat rate settings dialog in Machool
Lightspeed

How to connect your Lightspeed store

In the back office of your Lightspeed store, go to Settings > Store Settings > Developers to create an API key and secret. Lightspeed documents the steps in Creating API keys.

The Lightspeed connection dialog in Machool
Lightspeed E-series (Ecwid)

How to connect your Lightspeed E-series store

  1. Log in to your store’s admin page.
  2. Go to my.ecwid.com and click Create in the Add New App section. Only accounts on a paid plan can create custom apps and gain access to the API.
  3. After the app is created, a new page opens. Click Show secret token to reveal your access token. This is what connects your store to Machool.
The Lightspeed E-series store admin login page
Step 1.
The Ecwid applications home page
Step 2.
The Add New App section on the Ecwid developer page
Step 2: Add New App.
The secret token revealed on the Ecwid app page
Step 3: the access token.

Finding your Store ID

Scroll to the bottom of the admin page. It is in the footer, and also in the URL of your store admin page.

The Ecwid store admin footer showing the store ID
BigCommerce

How to connect your BigCommerce store

In your store’s control panel, go to Advanced Settings > API Accounts. The store API credentials are generated when a store API account is created. BigCommerce documents this in Store API Accounts.

Set these permissions:

  • Information & settings Read-only
  • Orders Modify
The BigCommerce connection dialog in Machool
Squarespace

How to connect your Squarespace store

First get the API key and Account ID from your Squarespace store administration.

  1. Go to your Squarespace store and log in as store admin.
  2. Go to System and select Developer API Keys under Advanced.
  3. Click Generate a Key.
  4. Under Key Name, enter a name for this integration, for example “Machool app”. The name is only for your reference.
  5. Tick each permission one by one, making sure Read only is selected.
  6. Click Generate a Key in the top right of the popup.
  7. Copy the API key and click Close.
  8. Find your Account ID in Account Settings > Account & Security.

With the key and account ID in hand, add them in Machool under Manage > E-commerce > Squarespace, paste them into the fields and click Connect.

The Squarespace settings menu with Developer API Keys
Step 2.
The Squarespace key name field
Step 4.
The Squarespace permissions list with Read only selected
Step 5.
The generated Squarespace API key
Step 7.
The Squarespace Account and Security page showing the account ID
Step 8.
X-Cart

How to connect your X-Cart store

  1. Log in to your X-Cart store admin page, then go to the App Store from the bottom left menu, the puzzle piece icon.
  2. Search for the third party app REST API and install it. This lets your store and Machool communicate.
  3. In the left menu, select My Apps, find the REST API app and click Settings.
  4. Create a strong, unique identifier to use as a read/write API key. Any string of characters works, but a mix of upper and lower case letters, numbers and special characters is harder to guess. Paste it into the API key (read/write) field and click Submit.
  5. Log in to Machool and open the E-Commerce page. Click the X-Cart logo, enter your store URL and the API key from step 4, then click Connect.

You can now view and fulfill your X-Cart orders in Machool.

The X-Cart admin with the App Store icon in the bottom left menu
Step 1.
The REST API app in the X-Cart App Store
Step 2.
The My Apps list in X-Cart with the REST API settings link
Step 3.
The API key field in the X-Cart REST API app settings
Step 4.
The X-Cart connection dialog in Machool
Step 5.

Related

Shopify and WooCommerce both have their own rules pages: Shopify advanced shipping rules and WooCommerce advanced shipping rules. Once orders are flowing in, Batch shipping covers printing labels for several at once.

Did not find what you were looking for? Browse the Support center, or contact us and a person will read your message.