Open APIs

 View Only
  • 1.  TMF 622 - Change order on an product item

    TM Forum Member
    Posted May 05, 2022 12:47
    Hi all, 
    I have a question about change order using TMF 622. Specifically on the documentation I did not find any sample of it.
    I have to build an API to handle the following UC samples: 
    • Order 1: New Subscription: Tariff 1 + Option A --> Product (inventory) ID: ABC
    • Order 2.1: Change Order on inventory ID ABC - Tariff 1 + Option B
    • Order 2.2: Change Order on inventory ID ABC - Tariff 2 + Option B
    How should I structure my API to be TMF compliant to handle the order 2.1 and 2.2 on the UC above? 
    Hope that I was clear. Thanks in advance. 
    Filippo

    ------------------------------
    Filippo Roberto Valeriani
    NTT DATA CORPORATION
    ------------------------------


  • 2.  RE: TMF 622 - Change order on an product item

    TM Forum Member
    Posted May 08, 2022 04:01
    Seemingly, all your use cases are variants that would be done using TMF622 (product order), driven of course by a relevant product catalog model in TMF620.
    Is there something specific that is blocking you from issuing a product order for these use cases?

    ------------------------------
    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: TMF 622 - Change order on an product item

    TM Forum Member
    Posted May 09, 2022 03:32
    Hi Jonathan, 
    thanks for your feedback. The point is that is not clear to me how to structure the API for the specific use case exposed above. I know that i have to use the TMF 622, but how should I modelize those API? 
    Thanks, 
    Filippo

    ------------------------------
    Filippo Roberto Valeriani
    NTT DATA CORPORATION
    ------------------------------



  • 4.  RE: TMF 622 - Change order on an product item

    TM Forum Member
    Posted May 09, 2022 03:53
    Hi Filippo
    It all starts with the catalog model. Your example is a bit abstract, so let's make it concrete, let's suppose we have a mobile bundle, with various plans (100 mins for fixed price, pay for what you use, etc.) and some add-in options (voice mailbox, cyber protection).
    The model might look like this (SPO - simple product offering that has a product spec and may have product offering price; BPO - bundling product offering). Of course there are many alternatives to the modeling approach, and I'm not showing the product specs or product offering prices.
    Hope it helps

    BPO Mobile
       SPO 100 min plan       } Only one of these two can be chosen
       SPO pay per use plan }
       SPO voice mailbox
       SPO cyber protection

    So the initial order item structure (Order 1) will look like this:

    OI Mobile Add
       OI 100 min plan Add
       OI voice mailbox Add

    Order 2.1 will look like this:
    OI Mobile no change
       OI 100 min plan Remove
       OI pay per use plan Add

    Order 2.2 will look like this (assuming it takes place after Order 2.1)
    OI Mobile no change
       OI voice mailbox Remove
       OI cyber protection Add

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



  • 5.  RE: TMF 622 - Change order on an product item

    TM Forum Member
    Posted May 09, 2022 06:05
    Hi Jonathan, 
    thanks for your feedback it is very useful. I have an additional consideration, for the change order, i should add also the reference to the inventory to find the correct record to change, isn't it? 
    Thanks, 
    Filippo

    ------------------------------
    Filippo Roberto Valeriani
    NTT DATA CORPORATION
    ------------------------------



  • 6.  RE: TMF 622 - Change order on an product item

    TM Forum Member
    Posted May 09, 2022 07:10
    Yes of course, the OrderItem entity has a reference to Product, and you would populate the Product.id in your input to refer to an existing inventory product. My presentation above was a gross simplification.

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



  • 7.  RE: TMF 622 - Change order on an product item

    TM Forum Member
    Posted May 09, 2022 08:05
    Ok. Thanks for your clarifications.
    So, if i would like to terminate a Tariff active, i have to use "delete" action or some different action as "terminate"?

    ------------------------------
    Filippo Roberto Valeriani
    NTT DATA CORPORATION
    ------------------------------



  • 8.  RE: TMF 622 - Change order on an product item

    TM Forum Member
    Posted May 09, 2022 10:17
    Yes
    We don't have an enum for action types - in the SID the allowed actions on an offering/spec are themselves an entity, and we are considering adding a similar pattern to the TMF620 API.

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



  • 9.  RE: TMF 622 - Change order on an product item

    TM Forum Member
    Posted May 10, 2022 04:31
    Ok, thanks for your prompt feedback. They are very useful to help my understanding :-)

    ------------------------------
    Filippo Roberto Valeriani
    NTT DATA CORPORATION
    ------------------------------