WooMCF Documentation

How WooMCF works

WooMCF connects your WooCommerce store to Amazon Multi-Channel Fulfillment (MCF). Your products are stored in Amazon FBA warehouses. When a customer buys on your WooCommerce store, WooMCF sends the order to Amazon, and Amazon picks, packs, ships, and provides tracking. You never touch the order.

Along the way WooMCF also keeps your WooCommerce stock in sync with your real FBA inventory, protects you from overselling, and always picks the cheapest pack combination to fulfill each order.

Terms used in this guide

Requirements

• WordPress 6.0 or newer
• WooCommerce installed and active
• PHP 8.0 or newer
• HTTPS enabled on your store
• An active Amazon Professional Seller account with inventory in FBA
• A WooMCF license key from your purchase email

Installation

1. Download the plugin ZIPThe download link is in your purchase email.
2. Upload it to WordPressIn your WordPress admin go to Plugins → Add New → Upload Plugin, choose the ZIP, and click Install Now.
3. Activate WooMCFClick Activate. A new WooMCF menu appears in the admin sidebar with four pages: Pack Mapping, Settings, Sync & Health, and License.

Updating later: install the new ZIP over the old one, or deactivate and replace the plugin folder. Your settings, mappings, and order history are kept.

Activate your license

1. Open the License pageGo to WooMCF → License.
2. Enter your license keyPaste the key from your purchase email. It starts with WOOMCF-.
3. Click ActivateThe status badge turns green and shows your renewal date.

A license is linked to one store at a time. If you move your store to a new domain, just activate the same key on the new site.

WooMCF revalidates your license automatically in the background. You can also click Check now on the License page to verify it immediately, for example right after renewing.

Connect Amazon

WooMCF uses Amazon's official login flow. You never copy API keys or developer credentials. You simply approve the connection inside your own Seller Central account.

1. Click Connect Amazon accountOn the WooMCF → License page, in the Amazon Connection card. Your license must be active first.
2. Log in to Seller CentralA Seller Central page opens. Log in with your Amazon seller account if asked.
3. Approve the connectionAmazon shows what WooMCF will access. Click Confirm.
4. Return to your storeYou land on a confirmation page. Back in WordPress, the badge shows Connected within a few seconds. Click Check connection if it still says Connecting.

What WooMCF can access

Only the Amazon Fulfillment permission: reading your FBA inventory levels and creating or tracking fulfillment orders. WooMCF cannot see your Amazon sales, pricing, advertising, or customer data from Amazon orders.

Connection badges

Disconnecting

You can revoke WooMCF's access at any time from Seller Central under Apps & Services → Manage your apps. Orders stop pushing immediately after you revoke.

Marketplace settings

Below the Amazon Connection card on the License page you choose which marketplace your FBA inventory lives in.

• Marketplace ID: pick the marketplace where your FBA stock is stored. Most sellers use the United States.
• Region: North America.
• Sandbox mode: for testing only. In sandbox, orders are simulated and nothing real ships. Keep this off for live selling.

Click Save after changing any of these.

Pack Mapping

This is the heart of WooMCF. On Amazon your product exists as packs, for example Pack of 5, Pack of 100, Pack of 300. On your WooCommerce store customers buy single units. Pack Mapping tells WooMCF which Amazon SKUs hold your units so it can convert between the two.

Mapping a product

1. Open Pack MappingGo to WooMCF → Pack Mapping and select the product you want to map. Both simple and variable products work.
2. Add a row per pack sizeFor each Amazon pack listing enter the Amazon Seller SKU and the pack size (units per pack). Example: SKU BOTTLE-32OZ-5Ct with pack size 5.
3. Optionally add a shipping costThe shipping cost column overrides the global cost for that pack size. See Shipping costs.
4. SaveWooMCF starts syncing stock for those SKUs on the next sync cycle.

How stock is calculated

After mapping, WooMCF manages the product's WooCommerce stock for you. The number shown to customers is the sellable quantity: how many units can actually be built from the packs Amazon has in stock, after your cost cap is applied. Example: 2 packs of 100 in FBA means customers can buy up to 200 units.

Per product cost cap

Each product's Pack Mapping page also has a Max shipping cost per order card. A value here overrides the global cap for this product only. See Max cost per order.

Simple MCF Mode

