WooCommerce

WooCommerce channel integration

Avasam can be integrated with one or more WooCommerce websites to download orders, and update listings with stock levels.

The list of sales channel integrations has 4 columns:

• The logo representing 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. In ‘Settings’, select ‘Sales channel integration’.
2. Click the ‘Add sales channel’ button.
3. Click on the ‘Add’ button next to ‘Woocommerce’.
4. Enter the name for this integration.
5. Click ‘Next’ to continue.
6. Enter your website address in the ‘Website end point’ field.
7. The ‘Consumer key’ and ‘consumer secret’ fields come from your website.
   1. Log in to the control panel of your website.
   2. Select the WooCommerce menu, and Settings.
   3. Select the Advanced tab.
   4. Click Legacy API.
   5. Ensure Legacy API is ticked.
   6. Click Rest API.
   7. Click Add key.
   8. Set a name/description for the key, such as 'Avasam'.
   9. Set permissions to read/write.
   10. Click Generate API key.
   11. This will provide you with a Consumer key and Consumer secret field.
8. Using the copy buttons, copy and paste these values into the Avasam integration.
9. Select the version v2 & v3 from the version drop-down menu
10. Click Next to continue.
11. You will be returned to the sales channel list in Avasam, with a new row added for your new integration.

tip

• Click ‘Cancel’ to return to the sales channel integration list without completing the integration.

tip

Ensure that your channel has stock updates enabled to ensure that your listings don't oversell.

1. Click on the channel name.
2. Click on additional settings.
3. Toggle the switch for stock update to yes.
4. Click save.

tip

By default, many WooCommerce servers do not support PUT methods in the API connection, which Avasam requires to work correctly with your webstore. This might manifest as the site not displaying the correct stock level for products after they are listed.
This can be corrected by your site developer. They will need to make adjustments to your site, though the method and updates needed will depend upon the specific configuration and plugins you are using.

Disable channel integration

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

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

1. In ‘Settings’, select ‘Sales channel integration’.
2. Locate the integrated sales channel you wish to disable.
3. Click the status switch to toggle it from ‘Yes’/active to ‘No’/disabled.
4. The channel is disabled.

Enable channel integration

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

You can re-enable the integration to resume downloading orders and updating listings.

1. In ‘Settings’, select ‘Sales channel integration’.
2. Locate the integrated sales channel you wish to enable.
3. Click the status switch to toggle it from ‘No’/disabled to ‘Yes’/active.
4. The channel is 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 a channel integration:

1. In ‘Settings’, select ‘Sales channel integration’.
2. Locate the channel integration you want to remove.
3. To open the integration, click the name.
4. Click the red ‘Remove account’ button to remove the integration.
5. Click ‘OK’ to confirm.
6. 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 a channel integration:

1. This opens the current list of sales channel integrations.
2. To open the integration, click the name.
3. Click ‘Reauthorize’.
4. Check the ‘Website end point’ value is correct.
5. Confirm the ‘Consumer key’ is correct.
6. Confirm the ‘Consumer secret’ is correct.
7. Click ‘Save’ to apply any updates/changes.
8. You will be returned to the list of channel integrations.

tip

• Click ‘Cancel’ if you decide to not change/update the integration.

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.

tip

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.

Listing on WooCommerce with Avasam

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

tip

Before you can list a product you must ensure that you have sourced products and integrated your WooCommerce store.

tip

Ensure that the title, description, shipping price and selling price are correct before listing a product.

tip

We recommend installing the Allow WebP Image extension on your WooCommerce site to ensure that all images are uploaded for your listings.

Listing a product in your WooCommerce store

1. Open listing manager.
2. Open the listings option for your WooCommerce store.
3. Select one or more products to list that don't have tick icons by their entry by selecting/ticking the left hand box for the product(s).
4. Click on list at the bottom of the screen.
5. Avasam will report item listed successfully.
6. The screen will refresh.
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.

tip

When listing products to your store, both with and without using the Avasam listing tool, in order to map the product correctly so that orders for the product can be processed, you will need to go into the mapping tool to download the latest listings after they have been created:

