WooCommerce integration

Security. Transfer passwords, API keys, or other credentials only through the secure method provided by Hanna Customer Support. Never paste a secret into an email or support request body.

WooCommerce can send customers and orders to Hanna and synchronise Items in one or both directions.

Contacts and Items

Orders are assigned to Hanna Contacts. Hanna may match an existing Contact by company code, phone, or email. Item mapping can include name, description, price, weight, images, categories, and optionally stock. Agree which system is authoritative before enabling two-way updates.

Orders

An order can create an Opportunity or Invoice. An Opportunity can later convert into a Proforma Invoice or Invoice according to an agreed order status or Opportunity stage. Use a separate numbering sequence for store records.

Activation and testing

Create dedicated WooCommerce REST API credentials under WooCommerce → Settings → Advanced → REST API with only the permissions required. Transfer them through the secure method provided by Hanna Customer Support. Test new and returning customers, VAT, shipping, discounts, payment, status changes, and retries before production use.

Setup screens

The screens below follow the setup sequence described above. Labels may vary as providers update their interfaces.

Troubleshooting

Check account permissions, integration status, required fields, and the external system log. If the problem persists, send the attempt time, record or event identifier, and visible error to Hanna Customer Support, without credentials.