> For the complete documentation index, see [llms.txt](https://docs.mastersoftgroup.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/australia-post-parcel-locker-plus-lookup-and-validation/guides/interchangeable-terms-for-australia-post-parcel-lockers.md).

# Interchangeable terms for Australia Post Parcel Lockers

This page details about the interchangeable terms for parcel lockers during lookup or validation.

## Configure Interchangeable Parcel Locker Terms

Terms for parcel locker can be configured using the file 'general\_au.properties' available in $HARMONY\_HOME/config/sub folder.

#### **Default terms listed in the file are as follows:**

<div align="left"><figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FXQ2sXVkzGElo3dDkdwIB%2Fimage.png?alt=media&amp;token=ad431992-c8a9-4850-b353-0cb58366767e" alt=""><figcaption></figcaption></figure></div>

#### **Adding additional interchangeable terms as follows:**

If a user is searching for a parcel locker address using the term 'Pcl Lkrs,' they will need to add this term to the properties file.

<div align="left"><figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FZCPnmLj0vGyDUMPTZ80o%2Fimage.png?alt=media&amp;token=3affa4f3-2626-4410-919d-550711b6670e" alt=""><figcaption></figcaption></figure></div>

You can add or modify terms in this file according to your requirements to ensure that users can search for parcel locker addresses using various terms.

### Sample to demonstrate the response of HRA [similar-addresses](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/australia-post-parcel-locker-plus-lookup-and-validation/australia-post-parcel-locker-plus-lookup.md) using the new term.

**API:**

<details>

<summary>POST <a href="http://localhost:8080/HRAWeb/hra/rest/au/address/similar-addresses">http://localhost:8080/HRAWeb/hra/rest/au/address/similar-addresses</a></summary>

</details>

<details>

<summary>Request: Input of 'PCL LKRS'</summary>

```json
{
  "option": {
    "source": "AUPOST",
    "top": "2"
  },
  "payload": {
    "fullAddress": "strathfield pcl lkrs"
  }
}
```

</details>

<details>

<summary>Response: Shows that 'Pcl lkrs' is interchangeable with 'Parcel Lockers' during lookup</summary>

```json
{
    "status": "SUCCESS",
    "messages": [],
    "payload": [
        {
            "fullAddress": "Aust Catholic Uni Strathfield Pcl Lkr, 25a Barker Rd, STRATHFIELD NSW 2135",
            "addressLine1": "25a Barker Rd",
            "addressLine2": "STRATHFIELD NSW 2135",
            "dpid": "98635762",
            "localityName": "STRATHFIELD",
            "postcode": "2135",
            "buildingName1": "Aust Catholic Uni Strathfield Pcl Lkr",
            "latitude": "-33.876703",
            "longitude": "151.078330",
            "id": "98635762_UPL",
            "attributes": {
                "address_line_1": "25a Barker Rd",
                "description": "Available 24x7",
                "id": "98635762_UPL",
                "name": "Aust Catholic Uni Strathfield Pcl Lkr",
                "record_type": "upl",
                "type": "UPL"
            }
        },
        {
            "fullAddress": "Strathfield Parcel Lockers, Shop 1 19 Everton Road, STRATHFIELD NSW 2135",
            "addressLine1": "Shop 1 19 Everton Road",
            "addressLine2": "STRATHFIELD NSW 2135",
            "dpid": "76897456",
            "localityName": "STRATHFIELD",
            "postcode": "2135",
            "buildingName1": "Strathfield Parcel Lockers",
            "latitude": "-33.871547",
            "longitude": "151.095547",
            "id": "76897456_UPL",
            "attributes": {
                "address_line_1": "Shop 1 19 Everton Road",
                "description": "Available 24/7",
                "id": "76897456_UPL",
                "location_description": "Parcel Locker is located outside main entrance to Post Shop",
                "name": "Strathfield Parcel Lockers",
                "record_type": "upl",
                "type": "UPL"
            }
        }
    ]
}
```

</details>

### Sample to demonstrate the response of [AupostValidation ](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/australia-post-parcel-locker-plus-lookup-and-validation/australia-post-parcel-locker-plus-validation.md)PDP using the new term.

**API:**

<details>

<summary>POST <a href="http://localhost:8080/HarmonyWS/rest/parseCustomerData">http://localhost:8080/HarmonyWS/rest/parseCustomerData</a></summary>

</details>

<details>

<summary>Request: Input of 'PCL LKRS'</summary>

```json
{
    "harmonyServiceConfig": {
        "role": "AupostValidationRole",
        "locale":"AUSTRALIA"
    },
    "parserInput": {
        "rawDataInput": {
            "address": {
                "value": "Strathfield pcl lkrs, Shop 1 19 Everton Road, STRATHFIELD NSW 2135"
            }
        }
    }
}

```

</details>

<details>

<summary>Response: Shows that 'Pcl lkrs' is interchangeable with 'Parcel Lockers' during validation</summary>

```json
{
    "ciqPartyDocument": {
        "addresses": [
            {
                "state": "NSW",
                "streetName": "Everton",
                "streetNumber": "19",
                "flatNumber": "1",
                "placeMajorName": "Strathfield Parcel Lockers",
                "addressQuality": 9,
                "gml": {
                    "geocodedPosition": "151.095547 -33.871547"
                },
                "addressLines": [
                    "Strathfield Parcel Lockers, Shop 1 19 Everton Road, STRATHFIELD NSW 2135"
                ],
                "addressLine": "Strathfield Parcel Lockers, Shop 1 19 Everton Road, STRATHFIELD NSW 2135",
                "postCode": "2135",
                "postalID": "76897456",
                "area": "STRATHFIELD",
                "flatType": "Shop",
                "streetType": "Road",
                "addressMessage": "POINT",
                "extraAttributes": {
                    "AddressLine1": "Shop 1 19 Everton Road",
                    "Type": "UPL",
                    "Description": "Available 24/7",
                    "LocationDescription": "Parcel Locker is located outside main entrance to Post Shop",
                    "RecordType": "upl",
                    "AddressQuality": "9",
                    "PostalID": "76897456",
                    "Id": "76897456_UPL",
                    "AddressMessage": "POINT",
                    "MatchedRule": "address",
                    "Name": "Strathfield Parcel Lockers"
                }
            }
        ],
        "pdpchangeContext": {},
        "options": {
            "exposeAttributes": "7"
        },
        "containedInParties": false,
        "locationInParties": 0
    }
}
```

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/australia-post-parcel-locker-plus-lookup-and-validation/guides/interchangeable-terms-for-australia-post-parcel-lockers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
