Open APIs

 View Only
  • 1.  Open APi for Get debt from customer

    Posted Jun 02, 2021 11:52
    Excuse me, you already know if exist an api that perform a query of all debts of customer has, like a list payments operation described in open api Payment Managment TMF676 that consults all payments made by the customer.

    I thank you in advance for your support.

    Best Regards

    Christopher



    ------------------------------
    Christopher Gabriel Crespo Leon
    Claro Ecuador
    ------------------------------


  • 2.  RE: Open APi for Get debt from customer

    TM Forum Member
    Posted Jun 02, 2021 12:12
    Hi Christopher
    Can you elaborate more on what you mean by "debt" in this context?
    Seemingly the debt of a customer (what does she "owe" the service provider) is codified in the A/R (post-paid) balance on the customer's BillingAccount (may have multiple accounts). So you could do a GET on BillingAccount filtering by RelatedParty.id = the ID of the customer, and then list the balances from each BillingAccount.
    Does this help?

    ------------------------------
    Jonathan Goldberg
    Amdocs Management Limited
    Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
    ------------------------------



  • 3.  RE: Open APi for Get debt from customer

    Posted Jun 03, 2021 01:27
    Edited by Christopher Gabriel Crespo Leon Jun 05, 2021 22:22
      |   view attached
    Hi,
    How are you,
    Thanks for answering
    
    I would like to get a report of the age of all the debts (receivable aging reports) that the client has with the service provider. In order to validate if I can sell more products or services.
    An example of this would be the following report

    ID/RUC/TIN 1091921649
    Customer CENTRO COMERCIAL KIPITO CIA. LTDA.
    Billing Account 1-11075622 ACTIVE
    debt type Debt Accounts Receivable Aging
    ADENDUM $00.00 0 days
    CELULAR $10.00 10 days
    CELULAR(AR CURRENT) $60.00 90 days
    Billing Account 9-698434 ACTIVA
    debt type Debt Accounts Receivable Aging
    ADENDUM $966.72 1780 days
    CELULAR $0.00 0 days
    CELULAR(AR CURRENT) $0.00 0 days
    Billing Account DTXXX-011107380 ACTIVE
    debt type Debt Accounts Receivable Aging
    ADENDUM $00.00 0 days
    GPR INTERNET $37.16 14 days
    GPR INTERNET(AR CURRENT) $0.00 0 days
    Billing Account DTYYY-00117NN ACTIVE
    debt type Debt Accounts Receivable Aging
    ADENDUM $00.00 0 days
    GPR INTERNET $153.74 14 days
    GPR INTERNET(AR CURRENT) $0.00 0 days
    black list: NO
    Amount of Active Services: 1759
    Amount of Inactive Services: 5078
    Inactive accounts in the last 60 days: NO

    We were thinking of using the open api TMF678 where we will get all invoices with pending status, but this did not cover all the requirement. Then we evaluate using the List payment operation format adapting it to show the debt, as shown TMF676_Payment_Management_API_User_Guide_v4.0.0.pdf (page 26 - 30)

    GET serverRoot/paymentManagement/v4/payment
    New api:
    GET serverRoot/DebtManagement/v4/debt

    Which of the existing open apis could add this new operation.

    I appreciate your advice in advance
    ------------------------------
    Christopher Gabriel Crespo Leon
    Claro Ecuador
    ------------------------------



  • 4.  RE: Open APi for Get debt from customer

    TM Forum Member
    Posted Jun 04, 2021 04:37
    Hi Christopher,

                   TMF 678 deals with Customer bill, at most it has capability to indicate if the invoice was paid (fully, partially) or not at all.

                   On the other hand Payment Management deals with individual payments.

                   From the information you have attached, it appears you are looking for Aging report or Age Trial Balance which falls into Account Receivables functional domain. As of today TMF has not defined the specifications for it however we expect to have them in near future.

    thanks,

    ------------------------------
    -----------------------------------------------------
    Nitin Patil
    Portfolio Architect BSS + B2B
    Amdocs India Limited
    Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer
    -----------------------------------------------------
    ------------------------------



  • 5.  RE: Open APi for Get debt from customer

    Posted Jun 04, 2021 07:43
    Edited by Christopher Gabriel Crespo Leon Jun 05, 2021 22:24
      |   view attached
    HI
    
    If I wanted to extend the model of an existing Open Api (add a capabilities), which would be the ID of the Open API on which I could do it.
    
    We are doing an integration with CRM and I would like in short-term provide that the debt query proposal is not be far from the standard. The idea is to manage the facade pattern to expose standardized contracts on a legacy system.
    I was also able to review the open api roadmap I thought the api that I should work is the "Dunning Case API"
    
    Dunning Case API
    The collection (dunning) is to control the overdue charge (arrear) of the customer by the way of notification and service limitation.

    Referenced in the attached file name open API roadmap (See attached file)
    Could you suggest me which open api ID could extend this capabilities or how could I solve this scenario.




    ------------------------------
    Christopher Gabriel Crespo Leon
    Claro Ecuador
    ------------------------------

    Attachment(s)