[ADMIN] คู่มือการเชื่อมต่อระบบบริหารทรัพย์สิน Asset Management System

[ADMIN] คู่มือการเชื่อมต่อระบบบริหารทรัพย์สิน Asset Management System

1.       ระบบบริหารทรัพย์สิน (Asset Management) และ ระบบ Oracle ERP

1.1.               ระบบบริหารทรัพย์สิน (Asset Management) การออกแบบโครงสร้างการเชื่อมต่อข้อมูลกับระบบ (Architecture Diagram)

A diagram of a diagram

AI-generated content may be incorrect.

รูปที่ 12 ระบบบริหารทรัพย์สิน (Asset Management) การออกแบบโครงสร้างการเชื่อมต่อข้อมูลกับระบบ (Architecture Diagram)

 

 


ตาราง 8 อธิบายการทำงานระบบบริหารทรัพย์สิน

ลำดับ

คำอธิบาย

1

ออกใบแจ้งหนี้/พิมพ์ใบชำระเงิน

2

ตรวจสอบข้อมูล Customer ว่ามีอยู่ในระบบแล้วหรือไม่

3

สร้าง Customer ในกรณีที่เป็น Customer รายใหม่

4A

ใบแจ้งหนี้/ข้อมูลใบแจ้งหนี้ระบบ

Ref1 คือ Project ID

Ref2 คือ Biller ID

4B

Interface ข้อมูลใบแจ้งหนี้ Real time

5

เรียกเก็บเงินที่ครบกำหนด (Call for due)

6

ขอรายการจ่ายจากธนาคารแบบ Real time

7

ตรวจเช็ครายการโอนเงินกับใบแจ้งหนี้

AR = ใช่

8

แจ้งเตือนจากPayment Hub

10

แสกนจ่านเงินผ่าน OR code หรือ ช่องทางออนไลน์

11

ส่งผ่านข้อมูลการจ่ายเงิน

12

ส่งข้อมูลการชำระเงินไปยัง Oracle AR, real time และทำการส่งต่อไปยัง Webservice ข้อมูลลูกค้าและใบแจ้งหนี้ AR และใบเสร็จสามารถดำเนินการโดยอัตโนมัติหลังผ่านกระบวนการประมวลผลรายวันแบบกลุ่ม

13

ส่งข้อมูลใบเสร็จ Realtime ไปบันทึกบน Webservice


1.1.1.                      API สำหรับการสร้างข้อมูลลูกค้า (Customer Creation)

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_09_AMS_CUST_APP/1.0/CreateCustomer

Headers

Content-Type

application/json

Authorization

Bearer <access_token>

Request Body

{

    "CustomerDetails": [

        {

            "Customer": {

                "CustomerSourceSystem": "AMS",

                "CustomerName": "นางจรัลรัตน์ คณายงพิบูลย์",

                "CustomerSourceReference": "779",

                "CustomerTaxRegistrationNumber": "3331000425535",

                "CustomerType": "Internal"

            },

            "Address": {

                "AddressLine1": "203 หมู่ 2 ",

                "AddressLine2": "สำโรง อุทุมพรพิสัย ศรีสะเกษ Thailand",

                "AddressLine3": "",

                "AddressLine4": "",

                "City": "อุทุมพรพิสัย",

                "State": "ศรีสะเกษ",

                "Country": "Thailand",

                "PostalCode": "33120"

            },

            "Contact": {

                "ContactName": "นางจรัลรัตน์ คณายงพิบูลย์",

                "MobileNumber": "",

                "LandLineNumber": "083-1290954",

                "EmailAddress": ""

            }

        }

    ]

}

Response

{

    "result": [

        {

            "CustomerName": "นางจรัลรัตน์ คณายงพิบูลย์",

            "CustomerSourceReference": "779",

            "OracleFusionCustomerNumber": "AMS_779",

            "StatusCode": "SUCCESS",

            "StatusMessage": "Customer interfaced successfully in oracle fusion"

        }

    ]

}

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

เข้าสู่ระบบ ERPàReceivablesàBillingàTasksàManage CustomersàSearch

A screenshot of a computer

Description automatically generated

รูปที่ 13 แสดง customer ที่ถูกสร้างด้วย API จากระบบ Asset Management

 

 

 


