End an Offline-Only Charging Session

post

{apiRoot}/nchf-convergedcharging/v1/offlinechargingdata/{OfflineChargingDataRef}/release

Ends an offline-only data charging session.

Request

Path Parameters
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
An offline-only charging request.
Show Source
Nested Schema : multipleUnitUsage
Type: array
Minimum Number of Items: 0
A list of multiple unit usage.
Show Source
Nested Schema : NFIdentification
Type: object
A grouped field that contains a set of information identifying the NF consumer of the charging service.
Show Source
Nested Schema : PDUSessionChargingInformation
Type: object
The 5G data connectivity-specific information.
Show Source
Nested Schema : RoamingQBCInformation
Type: object
The 5G data connectivity-specific information for roaming QBC.
Show Source
Nested Schema : triggers
Type: array
Minimum Number of Items: 0
A list of triggers.
Show Source
Nested Schema : MultipleUnitUsage
Type: object
Show Source
Nested Schema : RequestedUnit
Type: object
Show Source
Nested Schema : usedUnitContainer
Type: array
Minimum Number of Items: 0
Show Source
Nested Schema : UsedUnitContainer
Type: object
Show Source
Nested Schema : eventTimeStamps
Type: array
Minimum Number of Items: 0
Show Source
Nested Schema : NSPAContainerInformation
Type: object
Show Source
Nested Schema : PDUContainerInformation
Type: object
Show Source
Nested Schema : triggers
Type: array
Minimum Number of Items: 0
Show Source
Nested Schema : NsiLoadLevelInfo
Type: object
Represents the network slice and optionally the associated network slice instance and the load level information.
Show Source
Nested Schema : ServiceExperienceInfo
Type: object
Represents service experience information.
Show Source
Nested Schema : Throughput
Type: object
Show Source
Nested Schema : NetworkAreaInfo
Type: object
Describes a network area in which the NF service consumer requests the number of UEs.
Show Source
Nested Schema : NumberAverage
Type: object
Represents average and variance information.
Show Source
Nested Schema : ResourceUsage
Type: object
The current usage of the virtual resources assigned to the NF instances belonging to a particular network slice instance.
Show Source
Nested Schema : Snssai
Type: object
The S-NSSAIs of the NF.
Show Source
  • Pattern: ^[A-Fa-f0-9]{6}$
    The S-NSSAI Slice Differentiator (SD) ID of the network slices that are allowed to access the HTTP Gateway server.
  • Minimum Value: 0
    Maximum Value: 255
    The S-NSSAI Slice/Service Type (SST) ID of the network slices that are allowed to access the HTTP Gateway server.
Nested Schema : TimeWindow
Type: object
Represents a time window identified by a start time and a stop time.
Show Source
Nested Schema : ecgis
Type: array
Minimum Number of Items: 1
Contains a list of E-UTRA cell identities.
Show Source
Nested Schema : gRanNodeIds
Type: array
Minimum Number of Items: 1
Contains a list of NG RAN nodes.
Show Source
Nested Schema : ncgis
Type: array
Minimum Number of Items: 1
Contains a list of NR cell identities.
Show Source
Nested Schema : tais
Type: array
Minimum Number of Items: 1
Contains a list of tracking area identities.
Show Source
Nested Schema : Ecgi
Type: object
Show Source
Nested Schema : PlmnId
Type: object
Show Source
Nested Schema : GlobalRanNodeId
Type: object
Show Source
Match One Schema
Show Source
Nested Schema : GNbId
Type: object
Show Source
Nested Schema : Ncgi
Type: object
Show Source
Nested Schema : Tai
Type: object
Show Source
Nested Schema : supis
Type: array
Minimum Number of Items: 1
Show Source
Nested Schema : SteeringMode
Type: object
Contains the steering mode value and parameters determined by the PCF.
Show Source
Nested Schema : presenceReportingAreaInformation
Type: object
Minimum Number of Properties: 0
Additional Properties Allowed
Show Source
Nested Schema : QosCharacteristics
Type: object
Contains QoS characteristics for a non-standardized or a non-configured 5QI.
Show Source
Nested Schema : QosData
Type: object
Show Source
Nested Schema : servingNodeID
Type: array
Minimum Number of Items: 0
Show Source
Nested Schema : UserLocation
Type: object
Show Source
Nested Schema : ThresholdValue
Type: object
Indicates the threshold values for round-trip time (RTT) and packet loss rate.
Show Source
Nested Schema : PresenceInfo
Type: object
Show Source
Nested Schema : ecgiList
Type: array
Minimum Number of Items: 1
Show Source
Nested Schema : globalRanNodeIdList
Type: array
Minimum Number of Items: 1
Show Source
Nested Schema : ncgiList
Type: array
Minimum Number of Items: 1
Show Source
Nested Schema : trackingAreaList
Type: array
Minimum Number of Items: 1
Show Source
Nested Schema : Arp
Type: object
Show Source
Nested Schema : ServingNetworkFunctionID
Type: object
Show Source
Nested Schema : EutraLocation
Type: object
Show Source
Nested Schema : N3gaLocation
Type: object
Show Source
Nested Schema : NrLocation
Type: object
Show Source
Nested Schema : Ipv6Addr
Match All
Show Source
  • Pattern: ^((:|(0?|([1-9a-f][0-9a-f]{0,3}))):)((0?|([1-9a-f][0-9a-f]{0,3})):){0,6}(:|(0?|([1-9a-f][0-9a-f]{0,3})))$
  • Pattern: ^((([^:]+:){7}([^:]+))|((([^:]+:)*[^:]+)?::(([^:]+:)*[^:]+)?))$
