Tax Month Audit Report

ดึงรายงานตรวจสอบภาษีประจำเดือน (ภ.ง.ด.1) แสดงรายละเอียดรายพนักงานสำหรับงวดที่ระบุ เพื่อใช้ตรวจสอบความถูกต้องของรายได้ รายจ่าย และภาษีก่อนยืนยันแบบฟอร์มภงด.1 รองรับผลลัพธ์เป็น JSON และ Excel พร้อม pagination และโหมดเรียกดูเฉพาะพนักงานรายบุคคล

Endpoint


POST /api/v1/open-apis/report/tax-month-audit?path_action=tax_month_audit

Request Parameters

Query Parameter

Parameter	Type	Required	Description	Example
`path_action`	string	Yes	ระบุเป็น `tax_month_audit`	`"tax_month_audit"`

Request Body (JSON)

Required

Parameter	Type	Required	Description	Example
`authorize_id`	string	Yes	รหัสผู้เรียก API	`"EMP001"`
`year_month`	string	Yes	งวดเดือน (YYYY-MM)	`"2026-01"`

Output Parameters

Parameter	Type	Default	Description	Example
`type`	string	`json`	รูปแบบผลลัพธ์: `json` หรือ `excel`	`"json"`

Filter Parameters

Parameter	Type	Description	Example
`company_lists`	array	กรองบริษัท (id เป็น base64)	`[{"id":"Q09NUDAwMDE="}]`
`branch_lists`	array	กรองสาขา	`[{"id":"QlJBTkNIMDAx"}]`
`department_lists`	array	กรองแผนก	-
`division_lists`	array	กรองฝ่าย	-
`section_lists`	array	กรองแผนกย่อย	-
`section_lists_lv01` – `section_lists_lv05`	array	กรองระดับแผนกย่อยแบบลำดับชั้น	-

Single Employee Mode

Parameter	Type	Description
`force_path`	boolean	ถ้า `true` จะบังคับดึงข้อมูลพนักงานรายเดียวตาม `employee_lists[0]`
`employee_lists`	array	ใช้คู่กับ `force_path` ต้องมี `id` (base64) ของพนักงานเป้าหมาย

Pagination

Parameter	Type	Default	Description
`_PAGE`	integer	`1`	หน้าปัจจุบัน
`_NUMBER_PER_PAGE`	integer	ทั้งหมด	จำนวนพนักงานต่อหน้า

ค่า id ใน *_lists ทุกตัวต้องเป็น base64 encoded string เช่น EMP00123 → RU1QMDAxMjM=

Option Values

type

Value	Description
`json`	ตารางข้อมูล JSON (column/row)
`excel`	ดาวน์โหลดไฟล์ Excel (.xlsx)

Response Format

Success Response (JSON)


{
  "code": 200,
  "message": "Success",
  "payload": {
    "column": [
      "ลำดับ",
      "รหัสพนักงาน",
      "ชื่อ-นามสกุล",
      "เลขประจำตัวประชาชน/พาสปอร์ต",
      "วันเริ่มงาน",
      "วันลาออก",
      "เงินเดือนที่แสดงในสลิป"
    ],
    "row": [
      [
        { "value": 1, "colspan": 1, "align": "center" },
        { "value": "EMP001", "colspan": 1, "align": "center" },
        { "value": "นาย ทดสอบ ระบบ", "colspan": 1, "align": "left" }
      ]
    ]
  },
  "_PAGINATION": {
    "_TOTAL_RECORDS": 120,
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 15
  }
}

Response Fields

Field	Type	Description
`code`	integer	HTTP status code
`message`	string	ข้อความผลลัพธ์
`payload.column`	array	ชื่อคอลัมน์ของตาราง
`payload.row`	array	แถวข้อมูล (array ของ cell object)
`_PAGINATION._TOTAL_RECORDS`	integer	จำนวนพนักงานทั้งหมดที่ตรงเงื่อนไข
`_PAGINATION._PAGE`	integer	หน้าปัจจุบัน
`_PAGINATION._NUMBER_PER_PAGE`	integer	จำนวนพนักงานต่อหน้า

Excel Response

เมื่อระบุ type: "excel" ระบบจะส่งไฟล์ .xlsx กลับโดยตรง (binary download) ไม่ได้ห่อหุ้มด้วย JSON

Error Response


{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'year_month'",
    "'year_month' must be in YYYY-MM format (e.g., 2026-01)"
  ]
}

HTTP Status	Description
`400`	พารามิเตอร์ไม่ถูกต้อง
`401`	API Key ไม่ถูกต้องหรือไม่ได้ส่ง
`403`	ไม่มีสิทธิ์เข้าถึงรายงาน
`500`	เกิดข้อผิดพลาดภายในเซิร์ฟเวอร์

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/report/tax-month-audit?path_action=tax_month_audit" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "authorize_id": "EMP001",
    "year_month": "2026-01",
    "type": "json",
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 15
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/report/tax-month-audit?path_action=tax_month_audit',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      authorize_id: 'EMP001',
      year_month: '2026-01',
      type: 'json',
      _PAGE: 1,
      _NUMBER_PER_PAGE: 15
    })
  }
)
const data = await response.json()
console.log(`Total records: ${data._PAGINATION._TOTAL_RECORDS}`)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/report/tax-month-audit"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {"path_action": "tax_month_audit"}
payload = {
    "authorize_id": "EMP001",
    "year_month": "2026-01",
    "type": "json",
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 15
}
 
response = requests.post(url, headers=headers, params=params, json=payload)
data = response.json()
print(f"Total records: {data['_PAGINATION']['_TOTAL_RECORDS']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/report/tax-month-audit?path_action=tax_month_audit";
$data = json_encode([
    "authorize_id" => "EMP001",
    "year_month" => "2026-01",
    "type" => "json",
    "_PAGE" => 1,
    "_NUMBER_PER_PAGE" => 15
]);
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
echo "Total records: {$result['_PAGINATION']['_TOTAL_RECORDS']}\n";
?>

Tax Month (ภงด.1 Form) - รายงานภาษีประจำเดือนรูปแบบแบบฟอร์ม ภ.ง.ด.1