Open APIs

 View Only
  • 1.  Refunds in TMF 622 Product Order Management

    TM Forum Member
    Posted 8 days ago

    Hi all,

    As part of change product orders, customer might want to return some items or downgrade his plan leading to some refunds being issued to the customer in context of the Change Product Order.

    How does TMF 622 Product Order suite of APIs propose to handle refunds to the customer?



    ------------------------------
    Varun Pandhi
    Infosys
    ------------------------------


  • 2.  RE: Refunds in TMF 622 Product Order Management

    TM Forum Member
    Posted 7 days ago
    Edited by Matthieu Hattab 5 hours ago

    Hi,

    It doesn't. TMF 622 is about product ordering, which impact Profit & Loss.

    monetary transactions (credit, payment, refund...) are Balance Sheet operation only (what TM Forum ODA calls "Party Financial Management activities")

    you need a totally different API like TMF676, possibly 670.

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

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



  • 3.  RE: Refunds in TMF 622 Product Order Management

    TM Forum Member
    Posted 7 days ago

    Thanks Matthieu

    I think that Varun is wondering how the business process of product ordering cause payments and refunds to be initiated. I would say that this is part of the internal business logic of a Product Order Management system (or the corresponding ODA components). Based on the actual order data and the prices defined in the catalog, the OM system would need to collect payments and/or issue refunds.

    Of course these would also need to be recorded as applied customer billing rates on the customer bill.



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



  • 4.  RE: Refunds in TMF 622 Product Order Management

    TM Forum Member
    Posted 7 days ago
    Edited by Varun Pandhi 7 days ago

    Thanks Matthieu and Jonathan for response.

    Essentially to summarize we could use Refund resource defined in TMF 676 Payment Management API and associate it to an Account, but there is no means to know refund came about as part of which ProductOrder or ProductOrderItem. Am I correct?

    Or is CorrelationId meant to satisfy this requirement wherein CorrelationId on Refund resource would hold TMF Id of ProductOrderItem due to which it was initiated?



    ------------------------------
    Varun Pandhi
    Infosys
    ------------------------------



  • 5.  RE: Refunds in TMF 622 Product Order Management

    TM Forum Member
    Posted 6 days ago

    I think that correlatorID is intended for a consumer to refer a refund or a payment to its own records (semantically I would have preferred to use ExternalIdentifier for this).

    Payment has a list of PaymentItems, where each item has an entity reference to the entity that caused the payment item to be made (e.g. an order, a bill, etc.). However Refund does not have this corresponding list - we should consider adding it.



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



  • 6.  RE: Refunds in TMF 622 Product Order Management

    TM Forum Member
    Posted 16 hours ago
    Edited by Varun Pandhi 16 hours ago

    Hi Jonathan,

    Thanks for your response, however when a POST Product Order API is fired, refund is issued to the customer as a result of the ProductOrder creation, so is there any way in which we can have a reference to Refund in ProductOrder resource/ POST ProductOrder API response?

    Similarly, for the payment methods as well, a customer might be supporting multiple payment methods (Bill to Account, Credit Card Payment, Cash, Debit Card Payment etc.). While placing a Product Order, they would want to specify which payment method (from the allowed payment methods) to use for a particular ProductOrder. Is there a mechanism in TMF 622 ProductOrder resource/POST ProductOrder API request to provide the same?



    ------------------------------
    Varun Pandhi
    Infosys
    ------------------------------



  • 7.  RE: Refunds in TMF 622 Product Order Management

    TM Forum Member
    Posted 13 hours ago

    Hi Varun

    Let's look at this from a fine-grained perspective. A ProductOrder generally has multiple ProductOrderPrice, representing one-time, recurring, and usage charges that result from the order itself and of course from the ongoing ownership of the Product. Each Price subentity should be associated with an Account subclass (in most cases this will be a Billing Account), and the charges will be applied (AppliedCustomerBillingRate - ACBR) to that account and will affect the account balance. This is indeed reflected in the model.

    Some charges may need to be paid up-front, at ordering time, e.g. device purchase, first recurring charge, etc. And in your case, some charges may need to be refunded directly to a payment method (instead of being credited on the next bill).

    If we look at the current Open API model, we can see that there is room for improvement in this area:

    • How can it be "known" at ordering time which Prices are to be paid up-front - this could be a catalog designation, or something determined at ordering time by policy rules
    • Similarly, how can it be known that negative charges/credits need to refunded immediately

    However, once it is determined that an immediate payment/refund needs to be made, the association of a payment method is supported as part of the Payment Management API TMF676.

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



  • 8.  RE: Refunds in TMF 622 Product Order Management

    TM Forum Member
    Posted 5 hours ago
    Edited by Matthieu Hattab 5 hours ago

    I've been playing with the TMF AI assistant. It's fun and can be helpful.

    Use it and ask your question! I tried it and it was quite interesting. It suggests to use TMF700 as well.
    A good prompt is obviously important, so you may want to try different ones.

    it also confirms that TMF has not defined RMAs.



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

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



  • 9.  RE: Refunds in TMF 622 Product Order Management

    TM Forum Member
    Posted 53 minutes ago

    I was worried that AIVA would take my place as the lead responder on this community. However, when I asked AIVA itself if it had a chance of overtaking me, it denied all knowledge of the Engage community and also of me ...

    It did return search results about me, so maybe I should be worried ...



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