Import Data: Difference between revisions

Revision as of 04:15, 12 September 2020

Introduction

This function is to import Information/Data from other Software Data
Below is the list Data that we can Import from

Special Import

Standard Import

System	Contact Info
ELID	Elid Sdn Bhd
SynGlobal Time Attendance	SynGlobal Technologies Sdn Bhd
FingerTec	TimeTec Computing Sdn Bhd
ANVIZ	Hi-Profile Achievement (M) Sdn Bhd
Click Time Attendance	EGroup Solution Sdn Bhd
Nexpro TimeTracX	Nexus Professional Sdn Bhd
Check Time	MVIT Solution
ECOTimePrint	Eco Solution Technology

SQL Payroll Program

May get it from here

Modules Require

For all import except UBS Payroll & AutoCount Payroll

Data Import

Guideline & Example

There are 2 type of import

Single File Import
Batch File Import (Available in Version 1.2019.167.146 & above)

Sample Output - 20190529

Single File Import

This guide is all import except UBS Payroll & AutoCount Payroll

Just copy below example & paste to notepad & save it as CSV

Pros

Column Field name can be free format
No need to Hash File

Cons

Need Manually Mapping the Column
Manually Import individually
Not secure cause user can change the file before import

Overtime & Wages

Example 1 - OT or Wages
Date,Employee,Code,UnitAsTime 26/6/2015,A001,DR01,04:00 28/6/2015,A001,DR02,09:38 26/6/2015,A002,DR02,06:18 29/6/2015,A002,DR03,03:22 26/6/2015,A003,DR03,04:55

Example 2 - OT or Wages
"Date","Employee","Code","Unit" 26/6/2015,A001,DR01,4 28/6/2015,A001,DR02,9.63 26/6/2015,A002,DR02,6.30 29/6/2015,A002,DR03,3.37 26/6/2015,A003,DR03,4.92

Table Fields Properties
Field Name	Field Type	Field Size	Remarks
Date	Date	0	In dd/mm/yyyy or dd-mm-yyyy format
Employee	String	30	Employee Code/ID
Code	String	20	Overtime or Wages Code
Unit	FMTBcd	8	Time in rate eg 3 hr 15 min = 3.25 (3 + (15/60))
UnitAsTime	Time	0	In HH:MM format

[top]

Leave

Example 1 - Leave
TransDate,Employee,LeaveCode,UnitAsTime 08/11/2015,001,UL,08:00 19/11/2015,003,UL,09:20 15/11/2015,005,UL,08:00 01/11/2015,001,AL,08:00 03/11/2015,003,AL,08:00 08/11/2015,005,MC,08:00

Example 2 - Leave
TransDate,Employee,LeaveCode,Unit 08/11/2015,001,UL,1 19/11/2015,003,UL,1.17 15/11/2015,005,UL,1 01/11/2015,001,AL,1 03/11/2015,003,AL,1 08/11/2015,005,MC,1

Table Fields Properties
Field Name	Field Type	Field Size	Remarks
Date	Date	0	In dd/mm/yyyy or dd-mm-yyyy format
Employee	String	30	Employee Code/ID
LeaveCode	String	20	Leave Code (Eg AL, MC, etc)
Unit	FMTBcd	8	Day in rate eg 9 hr 20 min for 8 hr per day = 1.17 (((9+(20/60))/24)*(24/8))
UnitAsTime	Time	0	In HH:MM format

It adviceable to use Unit instead of UnitAsTime as

UnitAsTime max value can enter is 23:59 only
if you Export as Grand Total

[top]

Employee

Example 1 - Employee
"Code";"Name";"DOB";"Gender";"Salary";"Resident";"EISTYPE";"EISCATEGORY" "0018";"Shiro Emiya";"14/06/1980";"M";"1200";"F";"1";"0" "0019";"Nanoha Takamachi";"01/10/1995";"F";"2000";"F";"0";"1" "0020";"Belldandy";"01/09/1977";"F";"2500";"T";"1";"0"

