สมอง BC

คลังความรู้ / ระบบงานในชุด BC

#systems#market#sales#b2b#dashboard

ร้านค้าส่งออนไลน์ B2B (sys-market)

ระบบ /market เป็นหน้าร้านค้าส่งให้ร้านค้าช่วง (sub-dealer) เลือกสินค้า ใส่ตะกร้า แล้วสั่งซื้อแบบตัดวงเงินเครดิตโดยไม่ต้องชำระเงินออนไลน์ เมื่อกดสั่งซื้อ ระบบจะสร้างคำสั่งซื้อและเอกสารต่อเนื่องไปยังคลัง ขนส่ง CRM และ e-Tax ใน transaction เดียว การ์ดในหน้าเลือกระบบชื่อ "ร้านค้าส่ง Market (B2B Wholesale)"

ใครใช้ และเปิดอย่างไร

  • ใช้ได้เมื่อล็อกอินและเลือกฐานข้อมูลแล้ว ถ้ายังไม่มี session ระบบจะส่งไป /login และถ้ายังไม่เลือกฐานจะส่งไป /select-database (page.tsx:12-13)
  • เปิดได้จากการ์ดในกลุ่ม supply หรือพิมพ์ /market ตรง ๆ ดู โครงหน้าเว็บและการนำทาง (App shell & routing)
  • หน้าจอมี 3 มุมมองคือ home (แคตตาล็อก), cart (ตะกร้า) และ orders (คำสั่งซื้อ) (MarketDashboard.tsx:319-320)

Endpoint และ action

  • GET /api/v1/market/overview?q=&group= เรียก Overview ซึ่งรับคำค้นและกลุ่มสินค้า (handler.go:248-258)
  • POST /api/v1/market/order เรียก CartOrOrderAction ซึ่งอ่าน action_type แล้วแปลงเป็นตัวพิมพ์ใหญ่ก่อนเลือกทาง (:270-304)
action_type ผลในโค้ด
ADD_TO_CART เพิ่มสินค้าในตะกร้า ถ้า SKU ยังไม่อยู่ในแคตตาล็อกจะดึงจาก ic_inventory มาเพิ่มให้ ดู ราคาขั้นบันได คูปอง และการสั่งซื้อ B2B ที่ซิงก์ข้ามระบบ (sys-market-checkout-sync)
UPDATE_CART_QTY, REMOVE_CART_ITEM แก้จำนวนแล้วคิดราคาขั้นบันไดใหม่ หรือลบรายการ (:454-502)
CLEAR_CART DELETE FROM market_cart_item ทั้งตาราง (:503-510)
ADVANCE_ORDER_STATUS เลื่อนสถานะคำสั่งซื้อ (:511-545)
REORDER_TO_CART ใส่สินค้าตัวอย่างชุดตั้งต้นกลับเข้าตะกร้า (seedDefaultCartItems) ไม่ได้ใช้รายการของคำสั่งซื้อเดิม (:546-549)
PLACE_B2B_ORDER สั่งซื้อและซิงก์ข้ามระบบ ดู ราคาขั้นบันได คูปอง และการสั่งซื้อ B2B ที่ซิงก์ข้ามระบบ (sys-market-checkout-sync)

สถานะคำสั่งซื้อเดินตามลำดับ PENDING_CONFIRM → WMS_PACKING → TMS_IN_TRANSIT → DELIVERED_COMPLETED คำสั่งซื้อใหม่เริ่มที่ WMS_PACKING การเลื่อนสถานะอัปเดตเฉพาะ market_b2b_order (:511-545)

ข้อมูล

ตารางสร้างเองตอนเรียกครั้งแรก (handler.go:1252-1360) คอลัมน์เงินเป็น numeric(18,2)

ตาราง เก็บอะไร
market_product_catalog แคตตาล็อก ราคาปลีกและราคาขั้นบันได 3 ระดับ
market_subdealer_profile ร้านค้าช่วง วงเงิน (credit_limit, credit_used, credit_available) เทอม (credit_term_days) rebate และยอดยกมา
market_cart_item รายการในตะกร้า
market_b2b_order คำสั่งซื้อ พร้อมเลขเอกสารอ้างอิงของ ERP, WMS, TMS และ e-Tax

Overview อ่านแคตตาล็อก ร้านค้าช่วง ตะกร้า คำสั่งซื้อล่าสุด 20 รายการ จำนวนสินค้าใน ic_inventory และรายการสินค้าจาก ic_inventory ร่วมกับ ic_group ตามคำค้น (:852-884) ดู ทะเบียนสินค้า (ic_inventory)

ความสัมพันธ์กับระบบบัญชี

ที่มาในโค้ด