Configuration Package: Billing Schedule Line

Review the following information for creating billing schedule lines by exporting and then importing configuration packages for the billing schedule line (BssiArcbBillingShceduleLine) table, use table ID 23065675.

Note icon. Note: The billing schedule must already exist before lines can be added or updated through the data import.

Create a Billing Schedule Line Import File

To modify a billing schedule line, you must export and then import the billing schedule header data. For detailed steps for configuration packages, follow the instructions in the Prepare a Configuration Package article in the Microsoft Dynamics 365 Business Central documentation and incorporate these steps: 

  1. Create a configuration package:
    1. Ensure that you specify the Code, Package Name, and Language ID.
    2. In the Tables FastTab, select the billing schedule line (BssiArcbBillingShceduleLine) table (23065675).
  2. Export the configuration package for the table to Microsoft Excel (Package > Export to Excel). The file is saved to your default downloads folder.
  3. For the line you want to edit, do the following: 
    1. Open the file in Microsoft Excel, and find the line.
    2. Delete all other lines that you do not need.
      Important: When you delete the other lines, do not delete the header information or modify the format of the file.
    3. Edit the line as needed, and save the changes.
      If you change the unit price or amount, you must provide the correct value.
      If the field does not have data, you do not have to include it in the file.
  4. Import the updated file (Package > Import from Excel).
    1. On the import preview, select Import.
  5. Back on the configuration package window, validate the package (Process > Validate Package ) and then apply the data (Process > Apply Data).
  6. When you see the confirmation message, select OK.

Create Billing Schedule Line Import File and Exclude Fields

To ensure that the configuration package includes only the fields you want to import, you can exclude fields. Use the Config. Package Fields dialog to clear the Include Field check box to exclude the fields you do not want in the configuration package. Based on the Subscription Billing setup, some fields are automatically updated when they are excluded from the configuration package: 

When the following fields are excluded, the values are updated from the item record: 

  • Description
  • Unit Price

When the following fields are excluded, the values are updated from the billing schedule header

  • Start Date
  • End Date
  • Frequency
  • Interval

When the following fields are excluded, the values are updated from the billing schedule group:

  • Usage Option
  • Pricing Method

When the following field is excluded, the values are updated based on other values for the line:

  • Amount (calculated based on the unit price)

To create a billing schedule and exclude certain fields during the import, you can create a configuration package using the instructions from the previous section, Create a Billing Schedule Line Import File, and incorporate these steps.

  1. Create a configuration package for the billing schedule header (BssiArcbBillingScheduleLine) table, use 23065675.
  2. Select Yes to the following prompt: 
  3. On the Edit - Config. Package Fields dialog, clear the Include Field check box for any field you do not want to export to the configuration package.
  4. To exclude additional fields, on the Tables FastTab, select Table > Fields to open the Edit - Config. Package Fields dialog.
  5. On the Config. Package Fields dialog, clear the Include Field check box for these additional fields: 
  6. Export the configuration package for the table to Microsoft Excel (Package > Export to Excel). The file is saved to your default downloads folder.
  7. Open and edit the file in Excel.
  8. Follow the steps in Create a Billing Schedule Line Import File for importing and then validating and applying the configuration package.

Updating Lines in an Existing Billing Schedule

To update lines in a billing schedule, you can create a configuration package using the instructions from the previous section, Create a Billing Schedule Line Import File, and incorporate these steps.

  1. Create a configuration package for the billing schedule header (BssiArcbBillingScheduleLine) table, use 23065675.
  2. Exclude any fields you do not want to include in the configuration file.
    To update the End Date with the value from the specified value from the configuration package, ensure that you move the Number of Periods field to be between the Start Date and End Date fields.
  3. Move the Sell-To Customer No. to the field before Bill-To Customer No.
  4. Export the configuration package for the table to Microsoft Excel (Package > Export to Excel). The file is saved to your default downloads folder.
  5. Open and edit the file in Excel.
    1. Delete all rows that you do not need, and edit the values of any remaining rows.
  6. Follow the steps in Create a Billing Schedule Line Import File for importing and then validating and applying the configuration package.

Update End Date

Review the following information for how the End Date is updated: 

  • When End Date is excluded from the configuration file, it is updated based on the Start Date and Number of Periods specified.
  • When End Date is included in the configuration file but is empty, the End Date is updated with a blank value.
  • When End Date is included in the configuration file of the billing schedule header and has a value and the Number of Periods has a value, the End Date is updated based on the Start Date and Number of Periods specified.

Add Percent Price Adjustment to a Line

To add a percentage price adjustment for a line, follow this general workflow: 

  1. Create a configuration package for the price adjustment (BssiArcbSchEscalation) table (23065690).
  2. Export the configuration package for the table (Excel > Export to Excel).
  3. For the line you want to edit, do the following: 
    1. Open the file, and find the line you want.
    2. Delete all other lines that you do not need.
      Important: When you delete the other lines, do not delete the header information or modify the format of the file.
    3. Edit the line as needed.
      Ensure that all the required fields have values: Billing Schedule No., Billing Schedule Line No., Line No., and Percentage.
      If the field does not have data, you do not have to include it in the file.
    4. Create additional lines if needed.
    5. Save the changes.
  4. Import and then validate and apply the configuration package.

After the configuration package is imported, you can review the changes in the SBS ARCB Billing Detail List or the SBS ARCB Billing Price Adjustment History.

Add Amount Price Adjustment to a Line

To add an amount price adjustment for a line, follow the same steps as the previous section, Add Percent Price Adjustment to a Line, except when editing or adding lines, ensure that the Amount is specified.

Import Item Usage Information

To add a item usage information for an item, follow this general workflow. These steps work for usage items for both meter reading types (by reading or by consumption).

  1. Create a configuration package for the usage (BssiArcbUsageImportTEMP) table (23065704).
  2. Export the configuration package for the table (Excel > Export to Excel).
  3. For the line you want to edit, do the following: 
    1. Open the file, and find the line you want.
    2. Delete all other lines that you do not need.
      Important: When you delete the other lines, do not delete the header information or modify the format of the file.
    3. Edit the line as needed.
      Ensure that all the required fields have values: Schedule Number, Item No., Line No., Start Date, End Date, Current Reading, and Usage Option.
    4. Create additional lines if needed.
    5. Save the changes.
  4. Import and then validate and apply the configuration package.

Import Item Min/Max Information

To add minimum and maximum information for an item, follow this general workflow:

  1. Create a configuration package for the min/max information (BssiArcbMinMaxFreeDetails) table (23065718).
  2. Export the configuration package for the table (Excel > Export to Excel).
  3. For the line you want to edit, do the following: 
    1. Open the file, and find the line you want.
    2. Delete all other lines that you do not need.
      Important: When you delete the other lines, do not delete the header information or modify the format of the file.
    3. Edit the line as needed.
      Ensure that all the required fields have values: Billing schedule No., Line No.
    4. Create additional lines if needed.
    5. Save the changes.
  4. Import and then validate and apply the configuration package.