การเชื่อมต่อข้อมูลการซื้อและใบเสร็จ

ใบเสร็จ การซื้อ การเชื่อมต่อข้อมูล API
บทความนี้เหมาะสำหรับใคร
สำหรับนักพัฒนาที่ต้องการเชื่อมต่อข้อมูลการซื้อและใบเสร็จ ซึ่งเป็นข้อมูลแกนหลักของ ReceiptRoller

ข้อมูลที่เป็นแกนกลางที่สุดของ ReceiptRoller คือใบเสร็จ (receipt) การชำระเงินหนึ่งครั้งจะสอดคล้องกับใบเสร็จหนึ่งใบ และมีรายการ (item)หลายรายการอยู่ในนั้น ใบเสร็จออกจาก POS หรือระบบชำระเงินของท่านเอง และสามารถเข้าถึงได้ทั้งจากสโคปฝั่งร้านค้าและฝั่ง User

ข้อกำหนดอย่างเป็นทางการของโมเดลภายในอยู่ในบทความแยก
บทความนี้กล่าวถึงแนวคิดและรูปแบบการเชื่อมต่อ สำหรับนิยามฟิลด์ของโมเดล C# ของข้อมูลธุรกรรมที่ดึงมาจาก POS จริง (PosTransactionDto) กรุณาดูที่ PosTransactionDto รีเฟอเรนซ์
โมเดลธุรกรรมได้รับการขยาย
เพื่อไม่ให้ข้อมูลที่ POS ต้นทางส่งมาตกหล่น เราได้ขยายโมเดลธุรกรรม สำหรับธุรกรรม 1 รายการ ท่านสามารถดึงข้อมูลรายการ (ชื่อสินค้า・จำนวน・ราคาต่อหน่วย・ภาษี/ส่วนลดในระดับรายการ・รหัสแคตตาล็อก), รายละเอียดการชำระเงินของเทนเดอร์แบบแยก (เช่น เงินสด+บัตร โดยมีจำนวนเงิน・แบรนด์บัตร/เลข 4 หลักท้ายของแต่ละเทนเดอร์), รายละเอียดการคืนเงิน, สกุลเงิน, URL ใบเสร็จ, รหัสเชื่อมต่อภายนอก ฯลฯ สำหรับรายละเอียดฟิลด์กรุณาดูที่ PosTransactionDto รีเฟอเรนซ์

ฟิลด์หลัก

ฟิลด์ เนื้อหา
idรหัสใบเสร็จ (rcp_)
store_idร้านที่ออกใบเสร็จ
issued_atเวลาที่ออก
total_amountยอดรวม (หน่วยสกุลเงินที่เล็กที่สุด)
tax_amountจำนวนภาษีมูลค่าเพิ่ม
currencyรหัสสกุลเงิน
payment_methodวิธีการชำระเงิน (cash / credit_card / qr / etc) เมื่อชำระแบบแยก จะเก็บรายละเอียดของแต่ละเทนเดอร์ไว้ด้วย
statusissued / voided / refunded
customer_idลูกค้าที่ผูกไว้ (ไม่บังคับ)
items[]อาร์เรย์ของรายการ (นอกจากชื่อสินค้า・จำนวน・ราคาต่อหน่วย ยังรวมภาษีและส่วนลดในระดับรายการด้วย)

สโคปที่เกี่ยวข้อง

  • receipt.read — อ่านใบเสร็จของร้าน
  • receipt.write — ออกใบเสร็จใหม่・ยกเลิก
  • user.receipts.read — ใบเสร็จของผู้บริโภ…
วันที่เผยแพร่: 2569-04-27 วันที่อัปเดต: 2569-07-06