พร้อมจำหน่ายแล้ว BC Ai Account พร้อมใช้งาน ทดลองใช้ได้ทันที หรือติดต่อทีมขายเพื่อขอใบเสนอราคา

สำหรับนักพัฒนา — REST API + MCP

เชื่อมระบบของคุณเข้ากับ BC Ai Account

ทุกฟังก์ชันในโปรแกรมมี REST API ให้ระบบของคุณเรียกใช้ และมี MCP endpoint สำหรับบัญชีแยกประเภทและสินทรัพย์ถาวร ให้ผู้ช่วย AI ที่รองรับ MCP ทำงานกับข้อมูลบัญชีได้ตามสิทธิ์ของโทเคนที่ผู้ดูแลกำหนด

สอบถามสิทธิ์เชื่อมต่อ ดูระบบที่เชื่อมต่อได้

เชื่อมผู้ช่วย AI กับข้อมูลบัญชีผ่าน MCP

ภาพรวมสำหรับเจ้าของกิจการและนักบัญชี: ผู้ช่วย AI ทำอะไรได้บ้าง การกำหนดสิทธิ์โทเคน และข้อจำกัดที่ควรรู้

ดูรายละเอียดการเชื่อมผู้ช่วย AI →

เครื่องมือ MCP ของบัญชีแยกประเภท

gl_list     ค้นรายการบัญชี สมุดรายวัน และข้อมูลหลัก (แบ่งหน้า)
gl_get      เปิดดูรายการทีละรายการตาม ID
gl_report   ดึงรายงาน เช่น งบทดลอง งบกำไรขาดทุน งบฐานะการเงิน
gl_command  สั่งงานบัญชี (เฉพาะโทเคนอ่าน-เขียน)

MCP — เชื่อมผู้ช่วย AI

เชื่อมผู้ช่วย AI กับข้อมูลบัญชีตามสิทธิ์

BC Ai Account มี MCP (Model Context Protocol) endpoint ให้ผู้ช่วย AI และเครื่องมือนักพัฒนาที่รองรับ MCP เรียกใช้เครื่องมือบัญชีแยกประเภทได้ โดยผู้ดูแลเป็นผู้สร้างโทเคนและกำหนดสิทธิ์ในโปรแกรม

ขั้นตอนเชื่อมต่อ

1. สร้างโทเคนในโปรแกรม

ผู้ดูแลสร้างโทเคน เลือกสิทธิ์อ่านอย่างเดียวหรืออ่าน-เขียน และระบุบริษัทที่เข้าถึงได้

2. ตั้งค่าโปรแกรมที่รองรับ MCP

ใส่ที่อยู่ MCP endpoint และโทเคนในผู้ช่วย AI หรือเครื่องมือที่รองรับ MCP แบบเชื่อมผ่าน HTTP

3. ถามหรือสั่งงานตามสิทธิ์

"ขอดูงบทดลอง ณ สิ้นเดือน" "ลูกหนี้รายไหนยังค้างชำระ" — ผู้ช่วย AI เรียกได้เฉพาะเครื่องมือที่โทเคนอนุญาต

ใช้งานแบบไหนได้บ้าง

ผู้ช่วย AI ที่รองรับ MCP

เจ้าของกิจการ / นักบัญชี

ถามยอดบัญชี เปิดดูรายการ และดึงงบทดลองหรืองบการเงินมาสรุปเป็นภาษาที่อ่านง่าย

เครื่องมือนักพัฒนาที่รองรับ MCP

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

ใช้ MCP ร่วมกับ REST API เพื่อสำรวจข้อมูลบัญชีและทดสอบการเชื่อมต่อระหว่างพัฒนา

โทเคนอ่านอย่างเดียว

แนะนำเริ่มต้น

ค้นรายการ เปิดดู และดึงรายงานได้ ขอข้อมูลหลายบริษัทพร้อมกันได้ โดยยอดแต่ละบริษัทแสดงแยกกัน ไม่รวมเป็นงบการเงินรวม

โทเคนอ่าน-เขียน

ควบคุมโดยผู้ดูแล