Example 2 - Employee
CODE,NAME,NAME2,GENDER,DOB,ADDRESS1,ADDRESS2,ADDRESS3,ADDRESS4,PHONE1,PHONE2,MOBILE,EMAIL,NEWIC,OLDIC,PASSPORT,IMMIGRATIONNO,BRANCH,HRGROUP,DEPARTMENT,CATEGORY,PROJECT,JOB,TASK,COUNTRY,RACE,CALENDAR,JOBTITLE,JOINDATE,CONFIRMDATE,RESIGNDATE,MARITALSTATUS,ISACTIVE,WAGESTYPE,WAGES,CONTRIB,FREQUENCY,PAYMENTMETHOD,BANK,BANKACCNO,EPFNO,NK,INITIAL,SOCSONO,SOCSOTYPE,TAXBRANCH,TAXNO,DISABLED,RESIDENT,EASERIALNO,SPOUSENAME,SPOUSEADDRESS1,SPOUSEADDRESS2,SPOUSEADDRESS3,SPOUSEADDRESS4,SPOUSEPHONE1,SPOUSEPHONE2,SPOUSEMOBILE,SPOUSETAXBRANCH,SPOUSETAXNO,SPOUSEICNO,SPOUSEWORKING,SPOUSEDISABLED,LEAVEGROUP 001,LEE CHONG WAI,,M,12/12/1990,,,,,,,,lcw@gmail.com,901212014321,,,,----,----,----,----,----,----,----,MY,----,----,,02/01/2012,01/04/2012,,M,1,----,3000,----,----,MBB,CIBBMY,111265660,,,,,1,,,0,1,,,,,,,,,,,,,0,0,---- 002,KOO KIAN KEAT,,M,01/01/1992,,,,,,,,,920101101001,,,,----,----,----,----,----,----,----,MY,----,----,,01/08/2012,01/11/2012,,S,1,----,2000,----,HALF,MBB,RHBBMY,56706890,,,,,1,,,0,1,,,,,,,,,,,,,0,0,---- 003,NICOLE,,F,31/08/1994,,,,,,,,,940831105000,,,,----,----,----,----,----,----,----,MY,----,----,,02/01/2012,01/04/2012,,S,1,----,2800,----,----,MBB,MBBEMY,9048540654,,,,,1,,,0,1,,,,,,,,,,,,,0,0,---- 004,WONG CHUN HAN,,M,21/06/1984,,,,,,,,,840621083003,,,,----,----,----,----,----,----,----,MY,----,----,,01/02/2012,02/05/2012,,M,1,----,3200,----,----,MBB,HLBBMY,5646506160,,,,,1,,,0,1,,,,,,,,,,,,,0,0,---- 005,YAP KIM HOCK,,M,28/06/1980,,,,,,,,,800628063333,,,,----,----,----,----,----,----,----,MY,----,----,,02/01/2012,01/04/2012,,M,1,----,5000,----,----,MBB,OCBCMY,58946514315,,,,,1,,,0,1,,,,,,,,,,,,,0,0,----

Table Fields Properties
Field Name	Remarks
Marital Status	S - Single M - Married D - Divorced W - Widow
Socso Type	1 - First Category 2 - Second Category 0 - No Socso
EIS Type	0 - No EIS 1 - Has EIS
EIS Category	1 - Foreign workers 2 - Public sector 3 - Domestic servant 4 - Age 57 to 59 (never contribute EIS before) 5 - Employer with no employee 6 - Self employed/sole proprietors 7 - Spouse of employer
Bank Code	Is Bank SWIFT Code PHBMMY - Affin Bank Berhad RJHIMY - Al Rajhi Banking & Investment Corporation (Malaysia) Berhad MFBBMY - Alliance Bank Malaysia Berhad ARBKMY - AmBank (M) Berhad BIMBMY - Bank Islam Malaysia Berhad BKRMMY - Bank Kerjasama Rakyat Malaysia Berhad BMMBMY - Bank Muamalat Malaysia Berhad BSNAMY - Bank Simpanan Nasional Berhad CIBBMY - CIMB Bank Berhad CITIMY - Citibank Berhad DEUTMY - Deutsche Bank (Malaysia) Berhad HLBBMY - Hong Leong Bank Berhad HBMBMY - HSBC Bank Malaysia Berhad ICBKMY - Industrial and Commercial Bank of China (Malaysia) Berhad MBBEMY - Malayan Banking Berhad OCBCMY - OCBC Bank (Malaysia) Berhad PBBEMY - Public Bank Berhad RHBBMY - RHB Bank Berhad SCBLMY - Standard Chartered Bank Malaysia Berhad SMBCMY - Sumitomo Mitsui Banking Corporation Malaysia Berhad UOVBMY - United Overseas Bank (Malaysia) Berhad

