Update an account contact

patch

/crmRestApi/resources/11.13.18.05/accounts/{PartyNumber}/child/AccountContact/{AccountContactId}

Request

Path Parameters
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
  • The unique alternate identifier for the account party. You can update the value if the profile option HZ_GENERATE_PARTY_NUMBER is set to True. The default value is a concatenation of the value specified in the profile option ZCA_PUID_PREFIX and a unique system generated sequence number. Inactive records can't be updated.
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Account Party ID
    The primary key identifier of the object in this relationship. Either one of ObjectPartyId, ObjectPartyNumber, and combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship.
  • Title: Account Party Number
    Maximum Length: 30
    The public unique identification number for the object party of the relationship. One of ObjectPartyId, ObjectPartyNumber, and a combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship.
  • Title: Account Source System
    The name of external source system for the object party in the relationship, which are defined by an administrator as part of system setup. One of ObjectPartyId, ObjectPartyNumber, and a combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship. The value for this attribute should be predefined using the setup task Manage Trading Community Source Systems.
  • Title: Account Source System Reference
    The identifier for the object party in the relationship from external source system. One of ObjectPartyId, ObjectPartyNumber, and a combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship.
  • Title: Comments
    Maximum Length: 2000
    The comments of the user.
  • Title: Contact Number
    Maximum Length: 30
    The user-defined identification number for this contact.
  • Title: Contact Party Number
    Maximum Length: 30
    The public key identifier for the subject party of the relationship. One of SubjectPartyId, SubjectPartyNumber, and a combination of SubjectSourceSystem and SubjectSourceSystemReferenceValue, is used to identify the subject party of the relationship.
  • Title: Contact Source System
    The name of external source system for the subject party in the relationship, which are defined by an administrator as part of system setup. One of SubjectPartyId, SubjectPartyNumber, and a combination of SubjectSourceSystem and SubjectSourceSystemReferenceValue, is used to identify the subject party of the relationship. The value for this attribute should be predefined using the setup task Manage Trading Community Source Systems.
  • Title: Contact Source System Reference
    The identifier for the subject party in the relationship from external source system. One of SubjectPartyId, SubjectPartyNumber, and a combination of SubjectSourceSystem and SubjectSourceSystemReferenceValue, is used to identify the subject party of the relationship.
  • Title: Decision Maker
    Maximum Length: 1
    Default Value: false
    Indicates whether this contact is a decision maker. The values are Y for a decision maker, N for someone who's not the decision maker.
  • Title: Department
    Maximum Length: 60
    The free form text used to name the department for the contact.
  • Title: Department Code
    Maximum Length: 30
    The value of the department code for the contact.
  • Title: Influence Level
    Maximum Length: 30
    The contact's level of influence in the buying process.
  • Title: Job Title
    Maximum Length: 100
    The free form text for job title for the contact associated to an account.
  • Title: Job Title Code
    Maximum Length: 30
    The value of the code for the job title of the contact person.
  • Title: Preferred Contact
    Maximum Length: 10
    Default Value: false
    Indicates whether this contact person is primary contact for the customer. Accepted values are Y and N. Default value is N.
  • Title: Primary Customer
    Maximum Length: 10
    Default Value: false
    Indicates whether this customer is primary customer for the contact. Accepted values are Y and N. Default value is N.
  • Title: Reference
    Maximum Length: 1
    Default Value: false
    Indicates if this contact can be used as a reference. The values are Y for a contact who will act as a reference, N for a contact who can't act as a reference.
  • Title: Relationship Source System
    The name of external source system for the relationship, which is defined by an administrator as part of system setup. One of ObjectPartyId, ObjectPartyNumber, and a combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship. The value for this attribute should be predefined using the setup task Manage Trading Community Source Systems.
  • Title: Relationship Source System Reference
    The identifier for the relationship with the external source system.
  • Title: Affinity
    Maximum Length: 30
    The contact's affinity for the deploying organization.
  • Title: Affinity Comments
    Maximum Length: 2000
    The comments describing the contact's affinity for the deploying organization.
  • Title: Buying Role
    Maximum Length: 30
    The contact's role in the buying process.
  • Maximum Length: 1
    Default Value: A
    Indicates whether this is an active or inactive relationship. The values are A for active, I for inactive. This is an internal column and you're not expected to pass in a value. A list of valid values is defined in the lookup HZ_STATUS. You can review and update the codes using the Setup and Maintenance work area, Manage Standard Lookups task. Default value is A.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : accounts-AccountContact-item-response
