คู่มือการติดตั้งใช้งาน...

20
กองเทคโนโลยีสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หน้าที1 คู่มือการติดตั้งใช้งานโปรแกรมสาหรับซอฟต์แวร์สาเร็จรูป (Software Component :SWC)

Transcript of คู่มือการติดตั้งใช้งาน...

Page 1: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 1

คมอการตดตงใชงานโปรแกรมส าหรบซอฟตแวรส าเรจรป

(Software Component :SWC)

Page 2: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 2

โปรแกรมส าหรบซอฟตแวรส าเรจรป (Software Component :SWC)

4.1. เกยวกบระบบ (Software Component : SWC) Software Component : SWC คอ สวนประกอบโปรแกรมส ำหรบซอฟตแวรส ำเรจรป ทกรมสรรพำกรพฒนำขน โดยมงหวงใหผเสยภำษอำกร น ำไปใชงำนรวมกบโปรแกรมระบบงำนของหนวยงำน เพอจดสงขอมลภำษเงนไดหก ณ ทจำย ขอมลดอกเบยเงนฝำกธนำคำร จำกเครองคอมพวเตอร หรอเครองคอมพวเตอรแมขำยของผเสยภำษอำกร สเครองคอมพวเตอรแมขำยกรมสรรพำกร ผำนเครอขำยอนเทอรเนต (Server to Server :S2S) ในลกษณะของกำรฝำกไฟลใบแนบรำยกำรลวงหนำไวกอน จำกนนระบบงำนจะสรำงแบบยนรำยกำรภำษเงนไดหก ณ ทจำย หรอใบน ำสงขอมล โดยมรำยละเอยดบนหนำแบบ และเลขอำงองกำรฝำกไฟล เพอแสดงวำระบบไดรบกำรฝำกไฟลไว เรยบรอยแลว และยนแบบพรอมช ำระภำษ (ถำม) ณ ส ำนกงำนสรรพำกรพนทสำขำ (ไมตองแนบแผนสอฯหรอใบแนบรำยกำร) ตำมก ำหนดเวลำกำรยนแบบตอไป หรอจะเลอกน ำขอมลไปยนผำนระบบกำรยนแบบทำงอนเทอรเนตของกรมสรรพำกรกได ทงน ระบบ SWC สามารถน าสงขอมลไดจ านวนมากกวาการยนแบบบนผานอนเทอรเนตในสภาพปกต มความถกตองและปลอดภย รองรบมาตรฐานระดบสากล (ISO27001) ผใชสำมำรถดำวนโหลดและตดตงใชงำนไดงำย ไมกระทบตอระบบงำนเดมของผใชงำน และไมมคำใชจำยใดๆ

โปรแกรมส ำหรบซอฟตแวรส ำเรจรป (Software Component :SWC) อำศยหลกกำรท ำงำน Plug-in Concept ท ำกำรเชอมตอกบระบบงำนของผเสยภำษอำกร โดยจะไมกระทบตอระบบงำนเดม สอดรบกบนโยบำยดำนควำมมนคงปลอดภยสำรสนเทศของหนวยงำน ชวยลดระยะเวลำในกำรพฒนำโปรแกรมยนแบบกบกรมสรรพำกร ผเสยภำษอำกรทมระบบงำนของตน หรอมระบบงำนเงนเดอน (Payroll) หรอหนวยงำนรำชกำรทเขำระบบจำยตรงของกรมบญชกลำง สำมำรถ Download และน ำ Software Component :SWC ไปเพอยนแบบกบกรมสรรพำกรได ทงน เพอลดระยะเวลำกำรด ำเนนกำร ลดปรมำณกำรใชกระดำษ ลดกำรใชสอซดรอมหรอสอ (Media) อนๆ และลดคำใชจำยของหนวยงำน

Page 3: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 3

4.2. กลมผใชงาน SWC 1) ผเสยภำษอำกรทใชงำนซอฟตแวรส ำเรจรป เปนหนวยงำนทมระบบงำนและขอมลในฐำนขอมล

อยแลว เชน กจกำรธนำคำร หรอหนวยงำนทไมใชธนำคำรทมกำรจำยดอกเบยและเงนปนผล หนวยงำนรำชกำรทเขำระบบจำยตรงของกรมบญชกลำง (GFMIS) หรอหนวยงำนทใชโปรแกรมเงนเดอน (Payroll)

4.3. การท างานของระบบ SWC

ขนตอนการด าเนนการ

1) ผเสยภำษอำกรดำวนโหลดโปรแกรม SWC จำกเวบไซดกรมสรรพำกร 2) น ำ SWC ไป Plug-in โดยพฒนำใชงำนรวมกบระบบงำนปจจบน หรอตดตงแยกตำงหำก 3) ผเสยภำษอำกรลงทะเบยนเพอขอใชบรกำรจำกเวบไซดกรมสรรพำกร 4) กรมสรรพำกรสงอเมลตอบรบกำรลงทะเบยนพรอมแจงใหยนเอกสำรประกอบกำรลงทะเบยน

