# Shop — ร้านค้าออนไลน์ พร้อมเพย์

> ปลั๊กอิน Shop ทางการ — เพิ่มสินค้า วางปุ่มใส่ตะกร้าในหน้าออกแบบ ตะกร้าและหน้าชำระเงิน QR พร้อมเพย์ตามยอด โอนเงิน เก็บเงินปลายทาง แนบสลิป และจัดการคำสั่งซื้อ

ที่มา: https://anasaki.live/docs/store/plugin-shop

ปลั๊กอิน **Shop** (`eshop`) ทำให้เว็บขายของได้ทันที: เพิ่มสินค้าในหน้าจัดการ ลูกค้าใส่ตะกร้า กรอกที่อยู่ แล้วจ่ายด้วย **QR พร้อมเพย์ที่ใส่ยอดให้แล้ว** โอนเงิน หรือเก็บเงินปลายทาง ร้านตรวจสลิปและเปลี่ยนสถานะในหน้า **คำสั่งซื้อ** ระบบส่งอีเมลแจ้งลูกค้าให้

ต้องใช้ Anasaki Studio 2.2.2 ขึ้นไป

## เริ่มต้น

1. ติดตั้ง **Shop** จาก Plugin Store แล้วเปิดใช้งาน
2. ไปที่ **ปลั๊กอิน → Shop → ตั้งค่า** ใส่อย่างน้อยหนึ่งวิธีชำระเงิน
3. เมนู **สินค้า** จะโผล่ในหน้าจัดการ — เพิ่มสินค้า ใส่ราคา รูปเด่น และรายละเอียด แล้วกดเผยแพร่
4. เปิด `/product/` จะเห็นราคาและปุ่ม **ใส่ตะกร้า** ใต้รายละเอียดทันที

## การตั้งค่า

| ค่า | ความหมาย |
| --- | --- |
| พร้อมเพย์ | เบอร์ 10 หลัก เลขประจำตัว 13 หลัก หรือ e-Wallet 15 หลัก — ว่าง = ไม่รับพร้อมเพย์ |
| ชื่อบัญชีพร้อมเพย์ | แสดงใต้ QR ให้ลูกค้าตรวจก่อนโอน |
| บัญชีสำหรับโอนเงิน | ธนาคาร เลขบัญชี ชื่อบัญชี — ว่าง = ไม่มีตัวเลือกโอนเงิน |
| รับเก็บเงินปลายทาง | เปิด/ปิดตัวเลือก COD |
| ค่าส่ง / ส่งฟรีเมื่อยอดถึง | ค่าส่งต่อคำสั่งซื้อ และยอดขั้นต่ำที่ส่งฟรี (0 = ไม่มีส่งฟรี) |
| อีเมลรับแจ้งคำสั่งซื้อใหม่ | ว่าง = อีเมลผู้ดูแลเว็บ (ต้องตั้งค่า **อีเมล** ของเว็บก่อน) |
| ยกเลิกคำสั่งซื้อที่ไม่ชำระหลัง | ชั่วโมง (ค่าเริ่มต้น 48) คืนสต็อกให้อัตโนมัติ — ไม่รวมเก็บเงินปลายทางและคำสั่งซื้อที่แนบสลิปแล้ว |
| แสดงราคาและปุ่มใส่ตะกร้าใต้รายละเอียดสินค้า | ปิดได้ถ้าวางบล็อก **ปุ่มใส่ตะกร้า** ในแม่แบบหน้าสินค้าเอง |

## สินค้า

ฟิลด์ของสินค้า: **ราคา** (จำเป็น) **ราคาลด** (แสดงราคาเดิมขีดฆ่า) **จำนวนในสต็อก** (ว่าง = ไม่นับ) และ **รหัสสินค้า (SKU)** — สต็อกลดลงตอนลูกค้ายืนยันคำสั่งซื้อ และกลับคืนเมื่อยกเลิก สินค้าที่หมดแสดงปุ่ม **สินค้าหมด** แทน

สินค้าใช้หมวดหมู่ได้ และแต่ละชิ้นมีหน้าของตัวเองที่ `/product/` ซึ่งใช้แม่แบบบทความ หรือแม่แบบที่เลือกใน **ตั้งค่าเว็บไซต์ → การแสดงผล → ประเภทเนื้อหาจากโค้ด**