สั่งงานบัญชีได้ทีละบริษัท ทุกการบันทึกผ่านการตรวจความถูกต้องเดียวกับหน้าจอ เช่น เดบิตต้องเท่ากับเครดิต

ตัวอย่าง — ถามงบทดลองผ่านผู้ช่วย AI

คุณ:
"ขอดูงบทดลองของบริษัท A ณ 30 กันยายน และบอกว่าบัญชีไหนยอดสูงที่สุด"
ผู้ช่วย AI:

เรียกเครื่องมือ gl_report (งบทดลอง) ของบริษัท A ณ วันที่ 30 ก.ย. แล้วสรุปให้

สิ่งที่ได้:

  1. ยอดคงเหลือรายบัญชี ณ วันที่ที่ขอ
  2. ตรวจว่ายอดเดบิตรวมเท่ากับยอดเครดิตรวม
  3. บัญชีที่ยอดสูง พร้อมเปิดดูรายการต่อด้วย gl_list / gl_get

ตัวอย่างประกอบ — ผลลัพธ์จริงขึ้นกับข้อมูลในระบบและสิทธิ์ของโทเคน

ระบบที่เชื่อมต่อได้

เลือกเชื่อมต่อเฉพาะส่วนที่คุณต้องการ

ทุกฟังก์ชันในโปรแกรมมี REST API เลือกเชื่อมเฉพาะระบบงานที่ระบบของคุณต้องใช้

บัญชีแยกประเภทและภาษี

ผังบัญชี สมุดรายวัน งบการเงิน รายงานภาษี

บันทึกและผ่านรายการบัญชี ดึงงบทดลอง งบการเงิน รายงานภาษีซื้อ/ภาษีขาย และรายงานภาษีหัก ณ ที่จ่าย

  • ผังบัญชีและสมุดรายวัน
  • บันทึกรายการรายวัน
  • งบทดลองและงบการเงิน
  • รายงานภาษี

ขายและลูกหนี้

ใบเสนอราคา ใบสั่งขาย ใบกำกับภาษี รับชำระ

สร้างเอกสารขายตั้งแต่ใบเสนอราคาถึงใบกำกับภาษี ออกใบวางบิลและใบเสร็จรับเงิน ติดตามยอดค้างชำระ

  • ใบเสนอราคา / ใบสั่งขาย
  • บันทึกขายและใบกำกับภาษี
  • ใบวางบิล / ใบเสร็จรับเงิน
  • อายุลูกหนี้

ซื้อและเจ้าหนี้

ใบเสนอซื้อ ใบสั่งซื้อ รับสินค้า จ่ายชำระ

เชื่อมขั้นตอนจัดซื้อตั้งแต่ใบเสนอซื้อ ใบสั่งซื้อ รับสินค้า ตั้งหนี้ จนถึงจ่ายชำระเจ้าหนี้

  • ใบเสนอซื้อ / ใบสั่งซื้อ
  • รับสินค้าและตั้งหนี้
  • เตรียมจ่ายและจ่ายชำระหนี้
  • อายุเจ้าหนี้

ระบบคลังสินค้า

หลายคลัง รับเข้า เบิก รับคืน

ดูยอดคงเหลือตามสินค้าและคลัง บันทึกรับเข้า เบิกใช้ และรับคืน โดยสต็อกปรับยอดตามสินค้าและคลังพร้อมต้นทุนถัวเฉลี่ย

  • ยอดคงเหลือตามสินค้า / คลัง
  • รับเข้า / เบิกใช้ / รับคืน
  • ต้นทุนถัวเฉลี่ยรายคลัง

เงินสดและธนาคาร

เช็ค บัตรเครดิต สมุดเงินฝาก เงินสดย่อย

บันทึกรับ-จ่ายเงิน วงจรเช็ครับ/เช็คจ่าย ฝาก ถอน โอนระหว่างบัญชี และวงเงินสดย่อย

  • เช็ครับ / เช็คจ่าย
  • สมุดเงินฝาก
  • รับ-จ่ายเงินอื่นๆ
  • เงินสดย่อย