Example:
2001:db8:85a3::8a2e:370:7334
Nested Schema : Trigger
Type: object
Show Source
  • Minimum Value: 0
  • Allowed Values: [ "IMMEDIATE_REPORT", "DEFERRED_REPORT" ]
  • Allowed Values: [ "QUOTA_THRESHOLD", "QHT", "FINAL", "QUOTA_EXHAUSTED", "VALIDITY_TIME", "OTHER_QUOTA_TYPE", "FORCED_REAUTHORISATION", "UNUSED_QUOTA_TIMER", "UNIT_COUNT_INACTIVITY_TIMER", "ABNORMAL_RELEASE", "QOS_CHANGE", "VOLUME_LIMIT", "TIME_LIMIT", "EVENT_LIMIT", "PLMN_CHANGE", "USER_LOCATION_CHANGE", "RAT_CHANGE", "SESSION_AMBR_CHANGE", "UE_TIMEZONE_CHANGE", "TARIFF_TIME_CHANGE", "MAX_NUMBER_OF_CHANGES_IN_CHARGING_CONDITIONS", "MANAGEMENT_INTERVENTION", "CHANGE_OF_UE_PRESENCE_IN_PRESENCE_REPORTING_AREA", "CHANGE_OF_3GPP_PS_DATA_OFF_STATUS", "SERVING_NODE_CHANGE", "REMOVAL_OF_UPF", "ADDITION_OF_UPF", "INSERTION_OF_ISMF", "REMOVAL_OF_ISMF", "CHANGE_OF_ISMF", "START_OF_SERVICE_DATA_FLOW", "ECGI_CHANGE", "TAI_CHANGE", "HANDOVER_CANCEL", "HANDOVER_START", "HANDOVER_COMPLETE", "GFBR_GUARANTEED_STATUS_CHANGE", "ADDITION_OF_ACCESS", "REMOVAL_OF_ACCESS", "START_OF_SDF_ADDITIONAL_ACCESS" ]
  • Minimum Value: 0
  • Minimum Value: 0
Nested Schema : PDUSessionInformation
Type: object
Show Source
Nested Schema : presenceReportingAreaInformation
Type: object
Minimum Number of Properties: 0
Additional Properties Allowed
Show Source
Nested Schema : RANSecondaryRATUsageReport
Type: object
Show Source
Nested Schema : UserInformation
Type: object
Show Source
Nested Schema : AuthorizedDefaultQos
Type: object
Show Source
Nested Schema : Ambr
Type: object
Show Source
Nested Schema : MAPDUSessionInformation
Type: object
Show Source
Nested Schema : NetworkSlicingInfo
Type: object
Show Source
Nested Schema : PDUAddress
Type: object
Show Source
Nested Schema : SubscribedDefaultQos
Type: object
Show Source
Nested Schema : qosFlowsUsageReports
Type: array
Show Source
Nested Schema : QosFlowsUsageReport
Type: object
Show Source
Nested Schema : multipleQFIcontainer
Type: array
Minimum Number of Items: 0
Show Source
Nested Schema : RoamingChargingProfile
Type: object
Show Source
Nested Schema : MultipleQFIcontainer
Type: object
Show Source
Nested Schema : QFIContainerInformation
Type: object
Show Source
Nested Schema : triggers
Type: array
Minimum Number of Items: 0
Show Source
Nested Schema : enhancedDiagnostics
Type: array
Show Source
Nested Schema : presenceReportingAreaInformation
Type: object
Minimum Number of Properties: 0
Additional Properties Allowed
Show Source
Nested Schema : servingNetworkFunctionID
Type: array
Minimum Number of Items: 0
Show Source
Nested Schema : triggers
Type: array
Minimum Number of Items: 0
Show Source
Back to Top