ณ กองบรหำรภำษธรกจขนำดใหญ หรอ ส ำนกงำนสรรพำกรพนท ตำมภมล ำเนำ 5) ส ำหรบผเสยภำษอำกร รำยใหม (ไมเคยยนแบบทำงอนเทอรเนตหรอยนดวยสอฯ กบ

กรมสรรพำกรมำกอน) น ำเอกสำรประกอบกำรลงทะเบยน (รำยเอยดตำมทระบในอเมล) ยน ณ กองบรหำรภำษธรกจขนำดใหญ หรอ ส ำนกงำนสรรพำกรพนท ส ำหรบรำยเกำ (ไดรบกำรลงทะเบยน ภ.อ.01 หรอ ส.ส.01) ไมตองยนเอกสำรประกอบกำรลงทะเบยนแตอยำงใด ทงน กรมสรรพำกรจะยดถอตำมเอกสำรทไดเคยยนไวแลว เพอเปนกำรอ ำนวยควำมสะดวกใหกบรำยทเคยยนแบบดวยสอฯ หรออนเทอรเนตของกรมสรรพำกรมำกอน

6) เจำหนำทส ำนกงำนสรรพำกรพนท หรอ กองบรหำรกำรเสยภำษธรกจขนำดใหญ พจำรณำอนมตกำรลงทะเบยน หรอพจำรณำไมอนมตกำรลงทะเบยน

7) ระบบงำนจดสงอเมลตอบรบกำรลงทะเบยนกรณอนมต โดยม เลขอำงองกำรลงทะเบยน ใบรบรองอเลกทรอนกส (Digital Certificate) และ กญแจสวนบคคล (Private key) Username Password และใบรบรองอเลกทรอนกส (Digital Certificate) ของกรมสรรพำกร หรออเมลแจงผลกำรไมอนมตกำรลงทะเบยน

Page 4: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 4

8) ผเสยภำษอำกรท ำกำรฝำกไฟลขอมลผำนระบบงำนผำนเครอขำยอนเทอรเนต หรอเลอกสรำงแผนสอฯ (ซด) ไดในกรณสภำพอนเทอรเนตของหนวยงำนไมเอออ ำนวย

9) ผเสยภำษอำกรพมพแบบฯ ทระบเลขอำงองกำรฝำกไฟล (กรณฝำกไฟล) หรอพมพแบบฯ ทไมระบเลขอำงองกำรฝำกไฟล (กรณเลอกเปนซด) ทไดจำกระบบยน ณ หนวยรบช ำระภำษ

4.4. สถาปตยกรรมระบบงาน

Logger

Taxpayer Client (SWC)Authentication by WHTSVS user

P780

� Software Component � � (Production)

TSM Backup

14

2

6

3

5

WHTONL2192.168.138.194, 192.168.78.194,

192.168.93.2

AIX 6.1 TL6 SP1

WHTONL1

IBM DB2 Enterprise Server v9.7

192.168.138.193, 192.168.78.193,

192.168.93.1

AIX 6.1 TL6 SP1

WHTSOA1

IBM WebSphere ND v7.0

192.168.138.1, 192.168.138.129, 192.168.225.33

Windows Server 2008 R2 Standard Service Pack 1 64 bit

System x3650 M3 Intel(R) Xeon(R) CPU E5640 @2.67GHz 2.66GHz Ram 8GB

WHTSOA2

IBM WebSphere ND v7.0

192.168.138.2, 192.168.138.130, 192.168.225.34

Windows Server 2008 R2 Standard Service Pack 1 64 bit

System x3650 M3 Intel(R) Xeon(R) CPU E5640 @2.67GHz 2.66GHz Ram 8GB

WHTCAM192.168.139.129, 192.168.139.65

Windows Server 2008 R2 Enterprise

Service Pack 1 64 bit

System x3650 M3 Intel(R) Xeon(R)

CPU E5640 @2.67GHz 2.66GHz Ram 8GB

4.6. สวนควบคมดาน Security ของ Software Component Web Service

HTTPS Protocol

Base64

DES Encryption

Sign with Digital Signature RSA2048 bit

HTTPS Protocol

DES & RSA 2048 Decryption

Certificate Authority Check

Web Service(Username/Password)

Software Component�

Software Component Web Service

รปแบบการเขารหส ของ Software Component

1. กำรเขำรหสขอมล ใชกระบวนกำรเขำรหสเปน RSA 2048 Encryption โดยกำรใช Digital Signature Private key ของผเสยภำษ และ Public key ของกรมสรรพำกรในกำร Sign File เพอน ำสงขอมล

2. วธกำรน ำสงไฟล ใช RESTFUL Web service บน HTTPS protocol (Port 443) ซงเปน secure port และมกำรใชใบรบรองควำมปลอดภย SSL ทมกำรจดทะเบยนอยำงถกตอง

3. มำตรฐำนกำรเขำรหสแบบ Data Encryption Standard (DES) และแปลงไฟลใหเปน มำตรฐำน BASE64 เพอกำรสงขอมลแบบ RESTFUL Web Service

Page 5: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 5

4. ในกระบวนกำรสงไฟลในขนตอนของกำร request จะมกำรสง ขอมลของ Username / Password เลขอำงองกำรลงทะเบยน เลขประจ ำตวผเสยภำษอำกร และสำขำของผน ำสง ของระบบ Software Component Web Service เพอตรวจสอบยนยนตวตน กอนกำรฝำกไฟลทกครง

