Configure the spoke selector for external systems

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 2 Minuten Lesedauer

    • Configure the spoke selector for Aria to enable the configuration and execution of billing requests.

    Vorbereitungen

    Role required: admin

    Warum und wann dieser Vorgang ausgeführt wird

    The spoke selector application provides a common framework that enables the configuration and execution of integration requests. It operates by selecting the matching implementations based on the configured input parameters for each request.

    Prozedur

    1. Navigate to All > Spoke selector > Request type.
    2. Select Billing request.

      The billing request is configured with a request definition that invokes Aria APIs. This demo implementation serves as a reference for configuring a new request definition that retrieves billing-related data from a third-party system for billing requests.

    3. Create the Integration request definitions.

      By giving an appropriate value for Order or by defining the Selection condition the new request definition that fetches the billing-related data is triggered.

    4. To create Integration request definitions, navigate to All > Spoke selector > Request definition.
    5. In the Integration request definitions screen, select New in the header section.
      Integration request definitions screen.
    6. On the form, fill in the fields.
      Tabelle : 1. Integration request type form
      Field Description
      Name Name of the integration request type.
      Type Billing request selection is made as the integration request type.
      Description Brief description of the request definition.
      Order Request definition is executed in the least order value.
      Adapter type Flow
      Request adapter Name of the Flow configured to fetch the records for the respective configuration type.
      Hinweis:
      The sys_hub_flow record with the correct flow inputs, flow outputs, and flow snapshots.
      Application Store application details.
      Domain Global
      Condition Condition to trigger the request adapter.
      The following parameters must be included in the request for the Get Account Details Request for Aria API request adapter:
      
{"api_name":"get_acct_details","request_body":{"client_acct_id":"FT0010001"}}
      The following parameters must be included in the response for the Get Account Details Response for Aria API request adapter:
      {"status_code":"1","status_reason":"","response_body":{"master_plan_info_list":{"48477095":"Business Internet + 
           Cellphone PI0001061"},"company_name":"Flash Telecom","acct_no":"27045400"}}
      The following parameters must be included in the request for the Get Invoice History Request for Aria API request adapter:
      {"api_name":"get_invoice_history","request_body":{"acct_no":"27045400"}}
      The following parameters must be included in the response for the Get Invoice History Response for Aria API request adapter:
      {"status_code":"1","status_reason":"","response_body":{"invoices":
[{"amount":135.7,"invoice_no":254547358,"due_date":"2024-11-
30","outstanding_amount":135.7,"usage_bill_from":"2024-10-01","usage_bill_thru":"2024-10-31"},
{"amount":190.26,"invoice_no":254547359,"due_date":"2024-12-
31","outstanding_amount":190.26,"usage_bill_from":"2024-11-01","usage_bill_thru":"2024-11-30"},
{"amount":172.95,"invoice_no":254547360,"due_date":"2025-01-
31","outstanding_amount":172.95,"usage_bill_from":"2024-12-01","usage_bill_thru":"2024-12-31"},
{"amount":437.07,"invoice_no":254547361,"due_date":"2025-02-
28","outstanding_amount":0,"usage_bill_from":"2025-01-01","usage_bill_thru":"2025-01-31"}]}}
      The following parameters must be included in the request for the Get Invoice Details Request for Aria API request adapter:
      {"api_name":"get_invoice_details","request_body":{"acct_no":"27045400","invoice_no":"254547361"}}
      The following parameters must be included in the response for the Get Invoice Details Response for Aria API request adapter:
      {"status_code":"1","status_reason":"","response_body":{"line_items":
[{"usage_type_no":10058138,"amount":0,"service_name":"Mobile Data
GB","sold_product_number":"PI0001065","service_no":11196572,"description":"Mobile Data GB (10 gigabytes @
$0)"},{"usage_type_no":10058138,"amount":14.35,"service_name":"Mobile Data
GB","sold_product_number":"PI0001065","service_no":11196572,"description":"Mobile Data GB (18.847 gigabytes
@ $1)"},{"usage_type_no":10058140,"amount":255.73,"service_name":"International Roaming Calls from
EU","sold_product_number":"PI0001065","service_no":11197966,"description":"International Roaming Calls from
EU (93 minutes @ $2.75)"},{"usage_type_no":10058144,"amount":0.5,"service_name":"Domestic
Minutes","sold_product_number":"PI0001065","service_no":11196568,"description":"Domestic Minutes (9.91
minutes @ $.05)"},{"usage_type_no":10058146,"amount":11.75,"service_name":"International Calls to
Asia","sold_product_number":"PI0001065","service_no":11196570,"description":"International Calls to Asia (6.56
minutes @ $1.79)"}]}}
    7. Select Save.

    Ergebnisse

    Once the condition is set and the request condition matched, the defined flow executes and the records for the configuration are fetched from the external provider that you selected, into your ServiceNow instance.