• Open settings
• Open channel integrations
• Click on the channel to open the settings
• Click on SKU mapping to expand the section
• Select download from the drop down list. This may take several minutes.
• Click on the SKU mapping tool button.
  -- If the items were listed in Avasam , or using the Avasam SKUs, then click on the action available option, and select automap SKUs.
  -- If the items were listed with a different SKU, then follow the instructions for SKU mapping.
• Click close when you have finished.

tip

The tick icons indicate that an item is already listed on your WooCommerce store.

• A green tick is an item that has been previously listed using Avasam's listing tool on your WooCommerce store.
• A grey tick is an icon that is already on your store, but was listed without using our listing tool.

If an item shows a red exclamation mark (!) icon, this means that there has been an error when trying to list that item. Please hover the mouse over it for a tool tip that says why, or contact our support team for assistance.

tip

If you change your mind about updates you are making to products for listing, then you can click cancel to leave the screen and abandon changes.

If you are interrupted and want to come back and finish later, then selecting the products and clicking action, then save will keep them saved for later.

Updating listings

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

1. Open listing manager.
2. Open the listings option for your WooCommerce store.
3. Select 1 or more products that are listed (you can filter for listed items at the top of the list) 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 will report item updated successfully.
8. The screen will refresh.
9. If there is an error with the process, then this will be reflected by the error icon. Otherwise the status will change to listed.

Deleting listings

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

1. Open listing manager.
2. Open the listings option for your WooCommerce store.
3. Select 1 or more products that are listed (you can filter for listed) 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 will report item removed successfully.
7. The screen will refresh.
8. If there is an error with the process, then this will be reflected by the error icon. Otherwise the product(s) will be shown as not listed.

tip

When 1 or more products have been selected, the action drop down allows you to choose whether to list, save or delete those products.

Listing manager

The listing manager is where you can review and control the status of your integrated sales channels.

The listing manager can be opened from the menu to the left of the Avasam screen. This allows you to add products to your WooCommerce 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 WooCommerce 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:

Column/control	Purpose
Select/Select All	Toggle selection of one or more products/rows to apply an action to. Ticking select all ticks all rows.
Image	Primary image for product
Avasam SKU	Product identifier/SKU in Avasam inventory
Variation	Shows if product is in a variation, and if it's a child product or a parent product
Title	Title of product - as will be shown in the product listing on Shopify
Description	Click to open edit window for product listing description
Category	Avasam catalogue category
Stock	Number currently available in stock
Cost Price exc	Cost price specified by supplier
Shipping Price exc	Shipping price specified by supplier - can be edited for listing
Selling Price (Inc VAT)	Price to sell on channel (If pricing rule is setup, then this will show auto instead of allowing editing)
Product type	Product type in WooCommerce store
Collection	Product collection in WooCommerce store
Status	Can filter or order by listed, not listed or error

tip

You can also click on the listing manager entry on the left to toggle it and show the available integrated channels with listing tools as subcategories. Clicking on one of these is the same as clicking the listings button.

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 WooCommerce channel to show it in the product list. You can add columns for more than one integrated WooCommerce stores 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 WooCommerce store.

Icon	Status
	Correctly linked to listing on WooCommerce and listed via the Avasam listing tool
	Correctly linked to listing on WooCommerce but not listed via the Avasam listing tool
	Error when listing or updating on WooCommerce
	Not yet listed or linked on WooCommerce, but can be listed

WooCommerce SKU mapping

This guide ensures that Avasam can fulfil and invoice your WooCommerce 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 WooCommerce.

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.
   1. Select 'download' from the actions available field to grab the latest information from the site if the listing is not shown.
2. Search for the SKU you want to map under the sales channel SKU heading, or by scrolling down the list.
3. 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.
4. Click 'save' to apply this mapping to Avasam.

tip

To further filter the listings and products shown in either list, use the unmapped SKUs and mapped SKUs options. This will reduce the volume of results shown

tip

Changes made will only affect orders downloaded after new mapping is in place. It will not affect orders already in 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.

WooCommerce shipping mapping

This guide ensures that Avasam can fulfil and invoice your WooCommerce orders with the correct shipping services

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 service you want 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’.

tip

• This will only affect orders downloaded after it is mapped. It will not affect orders already in Avasam.