Create a payment plan

post

/fscmRestApi/resources/11.13.18.05/incentiveCompensationPaymentPlans

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.
  • Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Recovery Start Option
    Maximum Length: 1
    Default Value: false
    Indicates whether recovering draw amounts should be delayed for several months after being paid. Valid values are Y and N. If providing the value "Y" to enable delayed recovery, then provide the recovery start and optionally provide a recovery end. If providing the value "N", then the recovery starts immediately in the next subsequent payment. The default value is "N".
  • Title: Description
    Maximum Length: 1000
    A brief description of the payment plan.
  • Title: Draw End
    Maximum Length: 30
    The code indicating when the draw calculation for the participant should end. The value is used to determine the relative date after the payment plan assignment start date. Possible values are "-1", to stop the draw after 3 months, "-2", to stop the draw after 6 months, "-3", to stop the draw after 9 months, and "-4", to stop the draw after 12 months.
  • Title: End Date
    The date when the payment plan becomes inactive. The acceptable format is yyyy-mm-dd.
  • Title: Flat Minimum Amount to Pay Participant
    The minimum amount to pay the participant per the payment interval. The payment process creates a payment adjustment when the total earnings for the pay period are less than the minimum amount. This payment adjustment is often referred to as a draw or a guaranteed minimum.
  • Title: Maximum Payment
    The maximum amount to pay the participant for the payment interval. The payment process creates a payment adjustment when the total earnings for the pay period are more than the maximum amount. This payment adjustment is often referred to as a cap.
  • Title: Minimum Recovery
    Maximum Length: 1
    Default Value: true
    Indicates whether the draw amounts paid to the participant should be recovered in subsequent pay periods. When enabled, the payment process deducts from the payment of earnings over a period of time until the full draw amount is recovered. Valid values are Y and N. The default value is Y.
  • Title: Business Unit
    The unique identifier of the business unit to which the payment plan belongs. Review the business unit ID for a business unit using the Setup and Maintenance, Define Business Units task. If the Business Unit ID column is not displayed, then click the View menu to add the Business Unit ID column.
  • Title: Carry forward maximum
    Maximum Length: 1
    Default Value: false
    Indicates whether the maximum payment adjustment should be carried forward to offset earning short falls in subsequent pay periods. Valid values are Y and N. The default value is N.
  • Title: Payment Interval
    Default Value: -1000
    The unique identifier of the business unit interval that defines the frequency of the payment plan draw and cap adjustments. Intervals include period, quarter, annual, and semi annual. The default value is the identifier "-1000" for the period interval. Additional intervals are defined for the business unit using the Setup and Maintenance, Manage Intervals task. Use the finder for this resource to get the unique identifiers for the intervals.
  • Payment Plans Assignments
    Title: Payment Plans Assignments
    The assignments resource is used to view, create, update, or delete an incentive compensation assignment for a payment plan.
  • Title: Payment Plan Category
    Maximum Length: 30
    Default Value: STANDARD
    The code indicating which plan components to apply the draw and cap. The default value is STANDARD. A list of acceptable values is defined in the lookup CN_PAYMENT_PLAN_CATEGORY. Review and update the value for this attribute using the Setup and Maintenance, Manage Incentive Compensation Lookups task.
  • Title: Payment Plan
    The unique identifier of the payment plan.
  • Title: Name
    Maximum Length: 160
    The name of the payment plan.
  • Payment Plans Roles
    Title: Payment Plans Roles
    The roles resource is used to view, create, update, or delete an incentive compensation role assignment for a payment plan.
  • Title: Recovery Method
    Default Value: -1001
    The unique identifier of the recover expression. Recover expression determines which earnings can be deducted from, to recover a paid draw. The default, and only, valid value is "-1001" to recover against all earnings.
  • Title: Recovery End
    The code indicating when draw recovery should end. This value is optional if delayed recovery is enabled. The value is used to determine the relative date after the delayed recovery start. Possible values are "-1" to stop the recovery after 3 months, "-2" to stop the recovery after 6 months, "-3" to stop the recovery after 9 months, and "-4" to stop the recovery after 12 months.
  • Title: Recovery Start
    The code indicating when the delayed recovery period ends and the recovery processing should start. This value is required if delayed recovery is enabled. The value is used to determine the relative date after the payment plan assignment start date. Possible values are "-1" to start the recovery after 3 months, "-2" to start the recovery after 6 months, "-3" to start the recovery after 9 months, and "-4" to start the recovery after 12 months.
  • Title: Start Date
    The date when the payment plan becomes active. The acceptable format is yyyy-mm-dd.
