Skip to main content

Shopline

Shopline Channel Integrations​

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

Integrating a Shopline store​

Getting started from scratch​

Shopline integration​

Avasam can be integrated with one or more Shopline sites to download orders, and update listings with stock levels. Avasam also provides a Shopline 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.

  1. Click on the ‘Add’ button next to ‘Shopline’.
  2. Enter the name for this integration.

  1. Click ‘Next’ to continue.
  2. Enter the Handle of Shopline website. The app’s unique identifier, and store domain prefix. For example, the handle of https://zhangsan.myshopline.com “zhangsan”.

  1. Click ‘Next’.
  2. Authorise your connection with Shopline by clicking ‘Authkey’.

  • Enter the email address registered to your Shopline account & Enter your Shopline password.

  • Click ‘Log in’.
  • You’ll attached message

  1. The integration will create an inventory location in Shopline called avasam that will be used for stock level updates. You can select a different location.
  2. You'll be asked to select Send notification to customers as yes or no

  1. Save the changes when you're happy with the options.
  2. Click ‘Next’ to continue.
  3. You will be returned to the sales channel list in Avasam, with a new row added for your new integration.
  4. Shopline channel integrated successfully

Disable channel integration​​

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

To disable the integration to stop it from 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 a 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.

  1. Click ‘OK’ to confirm.
  2. You will be returned to the list of channel integrations.
  • Click ‘Cancel’ if you decide not to delete the integration.
  • If you delete 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. Locate the channel integration.

  2. Click the name to open the integration.

  3. Click ‘Reauthorise’.

  4. A new window will open.

  5. Click ‘Authkey’ to request a new token from Shopline.

  6. Click ‘Save’ to apply any updates/changes.

  7. You will be returned to the list of channel integrations.

Additional settings for Shopline​​

The Shopline integration has additional settings which can be customised.

Default collection: Where collection locations are offered in Shopline, set which one will be used for orders shipped via Avasam. Click to open drop down list and select option.

Stock update: When enabled, Avasam will provide inventory updates to mapped listings on Shopline 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 Shopline 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 Shopline listing 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.

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.

Listing a product in your Shopline store​

  1. Open listing manager
  2. Open the listings option for the chosen Shopline store.
  3. Select one or more products to list that don't have the error or listed icons by their entry (or filter for unlisted) by selecting/ticking the left hand box for the product(s).
  4. Click on list at the bottom of the screen.
  5. Avasam should report 'item listed successfully'.
  6. The screen will refresh. You may need to change the filter settings to show the product(s).
  7. If there is an error with the process, then this will be reflected by an error icon (see below). Otherwise the status will change to listed.

Should an error be reported, try to identify the issue. If necessary you can contact support for assistance.

Updating listings​

If you want to update listings, price etc for one of more products on Shopline, then you can do so as follows:

  1. Open listing manager.
  2. Open the listings option for the selected Shopline store.
  3. Select 1 or more products that are listed (you can filter for unlisted) by selecting/ticking the left hand box for the product(s).
  4. Update the details for those products.
  5. Check the updates are correct.
  6. Click on update at the bottom of the screen.
  7. Avasam should report 'item updated successfully'.
  8. The screen will refresh. You may need to change the filter to show the product(s).
  9. If there is an error with the process, then this will be reflected by the error icon (see below). Otherwise the status will change to listed.

Deleting listings​

If you no longer want a product to be listed on Shopline, then you arrange this by following these steps:

  1. Open listing manager.
  2. Open the listings option for the selected Shopline store.
  3. Select 1 or more products that are listed (you can filter for unlisted) by selecting/ticking the left hand box for the product(s).
  4. Click on action at the top of the screen.
  5. Select delete.
  6. Avasam should report 'item removed successfully'.
  7. The screen will refresh. You may need to change the filter to show the product(s).
  8. If there is an error with the process, then this will be reflected by the error icon (see below). Otherwise the product(s) will be shown as not listed.

Listing manager​

The listing manager can be opened from the menu to the left of the Avasam screen. This allows you to add products to your Shopline store, check their status and update them.

