ผังบัญชี

ผังบัญชีคือรายการบัญชีแยกประเภทขององค์กร คุณต้องใช้ทุกครั้งที่มีฟิลด์ขอ accountId เช่น บรรทัดของรายการบัญชี ฟิลด์ accountId ของรายการในเอกสารซื้อ หรือ incomeAccount / expenseAccount ของสินค้า

ผังบัญชีมีขนาดเล็กและเปลี่ยนไม่บ่อย จึงควรดึงมาครั้งเดียวตอนเริ่มระบบแล้วเก็บไว้ใช้

อ่านรายการบัญชี

GET /chart-of-accounts → อาร์เรย์ธรรมดา ใน data ไม่แบ่งหน้า

curl -X GET "$ABSERP_API_URL/openapi/v1/chart-of-accounts?accountType=EXPENSE&isActive=true" \
  -H "Authorization: Bearer $ABSERP_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": 63,
      "code": "5810",
      "name": "ค่าเสื่อมราคา",
      "accountType": "EXPENSE",
      "accountSubtype": "operating_expense",
      "cashFlowCategory": "operating",
      "parentId": null,
      "isSystem": true,
      "isActive": true,
      "createdAt": 1735689600,
      "updatedAt": null
    }
  ]
}

ควรจับคู่ด้วย code ไม่ใช่ name เพราะชื่อมีการแก้และมีการแปลภาษา แต่รหัสไม่เปลี่ยน แล้วจึงนำ id ไปใช้ใน request

ผังบัญชีอ่านได้เท่านั้น

POST /chart-of-accounts, PATCH /chart-of-accounts/{id} และ DELETE /chart-of-accounts/{id} ไม่เปิดให้ใช้ผ่าน Open API (ใช้ได้ในเว็บแอปเท่านั้น) สิ่งที่เปิดให้ใช้คือ GET /chart-of-accounts เท่านั้น เพราะระบบที่เชื่อมต่อมีหน้าที่ลงบัญชี เข้า ผังบัญชี ไม่ใช่ออกแบบผังบัญชี

ในทางปฏิบัติแทบไม่เป็นข้อจำกัด เพราะการเพิ่มบัญชีเป็นการตัดสินใจของผู้ดูแลบัญชี ไม่ใช่ของระบบที่เชื่อมต่อ ควรอ่านผังบัญชีที่มีอยู่ ไม่ควรสร้างขึ้นเอง

หากยังไม่มีบัญชีที่ต้องใช้ ให้แจ้งองค์กรเพิ่มใน ABSERP (บัญชี → ผังบัญชี) แล้วดึง id มาจาก GET /chart-of-accounts และสองเรื่องที่ควรบอกไปด้วยคือ ควรตั้งรหัสใหม่ให้อยู่ในช่วงเดียวกับประเภทนั้น (ในผังบัญชีไทยมาตรฐาน สินทรัพย์อยู่ช่วง 1000 รายได้ช่วง 4000 ค่าใช้จ่ายช่วง 5000) เพื่อให้งบการเงินจัดกลุ่มตรงตามที่นักบัญชีคาดหวัง และบัญชีที่มีประวัติแล้วควรปิดใช้งานแทนการลบ

ขั้นตอนถัดไป

อ่านต่อที่ ข้อมูลองค์กร