Create a higher education customer account

post

/fscmRestApi/resources/11.13.18.05/hedCustomerAccounts

Request

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
  • Linked Account Details
    Title: Linked Account Details
    Linked customer accounts are the in receivables customer accounts that are configured such that they can be used in student management.
  • Title: Party ID
    The unique identifier of the party the customer account is associated with. Party is a generic term covering both people and also entities like businesses, schools, branches of a government, and nonprofit organizations.
  • Title: Status Message
    Message providing information about the current status of accounts and account relationships of the user.
  • Tag Assignments
    Title: Tag Assignments
    Tag assignments track the attribute tags assigned to a person.
  • Title: Valid Relationship Indicator
    Indicates that both the proxy and student's customer accounts and the relationship between these accounts exist.
Nested Schema : Linked Account Details
Type: array
Title: Linked Account Details
Linked customer accounts are the in receivables customer accounts that are configured such that they can be used in student management.
Show Source
Nested Schema : Tag Assignments
Type: array
Title: Tag Assignments
Tag assignments track the attribute tags assigned to a person.
Show Source
Nested Schema : hedCustomerAccounts-linkedAccountDetails-item-post-request
Type: object
Show Source
  • Title: Customer Class Code
    The unique identifier of the customer class assigned to the customer account.
  • Title: Customer Profile Class ID
    Code indicating the account's customer profile class. Customer profile classes organize customer accounts into categories that reflect the needs of the deploying company.
  • Title: Default Indicator
    Indicates whether a customer account is the default account for a person. If true, Student Management automated processes will use the account when creating transactions. When false, the account can be viewed in Student Management but by default won't be used by automated processes.
  • Title: Description
    Description of the customer account.
  • Title: Payment Term ID
    The unique identifier of the payment term assigned to the customer account. Payment terms are used to calculate transaction due dates.
  • Title: Status Code
    The code that represents the status of a Receivables customer account. Valid values are A for Active or I for Inactive.
  • Title: Status Meaning
    The meaning of the status code. Valid values are Active and Inactive.
  • Title: Termination Date
    The date when a customer account is no longer available for use.
Nested Schema : hedCustomerAccounts-tagAssignments-item-post-request
Type: object
Show Source
  • Title: Request Action
    Maximum Length: 80
    Action to define if the object should be removed.
  • Title: Tag Code
    Maximum Length: 30
    The code that identifies a tag assigned to a financial account.
  • Title: Tag ID
    The unique identifier for the tag assigned to a financial account.
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 : hedCustomerAccounts-item-response
Type: object
Show Source
  • Title: Email Address
    Read Only: true
    Maximum Length: 320
    The email address for the party.
  • Linked Account Details
    Title: Linked Account Details
    Linked customer accounts are the in receivables customer accounts that are configured such that they can be used in student management.
  • Links
  • Title: Other Accounts
    Read Only: true
    The number of customer accounts assigned to the party. When the number is greater than zero, the party has accounts in Receivables that won't be visible from or used by Student Management.
  • Title: Party ID
    The unique identifier of the party the customer account is associated with. Party is a generic term covering both people and also entities like businesses, schools, branches of a government, and nonprofit organizations.
  • Title: Party Name
    Read Only: true
    Maximum Length: 360
    The name of the party the customer account is associated with. Party is a generic term covering both people and also entities like businesses, schools, branches of a government, and nonprofit organizations.
  • Title: Party Type Code
    Read Only: true
    Maximum Length: 30
    Code for the type of party the customer account is associated with. Valid values are Person and Organization. Organizations are entities like businesses, schools, charities, branches of a government, or similar.
  • Title: Party Type Meaning
    Read Only: true
    Maximum Length: 80
    Meaning for the party type code the customer account is associated with. Valid values are Person and Organization. Organizations are entities like businesses, schools, charities, branches of a government, or similar.
  • Title: Status Message
    Message providing information about the current status of accounts and account relationships of the user.
  • Tag Assignments
    Title: Tag Assignments
    Tag assignments track the attribute tags assigned to a person.
  • Title: Valid Relationship Indicator
    Indicates that both the proxy and student's customer accounts and the relationship between these accounts exist.
Nested Schema : Linked Account Details
Type: array
Title: Linked Account Details
Linked customer accounts are the in receivables customer accounts that are configured such that they can be used in student management.
Show Source
Nested Schema : Tag Assignments
Type: array
Title: Tag Assignments
Tag assignments track the attribute tags assigned to a person.
Show Source
Nested Schema : hedCustomerAccounts-linkedAccountDetails-item-response
Type: object
Show Source
  • Title: Account ID
    Read Only: true
    The unique identifier for a Receivables customer account.
  • Title: Account Number
    Read Only: true
    The number that identifies a customer account.
  • Title: Account Type Code
    Read Only: true
    Code indicating the type of customer account.
  • Title: Account Type Meaning
    Read Only: true
    Maximum Length: 255
    Meaning of the customer account type code.
  • Title: Customer Class Code
    The unique identifier of the customer class assigned to the customer account.
  • Title: Customer Class Meaning
    Read Only: true
    Maximum Length: 255
    The meaning of the customer class assigned to the customer account.
  • Title: Customer Profile Class ID
    Code indicating the account's customer profile class. Customer profile classes organize customer accounts into categories that reflect the needs of the deploying company.
  • Title: Customer Profile Class Name
    Read Only: true
    Maximum Length: 255
    The name of the account's customer profile class. Customer profile classes organize customer accounts into categories that reflect the needs of the deploying company.
  • Title: Default Indicator
    Indicates whether a customer account is the default account for a person. If true, Student Management automated processes will use the account when creating transactions. When false, the account can be viewed in Student Management but by default won't be used by automated processes.
  • Title: Deletable Indicator
    Read Only: true
    Indicates whether a customer account can be deleted using Student Management.
  • Title: Description
    Description of the customer account.
  • Title: Establishment Date
    Read Only: true
    The date when a customer account is set up or becomes valid.
  • Links
  • Title: Payment Term ID
    The unique identifier of the payment term assigned to the customer account. Payment terms are used to calculate transaction due dates.
  • Title: Payment Term Name
    Read Only: true
    Maximum Length: 255
    The name of the payment term assigned to the customer account. Payment terms are used to calculate transaction due dates.
  • Title: Status Code
    The code that represents the status of a Receivables customer account. Valid values are A for Active or I for Inactive.
  • Title: Status Meaning
    The meaning of the status code. Valid values are Active and Inactive.
  • Title: Termination Date
    The date when a customer account is no longer available for use.
Nested Schema : hedCustomerAccounts-tagAssignments-item-response
Type: object
Show Source
  • Links
  • Title: Request Action
    Maximum Length: 80
    Action to define if the object should be removed.
  • Title: Tag Assignment ID
    Read Only: true
    The unique identifier for the assignment of a tag to a financial account.
  • Title: Tag Code
    Maximum Length: 30
    The code that identifies a tag assigned to a financial account.
  • Title: Tag ID
    The unique identifier for the tag assigned to a financial account.
  • Title: Tag Name
    Read Only: true
    Maximum Length: 64
    The name of a tag assigned to a financial account.
Back to Top