Open APIs

  • 1.  Can We use TMF645 - QueryServiceQualification for BULK scneraios

    TM Forum Member
    Posted Oct 08, 2021 18:35
    Edited by Marlon Almazan Oct 08, 2021 18:44
    Hi,

    We would like to implement the solution for B2B customers and we would like to use TMF645 - CreateOrder for Multiple addresses in the same request.  This means, we would like to use the Searchcriteria as an array. Do we have any usecase where this is used in the similar way OR we should always use this  API for each address separately ?

    Thanks
    Arnab

    ------------------------------
    Arnab Kar
    Orange
    ------------------------------


  • 2.  RE: Can We use TMF645 - QueryServiceQualification for BULK scneraios

    TM Forum Member
    Posted Oct 10, 2021 08:53
    Hi Arnab
    To my understanding (and subject to qualification by @Ludovic Robert):
    • The check and query task resources both have array of item, where each item has an embedded Service. So you could in principle send in services with different related places.
    So purely from API perspective it would seem to be possible. But maybe your implementation would be complex if it has to check multiple addresses.
    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.
    ------------------------------



  • 3.  RE: Can We use TMF645 - QueryServiceQualification for BULK scneraios

    TM Forum Member
    Posted Oct 11, 2021 07:38
    Edited by Arnab Kar Oct 11, 2021 07:50
    Hi Jonathan,

    Thank you for your response however I still have queries: Please see the below sample JSON for QueryService:

    POST /tmf-api/serviceQualificationManagement/v4/queryServiceQualification

    {
        "description": "Query Service Qualification POST Illustration",
        "expectedQualificationDate": "2020-04-13T13:51:41.218Z",
        "instantSyncQualification": false,
        "externalId": "QSQ-456",
        "relatedParty": [
            {
                "id": "456",
                "href": "http://serverlocation:port/partyManagement/v4/party/456",
                "name": "Jean Pontus",
                "role": "Buyer contact",
                "@type": "RelatedParty",
                "@referredType": "Individual"
            }
        ],
        "searchCriteria": {
            "id": "1",
            "category": {
                "id": "1",
                "href": "http://serverlocation:port/serviceCatalogManagement/v4/category/1",
                "name": "Fiber Access",
                "@type": "Category"
            },
            "service": {
                "place": [
                    {
                        "role": "Installation Place",
                        "@type": "GeographicAddress",
                        "city": "San Francisco",
                        "postcode": "94121",
                        "streetName": "25th",
                        "streetType": "Avenue",
                        "streetNr": "437",
                        "geographicAddress": [
                            {
                                "levelType": "floor",
                                "levelNumber": "3"
                            }
                        ]
                    }
                ]
            },
            "@type": "SearchCriteria"
        },
        "@type": "QueryServiceQualification"
    }


    1.  If you see the highlighted objects - relatedParty, SearchCriteria, Place. As per the above example; Search Criteria is an OBJECT and not array.  However the Place is also an array.
    Does this mean that we can query the service qualification on multiple places within one searchCriteria? if yes, then how will the response be provided ? Will the response be sent in the iterative way for all the places ? As it might happen that the Service is qualified for one address and not for others. So specific response code should be provided against each of the place.

    2. What is the importance of the related party ? there is no link of the related party object to the search criteria. then in case of B2B customers how can we relate each of this related party to corresponding places in the Searchcriteria?

    3. In TMF schema ,if something is mentioned as an object, then can we change it to an type Array based on the requirements? Will it still be considered as conformed to TMF API ?

    Thanks,

    ------------------------------
    Arnab Kar
    Orange
    ------------------------------



  • 4.  RE: Can We use TMF645 - QueryServiceQualification for BULK scneraios

    TM Forum Member
    Posted Oct 12, 2021 05:02
    Dear Community members,

    Could you please extend your help on this Query ? It is bit important for us to understand if this API supports B2B customers in BULK ?

    Many thanks,
    Arnab

    ------------------------------
    Arnab Kar
    ------------------------------