### ตัวเลือกสินค้า แกลเลอรี โค้ดส่วนลด (1.1)

- **ตัวเลือกสินค้า** — ใส่ **ชื่อตัวเลือก** (เช่น ขนาด) แล้วเพิ่มแถวในรายการตัวเลือก แต่ละแถวมีชื่อ ราคา และสต็อกของตัวเอง (ราคาว่าง = ราคาสินค้า สต็อกว่าง = ไม่นับ) ลูกค้าต้องเลือกก่อนใส่ตะกร้า ตัวที่หมดกดไม่ได้ และราคาแสดง &#34;เริ่มต้น ฿…&#34; เมื่อราคาต่างกัน
- **รูปเพิ่มเติม** — เลือกได้ถึง 12 รูป แสดงบนหน้าสินค้า กดดูรูปใหญ่ได้
- **โค้ดส่วนลด** — การตั้งค่า **โค้ดส่วนลด** บรรทัดละโค้ด `โค้ด | 10% หรือจำนวนบาท | ยอดขั้นต่ำ | ใช้ได้ถึงวันที่` เช่น `WELCOME | 10%` หรือ `SAVE100 | 100 | 1000 | 2026-12-31` เมื่อมีโค้ด หน้าชำระเงินจะมีช่องกรอกโค้ด และส่วนลดแสดงในหน้าคำสั่งซื้อ อีเมล และ CSV
- **ราคาบนการ์ด** — การ์ดในหน้ารวมสินค้า (บล็อก **ข้อมูลเพิ่มเติม**) แสดงราคา ส่วนหน้าสินค้าใช้กล่องราคาและปุ่มใส่ตะกร้า

## ในหน้าออกแบบ

**บล็อกปลั๊กอิน** (แท็บองค์ประกอบ):

- **ปุ่มใส่ตะกร้า** — เลือกสินค้าในแผงคุณสมบัติ หรือเว้นว่างเมื่อวางในแม่แบบหน้าสินค้าหรือในการ์ดของรายการสินค้า เลือกได้ว่าจะแสดงราคาและช่องจำนวนไหม
- **ลิงก์ตะกร้า** — ไอคอน 🛒 พร้อมจำนวนชิ้น เหมาะกับหัวเว็บ
- **ราคาสินค้า** — ราคา (และราคาเดิมเมื่อลดราคา)

**รายการสินค้า**: วาง **รายการ (Collection)** แล้วเลือกแหล่งข้อมูล **สินค้า (ร้านค้า)** ใช้ `{{item.title}}` `{{item.image}}` `{{item.price}}` `{{item.regularPrice}}` `{{item.url}}` ในการ์ด และพารามิเตอร์ `search` `category` `sort` (`price`, `-price`, `title`)

## ลูกค้าซื้ออย่างไร

1. กด **ใส่ตะกร้า** — ตะกร้าเก็บในคุกกี้ของเบราว์เซอร์ 30 วัน ไม่ต้องสมัครสมาชิก
2. `/cart` — แก้จำนวน ลบ ดูค่าส่งและยอดรวม แล้วกด **ไปชำระเงิน**
3. `/checkout` — กรอกชื่อ เบอร์ อีเมล (ไม่บังคับ) ที่อยู่ และเลือกวิธีชำระเงิน
4. หน้าคำสั่งซื้อ (`/shop/order/`) แสดง **QR พร้อมเพย์ที่ใส่ยอดแล้ว** หรือเลขบัญชี พร้อมช่อง **แนบสลิป** (ระบบย่อรูปให้ก่อนส่ง) — ลิงก์นี้ใช้ดูสถานะภายหลังได้

ราคาและสต็อกถูกตรวจใหม่ฝั่งเซิร์ฟเวอร์ตอนยืนยันเสมอ ลูกค้าแก้ราคาในเบราว์เซอร์ไม่ได้ และจากที่อยู่ IP เดียวกันสั่งได้ไม่เกิน 5 ครั้งต่อนาที

## จัดการคำสั่งซื้อ

