FLUF Connect for OpenCart 1.0.0

Import and crosslist simple products, synchronise stock, and view new OpenCart sales in FLUF Connect.

REQUIREMENTS
OpenCart 4.1.0.4, PHP 8.1 or later, InnoDB product tables, a public HTTPS store, and a FLUF account with an eligible plan. This release supports the default store only and one OpenCart store per FLUF business. The extension download is free; FLUF service fees apply. See https://fluf.io/connect/ for current plans.

INSTALLATION
1. Back up your store. In OpenCart, open Extensions > Installer, upload fluf_connect.ocmod.zip, then click Install.
2. Open Extensions > Extensions, choose Modules, and install FLUF Connect. Click Edit.
3. Enable the connection. Choose the tax class, shipping requirement, weight and dimensions for products created from FLUF. Prices sent to OpenCart are BEFORE OpenCart tax, in your store's default currency. Review these defaults and your shipping methods before checking the box that allows publication.
4. Generate a connection key and copy it; it is shown only once. Keep it private.
5. Open https://fluf.io/connect/channels, choose OpenCart, and enter your public HTTPS storefront URL and connection key. Include the subdirectory if OpenCart is installed in one.
6. Import a few existing products. Test a new listing and a checkout in your test store before using this connection for your full catalogue.

SUPPORTED
Stock-tracked simple products; titles, descriptions, SKU, base prices, categories and product photos; creating products; editing title, description, SKU, price and quantity; disabling products; and new orders in the store's processing/completed statuses. Stock zero disables a product. Positive stock updates enable it again. Deactivation preserves the product and its order history.

LIMITS
OpenCart 3.x and other 4.x versions, multi-store, options, variants, discounts, specials and products without stock tracking are not supported. Excluded products do not import. Refunds, cancellations, shipping/fulfilment and image edits remain in OpenCart. Automatic relisting and rule-based autolisting are unavailable. Tax and delivery defaults apply only to new products; edit individual details in OpenCart when needed. FLUF imports base prices, not a customer's tax-inclusive checkout price. Set destination prices appropriately before crosslisting. Stock synchronisation is periodic, not instant; simultaneous purchases remain possible.

Orders created before the connection do not trigger stock updates. Historical order status changes and cancellations do not automatically restock other channels. Custom inventory and checkout extensions require separate testing.

PHOTOS
Up to 10 JPEG, PNG or WebP images per new product; up to 5 MiB each and 16 MiB combined. Hosting must allow a 24 MiB JSON request.

DATA AND CONTROL
The connection lets FLUF read store settings, products, categories, orders, customer contact details and shipping addresses, and create/edit products and inventory. No customer data is transferred until you connect the store to FLUF. Use FLUF's account settings or contact info@fluf.io for account data requests. Privacy: https://fluf.io/privacy-policy/ . Service terms: https://fluf.io/terms-conditions/ .

Disconnect OpenCart in FLUF to stop the connection. In the OpenCart module, use Disconnect and revoke key to invalidate store access. Generating a new key invalidates the old key; reconnect FLUF with the replacement. Uninstalling the module removes settings and revokes access. Existing products, photos and product-write recovery records remain to preserve your catalogue and prevent duplicate listings after reinstall. No order/customer records or connection keys are stored in recovery records.

TROUBLESHOOTING
Connection fails: check the exact OpenCart version, HTTPS URL, module enabled state and key. If you changed the key, reconnect in FLUF. Your host must allow authenticated API requests without redirecting them.
New listing blocked: confirm the product defaults in the OpenCart module and check that the source product is simple.
Product excluded: remove unsupported options, variants or promotional prices only if appropriate for your store; otherwise keep managing it in OpenCart.
Changed stock: refresh and retry; another checkout or stock edit may have happened.

Support: info@fluf.io
Guide: https://fluf.io/wp-content/themes/astra-child/FLUF%20OpenCart%20Extension/public/index.html
License: GNU GPL version 3 or later; see LICENSE.txt. The FLUF hosted service has separate terms.
