Data Import/Cardlines - Revision history

Scarpenter: 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..."

2017-08-18T02:46:01Z

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..."

Dcowan: clarified mandatory optional nature of LEDGER_CODE

2017-06-15T00:08:49Z

clarified mandatory optional nature of LEDGER_CODE

Dcowan: added report location to main page under preparing data section

2017-06-05T01:58:58Z

added report location to main page under preparing data section

Dcowan: made the data definition table easier to determine mandatory

2017-03-09T23:54:41Z

made the data definition table easier to determine mandatory

Pdundas: /* Card line Import Data Definition */

2016-05-02T01:19:54Z

‎Card line Import Data Definition

Pdundas at 01:15, 2 May 2016

2016-05-02T01:15:35Z

Pdundas at 01:14, 2 May 2016

2016-05-02T01:14:25Z

Scarpenter at 23:55, 29 February 2016

2016-02-29T23:55:41Z

Scarpenter at 23:52, 7 February 2016

2016-02-07T23:52:45Z

Scarpenter: /* Card line Import Data Definition */

2016-02-07T23:51:02Z

‎Card line Import Data Definition

@@ Line 1: / Line 1: @@
-== Importing Ledger Card lines ==
+=This Content Has Moved House=
-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]

@@ Line 54: / Line 54: @@
 | DESCRIPTION || This field has a 255 character limit. This is the description for the charge that will appear on the customers invoice or service information record (SIR). || '''Mandatory'''
 |-
-| LEDGER_CODE || This field is the ledger code name from the Emersion system for the card line. You can obtain a list of available ledger codes at the following location: Nav: ''Reports > List > Reference > Ledger Codes (and Mapping) report''. Ensure you use the ledger code NAME, not the MAPPING_NAME or SIMPLE_CODE. || '''Mandatory'''
+| LEDGER_CODE || This field is the ledger code name from the Emersion system for the card line. You can obtain a list of available ledger codes at the following location: Nav: ''Reports > List > Reference > Ledger Codes (and Mapping) report''. Ensure you use the ledger code <span style="text-decoration:underline;">NAME</span>, not the MAPPING_NAME or SIMPLE_CODE. If no name entered, '''MISC_CARDLINE''' will be used. || ''Optional''
 |-
 | ACCOUNT_ID || This field is the account you wish to have the card line assigned against. || '''Mandatory'''

← Older revision		Revision as of 01:58, 5 June 2017
Line 15:		Line 15:

	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.		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.
		+
		+	You can obtain a list of available ledger codes at the following location: <br/>
		+	* Reports > List > Reference > Ledger Codes (and Mapping) report.
		+	* ''Ensure you ONLY use the ledger code NAME from this report. Using the MAPPING_NAME, SIMPLE_CODE or ID from another source is unsupported and will result in an error for each line attempted.''

	== Importing your Data ==		== Importing your Data ==