5. หลงจำกทท ำกำรฝำกไฟลส ำเรจ ระบบ Software Component Web service จะท ำกำร Decryption ไฟล และสอบถำมสถำนะของ Digital Signature วำสำมำรถใชงำนไดหรอไม ผำนชองทำง Web Service (Certificate Authority) ของ WHTCAM หำก Digital Signature สำมำรถใชงำนได ระบบ Software Component Web Service จะท ำกำรสงขอมลไปทเครอง WHTONL2 ทำง SFTP Protocol และระบบจะออกเลขทอำงองกำรฝำกไฟล ตำมทธระกรรมรองขอ จงจะถอวำกระบวนกำรท ำงำนส ำเรจ

4.7. การเตรยมการเบองตนกอนใชบรการ (Pre-Condition) 1. เครองคอมพวเตอร

1) หนวยควำมจ ำ RAM ขนำด 4GB หรอ สงกวำ 2) ฮำรดดสก ขนำดไมนอยกวำ 250 GB 3) Internet ในกำรเชอมโยงระบบงำนเพอใชในกำรยนสอฝำกไฟลผำน Web Service 4) ระบบปฏบตกำร Windows XP SP3 Windwos 7 หรอสงกวำ 5) สถำปตยกรรมแบบ 32 บต หรอ 64 บต

2. ผเสยภำษตองมเลขอำงองกำรลงทะเบยน ใบรบรองอเลกทรอนกส (Digital Certificate) และ กญแจสวนบคคล (Private key) Username Password และใบรบรองอเลกทรอนกส (Digital Certificate) ของกรมสรรพำกร ทไดจำกกำรลงทะเบยน ซงกรมสรรพำกรจะสงอเมลตอบรบกำรลงทะเบยน ตวอยำงตำมรป

3. ดำวนโหลดโปรแกรมส ำหรบซอฟตแวรส ำเรจรป Software Component SWC (rdform.zip) 4. ดำวนโหลดโปรแกรม Runtime ส ำหรบ 32 บต หรอ 64 บต ตำมสถำปตยกรรมของเครองทน ำสง 5. ดำวนโหลดตวอยำงขอมลเพอทดสอบ

Page 6: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 6

6. เตรยมขอมลเพอ Load เขำ Software Component จะก ำหนดขอก ำหนด ตำม Format กลำงของกรมสรรพำกร (ดรำยละเอยด Format จำกหวขอดำวนโหลด)

7. ก ำหนดคำเรมตน (Configuration) กอนท ำกำรใชงำน Software Component ผเสยภำษตองกำรท ำกำรปรบปรงไฟล Config.xml หรอก ำหนดคำเรมตนในโปรแกรมชวยน ำสงขอมล (SWC_UI) ซงจะงำยในก ำหนดคำไดเอง เพอให Software Component ท ำงำนใหสอดคลองกบ Environment ของผเสยภำษ ซงจะประกอบดวย

1. เลขประจ ำตวผเสยภำษอำกร (จ ำเปน) 2. เลขทอำงองกำรลงทะเบยน (จ ำเปน) 3. รหสผใชงำนของผดแลระบบ (จ ำเปน) 4. รหสผำนของผดแลระบบ (จ ำเปน) 5. ใบรบรองอเลกทรอนกส (จ ำเปน) 6. รหสเปดไฟล (รหสทผใชตงเองเพอเปนรหสเปดไฟลใบรบรองอเลกทรอนกส) (จ ำเปน) 7. Network Setting เพอ Upload ขอมล และรบคำขอมลเพอพมพแบบยนรำยกำร ใบแนบ

รำยกำร และหนงสอรบรองหก ณ ทจำย (50ทว) (จ ำเปน)กรณสงจำกส ำนกงำนตองมผดแลระบบเครอขำยเปนผชวย หำกสงผำนมอถอ หรอเครองทบำนไม(จ ำเปน)

8. ก ำหนดคำ JAVA Runtime Environment มผลตอระบบงำนทใช JAVA กรณต ำกวำ ตองเลอกตดตง JAVA แยกตำงหำก

9. ก ำหนดคำ Virtual Memory (VM) ไม(จ ำเปน) เฉพำะกรณสงขอมลจ ำนวนมำก

4.8. วธการตดตง

1. ดำวนโหลดโปรแกรมจำกเวบไซดกรมสรรพำกร (www.rd.go.th) >>บรกำรอเลกทรอนกส>> ยนแบบดวยสอคอมพวเตอรและฝำกไฟลออนไลน>>โปรแกรมส ำหรบซอฟตแวรส ำเรจรป (Software Component :SWC)

2. คลกดำวนโหลดไฟลจำกรป

Page 7: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 7

3. ดำวนโหลดโปรแกรม Software Component ไวทเครอง จำกรป ดงน

1. โปรแกรมส ำหรบซอฟตแวรส ำเรจรป (SWC) หรอ ชดปรบปรงเวอรชน SWC_ServicePack

โปรแกรมส ำหรบซอฟตแวรส ำเรจรป กรณตองกำรปรบปรง SWC เปนเวอรชนปจจบน 2. โปรแกรม Runtime 32 หรอ 64 บต ตำมสถำปยกรรมของเครองทใชฝำกไฟลขอมล 3. โปรแกรมชวยน ำสงขอมล SWC User Interface (SWC-UI) หรอ ชดปรบปรงเวอรชน กรณ

