Open APIs

 View Only
  • 1.  TMF648/TMF622 ProductOfferingQualificationItemRef how to refer AlternateProductOfferingProposal?

    TM Forum Member
    Posted 24 days ago

    Hello,

    TMF679 POQ defines ProductOfferingQualification with a list of ProductOfferingQualificationItems, having a list of AlternateProductOfferingProposals.

    ProductOfferingQualification has a globally unique id.

    ProductOfferingQualificationItem has an id unique within ProductOfferingQualification,

    AlternateProductOfferingProposal has an id unique within ProductOfferingQualificationItem.

    Now in Quote and Order APIs there is ProductOfferingQualificationItemRef with productOfferingQualificationId and id to point to POQ item.

    How to use this type to refer to a specific AlternateProductOfferingProposal if the Buyet was proposed one and wishes to order it?

    Thank you!



    ------------------------------
    Michal Laczynski
    Amartus
    ------------------------------


  • 2.  RE: TMF648/TMF622 ProductOfferingQualificationItemRef how to refer AlternateProductOfferingProposal?

    TM Forum Member
    Posted 23 days ago
    Edited by Matthieu Hattab 23 days ago

    Hi,

    The Order API model doesn’t currently support referencing an "AlternateProductOfferingProposal" ID, and it’s not immediately clear why it would be needed.

    Could you clarify the purpose of having the proposal ID on the order item?

    The proposal isn’t a managed entity, and there’s no ABO/BO in the SID. The "proposal" sub-ressource only provides the (oddly named) "alternateActivationDate"  and the productofferingRef.Id, both of which are already mapped in the order item.

    However, if it’s essential, you’re welcome to add a new attribute ("ProposalId") in ProductOfferingQualificationItemRef



    ------------------------------
    Kind regards,

    Matthieu Hattab
    Lyse Platform
    ------------------------------



  • 3.  RE: TMF648/TMF622 ProductOfferingQualificationItemRef how to refer AlternateProductOfferingProposal?

    TM Forum Member
    Posted 17 days ago

    Hi Matthieu,

    The case is - since POQ allows providing Alternative POQ proposals - then they are there for some reason - to be used :)

    Now, when making a Quote the Buyer can/must refer to a POQ Item with a qualification of he/she wants to Quote.

    When an alternative proposal is Better for the Buyer - there is no way to reference it and take it directly to Quotation.

    Does the Buyer need to make another POQ for that alternative explicitly to be able to refer to it from the Quote request?

    That kind of brings unnecessary ping pong for both the Buyer and the Seller.

    Best regards,

    Michał



    ------------------------------
    Michal Laczynski
    Amartus
    ------------------------------



  • 4.  RE: TMF648/TMF622 ProductOfferingQualificationItemRef how to refer AlternateProductOfferingProposal?

    TM Forum Member
    Posted 16 days ago

    Hi,


    We use TMF 679 in two ways:

    • case 1: to request a list of qualified offers (input: context, category and intent)
    • case 2: to qualify a specific product offering Id or a list of product offering Ids (input: context, list of product ids and intent)

    Case 1 is for our pre-sales or sales scenarios, the input is typically a category, not a list of product ids, but that's up to your implementation.

    case 2 is typically for "move" or "modify" scenarios or to validate an entire order

    This is one scenario we have with TMF679:

    • customer wants to buy a new offer
    • we call TMF679 with case 1 input arguments
    • a webpage shows a list of qualified product offerings
      • some of these offers may have a different earliest activation date (which the APOP can provide)
      • if an offer in our catalogue is not qualified, we may or may not show it, it depends on the ineligibility reason code.
        We also don't show APOP with other product offerings because it's redundant, the API already returns a list of all qualified product offerings.
    • customer press the "add to cart" or "customise" button and the selected product is added to cart or we open the product configurator but at the end, the offer is added to the cart.
    • a few steps later, at checkout page, we do a final POQ
      • this time, the request provides a list of product Ids (that exist in the order)
      • (99.99% of the time, it's still valid)

    the quote, cart, order items do not reference any APOP id. We have no use for this.



    ------------------------------
    Kind regards,

    Matthieu Hattab
    Lyse Platform
    ------------------------------