# Woocommerce Settings guide v2.0.0

Version: 2.0.0

Navigate to Plugins and click on settings... /wp-admin/plugins.php and find 'Loqate AU & NZ Address' plugin

### Step 1: Get your API Keys

Get your Loqate AU NZ API Keys from <https://hosted.mastersoftgroup.com/console/#/login>

We wrote a guide for getting your API keys.

{% content-ref url="/pages/VvdkGCL1SrmqLDqhO5il" %}
[Getting your API keys](/loqate-harmony-api/guides/console/getting-your-api-keys.md)
{% endcontent-ref %}

If you don't have a Loqate AU NZ account sign up here to free trial: <https://www.loqate.com/anz/register/>

### Step 2: Add your API Keys to Woocommerce V2 Plugin

Navigate to Plugins and click on settings... /wp-admin/plugins.php and find 'Loqate AU & NZ Address' plugin

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

Your API key is concatenated {user name}:{password}.&#x20;

For example if&#x20;

User Name = 'myuser' and password ='mypassword' then you enter <mark style="color:red;">myuser:mypassword.</mark> Don't forget the semi colin :

![](/files/Ic8VpIEeOxfIJNeDUT3k)

**Alright you should be all set to start using using our default performance checkout settings.**

## Optional Settings

### Address Layout Options

Address Layout modifies your checkout experience for your users. We have two options available Optimised or Default.

**Optimised** being single line address. This hides 5 address fields and shortens your overall checkout form. Its the recommended setting.

Insert the below code block for Optimised

```json
{ "layout": "DEFAULT" }
```

**Default** is Woocommerces standard checkout.

Insert the below code block for Default

```json
{ "layout": "DEFAULT" }
```

#### Checkout experience

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

### Address FeatureOptions

Address FeatureOptions is the API settings for our Address Lookup service. Our Address Lookup has a broad range of feature that you can optimise for your application.&#x20;

All of these settings we can configure for you in the backend meaning you don't have to update these settings yourself.&#x20;

Read about the featureOptions available here: <https://docs.mastersoftgroup.com/loqate-harmony-api/api-specification/address/address-validation-and-lookup#request>

#### Default setting

This shows 5 results, in Title Case and suppresses Lot information when street numbers are available.&#x20;

```json
{ "singleLineHitNumber": 5, "caseType": "TITLE", "displayGnafLot":1,"suppressLot":1 }
```

#### Add User Derived Address:&#x20;

Learn about [User Derived Address](/loqate-harmony-api/guides/user-derived-address.md)

```json
{ "userInferred": 1, "singleLineHitNumber": 5, "caseType": "TITLE", "displayGnafLot":1,"suppressLot":1 }
```

#### For International (not AU & NZ) regions (recommended)

Grouping addresses particularly in countries with large populations in multi dwelling premises. Recommended setting.

We don't apply grouping to AU & NZ country searches.

```json
{ "groupAddresses": "1", "singleLineHitNumber": 5, "caseType": "TITLE", "displayGnafLot":1,"suppressLot":1 }
```

#### Add AustPost Parcel Locker data

This will include Australia Post parcel lockers, post offices and post shops to delivery selection options.

```json
{ "moreSources": "AUPOST", "singleLineHitNumber": 5, "caseType": "TITLE", "displayGnafLot":1,"suppressLot":1 }
```

#### Add them all

We've only list some of the available featureOptions.&#x20;

Read about all the featureOptions available here: <https://docs.mastersoftgroup.com/loqate-harmony-api/api-specification/address/address-validation-and-lookup#request>

```json
{ "userInferred": 1, "groupAddresses": "1", "moreSources": "AUPOST", "singleLineHitNumber": 5, "caseType": "TITLE", "displayGnafLot":1,"suppressLot":1 }
```

### Address Data - Australia

Within Australia we have 3 datasets the you can use. Choosing the right dataset is critical. Contact us for advice.

AUPAF: Australia Post Postal Address File (Postal Certified)

