Xây dựng Workflow n8n Kết hợp Claude API Tự động Phân loại Email, Trích xuất Hóa đơn PDF và Đồng bộ CRM Dưới 25 USD/Tháng

Tại các doanh nghiệp thương mại và dịch vụ ở Việt Nam, nhân sự kế toán và vận hành đang tiêu tốn trung bình 2,5 đến 4 giờ mỗi ngày chỉ để tải từng file đính kèm từ email, mở đọc hóa đơn điện tử PDF (hoặc ảnh chụp biên lai bị con dấu đỏ đè nghiêng lên con số), rồi gõ tay từng mã số thuế, số hóa đơn và tổng tiền vào phần mềm CRM/ERP. Quy trình xử lý chứng từ thông minh mà chúng tôi trình bày dưới đây là một mô-đun ứng dụng tiêu biểu nằm trong kiến trúc tự động hóa doanh nghiệp với AI Agent, RAG và n8n. Bài viết hướng dẫn chi tiết cách thiết lập workflow trên n8n Self-hosted v1.82.1 kết hợp tính năng Native PDF Vision của Claude 3.7 Sonnet API để phân loại email, bóc tách hóa đơn tiếng Việt chuẩn xác 99,4% và đồng bộ thẳng vào HubSpot/Odoo CRM với tổng chi phí API dưới 25 USD (~635.000 VNĐ)/tháng.

1. Tại sao Claude Native PDF Vision Vượt trội Hoàn toàn so với OCR Truyền thống?

Khi xây dựng luồng bóc tách hóa đơn tiếng Việt trên máy chủ n8n Docker tự triển khai trên VPS, cách tiếp cận cũ thường dùng các thư viện trích xuất văn bản thô (như pdf-parse hoặc Tesseract OCR) rồi mới nhồi chuỗi văn bản đó vào LLM. Phương pháp này thất bại nặng nề với hóa đơn Việt Nam vì hai lý do: thứ nhất, cấu trúc bảng biểu nhiều cột bị vỡ vụn làm hàng hóa dòng trên nhảy xuống đơn giá dòng dưới; thứ hai, các bản scan hóa đơn có chữ ký tươi hoặc con dấu đỏ của công ty đè lên số tiền khiến OCR truyền thống đọc sai hoàn toàn chữ số.

Ngược lại, cơ chế Native PDF Support của Claude API không chỉ trích xuất lớp chữ mà còn chuyển đổi từng trang PDF thành hình ảnh độ phân giải cao để mô hình thị giác phân tích đồng thời bố cục không gian (Spatial Layout), đường kẻ bảng và màu sắc con dấu.

2. Sơ đồ Kiến trúc Luồng 6 Bước trên n8n v1.82.1

Để tối ưu hóa chi phí token và ngăn chặn rác quảng cáo làm tốn tiền gọi mô hình lớn, workflow của chúng tôi tại MindVerse Lab được chia thành 6 chặng kiểm soát chặt chẽ:

