API - MHR Edit Owner Information

[arlentees]

• [x] Registries Staff - Validate that Owner Address, Phone Number, Email, Additional Instructions can be edited in any transfer
• [x] Qualified Suppliers (Lawyers/Notaries and Home Dealers) - Validate that Owner Address, Phone Number, Email, Additional Instructions can be edited in transfers due to Sale or Gift and Surviving Joint Tenants
• [x] Changed owner tracking for verification statements
• [x] Minor spec update: add previousOwnerId to the owner schema/model.
• [x] Update deleteOwnerGroups schema to ignore owners: only require groupId and type. Some migrated legacy owner addresses are failing address data validation because the city/street are missing.

Developer Notes:

1. Only treat an owner change as an edit when the UI explicitly identifies the change as an edit. Do not automatically set the report edit flag based on the owner changes.
2. Scope is transfer registrations only - corrections/amendments are not included.
3. The UI will use owner.previousOwnerId to indicate the added owner is an edit (API will verify and ignore if identical). Set in an addOwnerGroups owner to indicate the owner information has been changed except for the name. In other words, to be an edit the previousOwnerId in an addOwnerGroups owner maps to an ownerId in a deleteOwnerGroups owner and the names must be identical.

[arlentees]

Hey team! Please add your planning poker estimate with Zenhub @cameron-eyds @chdivyareddy @flutistar

[doug-lovett]

@LizGovier example TRAN document type registration verification report attached if you would like to review.

trans-test-example-jt.pdf

[LizGovier]

Looks great, thanks Doug!

[doug-lovett]

Example DEV request with new addOwnerGroups.owners.previousOwnerId property: POST https://bcregistry-dev.apigee.net/mhr/api/v1/transfers/108386

{
  "clientReferenceId": "UT-TRANS-JOINT",
  "declaredValue": 113840,
  "consideration": "$113,840.00",
  "transferDate": "2024-05-22",
  "ownLand": false,
  "attentionReference": "James Irving",
  "registrationType": "TRANS",
  "submittingParty": {
    "businessName": "ABC UNIT TEST COMPANY",
    "address": {
      "street": "222 SUMMER STREET",
      "city": "VICTORIA",
      "region": "BC",
      "country": "CA",
      "postalCode": "V8W 2V8"
    },
    "phoneNumber": "2507211234",
    "phoneExtension": "5555",
    "emailAddress": "test1@abc-ut.com"
  },
  "deleteOwnerGroups": [
    {
      "groupId": 1,
      "interest": "",
      "interestDenominator": 0,
      "interestNumerator": 0,
      "owners": [
        {
          "address": {
            "city": "LANGLEY",
            "country": "CA",
            "postalCode": "V3A 6H4",
            "region": "BC",
            "street": "6665 238TH STREET"
          },
          "individualName": {
            "first": "SALVADOR",
            "last": "DALI"
          },
          "ownerId": 995531,
          "partyType": "OWNER_IND",
          "phoneNumber": "2504890849",
          "status": "ACTIVE",
          "type": "SOLE"
        }
      ],
      "tenancySpecified": true,
      "type": "SOLE"
    }
  ],
  "addOwnerGroups": [
    {
      "groupId": 2,
      "owners": [
        {
          "address": {
            "city": "BARCELONA",
            "country": "CA",
            "postalCode": "V3A 6H4",
            "region": "BC",
            "street": "6664 238TH STREET"
          },
          "individualName": {
            "first": "SALVADOR",
            "last": "DALI"
          },
          "previousOwnerId": 995531,
          "partyType": "OWNER_IND",
          "phoneNumber": "2504899849"
        },
        {
          "address": {
            "city": "BARCELONA", 
            "country": "CA", 
            "postalCode": "V3A 6H4", 
            "region": "BC", 
            "street": "6665 238TH STREET"
          }, 
          "individualName": {
            "first": "JOAN", 
            "last": "MIRO"
          }, 
          "partyType": "OWNER_IND", 
          "phoneNumber": "6044620279"
        }
      ],
      "type": "JOINT"
    }
  ]
}