| All Verbs | /api/project/{ProjectId}/contacts |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ProjectId | query | Guid | No | Guid representing the object that is the project in Eros. |
| CustomerGroupId | query | Guid | No | Guid representing the projects contact customer group Id. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ProjectContacts | query | List<ProjectContact> | No | Object containing all details of the project to be inserted or updated. |
| CustomerContacts | query | List<ProjectContact> | No | Object containing all details of the project to be inserted or updated. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ContactId | query | Guid | No | Guid of the contact object within Eros. |
| ContactAlternateKey | query | string | Yes | The unique key that represents the contact on the external system. |
| RoleId | query | Guid | Yes | Guid of the Role List Item object within Eros. |
| RoleName | query | string | No | Role Name. |
| RoleAlternateKey | query | string | No | The unique key that represents the role type on the external system. Note: Use of this is not currently implemented |
| Contact | query | ContactModel | No | The object that contains details of the contact |
| Index | query | int | No | The order this contact is in priority. 1 would be the primary contact, 2 the secondary and so forth. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ContactId | body | Guid | No | Guid of the contact object within PSTPF. |
| ContactType | body | Guid | No | Guid of the Contact Type List Item object within PSTPF. |
| MaritalStatus | body | Guid? | No | Guid of the Marital Status List Item object within PSTPF. |
| Gender | body | Guid? | No | Guid of the Gender List Item object within PSTPF. |
| FirstName | body | string | No | The first given name for the contact. Applies to a person contact type. |
| MiddleName | body | string | No | The middle name(s) for the contact. Applies to a person contact type. |
| Surname | body | string | No | The surname for the contact. Applies to a person contact type. |
| FullName | body | string | No | The full name for the contact. |
| ShortName | body | string | No | A short name for the contact. |
| BirthDate | body | DateTime? | No | The birth date for the contact. Applies to a person contact type. |
| Title | body | string | No | The title for the contact. Applies to a person contact type. |
| Salutation | body | string | No | A salutation for the contact. |
| Abn | body | string | No | The A.B.N for the contact. |
| Acn | body | string | No | The A.C.N for the contact. |
| Arbn | body | string | No | The A.R.B.N for the contact. |
| TradingName | body | string | No | A trading name for the contact. |
| LegalName | body | string | No | A legal name for the contact. |
| Notes | body | string | No | Any notes/description for the contact. |
| EmploymentIndustry | body | string | No | Contact Employment Industry. |
| EmploymentRole | body | string | No | Contact Employment Role. |
| EmploymentGeographicArea | body | string | No | Contact Employment Geographic Area. |
| DriversLicence | body | string | No | The Contacts Drivers Licence Number |
| GstRegistered | body | bool | No | Indicates if the Contact is registered for GST |
| RecordStatus | body | string | No | The status of the contact in PSTPF |
| ContactRoles | body | List<ContactRole> | No | A list of roles this contact has. |
| ContactDetails | body | List<ContactDetailModel> | No | A list of the contact details for the contact. |
| CustomContentXML | body | string | No | Custom Content XML for the contact. |
| BlobImageURLPrimary | body | string | No | URL to the Primary Image. |
| BlobImageURLPrimaryThumbnail | body | string | No | URL to the Primary Image thumbnail. |
| PrimaryMobile | body | string | No | The primary mobile for the contact. |
| PrimaryEmail | body | string | No | The primary email for the contact. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| RoleId | body | Guid | No | Guid of the Role List Item object within PSTPF. |
| AlternateKey | body | string | No | The unique key that represents the role type on the external system. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ContactMethodId | body | Guid | No | Id of the Contact Method |
| ContactMethodName | body | string | No | Contact Method Name |
| ContactAddress | body | ContactAddressModel | No | If the contact method is an address, this will contain the address details. |
| ContactPhone | body | PhoneModel | No | If the contact method is a phone, this will contain the phone details |
| CountryId | body | Guid? | No | Id of the country |
| ContactDetails | body | string | No | A summary string representing the contact details |
| Notes | body | string | No | Notes about the contact details |
| ContactDetailsCode | body | string | No | Area Code if contact details are a phone number |
| OrderContactMethod | body | int | No | Order number of the contact method |
| IsPrimaryContactMethod | body | bool | No | True if this is the primary contact method |
| IsAddress | body | bool | No | True if this contact method is an address |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Address | body | AddressModel | No | Address Details |
| IsPostal | body | bool | No | True if this is a postal address. |
| IsPrimaryLocation | body | bool | No | True if this is the primary address. |
| IsRegisteredLocation | body | bool | No | True if this address is the registered tax address. |
| SuburbName | body | string | No | Suburb Name |
| StateName | body | string | No | State Name |
| CountryName | body | string | No | Country Name |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| DistanceAway | body | double | No | The distance between this project and another specified set of gps coordinates. |
| Latitude | body | Double? | No | The latitude of an address - geographic coordinates specifying the north-south position of a point on the Earth's surface. |
| Longitude | body | Double? | No | The longitude of an address - geographic coordinates specifying the east-west position of a point on the Earth's surface. |
| AddressFormatId | body | Guid | No | Address Format Id Guid - this will be determined by the service. |
| SuburbId | body | Guid | No | Suburb Id Guid - this will attempt to be determined by the SuburbName, StateShortName and Postcode entered. |
| SuburbName | body | string | No | The suburb name. |
| StateShortName | body | string | No | The shortened State Name e.g Vic for Victoria. |
| PostCode | body | string | No | The suburb postcode. |
| CountryId | body | Guid | No | Country Id Guid - this will be determined by the CountrName or ISOCountryCode entered. |
| CountryName | body | string | No | the name of the country the address is within. |
| ISOCountryCode | query | string | No | ISO Country Code. |
| LotNumber | body | string | No | The address Lot number. |
| SubUnit | body | string | No | The address Sub Unit number. |
| BuildingNumber | body | string | No | The address building number. |
| StreetNumber | body | string | No | The address street number. |
| StreetName | body | string | No | The address street name including street type. |
| AddressLineOne | body | string | No | A formatted address Line 1. |
| AddressLineTwo | body | string | No | A formatted address Line 2. |
| AddressFull | body | string | No | The full address string. |
| IsPhysical | body | bool? | No | True if the address is a physical location. |
| Notes | form | string | No | Notes about the address. |
| AutoMapCoordinates | body | bool? | No | If true, the address is eligible for having its coordinates calculated/updated. |
| LocationCoordinates | body | LocationCoordinates | No | Location Coordinates for the address. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Latitude | query | double | No | The latitude of an address - geographic coordinates specifying the north-south position of a point on the Earth's surface. |
| Longitude | query | double | No | The longitude of an address - geographic coordinates specifying the east-west position of a point on the Earth's surface. |
| Altitude | query | double? | No | The altitude of an address - the altitude above sea level." |
| Accuracy | query | double? | No | Accuracy of the latitude and longitude. |
| AltitudeAccuracy | query | double? | No | Accurancy of the Altitude. |
| Heading | query | double? | No | Direction you are heading. |
| Speed | query | double? | No | Speed you are going. |
| VerticalSpeed | query | double? | No | Speed your altitude is ascending/descending at. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| CountryCode | body | string | No | Country Code |
| AreaCode | body | string | No | Area Code |
| LocalNumber | body | string | No | Local Number |
To override the Content-type in your clients, use the HTTP Accept Header, append the .other suffix or ?format=other
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /api/project/{ProjectId}/contacts HTTP/1.1
Host: pfapi.pstpf.com.au
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length
{"ProjectId":"00000000-0000-0000-0000-000000000000","CustomerGroupId":"00000000-0000-0000-0000-000000000000"}
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length
{"ProjectContacts":[{"ContactId":"00000000-0000-0000-0000-000000000000","ContactAlternateKey":"String","RoleId":"00000000-0000-0000-0000-000000000000","RoleName":"String","RoleAlternateKey":"String","Contact":{"ContactId":"00000000-0000-0000-0000-000000000000","ContactType":"00000000-0000-0000-0000-000000000000","MaritalStatus":"00000000000000000000000000000000","Gender":"00000000000000000000000000000000","FirstName":"String","MiddleName":"String","Surname":"String","FullName":"String","ShortName":"String","BirthDate":"0001-01-01T00:00:00.0000000","Title":"String","Salutation":"String","Abn":"String","Acn":"String","Arbn":"String","TradingName":"String","LegalName":"String","Notes":"String","EmploymentIndustry":"String","EmploymentRole":"String","EmploymentGeographicArea":"String","DriversLicence":"String","GstRegistered":false,"RecordStatus":"String","ContactRoles":[{"RoleId":"00000000-0000-0000-0000-000000000000","AlternateKey":"String"}],"ContactDetails":[{"ContactMethodId":"00000000-0000-0000-0000-000000000000","ContactMethodName":"String","ContactAddress":{"Address":{"DistanceAway":0,"Latitude":0,"Longitude":0,"AddressFormatId":"00000000-0000-0000-0000-000000000000","SuburbId":"00000000-0000-0000-0000-000000000000","SuburbName":"String","StateShortName":"String","PostCode":"String","CountryId":"00000000-0000-0000-0000-000000000000","CountryName":"String","ISOCountryCode":"String","LotNumber":"String","SubUnit":"String","BuildingNumber":"String","StreetNumber":"String","StreetName":"String","AddressLineOne":"String","AddressLineTwo":"String","AddressFull":"String","IsPhysical":false,"Notes":"String","AutoMapCoordinates":false,"LocationCoordinates":{"Latitude":0,"Longitude":0,"Altitude":0,"Accuracy":0,"AltitudeAccuracy":0,"Heading":0,"Speed":0,"VerticalSpeed":0}},"IsPostal":false,"IsPrimaryLocation":false,"IsRegisteredLocation":false,"SuburbName":"String","StateName":"String","CountryName":"String"},"ContactPhone":{"CountryCode":"String","AreaCode":"String","LocalNumber":"String"},"CountryId":"00000000000000000000000000000000","ContactDetails":"String","Notes":"String","ContactDetailsCode":"String","OrderContactMethod":0,"IsPrimaryContactMethod":false,"IsAddress":true}],"CustomContentXML":"String","BlobImageURLPrimary":"String","BlobImageURLPrimaryThumbnail":"String","PrimaryMobile":"String","PrimaryEmail":"String"},"Index":0}],"CustomerContacts":[{"ContactId":"00000000-0000-0000-0000-000000000000","ContactAlternateKey":"String","RoleId":"00000000-0000-0000-0000-000000000000","RoleName":"String","RoleAlternateKey":"String","Contact":{"ContactId":"00000000-0000-0000-0000-000000000000","ContactType":"00000000-0000-0000-0000-000000000000","MaritalStatus":"00000000000000000000000000000000","Gender":"00000000000000000000000000000000","FirstName":"String","MiddleName":"String","Surname":"String","FullName":"String","ShortName":"String","BirthDate":"0001-01-01T00:00:00.0000000","Title":"String","Salutation":"String","Abn":"String","Acn":"String","Arbn":"String","TradingName":"String","LegalName":"String","Notes":"String","EmploymentIndustry":"String","EmploymentRole":"String","EmploymentGeographicArea":"String","DriversLicence":"String","GstRegistered":false,"RecordStatus":"String","ContactRoles":[{"RoleId":"00000000-0000-0000-0000-000000000000","AlternateKey":"String"}],"ContactDetails":[{"ContactMethodId":"00000000-0000-0000-0000-000000000000","ContactMethodName":"String","ContactAddress":{"Address":{"DistanceAway":0,"Latitude":0,"Longitude":0,"AddressFormatId":"00000000-0000-0000-0000-000000000000","SuburbId":"00000000-0000-0000-0000-000000000000","SuburbName":"String","StateShortName":"String","PostCode":"String","CountryId":"00000000-0000-0000-0000-000000000000","CountryName":"String","ISOCountryCode":"String","LotNumber":"String","SubUnit":"String","BuildingNumber":"String","StreetNumber":"String","StreetName":"String","AddressLineOne":"String","AddressLineTwo":"String","AddressFull":"String","IsPhysical":false,"Notes":"String","AutoMapCoordinates":false,"LocationCoordinates":{"Latitude":0,"Longitude":0,"Altitude":0,"Accuracy":0,"AltitudeAccuracy":0,"Heading":0,"Speed":0,"VerticalSpeed":0}},"IsPostal":false,"IsPrimaryLocation":false,"IsRegisteredLocation":false,"SuburbName":"String","StateName":"String","CountryName":"String"},"ContactPhone":{"CountryCode":"String","AreaCode":"String","LocalNumber":"String"},"CountryId":"00000000000000000000000000000000","ContactDetails":"String","Notes":"String","ContactDetailsCode":"String","OrderContactMethod":0,"IsPrimaryContactMethod":false,"IsAddress":true}],"CustomContentXML":"String","BlobImageURLPrimary":"String","BlobImageURLPrimaryThumbnail":"String","PrimaryMobile":"String","PrimaryEmail":"String"},"Index":0}]}