It contains information about the integrated channels and their current status (order sync, price sync, stock sync, all show the time this last occurred). It also contains information about the listings on the individual stores.

The listing manager shows the products in your inventory and their status on your Shopline store (listed, not listed, error). You can search for a product or filter the products shown using the controls along the top of the screen.

The columns and controls are as follows:

Checking the status of listings in my products​

In the my products page, click on columns. Click on default columns to expand the selection, and check the entry for your integrated Shopline channel to show it in the product list. You can add columns for more than one integrated Shopline store here.

Click apply to save the change. This adds one or more new column(s) to your my products list.

This shows the status of the product on your Shopline store.

Shopline SKU mapping​

This guide ensures that Avasam can fulfil and invoice your Shopline orders with the correct items.​

SKU mapping makes sure that Avasam knows which items in a particular order correlate with items in your inventory.

If the product isn't mapped, Avasam can't direct the order to the right supplier and raise the correct invoice. This means that your order won't be shipped If you want Avasam to automatically recognise the correct inventory SKU when the order is downloaded, then you will need to ensure all SKUS are mapped correctly from Shopline.

Editing existing SKU mappings​

The SKU mapping tool will list all existing mappings. You can expand this section by clicking on the arrow to the right of the title. This will open a new window that includes information about the products in your inventory, and the listings available on the integrated account.

Create a new SKU mapping​

To create a new SKU mapping:

  1. You can search for the listing you want to map by entering all or part of the SKU or title into the search bar under sales channel SKUs.
  • Select 'download' from the actions available field to grab the latest information from the site if the listing is not shown.
  1. Search for the SKU you want to map under the sales channel SKU heading, or by scrolling down the list.
  2. Search for the Avasam SKU to map this against under the Avasam SKU heading, then select the SKU and click ‘map them’ to the right of it.
  3. Click 'save' to apply this mapping to Avasam.

Delete a SKU mapping​

To delete a SKU mapping:

  1. You can search for the listing you want to change by entering all or part of the SKU or title into the search bar under Avasam SKUs or sales channel SKUs.
  2. Click the unlink button to sever the mapping.
  3. Click 'save' to apply this change of mapping to Avasam.

Shopline shipping mapping​

This guide ensures that Avasam can fulfil and invoice your Shopline orders with the correct shipping services for the supplier.​

If you want the shipping service paid for by the customer to automatically select the correct shipping provider and service when the order is downloaded to Avasam, then you will need to map the services from the site/channel to those in Avasam.

The ‘Shipping mapping’ section will list any existing mappings. You can open/expand it by clicking on the arrow to the right of the title. This will open a new window that includes information about the available Avasam shipping services, and the services available on the integrated account.

If any services are already mapped, then they will be listed here.

Delete a shipping mapping​

To delete a shipping mapping:

  1. Locate the service.
  2. Click the ‘X’ to the right of the service.
  3. Click ‘Save’ to apply the change.

Create a new shipping mapping​

To create a new shipping mapping:

  1. Select the Shopline shipping service to map under the ‘Sales channel shipping service’ drop down list.
  2. Select the Avasam shipping service to map this against under the ‘Avasam shipping service’ drop down list.
  3. Click map field.

Listing on Shopline with Avasam​

With the Avasam listing tool, it's easier than ever to add your products to your Shopline store

Shopline type mapping​

Shopline maintains categories or types. To get the best performance for your products, you should map the types in Shopline to Avasam categories.

When working with your products in Shopline, mapping Avasam categories to Shopline types will help to ensure that product updates and orders are handled correctly.

Editing existing type mappings​

The Shopline type mapping section will list all existing mappings. You can expand this section by clicking on the arrow to the right of the title.

Create a new type mapping​

To create a new type mapping:

  1. Search for the Shopline type you want to map under the Shopline Type heading, or by scrolling down the list.
  2. Search for the Avasam category to map this against under the Avasam category heading, then select the entry and click ‘map’ to the right of it.
  3. Click 'save' to apply this mapping to Avasam.