คู่มือ Samurai Agent

🚀 เริ่มต้น

ก่อนเริ่มรับงาน ต้องสมัครและรอ admin อนุมัติ — ขั้นตอนใช้เวลา 5-10 นาที

🥷 Tier: Samurai-bid vs Agent ทั่วไป

มี 3 ระดับ — ตั้งโดย admin หลังอนุมัติ

📋 Flow รับงาน (buy_now) — UX ใหม่ 2026-05-10

1. เปิด tab "บอร์ดงาน" — เห็นออเดอร์ที่เปิดรับ พร้อม commission ที่จะได้
2. แตะออเดอร์ → popup รายละเอียด เห็น URL · ราคา · maxBid · ลูกค้า/tier · note · commission breakdown · WIP gauge ก่อนตัดสินใจ
3. กด "✊ Claim งานนี้" ใน popup → ผลทันที:
   • 🎉 สำเร็จ → auto-nav แท็บ "งานของฉัน" + card pulse · ปุ่มใหญ่ 2 ปุ่ม: 🛒 เปิดลิงก์ซื้อ + 📤 อัปโหลดหลักฐาน
   • 😅 ช้าเกิน (agent อื่น claim ก่อน) — popup บอกชัด ไม่ใช่ error
   • ⏳ ออเดอร์ยังไม่พร้อม (ลูกค้ายังไม่จ่าย/admin ยังไม่ approve สลิป) — รอซักครู่
4. กด 🛒 เปิดลิงก์ซื้อ → ซื้อด้วย account ตัวเอง (Yahoo / Mercari / PayPay / Rakuten / Amazon JP)
5. กลับมากด 📤 อัปโหลดหลักฐาน — screenshot ใบเสร็จ / หน้า "ซื้อสำเร็จ"
6. กด 🏷 ป้ายกำกับ → copy ข้อความ JP ส่งให้ผู้ขายเขียนเลขลงพัสดุ (ดู section ถัดไป)
7. รอผู้ขายจัดส่ง → กรอก carrier + tracking number + ETA → ลูกค้าได้รับ LINE update
8. ของถึงโกดัง JP → admin confirm → claim status `arrived`
9. admin อนุมัติจ่ายเงิน → status `done` → โอนเงินเข้าบัญชี ภายใน 1-3 วัน

🔨 Flow ประมูล (auction-bid)

สำหรับออเดอร์ Yahoo Auction ที่ admin ปล่อยให้ agent bid เอง — flow ต่างจาก buy_now

ขั้นตอน

1. กด "✊ รับงาน" ที่ออเดอร์ประมูล (มี pill "🔨 ประมูล (bid เอง)")
2. เปิด link Yahoo Auction → bid ครั้งแรก ตาม maxBid ที่ลูกค้ากำหนด
3. กด "🔨 เริ่มบิดแล้ว" ใน dashboard → ลูกค้ารับ LINE notif "🔨 เริ่มบิดให้แล้ว"
4. ติดตามประมูลใน Yahoo — ถ้าถูกแซง:
   • กด "⚠️ ถูกแซง" + ใส่ยอดที่ถูกแซง
   • ลูกค้ารับ LINE: "❗ ถูกแซง · พิมพ์ bid <ยอดใหม่> หรือ ยอมแพ้"
   • ลูกค้าตอบ "bid 60000" → maxBid update → คุณบิดสู้ต่อ
   • ลูกค้าตอบ "ยอมแพ้" → status auction_lost → admin จัดการคืนเงิน
5. ประมูลจบ — ชนะ:
   • กด "🎉 สรุปยอด" → ใส่ winning yen + ค่าส่ง JP (ถ้ามี)
   • ลูกค้ารับ LINE บิลรอจ่าย (Bronze/Silver) หรือ "บิลออกตอนของถึงโกดัง" (Gold/Diamond/VIP)
   • Bronze/Silver: รอ admin approve สลิป (หรือ wallet หักอัตโนมัติ) → upload หลักฐานการซื้อ
   • Gold/Diamond/VIP: upload หลักฐานได้ทันที (post-paid)
6. ประมูลจบ — แพ้: กด "❌ แพ้ประมูล" + เหตุผล → admin notif → คืนเงินลูกค้า
7. ที่เหลือเหมือน buy_now: tracking → ถึงโกดัง → admin อนุมัติ → รับเงิน

Customer tier ที่ส่งผลต่อ flow ประมูล

ระบบ Samurai Pay ใช้ 5 tier (Bronze → Silver → Gold → Diamond → VIP) — ดู pill ของลูกค้าใน claim card:

• 🥉 Bronze / 🥈 Silver — pre-paid mandatory · ต้องรอลูกค้าจ่ายมัดจำ 50% (หรือ wallet หัก) ก่อน admin จะปล่อยให้ claim
• 🥇 Gold / 💎 Diamond / 👑 VIP — post-paid · admin auto-release ทันทีตอน create · agent ทำงานได้เลย ไม่รอจ่าย

📤 Upload หลักฐาน

หลักฐานการซื้อ (proof)

