Attachment PND91 (ใบแนบ ภงด.91)

ดึงรายงานใบแนบ ภ.ง.ด.91 สำหรับพนักงาน สรุปข้อมูลรายได้และภาษีที่เกี่ยวข้อง โดยระบุเดือนและปีของรายงาน พร้อมรองรับการส่งออกในรูปแบบ JSON, Excel และ PDF

Endpoint


POST /api/v1/open-apis/report/attachment-pnd91?path_action=attachment_pnd91

Request Parameters

Query Parameter

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

Request Body (JSON)

Parameter	Type	Required	Description	Example
`authorize_id`	string	Yes	รหัสผู้เรียก (employee_code ของผู้ขอสิทธิ์)	`"EMP001"`
`year`	string	Yes	ปีของรายงาน (YYYY)	`"2026"`
`month`	string	Yes	เดือนของรายงาน (MM)	`"03"`
`type`	string	No	รูปแบบผลลัพธ์: `json`, `excel`, `pdf1` (default: `json`)	`"pdf1"`
`filename`	string	No	ชื่อไฟล์ที่ส่งออก (ใช้กับ `excel`/`pdf1`)	`"ใบแนบ_ภงด91.pdf"`
`company_lists`	array	No	กรองตามบริษัท (id แบบ base64)	`[{"id":"Q09NUDAwMDE="}]`
`branch_lists`	array	No	กรองตามสาขา	`[{"id":"QlJBTkNIMDAx"}]`
`department_lists`	array	No	กรองตามแผนก	-
`employee_lists`	array	No	ระบุพนักงานเฉพาะเจาะจง (id แบบ base64)	`[{"id":"RU1QMDAxLTAwMQ=="}]`
`force_path`	string	No	ระบุ `"Y"` เพื่อดึงเฉพาะพนักงานใน `employee_lists` โดยไม่สนใจเดือน/ปี	`"Y"`

ถ้าไม่ระบุ employee_lists ระบบจะดึงพนักงานทั้งหมดตาม scope ที่กำหนด
กรองระดับใดระบบจะใช้งานระดับนั้นสูงสุด
force_path: "Y" ใช้สำหรับกรณีโอนย้าย — ระบบจะข้ามเงื่อนไขเดือน/ปี และดึงข้อมูลของพนักงานใน employee_lists เท่านั้น (จำเป็นต้องระบุ employee_lists)

Example Request Body


{
  "authorize_id": "EMP001",
  "year": "2026",
  "month": "03",
  "type": "json",
  "branch_lists": [
    { "id": "QlJBTkNIMDAxMjM0NTY3OA==" }
  ]
}

Response Format

JSON Response (type: json)


{
  "code": 200,
  "message": "Success",
  "payload": {
    "column": [
      "ลำดับ",
      "เลขที่ประจำตัวผู้เสียภาษี",
      "พาสปอร์ต/ใบอนุญาตทำงาน",
      "ชื่อ-นามสกุลพนักงาน",
      "เงินได้",
      "ภาษี"
    ],
    "row": [
      [
        { "value": 1, "colspan": 1, "align": "center" },
        { "value": "1234567890123", "colspan": 1, "align": "left" },
        { "value": "", "colspan": 1, "align": "left" },
        { "value": "นาย ทดสอบ ระบบ", "colspan": 1, "align": "left" },
        { "value": "10000.00", "colspan": 1, "align": "right" },
        { "value": "500.00", "colspan": 1, "align": "right" }
      ]
    ],
    "footer": [
      { "value": "รวม", "colspan": 4, "align": "center" },
      { "value": "10000.00", "colspan": 1, "align": "right" },
      { "value": "500.00", "colspan": 1, "align": "right" }
    ]
  }
}

PDF/Excel Response (type: pdf1 / excel)

Response จะเป็น file binary ใช้ --output ใน cURL เพื่อบันทึกไฟล์


HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="report.pdf"

Response Fields

Field	Type	Description
`code`	integer	HTTP Status Code (`200` = สำเร็จ)
`message`	string	ข้อความสถานะ
`payload.column`	array	หัวตารางสำหรับแสดงผล
`payload.row`	array	รายการข้อมูลพนักงานและยอดการหักภาษี (array 2 มิติ พร้อม `colspan`/`align`)
`payload.footer`	array	แถวสรุปยอดรวม

Error Response


{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'authorize_id'"
  ]
}

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

เงินชดเชยการเลิกจ้าง: กรณีพนักงานถูกเลิกจ้าง เงินชดเชยส่วนที่เกิน 600,000 บาท จะถูกนำมาคำนวณภาษี (ส่วนที่ไม่เกิน 600,000 บาทจะถูกยกเว้น)

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/report/attachment-pnd91?path_action=attachment_pnd91" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "authorize_id": "EMP001",
    "year": "2026",
    "month": "03",
    "type": "pdf1",
    "employee_lists": [
      { "id": "RU1QMDAxLTAwMQ==" }
    ],
    "filename": "ใบแนบ_ภงด91_2026_03.pdf"
  }' \
  --output report.pdf

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/report/attachment-pnd91?path_action=attachment_pnd91',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      authorize_id: 'EMP001',
      year: '2026',
      month: '03',
      type: 'json',
      branch_lists: [{ id: 'QlJBTkNIMDAxMjM0NTY3OA==' }]
    })
  }
)
const data = await response.json()
console.log(data.payload.row)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/report/attachment-pnd91"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {"path_action": "attachment_pnd91"}
payload = {
    "authorize_id": "EMP001",
    "year": "2026",
    "month": "03",
    "type": "json",
    "branch_lists": [{"id": "QlJBTkNIMDAxMjM0NTY3OA=="}]
}
 
response = requests.post(url, headers=headers, params=params, json=payload)
data = response.json()
print(data["payload"]["row"])

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/report/attachment-pnd91?path_action=attachment_pnd91";
$data = json_encode([
    "authorize_id" => "EMP001",
    "year" => "2026",
    "month" => "03",
    "type" => "json",
    "branch_lists" => [["id" => "QlJBTkNIMDAxMjM0NTY3OA=="]]
]);
 
$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 91 (50ทวิ / ภงด.91) - หนังสือรับรองการหักภาษี ณ ที่จ่าย (50ทวิ) รายบุคคล