ตองกำรปรบปรงโปรแกรมชวยน ำสงขอมล SWC-UI เปนเวอรชนปจจบน 4. ชดตดตง JAVA 32 หรอ 64 บต ตำมสถำปยกรรมของเครองทใชฝำกไฟลขอมล กรณตดตงแยก

ในกรณทหนวยงำนใช JAVA เวอรชนทต ำกวำ 1.7 5. ตวอยำงขอมลเพอกำรทดสอบ กรณตองกำรทดสอบกำรก ำหนดคำเรมตน (Config.xml)

4. ตดตงโปรแกรมส ำหรบซอฟตแวรส ำเรจรป (SWC) 1) Unzip ไฟลชดตดตง (rdform.zip) ไวทเครองและดบเบลคลกไฟลชดตดตง

(Install_SWC.bat) (ขอย ำวำตองแตกซปไฟลชดตดตงทเครองกอน จงจะตดตงส ำเรจ) ตำมรป

Page 8: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 8

2) ดบเบลคลกไฟล Install_SWC.bat โปรแกรมจะท ำกำรตดตงโปรแกรม ตำมรป

5. ดำวนโหลดโปรแกรม Runtime ส ำหรบ Windows 32 bit หรอ 64 บต ไวทเครองทตองกำรตดตง

โปรแกรม จำกนนท ำกำรUnzip ชดตดตง จะไดตำมรป และดบเบลคลกไฟลทงสองเพอตดตงจนเสรจ

กรณ หนวยงานมขอหามตดตง JAVA runtime เวอรชนทสงกวา หำมดบเบลคลกไฟล jdk-7u7-windows-i586.exe ใหด ำเนนกำรตดตง JAVA ชดแยกตำงหำก ตำมรปขอ 3 โดยใหดวธกำรสงกำรท ำงำนตำม Sample_Command ส ำหรบJAVA Runtime 1.7 (jre)

6. ตดตงโปรแกรมชวยน ำสงขอมล SWC User Interface (SWC-UI) จำกกำรดำวนโหลดโปรแกรมตำม

ขอ 3 โดยใหแตกซปไฟลโฟลเดอร SWC_UI ไวภำยใตโฟลเดอร rdform\ และ copy ไฟล shotcut หำกไมพบไฟลน ใหคลกขวำโปรแกรม swc_gui.exe และเลอก create shotcut ไปไวทหนำ DeskTop จำกนนดบเบลคลกจะขนหนำจอ ดงน

7. ดำวนโหลดไฟล Certificate ไดรบจำกอเมลไวทเครอง (กรณตดตงโปรแกรมชวยน ำสงขอมล SWC-

UI ไมตองท ำสวนนใหดคมอกำรก ำหนดคำ Config.xml ในโปรแกรม SWC-UI โดยคลกคมอหนำจอโปรแกรม และใหขำมไปดขอ 4.9) และท ำกำร Unzip โดยขนตอนน ระบบจะใหปอนรหสเปดไฟล

Page 9: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 9

(Passphase) ซงเปนรหสลบทผลงทะเบยนก ำหนดไวเองขณะลงทะเบยน เพอUnzip Certificate จะได 3 ไฟล ดงรป

จำกนนให Copy ไฟลนำมสกล .pfx และ .cer ไว \rdform\clientKey และ Copy ไฟล whtcas.cer ไวท \rdform\serverKey

8. เรมท ำกำร Config คำเรมตน โดยใหเขำไปทโฟลเดอร \rdform\config เปดไฟล Config.xml ดวยโปรแกรม EditPuls หรอโปรแกรมทอำนและแกไขภำษำ XML ไฟล ตวอยำง ดงน <?xml version="1.0" encoding="utf-8"?> <configuration> <application> <pathHomeDir></pathHomeDir> <pathExportPDF>pdf\\</pathExportPDF> <pathExportSVS>svs\\</pathExportSVS> <pathExportZip>zip\\</pathExportZip> <pathImportTXT>txt\\</pathImportTXT> <pathImportXLS>xls\\</pathImportXLS> <pathImportCSV>csv\\</pathImportCSV> <pathImportXML>xml\\</pathImportXML> <pathMasterXML>master\\xml\\</pathMasterXML> <pathTemplate>template\\</pathTemplate> <pathWebService>http://10.20.21.193:9080/WHTSVSOnline/rest/uploadservice/upload</pathWebService> <pathSFTPService>http://10.20.21.193:9080/WHTSVSOnline/rest/sftpservice/upload</pathSFTPService> <pathExtractService>http://10.20.21.193:9080/WHTSVSOnline/rest/extractservice/extract</pathExtractService> <pathWebServiceHome>http://10.20.21.193:9080/WHTSVSOnline/</pathWebServiceHome> <pathRefDocNoWS>http://10.20.21.193:9080/WHTSVSOnline/rest/refdocnoservice/getrefdocno</pathRefDocNoWS> <pathClientKey>clientkey\\</pathClientKey> <pathServerKey>serverkey\\</pathServerKey> <clientPriKeyName>ZZZZZZZZZZZZZZZZZZZZ.pfx</clientPriKeyName> <clientPubKeyName>ZZZZZZZZZZZZZZZZZZZZ.cer</clientPubKeyName> <senderNid>TTTTTTTTTTTTT</senderNid> <senderBranch>BBBBBB</senderBranch> <regRefNo>ZZZZZZZZZZZZZZZZZZZZ</regRefNo> <useSystemProxies>Y</useSystemProxies> <proxyHost>XX.XX.XX.XX</proxyHost> <proxyPort>XXXX</proxyPort> <proxyAuthenticationRequired>Y</proxyAuthenticationRequired> <proxyUser>XXXXXX</proxyUser> <proxyPassword>XXXX</proxyPassword> <serverPubKeyName>whtcas.cer</serverPubKeyName> <formatFolderName>yyyyMMddHHmmss</formatFolderName> <pathSessionKey>clientkey\\key.sessionkey</pathSessionKey> <fileSize>2048</fileSize> <passphase>xxxxxxxx</passphase> </application> <user>

