เชื่อมระบบของคุณเข้ากับ BC Ai ได้ทันที

ขั้นตอนทดสอบการเชื่อมต่อ

AI ที่รองรับ MCP

ตัวอย่าง — สั่งงาน Claude Desktop ด้วยภาษาธรรมดา

คุณ:

"ยอดขายเดือนนี้เท่าไหร่? เทียบกับเดือนที่แล้วเป็นยังไง?"

Claude:

ยอดขายเดือนนี้ ฿847,200 เพิ่มขึ้น 12.3% จากเดือนที่แล้ว (฿754,100)

สินค้าขายดีสุด 3 อันดับ:

1. สินค้า A — ฿234,000 (28%)
2. สินค้า B — ฿189,500 (22%)
3. สินค้า C — ฿156,200 (18%)

ข้อมูลจาก BC Ai ผ่าน MCP บน Claude Desktop — ประมวลผลบนเครื่องคุณ อัปเดตล่าสุด 5 นาทีที่แล้ว

JavaScript

// สร้างรายการขายใหม่ — แค่ไม่กี่บรรทัด
const response = await fetch('https://api.bcaccount.com/v1/sales', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    items: [
      { product_id: 'SKU-001', qty: 2, price: 590 },
      { product_id: 'SKU-042', qty: 1, price: 1290 },
    ],
    payment_method: 'promptpay',
    branch_id: 'BRANCH-01',
  }),
});

const result = await response.json();
console.log(result.transaction_id);
// => "TXN-20250214-0001"

Python

# สร้างรายการขายใหม่ — แค่ไม่กี่บรรทัด
import requests

response = requests.post(
    "https://api.bcaccount.com/v1/sales",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "items": [
            {"product_id": "SKU-001", "qty": "2.0000", "price": "590.00"},
            {"product_id": "SKU-042", "qty": "1.0000", "price": "1290.00"},
        ],
        "payment_method": "promptpay",
        "branch_id": "BRANCH-01",
    },
)

result = response.json()
print(result["transaction_id"])
# => "TXN-20250214-0001"

PHP

<?php
// สร้างรายการขายใหม่ — แค่ไม่กี่บรรทัด
$ch = curl_init('https://api.bcaccount.com/v1/sales');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'items' => [
            ['product_id' => 'SKU-001', 'qty' => 2, 'price' => 590],
            ['product_id' => 'SKU-042', 'qty' => 1, 'price' => 1290],
        ],
        'payment_method' => 'promptpay',
        'branch_id' => 'BRANCH-01',
    ]),
]);
$result = json_decode(curl_exec($ch), true);
echo $result['transaction_id'];
// => "TXN-20250214-0001"

Transaction — เอกสารซื้อ/ขาย/โอน/ปรับ

หัวใจหลักของระบบ ทุกประเภทใช้โครงสร้างเดียวกัน (transflag ระบุประเภท)

TransactionHeader transactionSaleInvoice, transactionPurchase, ...

Detail (รายการสินค้า)

PaymentDetail

• cashamount — จำนวนเงินสด
• paymentcreditcards — บัตรเครดิต [{cardnumber, amount, chargevalue}]
• paymenttransfers — โอนเงิน [{bankcode, banknames, accountnumber, amount}]

Product — สินค้า, Barcode, หน่วยนับ, BOM

รองรับ Multi-unit conversion (ชิ้น → แพ็ค → ลัง)

ProductBarcode productBarcode

BOM (Bill of Materials)

• code — รหัส BOM
• productcode — รหัสสินค้าผลิต
• qty — จำนวนที่ผลิตได้
• materials — วัตถุดิบ [{itemcode, barcode, qty, whcode}]

Party — ลูกหนี้, เจ้าหนี้, สมาชิก

Debtor (ลูกหนี้/ลูกค้า) debtorMaster

Member memberMaster

• pointbalance — แต้มคงเหลือ
• tiercode — ระดับสมาชิก
• telephone / birthday — เบอร์โทร / วันเกิด

Organization — สาขา, แผนก, คลัง, พนักงาน

Branch branchMaster

• base_currency — สกุลเงินหลัก (THB, USD, VND, ...)
• timezone — Timezone (Asia/Bangkok, ...)
• decimal_price — ทศนิยมราคา (2-8)

Warehouse warehouseMaster

• locations — ตำแหน่งจัดเก็บ [{code, names}]

Base Models — โครงสร้างพื้นฐาน

Identity

• shopid — รหัสร้าน (= database name)
• guidfixed — UUID ของเอกสาร (primary key)

NameX (Multi-language)

• code — รหัสภาษา: th, en, vi, lo, km, my, cn, ja, ko
• name — ชื่อในภาษานั้น

Activity (Audit Trail)

• createdby / createdat — ผู้สร้าง / วันเวลาสร้าง
• updatedby / updatedat — ผู้แก้ไข / วันเวลาแก้ไข
• deletedby / deletedat — ผู้ลบ / วันเวลาลบ

ApiResponse

• success (bool) / message / data / pagination