Formless là gì
Formless là kế toán agent cho doanh nghiệp nhỏ, hộ kinh doanh, cá nhân và hãng kế toán. Formless đọc tiền về, tiền ra từ tài khoản ngân hàng qua Open API, tự phân loại, ghi sổ, nhắc thuế; bạn chỉ duyệt những việc cần người quyết.
Bắt đầu trong 5 phút
- 1Đăng ký bằng họ tên, email, mật khẩu. Không cần công ty hay giấy tờ: bạn vào thẳng không gian cá nhân.
- 2Thêm tài khoản ngân hàng ở Ngân hàng → Tài khoản. Giao dịch mới tự về, giao dịch cũ nhập bằng sao kê.
- 3Mở Giao dịch, duyệt các gợi ý phân loại. Bấm Ghi sổ tất cả khi đã ổn.
- 4Có công ty hay hộ kinh doanh: vào Cài đặt → Nâng lên doanh nghiệp, dữ liệu giữ nguyên.
Kết nối ngân hàng
Formless đọc giao dịch qua Open API ngân hàng theo Thông tư 64/2024/TT-NHNN: ngân hàng xác thực bạn và lấy đồng ý, Formless chỉ nhận dữ liệu giao dịch. Formless không giữ mật khẩu internet banking và không chuyển tiền thay bạn.
Giao dịch và phân loại
Mỗi giao dịch đi qua ba bước: Chưa phân loại → Chờ ghi sổ (đã có danh mục, đối tác) → Đã ghi sổ. Luật tự động (Giao dịch → Luật tự động) phân loại sẵn theo nội dung, tài khoản, số tiền.
Formless Agent
Hỏi bằng tiếng Việt, Formless Agent trả lời từ số liệu thật trong sổ và xuất được báo cáo Excel, Word có biểu đồ.
Theo dõi tự động
Mỗi lần mở Theo dõi, Formless chạy hơn chục phép kiểm tra trên sổ thật và chỉ báo khi có việc cần làm, xếp theo mức gấp. Không cần cài đặt.
Soát hàng loạt
Bảng Soát hàng loạt đặt mỗi câu hỏi kế toán thành một cột và trả lời cho từng dòng: đối tác có MST hợp lệ không, tiền hàng cộng thuế có khớp tổng không, khoản chi lớn đã trả qua ngân hàng và có hoá đơn chưa, có bị nhập trùng không, đã ghi sổ chưa.
- 1Bấm số lỗi trên đầu một cột để chỉ xem các dòng lỗi ở cột đó, hoặc lọc theo kết luận Rủi ro, Cần xem, Ổn.
- 2Chọn nhiều dòng. Với giao dịch: gán danh mục, ghi sổ hoặc loại khỏi sổ một lần. Với hoá đơn: phát hành các hoá đơn nháp.
- 3Mọi thao tác hàng loạt đều ghi nhật ký; khoản đã ghi sổ phải đảo bút toán trước khi sửa.
Hộp thư hoá đơn
Gửi file XML hoá đơn điện tử cho Formless ở Hoá đơn → Hộp thư: kéo thả nhiều file một lúc, hoặc chuyển tiếp email của nhà cung cấp tới địa chỉ riêng của doanh nghiệp. Formless đọc đúng định dạng của Tổng cục Thuế.
Quy trình định kỳ
Quy trình là checklist cho việc lặp lại: khoá sổ tháng, kê khai GTGT quý (hoặc 01/CNKD cho hộ kinh doanh), quyết toán năm, quyết toán TNCN cho cá nhân. Hạn lấy theo lịch thuế.
- 1Bước có nhãn Formless tự kiểm tra tự tích khi dữ liệu đạt: đã phân loại hết, đã ghi sổ, khoản chi lớn có hoá đơn, đã đối soát, đã khoá sổ.
- 2Bước còn lại (rà soát, nộp tờ khai, nộp tiền) người phụ trách tích khi làm xong. Formless không tự nộp tờ khai.
- 3Giao quy trình cho một người, ghi chú, xem ai tích bước nào lúc nào.
Hoá đơn, sổ sách
Hoá đơn bán ra ghi nhận doanh thu và thuế GTGT khi phát hành; tiền về sau đó chỉ tất toán công nợ. Sổ cái theo Thông tư 133 hoặc 200 (doanh nghiệp), sổ đơn giản cho hộ kinh doanh và cá nhân. Kỳ kế toán khoá được để không ai sửa số đã chốt.
Báo cáo và thuế
Báo cáo dòng tiền, kết quả kinh doanh, bảng cân đối từ sổ cái. Formless nhắc hạn nộp tờ khai theo lịch thuế và lập nháp; Formless không tự nộp tờ khai, bạn hoặc kế toán kiểm tra rồi nộp.
Kế toán Formless
Kế toán do Formless tuyển chọn, cấp tài khoản và chấm công. Xem hồ sơ (kinh nghiệm, bằng cấp, đánh giá), book khi cần rà soát, khoá sổ, kê khai, quyết toán.
- 1Mở Kế toán Formless, chọn người hoặc để Formless chọn giúp, mô tả việc cần làm.
- 2Kế toán nhận việc: doanh nghiệp thành khách của người đó, họ làm trực tiếp trong khu làm việc của bạn. Mọi thao tác có nhật ký mang tên họ.
- 3Theo dõi tiến độ, giờ làm, trao đổi trong từng việc. Xong việc thì đánh giá sao.
- 4Muốn đổi người: bấm Đổi kế toán, quyền của người cũ gỡ ngay.
Yêu cầu chứng từ
Kế toán (Kế toán Formless hoặc người của hãng dịch vụ) xin chứng từ ở Yêu cầu chứng từ: sao kê, hoá đơn đầu vào, bảng lương, hợp đồng. Doanh nghiệp nhận thông báo, thả file ngay trong yêu cầu; kế toán bấm Đã nhận đủ hoặc mở lại để xin bổ sung. Yêu cầu quá hạn hiện trong Theo dõi.
Tư vấn tài chính, vay vốn
Chuyên viên ngân hàng đã được Formless xác minh nơi làm việc. Formless tự đọc số liệu và báo sức khoẻ tài chính (tiền mặt đủ bao lâu, tháng âm dòng tiền, khách nợ lâu…) để bạn biết cần hỏi gì.
- 1Mở Tư vấn tài chính, bấm Xin tư vấn: chọn chủ đề, mô tả vấn đề, đề xuất giờ hẹn.
- 2Gửi thêm báo cáo tài chính, sao kê nếu tư vấn viên cần.
- 3Hẹn lịch gọi video, gọi điện hoặc gặp tại chi nhánh. Nhận bản đánh giá và giải pháp.
- 4Nếu cần vốn: so sánh đề xuất vay (lãi suất, kỳ hạn, trả góp ước tính) rồi chấp nhận một đề xuất.
Chia sẻ dữ liệu an toàn
Luồng thanh toán
API và webhook tương thích định dạng SePay để bạn tái sử dụng plugin, SDK sẵn có (WooCommerce, Haravan, Google Sheets…) bằng cách đổi endpoint.
- 1Website tạo đơn qua
POST /api/v1/ordershoặc tự sinh mã đơnDH123. - 2Hiển thị QR động và nội dung chuyển khoản chứa mã đơn.
- 3Khách quét QR bằng app ngân hàng và chuyển tiền.
- 4Formless nhận biến động số dư, trích mã đơn, khớp đơn.
- 5Formless gửi webhook về website; website chuyển đơn sang “Đã thanh toán”.
Tạo mã VietQR
Ảnh PNG QR chuẩn EMVCo/NAPAS, không cần API key.
GET https://formless.vn/qr/img?acc=SO_TAI_KHOAN&bank=MA_NGAN_HANG&amount=SO_TIEN&des=NOI_DUNG acc Số tài khoản nhận bank Mã ngân hàng (VCB, MB, ACB, BIDV, TCB, VPB, TPB, STB, ICB...) hoặc BIN (970436...) amount Số tiền (VND). Bỏ trống -> QR tĩnh des Nội dung chuyển khoản (nên chứa mã đơn, ví dụ DH123) size Kích thước px (120-1000, mặc định 400) format text -> trả chuỗi EMVCo thay vì ảnh
<img src="https://formless.vn/qr/img?acc=0123456789&bank=MB&amount=150000&des=DH123" />
Webhooks
Tạo ở Cài đặt → Webhooks. Khi có giao dịch mới, Formless gửi POST JSON:
POST https://shop.vn/api/zos-webhook Content-Type: application/json Authorization: Apikey <API_KEY_CUA_BAN> # nếu chọn API Key X-Formless-Signature: t=1719900000,v1=<hex> # nếu chọn HMAC X-Formless-Delivery: <id> X-Formless-Attempt: 1
{
"event": "transaction",
"id": 92704,
"gateway": "Vietcombank",
"transactionDate": "2024-07-02 11:08:33",
"accountNumber": "1017588888",
"code": "DH123", // CHỈ có giá trị khi đơn đã nhận ĐỦ tiền
"content": "DH123 thanh toan don hang",
"transferType": "in", // in | out
"transferAmount": 5000000,
"accumulated": 105000000,
"referenceCode": "FT24012345678",
"order": { // null nếu tiền vào không liên quan đơn nào
"code": "DH123",
"matched": true, // tiền đã được ghi nhận cho đơn này
"settled": true, // đơn đã nhận ĐỦ tiền
"needs_review": false, // đang chờ người xác nhận trên trang Khớp đơn
"status": "PAID", // UNPAID | PARTIAL | PAID | OVERPAID | CANCELLED | EXPIRED
"expected_amount": 5000000,
"paid_amount": 5000000,
"remaining_amount": 0
}
}code làm điều kiện giao hàng. Kiểm tra order.settled === true. Khách chuyển thiếu vẫn được ghi nhận vào đơn (matched: true, status: "PARTIAL") nhưng chưa trả đủ.Điều kiện thành công: trả HTTP 200/201 trong 30 giây, body {"success": true}. Nếu không, Formless thử lại tối đa 8 lần theo Fibonacci (1, 1, 2, 3, 5, 8, 13, 21 phút). Idempotency: luôn kiểm tra id hoặc referenceCode đã xử lý chưa.
Xác thực webhook
API Key
// Node.js / Express if (req.headers.authorization !== "Apikey " + process.env.ZOS_WEBHOOK_KEY) return res.status(401).end();
HMAC-SHA256
Chuỗi ký ${t}.${rawBody}, header X-Formless-Signature: t=<unix>,v1=<hex>. Từ chối nếu lệch quá 5 phút.
import crypto from "node:crypto";
export function verify(secret, rawBody, header) {
const p = Object.fromEntries(header.split(",").map(kv => kv.split("=")));
if (Math.abs(Date.now()/1000 - Number(p.t)) > 300) return false;
const expected = crypto.createHmac("sha256", secret).update(p.t + "." + rawBody).digest("hex");
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(p.v1));
}PHP
<?php
$raw = file_get_contents("php://input");
$sig = $_SERVER["HTTP_X_ZOS_SIGNATURE"] ?? "";
parse_str(str_replace(",", "&", $sig), $p);
$expected = hash_hmac("sha256", $p["t"] . "." . $raw, $secret);
if (!hash_equals($expected, $p["v1"])) { http_response_code(401); exit; }
$data = json_decode($raw, true);
// Chỉ giao hàng khi đơn đã nhận ĐỦ tiền
if ($data["transferType"] === "in" && ($data["order"]["settled"] ?? false)) {
// UPDATE tb_orders SET status='Paid' WHERE order_code = $data["order"]["code"]
}
echo json_encode(["success" => true]);User API (REST)
Tạo key ở Cài đặt → API keys. Mọi request dùng Authorization: Bearer <api_key>.
GET https://formless.vn/api/v1/transactions/list
?account_number= &transaction_date_min=yyyy-mm-dd &transaction_date_max=yyyy-mm-dd
&since_id= &reference_number= &amount_in= &amount_out= &code= &limit=5000
GET https://formless.vn/api/v1/transactions/count (cùng bộ lọc)
GET https://formless.vn/api/v1/transactions/details/{id}
GET https://formless.vn/api/v1/bankaccounts/list
?short_name= &since_id= &last_transaction_date_min= &accumulated_min= &limit=100
GET https://formless.vn/api/v1/bankaccounts/count
GET https://formless.vn/api/v1/bankaccounts/details/{id}{
"status": 200, "error": null, "messages": { "success": true },
"transactions": [{
"id": "92704", "bank_brand_name": "Vietcombank", "account_number": "1017588888",
"transaction_date": "2024-07-02 11:08:33", "amount_out": "0.00", "amount_in": "5000000.00",
"accumulated": "105000000.00", "transaction_content": "DH123 thanh toan",
"reference_number": "FT24012345678", "code": "DH123", "transfer_type": "in"
}]
}API đơn hàng
POST https://formless.vn/api/v1/orders
Authorization: Bearer zos_xxx
{
"amount": 150000, // VND, bắt buộc
"order_code": "1023", // tuỳ chọn; tự thêm tiền tố (DH1023). Bỏ trống -> tự sinh
"description": "Đơn #1023",
"bank_account_id": "clx...", // tuỳ chọn; mặc định tài khoản đầu tiên
"expires_in": 30, // phút, 0 = không hết hạn
"return_url": "https://shop.vn/thank-you?o=1023",
"metadata": { "customer_id": 42 }
}{ "status": 200, "order": {
"id": "clx...", "order_code": "DH1023", "amount": 150000, "status": "UNPAID",
"bank": { "bank_code": "MB", "account_number": "0123456789", "account_holder": "NGUYEN VAN A" },
"transfer_content": "DH1023",
"qr_url": "https://formless.vn/qr/img?acc=...&bank=MB&amount=150000&des=DH1023",
"payment_url": "https://formless.vn/pay/clx..." // trang thanh toán có sẵn, tự cập nhật khi tiền vào
}}
GET https://formless.vn/api/v1/orders?status=UNPAID&limit=100
GET https://formless.vn/api/v1/orders/{order_code}
DELETE https://formless.vn/api/v1/orders/{order_code} // huỷ đơn chưa thanh toánCách khớp đơn. Formless chấm điểm từng đơn đang chờ theo mã đơn trong nội dung (chấp nhận viết liền, viết thường, gõ nhầm 1–2 ký tự), số tiền và thời điểm tạo đơn. Từ 70 điểm khớp tự động; 40–69 điểm đưa vào Khớp đơn để người xác nhận; dưới 40 bỏ qua.
Trả một phần, trả dư. Chuyển thiếu thì đơn thành PARTIAL, đủ thành PAID, dư thành OVERPAID. Mã QR luôn yêu cầu đúng phần còn thiếu. Sự kiện order.paid chỉ bắn khi đơn đã nhận đủ tiền.
Inbound endpoint
Với tài khoản kiểu PUSH, ngân hàng, app mobile hoặc SMS-forwarder gửi giao dịch về:
POST https://formless.vn/api/inbound/{bank_account_id}
X-Inbound-Token: <token trong dashboard>
{
"referenceCode": "FT24012345678", // duy nhất tại ngân hàng - dùng chống trùng
"amount": 5000000,
"transferType": "in",
"content": "DH123 thanh toan",
"transactionDate": "2024-07-02T11:08:33+07:00",
"accumulated": 105000000 // tuỳ chọn
}
// Gửi một mảng nhiều giao dịch cũng được.
// Trả về { success, results: [{ id, duplicate, order, order_status, paid_amount, needs_review }] }Connector ngân hàng
// connectorConfig cho POLL + GENERIC
{
"connector": "GENERIC",
"statementUrl": "https://openapi.bank.vn/v1/accounts/{account}/transactions?from={fromIso}",
"headers": { "Authorization": "Bearer ..." },
"listPath": "data.transactions",
"map": { "referenceCode": "refNo", "date": "transDate", "amount": "amount",
"type": "drCr", "inValue": "C", "content": "remark", "balance": "balance" }
}Tích hợp trong 30 phút
- 1Thêm tài khoản ngân hàng, tạo API key và webhook trỏ về
https://shop.vn/api/zos-webhook. - 2Ở trang checkout gọi
POST /api/v1/orders, hiển thịqr_urlvàtransfer_content(hoặc chuyển tớipayment_url). - 3Endpoint webhook: xác thực, kiểm tra
order.settled, cập nhật đơn, trả{"success":true}. - 4Trang chờ thanh toán gọi
GET /api/v1/orders/{code}từ server, hoặc dùng trang/pay/…có sẵn. - 5Đối soát cuối ngày bằng
GET /api/v1/transactions/list?transaction_date_min=….