Kiểm tra thể thức văn bản NĐ 30 API
Kiểm tra file .docx theo Nghị định 30/2020: khổ A4, căn lề, phông Times New Roman, cỡ chữ và kiểu chữ từng thành phần, số trang.
Tải lên văn bản hành chính .docx (quyết định, công văn, thông báo, tờ trình…), API kiểm tra theo Nghị định 30/2020/NĐ-CP, Phụ lục I: khổ A4 chiều dọc, căn lề (trên, dưới 20–25 mm, trái 30–35 mm, phải 15–20 mm), phông Times New Roman, cỡ chữ, đậm, nghiêng, in hoa của từng thành phần: Quốc hiệu (12–13, đậm, in hoa), Tiêu ngữ (13–14, đậm), tên cơ quan chủ quản và cơ quan ban hành, số ký hiệu (13), địa danh ngày tháng (13–14, nghiêng), tên loại văn bản (13–14, đậm, in hoa), trích yếu, dòng "V/v", "Kính gửi", nội dung (13–14, căn đều hai lề, giãn dòng từ đơn đến 1,5, lùi đầu dòng 1–1,27 cm, cách đoạn ≥ 6 pt), chức vụ và họ tên người ký (13–14, đậm), "Nơi nhận" (12, đậm nghiêng) và danh sách (11). API còn kiểm tra số 0 phía trước trong số, ngày tháng và vị trí số trang.
Phông và cỡ chữ được xác định như Word: định dạng trực tiếp, style đoạn và ký tự, mặc định của tài liệu và phông theo theme. Các thành phần được nhận diện bằng heuristic theo nội dung (CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM, "Số:", "…, ngày … tháng … năm …", "Nơi nhận:"…), kể cả trong bảng hai cột ở đầu văn bản; mỗi thành phần có chỉ số đoạn, giá trị đo được và quy định, detection_confidence cảnh báo khi nhận diện được ít thành phần.
Mỗi lỗi có mức độ (error, warning, info) và thông báo tiếng Việt, tiếng Anh. File chỉ được xử lý trong bộ nhớ, không lưu lại. File .doc cũ cần lưu lại thành .docx.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
file | body | file | có | File văn bản .docx (multipart file, body thô hoặc file_base64). |
Ví dụ
curl -X POST "https://apibox.io.vn/v1/vn-nd30-check" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@./my-file"const form = new FormData();
form.append('file', fileInput.files[0]);
const res = await fetch('https://apibox.io.vn/v1/vn-nd30-check', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY' },
body: form,
});
console.log(await res.json());import requests
res = requests.post(
"https://apibox.io.vn/v1/vn-nd30-check",
headers={"Authorization": "Bearer YOUR_API_KEY"},
files={"file": open("my-file", "rb")},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-nd30-check');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
CURLOPT_POSTFIELDS => ['file' => new CURLFile('my-file')],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"page": {
"width_mm": 215.9,
"height_mm": 279.4,
"orientation": "portrait",
"margins_mm": {
"top": 25.4,
"bottom": 25.4,
"left": 25.4,
"right": 25.4
}
},
"fonts": {
"Arial": 574
},
"elements": [
{
"element": "quoc_hieu",
"name_vi": "Quốc hiệu",
"name_en": "National title",
"found": true,
"paragraphs": [
3
],
"text": "CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM",
"measured": {
"size_pt": [
14
],
"bold_share": 1,
"italic_share": 0,
"uppercase": true
},
"required": {
"size_pt": [
12,
13
],
"bold": true,
"italic": false,
"uppercase": true
},
"ok": false,
"issues": [
"size"
]
},
{
"element": "dia_danh_ngay",
"name_vi": "Địa danh và thời điểm ban hành",
"name_en": "Place and date",
"found": true,
"paragraphs": [
5
],
"text": "Bắc Ninh, ngày 5 tháng 2 năm 2026",
"measured": {
"size_pt": [
13
],
"bold_share": 0,
"italic_share": 0,
"uppercase": false
},
"required": {
"size_pt": [
13,
14
],
"italic": true
},
"ok": false,
"issues": [
"italic"
]
},
{
"element": "noi_dung",
"name_vi": "Nội dung",
"name_en": "Body text",
"found": true,
"paragraphs": [
8,
9,
10
],
"text": "Căn cứ Nghị định số 30/2020/NĐ-CP ngày 05 tháng 3 năm 2020 của Chính phủ về công tác văn thư; | Điều 1. Ban hành kèm theo Quyết định này Quy chế làm việc của Sở Tài chính tỉnh Bắc Ninh, áp dụng cho to",
"measured": {
"size_pt": [
12
],
"bold_share": 0,
"italic_share": 0,
"uppercase": false
},
"required": {
"size_pt": [
13,
14
],
"italic": false
},
"ok": false,
"issues": [
"size"
]
}
],
"findings": [
{
"element": "page",
"severity": "error",
"rule": "paper_a4",
"en": "Paper is not A4 (210 × 297 mm): 215.9 × 279.4 mm.",
"vi": "Khổ giấy không phải A4 (210 × 297 mm): 215.9 × 279.4 mm."
},
{
"element": "page",
"severity": "error",
"rule": "margin_top",
"en": "Top margin 25.4 mm; required 20–25 mm.",
"vi": "Lề trên 25.4 mm; quy định 20–25 mm."
},
{
"element": "page",
"severity": "error",
"rule": "margin_bottom",
"en": "Bottom margin 25.4 mm; required 20–25 mm.",
"vi": "Lề dưới 25.4 mm; quy định 20–25 mm."
},
{
"element": "page",
"severity": "error",
"rule": "margin_left",
"en": "Left margin 25.4 mm; required 30–35 mm.",
"vi": "Lề trái 25.4 mm; quy định 30–35 mm."
},
{
"element": "page",
"severity": "error",
"rule": "margin_right",
"en": "Right margin 25.4 mm; required 15–20 mm.",
"vi": "Lề phải 25.4 mm; quy định 15–20 mm."
},
{
"element": "font",
"severity": "error",
"rule": "times_new_roman",
"en": "Font must be Times New Roman (Unicode TCVN 6909:2001). Other fonts used: Arial (574 chars).",
"vi": "Phông chữ phải là Times New Roman (bộ mã Unicode TCVN 6909:2001). Đang dùng phông khác: Arial (574 ký tự)."
},
{
"element": "quoc_hieu",
"severity": "error",
"rule": "font_size",
"en": "National title: font size 14 pt; required 12–13 pt.",
"vi": "Quốc hiệu: cỡ chữ 14; quy định 12–13.",
"paragraph": 3,
"text": "CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM"
}
],
"summary": {
"errors": 8,
"warnings": 4,
"infos": 1,
"elements_found": 13,
"compliant": false,
"detection_confidence": "high"
},
"paragraphs": 17,
"notes": [
"Elements are detected heuristically from text patterns; documents laid out in unusual tables may be mis-detected (see detection_confidence)."
],
"legal": [
{
"ref": "Nghị định 30/2020/NĐ-CP, Phụ lục I và III",
"effective_from": "2020-03-05",
"url": "https://vanban.chinhphu.vn/?pageid=27160&docid=199279"
}
],
"disclaimer": "Reference check, not an official verification; check the official text.",
"reviewed": "2026-11-11"
}
Ứng dụng
- Rà soát văn bản trước khi trình ký, ban hành
- Hướng dẫn văn thư bằng danh sách lỗi thể thức tự động
- Tích hợp kiểm tra thể thức vào phần mềm quản lý văn bản, e-office
- Kiểm tra bộ mẫu văn bản của cơ quan, trường học
Hỏi đáp
Kiểm tra những quy định nào?
Các quy định của Phụ lục I NĐ 30/2020/NĐ-CP đọc được từ file: khổ giấy, chiều trang, lề, phông chữ, cỡ / đậm / nghiêng / in hoa của từng thành phần, căn lề và giãn dòng phần nội dung, số 0 phía trước và số trang. Không kiểm tra câu chữ và vị trí con dấu.
Nhận diện thành phần có chính xác không?
Dựa trên mẫu nội dung, chạy tốt với văn bản soạn từ mẫu chuẩn. Bố cục lạ có thể nhận nhầm; xem detection_confidence và chỉ số đoạn của từng thành phần.
Văn bản của tôi có bị lưu không?
Không. File .docx chỉ được đọc trong bộ nhớ khi xử lý yêu cầu rồi bỏ đi.
API liên quan
Metadata ảnh & EXIF
Đọc kích thước, định dạng, thông tin EXIF máy ảnh, thông số chụp và vị trí GPS của ảnh JPEG, PNG, WebP, HEIC, AVIF, GIF… – upload file hoặc qua URL.
PDFMetadata PDF
Đọc metadata file PDF: số trang, tiêu đề, tác giả, phần mềm tạo, ngày tạo, phiên bản PDF, mã hoá, số trường form và khổ giấy từng trang (A4, Letter…).
PDF₫Tạo PDF báo giá, phiếu thu
Tạo PDF báo giá, phiếu thu, đơn đặt hàng, hoá đơn bán hàng gọn đẹp từ JSON: tiếng Việt chuẩn, thuế GTGT, số tiền bằng chữ và mã VietQR để thanh toán.