Troubleshooting Harvest
If users of your org report issues with Harvest, use the following guidelines. If the issues persists, please contact your Ascendix representative.
Before any troubleshooting activities, ensure that Enable email parsing is toggled ON and shows "Active". Click on Test connection to verify your key is valid.
1. API errors
Verify Agenforce license:
- is not expired or revoked
- org and user have respective permissions assigned
- try switching to another supported model (e.g., from GPT 5.2 to Anthropic Sonnet 4.6).
2. Slow responses
Try:
- a faster model (e.g. Gemini 3.8 Flash or GPT 5.5 instead of GPT 5.2).\
- lowering the Reasoning level.
3. Inaccurate results of the parsing
- increase model quality (e.g., Anthropic Opus 4.8 or Anthropic Sonnet 5.5 instead of GPT 5.2)\
- if only one user gets unexpected results, check that user's own model and parsing instruction on My Harvest Settings - their settings apply only to the emails they forward.\
- when a Record Request Set ends in Failed, open it and check the Fail Reason field — it captures the reason returned by the parser or downstream services and is your first stop before going to System Logs.
4. Apex Job error after clicking Autogenerate xRE Duplicate rules
If you see an error after clicking Autogenerate xRE Duplicate rules when no matching or duplicate rules from AscendixRE are present, click the button again — duplicate rules will be created on the second attempt.
5. No new entries in the System Logs tab
Harvest writes its logs through the Log platform event. Salesforce retires standard-volume platform events on 2026-12-15. In Setup → Platform Events → Log, check that the event type is high volume; if it is still standard volume, migrate it to high volume there.
6. Org Settings are read-only for an admin
If the Org Settings tab of the Harvest Admin Console shows "Org Settings are read-only because the "Ascendix Harvest Admin" permission set is not assigned to your user", assign the Ascendix Harvest Admin permission set to that admin in Setup → Users → Permission Set Assignments.