Nested Schema : Payment Plans Assignments
Type: array
Title: Payment Plans Assignments
The assignments resource is used to view, create, update, or delete an incentive compensation assignment for a payment plan.
Show Source
Nested Schema : Payment Plans Roles
Type: array
Title: Payment Plans Roles
The roles resource is used to view, create, update, or delete an incentive compensation role assignment for a payment plan.
Show Source
Nested Schema : schema
Type: object
Show Source
  • Title: End Date
    The date when the assignment for a payment plan becomes inactive. The acceptable format is yyyy-mm-dd.
  • Title: Flat Minimum Amount to Pay Participant
    The minimum amount to pay the participant per the payment interval. The payment process creates a payment adjustment when the total earnings for the pay period are less than the minimum amount. This payment adjustment is often referred to as a draw or a guaranteed minimum.
  • Title: Maximum Payment
    The maximum amount to pay the participant for the payment interval. The payment process creates a payment adjustment when the total earnings for the pay period are more than the maximum amount. This payment adjustment is often referred to as a cap.
  • Title: Participant Identifier
    The unique identifier for a participant.
  • The unique identifier of the payment plan.
  • Title: Recovery End Date
    The date when the recovery of draw owed by the participant ends.
  • Title: Recovery Start Date
    The date when the recovery of draw owed by the participant starts.
  • Title: Start Date
    The date when the assignment becomes active. The acceptable format is yyyy-mm-dd.
Nested Schema : schema
Type: object
Show Source
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 : incentiveCompensationPaymentPlans-item-response
Type: object
Show Source
  • Read Only: true
    Maximum Length: 64
    The user who created the payment plan.
  • Read Only: true
    The date and time when the payment plan is created.
  • Title: Recovery Start Option
    Maximum Length: 1
    Default Value: false
    Indicates whether recovering draw amounts should be delayed for several months after being paid. Valid values are Y and N. If providing the value "Y" to enable delayed recovery, then provide the recovery start and optionally provide a recovery end. If providing the value "N", then the recovery starts immediately in the next subsequent payment. The default value is "N".
  • Title: Description
    Maximum Length: 1000
    A brief description of the payment plan.
  • Title: Draw End
    Maximum Length: 30
    The code indicating when the draw calculation for the participant should end. The value is used to determine the relative date after the payment plan assignment start date. Possible values are "-1", to stop the draw after 3 months, "-2", to stop the draw after 6 months, "-3", to stop the draw after 9 months, and "-4", to stop the draw after 12 months.
  • Title: End Date
    The date when the payment plan becomes inactive. The acceptable format is yyyy-mm-dd.
  • Title: Flat Minimum Amount to Pay Participant
    The minimum amount to pay the participant per the payment interval. The payment process creates a payment adjustment when the total earnings for the pay period are less than the minimum amount. This payment adjustment is often referred to as a draw or a guaranteed minimum.
  • Read Only: true
    The date and time when the payment plan was last updated.
  • Read Only: true
    Maximum Length: 64
    The user who last updated the payment plan.
  • Links
  • Title: Maximum Payment
    The maximum amount to pay the participant for the payment interval. The payment process creates a payment adjustment when the total earnings for the pay period are more than the maximum amount. This payment adjustment is often referred to as a cap.
  • Title: Minimum Recovery
    Maximum Length: 1
    Default Value: true
    Indicates whether the draw amounts paid to the participant should be recovered in subsequent pay periods. When enabled, the payment process deducts from the payment of earnings over a period of time until the full draw amount is recovered. Valid values are Y and N. The default value is Y.
  • Title: Business Unit
    The unique identifier of the business unit to which the payment plan belongs. Review the business unit ID for a business unit using the Setup and Maintenance, Define Business Units task. If the Business Unit ID column is not displayed, then click the View menu to add the Business Unit ID column.
  • Title: Carry forward maximum
    Maximum Length: 1
    Default Value: false
    Indicates whether the maximum payment adjustment should be carried forward to offset earning short falls in subsequent pay periods. Valid values are Y and N. The default value is N.
  • Title: Payment Interval
    Default Value: -1000
    The unique identifier of the business unit interval that defines the frequency of the payment plan draw and cap adjustments. Intervals include period, quarter, annual, and semi annual. The default value is the identifier "-1000" for the period interval. Additional intervals are defined for the business unit using the Setup and Maintenance, Manage Intervals task. Use the finder for this resource to get the unique identifiers for the intervals.
  • Payment Plans Assignments
    Title: Payment Plans Assignments
    The assignments resource is used to view, create, update, or delete an incentive compensation assignment for a payment plan.
  • Title: Payment Plan Category
    Maximum Length: 30
    Default Value: STANDARD
    The code indicating which plan components to apply the draw and cap. The default value is STANDARD. A list of acceptable values is defined in the lookup CN_PAYMENT_PLAN_CATEGORY. Review and update the value for this attribute using the Setup and Maintenance, Manage Incentive Compensation Lookups task.
  • Title: Payment Plan
    The unique identifier of the payment plan.
  • Title: Name
    Maximum Length: 160
    The name of the payment plan.
  • Payment Plans Roles
    Title: Payment Plans Roles
    The roles resource is used to view, create, update, or delete an incentive compensation role assignment for a payment plan.
  • Title: Recovery Method
    Default Value: -1001
    The unique identifier of the recover expression. Recover expression determines which earnings can be deducted from, to recover a paid draw. The default, and only, valid value is "-1001" to recover against all earnings.
  • Title: Recovery End
    The code indicating when draw recovery should end. This value is optional if delayed recovery is enabled. The value is used to determine the relative date after the delayed recovery start. Possible values are "-1" to stop the recovery after 3 months, "-2" to stop the recovery after 6 months, "-3" to stop the recovery after 9 months, and "-4" to stop the recovery after 12 months.
  • Title: Recovery Start
    The code indicating when the delayed recovery period ends and the recovery processing should start. This value is required if delayed recovery is enabled. The value is used to determine the relative date after the payment plan assignment start date. Possible values are "-1" to start the recovery after 3 months, "-2" to start the recovery after 6 months, "-3" to start the recovery after 9 months, and "-4" to start the recovery after 12 months.
  • Title: Start Date
    The date when the payment plan becomes active. The acceptable format is yyyy-mm-dd.
