[ADMIN] คู่มือการเชื่อมต่อระบบเงินเดือนและค่าตอบแทน Payroll

[ADMIN] คู่มือการเชื่อมต่อระบบเงินเดือนและค่าตอบแทน Payroll

1.       ระบบเงินเดือนและค่าตอบแทน (Payroll) และ ระบบ Oracle ERP

1.1.               ระบบเงินเดือนและค่าตอบแทน (Payroll): การออกแบบโครงสร้างการเชื่อมต่อข้อมูลกับระบบ (Architecture Diagram)

A diagram of a payroll

Description automatically generated

รูปที่ 5 ระบบเงินเดือนและค่าตอบแทน (Payroll): การออกแบบโครงสร้างการเชื่อมต่อข้อมูลกับระบบ (Architecture Diagram)


ตาราง 5 อธิบายการทำงานระบบเงินเดือนและค่าตอบแทน (Payroll)

ลำดับ

คำอธิบาย

INTG_FIN_AP_01

การเบิกเงินล่วงหน้าของพนักงาน (Employee Advance) จะถูกจัดทำผ่านใบแจ้งหนี้ล่วงหน้าของบัญชีเจ้าหนี้ (AP Prepaid Invoice) และจะถูกส่งข้อมูลไปยังระบบ Payroll เพื่อการคำนวณเงินเดือนและค่าตอบแทนขั้นสุดท้าย (final Salary and compensation Calculation)

INTG_FIN_AP_02

เมื่อใบแจ้งหนี้ (AP invoice) สำหรับค่าตอบแทนเงินเดือน (Payroll) ได้รับการตรวจสอบงบประมาณ (budget checked) และอนุมัติแล้ว ใบแจ้งหนี้ที่ได้รับการอนุมัติจะถูกส่งข้อมูลไปยังระบบ Payroll เพื่อปรับปรุงสถานะว่าได้รับการอนุมัติการชำระเงินจากผู้มีอำนาจ (payment approved by authority)

INTG_FIN_AP_05

จำนวนเงินเดือน (Payroll compensation) จะถูกคำนวณโดยระบบ Payroll และจะมีการส่งข้อมูลไปยังโมดูลบัญชีเจ้าหนี้ (Accounts Payable) ของ Oracle โดยการสร้างใบแจ้งหนี้ (Payable Invoice) จากนั้นใบแจ้งหนี้จะถูกประมวลผลต่อไปเพื่อทำการตรวจสอบงบประมาณ (budget check) และการอนุมัติ (approval) ตามระบบ

INTG_FIN_AP_06

เมื่อมีการชำระเงินสำหรับค่าตอบแทนเงินเดือน (Payroll) แล้ว รายละเอียดการชำระเงินจะต้องมีการส่งข้อมูลและบันทึกในระบบบัญชีเจ้าหนี้ (AP) เพื่อการกระทบยอดธนาคาร (bank reconciliation) และการชำระเงินคืนของใบแจ้งหนี้ (payment neutralization of invoices) ต่อไป


1.1.1.                      API สำหรับการสร้างใบแจ้งหนี้บัญชีเจ้าหนี้ (AP Invoice)

HTTP Method

POST

Endpoint

https://dev-oic-axacomqa0kjr-si.integration.ap-singapore-1.ocp.oraclecloud.com/ic/api/integration/v1/flows/rest/
KKU_INT_FIN_AP_05_PR_AP_INV_APP/1.0/apinvoiceCreate

Headers

Content-Type

application/json

Authorization

Bearer <access_token>

Request Body

