365 business Address Validation
Troubleshooting
Messages and prompts from 365 business Address Validation with cause and solution for license, address validation, and initialization.
This page collects the messages shown by 365 business Address Validation for Microsoft Dynamics 365 Business Central. Messages are quoted exactly as Business Central displays them. Variable parts such as the service error text are replaced with "…".
Search for part of the message
Press Ctrl+F and enter a distinctive word from the message, for example "licensed" or "initialization".
License and authorization
| Message | Cause | Solution |
|---|---|---|
| "Address Validation is not properly licensed in your environment. Please sign up for a valid subscription and try again." | There is no valid license for Address Validation, and the 30-day trial period has either not started or already expired. | Start the trial period or sign up for a subscription. See Get started. |
| "The address validation could not be performed, due to an authorization error. Please check 365 business API Setup page and make sure your API Key is valid." | The stored API key of the 365 business API is invalid, blocked, or missing. | Open 365 business API Setup and check the API key. |
Address validation
| Message | Cause | Solution |
|---|---|---|
| "The current address does not contain enough information to validate the address information. Address, City and Post Code are required for validatation." | The Address, City, or Post Code fields are not completely filled in. | Complete the missing fields, and save the record again. |
| "Address verification failed due to the following error:…\ \Do you want to proceed without checking the address?" | The address validation service answered with an error, for example because of a timeout or an unreachable connection. | Choose Yes to save the record without validation, or No to correct the entry and try again. |
| "An error occured while processing your request.\ \Error Message: …" | The service answered the request with a technical error. | Note the error message. If the error occurs repeatedly, contact the Service Desk. |
| "The validation of the address failed.\No address could be found that matches the criteria." | The service did not find a match for the entered address, usually because the address is incorrect or unknown to the service. | Check the entry for typing errors. If the address is correct, mark it as validated manually (action Set Validated). See Manage address data. |
| "Record type … is not supported. Please contact your partner to add support for record …." | A third-party app or a web service call requested address validation for a table that is not supported. | Only use validation for Contact, Customer, Vendor, Alternative Address, Order Address, or Ship-to Address, or contact your partner. |
| "The address is already validated. Do you really want to validate the current address again?" | An address that is already validated was selected again for manual validation. | Choose Yes to validate again, or No to cancel. |
| "The address comparison could not be shown. The validated address has not been applied." | The comparison page could not be opened at runtime. | Repeat the action. If the error occurs again, contact the Service Desk. |
Notifications
| Message | Cause | Solution |
|---|---|---|
| "Address validation has suggested changes for the entered address." | The service found an address that differs from or completes the entered address. | Choose Show suggestion to compare the changes, or Always apply so future suggestions are applied without confirmation. See User settings. |
| "The following fields had to be shortened, due to field length restrictions: …" | A value returned by the service is longer than the target field in Business Central. | Choose Show details to compare the original and the shortened value, and adjust the field manually if needed. |
Initialization
| Message | Cause | Solution |
|---|---|---|
| "The address data initialization is currently being executed in a background session. During the execution there may be restrictions. Current progress: … % (… of … records)." | The address data initialization is running in the background. | Wait for it to finish, or open Show initialization to follow the progress. See Initialize address data. |
| "The address data initialization is not completed. Current progress: … % (… of … records). Until the initialization is completed, addresses may be validated more than once." | The initialization was started but has not finished yet. | Run the remaining batches. Until then, the same address can be sent to the service more than once. |
| "The address data initialization has been stopped, because at least one source table failed. Until the initialization is completed, addresses may be validated more than once." | At least one source table failed during the initialization. | Open Address Data Initialization, check the error message of the affected source table, and reset it. |
| "The address data initialization has not been executed yet. Until the initialization is completed, addresses may be validated more than once." | The initialization has not been started after installation. | Start the initialization with Initialize Address Data. |
| "The address data initialization has been scheduled and will be executed in a background session. Until the initialization is completed, addresses may be validated more than once." | The initialization is scheduled for a background session but has not started yet. | Wait for the scheduled run, or start a batch manually. |
Address not checked automatically
An address is not checked automatically when one of the following applies:
- Insert without a later change: Automatic validation only runs when an existing record is modified. If a record is created with a complete address and never changed afterward, for example through an API or web service insert, no validation takes place.
- Scope: The Address Validation Scope field excludes the current session, for example when the scope is limited to sessions with a user interface and the change happens without one, or the other way round. See How address validation works.
- Switch for the record type disabled: Automatic validation for the affected record type (for example Contact, Customer, Vendor) is switched off in the Address Validation Setup.
- Known address: The entered address matches an address that was already validated in the address directory. The service is not called again, and the existing address is applied unchanged. See Address directory.
See also
Last modified on