The Complete WooCommerce and NetSuite Integration Checklist for 2026

Authentication Checklist

• OAuth 2.0 M2M configured (not TBA) for all new integration clients
• Client ID and secret stored in environment variables or a secrets manager — never in source code
• Token refresh logic implemented with 5-minute pre-expiry buffer
• Integration role has minimum required permissions — not Administrator
• Sandbox credentials separate from production credentials

Data Mapping Checklist

• Every WooCommerce product maps to a NetSuite item via a stored internal ID (not SKU string match)
• Variable product variations map to NetSuite Matrix Item child items (not parent)
• Customer email → NetSuite Customer matching via stored user meta — not email lookup on every order
• Multi-currency orders pass transaction currency and exchange rate to NetSuite (not just base currency)
• Tax amounts passed as pre-calculated values — NetSuite not set to recalculate (no double tax)
• Custom NetSuite segments (sales channel, product line) applied on every SO

Sync Logic Checklist

• Idempotency check on order creation — duplicate webhook does not create duplicate SO
• Full order lifecycle handled: created → processing → fulfilled → refunded
• Inventory sync uses incremental SuiteQL (lastModifiedDate filter) — not full catalog pull
• Webhook failure triggers retry queue with exponential backoff
• Subscription renewal orders matched to existing NetSuite Customer (not new customer per renewal)

Error Handling Checklist

• Rate limit (429) handled with retry and exponential backoff + jitter
• Governance limit error (SSS_USAGE_LIMIT_EXCEEDED) logged and job split — not retried immediately
• Failed sync attempts written to a dead-letter queue with enough context to replay
• Finance team notified of sync failures within 15 minutes (not just developers)

Testing Checklist

• Unit tests for all data transformation logic (no network calls, runs in CI)
• Integration tests against NetSuite sandbox (not production)
• Full lifecycle end-to-end test: place order → fulfil → refund → verify NetSuite records match
• WooCommerce update tested in staging before production deployment
• NetSuite update (2026.1, 2026.2) tested in sandbox before production

Monitoring Checklist

• Sync success rate tracked — alert if below 99% over 15 minutes
• Sync lag P95 tracked — alert if above 15 minutes
• Daily reconciliation: WooCommerce order count matches NetSuite SO count for same date
• Governance consumption per order trended — alert if rising more than 20% week-over-week
• Error classification dashboard: retryable vs fatal errors separated