Data Import/Cardline Management - Revision history

Scarpenter at 03:31, 16 October 2017

2017-10-16T03:31:25Z

Dcowan: updated content to included reference to report

2017-07-13T06:38:01Z

updated content to included reference to report

Scarpenter at 04:40, 27 June 2017

2017-06-27T04:40:17Z

Dcowan at 03:37, 2 June 2017

2017-06-02T03:37:26Z

Scarpenter: /* Card Line Management Import Data Definition */

2016-08-05T01:14:31Z

‎Card Line Management Import Data Definition

Scarpenter: /* Card Line Management Import Data Definition */

2016-08-05T01:10:02Z

‎Card Line Management Import Data Definition

Pdundas at 01:29, 2 May 2016

2016-05-02T01:29:25Z

Pdundas: /* Card Line Management Import Data Definition */

2016-05-02T01:25:27Z

‎Card Line Management Import Data Definition

Pdundas: /* Card Line Management Import Data Definition */

2016-05-02T01:24:48Z

‎Card Line Management Import Data Definition

Pdundas at 01:16, 2 May 2016

2016-05-02T01:16:25Z

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE: Card Line Management Import}}
-= Overview =
+=This Content Has Moved House=
-This feature provides an easy and fast way to update, delete, allocate and deallocate cardlines.
+This article has been moved to our new home for documentation and help content, the new Emersion Knowledge Base.
-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.
+We are sorry for the untidiness while we are shifting locations and we appreciate your patience during the transition to out new home.
-If the bulk update is successful, the email notification will advise you when the process is complete.
+[https://resources.emersion.com/display/EKB/Managing+Cardlines Take me to the Emersion Knowledge Base article]
-== Preparing your Data ==
+[[file:new_home_sm.jpg|900px]]

@@ Line 1: / Line 1: @@
-{{DISPLAYTITLE: Cardline Updater}}
+{{DISPLAYTITLE: Card Line Management Import}}
 = Overview =
@@ Line 76: / Line 76: @@
 |-
 |}

@@ Line 1: / Line 1: @@
-== Ledger Cardline Management Bulk Importer / Updater ==
+{{DISPLAYTITLE: Cardline Updater}}
-This feature provides an easy and fast way to update, delete, allocate and de-allocate card lines into the system.
+This feature provides an easy and fast way to update, delete, allocate and deallocate cardlines.
 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.

@@ Line 37: / Line 37: @@
 == Card Line Management 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"

@@ Line 42: / Line 42: @@
 |Data field || Description
 |-
-| LEDGER_CARDLINE_ID ||  This field is mandatory. The format = NNNNNNN where the N is a Numeric.
+| LEDGER_CARDLINE_ID ||  This field is mandatory. The ID of the cardline to be modified.
 |-
 | MODIFICATION_TYPE || This field is mandatory. Use any of the following options:
@@ Line 50: / Line 50: @@
 * deallocate - this option does not apply to approved invoices.
 |-
-| INVOICE_ID || This field is optional. Mandatory for MODIFICATION_TYPE of 'allocate'. The format = NNNNNNN where the N is a Numeric.
+| INVOICE_ID || The ID of the invoice. Mandatory if MODIFICATION_TYPE is 'allocate', otherwise this is optional.
 |-
-| EXTAX_AMOUNT || This field is optional. Mandatory for MODIFICATION_TYPE of 'update'. This field represents the EX TAX portion of your charge and must be rounded to two decimal places. The format = NNN.NN where the N is a Numeric.
+| EXTAX_AMOUNT || The amount ex-tax. This must be rounded to two decimal places. Mandatory if MODIFICATION_TYPE is 'update', otherwise this is optional.
 |-
-| TAX_AMOUNT || This field is optional. Mandatory for MODIFICATION_TYPE of 'update'. This field represents the TAX portion of your charge and must be rounded to two decimal places. The format = NNN.NN where the N is a Numeric.
+| TAX_AMOUNT || The tax amount. This must be rounded to two decimal places. Mandatory if MODIFICATION_TYPE is 'update', otherwise this is optional.
 |-
 |}
-Your finished data file should look like the following example.
+Your data file should look like the following example.
 {| class="wikitable"

@@ Line 44: / Line 44: @@
 | LEDGER_CARDLINE_ID ||  This field is mandatory. The format = NNNNNNN where the N is a Numeric.
 |-
-| MODIFICATION_TYPE || This field is mandatory.
+| MODIFICATION_TYPE || This field is mandatory. Use any of the following options:
-When updating (of which you can only do to items which are not usage based) – you use modification type ‘update’, ‘ledger cardline ID’, ‘ex tax’ and ‘tax amounts’
+* update
+* delete
-When deleting (of which you can only do to items which are not usage based) – you use modification type ‘delete’ and ‘ledger cardline ID’
+* allocate - this option does not apply to approved invoices.
+* deallocate - this option does not apply to approved invoices.
 |-
 | INVOICE_ID || This field is optional. Mandatory for MODIFICATION_TYPE of 'allocate'. The format = NNNNNNN where the N is a Numeric.

@@ Line 12: / Line 12: @@
 To update card lines you will need to create a CSV data file or you can download the data file below to use as a template. You will need to extract the csv file and save it.
-[[media:Sample Cardline Import.csv | Cardline Import CSV template]]
+[[media:Sample_Cardline_Management_Import.csv | Sample_Cardline_Management_Import]]
 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.

@@ Line 71: / Line 71: @@
 | 12345679 || delete ||  ||  ||
 |-
-| 12345685 || allocate ||  ||  ||
+| 12345685 || allocate || 1234567 ||  ||
 |-
 | 12345699 || deallocate ||  ||  ||
 |-
 |}

@@ Line 64: / Line 64: @@
 {| class="wikitable"
-|+Card line Import Data File Example
+|+Card line Management Import Data File Example
-| ACTUAL_VALUE || 10 || 1 || "Test Transaction, Blah" || LEDGER_CODE || 111377 || 171519 || 1 || 2010-12-30 || 2010-12-30
+| LEDGER_CARDLINE_ID || MODIFICATION_TYPE || INVOICE_ID || EXTAX_AMOUNT || TAX_AMOUNT
 |-
-| 2010-02-01 || 33 || 3 || "Blah Transaction, Blah" ||  || 111377 ||  || 1 || 2010-12-30 || 2010-12-30
+| 12345678 || update ||  || 10 || 1
 |-
-| 2010-12-30 || 22 || 2.2 || Test Transaction || MY_TRANSACTION || 111683 || 173038 || 2 || 2010-12-30 || 2010-12-30
+| 12345679 || delete ||  ||  ||
 |-
 |}