[top]

Allowance & Deduction

Example - Allowance
"Date","Employee","Code","Unit" 26/6/2017,A0001,HP,4 28/6/2017,A0001,FUEL,9.63 26/6/2017,A0002,HP,6.30 26/6/2017,A0003,FUEL,4.92 26/6/2017,A0004,HP,1

Example - Deduction
"Date","Employee","Code","Unit" 26/6/2017,A0001,LATE,4 28/6/2017,A0001,LATE,9.63 26/6/2017,A0002,LATE,6.30 29/6/2017,A0002,LATE,3.37 26/6/2017,A0003,LATE,4.92

Table Fields Properties
Field Name	Field Type	Field Size	Remarks
Date	Date	0	In dd/mm/yyyy or dd-mm-yyyy format
Employee	String	30	Employee Code/ID
Code	String	20	Allowance or Deduction Code
Unit	FMTBcd	8	Qty or Unit

[top]

Claim

Example 1 - Claim
"TransDate","PostDate","Employee","Code","Amount" 26/6/2017,26/6/2017,A0001,TOLL,4 28/6/2017,28/6/2017,A0001,PARKING,9.63 26/6/2017,26/6/2017,A0002,TOLL,6.30 26/6/2017,26/6/2017,A0003,PARKING,4.92 26/6/2017,26/6/2017,A0004,TOLL,1

Example 2 - Claim
"TransDate","PostDate","Employee","Code","Description","Ref1","REF2","Amount" 26/6/2017,26/6/2017,A0001,PARKING,"MID VALLEY - CUSTOMER AB","IV-01243","1235481377828",4 28/6/2017,28/6/2017,A0001,PARKING,"MID VALLEY - CUSTOMER AB","IV-01243","2584986928248",9.65 26/6/2017,26/6/2017,A0002,TOLL,"TOLL CLAIM","","",6.30

Table Fields Properties
Field Name	Field Type	Field Size	Remarks
TransDate	Date	0	In dd/mm/yyyy or dd-mm-yyyy format Date of transaction Default TransDate is same as PostDate
PostDate	Date	0	In dd/mm/yyyy or dd-mm-yyyy format Date of Process Date Default PostDate is same as TransDate
Employee	String	30	Employee Code/ID
Code	String	20	Claim Code
Description	String	100	Claim Description (Optional)
Ref1	String	20	Claim Reference 1 (Optional)
Ref2	String	20	Claim Reference 2 (Optional)
Amount	FMTBcd	8	Claim Amount

[top]

Batch File Import

This function only Available in Version 1.2019.167.146 & above.

All file should be in CSV also but need to be in 1 zip file.

In Zip should had At least 2 file

Transaction File (eg pending.overtime.csv)
Hash File (eg pending.overtime.hash)

Zip File Name can be any name you like

Pros

1 Button to import all the files
No need to manually mapping the column
Secure from changes by user cause file is Hash

Cons

Need follow the column name given

Overtime & Wages

Transaction Type	File Name
Wages	pending.wages.csv pending.wages.hash
Overtime	pending.overtime.csv pending.overtime.hash

Example 1 - OT or Wages
TransDate,PostDate,Employee,Code,WorkUnitAsTime 26/6/2015,26/6/2015,A001,DR01,04:00 28/6/2015,28/6/2015,A001,DR02,09:38 26/6/2015,26/6/2015,A002,DR02,06:18 29/6/2015,29/6/2015,A002,DR03,03:22 26/6/2015,26/6/2015,A003,DR03,04:55

Example 2 - OT or Wages
"TransDate","PostDate","Employee","Code","WorkUnit" 26/6/2015,26/6/2015,A001,DR01,4 28/6/2015,28/6/2015,A001,DR02,9.63 26/6/2015,26/6/2015,A002,DR02,6.30 29/6/2015,29/6/2015,A002,DR03,3.37 26/6/2015,26/6/2015,A003,DR03,4.92

