# Manage Address Verification Services

Accurate address information is essential for ensuring smooth and efficient operations in any business, particularly when it comes to order fulfillment and billing. XoroERP simplifies this process by allowing you to validate addresses entered in the system, ensuring that your shipments and invoices are sent to the correct and standardized locations. The **Manage Address Verification Services** module in XoroERP connects you to a service that automatically verifies and corrects addresses, reducing errors and improving overall efficiency.

After connecting to this service, you can validate the addresses in modules such as sales order, purchase order, invoice, bill, etc. where shipping and/or billing addresses are entered. 

### **Setting Up Address Verification Services**

The first step in the address validation process is to set up a verification service. XoroERP integrates with **PostGrid**, a reliable address verification service that ensures your addresses are accurate and standardized.

{% hint style="info" %}
To set up address verification service, go to **Menu > Utilities > Manage Address Verification Services**
{% endhint %}

In the Manage Address Verification Services module, click on the "Connect" button next to the PostGrid service. 

<figure><img src="/files/vRz9LSwRX2VvA3hdDFwM" alt=""><figcaption></figcaption></figure>

The Add PostGrid Account module will open. Here, you need to enter your PostGrid account name and the API Key provided by PostGrid. Once you’ve entered these details, click "Connect" to establish the connection to the service.&#x20;

<figure><img src="/files/FFens9uyn8PRGp6JvfB0" alt=""><figcaption></figcaption></figure>

After successfully connecting, your PostGrid account name will appear under the Active Services section.

<figure><img src="/files/6ubzZBuMef2wsULDMoFK" alt=""><figcaption></figcaption></figure>

#### **Managing Active Address Verification Services**

Once you’ve connected to PostGrid or any other address verification service, XoroERP offers a couple of options to manage these services effectively:

* **Set as Default**: If you have multiple accounts connected, this option allows you to set a default service that will be used for address verification across all relevant modules.
* **Delete**: If you no longer need a service, you can remove it from your active services list by clicking the "Delete" button.

<figure><img src="/files/LNp4POiavGZ1Ppl4K9j8" alt=""><figcaption></figcaption></figure>

### Validating Address

With the address verification service connected, you can validate addresses in various modules where shipping or billing addresses are entered, such as **Sales Order**, **Purchase Order**, **Invoice**, and **Bill**.

To validate an address:

1. Open any module that includes an address modal (e.g., Sales Order).
2. Edit to open the address modal.
3. Click on the **Validate** button.<br>

   <figure><img src="/files/K48iFine3YuAQ1EtCjPp" alt=""><figcaption></figcaption></figure>
4. A pop-up window will appear, displaying two sections:

   * **Original Address**: This shows the address as entered by the user.
   * **Suggested Address**: This shows the corrected address as suggested by the PostGrid service.

   <figure><img src="/files/HGFrn646CGGSSqvXJEBm" alt=""><figcaption></figcaption></figure>

Review the suggested address and select "Use Original" option to keep the original address. If the suggested address is correct, select the "Use Suggested" option to update your original entry with this verified address. This process ensures that all addresses within your system are accurate and formatted correctly, reducing the risk of errors in shipping and billing.

By utilizing the **Manage Address Verification Services** module, XoroERP enables businesses to maintain accurate address records, streamline their operations, and enhance customer satisfaction through reliable and error-free shipments and invoices.

### Address Verification in Uploads

XoroERP offers you the address verification ability when uploading sales and purchase orders. A new field labeled `AddressVerificationIdentifierCode`has been introduced in the Upload Sales Order and Upload Purchase Order templates.&#x20;

<figure><img src="/files/fKmElqN509YbEjAVxPa1" alt=""><figcaption></figcaption></figure>

This field is used to control how address verification is handled during the upload process. Users can enter the following values in this field:

* **10 - Do not Validate Address:** No address validation is performed.
* **20 - Validate Address with Warning:** The system will validate the address, and if any potential issues are found, it will display a warning. You can then choose to proceed with the order or make corrections.
* **30 - Validate Address with Error:** The system will validate the address, and if any errors are found, the upload will be rejected.

By using this field, users can customize the level of address validation required during the upload process, ensuring flexibility and control based on the specific needs of the business.

#### **Addressing Invalid Addresses**

To provide greater clarity, we've introduced an **"Invalid Address?"** column in both the Sales Order Centre and Purchase Order Centre. When an order is created through an upload or API, the `AddressVerificationIdentifierCode` field is set to 20 and an issue is found in the address, the column is marked with a checkmark. This visual cue helps users quickly identify orders with potential address issues that may need further review.

<figure><img src="/files/X17kn3P9bd9PxVcl8WcD" alt=""><figcaption></figcaption></figure>

#### **Removing Address Verification Errors:**

To enhance user convenience, a **"Remove Address Verification Error"** option is available in both the Sales Order Centre and Purchase Order Centre. This allows users to quickly address and resolve any address verification errors that may have occurred during the upload process.

{% hint style="info" %}
To remove the address verification error, go to the Centre > Options > Remove Address Verification Error
{% endhint %}

<figure><img src="/files/ELd4fYKYuKerWilCWdZ6" alt=""><figcaption></figcaption></figure>

This option allows you to override the address validation and proceed with the order, even if the system initially detected an issue with the address.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xorosoft.com/xoroerp-1/utilities/manage-address-verification-services.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.