[ADMIN] คู่มือการเชื่อมต่อระบบ Payment Hub

[ADMIN] คู่มือการเชื่อมต่อระบบ Payment Hub

1.       ระบบการรับเงินด้วยระบบอิเล็กทรอนิกส์ (Payment Hub) และ ระบบ Oracle ERP

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

1.1.1.                      การออกแบบโครงสร้างการเชื่อมต่อข้อมูลกับระบบ: ใบเสร็จมาตรฐาน (Standard Receipt)

 

รูปที่ 1 ระบบการรับเงินด้วยระบบอิเล็กทรอนิกส์ (Payment Hub): การออกแบบโครงสร้างการเชื่อมต่อข้อมูลกับระบบ (Architecture Diagram) ในการตรวจสอบการชำระเงินและสร้างใบเสร็จมาตรฐาน

ตาราง 1 อธิบายการทำงานระบบการรับเงินด้วยระบบอิเล็กทรอนิกส์ (Payment Hub)

ลำดับ

คำอธิบาย

1

Source System เรียก REST API พร้อมกับข้อมูลที่จำเป็น เช่น ข้อมูลใบแจ้งหนี้ ลูกค้า จำนวนเงิน วันที่ และอื่นๆ

2

ระบบ ERP ตรวจสอบสถานะการชำระเงินกับระบบ Payment Hub ว่าชำระแล้วหรือไม่

3

หากสถานะเป็น "ชำระแล้ว" จึงค่อยสร้างใบเสร็จรับเงินใน Oracle Fusion

4

สร้างใบเสร็จรับเงินมาตรฐานในระบบ Oracle และนำไปใช้กับใบแจ้งหนี้ในระบบลูกหนี้ (Accounts Receivable หรือ AR)

5

ระบบ ERP เรียกใช้ API สำหรับการลงนามดิจิทัลใน PDF โดยใช้ไฟล์ PDF ใบเสร็จรับเงินแบบมาตรฐาน

6

ระบบลงนามดิจิทัลจะตอบกลับชื่อไฟล์ของ PDF ที่ลงนามดิจิทัลแล้ว

7

ระบบลงนามดิจิทัลทำการลงนามดิจิทัลและจะตอบกลับชื่อไฟล์ของ PDF ให้ระบบ ERP

8

ระบบ ERP จะตอบกลับหมายเลขใบเสร็จรับเงิน, รหัสใบเสร็จรับเงิน และชื่อไฟล์ของใบเสร็จรับเงินที่ลงนามดิจิทัลแล้วไปยัง Source System

9

Source System นำชื่อไฟล์ของใบเสร็จรับเงินที่ลงนามดิจิทัลแล้วไปดาวน์โหลดใบเสร็จรับเงินแบบมาตรฐาน

 

1.1.2.                      การออกแบบโครงสร้างการเชื่อมต่อข้อมูลกับระบบ: ใบเสร็จเบ็ดเตล็ด (Miscellaneous Receipt)

รูปที่ 2 ระบบการรับเงินด้วยระบบอิเล็กทรอนิกส์ (Payment Hub): การออกแบบโครงสร้างการเชื่อมต่อข้อมูลกับระบบ (Architecture Diagram) ในการตรวจสอบการชำระเงินและสร้างใบเสร็จเบ็ดเตล็ด

 

ตาราง 2 อธิบายการทำงานระบบการรับเงินด้วยระบบอิเล็กทรอนิกส์ (Payment Hub)

ลำดับ

คำอธิบาย

1

Source System เรียก REST API พร้อมกับข้อมูลที่จำเป็น เช่น ข้อมูลใบแจ้งหนี้ ลูกค้า จำนวนเงิน วันที่ และอื่นๆ

2

ระบบ ERP ตรวจสอบสถานะการชำระเงินกับระบบ Payment Hub ว่าชำระแล้วหรือไม่

3

หากสถานะเป็น "ชำระแล้ว" จึงค่อยสร้างใบเสร็จรับเงินใน Oracle Fusion

4

สร้างใบเสร็จรับเงินเบ็ดเตล็ดในระบบ Oracle

5

ระบบ ERP เรียกใช้ API สำหรับการลงนามดิจิทัลใน PDF โดยใช้ไฟล์ PDF ใบเสร็จรับเงินแบบเบ็ดเตล็ด

5

ระบบลงนามดิจิทัลจะตอบกลับชื่อไฟล์ของ PDF ที่ลงนามดิจิทัลแล้ว

6

ระบบลงนามดิจิทัลทำการลงนามดิจิทัลและจะตอบกลับชื่อไฟล์ของ PDF ให้ระบบ ERP

7

ระบบ ERP จะตอบกลับหมายเลขใบเสร็จรับเงิน, รหัสใบเสร็จรับเงิน และชื่อไฟล์ของใบเสร็จรับเงินที่ลงนามดิจิทัลแล้วไปยัง Source System