1.1.1.2.                 คำอธิบายชุดข้อมูลลูกค้าในระบบ

ลำดับ

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

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

Value

1

CustomerSourceSystem

ระบบต้นทางของลูกค้า

AMS

2

CustomerName

ชื่อลูกค้า

นางจรัลรัตน์ คณายงพิบูลย์

3

CustomerSourceReference

หมายเลขอ้างอิงลูกค้าในระบบต้นทาง

779

4

CustomerTaxRegistrationNumber

หมายเลขประจำตัวผู้เสียภาษีของลูกค้า

3.331E+12

5

CustomerType

ประเภทของลูกค้า

Internal

6

AddressLine1

ที่อยู่บรรทัดที่ 1

203 หมู่ 2

7

AddressLine2

ที่อยู่บรรทัดที่ 2 (ถ้ามี)

สำโรง อุทุมพรพิสัย ศรีสะเกษ Thailand

8

AddressLine3

ที่อยู่บรรทัดที่ 3 (ถ้ามี)

 

9

AddressLine4

ที่อยู่บรรทัดที่ 4 (ถ้ามี)

 

10

City

ชื่ออำเภอ

อุทุมพรพิสัย

11

State

ชื่อจังหวัด

ศรีสะเกษ

12

Country

ประเทศ

Thailand

13

PostalCode

รหัสไปรษณีย์

33120

14

ContactName

ชื่อผู้ติดต่อ

นางจรัลรัตน์ คณายงพิบูลย์

15

MobileNumber

หมายเลขโทรศัพท์มือถือ

 

16

LandLineNumber

หมายเลขโทรศัพท์บ้านหรือสำนักงาน

083-1290954

17

EmailAddress

อีเมลของผู้ติดต่อ

 

 


1.1.2.                      API สร้างข้อมูลใบแจ้งหนี้

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_07_AMS_ERP_AR_INV/1.0/CreateInvoice

Headers

Content-Type

application/json

Authorization

Bearer <access_token>

Request Body

{

    "InvoiceData": [

        {

            "Header": {

                "SourceInvoiceNumber": "CN2567-09-0114-6710",

                "BusinessUnit": "01",

                "TransactionClass": "Invoice",

                "CustomerName": "นางสาวรัชฎาพร นะที",

                "InvoiceAmount": "13200",

                "InvoiceDate": "2024-09-28",

                "PaymentTerms": "IMMEDIATE",

                "CustomerSourceReference": 867,

                "CustomerSourceSystem": "AMS",

                "Place": "TH",

                "No": "11 : โรงจอดรถซัตเติลบัสเก่า : โรงอาหารชั่วคราว (โรงจอดรถ Shuttle Bus เดิม)",

                "AgreementNo": "CN2567-09-0114",

                "AgeOfAgreement": " 5 Month 28 Day",

                "DateOfAgreement": "2024-10-01",

                "DueDate": "2024-10-04"

            },

            "Lines": [

                {

                    "LineNum": "1",

                    "LineDescription": "ค่าบำรุงสถานที่",

                    "LineAmount": "3300",

                    "LineType": "ค่าบำรุงสถานที่ อัตราผันแปร"

                },

                {

                    "LineNum": "2",

                    "LineDescription": "ค่าทำความสะอาด",

                    "LineAmount": "0",

                    "LineType": "ค่าทำความสะอาด"

                },

                {

                    "LineNum": "3",

                    "LineDescription": "ค่าธรรมเนียมการใช้พื้นที่(ป้าย)",

                    "LineAmount": "0",

                    "LineType": "ค่าธรรมเนียมการใช้พื้นที่"

                },

                {

                    "LineNum": "4",

                    "LineDescription": "เงินสนับสนุนกิจการ มข. รายเดือน",

                    "LineAmount": "0",

                    "LineType": "ค่าธรรมเนียมการใช้พื้นที่"

                },

                {

                    "LineNum": "5",

                    "LineDescription": "หนี้ค้างชำระเดิม",

                    "LineAmount": "0",

                    "LineType": "ค่าธรรมเนียมการใช้พื้นที่"

                },

                {

                    "LineNum": "6",

                    "LineDescription": "อื่นๆ ประกันความเสียหาย",

                    "LineAmount": "9900",

                    "LineType": "ค่าธรรมเนียมการใช้พื้นที่"

                }

            ]

        }

    ]

}

