Difference between revisions of "Data Import/Cardlines"

From Emersion
Jump to: navigation, search
(Replaced content with "=This Content Has Moved House= This article has been moved to our new home for documentation and help content, the new Emersion Knowledge Base. We are sorry for the untid...")
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Importing Ledger Card lines ==
+
=This Content Has Moved House=
 +
This article has been moved to our new home for documentation and help content, the new Emersion Knowledge Base.
  
This feature provides an easy and fast way to import card lines into the system.
+
We are sorry for the untidiness while we are shifting locations and we appreciate your patience during the transition to out new home.
  
The system utilises the '''Bulk upload processing notification''' event to send a notification with the results of the bulk approval attempt. You must set up this event and enable it before you use this tool.
+
[https://resources.emersion.com/display/EKB/Cardlines Take me to the Emersion Knowledge Base article]
 
 
If the bulk approval is successful, the email notification will advise you when the process is complete.
 
If the bulk approval is not successful, the email notification will send details of the records that failed to be approved and why.
 
 
 
== Preparing your Data ==
 
 
 
To import card lines you will need to create a CSV data file or you can download the data file below toi use as a template. You will need to extract the csv file and save it.
 
 
 
[[media:Sample Cardline Import.csv | Cardline Import CSV template]]
 
 
 
Enter the data into the import sheet. Leave no rows blank. You must ensure the data meets all validation requirements. These are contained in the data definition table below. When you submit the data file for import, the system will parse the file looking for errors. If the system finds no errors, the system will import the notes into the system. The file needs to be error-free in order to import the data. In the event errors are found, no data will be imported into Emersion. Review the bulk upload processing notification email, correct the file and try again.
 
 
 
== Importing your Data ==
 
 
 
To access the bulk invoice approval tool:
 
 
 
# Log into Cumulus.
 
# '''Nav: Admin > Bulk Import > Cardline'''.
 
# Click the '''Browse''' button and select the csv file containing the list of card lines you want to import.
 
# If you want the bulk upload processing notification email to be sent to a different email address than the address defined in the event template, tick the '''Override?''' check box and enter an alternative email address. This will only apply for this upload. To change the email address for all future imports, you will need to change the recipient defined in the event template.
 
# Press '''Submit'''
 
 
 
The system will validate the data and if no errors are found, the system will approve the invoices. When the notification email is received, the process has been completed.
 
 
 
<strong>'''It is strongly recommended that you check a few random records to ensure that bulk approval process was a success. If you find an problem, you cannot roll back the bulk approval.'''</strong>
 
 
 
You have two options should this occur:
 
 
 
# Manually correct the data.
 
# Request Emersion fix the errors for you. This can be submitted via [[Support_and_help_from_Emersion#Work_Orders | work order ticket]]. Please include a new csv data file with the records that need to be corrected. Do not include any records that do not need correcting.
 
 
 
== Card line Import Data Definition ==
 
This section contains a list of the required fields and a definition of what the system considers as valid data.
 
 
 
 
 
{| class="wikitable"
 
|+Card line Import Data Definition table
 
|Data field ||Description
 
|-
 
! TRANSACTION_DATE !! ACTUAL_VALUE !! TAX_AMOUNT !! DESCRIPTION !! LEDGER_CODE !! ACCOUNT_ID !! SERVICE_ID !! BILLING_TYPE_ID !! COVERS_FROM !! COVERS_TO
 
|-
 
| 2010-12-30 || 10 || 1 || "Test Transaction, Blah" || LEDGER_CODE || 111377 || 171519 || 1 || 2010-12-30 || 2010-12-30
 
|-
 
| 2010-02-01 || 33 || 3 || "Blah Transaction, Blah" ||  || 111377 ||  || 1 || 2010-12-30 || 2010-12-30
 
|-
 
| 2010-12-30 || 22 || 2.2 || Test Transaction || MY_TRANSACTION || 111683 || 173038 || 2 || 2010-12-30 || 2010-12-30
 
|}
 
 
 
[[File:Sample Cardline Import.csv|thumbnail|Cardline Sample Import File]]
 
 
 
The fields are described below;
 
* TRANSACTION_DATE - This field is mandatory and must be in the format of YYYY-MM-DD
 
 
 
* ACTUAL_VALUE - This field represents the EX TAX portion of your charge. It is mandatory and
 
  must be rounded to two decimal places.
 
 
 
* TAX_AMOUNT - This represents the tax portion of your charge. Can be zero. Is mandatory and
 
  must be rounded to two decimal places.
 
 
 
* DESCRIPTION - This is the description for the charge that will appear on the customers invoice
 
  or service information record. It is mandatory and must be less than 255 characters.
 
 
 
* LEDGER_CODE - This is the a ledger code from the Emersion system. You can find a list of the
 
  available ledger codes in the ledger code (mapping) report -
 
  https://cumulus.emersion.com.au/report/generic/view/1001 - Please ensure you use the ledger code NAME,
 
  not the MAPPING_NAME or SIMPLE_CODE.
 
 
 
* ACCOUNT_ID - The account you wish to have the cardline assigned against. This is a mandatory field.
 
 
 
* SERVICE_ID - The service ID you want this charge to be assigned against. This is not mandatory and has no default.
 
 
 
* BILLING_TYPE_ID - Whether the charge (or credit) you are creating is representative of an advance
 
  charge (1) or an arrears charge (2). It is not mandatory and defaults to 1 (advance).
 
 
 
* COVERS_FROM - The start date for the period of which the charge (or credit) covers. This is mandatory
 
  and must be in the format of YYYY-MM-DD
 
 
 
* COVERS_TO - The end date for the period of which the charge (or credit) covers. This is not mandatory,
 
  will default to the covers from and must be in the format of YYYY-MM-DD
 

Latest revision as of 12:46, 18 August 2017

This Content Has Moved House

This article has been moved to our new home for documentation and help content, the new Emersion Knowledge Base.

We are sorry for the untidiness while we are shifting locations and we appreciate your patience during the transition to out new home.

Take me to the Emersion Knowledge Base article