Open APIs

Expand all | Collapse all

TMF637 productPrice priceAlteration validFor property

  • 1.  TMF637 productPrice priceAlteration validFor property

    TM Forum Member
    Posted 24 days ago
    Hi All,
    I was wondering if someone can tell me why TMF637 productPrice priceAlteration validFor property was removed from v19 of the TMF637 API, when it was present in v18 of the API?

    For Your Information
    v19 swagger: https://github.com/tmforum-apis/TMF637_ProductInventory/blob/master/TMF637-ProductInventory-v4.0.0.swagger.json
    v18 swagger: https://github.com/tmforum-apis/TMF637_ProductInventory/blob/master/Product_Inventory_Management.swagger.json

    This was a very useful field for defining the validity period of a discount or "special price", which I think should never have been removed.

    Is the intention for a PriceAlteration , that ProductOfferingPriceRef be always used as part of the price alteration, as it is only the ProductOfferingPrice data object that contains a validFor field?
    Thanks

    ------------------------------
    Richard Loo
    Telstra Corporation
    ------------------------------


  • 2.  RE: TMF637 productPrice priceAlteration validFor property

    TM Forum Member
    Posted 24 days ago
    Hello Richard

    We introduced an applicationDuration attribute in the v4.0 for this purposed. This is the Duration during which the alteration applies on the order item price (for instance 2 months free of charge for the recurring charge).

    This is not related to the introduction of a link to ProductOfferingPriceRef. For me (but I'm not an expert on catalog API) the validFor in the ProductOfferingPriceRef i used to manage the validity itself of this entity.

    Hope it helps
    Ludovic


    ------------------------------
    Ludovic Robert
    Orange
    My answer are my own & don't represent necessarily my company or the TMF
    ------------------------------



  • 3.  RE: TMF637 productPrice priceAlteration validFor property

    TM Forum Member
    Posted 23 days ago
    Thanks Ludovic,Thanks Matthieu,

    I fail to see how applicationDuration is an adequate substitute for a validFor period, as the applicationDuration does not have any reference to any start date/time in the product inventory price data. For example, how do you specify a priceAlteration that only applies for May 2021, when the product instance was instantiated in January 2019. Hence my opinion that theTMF637 productPrice priceAlteration validFor property should never have been removed still stands.

    ------------------------------
    Richard Loo
    Telstra Corporation
    ------------------------------



  • 4.  RE: TMF637 productPrice priceAlteration validFor property

    TM Forum Member
    Posted 24 days ago
    +1 for Ludo's answer.

    ValidFor
    means:
    The period for which the price is valid.
    For instance, the price alterations could be:
    €22 for Q1
    €23 for Q2
    €25 for Q3
    It's particularly useful for absolute values. so you can keep in sync ProductOfferingPriceAlteration and ProductOfferingPrice

    while applicationDuration means:

    Specifies for a ProductOfferingPriceAlteration that impacts recurring ProductOfferingPrice the duration of application.

    Say, the price alteration has a duration of 3 months.
    In March, Customer buys the ProductOffering with a non discounted recurring ProductOfferingPrice of €46.

    it would pay this ProdOfferPrice
    €22 in Mar
    €23 in Apr*
    €23 in May
    €46 thereafter

    * from April, the pricealteration goes up by €1

    PS: PriceAlteration are not necessarily discount, they could be the exact opposite (as per priceType LOV)

    ------------------------------
    Matthieu Hattab
    Altibox AS
    ------------------------------