Content Comparison

...

The setup process is as follows:

purchase Purchase PWS credits. Please refer to our FAQ section on how credit use works.
review Review your welcome email from our team which includes your username and password
visit Visit the PWS Dashboard and use your username and password. We recommend changing your password and checking that your usage credits are displayed correctly on the dashboard
work Work your way through the Integrating POSTman Web Services section

...

If an address cannot be corrected automatically using Australia Post’s AMAS rules, the operator will should be taken to a near matches list such as this one.

...

The SetLogin function is the first call made to the Postman KEngine to set the username and password. Other web methods are valid only if the user has set a valid username and password by calling this web method.

...

Parameter Name	Value	Description
username	string	DMS PWS username
password	string	DMS PWS password

Return Structure

The call to setLogin will return unique string which needs to be saved by the user for the further use.

...

Parameter Name	Value	Description
address1	string	First line of the address to search for
address2	string	Second line of the address to search for
address3	string	Third line of the address to search for
address4	string	4th line of the address to search for
address5	string	5th line of the address to search for
address6	string	6th line of the address to search for
Barcode	string	Barcode of the address to search for
BSP	string	BSP of the address to search for
BSPState	string	BSPState of the address to search for
DPID	string	DPID of the address to search for
postcode	string	Postcode of the address to search for
POBoxNo	integer	PoBox number of the address to search for
POBoxprifixPOBoxprefix	integer	PoBox perifix prefix of the address to search for
poBoxsuffix	integer	PoBox suffix of the address to search for
UnitNo	string	Number of the unit of the address to search for
unitType	string	Type of the unit of the address to search for
IsCorrectedAddress	boolean	Whether or not the address is corrected
IsValidAddress	boolean	Whether or not the address is valid
IsStreetAddress	boolean	Whether or not the address is an street address

...

Parameter Name	Value	Description
address1	string	First line of the address to search for
address2	string	Second line of the address to search for
address3	string	Third line of the address to search for
address4	string	4^th line of the address to search for
address5	string	5^th line of the address to search for
address6	string	6^th line of the address to search for
Barcode	string	Barcode of the address to search for
BSP	string	BSP of the address to search for
BSPState	string	BSPState of the address to search for
DPID	string	DPID of the address to search for
postcode	string	Postcode of the address to search for
POBoxNo	integer	PoBox number of the address to search for
POBoxprifixPOBoxprefix	integer	PoBox perifix prefix of the address to search for
poBoxsuffix	integer	PoBox suffix of the address to search for
UnitNo	string	Number of the unit of the address to search for
unitType	string	Type of the unit of the address to search for
IsCorrectedAddress	boolean	Whether or not the address is corrected
IsValidAddress	boolean	Whether or not the address is valid
IsStreetAddress	boolean	Whether or not the address is an street address

...

Parameter Name

Value

Description

sessionID

string

Has to set to the string returned by the setLogin

function

maxNumberOfMatches

integer

The maximum number of the returned recode records of possible addresses near or similar to the one just scanned

...

Parameter Name	Value	Description
address1	string	First line of the address to search for
address2	string	Second line of the address to search for
address3	string	Third line of the address to search for
address4	string	4th line of the address to search for
address5	string	5th line of the address to search for
address6	string	6th line of the address to search for
Barcode	string	Barcode of the address to search for
BSP	string	BSP of the address to search for
BSPState	string	BSPState of the address to search for
DPID	string	DPID of the address to search for
postcode	string	Postcode of the address to search for
POBoxNo	integer	PoBox number of the address to search for
POBoxprifixPOBoxprefix	integer	PoBox perifix prefix of the address to search for
poBoxsuffix	integer	PoBox suffix of the address to search for
UnitNo	string	Number of the unit of the address to search for
unitType	string	Type of the unit of the address to search for
IsCorrectedAddress	boolean	Whether or not the address is corrected
IsValidAddress	boolean	Whether or not the address is valid
IsStreetAddress	boolean	Whether or not the address is an street address

...

The call to CurrentBalance will return an XML packet with an integer value in it. This integer is your current balance which is decremented by 1 every time you use an address validation.

...

<html>
<head>
</head>
<body>
<title>Webservice PHP Invocation Testing</title>
<?php
//include NuSoap
require_once('lib/nusoap.php');
echo '<p>Hello DMS WS PHP Invocation Testing</p>';
//Soap call
$client = new
soapclient('httphttps://webservice.dmsw.com.au/postman/postman1.asmx?wsdl', 'wsdl');
//Error handling
$err = $client->getError();
if ($err) {
echo '<h2>Constructor error</h2><pre>' . $err . '</pre>';
}
echo '<p>Retrieve current balance:</p>';
//Stored input parameters in an array
$aryPara = array('myUsername'=>'UserName', 'myPassword'=>'PassWord');
// Call webmethod -- SetLogin of DMS webservice and retrieve a loginGUID
$loginGUID = $client->call('SetLogin',$aryPara);
//Call webmethod - CurrentBalance of DMS webservice
$CurrentBalancearry = array('sessionID'=>($loginGUID['SetLoginResult']));
$aryResult = $client->call('CurrentBalance', $CurrentBalancearry);
//print result
print_r($aryResult);
echo '<p>Address validation testing:</p>';
//stored input parameters in an array NOTICE: sessionID is not 'null' now, the value of
loginGUID should be set to sessionID
$aryAddr = array('sessionID'=> ($loginGUID['SetLoginResult']),'address1'=>' Park
Road ','address2'=> null,'address3'=>
null,'suburb'=>'milton','state'=>'qld','postcode'=>'4030','mixedCase'=>
true,'ExpandAbbreviations'=> true);

...

Version	Old Version 14	New Version Current
Changes made by	Posimente AJ	Darren Wright
Saved on	Nov 07, 2024	Feb 20, 2025

Versions Compared

Key