SAP Knowledge Base Article - Public

3586028 - How to migrate the I-9 user data for reverification from old instance / third-party system to new instance - Onboarding

Symptom

How to migrate the I-9 user data for reverification from old instance / third-party system to new instance.

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 Onboarding

Resolution

  • Leverage the I-9 Audit Trail REST API to migrate the I-9 user data.
  • To migrate I-9 user data for reverification from an old instance to a new instance:
    1. The first step involves getting the I-9 audit trail from the old instance.
    2. The second step involves importing the I-9 Audit Trail to the new instance.

  • Example from demo:
  • Get - https://apisalesdemo2.successfactors.eu/rest/onboarding/compliance/i9audittrail/v1/user/103XX7/i9AuditTrailRecords
  • Post -

    https://apisalesdemo2.successfactors.eu/rest/onboarding/compliance/i9audittrail/v1/i9AuditTrailRecords

    {

      "value": [

        {

          "firstName": "Audti",

          "lastName": "Test",

          "middleName": null,

          "otherName": null,

          "address": null,

          "apartmentNumber": null,

          "city": null,

          "state": "AL",

          "zipCode": null,

          "dateOfBirth": "1995-06-06",

          "ssn": null,

          "emailAddress": null,

          "phoneNumber": null,

          "employmentEligExpDate": "2025-06-06",

          "citizenshipType": "US_CITIZEN",

          "alienRegistrationNumber": null,

          "uscisNumber": null,

          "i94AdministrationNum": null,

          "i94ExpirationDate": "2025-06-06",

          "passportNumber": null,

          "countryOfIssue.code": null,

          "visaType": "F1",

          "visaNum": null,

          "visaExpirationDate": "2025-06-06",

          "protectedStatus": "REFUGEE",

          "ctzOfFreeAssocState": "NO",

          "i129PetitionFilled": null,

          "h1BEmployee": "NEW_EMPLOYER",

          "i129SubmittedDate": "",

          "translator1": null,

          "translator2": null,

          "translator3": null,

          "translator4": null,

          "translator5": null,

          "initiationBy": null,

          "initiationDate": "",

          "alienExpiryDateApplicable": "true",

          "employerTitle": null,

          "employerBusiness": null,

          "employerFirstName": null,

          "employerLastName": null,

          "employerAddress": null,

          "employerCity": null,

          "employerState": null,

          "employerZipCode": null,

          "listADocument1": null,

          "listADocument2": null,

          "listADocument3": null,

          "listBDocument": null,

          "listCDocument": null,

          "listADocument1Name": null,

          "listADocument2Name": null,

          "listADocument3Name": null,

          "listBDocumentName": null,

          "listCDocumentName": null,

          "listBDocumentExpiry": null,

          "listCDocumentExpiry": null,

          "listADocument1Issuer": null,

          "listADocument2Issuer": null,

          "listADocument3Issuer": null,

          "listBDocumentIssuer": null,

          "listCDocumentIssuer": null,

          "listADocument1Expiry": null,

          "listADocument2Expiry": null,

          "listADocument3Expiry": null,

          "listADocument1Id": null,

          "listADocument2Id": null,

          "listADocument3Id": null,

          "listBDocumentId": null,

          "listCDocumentId": null,

          "remote": "false",

          "reasonForRemote": null,

          "reasonForDelay": null,

          "additionalInfo1": null,

          "additionalInfo2": null,

          "additionalInfo3": null,

          "additionalInfo4": null,

          "additionalInfo5": null,

          "additionalInfo6": null,

          "additionalInfo7": null,

          "additionalInfo8": null,

          "additionalInfo9": null,

          "additionalInfo10": null,

          "correctI9Reason": null,

          "verificationDate": "",

          "verificationDocument": null,

          "verifierFirstName": null,

          "verifierLastName": null,

          "verifierMiddleName": null,

          "dateOfRehire": "",

          "previousEmploymentGrantExpired": "false",

          "reverificationListADoc1": null,

          "reverificationListADoc2": null,

          "reverificationListADoc3": null,

          "reverificationListCDoc": null,

          "newFirstName": null,

          "newLastName": null,

          "newMiddleNamec": null,

          "reverificationListADocName1": null,

          "reverificationListADocName2": null,

          "reverificationListADocName3": null,

          "reverificationListCDocName": null,

          "seqNo": 1,

          "externalCode": null,

          "userId": "10XX80",

          "sourceOfRecord": "COMPLIANCE",

          "complianceProcess.processId": "",

          "status": "SECTION2_SIGNED"

        }

      ]

    }

     

 

See Also

Keywords

SuccessFactors, Onboarding 2.0, I-9 user data, reverification, migration, old instance, new instance, Form I-9 Audit Trail REST API, import, audit trail, API , KBA , LOD-SF-OBX-I9 , i9 Compliance Form , How To

Product

SAP SuccessFactors Onboarding