ข้อมูลด้านต่าง ๆ ที่ใช้ได้
รวบรวมภาพรวมของข้อมูลด้านต่าง ๆที่เชื่อมต่อได้จากพอร์ทัลนักพัฒนาของ ReceiptRoller ไว้ ใช้เพื่อทำความเข้าใจ「ดึงข้อมูลแบบใดได้บ้าง」ซึ่งลึกกว่า「ทำอะไรได้บ้าง」หนึ่งขั้น สำหรับ endpoint และข้อกำหนด scope ที่เป็นรูปธรรม โปรดดูคู่มือที่เกี่ยวข้องของแต่ละด้าน
ข้อมูลด้านต่าง ๆ ที่ใช้ได้
ReceiptRoller เป็นแพลตฟอร์มที่จัดการข้อมูลรีเทลที่ร้านค้า・แบรนด์ดูแลอยู่แบบข้ามด้าน จากพอร์ทัลนักพัฒนา คุณสามารถเชื่อมต่อข้อมูลด้านต่อไปนี้ผ่าน REST API・Webhook ได้ตามวัตถุประสงค์
การดึงข้อมูลของแต่ละด้านต้องมี OAuth scope ที่สอดคล้อง รายการ scope ฉบับสมบูรณ์และข้อจำกัดการดึงข้อมูลดูที่ รายการ OAuth scope และการใช้ได้/ไม่ได้
1. ข้อมูลการซื้อ・ใบเสร็จ
เป็นข้อมูลธุรกรรมที่เกิดขึ้นผ่าน POS・EC・แอปของตนเอง และข้อมูลใบเสร็จอิเล็กทรอนิกส์ที่ผูกกับธุรกรรมนั้น เป็นข้อมูลหลักที่ถูกใช้บ่อยที่สุดใน ReceiptRoller
- ข้อมูลหลักที่รวมอยู่ — ID ธุรกรรม・ID ร้านค้า・วันเวลาธุรกรรม・ยอดย่อย/ภาษี/ยอดรวม・วิธีชำระเงิน・รายการรายละเอียด (ชื่อสินค้า・จำนวน・ราคาต่อหน่วย・ประเภทภาษี)・ข้อมูลการใช้ส่วนลด・สถานะการออกใบเสร็จ (ออกแล้ว・คืนเงินแล้ว・ยกเลิก)
- วิธีดึง — API (ดูประวัติธุรกรรม, ดึงธุรกรรมเฉพาะ)/Webhook (แจ้งเตือนแบบเรียลไทม์ของอีเวนต์ออก・อัปเดต)
- scope ที่จำเป็น — จากฝั่งร้านค้าใช้
store.orders.*, จากฝั่งผู้ใช้ใช้user.receipts.read(ต้องตรวจสอบ) - use case หลัก — เชื่อมต่อใบเสร็จไปยังเซิร์ฟเวอร์ของตนเอง, ดูใบเสร็จในแอป wallet, ดึงเข้าอัตโนมัติในแอปบัญชีครัวเรือน
2. ข้อมูลสินค้า (PIM)
เป็น master สินค้าที่ร้านค้าดูแล และข้อมูลคุณสมบัติ・หมวดหมู่・variation ที่ผูกกับสินค้า เป็นด้านที่เทียบเท่ากับ Product Information Management
- ข้อมูลหลักที่รวมอยู่ — ID สินค้า・SKU・บาร์โค้ด JAN・ชื่อสินค้า・คำอธิบาย・ราคา・ประเภทภาษี・หมวดหมู่・คุณสมบัติ (ไซซ์・สี ฯลฯ)・variation・URL รูปภาพ・สถานะการเผยแพร่
- วิธีดึง — API (ดึงรายการ・ดึงรายตัว・สร้าง・อัปเดต・ลบ), นำเข้า/ส่งออก CSV แบบเป็นชุด
- scope ที่จำเป็น —
store.products.read/store.products.write - use case หลัก — ซิงค์สองทิศทางกับระบบ master สินค้าภายนอก, เชื่อมข้อมูลสินค้ากับ EC, อัปเดตเป็นชุดจาก CMS ภายในองค์กร
3. ข้อมูลสินค้าคงคลัง
เป็นจำนวนสินค้าคงคลังของสินค้า และข้อมูลธุรกรรม เช่น การรับ-เบิกจ่าย・การย้ายชั้นวาง รองรับการเชื่อมต่อ WMS และการจัดการสินค้าคงคลังแบบหลาย location
- ข้อมูลหลักที่รวมอยู่ — ID สินค้า・ID ร้านค้า・location・จำนวนคงเหลือปัจจุบัน・สินค้าคงคลังที่จอง・จำนวนที่จะเข้ารับ・ประวัติการรับ-เบิกจ่าย
- วิธีดึง — API (ตรวจสอบสินค้าคงคลัง・ปรับสินค้าคงคลัง)
- scope ที่จำเป็น —
store.inventory.read - use case หลัก — ซิงค์สินค้าคงคลังกับ WMS ภายนอก, แสดงจำนวนสินค้าคงคลังบนเว็บ EC, จัดการการย้ายสินค้าคงคลังระหว่างร้าน
4. ข้อมูลคำสั่งซื้อ
จัดการคำสั่งซื้อที่เกิดจาก EC・การจอง・การสั่งซื้อหน้าร้าน ฯลฯ และการเปลี่ยนสถานะ เช่น การจัดส่ง・การยกเลิก
- ข้อมูลหลักที่รวมอยู่ — ID คำสั่งซื้อ・วันเวลาสั่งซื้อ・ID ลูกค้า・ที่อยู่จัดส่ง・รายละเอียดคำสั่งซื้อ・สถานะคำสั่งซื้อ (ยังไม่ยืนยัน・ยืนยันแล้ว・จัดส่งแล้ว・ยกเลิก)・สถานะการชำระเงิน
- วิธีดึง — API (รายการคำสั่งซื้อ・รายละเอียด・อัปเดตสถานะ)/Webhook (อีเวนต์สร้างคำสั่งซื้อ・เปลี่ยนสถานะ)
- scope ที่จำเป็น —
store.orders.read/store.orders.write - use case หลัก — เชื่อมต่อกับ OMS, สั่งจัดส่งไปยังระบบจัดส่งของตนเอง, แดชบอร์ดคำสั่งซื้อ
5. ข้อมูลลูกค้า・CRM
เป็นข้อมูล CRM เช่น โปรไฟล์ลูกค้าที่ร้านค้าเข้าใจอยู่, segment ที่…
-
สำหรับร้านค้า: คู่มือออกใบเสร็จดิจิทัลในแอปของตนเองและแจ้งเตือนผ่าน Webhookอธิบายขั้นตอนตั้งแต่การให้ร้านค้า/แบรนด์ออกใบเสร็จดิจิทัลให้ลูกค้าในแอปของตนเอง จนถึงการรับการแจ้งเตือนแบบเรียลไทม์ผ่าน Webhook ครอบคลุมการลงทะเบียนแอป OAuth การตั้งค่า Webhook และการตรวจสอบลายเซ็น
-
สิ่งที่ทำได้ด้วยพอร์ทัลนักพัฒนาภาพรวมของสิ่งที่ทำได้ด้วยพอร์ทัลนักพัฒนาของ ReceiptRoller ผสมผสานการดึงและจัดการข้อมูลผ่าน REST API กับการรับอีเวนต์แบบเรียลไทม์ผ่าน Webhook เพื่อเชื่อมต่อข้อมูลร้านค้าและผู้ใช้จากระบบภายนอก
-
รายการสโคป OAuth และเงื่อนไขการใช้งานอธิบายรายการสโคปทั้งหมดที่ใช้ได้กับ OAuth API ของ ReceiptRoller และแต่ละสโคปจะให้สิทธิ์แก่แอปประเภทใด ครอบคลุมทั้งเงื่อนไขการตรวจสอบสโคปกลุ่ม User เหตุผลที่ไม่สามารถผสมสโคปกลุ่ม Store กับ User และวิธีใช้งานจากแอป LIFF
-
สำหรับแอปวอลเล็ต: คู่มือดึงใบเสร็จของผู้ใช้ผ่าน OAuthอธิบายวิธีดึงใบเสร็จการซื้อของ Receipt Roller โดยได้รับความยินยอมจากผู้ใช้ ผ่านแอปแบบวอลเล็ต เช่น iOS, Android และ LINE Mini App ครอบคลุมการยืนยันตัวตน OAuth 2.0 การใช้ Receipt API และการเชื่อมต่อ Webhook
-
วิธีดู API reference และเอกสารอธิบายโครงสร้างและการเลือกใช้เอกสารสำหรับนักพัฒนาของ ReceiptRoller ครอบคลุมช่องทางเข้า 4 จุด ได้แก่ ศูนย์ช่วยเหลือนักพัฒนา・หน้ารวม API・API reference แบบ Swagger・คอมมิวนิตี้นักพัฒนา และวิธีดึงข้อมูลจำเพาะ OpenAPI (openapi/v1.json) สำหรับใช้กับผู้ช่วย AI และเครื่องมือสร้างโค้ด