https://github.com/rgl/caderneta-predial
Descarrega todas as tuas cadernetas prediais disponíveis no Portal das Finanças
https://github.com/rgl/caderneta-predial
caderneta government government-data playwright portaldasfinancas portugal predial pt
Last synced: about 1 month ago
JSON representation
Descarrega todas as tuas cadernetas prediais disponíveis no Portal das Finanças
- Host: GitHub
- URL: https://github.com/rgl/caderneta-predial
- Owner: rgl
- Created: 2023-09-17T15:07:56.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-26T18:40:03.000Z (5 months ago)
- Last Synced: 2026-01-27T06:29:04.343Z (5 months ago)
- Topics: caderneta, government, government-data, playwright, portaldasfinancas, portugal, predial, pt
- Language: TypeScript
- Homepage:
- Size: 97.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Sobre
[](https://github.com/rgl/caderneta-predial/actions/workflows/playwright.yml)
Esta aplicação descarrega todas as tuas cadernetas prediais disponíveis no [Portal das Finanças](https://imoveis.portaldasfinancas.gov.pt/matrizesinter/web/consultar-patrimonio-predial).
# Uso (Ubuntu 24.04)
Instala o [node](https://nodejs.org).
Instala as dependencias:
```bash
npm ci
npx playwright install --with-deps chromium
```
Configura as tuas credenciais de acesso ao Portal das Finanças:
```bash
cat >.env <<'EOF'
CADERNETA_PREDIAL_NIF = 'o teu NIF'
CADERNETA_PREDIAL_SENHA = 'a tua senha'
EOF
```
Inicializa o repositório de git para guardar os resultados:
```bash
install -d data
(cd data && git init)
```
Executa a aplicação:
```bash
rm -f .auth.json
npm run test
```
Verifica que as cadernetas prediais foram descarregadas para a directoria `data`:
```bash
find data
```
Verifica as alterações, e potencialmente, faz commit:
```bash
(cd data && git status)
#(cd data && git add . && git commit -m update)
```
Abre o documento HTML:
```bash
for f in data/*.html; do xdg-open "$f"; done
```
# NIF de teste
Para testar a página de autenticação, podes usar um dos seguintes NIF (que
provavelmente não estão atribuídos) de teste:
* `100000010`
* `100000029`
* `100000037`
**NB** Não uses o `100000002`, pois já é usado internamente pelos testes
unitários.