Skip to main content
Skip table of contents

Support to Import Tax Details in .CSV format

Reference No: R2-78

Support has been provided to import the Tax Details in .CSV format into the R2 application.

The functionality is explained with a Sample Work Flow:

Prerequisites

  1. Create a sample TaxImportDetails.csv file comprising of the details such as Zip Code, City Name, State Name, County Name, Item TaxGroup, Custom TaxGroup, Tax Rate, Tax Action, Tax ScheduleID, Tax Schedule Description, and Effective Date, as shown in below.

    image-20240725-055608.png

The shuffling of columns in the TaxImportDetails.csv is not supported. It is mandatory to adhere to the column sequence of the TaxImportDetails.csv file comprising of the details in the first row such as Zip Code, City Name, State Name, County Name, Item TaxGroup, Custom TaxGroup, Tax Rate, Tax Action, Tax ScheduleID, Tax Schedule Description, and Effective Date. The details mentioned in the first row is always ignored, as it is considered as the Header.

Also, you will not be intimated if the columns have been shuffled resulting in importing incorrect data in the Maintenance module > Misc tab > Taxes tab.

Sample Work Flow

  1. Select the Maintenance module.

  2. Click the Import Tax Details icon. The Import Tax Details window is displayed, as shown in Figure 2.0.

image-20240725-055704.png

Figure 2.0 Maintenance module > Import Tax Details icon >  Import Tax Details window

 

  1. The Import Tax Details window displays the field options, as shown in Table 2.0:

Table 2.0 Import Tax Details

Field

Details

Description

User View

image-20240725-055738.png

Allows you to modify and Save the Import Tax Details window dimensions.

Path

image-20240725-055748.png

Select the Path importable button to select the .CSV file for Tax Import.

This is a mandatory field.

Options >Tax Area ID

image-20240725-055800.png

Select any one of the Tax Area ID drop-down option - City, State, County or Zip.

NOTE: Any two of the Tax Area ID drop-down fields selection is mandatory.

Options >Tax Region ID

 

image-20240725-055839.png

Select any one of the Tax Region ID drop-down option - City, State, County or Zip.

NOTE: Any two of the Tax Region ID drop-down fields selection is mandatory.

Tax Schedule ID

image-20240725-055858.png

Select either the Tax Schedule ID drop-down option or the Rate drop-down option.

 

NOTE:

  • Any one of the Tax Region ID drop-down or the Rate drop-down selection is mandatory.

  • If the Tax Schedule Description is null the Tax Schedule ID is considered as the Description for that schedule.

Allow multiple Tax Schedule for a Tax Area

image-20240725-055944.png

When the Allow multiple Tax Schedule for a Tax Area check box is not selected following by clicking the Run button, the system validates for any entries in the .CSV file with the same City, State, County, Item Tax Group, Customer Tax Group, Action and different Tax Rates.

If any such entries are found, the details of the entries are displayed inhibiting the file process.

 

  1. Select the fields in the Import Tax Details window, and click the Run button.

  2. The system displays a prompt with the message "Tax Details imported successfully" as shown in Figure 2.1.

image-20240725-060021.png

Figure 2.1 Tax Import Success Prompt

  1. Click OK.

  2. Select the Misc tab > Taxes tab to view all the imported Tax details, as shown in Figure 2.2.

  3. The Figure 2.2 displays the column details such as Tax Area, Region, Start Date, Customer Group, Item Group, and Action.

image-20240725-060057.png

Figure 2.2 Misc tab > Taxes tab > View all the imported Tax details

  1. The Column details displayed in Figure 2.2 is a combination of the columns from the Tax Import.csv, as explained in the below Table 2.1.

Table 2.1 R2 Column Details Explanation with the TaxImportDetails.csv Column Name Combinations

R2 Column Name

TaxImportDetails.csv Column Name Combinations

Tax Area

The Tax Area column in the R2 application is the combination of City Name, State Name, and County Name from the CSV file.

Region

The Region column in the R2 application is the combination of City Name, State Name, and County Name from the CSV file.

Start Date

The Start Date column in the R2 application is the Effective Date from the CSV file. It is always defined in mm/dd/yyyy format.

Customer Group

The Customer Group column in the R2 application is the Customer TaxGroup from the CSV file.

Item Group

The Item Group column in the R2 application is the Item TaxGroup from the CSV file.

Action

The Action column in the R2 application is the Tax Action from the CSV file.

  1.  In the Tax Import.csv file, replicate one of the Tax  line details by modifying the Tax Rate [0.18], as shown in figure 2.3.

image-20240725-060136.png

Figure 2.3 Tax Import.csv file with replica of the Tax line details except different Tax Rate

  1.  Save the Tax Import.csv file.

  2.  Import the Tax Import.csv file by repeating the Steps from 1 to 4.

  3. Click the Run button, a prompt with the error message "Based on the option chosen, multiple Tax Schedules for a Tax Area not allowed" is displayed with the OK and Details buttons, as shown in Figure 2.4.

image-20240725-060205.png

Figure 2.4 Prompt with the Error Message

  1. Click the Details button. The details of the error message is displayed portraying the replica of Tax  line details except different Tax Rate [0.18], as shown in Figure  2.5.

image-20240725-060233.png

Figure 2.5 Details of the Prompt with the Error Message

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.