Table Fields Properties
Field Name	Field Type	Field Size	Remarks
TransDate	Date	0	In dd/mm/yyyy or dd-mm-yyyy format Date of transaction
PostDate	Date	0	In dd/mm/yyyy or dd-mm-yyyy format Date of Process Date
Employee	String	30	Employee Code/ID
Code	String	20	Overtime or Wages Code
WorkUnit	FMTBcd	8	Time in rate eg 3 hr 15 min = 3.25 (3 + (15/60))
WorkUnitAsTime	Time	0	In HH:MM format

[top]

Leave

File Name

leave.application.csv
leave.application.hash

Example 1 - Leave
LeaveDate,Code,LeaveType,Description,LeaveDayAsTime 08/11/2015,001,UL,Sick,08:00 19/11/2015,003,UL,Fever,09:20 15/11/2015,005,UL,Sick,08:00 01/11/2015,001,AL,Holiday To Melaka,08:00 03/11/2015,003,AL,Holiday To Penang,08:00 08/11/2015,005,MC,High Fever,08:00

Example 2 - Leave
LeaveDate,Code,LeaveType,Description,LeaveDay 08/11/2015,001,UL,Sick,1 19/11/2015,003,UL,Fever,1.17 15/11/2015,005,UL,Sick,1 01/11/2015,001,AL,Holiday To Melaka,1 03/11/2015,003,AL,Holiday to Penang,1 08/11/2015,005,MC,High Fever,1

Table Fields Properties
Field Name	Field Type	Field Size	Remarks
Date	Date	0	In dd/mm/yyyy or dd-mm-yyyy format
Code	String	30	Employee Code/ID
LeaveType	String	20	Leave Code (Eg AL, MC, etc)
Description	String	80	Leave Description
LeaveDay	FMTBcd	8	Day in rate eg 9 hr 20 min for 8 hr per day = 1.17 (((9+(20/60))/24)*(24/8))
LeaveDayAsTime	Time	0	In HH:MM format

It adviceable to use LeaveDay instead of LeaveDayAsTime as

LeaveDayAsTime max value can enter is 23:59 only
if you Export as Grand Total

[top]

Allowance & Deduction

Transaction Type	File Name
Allowance	pending.allowance.csv pending.allowance.hash
Deduction	pending.deduction.csv pending.deduction.hash

Example - Allowance
"TransDate","PostDate","Employee","Code","WorkUnit" 26/6/2017,26/6/2017,A0001,HP,4 28/6/2017,28/6/2017,A0001,FUEL,9.63 26/6/2017,26/6/2017,A0002,HP,6.30 26/6/2017,26/6/2017,A0003,FUEL,4.92 26/6/2017,26/6/2017,A0004,HP,1

Example - Deduction
"TransDate","PostDate","Employee","Code","WorkUnit" 26/6/2017,26/6/2017,A0001,LATE,4 28/6/2017,28/6/2017,A0001,LATE,9.63 26/6/2017,26/6/2017,A0002,LATE,6.30 29/6/2017,29/6/2017,A0002,LATE,3.37 26/6/2017,26/6/2017,A0003,LATE,4.92

Table Fields Properties
Field Name	Field Type	Field Size	Remarks
TransDate	Date	0	In dd/mm/yyyy or dd-mm-yyyy format Date of transaction Default TransDate is same as PostDate
PostDate	Date	0	In dd/mm/yyyy or dd-mm-yyyy format Date of Process Date Default PostDate is same as TransDate
Employee	String	30	Employee Code/ID
Code	String	20	Allowance or Deduction Code
WorkUnit	FMTBcd	8	Qty or Unit

[top]

File Hash

The Hash is using MD5

Steps

01. File Hash : Hash MD5 the whole file

02. File String Hash : Hash MD5 again using the result shown in MD5 in Step 1.

03. Save the result in Step 2 in .hash file

Example Using the Allowance Information as above

01. Result from File Hash : e83045758c13cb7c17ba8f2150919f36

02. Result from String Hash from Step 1 : 1b324dad30a84f322c23a1cdec481cc1

03. Save the Result in Step 2 in pending.allowance.hash file

[top]

Command Line Sync