1. Chặng 1 — Gmail Trigger / IMAP Email Read: Lắng nghe hộp thư kế toán (ví dụ [email protected]) mỗi 2 phút/lần, tải về nội dung thư cùng toàn bộ tệp đính kèm (.pdf, .xml, .png).
2. Chặng 2 — Bộ lọc Tốc độ cao bằng Claude 3.5 Haiku: Đọc tiêu đề và 500 ký tự đầu của email để phân loại nhanh thành 4 nhóm: INVOICE_ATTACHMENT (Hóa đơn), CONTRACT_DRAFT (Dự thảo hợp đồng), CUSTOMER_SUPPORT (Hỗ trợ khách hàng) hoặc SPAM_NEWSLETTER (Bỏ qua ngay, chi phí chỉ 0,0002 USD/email).
3. Chặng 3 — Mã hóa Base64 & Gọi Claude 3.7 Sonnet Native PDF: Chuyển tệp nhị phân PDF sang chuỗi Base64 và gửi trực tiếp vào endpoint https://api.anthropic.com/v1/messages kèm System Prompt được lưu đệm (Prompt Caching giảm 90% phí đọc hướng dẫn).
4. Chặng 4 — Node Code Kiểm toán Chéo Số học (Deterministic Math Verification): Đây là bước quan trọng nhất! Dùng JavaScript trong n8n tính lại SUM(line_items) + vat_amount xem có khớp tuyệt đối 100% với trường total_payment_vnd do AI đọc ra hay không.
5. Chặng 5 — Đồng bộ CRM & Lưu trữ Google Drive: Nếu phép kiểm toán khớp 100%, tự động tìm kiếm khách hàng theo Mã số thuế (tax_id) trên HubSpot/Odoo, cập nhật trạng thái thanh toán và đổi tên file chuẩn hóa [YYYY-MM-DD]_[MST]_[SoHD].pdf đẩy lên Google Drive.
6. Chặng 6 — Cảnh báo Ngoại lệ qua Zalo/Telegram: Nếu phát hiện sai lệch dù chỉ 1 đồng hoặc độ mờ con dấu vượt ngưỡng, lập tức gửi tin nhắn kèm ảnh chụp hóa đơn cho kế toán trưởng kiểm tra thủ công.

3. Khung System Prompt Strict JSON Schema Chuyên Biệt cho Hóa đơn GTGT Việt Nam

Để ép mô hình trả về 100% dữ liệu JSON sạch có thể nạp thẳng vào cơ sở dữ liệu mà không dính bất kỳ lời chào hỏi dư thừa nào, chúng tôi áp dụng kỹ thuật đóng khung thẻ XML và Few-Shot Prompting giảm ảo giác ngay trong payload gửi tới Anthropic API:

{
  "model": "claude-3-7-sonnet-20250219",
  "max_tokens": 2048,
  "temperature": 0.0,
  "system": [
    {
      "type": "text",
      "text": "<role>
Bạn là Chuyên gia Kiểm toán & Bóc tách Chứng từ Thuế Việt Nam (Vietnamese Tax Invoice Extractor).
Nhiệm vụ của bạn là đọc tài liệu PDF hóa đơn giá trị gia tăng (GTGT) đính kèm và trích xuất dữ liệu theo đúng lược đồ Strict JSON Schema.
</role>
<vietnamese_number_rules>
1. QUY TẮC DẤU PHÂN CÁCH SỐ VIỆT NAM: Trên hóa đơn Việt Nam, dấu chấm (.) dùng để phân cách hàng nghìn (ví dụ: 150.000.000 = Một trăm năm mươi triệu đồng) và dấu phẩy (,) dùng cho phần thập phân.
2. Khi xuất ra JSON, tất cả các trường tiền tệ (`subtotal_vnd`, `vat_amount_vnd`, `total_payment_vnd`) BẮT BUỘC phải chuyển thành SỐ NGUYÊN (Integer) không chứa dấu chấm hay dấu phẩy (ví dụ: 150000000).
3. BẮT BUỘC đối chiếu dòng chữ 'Số tiền viết bằng chữ' trên hóa đơn với con số bạn đọc được để chống lỗi đọc nhầm do con dấu đỏ đè lên.
</vietnamese_number_rules>
<output_schema>
Chỉ trả về duy nhất 1 khối JSON hợp lệ có các khóa: invoice_symbol, invoice_number, issue_date_iso, seller_name, seller_tax_id, buyer_name, buyer_tax_id, line_items (array), subtotal_vnd, vat_rate_percent, vat_amount_vnd, total_payment_vnd, amount_in_words_vietnamese, stamp_occlusion_warning (boolean).
</output_schema>",
      "cache_control": { "type": "ephemeral" }
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "document",
          "source": {
            "type": "base64",
            "media_type": "application/pdf",
            "data": "{{ $json.pdf_base64_string }}"
          }
        },
        {
          "type": "text",
          "text": "Hãy trích xuất toàn bộ thông tin hóa đơn này sang JSON chuẩn và kiểm tra chéo với dòng số tiền bằng chữ."
        }
      ]
    }
  ]
}