{

    "InvoiceData": [

        {

            "TermsDate": "2024-06-20",

            "Description": "Payroll description",

            "invoiceLines": [

                {

                    "DistributionCombination": "1-01-00000-2110010100-00-0000-0000-000000-000000-0-0000",

                    "Description": "Line Description1",

                    "LineAmount": 200,

                    "LineNumber": 1

                },

                {

                    "DistributionCombination": "1-01-00000-2110010100-00-0000-0000-000000-000000-0-0000",

                    "Description": "Line Description2",

                    "LineAmount": 200,

                    "LineNumber": 1

                }

            ],

            "PayGroup": "PayGroup",

            "BusinessUnit": "32001",

            "SupplierSite": "KKU",

            "Supplier": "นางสาวเรนิสา ไชยส่งเสริม",

            "InvoiceNumber": "TEST_SP_INV_01",

            "InvoiceAmount": 200,

            "InvoiceDate": "2024-06-20",

            "InvoiceType": "Standard"

        }

    ]

}


1.1.1.1.                 คำอธิบายชุดข้อมูลใบแจ้งหนี้บัญชีเจ้าหนี้ในระบบ

ลำดับ

ชื่อรายการภาษาอังกฤษ

ชื่อรายการภาษาไทย

Value

1

TermsDate

วันที่เริ่มต้นเงื่อนไขของใบแจ้งหนี้ รูปแบบวันที่: YYYY-MM-DD

2024-06-20

2

Description

คำอธิบายสั้น ๆ เกี่ยวกับใบแจ้งหนี้

Payroll description

3

invoiceLines

รายละเอียดของรายการในใบแจ้งหนี้

 

4

DistributionCombination

รหัสการแจกแจงบัญชี (Account Combination) ของแต่ละรายการ

1-01-00000-2110010100-00-0000-0000-000000-000000-0-0000

5

Description (Line)

คำอธิบายสั้น ๆ เกี่ยวกับรายการในใบแจ้งหนี้

Line Description1

6

LineAmount

จำนวนเงินของแต่ละรายการในใบแจ้งหนี้

200

7

LineNumber

หมายเลขลำดับของแต่ละรายการในใบแจ้งหนี้

1

8

PayGroup

กลุ่มการจ่ายเงินที่เชื่อมโยงกับใบแจ้งหนี้

PayGroup

9

BusinessUnit

หน่วยธุรกิจที่รับผิดชอบใบแจ้งหนี้

32001

10

SupplierSite

สถานที่ตั้งในใบแจ้งหนี้

KKU

11

Supplier

ชื่เจ้าหนี้ที่เกี่ยวข้องกับใบแจ้งหนี้

นางสาวเรนิสา ไชยส่งเสริม

12

InvoiceNumber

หมายเลขใบแจ้งหนี้ที่ไม่ซ้ำกัน ใช้สำหรับการอ้างอิงเฉพาะใบแจ้งหนี้แต่ละฉบับ

TEST_SP_INV_01

13

InvoiceAmount

ยอดเงินรวมทั้งหมดของใบแจ้งหนี้

200

14

InvoiceDate

วันที่ของใบแจ้งหนี้ รูปแบบวันที่: YYYY-MM-DD

2024-06-20

15

InvoiceType

ประเภทของใบแจ้งหนี้ เช่น Standard หรือประเภทอื่น ๆ ที่กำหนดโดยระบบ

Standard


1.1.2.                      API สำหรับการสร้างใบชำระเงินบัญชีเจ้าหนี้ (AP Payment)

HTTP Method

POST

Endpoint

https://dev-oic-axacomqa0kjr-si.integration.ap-singapore-1.ocp.oraclecloud.com/ic/api/integration/v1/flows/rest/KKU_INT_FIN_AP_06_PR_AP_PAYMENT/1.0/CreatePayment

Headers

Content-Type

application/json

Authorization

Bearer <access_token>

Request Body

{

  "PaymentData": [

    {

      "SourceBusinessUnit": "32001",

      "SourcePaymentNumber": "501",

      "PaymentDate": "2024-06-22",

      "PayGroup": "BofA-2869",

      "SupplierSite": "KKU",

      "Supplier": "นางสาวเรนิสา ไชยส่งเสริม",

      "InvoiceNumber": "10001",

      "PaymentAmount": "10"

    },

    {

      "SourceBusinessUnit": "32001",

      "SourcePaymentNumber": "501",

      "PaymentDate": "2024-06-22",

      "PayGroup": "BofA-2869",

      "SupplierSite": "KKU",

      "Supplier": "นางสาวเรนิสา ไชยส่งเสริม",

      "InvoiceNumber": "10001",

      "PaymentAmount": "10"

    }

  ]

}