If a product ships one to one, meaning one WooCommerce unit equals one Amazon unit, you do not need pack mapping at all.

1. Match the SKUsSet the product's WooCommerce SKU to exactly the same value as its Amazon Seller SKU.
2. Enable MCF on the productEdit the product and check Fulfill via Amazon MCF in the WooMCF box. For variable products, enable it per variation.
3. DoneOrders for this product push to Amazon with the WooCommerce SKU, quantity as is.

You can also enable or disable MCF for many products at once: select them in the Products list and use the Enable MCF Fulfillment bulk action.

When to use which: use Simple MCF Mode when your Amazon listing is the exact unit you sell. Use Pack Mapping when Amazon holds multi unit packs and your store sells singles.

Discount tiers

Reward larger orders with automatic percentage discounts. Tiers apply only to products fulfilled through WooMCF, never to the rest of your catalog.

1. Open SettingsGo to WooMCF → Settings, Quantity discount tiers card.
2. Define your tiersEach row has a from quantity and a discount percent. Example: from 50 units 5%, from 100 units 10%, from 300 units 15%.
3. SaveThe discount is applied automatically in the cart based on the total quantity of that product.

There are no preset discounts. By default a single tier exists at quantity 1 with 0%, which means no discount until you decide otherwise.

The Show tiers on product page toggle displays your tier table to customers on the product page, which encourages bigger orders.

Sync & Health dashboard

WooMCF pulls live FBA stock from Amazon every 15 minutes and updates your WooCommerce stock to match. The WooMCF → Sync & Health page shows the current state of every mapped SKU.

Dashboard columns

Use Sync now to trigger an immediate sync instead of waiting for the next cycle. The sync log below the table records every sync run with a timestamp and result.

Drift alerts

Drift is the gap between what Amazon has and what WooCommerce shows. Small drift is normal between sync cycles. Large drift means something needs attention, for example a big Amazon sale that consumed your FBA stock.

Configure two thresholds in WooMCF → Settings:

• Warning: the SKU is highlighted on the dashboard. Nothing else happens.
• Critical: WooMCF resyncs that SKU immediately, and optionally emails you.

Turn on Email on critical drift to receive one digest email per sync cycle listing every SKU that crossed the critical threshold. The email goes to your alert email.

Checkout stock locks

When a customer reaches checkout, WooMCF reserves the exact units their cart needs, by default for 15 minutes. During that window no other customer can buy those same units. This makes overselling impossible even under heavy traffic, flash sales, or ad spikes.

• The lock is released automatically when the customer completes the order or the window expires.
• The lock duration is configurable in WooMCF → Settings.
• Locked units are visible in stock calculations, so the storefront always shows what is truly available.

Shipping costs

Amazon charges you a fulfillment fee per pack shipped. Tell WooMCF what each pack size costs you, and it will always fulfill every order with the cheapest possible pack combination.

Setting costs

• Global: in WooMCF → Settings, the Shipping costs & order cap card. Add a row per pack size, for example Pack of 5 costs $7.99, Pack of 100 costs $12.49.
• Per pack override: the shipping cost column in Pack Mapping overrides the global value for that specific pack.

Example

A customer orders 110 units. You stock Pack of 100 ($12.49), Pack of 10 ($8.99), and Pack of 5 ($7.99). WooMCF compares every valid combination and picks 1 × Pack of 100 + 1 × Pack of 10 for a total cost of $21.48, instead of shipping 22 packs of 5 for $175.78. This happens automatically on every order.

Max cost per order

The cap is your loss protection. Set a Max shipping cost per order and WooMCF will refuse to sell any quantity whose cheapest fulfillment would cost more than that number.

• Global cap: in Settings, next to the shipping cost rows. Applies to every mapped product.
• Per product cap: on the product's Pack Mapping page. Overrides the global cap for that product.
• Leave it blank for no cap.

What happens when a quantity exceeds the cap

The quantity is simply not offered. The storefront quantity field will not accept it, and if a customer types it anyway they see a clear message listing the quantities they can buy. Nothing reaches checkout that would lose you money on shipping.

What customers see

WooMCF quietly shapes the quantity field on your product pages so customers can only order what you can actually fulfill:

• The field starts at the smallest quantity you can fulfill, not at 1, when packs make single units impossible.
• The maximum is the sellable quantity from live FBA stock and your cost cap.
• If a customer types an impossible quantity and clicks Add to Cart, the browser shows a message such as Available quantities: 100, 200. No popups, no layout changes, works with any theme.
• The same rules are enforced again on the server at add to cart and at checkout, so the protection cannot be bypassed.

Tip: mention your pack sizes in the product description so buyers know what to expect, for example "sold in packs of 100".

Order lifecycle

1. Order is paidWooMCF takes over as soon as payment clears. The order moves to the amber MCF Pending status.
2. Pushed to AmazonWooMCF sends the fulfillment order with the cheapest pack split and the customer's shipping address. Every push is idempotent, meaning the same order can never be sent twice.
3. Amazon shipsAmazon picks, packs, and ships from FBA stock, using plain unbranded packaging.
4. Tracking returnsWooMCF pulls tracking numbers, adds them to the order, emails the customer, and marks the order Completed.

Everything WooMCF does is recorded in the order timeline, visible in the order's notes: the pack split chosen, the push result, tracking events, and any errors. When something goes wrong the reason is right there on the order.

Tracking & delivery

WooMCF checks Amazon regularly for fulfillment updates on pushed orders. When Amazon ships:

• Tracking numbers are saved on the WooCommerce order.
• The customer receives the tracking in an order note email.
• The order status changes to Completed automatically.
• Customers can also see the tracking on their account page.

If Amazon splits a shipment into multiple boxes, every tracking number is captured.

Failed orders & retry

Sometimes a push fails, for example when an address is incomplete or Amazon reports the SKU out of stock. When that happens:

• The order stays in MCF Pending and the exact error is written to the order timeline.
• A Push to MCF button appears on the order screen. Fix the underlying issue, for example correct the address, then click it to retry.
• If you enabled the goodwill coupon, the customer is automatically offered a discount for the inconvenience. See below.

Goodwill coupon

Optional. When an order cannot be fulfilled, WooMCF can automatically email the customer a percentage discount coupon for their next order, softening the bad experience while you resolve the issue.

• Turn it on in WooMCF → Settings, Failed fulfillment goodwill card.
• Set the discount percent, for example 10% off the next order.
• Off by default. Nothing is ever sent unless you enable it.

Notifications

All WooMCF alerts, including the critical drift digest and failed fulfillment notices, go to your alert email, set in WooMCF → Settings, Notifications card.

• Leave it blank to use your WordPress admin email.
• For reliable delivery install an SMTP plugin such as WP Mail SMTP. Without SMTP, WordPress emails often land in spam.
• WhatsApp notifications are coming in a future update.

License expiry & grace

If your subscription lapses:

• New order pushes and inventory sync pause. Your store keeps running, but WooMCF stops sending new work to Amazon.
• Tracking keeps working for 30 days. Orders that were already pushed continue to receive tracking updates and complete normally, so your customers' deliveries are never affected by a billing hiccup.
• An amber notice appears in your admin so you know what is happening.

Renew from the link in your purchase email, then click Check now on the License page. Everything resumes immediately, no reinstall needed.

Troubleshooting

FAQ

Does WooMCF work with my theme?

Yes. WooMCF uses standard WooCommerce hooks and native browser validation, so it works with any WooCommerce compatible theme, including custom builds.

Does Amazon branding appear on my packages?

MCF ships in plain packaging by default. Amazon offers unbranded packing options for Multi-Channel Fulfillment orders.

Can I use WooMCF for only some of my products?

Yes. Only products you map or enable are touched. The rest of your catalog is completely unaffected, including discounts and stock.

What happens during an Amazon outage?

WooMCF falls back to the last known stock numbers and keeps taking orders. Pushes that fail are retried, and anything needing attention appears on the order timeline and the dashboard.

Which marketplaces are supported?

North America: United States, Canada, and Mexico. More regions are planned.

Is my data safe?

WooMCF connects through Amazon's official OAuth flow. Access tokens are stored encrypted on our licensing server and are used only to sync inventory and create fulfillment orders. You can revoke access at any time from Seller Central.

What is removed if I uninstall?

Deleting the plugin keeps your data by default so nothing is lost by accident. Order history and fulfillment records always stay with your orders.

Support

Stuck on something this guide does not cover? We answer every message.

• Email: hello@woomcf.com
• Contact form: woomcf.com/contact

Include your site URL and, if it is about a specific order, the order number. It helps us help you faster.