OmniSupply AI

OmniSupply AI helps you keep the right amount of stock in your WooCommerce store. It forecasts what each product will sell, builds purchase orders for your suppliers, helps you receive deliveries accurately, and sends dropship orders to your suppliers. Optional AI can read supplier invoices and review customer notes, but it never changes stock or emails a supplier without your approval.

This guide walks you through installing OmniSupply AI, setting it up, and using it day to day.

Requirements

↑ Back to top
  • WordPress 7.0 or later
  • WooCommerce 7.0 or later
  • PHP 7.4 or later
  • Stock management turned on for the products you want OmniSupply AI to manage
  • For the optional AI features: an AI provider connected to WordPress, for example the AI Provider for OpenAI plugin with your own account

Installation

↑ Back to top
  1. Download the OmniSupply AI ZIP file from your WooCommerce.com account.
  2. In your WordPress admin, go to Plugins > Add New Plugin > Upload Plugin.
  3. Choose the ZIP file, click Install Now, then click Activate.
  4. Go to WooCommerce > OmniSupply AI. You will see the Operations Console and the OmniSupply AI tabs.

Quick start checklist

↑ Back to top
  1. Add your suppliers.
  2. Assign a supplier, sales speed and lead time to each product.
  3. Check your email settings and send a test email.
  4. Review the forecast and build your first purchase order.
  5. Choose how purchase orders are sent: Manual, Automatic, or Full Auto.

Each step is explained below.

Step 1: Add your suppliers

↑ Back to top
  1. Go to WooCommerce > OmniSupply AI > Forecasting.
  2. Open Forecasting and supplier workflow settings and find the Central Supplier Directory.
  3. Add each supplier with their name and the email address that should receive orders.
  4. Choose the supplier type:
    • Replenishment for suppliers you buy stock from.
    • Dropshipping for suppliers who ship paid orders directly to your customers.
  5. Save your settings.

Step 2: Set up your products

↑ Back to top

Open a product in Products and make sure Manage stock is turned on in the Inventory tab.

On the product’s General tab, fill in:

  • Supplier: who you buy this product from.
  • Daily Sales Velocity: leave this empty and OmniSupply AI works it out from your recent sales. Enter a number only if you want to set the daily sales rate yourself.
  • Lead Time (Days): how many days the supplier usually takes to deliver.

On the product’s Inventory tab, you can also add:

  • Supplier product SKU: the supplier’s own code for this product, shown on purchase orders.
  • Minimum order quantity: the smallest quantity the supplier accepts.
  • Carton / pack multiple: if the supplier sells in packs, for example 12, orders are rounded up to whole packs.

For variable products, each variation has its own purchasing fields. Leave a variation’s fields empty to use the main product’s settings.

Step 3: Check your email settings

↑ Back to top
  1. Go to WooCommerce > OmniSupply AI > Email Settings.
  2. By default, supplier emails are sent using your site’s normal email setup. If you prefer, an administrator can enter a separate email account (SMTP) just for supplier emails.
  3. Optionally, add a BCC address to receive a private copy of every supplier email.
  4. Click Save and Send Test Email and check that the test arrives.

Only administrators can change, test, or remove the separate email account. If you change the account’s host, port, encryption, or username, you must enter its password again.

Using the forecast

↑ Back to top

The Forecasting tab shows every product with a supplier, its current stock, how fast it sells, and how many you should order. OmniSupply AI studies the last 90 days of sales, gives extra weight to recent demand, allows for your supplier’s lead time plus a small safety buffer, and takes stock you have already ordered into account, so the same stock is not ordered twice. Products are marked Order now, Attention, or Safe. One unusually large order does not distort the forecast, but repeated large orders do count.

Use the forecast to spot products that will run out soon and add them to their supplier’s next purchase order.

Purchase orders

↑ Back to top

OmniSupply AI keeps one purchase order per supplier for each sending cycle. It updates automatically as stock changes, and you can edit it at any time before it is sent.

Choose a schedule and sending mode

↑ Back to top
  1. Go to WooCommerce > OmniSupply AI > Purchase Orders.
  2. Choose how often purchase orders are sent: daily, weekly on a chosen day, every chosen number of days, or monthly on a chosen date. Set the send time.
  3. Choose a mode:
    • Manual: purchase orders are built for you to review. Nothing is ever sent automatically.
    • Automatic: only purchase orders you have approved are sent on the schedule.
    • Full Auto: valid purchase orders are approved and sent on the schedule without manual approval. Use this only after you have checked supplier emails, product assignments, lead times and pack sizes.

Review and edit a purchase order

↑ Back to top

Open a purchase order to:

  • Change quantities and supplier SKUs.
  • Put a line on hold, remove it, or move it to another supplier.
  • Search for a product or variation and add it manually.
  • Add an internal note. Internal notes are never emailed to the supplier.
  • Preview exactly what the supplier email will say.

When you are happy, click Approve PO for Automatic mode, or Send now to send it straight away. Every change and every email is recorded in the purchase order’s history.

Receiving stock

↑ Back to top

Receive against a purchase order (no AI needed)

↑ Back to top
  1. Open the sent purchase order in Purchase Orders.
  2. For each line, enter the quantity that arrived and click to record it. WooCommerce stock increases by that amount once.
  3. If the supplier cannot supply the rest, cancel the remaining quantity.

The purchase order shows what is still outstanding and changes to Partially received, Received, or Cancelled automatically. Only lines that were sent to the supplier can be received.

Receive from a supplier invoice with AI