1.1.2.1.                 คำอธิบายชุดข้อมูลข้อมูลใบจ่ายเงินบัญชีเจ้าหนี้ในระบบ

ลำดับ

ชื่อรายการภาษาอังกฤษ

ชื่อรายการภาษาไทย

Value

1

SourceBusinessUnit

หน่วยธุรกิจที่เป็นแหล่งที่มาของการชำระเงิน

32001

2

SourcePaymentNumber

หมายเลขการชำระเงินที่ไม่ซ้ำกัน

501

3

PaymentDate

วันที่ทำการชำระเงิน รูปแบบวันที่: YYYY-MM-DD

2024-06-22

4

PayGroup

กลุ่มการจ่ายเงินที่เชื่อมโยงกับการชำระเงิน

BofA-2869

5

SupplierSite

สถานที่ตั้งของเจ้าหนี้ที่เกี่ยวข้องกับการชำระเงิน

KKU

6

Supplier

ชื่อเจ้าหนี้ที่เกี่ยวข้องกับการชำระเงิน

นางสาวเรนิสา ไชยส่งเสริม

7

InvoiceNumber

หมายเลขใบแจ้งหนี้ที่เกี่ยวข้องกับการชำระเงิน

10001

8

PaymentAmount

จำนวนเงินที่ชำระสำหรับใบแจ้งหนี้

10

 


1.1.3.                      API สำหรับการสร้างใบเสร็จเบ็ดเตล็ด (Miscellaneous Receipt)

HTTP Method

POST

Endpoint

https://dev-oic-axacomqa0kjr-si.integration.ap-singapore-1.ocp.oraclecloud.com/ic/api/integration/v1/flows/rest/KKU_INT_FIN_AR_18_AR_MISCREC_APP/1.0/CreateMiscReceipt

Headers

Content-Type

application/json

Authorization

Bearer <access_token>

Request Body

{

  "ReceiptData": [

    {

      "Description": "KKBU22-FCLT10-Faculty of Medicine",

      "BusinessUnit": "32001",

      "Amount": "1000",

      "IssuedBy": "Waken",

      "PaymentNumber": "001",

      "ReceiptDate": "2024-06-25",

      "ReceiptNumber": "R123"

    },

    {

      "Description": "KKBU22-FCLT10-Faculty of Medicine",

      "BusinessUnit": "32001",

      "Amount": "1000",

      "IssuedBy": "Waken",

      "PaymentNumber": "001",

      "ReceiptDate": "2024-06-25",

      "ReceiptNumber": "R124"

    }

  ]

}

 


1.1.3.1.                 คำอธิบายชุดข้อมูลข้อมูลใบเสร็จเบ็ดเตล็ดในระบบ

ลำดับ

ชื่อรายการภาษาอังกฤษ

ชื่อรายการภาษาไทย

Value

1

Description

คำอธิบายเกี่ยวกับใบเสร็จรับเงิน

KKBU22-FCLT10-Faculty of Medicine

2

BusinessUnit

หน่วยธุรกิจที่รับผิดชอบใบเสร็จรับเงิน

32001

3

Amount

จำนวนเงินที่เกี่ยวข้องกับใบเสร็จรับเงิน

1000

4

IssuedBy

ชื่อผู้ที่ออกใบเสร็จรับเงิน

Waken

5

PaymentNumber

หมายเลขการชำระเงินที่เกี่ยวข้องกับใบเสร็จรับเงิน

001

6

ReceiptDate

วันที่ของใบเสร็จรับเงิน รูปแบบวันที่: YYYY-MM-DD

2024-06-25

7

ReceiptNumber

หมายเลขใบเสร็จรับเงินที่ไม่ซ้ำกัน

R123