Page 10: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 10

<username>xxxxxxxxxxxxxx</username> <password>xxxxxxxxxxxxx</password> </user> </configuration>

กำร Config คำเรมตน ใหกรอกคำแทนตงอกษร ดงน 1) <clientPriKeyName>ZZZZZZZZZZZZZZZZZZZZ.pfx</clientPriKeyName> อกษรตว ZZZZZZZZZZZZZZZZZZZZ ใหแทนดวยชอ Certificate ทไดจำกกำรลงทะเบยน 2) <clientPubKeyName>ZZZZZZZZZZZZZZZZZZZZ.cer</clientPubKeyName>

อกษรตว ZZZZZZZZZZZZZZZZZZZZ ใหแทนดวยชอ Certificate ทไดจำกกำรลงทะเบยน

3) <senderNid>TTTTTTTTTTTTT</senderNid> อกษรต ว TTTTTTTTTTTTT ใหแทนดวย เลขประจ ำตวผ เ ส ยภำษอำกรของผ ส ง (ตำม Format 2.0 สวน Header ชอฟลด senderNid)

4) <senderBranch>BBBBBB</senderBranch> อกษรตว BBBBBB ใหแทนดวย สำขำของผน ำสง (ตำม Format 2.0 สวน Header ชอฟลด sender_branch)

5) <regRefNo>ZZZZZZZZZZZZZZZZZZZZ </regRefNo> อกษรตว ZZZZZZZZZZZZZZZZZZZZ ใหแทนดวยเลขอำงองกำรลงทะเบยน ทไดจำกอเมลตอบรบกำรลงทะเบยน

6) <useSystemProxies>Y</useSystemProxies> กรณหนวยงำนม Proxies Server เพอควบคมกำรทองอนเทอรเนตใหระบเปน Y และใหปอนคำขอ 7-11 ทงน ใหสอบถำมเจำหนำทเครอขำยของหนวยงำน หำกไมม Proxies Server ไมตองกรอกคำใดๆ หรอหำกมคำทกรอกอยโปรแกรมจะไมน ำไปใชงำน

7) <proxyHost>XX.XX.XX.XX</proxyHost> 8) <proxyPort>XXXX</proxyPort> 9) <proxyAuthenticationRequired>Y</proxyAuthenticationRequired> 10) <proxyUser>XXXXXX</proxyUser> กรณตองกำรปอนเองทกครงขณะสงท ำงำนให คำ tag ตดกน <proxyUser></proxyUser> 11) <proxyPassword>XXXX</proxyPassword> กรณตองกำรปอนเองทกครงขณะสงท ำงำนให คำ tag ตดกน <proxyPassword></proxyPassword> 12) <passphase>xxxxxxxx</passphase> ปอนรหสเปดไฟล จะเปนรหสทผลงทะเบยนไดกรอกไวขณะท ำกำรลงทะเบยน ซงจะตองจ ำเอง กรณตองกำรปอนเองทกครงขณะสงท ำงำนให คำ tag ตดกน ดงน <passphase></passphase> 13) <username>xxxxxxxxxxxxxx</username>

Page 11: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 11

14) <password>xxxxxxxxxxxxx</password>

ใหปอนคำ Username และ Password ทไดจำกอเมลตอบรบกำรลงทะเบยน

หมำยเหต กรณยนแบบดวย SWC ไมควร logon เขำสระบบใหบรกำรภำษเงนไดหก ณ ทจำยใชงำนออนไลน SVS หำกไมจ ำเปน กรณทำนได logon เขำสระบบงำนครงแรก ระบบฯ จะบงคบใหเปลยน Username และ Password ทำนจะตองกรอกคำทไดเปลยนไปแลว แทน

4.9. การปรบปรงเวอรชน (ServicePack) กรณทกรมสรรพำกรไดปรบปรงโปรแกรมเปนเวอรชนใหม ผทเคยตดตงและใชงำนในเวอรชนทผำนมำ

สำมำรถดำวนโหลดชดปรบปรงเวอรชน (ServicePack) ใหเปนเวอรชนปจจบน โดยไมตองตดตงใหมทงหมด ทงน จะไมกระทบตอคำใดๆ ทได Config ไวแลว ทงน ระบบกำรรบฝำกไฟลจะมกำรตรวจสอบเวอรชนทกครงทมกำรน ำสง ใหดำวนโหลดชดปรบปรงเวอรชนไวทเครองและ Unzip ไฟลตดตง ดงรป

ดบเบลคลกไฟลตดตง SWC_ServicePack1.2.bat (หรอเวอรชนทสงกวำ) จะท ำกำรปรบปรงเวอรชน ตำมรป

