B 18491 update endpoint for updateMTOServiceItem MAIN

[traskowskycaci]

INTEGRATION PR: #11908

Agility ticket

Summary

The updateMTOServiceItem only allows a service item without a SITDestinationFinalAddress field value to be created. It does not allow updates of the SITDestinationFinalAddress value if it already exists.

Since we populate the SITDestinationFinalAddress for destination SIT service items DDASIT, DDDSIT, DDFSIT, and DDSFSC at the time of destination SIT request/creation, there will never be a case where a destination SIT service item has an empty SITDestinationFinalAddress field, so this endpoint can never update that SITDestinationFinalAddress field.

Based on those findings, a new v2 endpoint was not needed. Instead, I added the four destination service codes as an explicit check that ensures the final destination address field cannot be updated. The added check does not break any functionality, it just clearly documents what was already happening based on the current logic in place.

I updated the error message to be more informative and to direct end users to update the shipment destination address if they want to update the destination SIT service item's final destination address.

I also expanded tests to reflect this functionality and updated the documentation for the endpoint.

The updateMTOServiceItem does allow the SITDestinationFinalAddress field value to be created for origin SIT service items, however, that column being populated for origin SIT service items is not relevant to SIT calculations. Instead, we are focusing on the destination SIT service items and their SITDestinationFinalAddress value.

How to test

1. Access the office application.
2. Login as a prime user.
3. Request destination SIT, which creates the 4 destination service items: DDASIT, DDDSIT, DDFSIT, and DDSFSC.
4. Using swagger or postman, use the updateMTOServiceItem endpoint to try updating the SITDestinationFinalAddress for any of the four destination SIT service items. Example request body:
   {
   "modelType": "UpdateMTOServiceItemSIT",
   "SITDestinationFinalAddress": {
   "ID": "62e795f4-61a8-4cca-b59d-028345c07b89",
   "StreetAddress1": "Maria Street Address 1",
   "City": "Herington",
   "State": "KS",
   "PostalCode": "66667",
   "Country": "United States"
   }
   }
5. Check that you receive a 422 with an error message directing you to update the shipment destination address:
   
6. Check that the database value for SITDestinationFinalAddress was not changed for the service item, and make sure that the SITDestinationFinalAddress for the service item still matches the shipment destination address.

[cameroncaci]

Commit hashes are good