WooCommerce is a full-featured eCommerce solution integrated into WordPress.


Support for WooCommerce integration is presently BETA. Features, implementation, and behavior are subject to change without notice. If you are using, or plan to use, this integration, please contact our sales team.

Aligni’s native WooCommerce integration helps you coordinate your eCommerce activities with your Aligni item master and inventory.


This integration enables Aligni to synchronize changes to your item master (e.g. new items, item changes, and item removal) with your WooCommerce item master. You may also synchronize item inventory updates between systems.

Integration Setup

WooCommerce Authorization

Aligni uses the WooCommerce REST API for integration. To get started, you will need to authorize Aligni to access your WooCommerce installation. Follow the steps in the WooCommerce REST API documentation under Generate API Keys. Next, copy the following settings from your WooCommerce site into Aligni’s WooCommerce integration settings:

  • Store URL – The full URL where your store is hosted.
  • REST API Consumer Key – Copy this from your WooCommerce configuration.
  • REST API Consumer Secret – Copy this from your WooCommerce configuration.

Once connected to your WooCommerce installation, Aligni will use the API to create a webhook to synchronize inventory called “Aligni Inventory Sync”. You should not remove or modify this webhook.

Aligni Configuration

Once the connection to WooCommerce has been established, additional configuration parameters are available.

Inventory Location

The inventory in the selected Aligni warehouse will be synchronized to WooCommerce. Typically, this is a “Finished goods” warehouse or similar.

Inventory Sublocation

Optionally, you may also specify a sublocation for the inventory synchronization. If specified, only inventory in the sublocation will be synchronized. For example, your headquarters warehouse may have a “General Storage” sublocation as well as a “Finished Goods” sublocation.

Item Synchronization

Item synchronization helps you keep your WooCommerce items in sync with Aligni items as your item master in Aligni evolves. This is a one-way synchronization with the following behaviors:

  • When you create a new item in Aligni, a corresponding item will be created in WooCommerce.
  • When an item is removed from WooCommerce, it is NOT removed from Aligni.
  • When you change an item in Aligni, the changes will be reflected in WooCommerce. If the item does not exist, it will be created.

Item attributes are synchronized according to the following table:

Aligni Item AttributeWooCommerce Item Attribute
Item partnumberProduct SKU
Item descriptionProduct name
Item inventory quantityProduct stock

Inventory Synchronization

Inventory synchronization helps you keep your WooCommerce inventory in sync with Aligni items as you receive new inventory or sell existing inventory. This is a two-way synchronization with the following behaviors:

  • When you receive inventory on a purchase order in Aligni, the item’s corresponding inventory in WooCommerce will be synchronized to Aligni’s new count.
  • When inventory is sold on the WooCommerce side, a corresponding inventory consumption will be entered in Aligni. Inventory unit selection is done on a first-in, first-out basis meaning that older inventory units will be consumed before newer units.
  • A PO in WooCommerce is only processed once after transitioning to the “processing” status. Updating the PO multiple times or changing status back and forth will not result in additional processing of the PO in Aligni.
  • “Cost of goods” in WooCommerce is set to the blended value of inventory units in Aligni.
  • “Bin” on WooCommerce is set to the first bin that the inventory was received to in Aligni.

Event Logging

Integration events are not presently logged with this integration.

Error Handling

Emails are sent to the organization system administrator if any of the following errors occur. Generally, these are errors that represent some inconsistency in configuration between WooCommerce and Aligni and should be resolved as soon as possible to prevent data loss. It is not possible to “re-run” a transaction, so manual updates may be required to resolve these issues.

Unknown Item

When WooCommerce posts an item that cannot be found in your Aligni item master, Aligni does not notify the user. These events will go undetected.

Insufficient Inventory

If a WooCommerce request requires more inventory to be consumed than is available, Aligni is unable to satisfy the request completely so an error message is sent. A partial consumption of this item may have already been processed.

Loss of Authorization

If Aligni’s authorization with WooCommerce is lost for any reason, Aligni will be unable to connect to WooCommerce via the API. In this case, an email is sent to the organization administrator notifying them of the loss of authorization and asking them to reauthorize by confirming credentials in the integration settings.