Companies can be registered with greenID via Web Services in a similar manner to individuals.
Overview
The registerCompany web service
- customerId
- clientId (your unique ID for the company/fund)
- password (web service password)
- ruleId (default)
- clientType (blank or SMSF - see further info below)
- abn or acn
- companyName (eg Fund X)
- state (state of company/fund registration)
About the clientType and how it affects which sources are checked
If you register with a clientType set to anything other than "SMSF" (or alternately don't send down a clientType) then the organisation is treated as a company and two "non-consent" checks are performed. The entity is checked against the ASIC and ABR sources. If no match is found via these non-consent sources, then a POST to the start page can be performed to allow the details to be tweaked to achieve a match via the user-centric versions of the ASIC and ABR sources.
If the clientType is "SMSF" the organisation is registered as a self managed super fund and no non-consent checks are performed (we currently don't have a non-consent version of the super fund lookup). The user-centric SMSF source must be used, and so a POST must be done to the start page as below.
POSTing to the start page
- returnUrl
- cancelUrl
- customerId
- timeoutUrl
- exceptionUrl
- clientId
The sources
Security Options
Unlike the individual registration Web Service methods, the company registration Web Service methods only use Password authentication.
WSDL Locations
The test environment WSDLs for the company registration methods described below are at the following locations:
https://test.edentiti.com/Registrations-Registrations/CompanyVerificationServicesPassword?wsdl
The production environment WSDLs for the company registration methods described below are at the following locations:
https://www.edentiti.com/Registrations-Registrations/CompanyVerificationServicesPassword?wsdl
Methods
There are two methods that can be used to register a company with greenID:
- registerCompany
- registerCompanySimpleAddress
One of these methods must be called as the first step when verification of a company is required. This method establishes a registration with GreenID that can be used as the basis of further checks.
The registerCompany Method
Method Signature
public RichVerificationResult registerCompany ( String customerId, String password, String clientId, String ruleId, String clientType, String abn, String acn, String companyName, String state, String postcode, String email, String phone, String fax, NameValuePair[] extraData)
Parameters
Name | Type | Required? | Description | Contact |
---|---|---|---|---|
customerId | String | Yes | This parameter is GreenID's identifier for the client application. The value is supplied by GreenID, and must be included with each registration request. | Must be a valid identifier issued by GreenID. |
password | String | Yes | ||
clientId | String | Yes | An identifier for the company being registered, supplied by the customer, i.e. it is your identifier for the company being registered, not GreenID's. | No restrictions. |
ruleId | String | Yes | Specifies the predefined verification rule that this registration will be run against. By default, every customer has at least the rule named "default". | Must be a string and must match a predefined rule string specified in the system. The default rule is named "default". |
clientType | String | Yes | ||
abn | String | Yes | The ABN of the company being registered. | No restrictions. All spaces will be stripped prior to being stored. All non-digits are stripped prior to being used for verification purposes. |
acn | String | Yes | The ACN of the company being registered. | No restrictions. All spaces will be stripped prior to being stored. All non-digits are stripped prior to being used for verification purposes. |
companyName | String | Yes | The name of the company being registered. | Must be a string that is the valid legal name of the company or business entity being registered. |
state | String | Yes | The state in which the company is registered. | Must be one of:
|
postcode | String | Yes | The postcode compent of the company's address. | Must be a string comprising only four digits, i.e.: ^[\d]{4}$ |
String | Yes | The primay email contact for the company being registered. | Standard Hibernate validation is used. | |
phone | String | Yes | The primary phone contact for the company being registered. | No restrictions, although non-digits are stripped when used for verification checks. Please don't include country codes. |
fax | String | No | The primary fax contact number for the company being registered. | Same as for phone numbers. |
extraData | NameValuePair[] | No | This parameter allowc the customer to send extra thata that will need to be agreed upon before implementation. It will be a simple key/value format. If there is no previous agreement for certain keys to be send in this field, then it will be ignored. |
The registerCompanySimpleAddress Method
Method Signature
public RichVerificationResult registerCompany ( String customerId, String password, String clientId, String ruleId, String clientType, String abn, String acn, String companyName, SimpleAddress address, String email, String phone, String fax, NameValuePair[] extraData)
Parameters
Name | Type | Required? | Description | Contact |
---|---|---|---|---|
customerId | String | YesY | This parameter is GreenID's identifier for the client application. The value is supplied by GreenID, and must be included with each registration request. | Must be a valid identifier issued by GreenID. |
password | String | Yes | ||
clientId | String | Yes | An identifier for the company being registered, supplied by the customer, i.e. it is your identifier for the company being registered, not GreenID's. | No restrictions. |
ruleId | String | Yes | Specifies the predefined verification rule that this registration will be run against. By default, every customer has at least the rule named "default". | Must be a string and must match a predefined rule string specified in the system. The default rule is named "default". |
clientType | String | Yes | ||
abn | String | Yes | The ABN of the company being registered. | No restrictions. All spaces will be stripped prior to being stored. All non-digits are stripped prior to being used for verification purposes. |
acn | String | Yes | The ACN of the company being registered. | No restrictions. All spaces will be stripped prior to being stored. All non-digits are stripped prior to being used for verification purposes. |
companyName | String | Yes | The name of the company being registered. | Must be a string that is the valid legal name of the company or business entity being registered. |
address | SimpleAddress | Yes | ||
String | Yes | The primay email contact for the company being registered. | Standard Hibernate validation is used. | |
phone | String | Yes | The primary phone contact for the company being registered. | No restrictions, although non-digits are stripped when used for verification checks. Please don't include country codes. |
fax | String | No | The primary fax contact number for the company being registered. | Same as for phone numbers. |
extraData | NameValuePair[] | No | This parameter allows the customer to send extra thata that will need to be agreed upon before implementation. It will be a simple key/value format. If there is no previous agreement for certain keys to be send in this field, then it will be ignored. |
The SimpleAddress Type
Name | Type | Required? | Description | Contact |
---|---|---|---|---|
description | String | No | A description of the address. | Length <= 255 characters. |
address1 | String | Yes | Line 1 of an address. | Length <= 255 characters. |
address2 | String | No | Line 2 of an address | Length <= 255 characters. |
address3 | String | no | Line 3 of an address | Length <= 255 characters. |
address4 | String | No | Line 4 of an address | Length <= 255 characters. |
suburb | String | Yes | Suburb component of the address. | Length <= 255 characters. |
postcode | String | Yes | Postcode component of the address. | Must be a string comprising only four digits, i.e.: ^[\d]{4}$ |
state | String | Yes | State component of the address. | Must be one of:
|
country | String | Yes | Country component of the address. |
Return Value
The return values of the functions are both the same: both methods will return a RichVerificationResult object. This object is described in detail in the section on Outcome Notification, so the reader is referred to that section for more detail. In summary, the return value will indicate the current status of the company's registration, and the outcome of any checks that were performed automatically.
Faults
Either method may raise a FaultDetails, inside which can be the following codes:
- SystemFault