Open APIs

Expand all | Collapse all

TMF 641 - understanding Cancel Service Order resource

  • 1.  TMF 641 - understanding Cancel Service Order resource

    TM Forum Member
    Posted Jun 18, 2020 19:01
    Hi there,

    While going through the TMF 641 v4 document, we have noticed the introduction of the new resource for Cancel Service Oder resource. Wanted to understand below points in regards to that:

    1) Since "state" is a patchable attribute in V4 , can the consumers not directly do a patch on state for an inflight order. New states introduced in V4 like "assessingCancellation" and "Pending cancellation" can be used for long running cancellation

    2) Is there any reference to understand the use case for introduction of Cancel service order resource?

    Thanks,
    Rati

    ------------------------------
    Rati Mehrotra
    Telstra Corporation
    ------------------------------


  • 2.  RE: TMF 641 - understanding Cancel Service Order resource

    TM Forum Member
    Posted Jun 19, 2020 04:47
    Hello Rati

    Adding a cancelOrder cames from the work done in cooperation with the MEF. In business between service provider it makes sense to have an operation requesting cancelling (product) order (and not allowing to modify the order itself). This cancellation request could take time, have its own status and required additional information (like cancellation reason) . Using the TMF Task pattern was assessed as a good option and in order to get MEF/TMF alignement MEF opted this way for product order.

    Then this feature was redistributed to TMF and to have global API consistence we introduced it to all order API (product/service/resource).

    Nothing prevent to still use a PATCH but to manage long running task you'll have to use Monitor pattern.

    Hope it helps,

    Ludovic

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



  • 3.  RE: TMF 641 - understanding Cancel Service Order resource

    TM Forum Member
    Posted Jun 21, 2020 22:53
    Hi Ludovic,

    Thanks for this information. Is there any Jira  or any other link that i can refer to?

    Thanks,
    Rati


    ------------------------------
    Rati Mehrotra
    Telstra Corporation
    ------------------------------



  • 4.  RE: TMF 641 - understanding Cancel Service Order resource

    TM Forum Member
    Posted Jul 06, 2020 02:47
      |   view attached
    Hi Ludovic,
    Thanks for your assistance.

    Can you also please assist in the following queries on cancelling an order.

    1) As mentioned earlier, since service state is a patchable attribute, PATCH on service state can also be done for cancelling service order. According to 641 state transition, cancel state can be reached only from pending and held. Currently there is no state transition available from inProgress/acknowledge to Cancel. How can the consumer cancel if the service order state is inprogress/acknowledged? Attaching a presentation if further clarification is required.

    2) cancelServiceOrder exposes only GET and POST operations, how can the consumer modify(like requestedCancellationDate) or withdraw a cancelServiceOrder?

    Cheers,
    Rati

    ------------------------------
    Rati Mehrotra
    Telstra Corporation
    ------------------------------

    Attachment(s)

    pptx
    Presentation1.pptx   197K 1 version


  • 5.  RE: TMF 641 - understanding Cancel Service Order resource

    TM Forum Member
    Posted Jul 06, 2020 03:24
    Hello Rati

    1) Agreed with you. The 'cancelled' & 'assessiongCancellation" states should be reached from inProgress & Acnowledged. It was discussed as it and the state engine did do show it. We should add these transitions for next release (or before)
    2) This is also a very good point; Perhaps trickier than the previous one because we could trigger some complex loop.

    Because you company is part of the TMF API projet may I request you to trigger 2 separate JIRAs for these please? It will be them easier to track them for next release.
    Thanks

    Ludovic

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



  • 6.  RE: TMF 641 - understanding Cancel Service Order resource

    TM Forum Member
    Posted Jul 06, 2020 19:59
    Edited by Rati Mehrotra Jul 06, 2020 21:18
    Hi Ludovic,

    Have raised a request for getting access to the API project

    Thanks,
    Rati

    ------------------------------
    Rati Mehrotra
    Telstra Corporation
    ------------------------------



  • 7.  RE: TMF 641 - understanding Cancel Service Order resource

    TM Forum Member
    Posted Jul 07, 2020 20:30
    Hi Ludovic,

    Have created the two Jira tickets.

    https://projects.tmforum.org/jira/browse/AP-2279

    https://projects.tmforum.org/jira/browse/AP-2280


    Thanks,
    Rati

    ------------------------------
    Rati Mehrotra
    Telstra Corporation
    ------------------------------



  • 8.  RE: TMF 641 - understanding Cancel Service Order resource

    TM Forum Member
    Posted Jul 08, 2020 03:21
    Thanks Rati - that will be very helpful to track these.

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