TJSP¶

Inicialmente instalamos o pacote

In [1]:

# Instala
!pip3 install tjsp_correcao_monetaria --upgrade

# Instala !pip3 install tjsp_correcao_monetaria --upgrade

Collecting tjsp_correcao_monetaria

  Downloading tjsp_correcao_monetaria-0.1.1-py3-none-any.whl.metadata (2.9 kB)
Requirement already satisfied: pandas>=2.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from tjsp_correcao_monetaria) (3.0.0)
Requirement already satisfied: requests-cache>=1.2.1 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from tjsp_correcao_monetaria) (1.2.1)
Requirement already satisfied: tabula-py>=2.10.0 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from tjsp_correcao_monetaria) (2.10.0)
Requirement already satisfied: numpy>=1.26.0 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from pandas>=2.0.0->tjsp_correcao_monetaria) (2.4.2)
Requirement already satisfied: python-dateutil>=2.8.2 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from pandas>=2.0.0->tjsp_correcao_monetaria) (2.9.0.post0)
Requirement already satisfied: six>=1.5 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from python-dateutil>=2.8.2->pandas>=2.0.0->tjsp_correcao_monetaria) (1.17.0)
Requirement already satisfied: attrs>=21.2 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from requests-cache>=1.2.1->tjsp_correcao_monetaria) (25.4.0)
Requirement already satisfied: cattrs>=22.2 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from requests-cache>=1.2.1->tjsp_correcao_monetaria) (25.3.0)
Requirement already satisfied: platformdirs>=2.5 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from requests-cache>=1.2.1->tjsp_correcao_monetaria) (4.5.1)
Requirement already satisfied: requests>=2.22 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from requests-cache>=1.2.1->tjsp_correcao_monetaria) (2.32.5)
Requirement already satisfied: url-normalize>=1.4 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from requests-cache>=1.2.1->tjsp_correcao_monetaria) (2.2.1)
Requirement already satisfied: urllib3>=1.25.5 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from requests-cache>=1.2.1->tjsp_correcao_monetaria) (2.6.3)

Requirement already satisfied: typing-extensions>=4.14.0 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from cattrs>=22.2->requests-cache>=1.2.1->tjsp_correcao_monetaria) (4.15.0)
Requirement already satisfied: charset_normalizer<4,>=2 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from requests>=2.22->requests-cache>=1.2.1->tjsp_correcao_monetaria) (3.4.4)
Requirement already satisfied: idna<4,>=2.5 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from requests>=2.22->requests-cache>=1.2.1->tjsp_correcao_monetaria) (3.11)
Requirement already satisfied: certifi>=2017.4.17 in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from requests>=2.22->requests-cache>=1.2.1->tjsp_correcao_monetaria) (2026.1.4)
Requirement already satisfied: distro in /home/docs/checkouts/readthedocs.org/user_builds/tjsp-correcao-monetaria/envs/latest/lib/python3.11/site-packages (from tabula-py>=2.10.0->tjsp_correcao_monetaria) (1.9.0)
Downloading tjsp_correcao_monetaria-0.1.1-py3-none-any.whl (8.0 kB)

Installing collected packages: tjsp_correcao_monetaria
Successfully installed tjsp_correcao_monetaria-0.1.1

Após isso é possível importar o pacote, que contem uma classe.

In [2]:

from datetime import date

import tjsp

from datetime import date import tjsp

Ao instanciar a classe, já será obtida a tabela atualizada e será apresentada, chamando a propriedade df.

In [3]:

tj = tjsp.TJSP()

tj = tjsp.TJSP()

Failed to import jpype dependencies. Fallback to subprocess.

No module named 'jpype'

A propriedade df é, na sua essência, um dataframe Pandas.

In [4]:

tj.df.head()

tj.df.head()

Out[4]:

	data	data_ref	ano	mes	taxa
0	1964-10-01	1964-10	1964	10	10000.0
1	1964-11-01	1964-11	1964	11	10000.0
2	1964-12-01	1964-12	1964	12	10000.0
3	1965-01-01	1965-01	1965	1	11300.0
4	1965-02-01	1965-02	1965	2	11300.0

---

Salvando PDF¶

É possível salvar o arquivo pdf obtido (para obter as tabelas) em um local no PC.

In [5]:

# Se não definir um filepath, salvará com nome de "tabela_debitos_judiciais.pdf"
# tj.save_pdf()

# Se não definir um filepath, salvará com nome de "tabela_debitos_judiciais.pdf" # tj.save_pdf()

In [6]:

# Se definir, salvará onde deseja o com o nome que deseja. Lembre-se de colocar a extensão .pdf.
tj.save_pdf(filepath=tjsp.data_path / 'tabela_debitos_judiciais.pdf')

# Se definir, salvará onde deseja o com o nome que deseja. Lembre-se de colocar a extensão .pdf. tj.save_pdf(filepath=tjsp.data_path / 'tabela_debitos_judiciais.pdf')

---

Salvando CSV¶

É possível salvar o arquivo csv criado em um local no PC.

In [7]:

# Se não definir um filepath, salvará com nome de "tabela_debitos_judiciais.csv"
# tj.save_csv()

# Se não definir um filepath, salvará com nome de "tabela_debitos_judiciais.csv" # tj.save_csv()

In [8]:

# Se definir, salvará onde deseja o com o nome que deseja. Lembre-se de colocar a extensão .csv.
tj.save_csv(filepath=tjsp.data_path / 'tabela_debitos_judiciais.csv')

# Se definir, salvará onde deseja o com o nome que deseja. Lembre-se de colocar a extensão .csv. tj.save_csv(filepath=tjsp.data_path / 'tabela_debitos_judiciais.csv')

---

Obtendo Valores¶

Por fim, é possível obter o valor para uma data, podendo ser uma string no formato YYYY-MM-DD.

In [9]:

tj.get_value_from_date(data='2026-01-01')

tj.get_value_from_date(data='2026-01-01')

Out[9]:

{'data': Timestamp('2026-01-01 00:00:00'),
 'data_ref': '2026-01',
 'ano': 2026,
 'mes': 1,
 'taxa': 101.977695}

Ou também pode-se passar no formato datetime.date.

In [10]:

tj.get_value_from_date(data=date(2026, 1, 1))

tj.get_value_from_date(data=date(2026, 1, 1))

Out[10]:

{'data': Timestamp('2026-01-01 00:00:00'),
 'data_ref': '2026-01',
 'ano': 2026,
 'mes': 1,
 'taxa': 101.977695}

É possível também pegar o último valor. Isso é especialmente útil pois o TJSP pode atrasar alguns dias no início do mês para divulgar a nova taxa e isso permite qualquer calculo com a taxa mais atual.

In [11]:

tj.get_last_value()

tj.get_last_value()

Out[11]:

{'data': Timestamp('2026-01-01 00:00:00'),
 'data_ref': '2026-01',
 'ano': 2026,
 'mes': 1,
 'taxa': 101.977695}