GDT Invoice API
by Casso
| Lines of Code | 3398 |
| Technical name | l10n_vn_casso_gdt_invoices |
| License | OPL-1 |
| Website | https://console.casso.vn/ |
| Required Apps | Invoicing (account) Discuss (mail) |
| Included Dependencies | Casso Base Legal Invoice Number |
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
This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file).
You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software.
The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
