کدال

اصلاح شده

2025-07-14

نکته. اگر از محیط ژوپیتر استفاده می‌کنید این کد را اجرا کنید.

import nest_asyncio
nest_asyncio.apply()

گرفتن لینک با تنظیم فیلتر برای جستجوی گزارشات از کدال

پر کردن جدول شرکت‌های لیست شده در کدال

from codal_tsetmc import fill_companies_table

fill_companies_table()

Error in fill_table_of_db_with_df: (sqlite3.IntegrityError) UNIQUE constraint failed: company.symbol
[SQL: INSERT INTO company (symbol, name, isic, type, status, industry, nature) VALUES (?, ?, ?, ?, ?, ?, ?)]
[parameters: [('آذرنگین', 'آذر نگین', '811620', -1, 3, 81, 1000005), ('بنیاد تعاون نیروی انتظامی جمهوری اسلامی ایران', 'بنیاد تعاون نیروی انتظامی جمهوری اسلامی ایران', '811774', -1, 3, 81, 1000005), ('بین المللی خدمات مسافرت هوایی ایرانگردی و جهانگردی آزادی', 'بین المللی خدمات مسافرت هوایی ایرانگردی و جهانگردی آزادی', '811602', -1, 3, 81, 1000005), ('پترونیک', 'مهندسی پترونیک صنعت', '', -1, 3, -1, 1000005), ('توس پیوند', 'توس پیوند', '811130', -1, 3, 81, 1000005), ('حسابرسی و بازرسی هادی بینات', 'حسابرسی و بازرسی هادی بینات', '811617', -1, 3, 81, 1000005), ('مهندسی بهنیان جنوب', 'مهندسی بهنیان جنوب', '751124', 4, 3, 75, 1000005), ('ایجاد محیط', 'ایجاد محیط', '811630', -1, 3, 81, 1000005)  ... displaying 10 of 181 total bound parameter sets ...  ('کشت و صنعت فتح و نصر کرمان', 'کشت و صنعت فتح و نصر کرمان', '811683', -1, 3, 81, 1000005), ('کشتیرانی کاسپین بنیاد', 'کشتیرانی کاسپین بنیاد', '811471', -1, 3, 81, 1000005)]]
(Background on this error at: https://sqlalche.me/e/20/gkpj)

دانلود داده‌های مورد نیاز برای جستجو

from codal_tsetmc import fill_categories_table

fill_categories_table()

تعریف یک جستجو

برای تنظیم یک جستجو یا (query) باید ابتدا یک شی یا (object) از کلاس جستجوی کدال (CodalQuery) ایجاد کنید بعد تنظیمات دلخواه را روی آن اعمال کنید

تنظیمات برای جستجو

تنظیمات موجود در کلاس جستجوی کدال به همراه مقادیر پیشفرض

#| eval: false
from codal_tsetmc import CodalQuery

# شی جستجوی کدال
query = CodalQuery()

# 1. نماد
query.set_symbol(symbol: str = "")

# 2. نام
query.set_name(name: str = "")

# 3. وضعیت ناشر
query.set_publisher_status(title: str = "")

# 4. ماهیت شرکت
query.set_company_nature(title: str = "")

# 5. نوع شرکت
query.set_company_type(title: str = "")

# 6. نوع صنعت
query.set_industry_group(title: str = "")

# 7. گروه اطلاعیه
query.set_letter_group(title: str = "")

# 8. نوع اطلاعیه
query.set_letter_type(title: str = "")

# 9. موضوع اطلاعیه
query.set_letter_subject(subject: str = "")

# 10. شماره پیگیری
query.set_tracing_no(no: str = "")

# 11. کد اطلاعیه
query.set_letter_code(code: str = "")

# 12. طول دوره
query.set_length_period(period=-1)

# 13. از تاریخ
query.set_from_date(date: str = "1300/01/01")

# 14. تا تاریخ
query.set_to_date(date: str = "1500/01/01")

# 15. حسابرسی شده
query.set_audited(status: bool = True)

# 16. حسابرسی نشده
query.set_not_audited(status: bool = True)

# 17. اصلی
query.set_consolidatable(status: bool = True)

# 18. تلفیقی
query.set_not_consolidatable(status: bool = True)

# 19. فقط زیرمجموعه ها
query.set_childs(status: bool = True)

# 20. فقط شرکت اصلی
query.set_mains(status: bool = True)

# 21. موسسه حسابرسی شرکت
query.set_auditor_ref(title: str = None)

# 22. سالی مالی منتهی به
query.set_year_end_to_date(date: str = "1300/01/01")

# 23. فقط اطلاعیه های منتشر شده از طرف سازمان
query.set_publisher(status: bool = True)

# 24. تنظیمات پیشفرض 
query.reset_params()

# تنظیم شماره ISIC
query.set_isic(isic: str = "")

# تنظیم شماره صفحه
query.set_page_number(number: int = 0)

# گرفتن شماره صفحه
query.get_page_number()

# نمایش تعداد صفحات جستجو
query.page

# گرفتن مواد تنظیم شده برای جستجو
query.params

"""################
گرفتن لینک کوئری کدال
################"""

# گرفتن لینک
query.get_query_url(api: bool = True)

# گرفتن لیست گزارش
query.get_report_list_url()

# گرفتن کوئری جستوجو
query.get_api_search_url()

"""################
گرفتن اطلاعات از کدال
################"""

# گرفتن اطلاعات کلی در یک صفحه
query.get_api_sigle_page()

# گرفتن اطلاعات کلی در همه صفحات
query.get_api_multi_page(pages: int = 0)

# گرفتن اطلاعات کلی تمام صفحات به صورت یک فرمت داده
query.get_letters(pages: int = 0, show = False)

# نمایش اطلاعات نامه‌ها و صورت‌مالیهای جستجو شده
query.letters

گرفتن یک جستجوی خاص برای چند نماد با سرعت بالا و ذخیره آن در دیتابیس

#| eval: false
from codal_tsetmc.download.codal.letters import *

# گرفتن و ذخیره لیست گزارشات با یک جستجوی مشابه برای لیستی از نمادها و ذخیره در دیتابیس
update_letters_table(
  query: CodalQuery,
  symbols: list[str],
  msg: str = ""
)

یک مثال از نحوه استفاده

تنظیم فیلترهای دلخواه

from codal_tsetmc import CodalQuery

query = CodalQuery()

نام نماد

query.set_symbol("وبملت")

از تاریخ

query.set_from_date("1400/01/01")

گروه اطلاعیه

query.set_letter_group('اطلاعات و صورت مالی سالانه')

نوع اطلاعیه

query.set_letter_type('اطلاعات و صورتهای مالی میاندوره ای')

حذف حسابرسی نشده‌ها یا حذف حسابرسی شده‌ها

query.set_not_audited(False)
# query.set_audited(False)

فقط زیر مجموعه‌ها

query.set_childs(False)

نمایش موارد تنظیم شده

query.params

{'PageNumber': 1,
 'Symbol': 'وبملت',
 'name': -1,
 'ReportingType': -1,
 'CompanyType': -1,
 'IndustryGroup': -1,
 'CompanyState': -1,
 'LetterType': 6,
 'Category': 1,
 'Subject': -1,
 'TracingNo': -1,
 'LetterCode': -1,
 'Length': -1,
 'FromDate': '1400/01/01',
 'ToDate': -1,
 'Audited': 'true',
 'NotAudited': 'false',
 'Consolidatable': 'true',
 'NotConsolidatable': 'true',
 'Childs': 'false',
 'Mains': 'true',
 'AuditorRef': -1,
 'YearEndToDate': -1,
 'Publisher': 'false'}

گرفتن لینک برای مرورگر

query.get_report_list_url()

'https://codal.ir/ReportList.aspx?search&PageNumber=1&Symbol=%D9%88%D8%A8%D9%85%D9%84%D8%AA&LetterType=6&Category=1&FromDate=1400%2F01%2F01&Audited=true&NotAudited=false&Consolidatable=true&NotConsolidatable=true&Childs=false&Mains=true&Publisher=false'

گرفتن لینک برای api

query.get_query_url()

'https://search.codal.ir/api/search/v2/q?&PageNumber=1&Symbol=%D9%88%D8%A8%D9%85%D9%84%D8%AA&LetterType=6&Category=1&FromDate=1400%2F01%2F01&Audited=true&NotAudited=false&Consolidatable=true&NotConsolidatable=true&Childs=false&Mains=true&Publisher=false&search=true'

گرفتن لیست گزارشات

query.get_api_multi_page()

[{'SuperVision': {'UnderSupervision': 0, 'AdditionalInfo': '', 'Reasons': []},
  'TracingNo': 1278431,
  'Symbol': 'وبملت',
  'CompanyName': 'بانک ملت',
  'UnderSupervision': 0,
  'Title': 'اطلاعات و صورت\u200cهای مالی میاندوره\u200cای تلفیقی دوره ۶ ماهه منتهی به  ۱۴۰۳/۰۶/۳۱ (حسابرسی شده)',
  'LetterCode': 'ن-۱۰',
  'SentDateTime': '۱۴۰۳/۰۹/۱۴ ۲۳:۲۳:۳۵',
  'PublishDateTime': '۱۴۰۳/۰۹/۱۴ ۲۳:۲۳:۳۵',
  'HasHtml': True,
  'IsEstimate': False,
  'Url': '/Reports/Decision.aspx?LetterSerial=qr1ypqX8jr8rIaRvVJxoNA%3d%3d&rt=3&let=6&ct=0&ft=-1',
  'HasExcel': True,
  'HasPdf': True,
  'HasXbrl': False,
  'HasAttachment': True,
  'AttachmentUrl': '/Reports/Attachment.aspx?LetterSerial=qr1ypqX8jr8rIaRvVJxoNA%3d%3d',
  'PdfUrl': 'DownloadFile.aspx?hs=qr1ypqX8jr8rIaRvVJxoNA%3d%3d&ft=1005&let=6',
  'ExcelUrl': 'https://excel.codal.ir/service/Excel/GetAll/qr1ypqX8jr8rIaRvVJxoNA%3d%3d/0',
  'XbrlUrl': '',
  'TedanUrl': 'http://www.tedan.ir'},
 {'SuperVision': {'UnderSupervision': 0, 'AdditionalInfo': '', 'Reasons': []},
  'TracingNo': 1204480,
  'Symbol': 'وبملت',
  'CompanyName': 'بانک ملت',
  'UnderSupervision': 0,
  'Title': 'صورت\u200cهای مالی تلفیقی سال مالی منتهی به ۱۴۰۲/۱۲/۲۹ (حسابرسی شده)',
  'LetterCode': 'ن-۱۰',
  'SentDateTime': '۱۴۰۳/۰۳/۳۰ ۰۲:۰۷:۲۲',
  'PublishDateTime': '۱۴۰۳/۰۳/۳۰ ۰۲:۰۷:۲۲',
  'HasHtml': True,
  'IsEstimate': False,
  'Url': '/Reports/Decision.aspx?LetterSerial=mqr3xE1pbbVIinxpqdX7kQ%3d%3d&rt=3&let=6&ct=0&ft=-1',
  'HasExcel': True,
  'HasPdf': True,
  'HasXbrl': False,
  'HasAttachment': True,
  'AttachmentUrl': '/Reports/Attachment.aspx?LetterSerial=mqr3xE1pbbVIinxpqdX7kQ%3d%3d',
  'PdfUrl': 'DownloadFile.aspx?hs=mqr3xE1pbbVIinxpqdX7kQ%3d%3d&ft=1005&let=6',
  'ExcelUrl': 'https://excel.codal.ir/service/Excel/GetAll/mqr3xE1pbbVIinxpqdX7kQ%3d%3d/0',
  'XbrlUrl': '',
  'TedanUrl': 'http://www.tedan.ir'},
 {'SuperVision': {'UnderSupervision': 0, 'AdditionalInfo': '', 'Reasons': []},
  'TracingNo': 1116260,
  'Symbol': 'وبملت',
  'CompanyName': 'بانک ملت',
  'UnderSupervision': 0,
  'Title': 'اطلاعات و صورت\u200cهای مالی میاندوره\u200cای تلفیقی دوره ۶ ماهه منتهی به  ۱۴۰۲/۰۶/۳۱ (حسابرسی شده)',
  'LetterCode': 'ن-۱۰',
  'SentDateTime': '۱۴۰۲/۰۹/۱۵ ۲۰:۰۳:۳۵',
  'PublishDateTime': '۱۴۰۲/۰۹/۱۵ ۲۰:۰۳:۳۵',
  'HasHtml': True,
  'IsEstimate': False,
  'Url': '/Reports/Decision.aspx?LetterSerial=OVLjMIHaAZsXZK6TitYWxQ%3d%3d&rt=3&let=6&ct=0&ft=-1',
  'HasExcel': True,
  'HasPdf': True,
  'HasXbrl': False,
  'HasAttachment': True,
  'AttachmentUrl': '/Reports/Attachment.aspx?LetterSerial=OVLjMIHaAZsXZK6TitYWxQ%3d%3d',
  'PdfUrl': 'DownloadFile.aspx?hs=OVLjMIHaAZsXZK6TitYWxQ%3d%3d&ft=1005&let=6',
  'ExcelUrl': 'https://excel.codal.ir/service/Excel/GetAll/OVLjMIHaAZsXZK6TitYWxQ%3d%3d/0',
  'XbrlUrl': '',
  'TedanUrl': 'http://www.tedan.ir'},
 {'SuperVision': {'UnderSupervision': 0, 'AdditionalInfo': '', 'Reasons': []},
  'TracingNo': 1041366,
  'Symbol': 'وبملت',
  'CompanyName': 'بانک ملت',
  'UnderSupervision': 0,
  'Title': 'صورت\u200cهای مالی تلفیقی سال مالی منتهی به ۱۴۰۱/۱۲/۲۹ (حسابرسی شده)',
  'LetterCode': 'ن-۱۰',
  'SentDateTime': '۱۴۰۲/۰۳/۲۸ ۲۰:۲۹:۵۴',
  'PublishDateTime': '۱۴۰۲/۰۳/۲۸ ۲۰:۲۹:۵۴',
  'HasHtml': True,
  'IsEstimate': False,
  'Url': '/Reports/Decision.aspx?LetterSerial=5mk9zW2T9eTUWjPZUakQQQaQQQ8A%3d%3d&rt=3&let=6&ct=0&ft=-1',
  'HasExcel': True,
  'HasPdf': True,
  'HasXbrl': False,
  'HasAttachment': True,
  'AttachmentUrl': '/Reports/Attachment.aspx?LetterSerial=5mk9zW2T9eTUWjPZUakQQQaQQQ8A%3d%3d',
  'PdfUrl': 'DownloadFile.aspx?hs=5mk9zW2T9eTUWjPZUakQQQaQQQ8A%3d%3d&ft=1005&let=6',
  'ExcelUrl': 'https://excel.codal.ir/service/Excel/GetAll/5mk9zW2T9eTUWjPZUakQQQaQQQ8A%3d%3d/0',
  'XbrlUrl': '',
  'TedanUrl': 'http://www.tedan.ir'},
 {'SuperVision': {'UnderSupervision': 0, 'AdditionalInfo': '', 'Reasons': []},
  'TracingNo': 966408,
  'Symbol': 'وبملت',
  'CompanyName': 'بانک ملت',
  'UnderSupervision': 0,
  'Title': 'اطلاعات و صورت\u200cهای مالی میاندوره\u200cای تلفیقی دوره ۶ ماهه منتهی به  ۱۴۰۱/۰۶/۳۱ (حسابرسی شده)',
  'LetterCode': 'ن-۱۰',
  'SentDateTime': '۱۴۰۱/۰۹/۱۵ ۱۹:۵۶:۵۷',
  'PublishDateTime': '۱۴۰۱/۰۹/۱۵ ۱۹:۵۶:۵۷',
  'HasHtml': True,
  'IsEstimate': False,
  'Url': '/Reports/Decision.aspx?LetterSerial=OrRG4vaz36UjbkVcznu8fA%3d%3d&rt=3&let=6&ct=0&ft=-1',
  'HasExcel': True,
  'HasPdf': True,
  'HasXbrl': False,
  'HasAttachment': True,
  'AttachmentUrl': '/Reports/Attachment.aspx?LetterSerial=OrRG4vaz36UjbkVcznu8fA%3d%3d',
  'PdfUrl': 'DownloadFile.aspx?hs=OrRG4vaz36UjbkVcznu8fA%3d%3d&ft=1005&let=6',
  'ExcelUrl': 'https://excel.codal.ir/service/Excel/GetAll/OrRG4vaz36UjbkVcznu8fA%3d%3d/0',
  'XbrlUrl': '',
  'TedanUrl': 'http://www.tedan.ir'},
 {'SuperVision': {'UnderSupervision': 0, 'AdditionalInfo': '', 'Reasons': []},
  'TracingNo': 896865,
  'Symbol': 'وبملت',
  'CompanyName': 'بانک ملت',
  'UnderSupervision': 0,
  'Title': 'صورت\u200cهای مالی تلفیقی سال مالی منتهی به ۱۴۰۰/۱۲/۲۹ (حسابرسی شده)',
  'LetterCode': 'ن-۱۰',
  'SentDateTime': '۱۴۰۱/۰۳/۲۹ ۰۰:۰۲:۰۱',
  'PublishDateTime': '۱۴۰۱/۰۳/۲۹ ۰۰:۰۲:۰۱',
  'HasHtml': True,
  'IsEstimate': False,
  'Url': '/Reports/Decision.aspx?LetterSerial=YLhTbKc77KtnbMHocooRSQ%3d%3d&rt=3&let=6&ct=0&ft=-1',
  'HasExcel': True,
  'HasPdf': True,
  'HasXbrl': False,
  'HasAttachment': True,
  'AttachmentUrl': '/Reports/Attachment.aspx?LetterSerial=YLhTbKc77KtnbMHocooRSQ%3d%3d',
  'PdfUrl': 'DownloadFile.aspx?hs=YLhTbKc77KtnbMHocooRSQ%3d%3d&ft=1005&let=6',
  'ExcelUrl': 'https://excel.codal.ir/service/Excel/GetAll/YLhTbKc77KtnbMHocooRSQ%3d%3d/0',
  'XbrlUrl': '',
  'TedanUrl': 'http://www.tedan.ir'},
 {'SuperVision': {'UnderSupervision': 0, 'AdditionalInfo': '', 'Reasons': []},
  'TracingNo': 825953,
  'Symbol': 'وبملت',
  'CompanyName': 'بانک ملت',
  'UnderSupervision': 0,
  'Title': 'اطلاعات و صورت\u200cهای مالی میاندوره\u200cای تلفیقی دوره ۶ ماهه منتهی به ۱۴۰۰/۰۶/۳۱ (حسابرسی شده)',
  'LetterCode': 'ن-۱۰',
  'SentDateTime': '۱۴۰۰/۰۹/۱۵ ۲۲:۰۱:۳۲',
  'PublishDateTime': '۱۴۰۰/۰۹/۱۵ ۲۲:۰۱:۳۲',
  'HasHtml': True,
  'IsEstimate': False,
  'Url': '/Reports/Decision.aspx?LetterSerial=TLOQ83KhULOFMQQQaQQQYZIZ5H5A%3D%3D&rt=3&let=6&ct=0&ft=-1',
  'HasExcel': True,
  'HasPdf': True,
  'HasXbrl': False,
  'HasAttachment': True,
  'AttachmentUrl': '/Reports/Attachment.aspx?LetterSerial=TLOQ83KhULOFMQQQaQQQYZIZ5H5A%3d%3d',
  'PdfUrl': 'DownloadFile.aspx?hs=TLOQ83KhULOFMQQQaQQQYZIZ5H5A%3d%3d&ft=1005&let=6',
  'ExcelUrl': 'https://excel.codal.ir/service/Excel/GetAll/TLOQ83KhULOFMQQQaQQQYZIZ5H5A%3d%3d/0',
  'XbrlUrl': '',
  'TedanUrl': 'http://www.tedan.ir'},
 {'SuperVision': {'UnderSupervision': 0, 'AdditionalInfo': '', 'Reasons': []},
  'TracingNo': 768588,
  'Symbol': 'وبملت',
  'CompanyName': 'بانک ملت',
  'UnderSupervision': 0,
  'Title': 'صورت\u200cهای مالی تلفیقی سال مالی منتهی به ۱۳۹۹/۱۲/۳۰ (حسابرسی شده)',
  'LetterCode': 'ن-۱۰',
  'SentDateTime': '۱۴۰۰/۰۴/۲۰ ۱۱:۲۰:۳۶',
  'PublishDateTime': '۱۴۰۰/۰۴/۲۰ ۱۱:۲۰:۳۶',
  'HasHtml': True,
  'IsEstimate': False,
  'Url': '/Reports/Decision.aspx?LetterSerial=Qlz4uFzkkEGRvIQUhty5IQ%3D%3D&rt=3&let=6&ct=0&ft=-1',
  'HasExcel': True,
  'HasPdf': True,
  'HasXbrl': False,
  'HasAttachment': True,
  'AttachmentUrl': '/Reports/Attachment.aspx?LetterSerial=Qlz4uFzkkEGRvIQUhty5IQ%3d%3d',
  'PdfUrl': 'DownloadFile.aspx?hs=Qlz4uFzkkEGRvIQUhty5IQ%3d%3d&ft=1005&let=6',
  'ExcelUrl': 'https://excel.codal.ir/service/Excel/GetAll/Qlz4uFzkkEGRvIQUhty5IQ%3d%3d/0',
  'XbrlUrl': '',
  'TedanUrl': 'http://www.tedan.ir'}]

گرفتن تمام صفحات و ذخیره آن درون شی

query.get_letters()

نمایش صفحات ذخیره شده

query.letters

	super_vision	tracing_no	symbol	company_name	title	letter_code	sent_date_time	publish_date_time	has_html	...	url	has_excel	has_pdf	has_xbrl	has_attachment	attachment_url	pdf_url	excel_url	tedan_url
0	{'UnderSupervision': 0, 'AdditionalInfo': '', ...	1278431	وبملت	بانک ملت	اطلاعات و صورت‌های مالی میاندوره‌ای تلفیقی دور...	ن-10	1403/09/14 23:23:35	1403/09/14 23:23:35	True	...	/Reports/Decision.aspx?LetterSerial=qr1ypqX8jr...	True	True	False	True	/Reports/Attachment.aspx?LetterSerial=qr1ypqX8...	DownloadFile.aspx?hs=qr1ypqX8jr8rIaRvVJxoNA%3d...	https://excel.codal.ir/service/Excel/GetAll/qr...	http://www.tedan.ir
1	{'UnderSupervision': 0, 'AdditionalInfo': '', ...	1204480	وبملت	بانک ملت	صورت‌های مالی تلفیقی سال مالی منتهی به 1402/12...	ن-10	1403/03/30 02:07:22	1403/03/30 02:07:22	True	...	/Reports/Decision.aspx?LetterSerial=mqr3xE1pbb...	True	True	False	True	/Reports/Attachment.aspx?LetterSerial=mqr3xE1p...	DownloadFile.aspx?hs=mqr3xE1pbbVIinxpqdX7kQ%3d...	https://excel.codal.ir/service/Excel/GetAll/mq...	http://www.tedan.ir
2	{'UnderSupervision': 0, 'AdditionalInfo': '', ...	1116260	وبملت	بانک ملت	اطلاعات و صورت‌های مالی میاندوره‌ای تلفیقی دور...	ن-10	1402/09/15 20:03:35	1402/09/15 20:03:35	True	...	/Reports/Decision.aspx?LetterSerial=OVLjMIHaAZ...	True	True	False	True	/Reports/Attachment.aspx?LetterSerial=OVLjMIHa...	DownloadFile.aspx?hs=OVLjMIHaAZsXZK6TitYWxQ%3d...	https://excel.codal.ir/service/Excel/GetAll/OV...	http://www.tedan.ir
3	{'UnderSupervision': 0, 'AdditionalInfo': '', ...	1041366	وبملت	بانک ملت	صورت‌های مالی تلفیقی سال مالی منتهی به 1401/12...	ن-10	1402/03/28 20:29:54	1402/03/28 20:29:54	True	...	/Reports/Decision.aspx?LetterSerial=5mk9zW2T9e...	True	True	False	True	/Reports/Attachment.aspx?LetterSerial=5mk9zW2T...	DownloadFile.aspx?hs=5mk9zW2T9eTUWjPZUakQQQaQQ...	https://excel.codal.ir/service/Excel/GetAll/5m...	http://www.tedan.ir
4	{'UnderSupervision': 0, 'AdditionalInfo': '', ...	966408	وبملت	بانک ملت	اطلاعات و صورت‌های مالی میاندوره‌ای تلفیقی دور...	ن-10	1401/09/15 19:56:57	1401/09/15 19:56:57	True	...	/Reports/Decision.aspx?LetterSerial=OrRG4vaz36...	True	True	False	True	/Reports/Attachment.aspx?LetterSerial=OrRG4vaz...	DownloadFile.aspx?hs=OrRG4vaz36UjbkVcznu8fA%3d...	https://excel.codal.ir/service/Excel/GetAll/Or...	http://www.tedan.ir
5	{'UnderSupervision': 0, 'AdditionalInfo': '', ...	896865	وبملت	بانک ملت	صورت‌های مالی تلفیقی سال مالی منتهی به 1400/12...	ن-10	1401/03/29 00:02:01	1401/03/29 00:02:01	True	...	/Reports/Decision.aspx?LetterSerial=YLhTbKc77K...	True	True	False	True	/Reports/Attachment.aspx?LetterSerial=YLhTbKc7...	DownloadFile.aspx?hs=YLhTbKc77KtnbMHocooRSQ%3d...	https://excel.codal.ir/service/Excel/GetAll/YL...	http://www.tedan.ir
6	{'UnderSupervision': 0, 'AdditionalInfo': '', ...	825953	وبملت	بانک ملت	اطلاعات و صورت‌های مالی میاندوره‌ای تلفیقی دور...	ن-10	1400/09/15 22:01:32	1400/09/15 22:01:32	True	...	/Reports/Decision.aspx?LetterSerial=TLOQ83KhUL...	True	True	False	True	/Reports/Attachment.aspx?LetterSerial=TLOQ83Kh...	DownloadFile.aspx?hs=TLOQ83KhULOFMQQQaQQQYZIZ5...	https://excel.codal.ir/service/Excel/GetAll/TL...	http://www.tedan.ir
7	{'UnderSupervision': 0, 'AdditionalInfo': '', ...	768588	وبملت	بانک ملت	صورت‌های مالی تلفیقی سال مالی منتهی به 1399/12...	ن-10	1400/04/20 11:20:36	1400/04/20 11:20:36	True	...	/Reports/Decision.aspx?LetterSerial=Qlz4uFzkkE...	True	True	False	True	/Reports/Attachment.aspx?LetterSerial=Qlz4uFzk...	DownloadFile.aspx?hs=Qlz4uFzkkEGRvIQUhty5IQ%3d...	https://excel.codal.ir/service/Excel/GetAll/Ql...	http://www.tedan.ir

8 rows × 21 columns

گرفتن و ذخیره لیست گزارشات برای چند نماد با سرعت بالا در دیتابیس

from codal_tsetmc.download.codal.letters import update_letters_table

update_letters_table(query, ["فولاد", "فملی", "شپنا"])

Set letter url for: فولاد
Set letter url for: فملی
Set letter url for: شپنا
None

False

گرفتن لیست گزارشات نماد خاص در دیتابیس

from codal_tsetmc.tools.database import read_table_by_conditions

read_table_by_conditions(
  table="letter", 
  variable="symbol",
  value="فولاد"
)

	id	publish_date_time	sent_date_time	tracing_no	serial	title	code	type	symbol	company_name	has_html	has_pdf	has_excel	has_attachment
0	12	14031107185314	14031107185314	1289196	MUqRrXY475SCkpKozft7Iw%3d%3d	اطلاعات و صورت های مالی میاندوره ای تلفیقی دور...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فولاد	فولاد مبارکه اصفهان	1	1	1	1
1	13	14030425171805	14030425171805	1215033	0mf0cmSamvZHlER7R7kPOA%3d%3d	صورت های مالی تلفیقی سال مالی منتهی به 1402/12...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فولاد	فولاد مبارکه اصفهان	1	1	1	1
2	14	14021107184454	14021107184454	1096229	4aQQQaQQQJI3W6uTKLoHuoFjH7zA%3d%3d	اطلاعات و صورت های مالی میاندوره ای تلفیقی دور...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فولاد	فولاد مبارکه اصفهان	1	1	1	1
3	15	14020426214952	14020426214952	1055774	SS97V5jtRN0QQQaQQQscZebQQQaQQQvRwg%3d%3d	صورت های مالی تلفیقی سال مالی منتهی به 1401/12...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فولاد	فولاد مبارکه اصفهان	1	1	1	1
4	16	14011029125540	14011029125540	982256	QQQaQQQtdXtHxpzUX3vJk1C1JfUw%3d%3d	اطلاعات و صورت های مالی میاندوره ای تلفیقی دور...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فولاد	فولاد مبارکه اصفهان	1	1	1	1
5	17	14010509103042	14010509103042	912864	AuFIYwI3LY424zd3p4ij5A%3d%3d	صورت های مالی تلفیقی سال مالی منتهی به 1400/12...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فولاد	فولاد مبارکه اصفهان	1	1	1	1
6	18	14001124155735	14001124155735	852911	cQd9yigizoTueJdP5SZofw%3D%3D	اطلاعات و صورت های مالی میاندوره ای تلفیقی دور...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فولاد	فولاد مبارکه اصفهان	1	1	1	1
7	19	14000507165312	14000507165312	762282	NDR8Dkp6Fm%2BEHtNIfHDW5A%3D%3D	صورت های مالی تلفیقی سال مالی منتهی به 1399/12...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فولاد	فولاد مبارکه اصفهان	1	1	1	1

گرفتن لیست گزارشات از دیتابیس با کوئری

from codal_tsetmc.tools.database import read_table_by_sql_query

df = read_table_by_sql_query(
    """
  SELECT *
  FROM letter
  WHERE symbol IN (
    'فولاد',
    'فملی',
    'شپنا'
  )
  """
)

df.head()

	id	publish_date_time	sent_date_time	tracing_no	serial	title	code	type	symbol	company_name	has_html	has_pdf	has_excel	has_attachment
0	1	14030915205600	14030915205600	1279929	DCHTHUienVquZ4us1iGDDw%3d%3d	اطلاعات و صورت های مالی میاندوره ای تلفیقی دور...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فملی	ملی صنایع مس ایران	1	1	1	1
1	2	14030420235235	14030420235235	1215869	xjjQPlJWJeiObfjSfQQQaQQQPyxQ%3d%3d	صورت های مالی تلفیقی سال مالی منتهی به 1402/12...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فملی	ملی صنایع مس ایران	1	1	1	1
2	3	14020916021316	14020916021316	1117547	m7Al4zMK6ehzTl5IYHXJMw%3d%3d	اطلاعات و صورت های مالی میاندوره ای تلفیقی دور...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فملی	ملی صنایع مس ایران	1	1	1	1
3	4	14020421234934	14020421234934	1053560	uNTArPkEcdZwlQ3qCxrlGA%3d%3d	صورت های مالی تلفیقی سال مالی منتهی به 1401/12...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فملی	ملی صنایع مس ایران	1	1	1	1
4	5	14010915211100	14010915211100	967888	ysRiJ5CYn9VX%2bdsPleOp8A%3d%3d	اطلاعات و صورت های مالی میاندوره ای تلفیقی دور...	ن - 10	اطلاعات و صورتهای مالی میاندوره ای	فملی	ملی صنایع مس ایران	1	1	1	1