If there are no side-effects due to the substitution of a different related party, then yes you would use PATCH in 637 or 638. But it is possible, especially for Product, that the substitution of a related party could itself trigger re-evaluation of qualification, meaning you would be in an ordering situation.
------------------------------
Jonathan Goldberg
Amdocs Management Limited
Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
------------------------------
Original Message:
Sent: Aug 22, 2023 06:22
From: Milind Bhagwat
Subject: How do we deal with changes to related Party in TMF APIs?
Thanks Jonathan. I was more thinking of the 2nd scenario where the contact has changed.
We could patch the Product or the Service object with the new party as you suggest.
However should we use the Inventory API i.e 637 or 638?
Regards
Milind
------------------------------
Milind Bhagwat
BT Group plc
------------------------------
Original Message:
Sent: Aug 21, 2023 08:07
From: Jonathan Goldberg
Subject: How do we deal with changes to related Party in TMF APIs?
Hi Milind
I'm not quite sure what you are referring to. It could be:
- The data on a related party has changed, e.g. an individual who was playing party role of Customer no longer has a tax exemption
- The reference to the related party needs to be changed, e.g. the billing contact for a billing account is now Jane Smith instead of Rudy Patel
For the second situation, presumably you would PATCH (json-patch or merge-patch) the relevant reference to the related party in the containing entity
The first situation is more tricky, since it could be that the data change has side effects (e.g. in my example on tax calculation). I don't think this is a pure API concern, it's more of a system design consideration. For example, you could have some listener that consumes events on Party, and which would take appropriate action in the case of a significant change.
Hope it helps
------------------------------
Jonathan Goldberg
Amdocs Management Limited
Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.