Module Navigation

Troubleshooting Acumatica Integration Error: Connector Configuration Missing or Invalid

Before Arcoro reads or writes a single record for an Acumatica connector, it checks that the connector is fully and correctly set up. It confirms that required connector fields are filled in, that the configured API version is properly formatted and supported, and that the default cash account and default payment method the connector points to actually exist in your Acumatica instance.

If any of these checks fail, Arcoro stops the sync immediately, before it touches any employee record. Because every entity in the sync (Employees, Departments, Pay Groups, and so on) uses the same connector setup, one failed check stops the entire run, not just one entity.

Most of these problems are fixed by editing the connector configuration in Arcoro. A few require checking a value against your live Acumatica instance.

Error Messages

Message textDirectionOccurs whenOutcomeFix
Acumatica Provider could not read the configuration setting '[connector setting name]'.BothThe named connector setting is blank. This message can name any of: Acumatica Service URL, Acumatica Tenant, Acumatica API ClientId, Acumatica API ClientSecret, Acumatica UserName, Acumatica Password, Default Payroll Payment Method, or API Minimum Version.Sync stopped. For the sign-in fields (ClientId, ClientSecret, UserName, Password) this always stops the sync immediately, before any record is processed.In Arcoro, open the connector and fill in the exact field named in the message.
The API Minimum Version has not been supplied.BothThe connector's API Minimum Version field is blank. This is the first setup check Arcoro runs, right after sign-in succeeds.Sync stopped. No records for any entity are processed.In Arcoro, open the connector and enter a value in the API Minimum Version field.
The API Version '[API Minimum Version value]' is not supported. The version must be properly formatted and greater than or equal to the minimum required version of '[minimum version Arcoro requires]'.BothThe connector's API Minimum Version, with periods removed, either does not parse as a number, or parses to a number lower than the minimum version Arcoro requires.Sync stopped. No records for any entity are processed.In Arcoro, correct the API Minimum Version field so it is formatted like the minimum version shown in the message and is not lower than it.
API version '[API Minimum Version value]' does not exist in this instance of Acumatica.BothArcoro asked your Acumatica instance for its list of API endpoint versions, and none of them matches the connector's API Minimum Version value exactly.Sync stopped. No records for any entity were processed.Confirm your Acumatica instance which API version is actually available, then match the API Minimum Version field in Arcoro to that value.
This instance of Acumatica does not support the minimum API version of [minimum version Arcoro requires].BothArcoro asked your Acumatica instance for its list of API endpoint versions, and the version Arcoro itself requires as a floor is not among them. This check does not depend on what is entered in the connector.Sync stopped. No records for any entity are processed.Confirm with your Acumatica administrator whether that API version can be enabled or published on their instance. Escalate if it is not clear how to proceed.
Default Cash Account is missing from the connector properties. Add the required field to the connector and run the sync again.BothThe connector's Default Payroll Cash Account field is blank.Sync stopped. No records for any entity are processed.In Arcoro, open the connector and fill in the Default Payroll Cash Account field.
The default cash account '[cash account code]' does not exist in this instance of Acumatica.BothArcoro looked up the cash account code configured in the connector directly in your Acumatica instance, and no matching cash account was found.Sync stopped. No records for any entity are processed.Confirm the correct cash account code in your Acumatica instance, then correct the Default Payroll Cash Account field in Arcoro to match.
Default Payment Method is missing from the connector properties. Add the required field to the connector and run the sync again.BothThe connector's Default Payroll Payment Method field is blank.Sync stopped. No records for any entity are processed.In Arcoro, open the connector and fill in the Default Payroll Payment Method field.

Confirming the Error

  1. Open the sync execution for the affected Acumatica connector in the Arcoro sync history.
  2. Find the step for the Acumatica connector and open it. Because these checks run before any entity is processed, you may see the same failure repeated across every entity row in that step, or the step may stop before any entity rows appear at all.
  3. If entity rows are shown, check the counts in the columns labelled Errors, Warnings, Information, Failures, Added, Updated, and Unchanged. For this family of issues, expect Added, Updated, and Unchanged to be zero, because no record was ever read or written.
  4. Open the Errors list for the entity row (or the step-level failure detail if no entity rows appeared) and match the fixed part of the sentence against the Messages table above. Ignore the quoted value in the middle. For example, match on "does not exist in this instance of Acumatica" rather than the specific version or cash account code quoted in it.
  5. If you saw this while first setting up or editing the connector, rather than during a scheduled sync, the same message text can also appear as the result of the connector connection test, since the test runs the identical sign-in and setup checks before returning a result.

Resolving the Error

Missing Connector Setting (Acumatica Provider Could Not Read the Configuration Setting)

  1. In Arcoro, open the connector configuration for the affected Acumatica connector.
  2. Find the field named in the message text and enter a value. This is an Arcoro-side fix; no change is needed in Acumatica.
  3. Save the connector and run the sync again, or run the connector connection test, to confirm the message no longer appears.

API Minimum Version Not Supplied, or Improperly Formatted

  1. In Arcoro, open the connector configuration and check the API Minimum Version field.
  2. If it is blank, enter a value. If it is present but the message says it is not supported, reformat it to match the pattern shown in the message and make sure it is not lower than the minimum version shown.
  3. Save the connector and run the sync again, or run the connector connection test, to confirm the message no longer appears.

API Version Does Not Exist, or the Instance Does Not Support the Minimum Version

  1. These two both depend on what API versions your Acumatica instance actually exposes, not just what is typed into Arcoro.
  2. If the message says the configured version does not exist, confirm with their Acumatica administrator which API version their instance actually supports, then update the API Minimum Version field in Arcoro to match it exactly.
  3. If the message says the instance does not support Arcoro's own minimum required version, this is not something the connector setting can work around. Escalate so someone can confirm with the Acumatica administrator whether their instance can be updated or reconfigured to expose that version.
  4. Run the sync again, or run the connector connection test, to confirm the message no longer appears.

Default Cash Account Missing, or Not Found in Acumatica

  1. If the message says the field is missing, open the connector configuration in Arcoro and fill in the Default Payroll Cash Account field.
  2. If the message says the cash account does not exist, confirm the correct cash account code in your Acumatica instance, then correct the value in the Default Payroll Cash Account field in Arcoro so it matches exactly.
  3. Save the connector and run the sync again, or run the connector connection test, to confirm the message no longer appears.

Default Payment Method Missing

  1. In Arcoro, open the connector configuration and fill in the Default Payroll Payment Method field.
  2. Save the connector and run the sync again, or run the connector connection test, to confirm the message no longer appears.

When to Escalate

If any of the following occur, you may need to reach out to Arcoro support for additional assistance.

  • The message says your Acumatica instance does not support Arcoro's required minimum API version, and your Acumatica administrator is unsure how to enable or publish that version.
  • You corrected the named connector field, cash account code, or payment method, ran the sync or connection test again, and the same message still appears.
  • The sync log shows a different message than the eight covered in this article, even if it appears alongside one of these.
  • You cannot tell which connector field the message is pointing to, or the field named in the message does not appear anywhere in the connector's configuration screen.
Was this article helpful?
0 out of 0 found this helpful