Tạo mẫu D02-LT, TK1-TS online

Sinh mẫu D02-LT (danh sách tham gia) và TK1-TS (tờ khai) theo QĐ 366/QĐ-BHXH dạng Excel, kèm kiểm tra lỗi từng dòng.

Kết quả

Bấm “Chạy” để xem kết quả.

Gửi danh sách từ phần mềm nhân sự (JSON hoặc file CSV / XLSX), API trả file Excel trình bày như mẫu ban hành kèm QĐ 366/QĐ-BHXH (29/4/2026, hiệu lực 1/5/2026, thay QĐ 595): form=d02-lt tạo "Danh sách tham gia, điều chỉnh đóng BHXH, BHYT, BHTN" đủ 21 cột (tiền lương, phụ cấp, loại HĐLĐ, từ tháng / đến tháng, nơi KCB ban đầu, loại tăng giảm…) với dòng tiêu đề gộp ô; form=tk1-ts tạo mỗi người một sheet "Tờ khai đăng ký, điều chỉnh thông tin tham gia BHXH, BHYT" gồm các chỉ tiêu [01] đến [17].

Từng dòng được kiểm tra: mã số BHXH 10 chữ số, số định danh cá nhân 12 chữ số, ngày tháng hợp lệ (DD/MM/YYYY), khoảng tháng, mã loại tăng giảm (TM, ON, TC, TD, GH, KL, TS, OF, DC…), tiền lương cộng phụ cấp không thấp hơn lương tối thiểu vùng của đơn vị (unit.region hoặc mã phường xã, NĐ 293/2025/NĐ-CP) và cảnh báo khi vượt trần 20 lần lương cơ sở. format=json trả lỗi theo dòng và trường (kèm file base64); strict=true từ chối tạo file khi còn lỗi (422).

Mẫu D02-TS không còn trong QĐ 366 (danh sách hộ gia đình chuyển sang NĐ 188/2025/NĐ-CP). Bố cục cột theo mẫu kèm QĐ 366 do các đơn vị I-VAN công bố, vì bản scan chính thức chỉ liệt kê danh mục mẫu; hãy kiểm tra thêm yêu cầu của cơ quan BHXH địa phương.

Dùng trong code của bạn

curl -X POST "https://apibox.io.vn/v1/vn-bhxh-forms" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"form":"d02-lt","format":"json","include_file":false,"unit":{"name":"Công ty TNHH Ví Dụ","code":"TA1234A","region":1},"rows":[{"name":"Nguyễn Văn An","id_number":"001090012345","birth_date":"15/03/1990","position":"Kế toán viên","salary":8000000,"contract_type":"fixed","contract_date":"01/11/2026","from_month":"11/2026","change_type":"TM"},{"name":"Trần Thị Bình","bhxh_code":"7912345678","birth_date":"20/05/1995","salary":4000000,"from_month":"11/2026","change_type":"DC"}]}'

const res = await fetch('https://apibox.io.vn/v1/vn-bhxh-forms', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "form": "d02-lt",
    "format": "json",
    "include_file": false,
    "unit": {
      "name": "Công ty TNHH Ví Dụ",
      "code": "TA1234A",
      "region": 1
    },
    "rows": [
      {
        "name": "Nguyễn Văn An",
        "id_number": "001090012345",
        "birth_date": "15/03/1990",
        "position": "Kế toán viên",
        "salary": 8000000,
        "contract_type": "fixed",
        "contract_date": "01/11/2026",
        "from_month": "11/2026",
        "change_type": "TM"
      },
      {
        "name": "Trần Thị Bình",
        "bhxh_code": "7912345678",
        "birth_date": "20/05/1995",
        "salary": 4000000,
        "from_month": "11/2026",
        "change_type": "DC"
      }
    ]
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-bhxh-forms",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"form": "d02-lt", "format": "json", "include_file": False, "unit": {"name": "Công ty TNHH Ví Dụ", "code": "TA1234A", "region": 1}, "rows": [{"name": "Nguyễn Văn An", "id_number": "001090012345", "birth_date": "15/03/1990", "position": "Kế toán viên", "salary": 8000000, "contract_type": "fixed", "contract_date": "01/11/2026", "from_month": "11/2026", "change_type": "TM"}, {"name": "Trần Thị Bình", "bhxh_code": "7912345678", "birth_date": "20/05/1995", "salary": 4000000, "from_month": "11/2026", "change_type": "DC"}]},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-bhxh-forms');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"form":"d02-lt","format":"json","include_file":false,"unit":{"name":"Công ty TNHH Ví Dụ","code":"TA1234A","region":1},"rows":[{"name":"Nguyễn Văn An","id_number":"001090012345","birth_date":"15/03/1990","position":"Kế toán viên","salary":8000000,"contract_type":"fixed","contract_date":"01/11/2026","from_month":"11/2026","change_type":"TM"},{"name":"Trần Thị Bình","bhxh_code":"7912345678","birth_date":"20/05/1995","salary":4000000,"from_month":"11/2026","change_type":"DC"}]}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Tài liệu API → Nhận API key miễn phí

Hỏi đáp

API dùng mẫu theo văn bản nào?

QĐ 366/QĐ-BHXH ngày 29/4/2026, hiệu lực từ 1/5/2026, thay thế QĐ 595/QĐ-BHXH và các quyết định sửa đổi.

File có nhập thẳng vào phần mềm BHXH được không?

File theo mẫu giấy. Phần mềm I-VAN có định dạng nhập riêng, nên hãy dùng để in hoặc làm nguồn nhập liệu.

Lương tối thiểu vùng được kiểm tra thế nào?

Tiền lương cộng phụ cấp chức vụ và phụ cấp khác phải từ mức lương tối thiểu vùng của đơn vị tại ngày lập; truyền unit.region (1–4) hoặc unit.ward_code.