Troubleshooting and Support

Resolve common issues and access support resources for the WooCommerce ERPNext Integration Plugin.

Troubleshooting Common Issues

Issue Type	Steps to Resolve
ERPNext Connection	Verify Host URL, API credentials, and SSL settings. Ensure ERPNext API is enabled.
WordPress/WooCommerce	Check plugin/theme compatibility, increase PHP memory limit (e.g., 512MB), verify database connectivity.
Sync Issues	Confirm cron jobs are running, validate field mappings, check permissions, ensure data formats match.
Performance	Adjust sync intervals, use batch processing, enable caching, optimize server resources.
Logs	Enable debug mode, review error logs, adjust log levels, implement log rotation.

Example: Connection Failure

• Error: Failed to connect to ERPNext.
• Steps:
  1. Verify Host URL includes https://.
  2. Regenerate API Key/Secret in ERPNext.
  3. Disable SSL verification temporarily to test.
  4. Check ERPNext server logs for blocked requests.

Support Resources

• Plugin Documentation: Access help sections in ERPNext Integration → Help.
• WordPress Codex: General WordPress troubleshooting.
• WooCommerce Docs: Store-specific issues.
• ERPNext Docs: API and configuration details.
• Community Support:
  • WordPress Forums
  • WooCommerce Community
  • ERPNext Community
• Plugin Support: Contact the developer via the plugin’s support channel.

Getting Help

For unresolved issues, provide the following to support:

• Plugin version
• WordPress/WooCommerce versions
• ERPNext version
• Error logs (from ERPNext Integration → Logs)
• Description of the issue and steps to reproduce