addPartyAddress
- Description
- This transaction adds an address type and the corresponding address for a given Party.
- Web Services
- Operation name: addPartyAddress
- Example
- Add a home address, a business address, a mailing address, and others for a Party.
- Usage information
- You can associate multiple active addresses of any type with a
Party. The address, address usage type, and start date combination
must be unique.
Address information includes detailed address data such as residence number, street name, city, province/state, country, and more.
An address is considered to be active if it contains no end date, or an end date greater than the current date. An address is considered inactive if the end date is less than or equal to the current date.
An address can be registered as seasonal, such as a Summer address, that is only valid during the effective dates provided. Addresses occur only once in the database, so if the address already exists, then the Party is associated to that address through this transaction.
Address types are user-definable through a code table.
- Preconditions
- Party must exist.
- Mandatory input
- PartyId
- AddressUsageType
- AddressLineOne
- City
- ProvinceStateType
- ZipPostalCode
- Inquiry levels
- Not applicable
- Filter values
- Not applicable
- Transaction behavior
- If the address already exists in InfoSphere® MDM,
it is not added; the ID of the existing address is returned in the
response.
If the address does not exist in InfoSphere MDM and the address standardization override indicator is not set to Y, the address is formatted, validated, and added (provided that address standardization is ON).
Multiple records of the same address and address usage type for the same Party can exist, each with a different start date.
If the start date is not supplied, the current system date is used by default.
Restriction: Address notes cannot be added to a party address object (TCRMPartyAddressBObj or TCRMAddressBObj) as part of an addPartyAddress transaction. You must use the addAddressNote transaction for this function. - Request message
- <TCRMTxType> addPartyAddress
<TCRMTxObject> TCRMPartyAddressBObj
<TCRMObject> TCRMPartyAddressBObj
with associated TCRMAddressBObj
- Response objects
- TCRMPartyAddressBObj
with associated TCRMAddressBObj
- Special note
- Not applicable