Type: object
Show Source
  • Title: Account Contact ID
    Read Only: true
    The unique identifier of the account contact.
  • Title: Account Party ID
    The primary key identifier of the object in this relationship. Either one of ObjectPartyId, ObjectPartyNumber, and combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship.
  • Title: Account Party Number
    Maximum Length: 30
    The public unique identification number for the object party of the relationship. One of ObjectPartyId, ObjectPartyNumber, and a combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship.
  • Title: Account Source System
    The name of external source system for the object party in the relationship, which are defined by an administrator as part of system setup. One of ObjectPartyId, ObjectPartyNumber, and a combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship. The value for this attribute should be predefined using the setup task Manage Trading Community Source Systems.
  • Title: Account Source System Reference
    The identifier for the object party in the relationship from external source system. One of ObjectPartyId, ObjectPartyNumber, and a combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship.
  • Title: Comments
    Maximum Length: 2000
    The comments of the user.
  • Title: First Name
    Read Only: true
    Maximum Length: 150
    The first name of the contact record.
  • Title: Last Name
    Read Only: true
    Maximum Length: 150
    The last name of the contact record.
  • Title: Contact Last Update Date
    Read Only: true
    The date when the contact record was last updated.
  • Title: Name
    Read Only: true
    Maximum Length: 360
    The name of the contact.
  • Title: Contact Number
    Maximum Length: 30
    The user-defined identification number for this contact.
  • Title: Contact Party ID
    The primary key identifier of the subject in this relationship. Either one of SubjectPartyId, SubjectPartyNumber, and a combination of SubjectSourceSystem and SubjectSourceSystemReferenceValue, is used to identify the subject party of the relationship.
  • Title: Contact Party Number
    Maximum Length: 30
    The public key identifier for the subject party of the relationship. One of SubjectPartyId, SubjectPartyNumber, and a combination of SubjectSourceSystem and SubjectSourceSystemReferenceValue, is used to identify the subject party of the relationship.
  • Title: Contact Source System
    The name of external source system for the subject party in the relationship, which are defined by an administrator as part of system setup. One of SubjectPartyId, SubjectPartyNumber, and a combination of SubjectSourceSystem and SubjectSourceSystemReferenceValue, is used to identify the subject party of the relationship. The value for this attribute should be predefined using the setup task Manage Trading Community Source Systems.
  • Title: Contact Source System Reference
    The identifier for the subject party in the relationship from external source system. One of SubjectPartyId, SubjectPartyNumber, and a combination of SubjectSourceSystem and SubjectSourceSystemReferenceValue, is used to identify the subject party of the relationship.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the row.
  • Title: Created by Application
    Maximum Length: 30
    Default Value: HZ_WS
    The application module that created the record. It's defaulted to value HZ_WS for all web service based creation. A list of valid certification level codes is defined in the lookup HZ_CREATED_BY_MODULES. You can review and update the codes using the Setup and Maintenance task, Manage Trading Community Common Lookups.
  • Title: Creation Date
    Read Only: true
    The date and time when the row was created.
  • Title: Decision Maker
    Maximum Length: 1
    Default Value: false
    Indicates whether this contact is a decision maker. The values are Y for a decision maker, N for someone who's not the decision maker.
  • Title: Department
    Maximum Length: 60
    The free form text used to name the department for the contact.
  • Title: Department Code
    Maximum Length: 30
    The value of the department code for the contact.
  • Title: OK to Call
    Read Only: true
    Maximum Length: 10
    Default Value: false
    Indicates whether the user can call the contact of an account. The accepted values are True and False or Y and N. Default is False or N.
  • Title: OK to Email
    Read Only: true
    Maximum Length: 10
    Default Value: false
    Indicates whether the user can email the contact of an account. The accepted values are True and False or Y and N. Default is False or N.
  • Title: Do Not Call
    Read Only: true
    Maximum Length: 255
    Default Value: false
    Indicates whether you can call the account contact. The accepted values are True and False or Y and N. Default is False or N.
  • Title: Do Not Email
    Read Only: true
    Maximum Length: 255
    Default Value: false
    Indicates whether you can email the account contact. The accepted values are True and False or Y and N. Default is False or N.
  • Title: Primary Email
    Read Only: true
    Maximum Length: 320
    The e-mail address of the contact person for the account.
  • Title: Email Verification Date
    Read Only: true
    The date of the verification for the email.
  • Title: Email Verification Status
    Read Only: true
    The status of the verification for email. Accepted values are defined in the standard lookup type ORA_HZ_VALIDATION_STATUS as ORA_VALID, ORA_INVALID and ORA_PARTIALLY_VALID. Default value is blank which indicates that values are not verified.
  • Title: Address
    Read Only: true
    The formatted address of the contact.
  • Title: Phone Number
    Read Only: true
    The primary formatted phone number for the contact person.
  • Title: Influence Level
    Maximum Length: 30
    The contact's level of influence in the buying process.
  • Title: Job Title
    Maximum Length: 100
    The free form text for job title for the contact associated to an account.
  • Title: Job Title Code
    Maximum Length: 30
    The value of the code for the job title of the contact person.
  • Title: Last Updated Date
    Read Only: true
    The date and time when the record was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the record.
  • Title: Last Update Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the row.
  • Links
  • Title: Buying Role
    Read Only: true
    Maximum Length: 30
    Describes a contact's role in a buying relationship. Sample values are key decision maker, supporting decision maker.
  • Title: Contact Job Title
    Read Only: true
    Maximum Length: 100
    The title of the contact's job with deploying organization.
  • Title: Affinity
    Read Only: true
    Maximum Length: 30
    The contact's affinity for the deploying organization.
  • Title: Phone Verification Date
    Read Only: true
    The date of the verification for phone.
  • Title: Phone Verification Status
    Read Only: true
    The status of the verification for phone. Accepted values are defined in the standard lookup type ORA_HZ_VALIDATION_STATUS as ORA_VALID and ORA_INVALID. Default value is blank which indicates that values are not verified.
  • Title: Preferred Contact
    Maximum Length: 10
    Default Value: false
    Indicates whether this contact person is primary contact for the customer. Accepted values are Y and N. Default value is N.
  • Title: Preferred Contact Method
    Read Only: true
    The person's or organization's preferred contact method.
  • Title: Primary Customer
    Maximum Length: 10
    Default Value: false
    Indicates whether this customer is primary customer for the contact. Accepted values are Y and N. Default value is N.
  • Title: Reference
    Maximum Length: 1
    Default Value: false
    Indicates if this contact can be used as a reference. The values are Y for a contact who will act as a reference, N for a contact who can't act as a reference.
  • Title: Relationship Id
    Read Only: true
    The unique identifier of the relationship associated with account contact record.
  • Title: Relationship Record ID
    Finds an account contact with the relationship record identifier.
  • Title: Relationship Source System
    The name of external source system for the relationship, which is defined by an administrator as part of system setup. One of ObjectPartyId, ObjectPartyNumber, and a combination of ObjectSourceSystem and ObjectSourceSystemReferenceValue, is used to identify the object party of the relationship. The value for this attribute should be predefined using the setup task Manage Trading Community Source Systems.
  • Title: Relationship Source System Reference
    The identifier for the relationship with the external source system.
  • Title: Affinity
    Maximum Length: 30
    The contact's affinity for the deploying organization.
  • Title: Affinity Comments
    Maximum Length: 2000
    The comments describing the contact's affinity for the deploying organization.
  • Title: Buying Role
    Maximum Length: 30
    The contact's role in the buying process.
  • Maximum Length: 1
    Default Value: A
    Indicates whether this is an active or inactive relationship. The values are A for active, I for inactive. This is an internal column and you're not expected to pass in a value. A list of valid values is defined in the lookup HZ_STATUS. You can review and update the codes using the Setup and Maintenance work area, Manage Standard Lookups task. Default value is A.
Back to Top