↑ Back to top
  1. Go to WooCommerce > OmniSupply AI > Goods Received and choose the supplier.
  2. Upload the supplier’s invoice or delivery docket as a PDF, JPG, or PNG, tick the consent box, and start the analysis.
  3. AI reads the document and fills in the delivered quantities it can match confidently. Lines it is unsure about are listed for you to enter manually.
  4. Check the invoice number, the received date and every quantity. Change anything that is not right.
  5. Tick the confirmation box and click Approve complete receipt and update stock.

Stock only changes when you approve. The same invoice or delivery docket cannot be received twice. Products appear on this screen when they are published, manage stock, are assigned to the supplier, and have had a purchase order sent to that supplier.

Uploaded documents are encrypted and stored privately. They are hidden from the Media Library and can only be opened from the OmniSupply AI screens by people who manage your store.

Dropshipping

↑ Back to top

When a customer pays for a product assigned to a Dropshipping supplier, OmniSupply AI emails that supplier the items and the customer’s delivery details.

  1. Go to Forecasting > Forecasting and supplier workflow settings.
  2. Under Dropshipping supplier email timing, choose to send immediately, 15, 30, 45, or 60 minutes after payment, or at a set time each day.
  3. Optionally, tick the option to email the administrator whenever a delayed order is queued.

Just before sending, OmniSupply AI checks the order again. Cancelled, failed, and refunded orders are not sent to the supplier.

Customer notes and supplier reviews

↑ Back to top

If a customer leaves a note on a dropship order, the supplier email is held for you to review under Supplier Reviews. If you turn on Use AI to handle customer notes, harmless comments are left out automatically, and anything that needs action is still held for you.

To approve an address change, first update the shipping address on the WooCommerce order and check shipping charges. Then open the review, confirm, and send. Supplier emails always use the address on the WooCommerce order, never an address from the note.

The Dropshipping Activity tab shows every dropship order, the AI decision, and whether the supplier email was queued, held, sent, stopped, or failed.

Setting up the AI features

↑ Back to top
  1. Install and connect an AI provider for WordPress, for example the AI Provider for OpenAI plugin with your own account.
  2. To read supplier invoices with AI, upload a document on the Goods Received screen and tick the consent box. Each document is sent to your AI provider only after you give consent.
  3. To review dropship customer notes with AI, turn on Use AI to handle customer notes in the Forecasting settings. It is off by default.

AI requests go through WordPress’s built-in AI connection to the provider you chose, and any usage is billed by that provider. OmniSupply AI does not store your provider’s login details. AI can make mistakes, so always check its suggestions before approving.

Who can use OmniSupply AI

↑ Back to top
  • Administrators can use everything.
  • Shop Managers can use forecasting, purchase orders, receiving, dropshipping, and reviews. They can see the Email Settings page, but only administrators can change the separate supplier email account.

If you change your WordPress security keys

↑ Back to top

Uploaded supplier documents are encrypted using your site’s WordPress security keys. If you change AUTH_KEY, AUTH_SALT, SECURE_AUTH_KEY or SECURE_AUTH_SALT, keep a copy of the old values and add them to wp-config.php as OMNISUPPLY_AI_PREVIOUS_AUTH_KEY, OMNISUPPLY_AI_PREVIOUS_AUTH_SALT, OMNISUPPLY_AI_PREVIOUS_SECURE_AUTH_KEY and OMNISUPPLY_AI_PREVIOUS_SECURE_AUTH_SALT. Then open OmniSupply AI. Your documents are re-encrypted with the new keys, and a notice confirms when every document is done. Only then remove the four lines. You will also need to enter the separate supplier email account password again.

Without the old values, documents uploaded before the change cannot be opened. Your stock and receipt records are not affected.

Troubleshooting

↑ Back to top

Suppliers are not receiving emails

↑ Back to top

Go to Email Settings and send a test email. Check the supplier’s email address in the Central Supplier Directory and look in the supplier’s spam folder.

A product is missing from the forecast or Goods Received

↑ Back to top

Check that the product manages stock and has a supplier assigned. On Goods Received, a purchase order must also have been sent to that supplier for the product.

A receipt says it was not completed

↑ Back to top

The message lists the lines that were not applied and why. Lines that were applied are recorded and will not be added again. Fix the problem and approve the receipt again.

A receipt says an approval was interrupted

↑ Back to top

If an approval was cut off, for example by a lost connection, wait 10 minutes and approve it again. Anything already applied will not be applied twice.

A receipt asks for a manual stock check

↑ Back to top

This only happens on servers whose database cannot undo an interrupted change. Check the product’s stock in WooCommerce, choose whether the delivery is already included, and approve again.

AI invoice reading or note handling is not working

↑ Back to top

Check that an AI provider is installed and connected in WordPress. If AI cannot be reached, OmniSupply AI holds notes for your review, and you can always enter delivered quantities manually.

Removing OmniSupply AI

↑ Back to top

Deactivating or deleting the plugin keeps your suppliers, purchase orders, receipts, and settings, so nothing is lost by accident. To remove all OmniSupply AI data when you delete the plugin, add define( 'OMNISUPPLY_AI_DELETE_DATA_ON_UNINSTALL', true ); to wp-config.php first. This removes receipts and their documents, settings, and the supplier directory, purchase orders, and OmniSupply AI product and order data. WooCommerce order notes and emails that were already sent are not removed.

Need help?

↑ Back to top

If you have questions or run into a problem, contact us through the support link on your WooCommerce.com account.

Related Products

WooCommerce Subscriptions is a WooCommerce extension that lets customers subscribe to your products or...

Offer add-ons like gift wrapping, special messages or other special options for your products.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.