Nested Schema : Payment Plans Assignments
Type: array
Title: Payment Plans Assignments
The assignments resource is used to view, create, update, or delete an incentive compensation assignment for a payment plan.
Show Source
Nested Schema : Payment Plans Roles
Type: array
Title: Payment Plans Roles
The roles resource is used to view, create, update, or delete an incentive compensation role assignment for a payment plan.
Show Source
Nested Schema : incentiveCompensationPaymentPlans-PaymentPlanAssignments-item-response
Type: object
Show Source
  • Title: Analyst
    Read Only: true
    The unique identifier of the analyst assigned to the payment plan.
  • Title: Analyst Name
    Read Only: true
    Maximum Length: 360
    The name of the analyst assigned to the payment plan.
  • Title: Assignment Type
    Read Only: true
    The assignment type for the payment plan.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the payment plan assignment.
  • Title: Creation Date
    Read Only: true
    The date and time when the payment plan assignment is created.
  • Title: End Date
    The date when the assignment for a payment plan becomes inactive. The acceptable format is yyyy-mm-dd.
  • Title: Flat Minimum Amount to Pay Participant
    The minimum amount to pay the participant per the payment interval. The payment process creates a payment adjustment when the total earnings for the pay period are less than the minimum amount. This payment adjustment is often referred to as a draw or a guaranteed minimum.
  • Title: Last Updated Date
    Read Only: true
    The date and time when the payment plan assignment was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the payment plan assignment.
  • Links
  • Title: Maximum Payment
    The maximum amount to pay the participant for the payment interval. The payment process creates a payment adjustment when the total earnings for the pay period are more than the maximum amount. This payment adjustment is often referred to as a cap.
  • Title: Participant Identifier
    The unique identifier for a participant.
  • Title: Participant Name
    Read Only: true
    Maximum Length: 360
    The name of the participant in incentive compensation.
  • The unique identifier of the payment plan.
  • Title: Person Number
    Read Only: true
    Maximum Length: 30
    The Fusion HCM specific identifier that uniquely identifies a person in the application, regardless of their relationship to the enterprise. It does not have any relation to any national identifier component.
  • Title: Recovery End Date
    The date when the recovery of draw owed by the participant ends.
  • Title: Recovery Start Date
    The date when the recovery of draw owed by the participant starts.
  • Read Only: true
    The unique identifier off the payment plan role.
  • Title: Role Name
    Read Only: true
    Maximum Length: 60
    The name of the role.
  • Title: Start Date
    The date when the assignment becomes active. The acceptable format is yyyy-mm-dd.
Nested Schema : incentiveCompensationPaymentPlans-PaymentPlanRoles-item-response
Type: object
Show Source
Back to Top