EKM channel integration

Integrating EKM with Avasam lets you download orders, as well as controlling stock levels and prices.

Integrating an EKM store

If you already have an Avasam account setup, then you can integrate your EKM store as shown in this video. We also have separate articles for listing.

EKM integration

Avasam can be integrated with one or more EKM sites to download orders, and update listings with stock levels. Avasam also provides a EKM listing tool.

The list of sales channel integrations has 4 columns:

  • The logo represents the type of channel integration.
  • The type of channel integration.
  • The name of the specific channel integration.
  • The status of the integration - yes/blue is enabled, no/grey is disabled.

New sales channel integration

To create a new sales channel integration:

  1. Open settings.
  2. Select sales channel integration
  3. Click the add sales channel button.
  4. Click on the add button next to EKM.
  5. Enter the name for this integration.
  6. Click next to continue.
  7. Click on the authkey button to connect to your EKM store.
  8. Authorise your connection with EKM by clicking authkey.
  9. Click authkey.
    1. A new tab will open. Login to your EKM account.
    2. You will be asked to give Avasam access to your EKM store.  
    3. Click allow.
    4. Close the tab, as instructed, if it does not close itself.
    5. Select the default currency for your orders as a 3-letter ISO currency code (Enter GBP if unsure).
    6. Click next to continue.
    7. Select the default order status to download orders from EKM. Pending is standard.
    1. Select the default dispatch status for Avasam to update your EKM orders to when shipped. Dispatched is standard.
    2. Click next to continue.
  10. You will be returned to the sales channel list in Avasam, with a new row added for your new integration.

Ensure shipping mapping is in place for any orders in the system, so they can be correctly invoiced when downloaded. 

Shipping Mapping

When you receive orders from customers, Avasam will try to bill you for the products and shipping, so the order can be passed for dispatch. Your shipping services must be mapped for Avasam to correctly charge for them.

With EKM, you can only map a shipping service after an order using it has been downloaded. Ensure that you look for an order with an error for the shipping service  after setting up a new one, so that you can map it. The system will then use that mapping to update and charge for the order.

  1. Open settings.
  2. Select sales channel integration.
  3. Locate the integrated sales channel and click to open.
  4. Click on the section labelled shipping mapping.
  5. The section will expand. Click on the button labelled shipping mapping.
  6. Click on the list of EKM shipping services to select the service to be mapped. Click on the Avasam service to be used in the right hand list, this is the service that will be allocated to the order and charged for when the selected EKM service is used.
  7. Click map.
  8. Repeat as necessary.

Disable channel integration

When you create new channel integration, it is automatically enabled and active.

To disable the integration to stop it downloading orders and updating listings temporarily:

  1. Open settings.
  2. Select sales channel integration.
  3. Locate the integrated sales channel to disable.
  4. Click the status switch to toggle it from yes/active to no/disabled.
  5. The channel will be disabled.

Enable channel integration

When you create new channel integration, it is automatically enabled and active. You, or someone else, may temporarily disable it.

To re-enable the integration to resume downloading orders and updating listings:

  1. Open settings.
  2. Select sales channel integration.
  3. Locate the integrated sales channel to enable.
  4. Click the status switch to toggle it from no/disabled to yes/active.
  5. The channel will be re-enabled.

Remove channel integration

If you no longer wish to have Avasam connected to a sales channel, it can be easily removed. Once deleted, you will need to re-create the integration from scratch should you choose to re-use it.

To remove channel integration:

  1. Open settings.
  2. Select sales channel integration.
  3. Locate the channel integration you want to remove.
  4. To open the integration, click the name.  
  5. Click the red remove account button. 
  6. Click OK to confirm.
  7. You will be returned to the list of channel integrations.

Click ‘Cancel’ if you decide to not delete the integration.
If you delete an integration and then reintegrate the same channel, the analytics and reports will not recognise orders from the two integrations as being from the same site.

Update/verify channel integration

If Avasam is having issues downloading from updating a sales channel, it can be easily checked. In ‘Settings’, select ‘Sales channel integration’ to ensure that you are connecting to the correct website end point.

To update/verify channel integration:

  1. Open settings.
  2. Select sales channel integration.
  3. Locate the channel integration to update.
  4. Click reauthorise.
  5. A new window will open.
  6. Click authkey to request a new token from EKM.
  7. Click save to apply any updates/changes.
  8. You will be returned to the list of channel integrations.

Additional settings for EKM

The EKMintegration has additional settings which can be customised.

Stock update: When enabled, Avasam will provide inventory updates to mapped listings on EKM when the levels change in Avasam. Click to toggle between on and off.

Price (inc VAT) update:  When enabled, Avasam will update prices on mapped listings when you change them in my products in Avasam. Click to toggle between on and off.

Max quantity to advertise: Set the maximum number of an item you want the EKM listing to show for any listing mapped to an Avasam SKU.

  • If the stock level is higher than this number, it will be maintained at this value until you have less available.
  • If the level becomes lower than this point, the inventory level updates the listing dynamically.
  • Once the level increases past the value set, the listing will maintain this level again.

Requires stock update to be set to yes.

Stock Threshold value: Set the stock level of an item you want the EKM listings to treat as zero (out of stock) for any listing mapped to an Avasam SKU.

  • If the stock level is higher than this number, it will not affect the listing.
  • If the level becomes lower than this value, the inventory level updates are set to 0 for the listing.
  • Once the level increases past the value set, the listing will maintain the correct level updates again.

Requires stock update to be set to yes.

Excluding non-Avasam orders

Avasam can download orders for products not linked in Avasam - This is useful if you don't immediately map listings after creating them. Alternatively, if you sell some of your own stock alongside Avasam orders, it can clutter up the order screen. Non-Avasam orders are deleted after 3 days if not for mapped products.

To avoid seeing those orders:

  1. In ‘settings’, select ‘sales channel integration’.
  2. Find the relevant channel integration and click its name to open the integration.
  3. Scroll down to the 'additional settings' section heading.
  4. Click on the 'additional settings' section heading to open up the settings menu.
  5. Set the exclude non-Avasam orders switch to off, or grey.
  6. Click ‘save’ to apply any updates or changes to Avasam.
  7. You will be returned to the list of channel integrations.

You cannot make exclude non-Avasam orders and split orders with unknown SKUs active simultaneously, only one at a time can be active, or neither.

Splitting order containing Avasam and non-Avasam SKUs

Where some of your orders contain a mix of Avasam and non-Avasam products, this setting allows you to process the Avasam products and not import the unknown items. When set to no, you will only import these orders if exclude non-Avasam orders is set to no.

To enable this:

  1. In ‘settings’, select ‘sales channel integration’.
  2. Find the relevant channel integration and click its name to open the integration.
  3. Scroll down to the 'additional settings' section heading.
  4. Click on the 'additional settings' section heading to open up the settings menu.
  5. Set the split orders with unknown SKUs switch to on, or green.
  6. Click ‘save’ to apply any updates or changes to Avasam.
  7. You will be returned to the list of channel integrations.