Response

{

    "result": [

        {

            "SourceInvoiceNumber": " CN2567-09-0114-6710",

            "OracleFusionInvoiceNumber": " 22009",

            "StatusCode": "SUCCESS",

            "StatusMessage": "Invoice created successfully in oracle fusion"

        }

    ]

}

 

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

เข้าสู่ระบบ ERPàReceivablesàBillingàTasksàManage TransactionsàSearch

A screenshot of a computer

Description automatically generated

รูปที่ 14 แสดง AR Invoice ที่ถูกสร้างขึ้นผ่าน API จากระบบ Asset Management


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

ลำดับ

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

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

Value

1

SourceInvoiceNumber

หมายเลขใบแจ้งหนี้ต้นทาง

CN2567-09-0114-6710

2

BusinessUnit

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

1

3

TransactionClass

ประเภทของธุรกรรม

Invoice

4

CustomerName

ชื่อลูกค้า

นางสาวรัชฎาพร นะที

5

InvoiceAmount

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

13200

6

InvoiceDate

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

28/9/2024

7

PaymentTerms

เงื่อนไขการชำระเงิน

IMMEDIATE

8

CustomerSourceReference

หมายเลขอ้างอิงลูกค้าในระบบต้นทาง

867

9

CustomerSourceSystem

ระบบต้นทางของลูกค้า

AMS

10

Place

สถานที่

TH

11

No

รายละเอียดหมายเลขสถานที่

11 : โรงจอดรถซัตเติลบัสเก่า : โรงอาหารชั่วคราว (โรงจอดรถ Shuttle Bus เดิม)

12

AgreementNo

หมายเลขข้อตกลงที่เกี่ยวข้องกับใบแจ้งหนี้

CN2567-09-0114

13

AgeOfAgreement

อายุของข้อตกลง

5 Month 28 Day

14

DateOfAgreement

วันที่ข้อตกลงเริ่มต้น รูปแบบ YYYY-MM-DD

1/10/2024

15

DueDate

วันครบกำหนดชำระเงิน รูปแบบ YYYY-MM-DD

4/10/2024

16

LineNum

หมายเลขลำดับของรายการบริการ

1

17

LineDescription

คำอธิบายของรายการบริการ

ค่าบำรุงสถานที่

18

LineAmount

จำนวนเงินของรายการบริการ

3300

19

LineType

ประเภทของรายการ เช่น ค่าบำรุงสถานที่, ค่าทำความสะอาด

ค่าบำรุงสถานที่ อัตราผันแปร


1.1.3.                      API สร้างข้อมูลใบเสร็จ

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_08_AMS_AR_RECEIPT/1.0/CreateReceipt

Headers

Content-Type

application/json

Authorization

Bearer <access_token>

Request Body

{

    "ReceiptData": [

        {

            "ReceiptAmount": "5600",

            "BusinessUnit": "01",

            "CustomerName": "นายกรกฎ ทัณฑะรักษ์",

            "InvoiceNumber": "CN2567-10-0184-6801",

            "CustomerSourceReference": "1",

            "RemittanceBankAccountNumber": "7933000066",

            "CustomerSourceSystem": "AMS",

            "ReceiptNumber": "AMS_100007"

        }

    ]

}

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

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

A screenshot of a computer

Description automatically generated

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


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

ลำดับ

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

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

Value

1

ReceiptAmount

จำนวนเงินของใบเสร็จรับเงิน

13200

2

BusinessUnit

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

01

3

CustomerName

ชื่อลูกค้าที่เกี่ยวข้องกับใบเสร็จรับเงิน

นางสาวรัชฎาพร นะที

4

InvoiceNumber

หมายเลขใบแจ้งหนี้ที่เกี่ยวข้อง

AMS_22009

5

CustomerSourceReference

หมายเลขอ้างอิงลูกค้าในระบบต้นทาง

867

6

RemittanceBankAccountNumber

หมายเลขบัญชีธนาคารที่ใช้ในการชำระเงิน

7933000066

7

CustomerSourceSystem

ระบบต้นทางของลูกค้า

AMS

8

ReceiptNumber

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

R123