Acumatica Connector documentation.

Version: 1.0.0
Requires: WordPress 6.0+, WooCommerce 7.0+, PHP 7.4+
Supported ERP: Acumatica Cloud ERP and MYOB Acumatica using supported contract-based REST endpoints
Implementation: QuixWP onboarding is required before production automation is enabled

Overview

QuixWP Acumatica Connector connects an established WooCommerce store to Acumatica or MYOB Acumatica. It is designed for businesses that already maintain products in WooCommerce and want Acumatica to remain the operational source for stock, base pricing, customer price classes, and sales-order processing.

The connector includes:

• Secure Acumatica authentication and endpoint-version discovery.
• Manual and scheduled stock and base-price synchronization.
• Customer price-class import and WordPress role mapping.
• Customer-specific storefront, cart, and checkout pricing.
• WooCommerce order export to Acumatica SalesOrder.
• Automatic retries, manual retries, redacted logs, and operational status reporting.
• HPOS-compatible order access and Action Scheduler support.

Important: The plugin is a complete commercial connector, but Acumatica environments differ in tenant structure, warehouses, price classes, tax codes, freight items, units of measure, and custom fields. QuixWP onboarding configures those environment-specific details and validates the final workflow.

Requirements

The Acumatica API user should have only the permissions required for the agreed catalogue, pricing, customer, and SalesOrder operations. QuixWP confirms the exact access requirements during onboarding.

Standard implementation scope

The standard package includes:

• One WooCommerce production website.
• One Acumatica or MYOB Acumatica tenant.
• An existing WooCommerce catalogue with matching SKUs.
• Base-price synchronization.
• Stock-quantity synchronization.
• Customer price-class synchronization.
• WooCommerce role-to-price-class mapping.
• WooCommerce order export to Acumatica SalesOrder.
• One controlled catalogue test, one controlled order test, and production sign-off.

The following commonly require custom scope: product creation, image and category synchronization, matrix-item generation, advanced multi-warehouse allocation, unusual units of measure, multiple stores or tenants, bidirectional fulfilment, refunds, custom endpoints, and extensive custom-field mapping.

Onboarding workflow

1. Compatibility review: QuixWP reviews the WooCommerce catalogue, Acumatica tenant, Inventory IDs, warehouse setup, price classes, order workflow, and required mappings.
2. Secure installation: The connector is installed, the dedicated API account is configured, and the connection is validated.
3. Catalogue test: A controlled synchronization confirms SKU matching, stock behavior, base pricing, and customer price classes.
4. Order test: A test WooCommerce order is exported and reviewed in Acumatica before automatic exports are enabled.
5. Production sign-off: Scheduling and automatic order export are enabled after both teams approve the results.

The plugin’s Onboarding screen records each stage and keeps automatic processes disabled until the implementation is approved.

Installation

Installation is normally completed by QuixWP as part of onboarding:

1. Go to WP Admin → Plugins → Add New → Upload Plugin.
2. Upload quixwp-acumatica-connector.zip.
3. Activate the plugin.
4. Open WooCommerce → Acumatica Connector.
5. Leave scheduled synchronization and automatic order export disabled until the onboarding tests are complete.

Connection

Open the Connection screen and enter the Acumatica endpoint details supplied for the dedicated integration account.

Use Test connection before saving the production workflow. A successful test confirms login and endpoint discovery; it does not enable synchronization or order export by itself.

Catalogue synchronization

The Catalogue Sync screen controls product matching, price and stock behavior, scheduling, and manual runs.

Matching model

The standard implementation matches:

WooCommerce product or variation SKU = Acumatica Inventory ID

Products without a matching SKU remain unchanged and are reported in the synchronization result.

Supported catalogue data

• Base product price.
• Stock quantity using the agreed Acumatica availability field.
• Customer price-class records.
• Simple products and product variations.

Manual and scheduled runs

The first synchronization is always run manually during onboarding. After validation, scheduled runs can use Action Scheduler where available, with WP-Cron as a fallback.

Customer pricing

The Customer Pricing screen maps WooCommerce user roles to Acumatica customer price classes.

For example:

Imported class prices are indexed locally so storefront price requests do not require a live ERP API request. The connector applies the resolved price to product displays, variation data, cart calculations, and checkout totals.

Page caching must vary by logged-in customer or role when customer-specific prices are displayed. QuixWP reviews the store’s caching configuration during onboarding.

Order export

The Order Export screen controls when WooCommerce orders are sent to Acumatica and which defaults are used for the SalesOrder payload.

Typical workflow

1. A WooCommerce order reaches the configured export status.
2. The connector resolves the Acumatica customer using the agreed customer-matching rule.
3. Line items are mapped by WooCommerce SKU / Acumatica Inventory ID.
4. Freight, unit, branch, and order-type defaults are applied.
5. The SalesOrder is created and the Acumatica reference is stored on the WooCommerce order.

Failure handling

Failed exports are recorded with a redacted error and retried automatically according to the connector policy. After correcting the underlying mapping or API issue, an administrator can retry the order manually from the plugin screen or the WooCommerce order interface.

Automatic order export remains disabled until a controlled test order has been reviewed and approved in Acumatica.

Logs and diagnostics

The Logs screen provides protected operational diagnostics for connection tests, synchronization runs, and order exports.

• Passwords and session cookies are never intentionally written to the diagnostic log.
• Common email and address fields are redacted.
• Logs are stored in a protected uploads location.
• Debug logging can be enabled temporarily during onboarding or support investigation.

Do not send API credentials through email or the website support form. QuixWP will arrange a secure credential exchange when access is required.

Licence and maintenance

The Licence screen records the directly issued QuixWP enterprise licence, maintenance status, expiry date, and support entitlement.

The annual maintenance renewal includes:

• Plugin updates and security fixes.
• Compatibility maintenance for supported WordPress, WooCommerce, PHP, and Acumatica versions.
• Connector support and diagnostic assistance.
• Access to new standard connector functionality released during the maintenance period.

When maintenance expires, the installed connector does not deliberately disable ongoing stock, pricing, or order operations. Updates and support remain unavailable until renewal.

Developer hooks

The connector exposes documented actions and filters following the QuixWP naming convention. Examples include synchronization lifecycle events, API request and response filters, pricing resolution filters, SalesOrder payload filters, and export result actions.

Custom work should be implemented through documented hooks or a separate integration module rather than editing the commercial plugin directly.

Troubleshooting

Connection test fails

• Confirm the base URL uses HTTPS and points to the correct Acumatica instance.
• Confirm tenant/company and branch values.
• Verify the dedicated API user can log in and access the required endpoint.
• Check whether a firewall, VPN, allowlist, or security service blocks the WordPress server.

Products are not matching

• Confirm the WooCommerce SKU exactly matches the Acumatica Inventory ID.
• Check both the parent product and variation SKUs.
• Review the latest synchronization result and protected log.

Customer-specific pricing is not visible

• Confirm the customer role is mapped to the intended Acumatica price class.
• Confirm a current class-price record exists for the product.
• Purge page and object caches, and ensure full-page caching varies by logged-in user or role.

An order failed to export

• Open Order Export and review the latest redacted error.
• Confirm every exported line has a matching Inventory ID.
• Confirm customer, branch, UOM, freight, tax, and order-type mappings.
• Correct the issue and use the manual retry action.

Support

For onboarding, compatibility, or technical support, use the Acumatica Connector support form. Include the WooCommerce version, Acumatica product/version, affected workflow, and the approximate time of the latest failure. Do not include passwords or API credentials.