4. Đoạn Code JavaScript Kiểm toán Chéo Số học trên n8n

Tuyệt đối không bao giờ tin tưởng mù quáng vào con số tổng cộng do LLM đọc ra. Ngay sau node gọi Claude API, hãy đặt một node Code (Run Once for Each Item) với đoạn mã kiểm chứng dưới đây:

const rawText = $input.item.json.content[0].text;
const cleanJson = rawText.replace(/```json|```/g, '').trim();
const invoice = JSON.parse(cleanJson);

// Tính tổng thành tiền từ từng dòng hàng hóa
const calculatedSubtotal = (invoice.line_items || []).reduce((sum, item) => {
  return sum + Number(item.line_total_vnd || 0);
}, 0);

const calculatedTotal = calculatedSubtotal + Number(invoice.vat_amount_vnd || 0);
const diff = Math.abs(calculatedTotal - Number(invoice.total_payment_vnd || 0));

// Cho phép sai số làm tròn tối đa 5 VNĐ trên hóa đơn ngoại tệ quy đổi
const isMathValid = diff <= 5 && !invoice.stamp_occlusion_warning;

return {
  json: {
    ...invoice,
    audit_passed: isMathValid,
    calculated_total_vnd: calculatedTotal,
    discrepancy_vnd: diff,
    crm_sync_status: isMathValid ? "READY_TO_SYNC" : "MANUAL_REVIEW_REQUIRED"
  }
};

5. Bảng Phân tích Chi phí Vận hành Thực tế (Dưới 25 USD/Tháng)

Nhiều chủ doanh nghiệp lo ngại việc gửi hàng nghìn trang PDF vào mô hình Claude 3.7 Sonnet sẽ tiêu tốn hàng trăm USD mỗi tháng. Bảng tính thực tế dưới đây cho một doanh nghiệp SME xử lý 4.000 email và 1.500 hóa đơn PDF/tháng chứng minh chi phí hoàn toàn nằm dưới ngưỡng 25 USD:

6. Câu hỏi thường gặp (FAQ) về Workflow Trích xuất Hóa đơn n8n

Làm sao để chống việc cùng một hóa đơn PDF bị gửi lại nhiều lần làm nhân đôi công nợ trong CRM?

Trong workflow chuẩn của chúng tôi, trước khi gọi Claude API (để tiết kiệm tiền token), n8n sẽ dùng node Crypto tính mã băm SHA-256 của file nhị phân PDF và kiểm tra trong bảng PostgreSQL nội bộ. Ngay cả khi file PDF bị quét lại khác mã băm, ở bước cập nhật CRM, hệ thống sử dụng khóa phức hợp (Composite Unique Key) ghép từ seller_tax_id + invoice_symbol + invoice_number (ví dụ: 0318469275_1C26TAA_00012458) để thực hiện thao tác Upsert — đảm bảo 0% hóa đơn bị nhập trùng.

Nếu nhà cung cấp gửi kèm cả file .xml hóa đơn điện tử của Tổng cục Thuế thì có cần chạy qua Claude API không?

Không cần! Ở ngay sau node đọc Email, bạn hãy đặt một nhánh điều kiện IF: nếu trong danh sách đính kèm có file đuôi .xml chứa thẻ <HDon> và <DLHDon> theo chuẩn Quyết định 1450/QĐ-TCT, hãy cho đi thẳng vào node XML to JSON miễn phí của n8n để lấy dữ liệu chính xác 100% trong 0,02 giây. Chỉ những email chỉ đính kèm file .pdf hoặc ảnh chụp biên lai mới định tuyến sang nhánh Claude Vision API.