หน้า **คำสั่งซื้อ** (เมนูนักพัฒนา → หน้าของปลั๊กอิน) แสดงรายการตามสถานะ ค้นหาด้วยชื่อ เบอร์ อีเมล หรือรหัส คลิกเลขที่เพื่อดูรายการสินค้า ที่อยู่ และ **สลิป** แล้วกดเปลี่ยนสถานะ:

| สถานะ | เกิดอะไรขึ้น |
| --- | --- |
| รอชำระ | สถานะเริ่มต้น |
| ชำระแล้ว | อีเมลยืนยันการชำระเงินถึงลูกค้า |
| จัดส่งแล้ว | อีเมลแจ้งจัดส่งถึงลูกค้า |
| สำเร็จ | ปิดงาน |
| ยกเลิก | คืนสต็อก |

ส่งออกทั้งหมดเป็น **CSV** ได้ และแดชบอร์ดมีการ์ด **ร้านค้า** (รอชำระ รอจัดส่ง ยอดวันนี้) สิทธิ์ **จัดการคำสั่งซื้อ** และ **จัดการสินค้า** ปรับได้ที่ **ผู้ใช้ → สิทธิ์** (ค่าเริ่มต้น: ผู้ดูแลและบรรณาธิการ)

### เลขพัสดุและการชำระด้วยบัตร (1.1)

ในหน้ารายละเอียดคำสั่งซื้อ กรอก **ขนส่ง** และ **เลขพัสดุ** แล้วกด **บันทึกและเปลี่ยนเป็นจัดส่งแล้ว** ลูกค้าได้อีเมลพร้อมเลขพัสดุ และเห็นปุ่ม **ติดตามพัสดุ** ในหน้าคำสั่งซื้อ (ลิงก์ติดตามของไปรษณีย์ไทย Kerry Flash และ J&T)

ติดตั้งปลั๊กอิน [Payments](/docs/store/plugin-payments) แล้วจะมีวิธีชำระ **บัตรเครดิต/เดบิต** เพิ่มให้อัตโนมัติ

### ใบเสร็จ ใบกำกับภาษี และคำสั่งซื้อของฉัน (1.1)

- ตั้ง **ชื่อร้าน/บริษัท เลขผู้เสียภาษี ที่อยู่** สำหรับใบเสร็จ ถ้า **จดทะเบียน VAT** ใบเสร็จจะเป็น **ใบกำกับภาษี/ใบเสร็จรับเงิน** แสดงมูลค่าก่อนภาษีและ VAT 7%
- ลูกค้าติ๊ก **ต้องการใบกำกับภาษีเต็มรูป** ตอนสั่งซื้อ แล้วใส่ชื่อ/บริษัท เลขผู้เสียภาษี 13 หลัก และที่อยู่
- เมื่อคำสั่งซื้อเป็น **ชำระแล้ว** ได้เลขที่ใบเสร็จ `R2026-0001` (นับใหม่ทุกปี) และปุ่ม **ใบเสร็จรับเงิน** ในหน้าคำสั่งซื้อ พิมพ์หรือบันทึกเป็น PDF ได้
- ใช้คู่กับปลั๊กอิน **Members**: สมาชิกที่เข้าสู่ระบบตอนสั่งซื้อดูประวัติได้ที่ `/shop/orders`

## สำหรับนักพัฒนา

```ts
site.on('eshop.order.created', (o) => log.info('new order', o.id, o.total));
site.on('eshop.order.paid', (o) => http.webhook('https://example.com/hook', 'paid', o));
site.on('eshop.order.status', (o) => log.info(o.id, o.from, '→', o.status));
```

export `orderTotal([{ id, qty }])` (ใน `plugins.call('eshop', …)`) คืนยอดรวมตามราคาปัจจุบัน — ตารางของปลั๊กอินคือ `p_eshop_orders` และ `p_eshop_items`

> [!NOTE]
> สลิปเก็บเป็นไฟล์ส่วนตัวของปลั๊กอิน (ไม่มีลิงก์สาธารณะ) เห็นได้เฉพาะผู้ที่มีสิทธิ์จัดการคำสั่งซื้อ ระบบไม่ได้ตรวจสลิปกับธนาคารอัตโนมัติ — ร้านควรตรวจยอดในแอปธนาคารก่อนกด **ชำระแล้ว**
