Catch Up Billing Run

catchup billing run is a process that reconciles outstanding charges by calculating and generating invoices for previously unbilled services or products catch up billing runs facilitate the migration of customer subscriptions from other systems into nue for example, if you are using stripe to collect payments from your customer, the catch up billing run in nue will ensure that nue revenue manager will send out the ‘next’ invoice appropriately nue will execute the catch up bill run prior to starting the regular billing schedule the catch up bill run will mark invoices that were already processed through other systems as ‘catch up’ these invoices will not be transferred to stripe, quickbooks or other external collection systems the catch up bill run is created using nue api, and will only need to be run once after customer subscriptions are migrated into nue prerequisite before executing the catch up bill run, you will need to follow the steps below to check all existing data and configurations step 1 set up billing parameters for each account login to salesforce → nue on salesforce navigate to accounts, and click into the account detail page check whether the account level billing settings are all set up correctly the account billing settings will override the system billing settings if they are not empty so if the current account will be billed based on the system level billing settings, leave them empty at the account level repeat the above steps and make sure the billing settings for all accounts are configured correctly step 2 check billing schedule settings login to nue app navigate to system settings → billing check the system level billing settings, and make sure they are correctly configured navigate to system settings → invoices turn off the below settings if they are on (in the red box) automatically generate the first invoice when an order is activated automatically activate the first invoice when an order is activated click ‘save’ to save the changes step 3 import historical subscriptions and orders import the historical subscriptions and orders by following import subscriptions into nue docid 0nbnovyc3mnepmujhtpvo note to prepare for catch up billing schedules, ensure to verify if there are existing invoices for any accounts if an account possesses invoices in draft or active statuses, nue will exclude it from the catch up billing process, resulting in no billing information update for that account therefore, please ensure that accounts intended for catch up billing do not contain any invoices catch up billing schedule nue offers two different catch up billing schedule modes generate invoices in this catch up mode, real invoices and credit memos will be generated, and optionally activated this option is used when you need to generate invoices for historical orders, and also ingest them into the revenue recognition system for the simulated revenue run and accounting close process however, even when the real invoices are generated and activated, they will not be transferred to the payment system the generated invoices (including invoice items) and credit memos (including credit memo items) are marked as ‘catch up’ simulation in the simulation mode, invoices and credit memos will not be generated the billing catch up process will run, but the invoices will not be created the billing process simply sets the billed until date for the active order products since invoices are not generated they will not be transferred to payment systems either note in the simulation mode, the reports and metrics of the invoice data will not be available create a catch up billing schedule after importing all historical subscriptions and orders successfully, you can start creating a catch up billing schedule to catch up with the billing statuses to a specific billing target date this billing target date is defined as the ‘last billing date processed in the other system’ (in other words, the cutover date to nue) for example, if your customer subscription has a billing cycle day of the 15th of each month, and is invoiced on a monthly basis, let’s assume that the cut off date to convert to nue is march 31, 2023 the subscription has a subscription start date of june 15, 2022 your other system has already invoiced this customer 9 times on a monthly basis from june 15 march 14 nue will create a ‘catch up’ billing schedule with a target date of march 31, 2023 (the cutover date) this catch up bill run will result in 9 invoices created in nue nue will set these invoices to ‘catch up’ status the next invoice created for this subscription will be created on april 15, 2023 with an ‘active’ status let’s accomplish the above scenario following the below steps get auto token we need to get the api access key and api token https //api docs nue io/#authentication create catch up billing schedule→ post https //api nue io/billing/schedules { "scheduletype" "on demand", "customerfilter" null, "productfilter" null, "orderfilter" null, "billcycledayfilter" null, "schedulestartdate" "2023 03 31", "targetdate" "2023 03 31", "recurringschedule" null, "status" "active", "zoneid" "asia/shanghai", "autoactivate" true, "splitbyperiod" true, "cleancatchup" true, "catchupmode" "generateinvoices" } after the catch up billing schedule job completes, you will see the generated invoices by navigating to revenue manager → invoices if you want to use the simulation mode,you can set the catch up mode to ‘simulation’, then there won’t be catch up invoices generated, but the bill until date for this subscription will be catched up to 2023/03/15 "catchupmode" "generateinvoices" if you don’t want to generate one catch up invoice for each billing period, simply set the parameter ‘splitbyperiod’ to false, then there will be only one catch up invoice generated across all billing periods before the billing target date "splitbyperiod" false if the generated catch up invoices are not as expected or you need to regenerate them from scratch, set the parameter ‘cleancatchup’ to true, this will delete all existing catch up invoices and regenerate new ones "cleancatchup" true apply filters to the billing schedule if you have a large number of historical subscriptions that need to catch up, we do suggest you use the filters in the billing schedule request to restrict the data volume for each catch up billing schedule, for example, filtering by account’s name this will make it easier to verify whether the generated invoices are as expected { "createdthrough" "api", "scheduletype" "on demand", "customerfilter" "{name { eq \\"nue io\\"}}", "productfilter" null, "orderfilter" null, "billcycledayfilter" null, "schedulestartdate" "2023 03 31", "targetdate" "2023 03 31", "recurringschedule" null, "status" "active", "zoneid" "asia/shanghai", "autoactivate" true, "splitbyperiod" true, "cleancatchup" true, "catchupmode" "generateinvoices" } you can leverage nue graphql generator to create the filter condition and attach it to the parameter ‘customerfilter’ in the catch up billing schedule request note make sure to convert the double quote ( “ ) into backslash + double quote (\”) when using it in the api request nue billing schedule supports the customer filter, product filter, and order filter if you need to catch up billing information for some specific products or orders, you can add filter conditions to the api request accordingly for example, filtering by product revenue model or order number "productfilter" "{pricemodel { eq \\"recurring\\"}}", "orderfilter" "{ordernumber { eq \\"00000101\\"}}"