Can anyone share the relationship between servic qualification API TMF645 & Service Order API TMF641

Abhi53
Tera Contributor

4 weeks ago

Can anyone share the relationship between service qualification API TMF645 & Service Order API TMF641. I can trace that in scripted rest already OTB service qualification API is available but need details about the GET/POST operations via the service qualification API & real time usage for the same.

0 Helpfuls
  • 459 Views
6 REPLIES 6

Deepak Shaerma
Kilo Sage
Kilo Sage

Tuesday

@Abhi53 

Scenario: A customer, Jane, goes to a Telecom website to see if she can get 5G Home Internet.

  1. On the Website (The "Buyer"):

    • Jane enters her address: "123 Main St, Anytown, USA."

    • She clicks the "Check Availability" button.

  2. POST TMF645 (The Request):

    • The website's backend (the "Buyer") sends a POST request to the ServiceNow TMF645 API endpoint.

    • Request Body (simplified):

      JSON
       
      {
  "serviceQualificationItem": [
    {
      "service": {
        "place": [ { "address": "123 Main St..." } ],
        "serviceSpecification": { "id": "5G-Home-Internet" }
      }
    }
  ]
}

  3. Inside ServiceNow (The "Seller"):

    • The Scripted REST API receives the request.

    • It creates a new Customer Order, CS_ORD0010001, and sets its state to "Qualifying".

    • The attached workflow is triggered.

  4. The "Third Party" (The Check):

    • The workflow makes a POST call to an external API (the "third party"), which could be a Network Feasibility system.

    • ServiceNow asks: "Is 5G-Home-Internet available at 123 Main St?"

    • The Third Party responds: {"status": "available", "signal_strength": "excellent"}.

  5. Inside ServiceNow (The Update):

    • The workflow receives the "available" response.

    • It updates the Customer Order CS_ORD0010001.

    • The order state is changed from "Qualifying" to "Qualified".

    • The TMF645 API sends its final response back to the website.

  6. On the Website (The Result):

    • The website receives the "Qualified" response.

    • It displays a new message to Jane: "Great news! 5G Home Internet is available at your address."

    • A new button appears: "Order Now".

  7. The Handoff to TMF641:

    • Jane clicks the "Order Now" button.

    • This triggers a new API call from the website: a POST TMF641 (Service Order) request.

    • This TMF641 request re-uses the CS_ORD0010001 order, telling ServiceNow, "For that order you just qualified, start the fulfillment process."

    • ServiceNow moves the order state from "Qualified" to "In-Flight," and the provisioning (e.g., "Ship SIM card," "Activate account") begins.

 

Note: Please Mark this Helpful and Accepted Solution. If this Helps you to understand. This will help both the community and me..
- Keep Learning ‌‌
Thanks & Regards 
Deepak Sharma

Abhi53
Tera Contributor
In response to Deepak Shaerma

Wednesday

Hi Deepak, 
 
Thanks a ton for your detailed response with use case. 
 
It's a perfect example of service delivery which includes both service qualification & service order flows. 
 
In my case we are dealing from service assurance end... So we have to trigger service qualification API- TMF645, whenever customer is reporting any issue which needs manual intervention i.e. fiber disconnect... So we need to send service qualification input to third party and they will check it and respond if service is qualified or not for required troubleshooting. 
 
If response is qualified then we need to create service order via tmf 641 and pass details to third party so that they can carry on actual work. 
Similarly they will share updates on service order for the work delivered or issue resolved. 
 
Let's connect over call to discuss further if possible. 
 
Abhi
+91-8806062354
0 Helpfuls