This function only Available in Version 1.2020.186.160 & above.

This function can import and export file from/to SQL Payroll

Setting In SQL Payroll

An access token is required when the third party application calls data provider and data import commands.

01. Click Tools | Maintain User

02. Double Click ADMIN user

03. Click More | Generate Access Token

04. Enter the ADMIN password

05. Save the Token File

Data Provider (Export)

This command is to export data from SQL Payroll to Json file

[SQL Payroll bin folder Path]> sqlpay -token "<accesstoken>" -dataprovider -id "<id>" [-<param name> "<param value>"] -out "<json file>"

Command	Description
[SQL Payroll bin folder Path]	Folder path where SQL Payroll Install Eg C:\estream\SQL Payroll\bin
-token	A Code where generate
-dataprovider	Indicator To export Data from SQL Payroll
-id	Indicator type of Data to export
[-<param name> "<param value>"]	Additional parameter for some id type
-out	Json file folder & name to save to

[top]

Maintain Employee

Command

[SQL Payroll bin folder Path]> sqlpay -token "<accesstoken>" -dataprovider -id ""employee"" -out "<json file>"

Example

C:\estream\SQL Payroll\bin>sqlpay -token "eyJ0eXAiOi..." -dataprovider -id "employee" -out "c:\Users\Star\Desktop\employee.json"

[top]

Maintain Branch

Command

[SQL Payroll bin folder Path]> sqlpay -token "<accesstoken>" -dataprovider -id ""branch"" -out "<json file>"

Example

C:\estream\SQL Payroll\bin>sqlpay -token "eyJ0eXAiOi..." -dataprovider -id "branch" -out "c:\Users\Star\Desktop\branch.json"

[top]

Things To Consider

01. The target database must had Valid

- Employee Code

- OT Code

- Leave Code

- Wages Code

02. File extention must be in csv (e.g. OT.csv)

03. The data in "Net Figure" (eg. OT WorkUnitAsTime := Logout Time - Login Time)

04. There is no display format for Amount/Qty (eg 1600.12 not 1,600.12)

05. There is no extra spacing at the Begin & End of data (eg Tes1,Test2 not Tes1 , Tes2 ,)

06. The data type which is Boolean (0 = False & 1 = True)

07. Must 1 Transaction type 1 file (i.e. Overtime 1 file & Leave 1 file)

08. The output can be export out in Day or Time but not both in same time

09. Make sure only export out relevant data (eg if OT = 0 or No leave taken don't export out)

----------------------------------------------------------------------------------------------------------------------------------------------------

Notes

1. Output Can be in Tab, Semicolon or Comma.
2. Field can be added by just look in the field chooser in Pending Payroll.

----------------------------------------------------------------------------------------------------------------------------------------------------

Need assistance? May email to support@sql.com.my

@@ Line 634: / Line 634: @@
 =====Maintain Branch=====
+Command
+<pre>
+[SQL Payroll bin folder Path]> sqlpay -token "<accesstoken>" -dataprovider -id ""branch"" -out "<json file>"
+</pre>
+Example
+<pre>
+C:\estream\SQL Payroll\bin>sqlpay -token "eyJ0eXAiOi..." -dataprovider -id "branch" -out "c:\Users\Star\Desktop\branch.json"
+</pre>
 <div style="float: right;">   [[#top|[top]]]</div>
 =====Maintain Department=====
 <div style="float: right;">   [[#top|[top]]]</div>

Revision as of 04:15, 12 September 2020

Introduction

Special Import

Standard Import

SQL Payroll Program

Modules Require

Guideline & Example

Single File Import

Overtime & Wages

Leave

Employee

Allowance & Deduction

Claim

Batch File Import

Overtime & Wages

Leave

Allowance & Deduction

File Hash

Steps

Command Line Sync

Setting In SQL Payroll

Data Provider (Export)

Maintain Employee

Maintain Branch

Maintain Department

Maintain HR Group

Maintain Category

Maintain Project

Maintain Job

Maintain Task

Maintain Leave Type

Maintain Leave Group

Leave Application

Maintain Wages

Maintain Allowance

Maintain Overtime

Maintain Commission

Maintain Claim

Maintain Deduction

PaySheet

Things To Consider

See also