Open APIs

Expand all | Collapse all

TMF632 Party and TMF629 Customer management details

  • 1.  TMF632 Party and TMF629 Customer management details

    TM Forum Member
    Posted Jun 04, 2020 10:37
    Hello TMForum,

    I've got two questions related to party and customer management.
    I'd like to allow for read access and modification of some customer details.

    My interpretation is that some customer related attributes could be addressed by
    a) TMF632 Party Management
    Individual.familyName
    Individual.fullName
    Individual.individualIdentification[] - reference to legal documents
    Individual.location - temporary/legal location address related to individual, e.g.: home address,
    Individual.contactMedium[] - mail correspondence address, email address, telephone number for contacting,
    relatedParty -> Customer (reference to a role from TMF629)

    b) TMF629 Customer Management
    Customer.name - the same as TMF632 Individual.fullName
    Customer.account -> BillingAccount (refernce to TMF666 BillingAccount)
    Customer.agreement

    Above all this data I still would like to capture the
    - the billing address - that should be present on the invoices,
    - address location for installed services that customer is billed for under given BillingAccount,
    I'm not sure how to express these address in the CRM application context. Could you help?

    Also considering that I'd have B2C and B2B customers is my understanding correct that I should use seperatlly two API calls for such details:
    - B2C customers - GET /individual/{id} + related TMF629 /Customer
    - B2B customers - GET /organization/{id} + related TMF629 /Customer
    ?

    Cheers,
    Bartosz


    ------------------------------
    Bartosz Kluzek
    Liberty Global Services B.V.
    ------------------------------


  • 2.  RE: TMF632 Party and TMF629 Customer management details

    TM Forum Member
    Posted Jun 09, 2020 08:28
    Hi Bartosz

    I'll try to give a quick overview of the distinction between Party and Party Role, a key pillar of this area in the Open API (and in the SID), apologies if you are already familiar.
    Party is an abstract class with concrete subclasses Organization and Individual, without relation to the service provider (or some other party)
    PartyRole is concrete class representing the role that the party plays in relation to the service provider. Examples include Customer (which is so ubiquitous that a concrete subclass was defined for it), Dealer, Supplier, Partner, and many more. A Party can play multiple roles, but a PartyRole can be played by exactly one Party (PartyRole.engagedParty in the model).

    This separation has many consequences, for example allows you to have different names for a party and party role, e.g. in residential sector it could be that the name of the customer will be a concatenation of the given and family names of the individual, or something else. It depends on your specific implementation of the API, according to business requirements and practices in your jurisdiction or service provider.

    Regarding billing address, suggest you take a look at TMF 666 Account Management, the BillingAccount entity includes a Contact with Contact medium that could be interpreted as the billing address.

    Regarding installation or service address, suggest you take a look at TMF 637 Product Inventory, Product has a RelatedPlace including a role for the address that could be delivery, installation, etc.

    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.
    ------------------------------



  • 3.  RE: TMF632 Party and TMF629 Customer management details

    TM Forum Member
    Posted Jun 10, 2020 04:16
    Thank you Jonathan, this is helpful

    ------------------------------
    Bartosz Kluzek
    Liberty Global Services B.V.
    ------------------------------