SAP Knowledge Base Article - Public

2518638 - Payment Information migration issues

Symptom

Direct Deposit to Payment Information migration (from Upgrade Center) fails. There can be multiple errors or only one error or sometimes no error in the Job response file (Admin Centre -> Monitor Job -> Job response file).

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.

Environment

SAP SuccessFactors Employee Central: Payment Information

Reproducing the Issue

The migration job in Upgrade Center fails with any of the following error:

  •  Data inconsistency is present for employee
  • User has no job information
  • Amount/Percentage 0 is not considered into migration
  • {0} is a required field/association in Object {1}
  • User has no record with the deposit type Balance. Please maintain the deposit type Balance for the user.
  • Amount/Percent field has value but deposit type is Balance. Please correct the data.
  • Old payment method and new payment method are inconsistent. Please correct the data.
  • Neither payroll integration nor direct deposit is enabled in Provisioning. Please contact SuccessFactors Customer Success to enable one of them.
  • Error "EMPLOYEE_HRIS_GO_FORMATTED_MESSAGE_WRAPPER" in Provisioning job details for the migration job.
  • bank details are inconsistent. Please correct the data.

Resolution

There can be many issues causing the failure. All the below checks must be performed when the migration fails.

  • Check 1: When the migration happens, Direct Deposit’s “Deposit Type” field corresponds to MDF Payment Information’s “Pay Type” field. If "Deposit Type" value is Null or Balance, then "Pay Type" value becomes “Main”. Hence there has to be atleast one Direct Deposit record for the users with "Deposit Type" value as either Null or Balance. This is because each user must have one Main Payment Method in new MDF based Payment Information portlet.
  • Check 2: Check object definition (Admin Centre -> Configure Object Definitions) of Payment Information Details. Make sure that fields visibility are configured fine. Also, make sure that no optional field is marked as mandatory.
  • Check 3: Verify that the users have valid Personal Information and Job Information records as of the intended Payment Information record date (can be found from existing Direct Deposit record's date).
  • Check 4: There should be eactly one Bank Transfer in Old Payment Method. For this, navigate to Admin Center -> Manage Data -> Old Payment Method -> Search for Bank Transfer. If it's not there, create one Old Payment Method with an external code (same external code as used in Payment Method; usually it's "05"), external name (same external name as used in Payment Method; usually it's "Bank Transfer"), set Bank Transfer field to "Yes".
  • Check 5: For the error "Amount/Percent field has value but deposit type is Balance. Please correct the data." -> Delete the value in the Amount field from Direct Deposit information of the UserID in the error.
  • Check 6: For the error "Old payment method and new payment method are inconsistent. Please correct the data." -> This error happens only when either or both of the following 2 happens:

    External codes of Payment Methods are different in Direct Deposit and Payment Information. For example, in Direct Deposit the external code is "5", but in Manage Data -> Payment Method the external code is "05". Make sure that the external codes are same in both places.
    OR
    External names of Payment Methods are different in Direct Deposit and Payment Information. For example, in Direct Deposit external code "05" is named as "Direct Deposit", but in Manage Data -> Payment Method with external code "05" is named "Bank Transfer". Make sure that the external names are same in both places. 
  • Check 7: For the error "Neither payroll integration nor direct deposit is enabled in Provisioning. Please contact SuccessFactors Customer Success to enable one of them" -> Enable the option "Enable Payment Method in Payment Information even if Payroll Integration is not enabled" in Provisioning. If you do not have access to Provisioning, contact your implementation partner. If you don't have an implementation partner, contact SAP Cloud Product Support.
  • Check 8: Below table explains mapping between Direct Deposit fields and MDF-based Payment Information fields:
    DDtoPI.jpg
    When the migration happens, Direct Deposit’s Deposit Type field corresponds to MDF Payment Information’s Pay Type field. If Deposit Type value is "Null" or "Balance", then Pay Type value becomes “Main”. It is mandatory to maintain at least one record with Pay Type as “Main” in MDF Payment Information portlet. Hence, it is mandatory that at least one Direct Deposit record for each employee is maintained with Deposit Type = "Null" or “Balance”.
  • Check 9: The following feature must be enabled in Provisioning: "Enable this feature to enable upgrade center feature for migration of payment information (Direct Deposit)". If you do not have access to Provisioning, contact your implementation partner. If you don't have an implementation partner, contact SAP Cloud Product Support.
  • Check 10: Verify that each user has only one Direct Deposit record with Deposit Type "Balance". There can be more than one records with other Deposit Types.

If the migration still fails, keep backup of the Direct Deposit data for the impacted users. Then delete Direct Deposit data for the impacted users and re-try the migration.

Keywords

data_inconsistency amount/percentage field/association Upgrade Now - Failed EMPLOYEE_HRIS_GO_FORMATTED_MESSAGE_WRAPPER ECT-76429 , KBA , LOD-SF-EC-PAY , Payment Information (Bank Information) , LOD-SF-EC , Employee Central , Problem

Product

SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HCM Core all versions