@@ Line 40: / Line 40: @@
 {| class="wikitable"
 |+Card line Import Data Definition table
-|Data field || Description
+|Data field || Description || Mandatory/Optional
 |-
-| TRANSACTION_DATE ||  This field is mandatory. The format = YYYY-MM-DD.
+| TRANSACTION_DATE ||  The format = YYYY-MM-DD. || '''Mandatory'''
 |-
-| ACTUAL_VALUE || This field is mandatory. This field represents the EX TAX portion of your charge and must be rounded to two decimal places.
+| ACTUAL_VALUE ||This field represents the EX TAX portion of your charge and must be rounded to two decimal places. || '''Mandatory'''
 |-
-| TAX_AMOUNT || This field is mandatory. This field represents the TAX portion of your charge and must be rounded to two decimal places.
+| TAX_AMOUNT ||This field represents the TAX portion of your charge and must be rounded to two decimal places. || '''Mandatory'''
 |-
-| DESCRIPTION || This field is mandatory and has a 255 character limit. This is the description for the charge that will appear on the customers invoice or service information record (SIR).
+| DESCRIPTION || This field has a 255 character limit. This is the description for the charge that will appear on the customers invoice or service information record (SIR). || '''Mandatory'''
 |-
-|  LEDGER_CODE || This field is mandatory and is the a ledger code name from the Emersion system for the card line. You can obtain a list of available ledger codes at the following location:
+| LEDGER_CODE || This field is the ledger code name from the Emersion system for the card line. You can obtain a list of available ledger codes at the following location: Nav: ''Reports > List > Reference > Ledger Codes (and Mapping) report''. Ensure you use the ledger code NAME, not the MAPPING_NAME or SIMPLE_CODE. || '''Mandatory'''
 |-
-| ACCOUNT_ID || This is a mandatory field. and is the account you wish to have the card line assigned against.
+| ACCOUNT_ID || This field is the account you wish to have the card line assigned against. || '''Mandatory'''
 |-
-| SERVICE_ID || This field is optional. It is service ID you want this charge to be assigned against.
+| SERVICE_ID || This field is service ID you want this charge to be assigned against. || ''Optional''
 |-
-| BILLING_TYPE_ID || Defines if the charge is an advance charge or an arrears charge (2). Valid entries are:
+| BILLING_TYPE_ID || Defines if the charge is an advance charge or an arrears charge (2). Valid entries are: 1 = advance, 2 = in arrears. If not provided, the default setting is 1 (advance). || ''Optional''
 |-
-| COVERS_FROM ||  A mandatory start date for the period of which the card line covers. Format = YYYY-MM-DD.
+| COVERS_FROM ||  The start date for the period of which the card line covers. Format = YYYY-MM-DD. || '''Mandatory'''
 |-
-| COVERS_TO || The end date for the period that the card line covers. Format = YYYY-MM-DD.
+| COVERS_TO || The end date for the period that the card line covers. Format = YYYY-MM-DD. If a date is not supplied, the system will use the COVERS_FROM date. || ''Optional''
 |-
 |}

@@ Line 72: / Line 72: @@
 {| class="wikitable"
 |+Card line Import Data File Example
-| ACTUAL_VALUE || 10 || 1 || "Test Transaction, Blah" || LEDGER_CODE || 111377 || 171519 || 1 || 2010-12-30 || 2010-12-30
+| TRANSACTION_DATE || ACTUAL_VALUE || TAX_AMOUNT || DESCRIPTION || LEDGER_CODE || ACCOUNT_ID || SERVICE_ID || BILLING_TYPE_ID || COVERS_FROM || COVERS_TO
 |-
 | 2010-02-01 || 33 || 3 || "Blah Transaction, Blah" ||  || 111377 ||  || 1 || 2010-12-30 || 2010-12-30

@@ Line 50: / Line 50: @@
 | DESCRIPTION || This field is mandatory and has a 255 character limit. This is the description for the charge that will appear on the customers invoice or service information record (SIR).
 |-
-|  LEDGER_CODE || This field is mandatory and is the a ledger code name from the Emersion system for the card line. You can obtain a list of available ledger codes at the following location: < /br>
+|  LEDGER_CODE || This field is mandatory and is the a ledger code name from the Emersion system for the card line. You can obtain a list of available ledger codes at the following location:
 Nav: '''Reports > List > Reference > Ledger Codes (and Mapping) report'''. Ensure you use the ledger code NAME, not the MAPPING_NAME or SIMPLE_CODE.
 |-
@@ Line 58: / Line 58: @@
 |-
 | BILLING_TYPE_ID || Defines if the charge is an advance charge or an arrears charge (2). Valid entries are:
-= advance, 2 = in arrears < /br>
+= advance, 2 = in arrears
 It is not mandatory. The default setting is 1 (advance).
 |-

← Older revision		Revision as of 23:55, 29 February 2016
Line 77:		Line 77:
	\|-		\|-
	\|}		\|}
		+
		+	= See Also =
		+
		+	* [[Events\|Events]]

@@ Line 66: / Line 66: @@
 |}
-[[File:Sample Cardline Import.csv|thumbnail|Cardline Sample Import File]]
+Your finished data file should look like the following example.
 {| class="wikitable"