4.10 . การทดสอบและการน าสงขอมล 1. กำรทดสอบน ำสงขอมล ขนตอนกำรทดสอบจะแบงเปน 2 ขนตอน คอ

1) ขนตอนท 1 Environment Test จะเปนกำรทดสอบกำร Config คำตำงๆ และสภำพเครอขำยอนเทอรเนต โดยใหดำวนโหลดตวอยำงขอมลเพอกำรทดสอบ(swc_data_test_1.2.zip) ให Unzip จะไดไฟลตำมรป

Page 12: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 12

2) แกไขขอมลเพอใชทดสอบ เชน เลอกทดสอบ ภ.ง.ด.2 ใหแกไข ชอไฟล PND2_TTTTTTTTTTTTTT_000000_2555_06_00_00.txt โดยใหก ำหนดคำ TTTTTTTTTTTTTT เปนเลขประจ ำตวผเสยภำษอำกรของผมหนำทหกภำษ ณ ทจำย

3) เปดขอมลท ำกำรแกไข TTTTTTTTTTTTTT เปนเลขประจ ำตวผเสยภำษอำกรจำกซำยไปขวำ ของผน ำสง SenderNID ตว TTTTTTTTTTTTTT ตอมำ ใหกรอกเลขประจ ำตวผเสยภำษอำกรของผมหนำทหกภำษ ณ ทจำย (หำกเปนคนเดยวกนจะไดคำเหมอนกน) และตว อกษร ZZZZZZZZZZZZZZZZZZZZ จะเปนเลขอำงองกำรลงทะเบยนทไดจำกอเมล ตำมรป

4) สงหนำแบบทไดจำกกำรทดสอบ เพอแจงผลกำรทดสอบ และลบขอมลกำรทดสอบทกครงทสงไฟลส ำเรจ ใหกบเจำหนำทกรมสรรพำกรทำงอเมล เพอยนยนกำรทดสอบและลบขอมลกำรทดสอบทกครง และท ำกำรขดฆำหนำแบบทดสอบ เพอปองกนปญหำกำรยนแบบผดพลำด

5) ขนตอนท 2 Data Test ขนตอนน DBA หรอผจดกำร Database จะเปนผท ำขอมลใหตรงตำมขอก ำหนด Format 2.0 ของกรมสรรพำกร เพอน ำมำทดสอบ ซงอำจแยกทมกำรท ำงำนกนท ำระหวำงขนตอนทดสอบ 1 และ 2 สำมำรถท ำงำนไปพรอมกนได เมอทดสอบส ำเรจจะไดหนำแบบฯ เพอยนยนกำรทดสอบและลบขอมลกำรทดสอบทกครง และท ำกำรขดฆำหนำแบบทดสอบ เพอปองกนปญหำกำรยนแบบผดพลำด ทงน ระหวำงวนทยนแบบและช ำระภำษ (1 – 7 ของเดอนภำษถดไป) กรมสรรพำกรขอควำมกรณำหำมด ำเนนกำรทดสอบน ำสงขอมล เนองจำกจะกระทบตอกำรยนแบบจรง

6) ดบเบลคลก SWC_GUI (ตงคำโดยก ำหนดหนวยงำนและConfig.xml แลว) คลกฝำกไฟลและBrowse ไฟลทตองกำรน ำสง (ดวธกำรน ำสงจำกคมอในโปรแกรม SWC_GUI) หำกไมใช SWC_GUI กำรสงขอมล ใหน ำไปไวท /rdform/transform/ ซงจะแยกโฟลเดอรตำมแบบ เชน PND1 PND1a PND1as PND2 PND2a PND3 PND3a และ PND53 ซงจะเปนโฟลเดอรส ำหรบขอมล ภ.ง.ด.1 ภ.ง.ด.1ก ภ.ง.ด.1ก พเศษ ภ.ง.ด.2 ภ.ง.ด.2ก ภ.ง.ด.3 ภ.ง.ด.3ก และ ภ.ง.ด.53 ตำมล ำดบ

Page 13: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 13

4.11. จดขอมลตาม Format 2.0 จดท ำขอมล ตำมขอก ำหนด Format 2.0 ของแตละประเภทแบบ ดงรป

4.12. ชดค าสงการน าสงขอมล (กรณไมใชตดตง SWC_GUI) แนะน ำใหตดตงโปรแกรมชวยน ำสงขอมล SWC User Interface (SWC-UI) เพมเตม เพอน ำสงขอมล ซงจะไมตองยงยำกใหก ำหนดคำค ำสงหรอกำรวำงไฟลเพอฝำกไฟลขอมล สำมำรถคลกดวธกำรใชงำนไดจำกโปรแกรม หรอจะด ำเนนกำรน ำสงขอมลตำมรปแบบค ำสงในลกษณะ Command line ซงสำมำรถเลอกรปแบบค ำสงเชอมตอกบระบบงำนของผเสยภำษอำกร จำกโฟลเดอร /rdform/sample_command ประกอบดวยขนตอนกำร ดงน

a. 01_SWC_Covert.bat (Validate&Convert) ขนตอนกำรตรวจสอบใบรบรองอเลกทรอนกส (Digital Certificate) เพอยนยนตวของผน ำสง และตรวจรปแบบขอมลใหเปนไปตำมขอก ำหนด Format 2.0 ซงจะตองผำนกำรตรวจสอบในขนตอนน จงจะยอมใหท ำงำนในขนตอนตอไป ระบบจะเขยน log ผลกำรด ำเนนกำร