สินทรัพย์ถาวร

ทะเบียนสินทรัพย์ ค่าเสื่อมราคา

จัดการทะเบียนสินทรัพย์ ประมวลผลค่าเสื่อมราคาและโอนเข้าบัญชีแยกประเภท ดูตารางค่าเสื่อมราคา

  • ทะเบียนสินทรัพย์
  • ประมวลผลค่าเสื่อมราคา
  • ตารางค่าเสื่อมราคา

ตัวอย่างโค้ด

ตัวอย่างเรียก MCP endpoint

MCP ใช้ JSON-RPC ผ่าน HTTP — แทน MCP_URL ด้วยที่อยู่ MCP endpoint ของระบบคุณ และ MCP_TOKEN ด้วยโทเคนที่สร้างในโปรแกรม (เก็บโทเคนไว้ในตัวแปรสภาพแวดล้อม ไม่เขียนลงในโค้ด)

JavaScript — ขอรายการเครื่องมือ

// ขอรายการเครื่องมือ MCP ที่โทเคนนี้ใช้ได้
const response = await fetch(process.env.MCP_URL, {
 method: 'POST',
 headers: {
 'Authorization': `Bearer ${process.env.MCP_TOKEN}`,
 'Content-Type': 'application/json',
 'Accept': 'application/json, text/event-stream',
 },
 body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/list' }),
});

const result = await response.json();
console.log(result.result.tools.map((tool) => tool.name));
// => [ 'gl_list', 'gl_get', 'gl_report' ]  (โทเคนอ่านอย่างเดียว)

Python — ดึงงบทดลอง

# ดึงงบทดลองของบริษัทเดียว ณ วันที่กำหนด
import os
import requests

response = requests.post(
 os.environ["MCP_URL"],
 headers={
 "Authorization": f"Bearer {os.environ['MCP_TOKEN']}",
 "Accept": "application/json, text/event-stream",
 },
 json={
 "jsonrpc": "2.0",
 "id": 2,
 "method": "tools/call",
 "params": {
 "name": "gl_report",
 "arguments": {
 "companyCode": "รหัสบริษัท",
 "report": "trialbalance",
 "query": {"to": "2026-09-30"},
 },
 },
 },
)

print(response.json()["result"])

PHP — ทดสอบการเชื่อมต่อ

<?php
// ทดสอบการเชื่อมต่อด้วยคำสั่ง initialize ของ MCP
$ch = curl_init(getenv('MCP_URL'));
curl_setopt_array($ch, [
 CURLOPT_POST => true,
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_HTTPHEADER => [
 'Authorization: Bearer ' . getenv('MCP_TOKEN'),
 'Content-Type: application/json',
 'Accept: application/json, text/event-stream',
 ],
 CURLOPT_POSTFIELDS => json_encode([
 'jsonrpc' => '2.0',
 'id' => 1,
 'method' => 'initialize',
 'params' => ['protocolVersion' => '2025-11-25'],
 ]),
]);
$result = json_decode(curl_exec($ch), true);
echo $result['result']['serverInfo']['name'];

ตัวอย่างผลลัพธ์ (ย่อ) — tools/list ด้วยโทเคนอ่านอย่างเดียว

{
 "jsonrpc": "2.0",
 "id": 1,
 "result": {
 "tools": [
 { "name": "gl_list", "description": "…" },
 { "name": "gl_get", "description": "…" },
 { "name": "gl_report", "description": "…" }
 ]
 }
}

MCP Tools — บัญชีแยกประเภท

เครื่องมือ MCP ที่ผู้ช่วย AI เรียกใช้ได้

เครื่องมือที่เห็นขึ้นกับสิทธิ์ของโทเคน: โทเคนอ่านอย่างเดียวเห็น gl_list, gl_get และ gl_report ส่วนโทเคนอ่าน-เขียนเห็น gl_command เพิ่ม

gl_list — ค้นรายการ

  • ผังบัญชี สมุดรายวัน รายการรายวัน และข้อมูลหลักของบัญชีแยกประเภท แบบแบ่งหน้า
  • ข้อมูลประกอบรายการบัญชี เช่น คู่ค้า บัญชีธนาคาร เอกสาร การรับ-จ่ายชำระ และรายการ Statement ธนาคาร

