Billing Schedules

the billing schedule refers to the frequency at which the billing process is executed it determines how often the system runs the billing operations to generate invoices and credit memos for customers for example, a billing schedule could be set to run on a monthly basis, meaning that billing operations are performed once a month to generate invoices for the respective billing period alternatively, the schedule could be configured for a different interval, such as weekly, quarterly, or annually, depending on the specific needs of the business and the terms outlined in customer contracts by establishing a billing schedule, organizations can maintain a consistent and predictable billing cycle, ensuring that invoices are generated and delivered to customers in a timely manner this allows for effective financial management, accurate revenue recognition, and improved customer satisfaction by providing clear and transparent billing practices generate invoices on order activation admin users can configure the first invoices to be automatically generated and (optionally) activated as soon as the orders are activated login to nue app https //app nue io navigate to settings → billing schedules to automatically generate the first invoice in draft status, enable the option automatically generate the first invoice when an order is activated to automatically generate the first invoice in active status, enable the option automatically activate the first invoice when an order is activated if these options are turned on, the system will generate the first invoice using either the current date (today) or the earliest next billing date among all the products in the order, whichever comes later, as the target date for the invoice on demand billing schedule finance ops users can schedule to run billing once at a certain time or immediately login to nue app https //app nue io from the menu, navigate to revneue manager → billing schedules click new billing schedule in schedule type, select on demand under schedule, you can select a time to run, or check "run immediately" to run the billing schedule now click save and close you will be asked 'the billing schedule is in draft status do you want to activate and run the billing schedule now?', click yes to activate and execute the billing schedule recurring billing schedule you can create a billing schedule that generate invoices, and optionally automatically activate generated invoices on a daily, monthly basis or even with a custom schedule login to nue app https //app nue io from the menu, navigate to revneue manager → billing schedules click new billing schedule in schedule type, select recurring set the schedule start date to the day you want to run the first billing schedule job, and it will be based on the timezone you specified in the timezone field set the invoice date of the invoices generated in the first billing period, and it will be updated automatically in the following billing periods if you want to generate active invoices directly, check this option automatically activate generated invoices set the frequency of the billing schedule under the schedule section click save and close billing schedule frequency you can set the following schedule frequency for recurring billing schedules based on your business requirement daily run the billing schedule every day or only on weekdays weekly when running the billing schedule weekly, you are allowed to select multiple dates between monday and sunday, the billing job will be executed on the dates you choose every week monthly if you charge your customers on a monthly basis, you can choose this option and set the date of the month you want to generate invoices for your customers you have options to run the billing schedule job on a specific day of the month(s), or the nth day of the week in each month custom if the above options cannot meet your needs, or you have a special billing frequency for some customers, you can choose to configure the billing schedule frequency based on a custom cron expression the following tables show the supported cron expressions for billing schedules parts of a cron expression cron statement values special characters seconds 0–59 none minutes 0–59 none hours 0–23 , / day of month 1–31 , ? / month 1–12, jan dec , / day of week 1–7, sun–sat , ? / special characters character function example , value list separator (read as "and") 0 0 0 ? 3,5 means "at 12 00 am, only on wednesday and friday" specifies a range (read as "from to " ) 0 0 0 ? 1 5 means "at 12 00 am, monday through friday" specifies all values (read as "every") 0 0 0 1 means "at 12 00 am, on day 1 of every month" ? specifies no specific value (read as "any") 0 0 0 ? 1 means "at 12 00 am, every day in january" / specifies increments (the number before the slash specifies when the interval begins the number after the slash is the interval ) 0 0 1/6 means "every 6 hours, starting at 01 00 am" billing schedule filters when creating a billing schedule, by default, all customers will be billed if they have available orders that need to be invoiced sometimes, you may only want to bill for specific customers or even orders, in this case, you can apply filters for the billing schedules nue supports different level filters such as customer filter, product filter, and order filter you can specify any type of filter or combine them together when creating a billing schedule customer filter if you want to generate invoices for some specific customers, you can set customer filters by expanding the customer filter section on the billing schedule creation page, there are two types of filters available simple filter you can search for specific customers and filter by their bill cycle day based on your needs for example, if you want to bill for customer 'nue io', you can search for it and only generate invoices for this customer if you want to bill customers with the same bill cycle day, you can choose the option specific bill cycle date instead of generating invoices for all customers with different bill cycle days advanced filter if you have more complex criteria to find the customers you need to bill, you can switch to the advanced filter in this filter, you can filter by any field on the customer record for example, filtering all new business customers in the year 2023 product filter by default, a billing schedule job will bill for products with all types of revenue models if you need to bill for specific revenue models, just check the revenue models you want to bill under the simple filter tab you can also filter by any field on the product record under the advanced mode, only order products that matched the filter criteria will be billed order filter sometimes, when your customer placed an order and you want to generate an invoice immediately for this order or they made some changes and you only need to bill the amount for the change order in these cases, a billing schedule can only bill for specific orders you can either search orders from the simple filter or set the criteria in the advanced filter billing job after creating and activating a billing schedule, it will be displayed in the billing schedule list you can see the associated billing jobs by clicking the 'view billing jobs' on the billing schedule record the billing job will be executed at the time you configured in the billing schedule, you can check the job status to see if it is completed the billing job has the following statutes scheduled the current job is still waiting to be executed processing the current job is running completed the current job is completed successfully completed with error the current job is completed with some errors error the current job has failed due to unexpected reasons canceled the current job is canceled if a billing job has failed or is completed with errors, system administrators will receive an email notification including the error details you can disable this email notification from nue system setting > billing > send email notifications when billing jobs are completed with errors or failed after a billing job is completed successfully, you can see the number of billed customers, invoices, and credit memos(if enabled) in this billing job when clicking on the number in the job list, you will be navigated to the related records for example, if you click on the number in the invoices generated column, you will see a list of generated invoices by this billing job billing schedule dates when creating a billing schedule, you will need to set values for some date type fields, and these date fields are quite important to make your billing schedule work as expected schedule start date the date that the billing schedule gets started the default value is today's date billing job date the date when a billing job is executed starts from the schedule start date and gets advanced each time when a new billing job is created according to the billing schedule billing target date the billing target date is used to determine which billing periods of order products will be included in the current billing job any billing periods with a bill cycle day before the billing target date will be processed for example, let’s consider an order product with a monthly billing cycle that starts on 01/01/2023, and ends on 12/31/2023, with the 1st day of each month set as the bill cycle day if the billing target date is set to 2023/01/15, only one billing period from 01/01/2023 to 01/31/2023 will be billed this is because the bill cycle day of 01/01/2023 falls before the billing target date of 01/15/2023 however, if the billing target date is set to 02/15/2023, 2 billing periods will be billed these 2 periods span from 01/01/2023 to 02/28/2023, as both the bill cycle days of 01/01/2023 and 02/01/2023 are before the billing target date of 02/15/2023 in the case of a recurring billing schedule, a relative date will be used as the billing target date for each billing job users will see a helpful message displayed under the billing target date, indicating the first job execution date and the corresponding billing target date by default, the date when the billing job is executed will be set as the billing target date however, users have the flexibility to select any date before or after the job execution date based on their business needs for example, if businesses want to bill their customers two months in advance on a monthly basis, they can create a recurring billing schedule and set the billing target date to "billing job execution date plus 2 months " in this case, customers will receive an invoice for future items, and an invoice for october and november will be generated in september invoice date the invoice date refers to the specific date when an invoice is generated or issued by a seller to a buyer when creating a billing schedule, the invoice date determines the issue date of the generated invoices in the case of a recurring billing schedule, the initial invoice date is set by the first billing job, and for subsequent billing jobs, the invoice date is updated accordingly for instance, let’s consider a recurring billing schedule that starts on 01/01/2023 and has an initial invoice date of 01/06/2023 in this scenario, the invoice date for the invoices generated in january would be 01/06/2023 however, when the billing job repeats on 02/01/2023, the invoice date for that particular billing period will be updated to 02/06/2023 users can change the invoice date while activating an invoice if the invoice date is changed, the invoice's due date will be automatically recalculated and updated based on the payment term of the customer