GNAF: Geocoded National Address File (Physical addresses)

AUSOTS: Combined AUPAF & GNAF for highest coverage.

```json
// for GNAF
{ "sot": "GNAF" }
// for Australia Post
{ "sot": "AUPAF" }
// for Australia Post & GNAF combined
{ "sot": "AUSOTS" }
```

### Address Data - New Zealand

Within New Zealand we have 3 datasets the you can use. Choosing the right dataset is critical. Contact us for advice.

NZPAF: New Zealand Posts - Postal Address File (Postal Certified deliverable)

NZAD: New Zealand Posts - Address File (Physical addresses)

CNAR: Critchlow / National Map is Physical address file with improved Geocoding results.

```json
// for New Zealand Posts - Postal Address File (Postal Certified deliverable)
{ "sot": "NZPAF" }
// for New Zealand Posts - Address File (Physical addresses)
{ "sot": "NZAD" }
// for Critchlow / National Map
{ "sot": "CNAR" }
```

### Enhanced State/County/Region

Loqate is a global address experts.&#x20;

Ticking this box overrides Woocommerce representations of regional information and uses Loqates comprehensive collection of state/county/region or the equivalent.

For some regions syncing of Loqate data with Woocommerce lists of regions is not always possible. Enabling will overwrite with Loqate data.

### Business Lookup

Enable or disable the Business Lookup service. Business Lookup enables users to search for the business names, business or company numbers within the company field in checkout.&#x20;

&#x20;![](/files/4napuKFSRYoUleaiUSsa)

In checkout, reduce time in checkout, accurately capture business customers, know your business identifiers.

#### Checkout experience

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

#### Filter for Active Businesses

```json
{ 
"caseType": "TITLE", 
"hits": 5, 
"taxStatus": "ACT", 
"bnStatus": "", 
"state": [], 
"nameTypes": [] 
}
```

#### Filter for Active Businesses & Active tax registration&#x20;

<pre class="language-json" data-overflow="wrap"><code class="lang-json">{ 
<strong>"caseType": "TITLE", 
</strong>"hits": 5, 
"taxStatus": "ACT", 
"bnStatus": "ACT", 
"state": [], 
"nameTypes": [] 
}
</code></pre>

#### Filter by State

If only conducting business in a particular state you can filter your results.

```json
{ 
"caseType": "TITLE", 
"hits": 5, 
"taxStatus": "", 
"bnStatus": "", 
"state": ["VIC", "NSW"], 
"nameTypes": [] 
}
```

#### Display Main/Legal Entity Name

Main/legal entity name which might be different from the entity's alias name entered by user.

For example: You might know McDonalds the brand or a 'trading name'. Legal entity name is different and this option changes the information being displayed to legal entity names.&#x20;

### Email Validation

Enable or disable the Email Validation within the checkout experience.&#x20;

<div align="left"><figure><img src="/files/cUt8T0t54hCGLmgCpsnu" alt=""><figcaption></figcaption></figure></div>

#### Checkout experience

This displays the result of the validation to the end user. Results that are valid or indeterminate can proceed to the next step. Invalid email addresses are alerted within checkout enabling users to correct any issues they have.

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

#### Default Email Options

We recommend you keep the default configuration.

```json
{ "sot": "VE_ALL", "options": [ "FORMAT", "BLOCKLIST", "DOMAIN", "MAILSERVER", "MAILBOX" ] }
```

### Phone Validation

Enable or disable the phone validation.

<div align="left"><figure><img src="/files/buAWHmTxgwYjepvtMgUR" alt=""><figcaption></figcaption></figure></div>

Like email validation phone displays the result of the validation to the end user. Results that are valid or indeterminate can proceed to the next step. Invalid phone numbers are alerted within checkout enabling users to correct any issues they have.


---

# 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.mastersoftgroup.com/loqate-harmony-api/integrations/woocommerce-plugin/woocommerce-settings-guide-v2.0.0.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.