GDT Invoice API
bởi Casso
| Số dòng Code | 3399 |
| Tên kỹ thuật | l10n_vn_casso_gdt_invoices |
| Giấy phép | OPL-1 |
| Website | https://console.casso.vn/ |
| Yêu cầu các App | Invoicing (account) Discuss (mail) |
| Bao gồm Các phụ thuộc | Casso Base Số hóa đơn giá trị gia tăng |
Casso Đồng Bộ Hóa Đơn GDT
Casso Đồng Bộ Hóa Đơn GDT là giải pháp tự động hóa toàn diện giúp kết nối trực tiếp Cổng thông tin Tổng cục Thuế (GDT) với Odoo. Hệ thống tự động kéo toàn bộ hóa đơn điện tử mua vào và bán ra theo thời gian thực hoặc lịch định kỳ hàng ngày, tự động bóc tách chi tiết dòng hàng, nhận diện đối tác và thuế suất, tạo sẵn dự thảo bút toán kế toán — xóa bỏ 100% thao tác nhập liệu và tải XML thủ công.
Module yêu cầu cài đặt nền tảng Casso Base.
Kéo trực tiếp từ GDT
Kết nối Cổng Thuế một chạm — Không cần tải file XML thủ công.
Tự động đồng bộ mỗi ngày
Lịch chạy ngầm định kỳ — Hóa đơn mới về tức thì.
Tự nhận diện đối tác & thuế
Tự động bóc tách mã số thuế — Tự sinh đối tác, chuẩn xác dòng tiền.
Chống trùng lặp tuyệt đối
Kiểm tra đa tầng ký hiệu số — Đồng bộ nhiều lần không lo trùng.
Bóc tách chi tiết hóa đơn
Tự động lấy đủ từng dòng hàng — Số lượng đơn giá chuẩn xác từng xu.
Kéo theo ngày linh hoạt
Chọn mốc thời gian theo nhu cầu — Quản lý tập trung trên một giao diện.
- ✔ Kéo hóa đơn điện tử theo khoảng ngày tùy chọn, ngay từ nút trên danh sách Hóa đơn
- ✔ Tự động tạo Hóa đơn bán ra hoặc Hóa đơn mua vào tương ứng với loại hóa đơn trên GDT
- ✔ Dedup tự động theo số ký hiệu + số hóa đơn — đồng bộ lại một khoảng ngày không bao giờ tạo trùng
- ✔ Chỉ tạo bản ghi hóa đơn (đối tác, tổng tiền, thuế) khi kéo danh sách; chi tiết từng dòng (sản phẩm, số lượng, đơn giá) chỉ được lấy về khi hóa đơn được mở hoặc vào sổ — giúp lần đồng bộ định kỳ luôn nhanh
- ✔ Thuế suất được nhận diện tự động cho từng dòng hóa đơn, và tạo mới ngay khi import hóa đơn lần đầu
- ✔ Tự động đồng bộ hàng ngày theo giờ tùy chỉnh, kèm thông báo tóm tắt kết quả sau mỗi lần chạy
- ✔ MST bên bán trên hóa đơn mua vào được xác thực tự động; hóa đơn có MST không hợp lệ hoặc ngừng hoạt động bị đánh dấu và cần xác nhận thủ công trước khi vào sổ từng hóa đơn
- ✔ Khi vào sổ nhiều hóa đơn cùng lúc, hóa đơn bị chặn MST tự động được loại khỏi lô — các hóa đơn còn lại vẫn vào sổ bình thường, không bị dừng theo
- ✔ Sau mỗi lần kéo, hiển thị tóm tắt số hóa đơn đã tạo / trùng lặp / bị chặn MST, kèm bảng chi tiết từng trường hợp
- ✔ Theo dõi kết nối GDT qua webhook — tự tạo hoạt động nhắc nhở trên công ty khi kết nối gặp lỗi hoặc bị thu hồi
- ✔ Import theo lô với cô lập lỗi từng hóa đơn — một hóa đơn lỗi không làm hỏng cả đợt đồng bộ
Hướng dẫn Kết nối & Đồng bộ Hóa đơn GDT
- Thử nghiệm Sandbox: Khi test ở môi trường Sandbox, quý khách vui lòng sử dụng tài khoản Tổng cục Thuế demo 0999001100-02 (mật khẩu:
1) để thử nghiệm liên kết và đồng bộ hóa đơn. - Cơ chế chia sẻ kết nối:
- Nếu tài khoản thuế đã được liên kết trước trên Casso Console: Hệ thống sẽ tự động chia sẻ kết nối xuống Viindoo (1 chạm dùng ngay không cần đăng nhập lại).
- Nếu chưa liên kết tài khoản bao giờ: Hệ thống sẽ tự động mở giao diện để bạn nhập thông tin và liên kết trực tiếp an toàn.
Hệ thống sẽ tự động mở giao diện BankHub SDK nhúng trực tiếp ngay trong Viindoo. Bạn chỉ cần nhấn Tiếp Tục → dùng ứng dụng Cas ID quét mã QR (hoặc nhập thông tin tài khoản thuế) → hệ thống thông báo Thành công: Tài khoản của bạn đã liên kết thành công → nhấn Đồng Ý để hoàn tất.
* Hình ảnh mô phỏng liên tục 3 thao tác: Mở giao diện liên kết → Quét mã QR Cas ID → Xác nhận liên kết thành công.
Khi hệ thống phát hiện liên kết đã thiết lập sẵn trong tổ chức (thông qua Casso Base hoặc Casso Console), hộp thoại xác nhận sẽ xuất hiện — nhấn chọn Sử dụng kết nối này để liên kết ngay lập tức (1 chạm dùng ngay không cần đăng nhập lại).
Hướng dẫn Liên kết API để Dùng Dịch Vụ
Luồng Sandbox (Môi trường thử nghiệm miễn phí)
- Đăng nhập vào Casso Console (https://console.casso.vn).
- Tại menu bên trái, nhấp chọn mục Sandbox → Nhấn nút Tự cấp quyền cho tôi.
- Nhấp vào tên tổ chức hiện tại ở góc trên bên trái menu → Chọn Chuyển tổ chức.
- Chọn tổ chức thử nghiệm Sandbox: CTY TNHH CASSO DEMO 1 (hoặc tổ chức có nhãn Sandbox).
* Hình ảnh mô phỏng liên tục 3 thao tác: Cấp quyền Sandbox → Chuyển tổ chức → Chọn tổ chức Sandbox.
- 2.1. Cấu hình môi trường Sandbox trên Viindoo: Bật chế độ nhà phát triển (Debug mode). Vào ứng dụng Casso → API Configurations. Tại mục DEBUG, chọn Môi trường là Sandbox. Sau đó sao chép Redirect URI và Webhook URL.
- 2.2. Tạo API Credential trên Casso Console: Quay lại Casso Console (tổ chức Sandbox), vào Dashboard → Nhấn tạo API Credential mới. Đặt tên gợi nhớ (ví dụ:
Casso-Demo-Sandbox), dán Redirect URI và Webhook URL vừa sao chép từ Viindoo vào rồi nhấn Save.
- 2.3. Sao chép thông tin xác thực: Sau khi lưu, tại mục Additional information bên phải, sao chép Client ID và Client secret.
- 2.4. Dán thông tin vào Viindoo: Quay lại Viindoo, dán Client ID và Secret Key vào mục Thông tin xác thực (lấy từ Casso Console), điền tên Company rồi nhấn biểu tượng Lưu (Cloud).
- 2.5. Kiểm tra kết nối: Nhấn nút Kiểm tra kết nối ở thanh header phía trên. Cửa sổ thông báo hiển thị OK cho cả 3 mục (Client ID, Redirect URI, Webhook URL) là xác nhận kết nối thành công!
Quay lại Dashboard của tổ chức Sandbox trên Casso Console, tại mục Tài khoản Sandbox, hệ thống cung cấp sẵn các tài khoản demo chuẩn:
| Dịch vụ thử nghiệm | Tên đăng nhập / Mã số thuế | Mật khẩu | Ghi chú |
|---|---|---|---|
| Tổng cục Thuế GDT (TEST) | 0999001100-02 |
1 |
Thử nghiệm liên kết và đồng bộ Hóa đơn điện tử GDT |
Luồng Production (Môi trường thực tế)
- 1.1. Mở ứng dụng Casso: Từ màn hình chính / menu ứng dụng của Viindoo, tìm và nhấp chọn ứng dụng Casso.
- 1.2. Lấy thông tin URL từ Viindoo: Vào menu API Configurations. Tại mục CẤU HÌNH TRÊN CASSO CONSOLE, sao chép Redirect URI và Webhook URL. Nhấp vào đường dẫn https://console.casso.vn để mở Casso Console.
- 1.3. Tạo API Credential trên Casso Console: Trên Casso Console (tổ chức Production), tại mục Dashboard → Nhấn tạo API Credential mới. Đặt tên gợi nhớ (ví dụ:
Casso-Demo), dán Redirect URI và Webhook URL vừa sao chép từ Viindoo rồi nhấn Save.
- 1.4. Sao chép thông tin xác thực: Tại mục Additional information, sao chép Client ID và Client secret vừa tạo.
- 1.5. Dán khóa vào Viindoo: Quay lại Viindoo, dán Client ID và Secret Key vào mục Thông tin xác thực (lấy từ Casso Console) rồi nhấn biểu tượng Lưu (Cloud).
- 1.6. Kiểm tra kết nối: Nhấn nút Kiểm tra kết nối ở góc trên bên trái. Hộp thoại hiện lên hiển thị OK cho cả 3 mục (Client ID, Redirect URI, Webhook URL) là kết nối thành công hoàn tất!
Widget kết nối GDT trong wizard đồng bộ luôn hiển thị đúng một trong ba trạng thái sau:
Kết nối đang hoạt động bình thường, có thể chọn khoảng ngày và đồng bộ hóa đơn. Nút Ngắt kết nối luôn có sẵn nếu cần thu hồi quyền truy cập.
Phiên xác thực gặp sự cố (thường do token hết hạn) — hệ thống tự tạo một hoạt động nhắc nhở trên công ty. Nhấn Cập nhật kết nối để xác thực lại qua OAuth mà không mất cấu hình đã có, hoặc Ngắt kết nối để bắt đầu lại từ đầu.
Công ty chưa liên kết tài khoản GDT nào, hoặc vừa ngắt kết nối. Nhấn Kết nối GDT để mở luồng xác thực OAuth.
| Vai trò | Quyền hạn |
|---|---|
| Người dùng nội bộ (mọi nhân viên) | Chỉ xem được trạng thái kết nối GDT của công ty, không thao tác được |
| Casso User | Toàn quyền: kết nối/ngắt kết nối GDT, kéo hóa đơn, bật/tắt tự động đồng bộ |
| Quản lý Kế toán (Accounting Manager) | Gỡ chặn MST cho đối tác từ form Liên hệ (nút "Gỡ chặn MST") |
| Quản trị viên (Settings) | Toàn quyền kỹ thuật trên bản ghi kết nối GDT |
033 4587 486
www.cas.so
facebook.com/cassovn
Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).
Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).
Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.
Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.
