Open APIs

Hi,
    Please some one can verify whether my understanding is correct or not for BillCycleSpecification atrributes which will refelect on Customer bill.

I took the Example as mentioned below
BillCycleSpecification Attributes : 13th of every month(Example)
billingDateShift : 3
chargeDateOffset : 2
creditDateOffset : 2
paymentDueDateOffset : 10
mailingDateOffset :3
billingPeriod : monthly
validFor : ?

BillCycle Attributes : 13th December 2021 (Example)
billingDate : 16th December 2021
chargeDate : 15th December
creditDate : 15th December
paymentDueDate: 23rd December 2021
mailingDate : 16th December 2021

Please check above example and  let me correct if i am wrong.

 Also please let me  how  and where  billing system will check to trigger bill generation

===================================================================================================

Thanks waiting for you valuable reply.

------------------------------
mukesh se n
C-DOT
------------------------------

Hi Mukesh,

           I see your point and also agree that the documentation is a bit confusing. I would like to explain the attributes from my perspective

billingDateShift : 3   ==> The documentation states "An offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period" --> In my view the bill settlement period is the date on which the billing cycle closes. So this attribute indicates the number of days after the cycle closes the bill would get generated. 

chargeDateOffset : 2  ==>  The documentation states "An offset of a date through which charges previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod."  --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is not more than billingDateShift.

creditDateOffset : 2  ==>  The documentation states "An offset of a date through which credits previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod" --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is not more than billingDateShift.

paymentDueDateOffset : 10 ==> The documentation states "An offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod." --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is more than the billingDateShift as per the local norms.

mailingDateOffset :3 ==> The documentation states "An offset of a customer bill mailing date. The offset is expressed as number of days with regard to the start of the BillingPeriod. --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is more than or equal to the billingDateShift.

        As per your example the billing cycle is closing on 13th December, all charges and Credits arriving before 15th of December are included in the Bill which will be generated on 16th December and emailed on the same date. The customer has 10 days from the close of the cycle to make the payment. So your example looks perfect to me.

Thanks,

------------------------------
-----------------------------------------------------
Nitin Patil
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
-----------------------------------------------------
------------------------------

thank you so much for valuable feedback and verification of my understanding .

------------------------------
mukesh se n
C-DOT
------------------------------

Original Message:
Sent: Mar 14, 2022 02:17
From: Nitin Patil
Subject: BillCycleSpecification - Attributes

Hi Mukesh,

           I see your point and also agree that the documentation is a bit confusing. I would like to explain the attributes from my perspective

billingDateShift : 3   ==> The documentation states "An offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period" --> In my view the bill settlement period is the date on which the billing cycle closes. So this attribute indicates the number of days after the cycle closes the bill would get generated.

chargeDateOffset : 2  ==>  The documentation states "An offset of a date through which charges previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod."  --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is not more than billingDateShift.

creditDateOffset : 2  ==>  The documentation states "An offset of a date through which credits previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod" --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is not more than billingDateShift.

paymentDueDateOffset : 10 ==> The documentation states "An offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod." --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is more than the billingDateShift as per the local norms.

mailingDateOffset :3 ==> The documentation states "An offset of a customer bill mailing date. The offset is expressed as number of days with regard to the start of the BillingPeriod. --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is more than or equal to the billingDateShift.

        As per your example the billing cycle is closing on 13th December, all charges and Credits arriving before 15th of December are included in the Bill which will be generated on 16th December and emailed on the same date. The customer has 10 days from the close of the cycle to make the payment. So your example looks perfect to me.

Thanks,

------------------------------
-----------------------------------------------------
Nitin Patil
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
-----------------------------------------------------
------------------------------

Hi,
      I would like to know how to set billing trigger value means based on which field bill generation will start.

As per my understanding, Based on the billing period , we have to start bill generation but as per the TMF "billingPeriod A string. A billing time period. It can be recurring, for example: week, month,quarter of year, year "

So I am not properly understanding what value i have to assign/set to billingPeriod field in my DB table so that i can use this value to periodically check whether the cycle is ending or not.

(1) Suppose i set billingPeriod= month (monthly) means the billing cycle starts "1st of every month and ends with the last day of month" -- is this correct ?
(2) Then the second case billing period starts on the 15th of every month and ends on the 14th. So for this case how to set billingPeriod value or which value?

The Brief of my doubt is how and where to set billing period(or billing start/trigger value) value so that my billingSystem can use this value and trigger bill generation

Or is there any other field which can be used to check bill generation triggers?

Kindly help me in this regard.

------------------------------
mukesh se n
C-DOT
------------------------------

Original Message:
Sent: Mar 14, 2022 02:17
From: Nitin Patil
Subject: BillCycleSpecification - Attributes

Hi Mukesh,

           I see your point and also agree that the documentation is a bit confusing. I would like to explain the attributes from my perspective

billingDateShift : 3   ==> The documentation states "An offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period" --> In my view the bill settlement period is the date on which the billing cycle closes. So this attribute indicates the number of days after the cycle closes the bill would get generated.

chargeDateOffset : 2  ==>  The documentation states "An offset of a date through which charges previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod."  --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is not more than billingDateShift.

creditDateOffset : 2  ==>  The documentation states "An offset of a date through which credits previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod" --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is not more than billingDateShift.

paymentDueDateOffset : 10 ==> The documentation states "An offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod." --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is more than the billingDateShift as per the local norms.

mailingDateOffset :3 ==> The documentation states "An offset of a customer bill mailing date. The offset is expressed as number of days with regard to the start of the BillingPeriod. --> What is the start of the billing period? In my view it is a day when the billing cycle closes. So number of days after cycle close date. The billing cycle should have validations to make sure this offset is more than or equal to the billingDateShift.

        As per your example the billing cycle is closing on 13th December, all charges and Credits arriving before 15th of December are included in the Bill which will be generated on 16th December and emailed on the same date. The customer has 10 days from the close of the cycle to make the payment. So your example looks perfect to me.

Thanks,

------------------------------
-----------------------------------------------------
Nitin Patil
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
-----------------------------------------------------
------------------------------