b. 02_SWC_Upload.bat (Data Transform) ท ำกำรเขำรหสขอมลและน ำสงขอมลผำนอนเทอรเนตของหนวยงำนสคอมพวเตอร จะท ำงำนตอเนองจำกขนตอนท 01 ระบบจะเขยน log ผลกำรด ำเนนกำรตอจำกขนตอนทผำนมำ

c. 03_SWC_getTaxForm.bat รองขอเลขทอำงองกำรฝำกไฟลจำกระบบงำนและสรำงแบบยนรำยกำรภำษเงนไดหก ณ ทจำยในรปแบบ .pdf ไฟล จะท ำงำนตอเนองจำกขนตอนท 02 ระบบจะเขยน log ตอจำกขนตอนทผำนมำ

d. 04_SWC_offLineMode.bat สรำงแบบยนรำยกำรภำษเงนไดหก ณ ทจำยพรอมแผนสอใบแนบรำยกำรเพอน ำไปยน กรณไมสำมำรถน ำสงทำงอนเทอรเนตสภำพปกตได หำกด ำเนนกำรตำม 01 02 และ 03 ไดแลวไมตองด ำเนนกำรในขอน แตหำกสภำพอนเทอรเนตมปญหำจ ำเปนตองสงดวยซด จะตองด ำเนนกำรในขนตอน 01 และ 04 จะท ำงำนตอเนองจำกขนตอนท 01 ระบบจะเขยน log ผลกำรด ำเนนกำรตอจำกขนตอนทผำนมำ

4.12 รปแบบค าสงการท างานสงขอมล (API ของ Software Component) แบงเปน 2 รปแบบ ดงน 1) รปแบบค าสงตาม Version 1.0 – 1.1 (รปแบบเดม) Library: RDForm.jar JAVA Version: 1.7 (jdk1.7.0_17) Database: log.db (SQLite) รปแบบการใชงาน: ท ำกำรสง Parameter เขำไปใชงำน RDForm.jar

Page 14: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 14

ขนตอน 01_SWC_Convert Syntax cd C:\rdform\swc_convert swc_convert filename.txt > [PATHFILE][LOG] Example cd C:\rdform\swc_convert swc_convert PND2_TTTTTTTTTTTTT_000000_YYYY_mm_00_00_.txt >..\log\ConvertPND2_set1.log pause Parameter filename.txt ชอไฟลตงตำมขอก ำหนดตำม Format 2.0 ขนตอน 02_SWC_Upload Syntax java -cp "C:\rdform\RDForm.jar" th.go.rd.wht.rdform.test.TestRunPND1 [PNDTYPE][NID][NO_OF_SEND][FORMAT][PATHFILE][LOG] Example java -cp "C:\rdform\RDForm.jar" th.go.rd.wht.rdform.test.TestRunPND1 PND1 0105510003129 1 csv C:/rdform/csv/PND1/ >log\TestRunPND1.log Parameter TAX_TYPE:แบบภำษ เชน PND1(ภงด.1) NID:0105510003129 (เลขผเสยภำษ 13 หลก) NO_OF_SEND: 1 (ครงทยน) FORMAT: csv (รปแบบกำรยนไฟล แบบ CSV) PATHFILE:C:/rdform/csv/PND1/ (ต ำแหนง PATH ของไฟลทจะประมวลผล) LOG:>log\Efiling_PND1.log (ต ำแหนงของ log file ของกำรประมวลผล) ขนตอน 03_SWC_getTaxForm พมพแบบยนรายการพรอมเลขทฝากไฟล Syntax java -cp "C:\CPF_Payroll\RDForm.jar" th.go.rd.wht.rdform.report.test.TestPND1Report [PNDTYPE][NID][NO_OF_SEND][FORMAT][LOG] Ex. java -cp "C:\CPF_Payroll\RDForm.jar" th.go.rd.wht.rdform.report.test.TestPND1Report PND1 0105510003129 1 csv >log\TestPND1Report.log Parameter PNDTYPE:แบบภำษ เชน PND1(ภงด.1) NID:0105510003129 (เลขผเสยภำษ 13 หลก) NO_OF_SEND: 1 (ครงทยน) FORMAT: csv (รปแบบกำรยนไฟล แบบ CSV) LOG:>log\Efiling_PND1.log (ต ำแหนงของ log file ของกำรประมวลผล)

Page 15: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 15

2) รปค าสงแบบสน ตาม Version 1.2

a. 01_SWC_Covert.bat ตรวจสอบรปแบบขอมลใหเปนไปตำมขอก ำหนด Format 2.0 และ ตรวจสอบใบ Certificate เพอยนยนตวตน รปแบบค ำสง cd C:\rdform\swc_convert swc_convert filename.txt pause

b. 02_SWC_Upload.bat ท ำกำรเขำรหสขอมลและน ำสงขอมล รปแบบค ำสง cd C:\rdform java -cp "C:\rdform\RDForm.jar" th.go.rd.wht.rdform.Process.ProcessRunCenter filename.txt pause

