Báo cáo tài chính
Mục lục
Module Finance cung cấp khả năng truy xuất dữ liệu báo cáo tài chính (BCTC) nguyên bản từ 3 nguồn cấp dữ liệu hàng đầu: VCI (Vietcap), MAS (Mirae Asset), và KBS (KB Securities).
Từ phiên bản v3.2.8, cấu trúc của module Finance đã được đồng nhất hoàn toàn:
- Dữ liệu đầu ra đồng nhất: Tất cả các nguồn (VCI, MAS, KBS) đều trả về dữ liệu chuẩn hóa theo cùng một cấu trúc định dạng Tidy Data (Long-form) với các Semantic ID chuẩn mực kế toán Việt Nam (VAS).
- Tham số đồng nhất: Loại bỏ các tham số riêng lẻ, sử dụng chung một bộ tham số chuẩn.
1. Khởi Tạo
from vnstock_data import Finance
# Nguồn VCI (Mặc định & Khuyên dùng)
finance = Finance(source='VCI', symbol='TCB')
# Nguồn MAS
finance_mas = Finance(source='MAS', symbol='TCB')
# Nguồn KBS
finance_kbs = Finance(source='KBS', symbol='TCB')2. So Sánh Mức Độ Chi Tiết Các Nguồn
Mặc dù cả 3 nguồn đều đã được chuẩn hóa về cùng một định dạng (Long-form), mức độ chi tiết (số lượng chỉ tiêu tài chính) vẫn có sự khác biệt rõ rệt tùy thuộc vào nhóm ngành (Ngân hàng, Chứng khoán, Bảo hiểm, Thường).
Dưới đây là bảng thống kê so sánh số lượng chỉ tiêu tài chính của các nguồn dựa trên tập mẫu kiểm thử đặc trưng gồm các mã đại diện: TCB (Ngân hàng), SSI (Chứng khoán), BVH (Bảo hiểm), và HPG (Thường).
| Nhóm ngành | Loại Báo Cáo | VCI | MAS | KBS |
|---|---|---|---|---|
| Ngân hàng (TCB) | Cân đối kế toán | 86 | 77 | 71 |
| Lưu chuyển tiền tệ | 52 | 51 | 50 | |
| Kết quả kinh doanh | 26 | 25 | 24 | |
| Chỉ số tài chính | 58 | 32 | 31 | |
| Thuyết minh | 219 | - | - | |
| Chứng khoán (SSI) | Cân đối kế toán | 208 | 156 | 155 |
| Lưu chuyển tiền tệ | 148 | 137 | 138 | |
| Kết quả kinh doanh | 79 | 91 | 90 | |
| Chỉ số tài chính | 58 | 60 | 59 | |
| Thuyết minh | 642 | - | - | |
| Bảo hiểm (BVH) | Cân đối kế toán | 150 | 134 | 132 |
| Lưu chuyển tiền tệ | 49 | 70 | 45 | |
| Kết quả kinh doanh | 84 | 80 | 79 | |
| Chỉ số tài chính | 58 | 66 | 65 | |
| Thuyết minh | 281 | - | - | |
| Thường (HPG) | Cân đối kế toán | 122 | 187 | 135 |
| Lưu chuyển tiền tệ | 41 | 59 | 50 | |
| Kết quả kinh doanh | 25 | 30 | 25 | |
| Chỉ số tài chính | 58 | 74 | 73 | |
| Thuyết minh | 157 | - | - |
💡 Nhận xét:
- VCI tỏ ra vượt trội và toàn diện nhất về mức độ chi tiết và hoàn thiện, bao phủ tất cả dạng báo cáo tài chính và có độ tin cậy cao nhất tuy nhiên bạn chỉ có thể sử dụng nguồn này nếu cài thư viện trên môi trường máy tính cục bộ thay vì chạy qua Google Colab.
- MAS có ưu thế mạnh trong việc bóc tách cực kỳ chi tiết Bảng cân đối kế toán và Lưu chuyển tiền tệ đối với các Doanh nghiệp Thường (Sản xuất, Bán lẻ, Bất động sản...) và ngành Bảo hiểm.
- KBS không được khuyến nghị sử dụng trừ khi bạn đang chuyển đổi code từ phiên bản vnstock Community (miễn phí) cũ sang, do nguồn này giới hạn số lượng kỳ báo cáo được tải về và dữ liệu API gốc có một số lỗi thiếu chuẩn mực không thể xử lý triệt để.
3. Các Hàm Hỗ Trợ & Tham Số Mặc Định
Bạn có thể sử dụng các hàm tải BCTC giống hệt nhau trên bất kỳ đối tượng Finance nào (VCI, MAS, hay KBS).
| Hàm | Mô tả |
|---|---|
income_statement() | Kết quả kinh doanh |
balance_sheet() | Cân đối kế toán |
cash_flow() | Lưu chuyển tiền tệ |
ratio() | Chỉ số tài chính |
| note() | Thuyết minh BCTC |
Tham số chung (Parameters)
period: Kỳ báo cáo ('quarter': Quý,'year': Năm).lang: Ngôn ngữ của tên chỉ tiêu ('vi'hoặc'en'). Khi sử dụng ngôn ngữ tiếng Anh, tên tiêu chí được xử lý từ nội dung mã id để thể hiện định dạng dễ đọc.drop_empty: Ẩn các chỉ tiêu không có giá trị (Mặc định:False).com_type: Loại hình công ty để ép kiểu phân tích ('Regular','Bank','Securities','Insurance').
Ví dụ sử dụng
# Lấy Báo cáo Cân đối kế toán theo Năm (Output mặc định là Long-form Tidy Data)
df = finance.balance_sheet(period='year', lang='vi')
# Ép kiểu dữ liệu cho nhóm ngành Chứng khoán
df_sec = finance_mas.cash_flow(period='quarter', com_type='Securities')Cấu trúc dữ liệu trả về chuẩn (Long-form):
id: Semantic ID định danh chỉ tiêu (Ví dụ:BS_CASH_AND_PRECIOUS_METALS)name: Tên chỉ tiêu theo ngôn ngữ truyền vào (Tiền và các khoản tương đương tiền)unit: Đơn vị (VND)level: Phân cấp- Các cột chứa kỳ báo cáo (Ví dụ:
2024-Q1,2024-Q2...)
4. Các Tính Năng Bổ Sung Theo Nguồn
Thuyết Minh Báo Cáo Tài Chính (Chỉ có ở VCI)
VCI là nguồn duy nhất phân tách Thuyết minh BCTC cực kỳ cụ thể để phục vụ đi sâu vào các khoản mục con.
df_note = finance.note(period='quarter', lang='en')Kế Hoạch Kinh Doanh Năm (Chỉ có ở MAS)
MAS hỗ trợ việc lấy số liệu Kế hoạch kinh doanh do ĐHCĐ đề ra hàng năm.
df_plan = finance_mas.annual_plan()
Thảo luận
Đang tải…