• screenshot หน้า "ซื้อสำเร็จ" หรือใบเสร็จ
• JPG/PNG · ไม่เกิน 8 MB · สูงสุด 10 ไฟล์
• เห็น order ID + ยอดเงิน + ชื่อสินค้าชัดเจน

Tracking

• Carrier: ヤマト, 佐川, 日本郵便, etc.
• Tracking number: เลข tracking
• URL (ถ้ามี): link เว็บ tracking โดยตรง — admin/ลูกค้าใช้เช็คสถานะได้
• ETA date: วันที่คาดถึงโกดัง JP

🏷 ป้ายกำกับสำหรับร้านค้า (สำคัญมาก)

ทุก claim card ใน tab "งานของฉัน" มีปุ่ม 🏷 ป้ายกำกับสำหรับร้านค้า — เปิด popup โชว์:

• เลขออเดอร์ (เช่น JP-12345) + ปุ่มคัดลอก
• รหัสลูกค้า (เช่น SM1234) + ปุ่มคัดลอก
• ข้อความญี่ปุ่นพร้อมใช้ — paste ในแชท Yahoo/Mercari/PayPay หรือช่องโน้ตตอน checkout

ขอให้ผู้ขายเขียน 2 เลขนี้บนกล่อง/ใบส่งของ — โกดัง JP จะคัดแยกได้เร็วและตรงทันทีเมื่อพัสดุถึง ลด error กรณีพัสดุหลายชิ้นมาพร้อมกันหรือกล่องไม่มี tracking ตรงกับใบเสร็จ

🛡️ ขีดจำกัด + ระบบอัตโนมัติ (2026-05-11)

ระบบมีกฎเพื่อให้ทุก agent มีโอกาสรับงานเท่า ๆ กัน + ป้องกันออเดอร์ค้าง:

1. Cap จำนวน claim ที่ active พร้อมกัน

"Active" = ทุก claim ที่ยังไม่ done/rejected/released — รวม claimed, purchased, shipped, arrived

2. Stale claim auto-release

• Claim status claimed ไม่ส่ง proof ≥ 18 ชม. → ระบบ warn
• เกิน 72 ชม. ไม่ขยับ → auto-release ออเดอร์กลับบอร์ด (agent คนอื่นรับต่อได้)
• ถ้าส่ง proof แล้ว (status ≥ purchased) → ไม่ auto-release · งานเป็นของ agent คนนี้

3. Auto-approve สำหรับ agent ที่เชื่อใจ

ถ้าครบเงื่อนไขทั้งหมด: tier ≥ Samurai-agent + งานเสร็จ ≥ 50 ครั้ง + ไม่มี reject ใน 30 วัน + ยอด ≤ ¥30,000

→ arrived → done อัตโนมัติ (ไม่ต้องรอ admin กด approve) · เงินคำนวณเข้า totalEarnedTHB ทันที

4. Auto-promote: Agent → Samurai-agent

• งานเสร็จ ≥ 30 ครั้ง + rejection rate < 10% + ไม่มี reject ใน 30 วัน
• → ระบบ promote เป็น Samurai-agent อัตโนมัติ
• Samurai-agent → Samurai-bid ต้อง admin invite เท่านั้น (in-house only)

5. Max bid cap

ลูกค้าตั้ง maxBid ได้สูงสุด ¥10,000,000 (~฿2.3M) — ถ้าลูกค้าพิมพ์เกิน ระบบ reject อัตโนมัติ

💸 รับเงิน

commission คำนวณตอน arrived (ของถึงโกดัง) — admin ตรวจ + อนุมัติ → โอนเข้าบัญชีไทย

โอนเงินเข้าบัญชี

• admin บันทึกการจ่ายใน "💰 รอจ่าย agent"
• โอนเข้าบัญชีไทยที่ใส่ในโปรไฟล์ (เลขบัญชี + ชื่อต้องตรง)
• หาก info ผิด → admin จะติดต่อก่อนโอน

❓ FAQ

ออเดอร์ปริ่มอยากรับ แต่หาย

ตอน claim ใช้ first-come — agent คนอื่นกดก่อน → ออเดอร์หายจากบอร์ดทันที

ราคาสินค้าเปลี่ยน (เช่น stock หมด ผู้ขายขึ้นราคา)

ปล่อยคืน (release) — admin ปล่อยใหม่หลังคุยลูกค้าเรื่องราคา

ผู้ขายไม่ส่งของ / ส่งของช้า

ติดต่อ admin Samurai ผ่าน LINE @samuraibid — admin จะคุยกับลูกค้าและจัดการ refund

ของถึงโกดังแล้ว แต่ admin ยังไม่อนุมัติ

ปกติภายใน 1-2 วัน · ถ้านานเกินติดต่อ admin · admin อาจ reject ถ้ามีปัญหา (ของชำรุด, เลขผิด) — รับเหตุผลและแก้

Tier samurai_bid ได้ยังไง

admin invite เท่านั้น — เป็นทีมงานในสังกัด Samurai. agent ทั่วไปสมัครได้แต่จะเป็น tier `agent`

ปิด account / หยุดทำ

แจ้ง admin ผ่าน LINE → admin จะ suspend account · งานที่ทำค้างอยู่ต้องทำเสร็จก่อน