Open APIs

Expand all | Collapse all

TMF654 - TransferBalance POST API - How to identify Buckets

  • 1.  TMF654 - TransferBalance POST API - How to identify Buckets

    TM Forum Member
    Posted Mar 10, 2021 07:10
    Edited by Karan Agrawal Mar 10, 2021 07:10
    Hello Experts,

    As per TMF-654 User Guide v4.0.0, TransferBalance POST API needs one of
    • logicalResourceRef
    • productRef
    • bucketRef
    • relatedParty
    How can productRef / relatedParty / logicalResourceRef identify a particular bucket?
    At any given time, a user can have 2+ buckets ACTIVE for same productRef.
    For instance, a subscriber gets 100 Free Minutes every month as part of regular plan and a special add-on plan is purchased which grants 50 Free Minutes for 15 days.
    These will be two different buckets, though the same usageType / productRef because the validities are different.

    With this situation, is there a direction on which bucket should be picked?

    Thanks,
    ------------------------------
    Karan Agrawal
    Oracle Corporation
    ------------------------------


  • 2.  RE: TMF654 - TransferBalance POST API - How to identify Buckets

    TM Forum Member
    Posted 29 days ago
    Edited by Surender Prakash Sharma 29 days ago
    Hi Karan,
    From API definition, its clear that API client will have knowledge about bucket (by Get operation for instance) associated with RelatedParty and ProductRef.
    This imply that client application is more like orchestrator which can interact with ABMF function per 3GPP and directory work with balance monetary or non monetary.
    In addition I believe it would have been nice if each API spec would somehow map to layered architecture ( meaning it imply at system level or business level or experience level)?
    ​​

    ------------------------------
    Surender Prakash Sharma
    Nokia
    ------------------------------



  • 3.  RE: TMF654 - TransferBalance POST API - How to identify Buckets

    TM Forum Member
    Posted 22 days ago
    Hi Surender,

    I agree that API client will have knowledge of the buckets (GET Operation) and as long as bucket is sent, it is no problem!

    But, Transfer Balance Use Cases clearly state that API client can invoke by sending productRef, without explicitly specifying Bucket information.
    This is where confusion rises!
    There could be buckets with overlapping validity which brings up challenges in picking the right one when only productRef is specified.

    ------------------------------
    Karan Agrawal
    Oracle Corporation
    ------------------------------