gl_get — เปิดดูรายละเอียด

  • เปิดดูข้อมูลบัญชีแยกประเภททีละรายการตาม ID
  • เปิดดูข้อมูลการตรวจทานรายการรายวัน

gl_report — ดึงรายงาน

  • บัญชีแยกประเภท และงบทดลอง
  • งบกำไรขาดทุน และงบฐานะการเงิน
  • ยอดคงค้างลูกหนี้ / เจ้าหนี้
  • รายการ Statement ธนาคารที่ยังไม่จับคู่

gl_command — สั่งงานบัญชี (โทเคนอ่าน-เขียน)

  • ใช้รูปแบบคำสั่งเดียวกับ REST API ของบัญชีแยกประเภท และผ่านการตรวจความถูกต้องเดียวกับหน้าจอ
  • การผ่านรายการ ยกเลิกผ่านรายการ และปิดงวด ต้องสั่งอย่างชัดเจน ไม่เกิดขึ้นอัตโนมัติ
  • รายการที่นำเข้าจะไม่ผ่านรายการเอง ผู้ใช้ตรวจแล้วสั่งผ่านรายการภายหลัง

สินทรัพย์ถาวร

  • มีชุดเครื่องมือ MCP สำหรับทะเบียนสินทรัพย์ ตารางค่าเสื่อมราคา การโอนค่าเสื่อมราคาเข้าบัญชีแยกประเภท และการจำหน่ายสินทรัพย์
  • สอบถามทีมงานเรื่องการเปิดใช้งานสำหรับกิจการของคุณ

ขอบเขตบริษัทและสาขา

  • กลุ่มกิจการ (Holding) ถูกกำหนดตามโทเคน
  • ระบุ companyCode สำหรับบริษัทเดียว หรือ companyCodes เพื่ออ่านหลายบริษัท (เฉพาะโทเคนอ่านอย่างเดียว)
  • ยอดหลายบริษัทแสดงแยกกัน ไม่รวมเป็นงบการเงินรวม
  • ข้อจำกัดสิทธิ์ระดับสาขาที่กำหนดไว้ยังมีผลเหมือนเดิม

ข้อควรรู้ก่อนเชื่อมต่อ

  • เชื่อมผ่าน HTTP แบบ JSON-RPC ตามมาตรฐาน MCP
  • ยืนยันตัวตนด้วย header Authorization: Bearer ตามด้วยโทเคน
  • header Accept ต้องมีทั้ง application/json และ text/event-stream
  • เริ่มจากโทเคนอ่านอย่างเดียว แล้วเปิดอ่าน-เขียนเฉพาะงานที่จำเป็น

ตัวอย่างการตั้งค่าโปรแกรมที่รองรับ MCP (รูปแบบจริงขึ้นกับแต่ละโปรแกรม)

{
 "mcpServers": {
 "bc-ai-account-gl": {
 "type": "http",
 "url": "MCP_URL",
 "headers": {
 "Authorization": "Bearer MCP_TOKEN"
 }
 }
 }
}

โครงสร้างข้อมูล

โครงสร้างข้อมูลหลักที่ควรรู้

ข้อมูลแยกตามกลุ่มกิจการ บริษัท และสาขา หน้าจอโปรแกรมรองรับภาษาไทยและภาษาอังกฤษ

กลุ่มกิจการ บริษัท และสาขา

ข้อมูลทั้งหมดอยู่ภายใต้กลุ่มกิจการ (Holding) ซึ่งมีได้หลายบริษัท และแต่ละบริษัทมีได้หลายสาขา

  • สิทธิ์ผู้ใช้กำหนดรายเมนู พร้อมขอบเขตบริษัทและสาขา
  • ระบบตรวจสิทธิ์ทุกครั้งที่เรียกใช้งาน
  • ข้อมูลหลายบริษัทไม่รวมยอดกัน (ไม่มีงบการเงินรวม)

บัญชีแยกประเภท

