Tax Audit Report (ภงด.1ก ตรวจสอบ)

ดึงรายงานตรวจสอบภาษีประจำปี (ภงด.1ก) แบบ Matrix สรุปยอด 12 เดือนต่อพนักงาน พร้อมแจกแจงรายได้และรายหักที่นำมาคิดภาษี รองรับผลลัพธ์แบบ JSON (ตาราง) และ Excel

Endpoint


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

Request Parameters

Query Parameter

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

Request Body (JSON)

Required

Parameter	Type	Required	Description	Example
`authorize_id`	string	Yes	รหัสผู้เรียก API	`"EMP001"`
`year`	string	Yes	ปีภาษี รูปแบบ `YYYY` (ค.ศ.)	`"2026"`

Output

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

Filter & Scope

Parameter	Type	Description
`company_lists`	array	กรองตามบริษัท (array ของ `{id}` โดย `id` เป็น base64)
`branch_lists`	array	กรองตามสาขา
`department_lists`	array	กรองตามแผนก
`division_lists`	array	กรองตามฝ่าย
`section_lists`	array	กรองตามแผนกย่อย
`section_lists_lv01` — `section_lists_lv05`	array	กรองตามระดับแผนกย่อยแบบลำดับชั้น
`force_path`	boolean	ถ้า `true` จะบังคับแสดงพนักงานคนเดียวจาก `employee_lists[0]`
`employee_lists`	array	รายการพนักงาน (ใช้ร่วมกับ `force_path=true`)

Pagination

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

*_lists ทุกตัวต้องเป็น array ของ object {"id": "<base64>"}
เมื่อใช้ force_path: true ต้องมี employee_lists อย่างน้อยหนึ่งคน จะช่วยให้ query เร็วขึ้นเมื่อดึงข้อมูลรายบุคคล
รายงานนี้รวมยอดทั้ง 12 เดือน ควรใช้ pagination เมื่อมีพนักงานจำนวนมากเพื่อลดเวลาตอบสนอง

Example Request Body


{
  "authorize_id": "EMP001",
  "year": "2026",
  "type": "json",
  "_PAGE": 1,
  "_NUMBER_PER_PAGE": 15
}

Response Format

JSON Response (`type: json`)


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

Response Fields

Field	Type	Description
`column`	array	หัวตารางสรุปยอดรวมตลอดปี
`row`	array	ข้อมูลแถว แต่ละคอลัมน์เป็น object `{ value, colspan, align, type }`
`_PAGINATION`	object	ข้อมูลการแบ่งหน้า

Excel Response (`type: excel`)

ผลลัพธ์จะถูกส่งกลับเป็นไฟล์ Excel (.xlsx) สามารถดาวน์โหลดตรงผ่าน request ได้เลย ไม่ใช่ JSON Payload

Error Response


{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "'year' must be in YYYY format (e.g., 2026)"
  ]
}

HTTP Status	Description
`400`	พารามิเตอร์ไม่ถูกต้อง (`year`, `type`, `force_path` เป็นต้น)
`401`	API Key ไม่ถูกต้องหรือไม่ได้ส่ง
`403`	ไม่มีสิทธิ์เรียกใช้งาน
`500`	เกิดข้อผิดพลาดภายใน

Code Examples

cURL


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

JavaScript


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

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/report/tax-audit"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {"path_action": "tax_audit"}
payload = {
    "authorize_id": "EMP001",
    "year": "2026",
    "type": "json",
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 15
}
 
response = requests.post(url, headers=headers, params=params, json=payload)
data = response.json()
print(data["payload"]["column"])

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/report/tax-audit?path_action=tax_audit";
$data = json_encode([
    "authorize_id" => "EMP001",
    "year" => "2026",
    "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);
print_r($result["payload"]);
?>

Tax Year Annual (ภงด.1ก) - รายงานภาษีประจำปีสำหรับส่งสรรพากร (JSON/Excel/PDF/Text)
Get Monthly Tax Report - รายงานภาษีประจำเดือน (ภงด.1)