Formless
Bắt đầu

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.

Tiền về tự lên sổ
Giao dịch ngân hàng về ngay, Formless gợi ý danh mục và bút toán.
Hỏi Formless Agent bằng tiếng Việt
“Khách nào đang nợ?”, “Thuế GTGT quý này bao nhiêu?”
Kế toán Formless khi cần
Book kế toán do Formless tuyển chọn, làm việc ngay trong sổ của bạn.
Tư vấn tài chính
Chuyên viên ngân hàng đã xác minh xem số liệu, hẹn lịch, đưa giải pháp.

Bắt đầu trong 5 phút

  1. 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.
  2. 2
    Thê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ê.
  3. 3
    Mở Giao dịch, duyệt các gợi ý phân loại. Bấm Ghi sổ tất cả khi đã ổn.
  4. 4
    Có 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.
Chưa sẵn sàng kết nối ngân hàng? Dùng tài khoản giả lập để thử toàn bộ luồng trước.

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.

Open API (POLL)
Formless hỏi ngân hàng mỗi 30 giây. Cần ngân hàng đã ký kết nối.
Đẩy về (PUSH)
Ngân hàng hoặc ứng dụng chuyển tiếp gửi giao dịch về endpoint của Formless.
Giả lập
Tự tạo giao dịch để thử phân loại, khớp đơn, webhook.
Sao kê
Nhập file sao kê cho giai đoạn trước khi kết nối.
Dùng hằng ngày

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.

Chuyển tiền giữa các tài khoản của chính bạn đánh dấu Chuyển nội bộ, không tính vào thu chi.

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 đồ.

“Khách nào đang nợ?”
Danh sách công nợ phải thu, quá hạn bao lâu.
“Thuế GTGT quý này?”
Ước tính đầu ra, đầu vào, số phải nộp.
“Báo cáo tháng 9”
Thu chi, dòng tiền, danh mục lớn nhất; tải Excel, Word.
“Chi phí tháng này?”
Chi theo danh mục, so với tháng trước.

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.

Thuế
Hạn nộp tờ khai trong 14 ngày, hoá đơn bị cơ quan thuế từ chối, khoản chi từ 5 triệu chưa có hoá đơn.
Tiền
Số dư đủ chi bao nhiêu ngày, phải thu quá hạn, phải trả đến hạn, tài khoản ngân hàng im lặng.
Hoá đơn
MST đối tác sai số kiểm tra, hoá đơn đầu vào nghi trùng, hoá đơn nháp để lâu.
Sổ sách
Giao dịch quá 7 ngày chưa phân loại, đã phân loại chưa ghi sổ, tháng trước chưa khoá sổ.
Mỗi việc có nút đi thẳng tới chỗ xử lý. Sửa xong, mở lại trang là việc đó biến mấ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.

  1. 1
    Bấ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.
  2. 2
    Chọ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.
  3. 3
    Mọ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ế.

Đọc đủ
Người bán, MST, ký hiệu, số, ngày lập, từng dòng hàng, thuế suất, mã cơ quan thuế.
Tự thêm nhà cung cấp
Người bán chưa có trong Đối tác thì tạo mới theo MST, kèm địa chỉ, số tài khoản.
Chặn sai sót
Hoá đơn xuất cho MST khác bị từ chối; nhập trùng bị chặn; MST sai số kiểm tra, thiếu mã CQT được cảnh báo.
Vào dạng nháp
Soát trong Soát hàng loạt rồi Phát hành để ghi sổ: Nợ chi phí và 1331, Có 331.
Hoá đơn do chính doanh nghiệp xuất (người bán trùng MST của bạn) được nhập thành hoá đơn bán ra.

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ế.

  1. 1
    Bướ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ổ.
  2. 2
    Bướ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.
  3. 3
    Giao 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.

Chuyên gia

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.

  1. 1
    Mở Kế toán Formless, chọn người hoặc để Formless chọn giúp, mô tả việc cần làm.
  2. 2
    Kế 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ọ.
  3. 3
    Theo dõi tiến độ, giờ làm, trao đổi trong từng việc. Xong việc thì đánh giá sao.
  4. 4
    Muố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ì.

  1. 1
    Mở 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.
  2. 2
    Gửi thêm báo cáo tài chính, sao kê nếu tư vấn viên cần.
  3. 3
    Hẹ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.
  4. 4
    Nế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.
Formless không cho vay, không bảo đảm khoản vay và không thu phí trên khoản vay. Lãi suất, hạn mức do ngân hàng quyết định sau thẩm định.

Chia sẻ dữ liệu an toàn

Chỉ khi bạn đồng ý
Tư vấn viên nhận bản chụp số liệu tại lúc gửi, không vào sổ sống.
Có thời hạn
30, 60 hoặc 90 ngày; thu hồi bất cứ lúc nào, hiệu lực ngay.
Tối thiểu
Không gửi từng giao dịch, không gửi tên khách hàng của bạn.
Có nhật ký
Mỗi lần kế toán, tư vấn viên xem hay tải đều ghi lại, bạn tra được.
Tích hợp API

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.

  1. 1
    Website tạo đơn qua POST /api/v1/orders hoặc tự sinh mã đơn DH123.
  2. 2
    Hiển thị QR động và nội dung chuyển khoản chứa mã đơn.
  3. 3
    Khách quét QR bằng app ngân hàng và chuyển tiền.
  4. 4
    Formless nhận biến động số dư, trích mã đơn, khớp đơn.
  5. 5
    Formless 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.

http
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
html
<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:

http
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
json
{
  "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
  }
}
Đừng dùng 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

javascript
// 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.

javascript
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
<?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>.

http
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}
json
{
  "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

http
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 }
}
json
{ "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án

Cá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ề:

http
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

SIMULATOR
Tạo giao dịch giả để test webhook, khớp đơn.
PUSH
Inbound endpoint ở trên; ngân hàng hoặc app chuyển tiếp gửi về.
POLL
Worker gọi Open API ngân hàng mỗi 30 giây; connector GENERIC map JSON sao kê bằng cấu hình.
Riêng từng ngân hàng
Viết sau khi ký Open Banking và nhận credential (MB, BIDV, VPBank, ACB…).
json
// 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

  1. 1
    Thêm tài khoản ngân hàng, tạo API key và webhook trỏ về https://shop.vn/api/zos-webhook.
  2. 2
    Ở trang checkout gọi POST /api/v1/orders, hiển thị qr_url và transfer_content (hoặc chuyển tới payment_url).
  3. 3
    Endpoint webhook: xác thực, kiểm tra order.settled, cập nhật đơn, trả {"success":true}.
  4. 4
    Trang chờ thanh toán gọi GET /api/v1/orders/{code} từ server, hoặc dùng trang /pay/… có sẵn.
  5. 5
    Đối soát cuối ngày bằng GET /api/v1/transactions/list?transaction_date_min=….