Điền dữ liệu vào mẫu Word (.docx) online từ JSON

Q: Thẻ không được thay giá trị là vì sao?

Kiểm tra bằng `action=tags`: thẻ phải dùng ngoặc nhọn thường `{…}` và không xuống dòng ở giữa. Thẻ bị tách đoạn được xử lý tự động; giá trị thiếu được báo trong `missing_fields` (hoặc header x-missing-fields).

Q: Làm sao lặp một dòng của bảng?

Đặt `{#items}` ở ô đầu và `{/items}` ở ô cuối của dòng (hoặc của một dòng phía dưới): các dòng đó được nhân lên theo từng phần tử, `{$index}` là số thứ tự.

Điền mẫu Word .docx có {thẻ}, lặp dòng bảng, điều kiện từ JSON; trộn nhiều bản ghi thành file zip. Định dạng tiền VND, số tiền bằng chữ, ngày tháng.

Kết quả

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

Tải lên file Word có các thẻ và gửi dữ liệu JSON: {ho_ten} chèn giá trị (dùng được đường dẫn như {ben_a.ten}), {#items}…{/items} lặp nội dung cho từng phần tử của mảng, {#co_bao_hiem}…{/co_bao_hiem} chỉ hiện khi giá trị đúng và {^co_bao_hiem}…{/co_bao_hiem} khi sai hoặc rỗng. Vòng lặp đặt trong dòng của bảng sẽ lặp dòng đó (dòng hàng hóa, điều khoản), vòng lặp qua nhiều đoạn sẽ lặp các đoạn, vòng lặp trong một đoạn lặp phần chữ tại chỗ. {$index} để đánh số thứ tự.

Bộ lọc định dạng theo kiểu Việt Nam: {luong|money} ra 15.500.000, {luong|words} ra "Mười lăm triệu năm trăm nghìn đồng", {ngay|date} ra 11/11/2026, {ngay|date_vi} ra "ngày 11 tháng 11 năm 2026", cùng upper, lower, trim và default:…. Thẻ bị Word tách thành nhiều đoạn chữ khi gõ (do kiểm tra chính tả, đổi định dạng) được ghép lại trước, nên vẫn chạy đúng như khi gõ; định dạng của ký tự đầu thẻ được giữ. Đầu trang, chân trang, chú thích cũng được điền; dấu {{ten}} được tự nhận ra.

Gửi rows (mảng) thay cho data để trộn nhiều văn bản một lần: kết quả là file zip, tên file theo filename như HD_{so_hd}. action=tags liệt kê các thẻ trong mẫu. Kết quả là .docx (không chuyển sang PDF); file được xử lý trong bộ nhớ, không lưu lại.

Dùng trong code của bạn

curl -X POST "https://apibox.io.vn/v1/docx-template" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "0=@./my-file"

const form = new FormData();
form.append('0', fileInput.files[0]);

const res = await fetch('https://apibox.io.vn/v1/docx-template', {
  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/docx-template",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    files={"0": open("my-file", "rb")},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/docx-template');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => ['0' => new CURLFile('my-file')],
]);
$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

Thẻ không được thay giá trị là vì sao?

Kiểm tra bằng action=tags: thẻ phải dùng ngoặc nhọn thường {…} và không xuống dòng ở giữa. Thẻ bị tách đoạn được xử lý tự động; giá trị thiếu được báo trong missing_fields (hoặc header x-missing-fields).

Làm sao lặp một dòng của bảng?

Đặt {#items} ở ô đầu và {/items} ở ô cuối của dòng (hoặc của một dòng phía dưới): các dòng đó được nhân lên theo từng phần tử, {$index} là số thứ tự.

Có xuất ra PDF được không?

Không, kết quả là file .docx. Hãy chuyển bằng Word / LibreOffice, hoặc dùng /v1/md-pdf cho văn bản soạn bằng Markdown.