ผังบัญชีหลายระดับ กลุ่มผังบัญชี สมุดรายวันที่กำหนดเอง ปีบัญชี และงวดบัญชี

  • มิติวิเคราะห์ 6 แบบ: แผนก โครงการ การจัดสรร งาน หน่วยงาน ฝ่าย
  • รายการรายวันต้องมียอดเดบิตเท่ากับเครดิต
  • ผ่านรายการ ยกเลิกผ่านรายการ และปิดงวด เป็นคำสั่งแยกต่างหาก

ลูกหนี้ เจ้าหนี้ และเอกสาร

ทะเบียนลูกหนี้/เจ้าหนี้ เอกสารขาย เอกสารซื้อ และการรับ-จ่ายชำระ เชื่อมกับบัญชีแยกประเภท

  • ยอดคงค้างและอายุลูกหนี้ / เจ้าหนี้
  • ใบวางบิล ใบเสร็จรับเงิน ใบรับวางบิล และการจ่ายชำระหนี้
  • เงื่อนไขชำระเงินและสาเหตุลด/เพิ่มหนี้ตั้งค่าได้

สินค้าและคลัง

ข้อมูลสินค้า บาร์โค้ดต่อสินค้า/หน่วย กลุ่ม ยี่ห้อ และหลายคลัง

  • รับเข้า เบิกใช้ และรับคืน
  • พิมพ์ป้ายราคาติดชั้นวาง (EAN-13)

หลักการข้อมูลพื้นฐาน

  • จำนวนเงินเป็นทศนิยมแม่นยำ ไม่ใช้ float
  • สกุลเงินตั้งค่าได้ในระบบ
  • เก็บประวัติการใช้งานและการแก้ไขเอกสาร (Audit Log)

Architecture & Reference

สถาปัตยกรรมและข้อกำหนดโดยสรุป

Go + PostgreSQL

ระบบหลังบ้านพัฒนาด้วยภาษา Go และใช้ฐานข้อมูล PostgreSQL

ธุรกรรมบัญชีแบบ ACID

การบันทึกบัญชีแต่ละครั้งสำเร็จทั้งชุดหรือไม่บันทึกเลย ไม่มีรายการค้างครึ่งทาง

ตรวจสิทธิ์ทุกคำขอ

สิทธิ์รายเมนูและขอบเขตบริษัท/สาขาถูกตรวจทุกครั้งที่เรียกใช้งาน ทั้งจากหน้าจอและ API

เส้นทางข้อมูล

ระบบของคุณ / ผู้ช่วย AI → REST API หรือ MCP → ตรวจสิทธิ์ → ตรวจความถูกต้อง → บันทึกลงฐานข้อมูล

การบันทึกผ่าน MCP ใช้กฎตรวจความถูกต้องชุดเดียวกับหน้าจอ

รหัสรายงานของ gl_report

reportรายงาน
ledgerบัญชีแยกประเภท
trialbalanceงบทดลอง
pnlงบกำไรขาดทุน
balancesheetงบฐานะการเงิน
ar-outstandingยอดคงค้างลูกหนี้
ap-outstandingยอดคงค้างเจ้าหนี้
bank-unmatchedรายการ Statement ธนาคารที่ยังไม่จับคู่

ระบุวันที่ ณ วันสิ้นสุดของรายงานด้วย query.to

ประเภทสมุดรายวัน (booktype)

booktypeความหมาย
1สมุดรายวันทั่วไป
2สมุดรายวันจ่าย
3สมุดรายวันรับ
4สมุดรายวันขาย
5สมุดรายวันซื้อ
6ยอดยกมา

สมุดรายวันที่ถูกใช้แล้วลบไม่ได้ ให้ปิดใช้งานแทน และเปลี่ยนรหัสหรือประเภทไม่ได้

กันบันทึกซ้ำและกันเขียนทับ

  • ทุกคำสั่งเขียนต้องมี requestid แบบ UUID ที่ไม่ซ้ำ
  • การแก้ไขต้องส่ง version ล่าสุด เพื่อกันเขียนทับข้อมูลที่ผู้อื่นแก้ไปแล้ว
  • รายการนำเข้าระบุ source_type, source_system และ source_record_id เพื่อกันนำเข้าเอกสารต้นทางซ้ำ

