TM Forum Community

 View Only
  • 1.  TMF654 - TopupBalance

    Posted Jun 19, 2023 16:24

    Hi All,

    We need to manage additional attributes with balance refill regular information. As per our understanding, we are looking below options. Please suggest which one will be appropriate for us.

    Additional attributes like : AddData1, AddData2, AddInt1,AddInt2 etc

    Option 1 : Use existing "product" schema object and define attribute name-value pairs in List[ProductRef]

    Option 2: Extend topupBalance operation with "characteristic" schema object


    #General

    ------------------------------
    Chetan Patel
    Tech Mahindra Limited
    ------------------------------


  • 2.  RE: TMF654 - TopupBalance

    Posted Jun 20, 2023 02:00

    Hi Chetan, 

    Are you talking about a composite top up - aka a top up that is composed of multiple balances? For example 100min, 1GBData, 1000 SMS

    /Elisabeth



    ------------------------------
    Elisabeth Andersson
    MATRIXX Software
    ------------------------------



  • 3.  RE: TMF654 - TopupBalance

    Posted Jun 20, 2023 03:49

    Hi Elisabeth,

    It will be single top-up balance either min or data or SMS but here they are expecting supporting attributes to this top-up. For example Recharge through External Party, Recharge against Loan, Recharge Against Credit/Debit Transfer, and few futuristic expected attributes



    ------------------------------
    Chetan Patel
    Tech Mahindra Limited
    ------------------------------



  • 4.  RE: TMF654 - TopupBalance

    Posted Jun 20, 2023 04:24

    Got you. 

    OK, so looking at the API and the use case part I see that a channel can be set for a top up "Operators can provide multiple recharge channels to top up these buckets to increase the balance to use for services."

    Looking at the Top Up Schema there is a 0..1 relationship to ChannelRef and that is used as a resource reference to the channel. Have a look at it as ,if I understand it correctly,
    you would be able to use it to define different types of channels as per your examples above. 

    ChannelRef relationship

    The channel to which the resource reference to. e.g. channel for selling product offerings, channel for opening a trouble ticket etc..

    @referredType

    A string. The actual type of the target instance when needed for disambiguation.

    name

    A string. Name of the channel.

    href

    An uri (Uri). Hyperlink reference.

    id

    A string. unique identifier.

    @baseType

    A string. When sub-classing, this defines the super-class.

    @schemaLocation

    An uri (Uri). A URI to a JSON-Schema file that defines additional attributes and relationships.

    @type

    A string. When sub-classing, this defines the sub-class Extensible name.



    ------------------------------
    Elisabeth Andersson
    MATRIXX Software
    ------------------------------



  • 5.  RE: TMF654 - TopupBalance

    Posted Jun 20, 2023 06:42

    Hi  Elisabeth,

    Thanks  a log for suggesting ChannelRef relationship. with detail explanation. 

    May we know which schema object suitable, if we will get these additional attributed other than channel reference, like legacy system demographics attributes ?

    Here we also need to take care that all the  attributes should be under single schema object.



    ------------------------------
    Chetan Patel
    Tech Mahindra Limited
    ------------------------------



  • 6.  RE: TMF654 - TopupBalance

    Posted Jun 21, 2023 03:55

    Hi Chetan, 

    I am not sure that I understand exactly, but I assume that what you are looking for is the definition of channels and then associated payment methods with the logistics to execute on the refill? I looked on the API table and you have the Payment Method API TMF670 and of course the Payment API TMF676. 



    ------------------------------
    Elisabeth Andersson
    MATRIXX Software
    ------------------------------



  • 7.  RE: TMF654 - TopupBalance

    Posted Jun 21, 2023 04:53

    Hi Elisebeth,

    Thanks a lot for your time & explanation.

    Let me brief about my requirement.

    Here we are going for TMF compliance conversation of existing solution. We need to prepare one TMF comply API layer that will communicate southbound APIGateway/Middleware layer and further it will call existing legacy billing/charging/CRM system.

    So my TMF API layer will trigger single API of APIGateway/Middleware layer while it will be distributed in multiple API call behind the middleware.

    PFB sample required object that we need to incorporate in TMF compliance for TMF654 Topupbalance

        additionalInformation/

    Complex

           [1..n]

    Additional Information for future use.

                         name

    String

    [1..1]

    Constant:

    'EXTERNAL_DATA1'

                          value

    String

    [1..1]

    AParty number in case of credit/data transfer.

    Note: This is applicable for reload & CSI only.

    Loan Id if the request is initiated from Central Mall POS



    ------------------------------
    Chetan Patel
    Tech Mahindra Limited
    ------------------------------



  • 8.  RE: TMF654 - TopupBalance

    Posted Jun 22, 2023 04:24

    Look at the user guide for adjustment and transfer. What you will see in the datamodel is that there are different ways of relating to the action through relatedParty and you also have the owning Party as well as a logical reference that often is the identifier (MSISDN/IMSI or such) 



    ------------------------------
    Elisabeth Andersson
    MATRIXX Software
    ------------------------------



  • 9.  RE: TMF654 - TopupBalance

    Posted Jun 22, 2023 04:53

    Thanks a Elisabeth,

    Yes, this is right data model for me, relatedParty can be map here.



    ------------------------------
    Chetan Patel
    Tech Mahindra Limited
    ------------------------------