# Parcel Locker Plus

In the 2020/2021 period, over 46 million parcels were sent to collection points, offering parcel collect options that provide the delivery choices your customers expect.

### Successful delivery is paramount:

**49%** of customers surveyed by AustPost emphasized the importance of access to additional collection points.^[^1].

**73%** of consumers prefer knowing their parcel collection options before making a purchase.\*[^2]

**68%** of businesses highlight failed or late deliveries as a significant operational cost\*\*[^3]​

### Parcel Locker Plus - Collection Points

Parcel Locker Plus is updated monthly, encompassing the expanding collection point network. Collection points include:

* Parcel Lockers
* Licensed Post office
* Post Offices
* Post Office Agency
* Community Postal Agent
* Retail Annexa
* PostShop
* Delivery Annex
* Business Center

<figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FiUfgtAFoNyipJoLqJlSI%2Fimage.png?alt=media&#x26;token=f6379136-332b-457b-bff3-c14a20607870" alt=""><figcaption></figcaption></figure>

### Parcel Locker Plus - Sending Points

Parcel Locker Plus comprises locations where mail or packages can be sent, including roadside options such as red roadside mailboxes and Express Post mailboxes.

Sending points include:

* Red roadside mailboxes
* Express Post mailboxes

<figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FBPlRKCsuiQgoaxFzOEd0%2Fimage.png?alt=media&#x26;token=e274fc6d-da2c-44f1-b474-312c02a02cf3" alt=""><figcaption></figcaption></figure>

### How to access Parcel Locker Plus

Parcel locker plus is available in [Address Lookup & Validation](https://docs.mastersoftgroup.com/loqate-harmony-api/api-specification/address/address-validation-and-lookup) by setting either "sourceOfTruth" or "moreSources" to "AUPOST". Results are prioritised by the dataset listed in "sourceOfTruth".

If you only want to search with Parcel Locker Plus then only set "sourceOfTruth":"AUPOST" without anything within "moreSources"

### Filtering Parcel Locker Plus using addressTypeFilter

You are able to filter Parcel Locker Plus by using "addressTypeFilter" employing either inclusion or exclusion methods.&#x20;

Inclusion method is whereby you state what you want searched in the array "addressTypeFilter":"UPL" will only search within Parcel Lockers.&#x20;

Inclusion method involves specifying what you want searched in the array (eg. "addressTypeFilter":"UPL" will search only within Parcel Lockers)

Exclusion method, indicated by adding a "-", entails specifying what you want excluded (eg. "addressTypeFilter":"-UPL" will search everything except Parcel Lockers).

#### Common Use Cases:

**Collection Only:** You need to set the "addressTypeFilter": "-rspb, -cspb". This searches everything except the sending use cases.

**Sending Only:** You need to set the "addressTypeFilter": "rspb, cspb". This searches only the sending use cases.&#x20;

| Asset Type​ Code | Description                  |
| ---------------- | ---------------------------- |
| UPL​             | PARCEL LOCKER​               |
| LPO​             | LICENSED POST OFFICE​        |
| PO​              | POST OFFICE​                 |
| CPA​             | COMMUNITY POSTAL AGENT​      |
| RA​              | RETAIL ANNEXE​               |
| RP​              | POSTSHOP​                    |
| POA​             | POST OFFICE AGENCY​          |
| PO​              | POST OFFICE​                 |
| PDEP​            | DELIVERY ANNEX​              |
| BC​              | BUSINESS CENTRE​             |
| RSPB​            | RED STREET POSTING BOX​      |
| CSPB​            | COMBINED STREET POSTING BOX​ |

### Parcel Locker Plus request examples

<details>

<summary>Lookup Request: Address Lookup with Collection points only</summary>

```json
{
        "payload": [ { "country": "AU", "fullAddress": "parcel 3000 " } ], 
        "sourceOfTruth": "AUSOTS",
        "featureOptions": { "moreSources": "AUPOST","addressTypeFilter": "-rspb, -cspb"}
}
```

</details>

<details>

<summary>Lookup Request: Collection Only</summary>

This will show all options within "3000" search criteria eg mostly Melbourne postcode.

```json
{
        "payload": [ { "country": "AU", "fullAddress": "3000" } ], 
        "sourceOfTruth": "AUPOST",
        "featureOptions": { "addressTypeFilter": "-rspb, -cspb"}
    }
```

</details>

<details>

<summary>Lookup Request: Sending Only</summary>

This use case you would be telling customers where they can send something from.&#x20;

```json
{
        "payload": [ { "country": "AU", "fullAddress": "3000" } ], 
        "sourceOfTruth": "AUPOST",
        "featureOptions": { "addressTypeFilter": "rspb, cspb"}
    }
```

</details>

[^1]: ^2021 APO Deliver experience report

[^2]: \*APO 2022 Inside Australian Online Shopping eCommerce Industry Report

[^3]: \*\* Loqate fixing failed deliveries research
