Create Resource for Offline-Only Charging

post

{apiRoot}/nchf-convergedcharging/v1/offlinechargingdata

Creates a request to start offline-only charging.

Request

There are no request parameters for this operation.

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

201 Response

The resource was created successfully.
Body ()
Root Schema : OffChargingDataResponse
Type: object
A response to a request for offline-only charging.
Show Source
Nested Schema : InvocationResult
Type: object
The result.
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
Show Source
Nested 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
Nested Schema : UserLocation
Type: object
Show Source
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 : EutraLocation
Type: object
Show Source
Nested Schema : N3gaLocation
Type: object
Show Source
Nested Schema : NrLocation
Type: object
Show Source
Nested Schema : Ecgi
Type: object
Show Source
Nested Schema : GlobalRanNodeId
Type: object
Show Source
Match One Schema
Show Source
Nested Schema : Tai
Type: object
Show Source
Nested Schema : PlmnId
Type: object
Show Source
Nested Schema : GNbId
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 : Ncgi
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 : ServingNetworkFunctionID
Type: object
Show Source
Nested Schema : SubscribedDefaultQos
Type: object
Show Source
Nested Schema : Arp
Type: object
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 : NFIdentification
Type: object
A grouped field that contains a set of information identifying the NF consumer of the charging service.
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 : 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 : 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 : servingNetworkFunctionID
Type: array
Minimum Number of Items: 0
Show Source
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 : triggers
Type: array
Minimum Number of Items: 0
Show Source

400 Response

The request isn't valid.
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

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

403 Response

The request wasn't authorized.
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 create a resource for an Nchf offline-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" -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-charging session to create.

Example of Request Body

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

{
    "invocationSequenceNumber": 1,
    "invocationTimeStamp": "2018-09-24T07:30:33.882Z",
    "notifyUri": "http://test-notification-url",
    "nfConsumerIdentification": {
 
        "nodeFunctionality": "SMF"
 
    },
    "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 201 is returned along with a header and a response body. The following shows sample header contents:

connection: keep-alive
content-type: application/json
date: Tue, 12 Jul 2022 08:33:07 +0530
location: apiroot/nchf-convergedcharging/v1/offlinechargingdata/87cfb534-9efa-5192-41fd-cbcfdb053226
transfer-encoding: chunked

The following shows sample response body contents:

{
   "invocationTimeStamp": "2018-09-24T13:00:33.882+05:30",
   "invocationSequenceNumber": 1
}

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