c. 03_SWC_getTaxForm.bat รองขอเลขทอำงองกำรฝำกไฟลจำกระบบงำนและสรำงแบบยนรำยกำรภำษเงนไดหก ณ ทจำยในรปแบบ pdf ไฟล รปแบบค ำสง cd C:\rdform java -cp "RDForm.jar" th.go.rd.wht.rdform.report.Process.ProcessReportCenter filename.txt N pause

d. 04_SWC_offLineMode.bat สรำงแบบยนรำยกำรภำษเงนไดหก ณ ทจำยพรอมแผนสอใบแนบรำยกำร รปแบบค ำสง

cd C:\rdform java -cp "RDForm.jar" th.go.rd.wht.rdform.CreateSVS.ProcessCreateSVSCenter filename.txt N pause หมายเหต รปแบบค าสงการน าขอมลยนทางอนเทอรเนต (e-filing) (กรณเลอกน ำขอมลไปยนอนเทอรเนต) Syntax java -cp "C:\rdform\RDForm.jar" th.go.rd.wht.rdform.efiling.test.Efiling_PND1 [PNDTYPE][NID][NO_OF_SEND][FORMAT][PATHFILE][LOG] Ex. java -cp "C:\rdform\RDForm.jar" th.go.rd.wht.rdform.efiling.test.Efiling_PND1 PND1 0105510003129 1 csv C:/rdform/csv/PND1/ >log\Efiling_PND1.log Parameter PNDTYPE:แบบภำษ เชน PND1(ภงด.1)

Page 16: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 16

NID:0105510003129 (เลขผเสยภำษ 13 หลก) NO_OF_SEND: 1 (ครงทยน) FORMAT: csv (รปแบบกำรยนไฟล แบบ CSV) PATHFILE:C:/rdform/csv/PND1/ (ต ำแหนง PATH ของไฟลทจะประมวลผล) LOG:>log\Efiling_PND1.log (ต ำแหนงของ log file ของกำรประมวลผล) ตดตอสอบถาม กองเทคโนโลยสำรสนเทศ กรมสรรพำกร โทร 0-2272-8861-2 อเมล [email protected]

Page 17: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 17

ภาคผนวก ก. การลงทะเบยนเรมใชงาน https://whtsvs.rd.go.th/WHTSVS/

ตรวจสอบสถานะการลงทะเบยน / แกไขขอมลการลงทะเบยน

1.ระบ ภ.อ.01 หรอ ส.ส.01

2.รายละเอยดหนวยงาน

3.ก าหนดผ ตดตอ (Admin)

4.ก าหนดรหสเปดไฟล (passphrase)

Page 18: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 18

หมำยเหต 1. พมพเอกสำรกำรลงทะเบยน 2. แกไขกำรลงทะเบยน เนองจำกมขอผดพลำดในกำรกรอกรำยกำร สำมำรถแกไขได ในกรณยงไมไดผำน

ขนตอนกำรพจำรณำเอกสำรประกอบกำรลงทะเบยน หรอหลงจำกทไดรบกำรตอบรบกำรลงทะเบยนเรยบรอยแลว

3. ยกเลกกำรลงทะเบยน

Page 19: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 19

ภาคผนวก ข. ตวอยำงแบบยนรำยกำรภำษเงนไดหก ณ ทจำย (ฝำกไฟล) ยนดวยสอบนทกในระบบคอมพวเตอร

1.เลขอางองการลงทะเบยน 2.เลขอางองการฝาก

ไฟล (กรณแนบสอฯจะไมระบ)

Page 20: คู่มือการติดตั้งใช้งาน ...interapp4.rd.go.th/WHT/resources/files/Manual_SWCv1_4_1.pdfกองเทคโนโลย สารสนเทศ

กองเทคโนโลยสารสนเทศ กรมสรรพากร SWC version 1.4.2 03/02/63 หนาท 20

ภาคผนวก ค.

ประกำศอธบดกรมสรรพำกร

1. ค ำชแจงกรมสรรพำกร เรอง กำรยนแบบแสดงรำยกำรเกยวกบภำษเงนไดบคคลธรรมดำหก ณ ทจำย

ภ.ง.ด.๒ และ ภ.ง.ด.๒ก และกำรยนแบบยนรำยกำรภำษเงนไดหก ณ ทจำยอน http://www.rd.go.th/fileadmin/user_upload/kormor/newlaw/58r17.pdf

2. ประกำศอธบดกรมสรรพำกร เกยวกบภำษเงนได (ฉบบท ๒๕๕) เรอง ก ำหนดแบบแสดงรำยกำรเกยวกบภำษเงนไดบคคลธรรมดำหก ณ ทจำย http://www.rd.go.th/fileadmin/user_upload/kormor/newlaw/58dg255.pdf

3. ประกำศอธบดกรมสรรพำกร เกยวกบภำษเงนได (ฉบบท ๒๕๖) เรอง ก ำหนดแบบแสดงรำยกำรเกยวกบภำษเงนไดของบรษทหรอหำงหนสวนนตบคคล http://www.rd.go.th/fileadmin/user_upload/kormor/newlaw/58dg256.pdf

4. ประกำศอธบดกรมสรรพำกร เกยวกบภำษเงนได (ฉบบท ๒๖๐) เรอง ก ำหนดแบบแสดงรำยกำรเกยวกบภำษเงนไดบคคลธรรมดำหก ณ ทจำย http://www.rd.go.th/fileadmin/user_upload/kormor/newlaw/dg260.pdf