Response

Supported Media Types

204 Response

The data charging session was ended successfully.

401 Response

Unauthorized request.
Body ()
Root Schema : ProblemDetails
Type: object
Information about an error.
Show Source
Nested Schema : invalidParams
Type: array
Minimum Number of Items: 1
A list of invalid parameters.
Show Source
Nested Schema : InvalidParam
Type: object
An invalid parameter.
Show Source

404 Response

The requested resource couldn't be found.
Body ()
Root Schema : ProblemDetails
Type: object
Information about an error.
Show Source
Nested Schema : invalidParams
Type: array
Minimum Number of Items: 1
A list of invalid parameters.
Show Source
Nested Schema : InvalidParam
Type: object
An invalid parameter.
Show Source

410 Response

The requested resource is no longer available.
Body ()
Root Schema : ProblemDetails
Type: object
Information about an error.
Show Source
Nested Schema : invalidParams
Type: array
Minimum Number of Items: 1
A list of invalid parameters.
Show Source
Nested Schema : InvalidParam
Type: object
An invalid parameter.
Show Source

411 Response

The request didn't include the required length.
Body ()
Root Schema : ProblemDetails
Type: object
Information about an error.
Show Source
Nested Schema : invalidParams
Type: array
Minimum Number of Items: 1
A list of invalid parameters.
Show Source
Nested Schema : InvalidParam
Type: object
An invalid parameter.
Show Source

413 Response

The request payload is too large.
Body ()
Root Schema : ProblemDetails
Type: object
Information about an error.
Show Source
Nested Schema : invalidParams
Type: array
Minimum Number of Items: 1
A list of invalid parameters.
Show Source
Nested Schema : InvalidParam
Type: object
An invalid parameter.
Show Source

500 Response

The system encountered an internal error.
Body ()
Root Schema : ProblemDetails
Type: object
Information about an error.
Show Source
Nested Schema : invalidParams
Type: array
Minimum Number of Items: 1
A list of invalid parameters.
Show Source
Nested Schema : InvalidParam
Type: object
An invalid parameter.
Show Source

503 Response

The server cannot handle the request due to overload or maintenance.
Body ()
Root Schema : ProblemDetails
Type: object
Information about an error.
Show Source
Nested Schema : invalidParams
Type: array
Minimum Number of Items: 1
A list of invalid parameters.
Show Source
Nested Schema : InvalidParam
Type: object
An invalid parameter.
Show Source

Default Response

Generic Error
Back to Top

Examples

The following example shows how to end an Nchf offline-only charging session by submitting a POST request on the REST resource using cURL. For more information about cURL, see "Use cURL".

The -d option specifies the file to attach as the request body.

curl -X POST "apiroot/nchf-convergedcharging/v1/offlinechargingdata/87cfb534-9efa-5192-41fd-cbcfdb053226%20/release" -H "accept: */*" -H "Content-Type: application/json" -d @file.json

where:

  • apiRoot is for accessing the HTTP Gateway server at either http://hostname:httpPort or https://hostname:httpsPort.

  • file.json is the JSON file that specifies the offline-only charging session to end.

Example of Request Body

The following is an example of the contents of file.json sent as the request body:

{
   "invocationSequenceNumber": 3,
   "invocationTimeStamp": "2018-09-24T09:30:33.882Z",
   "multipleUnitUsage": [
      {
         "ratingGroup": 10,
         "usedUnitContainer": [{
            "localSequenceNumber": 0,
            "quotaManagementIndicator":"OFFLINE_CHARGING",
            "time": 300
         }],
         "uPFID": "123e4567-e89b-12d3-a456-426655440000"
      }
   ],
   "nfConsumerIdentification": {
      "nodeFunctionality": "SMF"
   },
   "notifyUri": "http://test-notification-url",
   "pDUSessionChargingInformation": {
      "chargingId": 1000,
      "pduSessionInformation": {
         "pduSessionID": 1,
         "dnnId": "1"
      }
   },
   "roamingQBCInformation": {},
   "subscriberIdentifier": "imsi-4900000001",
   "triggers": [
      {
         "triggerCategory": "IMMEDIATE_REPORT",
         "triggerType": "QUOTA_THRESHOLD"
      }
   ]
}

Example of Response Body

If successful, the response code 204 is returned along with a header. For example:

connection: keep-alive
date: Tue, 12 Jul 2022 08:37:35 +0530

If the request fails, the response includes the appropriate HTTP code. For a 4xx/5xx code, the message body also contains a ProblemDetails structure with the cause attribute set to the appropriate application error.

Back to Top