8

Source System นำชื่อไฟล์ของใบเสร็จรับเงินที่ลงนามดิจิทัลแล้วไปดาวน์โหลดใบเสร็จรับเงินแบบเบ็ดเตล็ด

 

 

1.2.               ระบบการรับเงินด้วยระบบอิเล็กทรอนิกส์ (Payment Hub): API การออกใบเสร็จมาตรฐาน

1.2.1.                      API การออกใบเสร็จมาตรฐาน (Standard Receipt)

ตาราง 3 หน้าจอ Payload ยกตัวอย่างของระบบสาธารณูปโภค (Utility System)

HTTP Method

POST

Endpoint

https://sit-uat-oic797-axacomqa0kjr-si.integration.ap-singapore-1.ocp.oraclecloud.com/ic/api/integration/v1/flows/rest/
KKU_INT_FIN_AR_05_STD_RCPT_APP/1.0/CreateStandardReceipt

Headers

Content-Type

application/json

Authorization

Bearer <access_token>

Request Body

{

    "ReceiptData": [

        {

            "CustomerSourceSystem": "US",

            "CustomerSourceReference": "00003",

            "CustomerName": "US-บริษัท ทดสอบ. จำกัด",

            "RemittanceBankAccountNumber": "6609064822",

            "SourceInvoiceNumber": "KT989898",

            "ReceiptDate": "2025-01-05",

            "ReceiptAmount": "1.25",

            "ReceiptDescription": "For US-บริษัท ปตท. จำกัด (มหาชน)",

            "TransactionId": "1854042839243481088",

            "ProjectId": "HRKKUPAYMENT",

            "Ref2": "300000054647793",

            "Ref3": "54207020200"

        }

    ]

}

Response

{

    "result": [

        {

            "SourceInvoiceNumber": "KT989898",

            "OracleFusionInvoiceNumber": "300000056124305",

            "OracleFusionReceiptNumber": "US_07012025104003313",

            "OracleFusionReceiptId": "27009",

            "OracleFusionReceiptPDFInBase64": "",

            "StatusCode": "SUCCESS",

            "StatusMessage": "Receipt created successfully",

            "PDFFileName": "27009.pdf"

        }

    ]

}

1.2.1.1.                 ผู้ใช้สามารถตรวจสอบผลลัพธ์ได้โดยมีขั้นตอนดังนี้

เข้าสู่ระบบ ERPàReceivablesàAccounts ReceivableàTasksàManage ReceiptsàSearchàView Receipt

A document with a graphic design Description automatically generated with medium confidence

รูปที่ 3 แสดงตัวอย่างใบเสร็จมาตรฐานที่ถูกสร้างขึ้นในระบบ ERP ผ่าน API

1.2.2.                      API การออกใบเสร็จเบ็ดเตล็ด (Miscellaneous Receipt)

ตาราง 4 หน้าจอ Payload ยกตัวอย่างของระบบต้นทางอื่น ๆ

HTTP Method

POST

Endpoint

https://sit-uat-oic797-axacomqa0kjr-si.integration.ap-singapore-1.ocp.oraclecloud.com/ic/api/integration/v1/flows/rest/

KKU_INT_FIN_AR_05_MISC_RCPT_APP/1.0/CreateMiscReceipt

Headers

Content-Type

application/json

Authorization

Bearer <access_token>

Request Body

{

    "ReceiptData": [

        {

            "ReceiptIssuedBy": "งานเงินรายได้กองคลัง",

            "ReceiptDescription": "ค่าธรรมเนียมการสมัครงาน",

            "Ref3": "54207020200",

            "ProjectId": "HRKKUPAYMENT",

            "TransactionId": "1854042839243481088",

            "ReceiptAmount": "1",

            "CustomerPhone": "",

            "CustomerEmail": "jnatchaphon@gmail.com",

            "Ref2": "300000054647793",

            "CustomerName": "US customer 002",

            "ReceiptDate": "2025-01-06",

            "CustomerTaxId": "234124356435",

            "CustomerAddress": "200/24"

        }

    ]

}

Response

{

    "result": [

        {

            "OracleFusionReceiptNumber": "OTHER_07012025102407581",

            "OracleFusionReceiptId": "27006",

            "StatusCode": "SUCCESS",

            "StatusMessage": "Receipt created successfully in Oracle Fusion",

            "PDFFileName": "27006.pdf"

        }

    ]

}

1.2.2.1.                 ผู้ใช้สามารถตรวจสอบผลลัพธ์ได้โดยมีขั้นตอนดังนี้

เข้าสู่ระบบ ERPàReceivablesàAccounts ReceivableàTasksàManage ReceiptsàSearchàView Receipt

A document with a logo and text Description automatically generated

รูปที่ 4 แสดงตัวอย่างใบเสร็จเบ็ดเตล็ดที่ถูกสร้างขึ้นในระบบ ERP ผ่าน API