บรรทัดบัญชีของรายการที่ผ่านรายการแล้วแก้ทับไม่ได้

รูปแบบรหัส

ข้อมูลความยาวสูงสุด
เลขที่เอกสาร30 ตัวอักษร
รหัสบัญชี20 ตัวอักษร
รหัสสมุดรายวัน15 ตัวอักษร

ใช้อักษรไทย สระ วรรณยุกต์ ตัวเลข และ _ . - / # ( ) : ได้ แต่ห้ามมีช่องว่าง

จำนวนเงิน

  • ส่งจำนวนเงินเป็นสตริงทศนิยม เช่น "1250.50" ไม่ใช้ตัวเลขทศนิยมแบบ float
  • รายการรายวันต้องมียอดเดบิตเท่ากับเครดิตก่อนบันทึก

REST API

ทุกฟังก์ชันในโปรแกรมมี REST API ทั้งงานบัญชี ภาษี ซื้อ ขาย ลูกหนี้ เจ้าหนี้ เงินสดและธนาคาร คลังสินค้า และสินทรัพย์ถาวร

สอบถามเอกสาร API และวิธียืนยันตัวตนสำหรับระบบภายนอกได้จากทีมพัฒนา

ต้นทุนสินค้า

ต้นทุนสินค้าคำนวณแบบถัวเฉลี่ย (weighted average) อย่างเดียว

  • ดูยอดคงเหลือตามสินค้าและตามคลังได้

ทำไมต้องเชื่อมต่อกับ BC Ai

มาตรฐานเปิด

REST API รับส่งข้อมูล JSON และ MCP ตามมาตรฐานเปิด ใช้ได้กับทุกภาษาโปรแกรม

กฎเดียวกับหน้าจอ

รายการบัญชีที่ส่งผ่าน MCP ผ่านการตรวจความถูกต้องเดียวกับการบันทึกบนหน้าจอ

เริ่มจากสิทธิ์ขั้นต่ำ

เริ่มด้วยโทเคนอ่านอย่างเดียว ระบุเฉพาะบริษัทที่ต้องใช้ แล้วค่อยขยายสิทธิ์เมื่อจำเป็น

รองรับ MCP + AI

ผู้ช่วย AI ที่รองรับ MCP ทำงานกับบัญชีแยกประเภทได้ตามสิทธิ์ของโทเคน

ตัวอย่างการใช้งาน

ตัวอย่างการเชื่อมต่อ

แนวทางเชื่อมระบบที่มีอยู่ของคุณกับ BC Ai Account ผ่าน REST API และ MCP

ระบบเดิมของคุณ → บัญชีแยกประเภท

ส่งรายการบัญชีจากระบบเดิมเข้าเป็นรายการรายวัน ระบุแหล่งที่มากันนำเข้าซ้ำ แล้วให้นักบัญชีตรวจและผ่านรายการเอง

ผู้ช่วย AI → รายงานบัญชี

ผู้บริหารถามงบกำไรขาดทุนหรือยอดลูกหนี้ค้างชำระผ่านผู้ช่วย AI โดยใช้โทเคนอ่านอย่างเดียว

ระบบภายในของกิจการ → คลังสินค้า

ดึงยอดคงเหลือตามสินค้าและคลังจาก BC Ai Account ไปแสดงในระบบภายในผ่าน REST API

เว็บหรือแอปของคุณเอง → ระบบขาย

สร้างหน้าจอของคุณเอง แล้วส่งเอกสารขายเข้า BC Ai Account ผ่าน REST API

พร้อมเชื่อมต่อแล้วหรือยัง?

สอบถามทีมพัฒนาเพื่อรับเอกสาร API ที่อยู่ MCP endpoint และคำแนะนำการตั้งสิทธิ์โทเคนสำหรับกิจการของคุณ

สอบถามสิทธิ์เชื่อมต่อ ปรึกษาทีมงาน