skatteetaten-shared
Skill base para o CLI skt, um cliente não oficial, somente leitura dos próprios dados fiscais noruegueses de uma pessoa física no portal Min skatt da Skatteetaten. Leia isto antes de usar qualquer outra skill skatteetaten.
São dados fiscais reais e sensíveis, e esta ferramenta é não oficial. Seja conservador. skt não possui API oficial por trás: ele faz login com o BankID do usuário como um navegador e lê os endpoints JSON internos não documentados do portal usando o cookie de sessão. É somente leitura (nunca envia ou edita) e deve ser usado exclusivamente sobre os próprios dados do usuário. Nunca invente valores, números de conta ou anos; aja apenas com base no que os comandos retornam ou no que o usuário informa. Se o usuário solicitar um envio/edição/alteração, recuse — está deliberadamente fora do escopo. Consulte TERMS.md.
Instalação e configuração inicial
cargo install --path . # instala o binário `skt`
Uma vez, o usuário deve fazer isso pessoalmente (precisa do BankID e de um navegador):
- Ter o Google Chrome ou Chromium instalado (usado apenas durante o login).
skt login— abre um navegador; o usuário completa o BankID;sktcaptura o cookie de sessão do Min skatt via CDP e o armazena.
Não execute skt login em nome do usuário sem perguntar — ele abre um navegador e dispara um fluxo interativo de BankID.
Autenticação e modelo de sessão
skt status # quando foi capturada? qual backend de armazenamento?
skt whoami # verificação real mais barata — valida a sessão, imprime o nome do usuário
skt logout # remove a sessão armazenada
Não há token de atualização. Diferente de um CLI OAuth normal, as sessões do Min skatt são curtas e expiram silenciosamente. Consequências para você:
- Se uma leitura falhar com erro de autenticação (ou
skt whoamifalhar), a sessão expirou — diga ao usuário para executarskt loginnovamente. Não tente novamente em loop. skt statusmostra o momento da captura, mas não pode provar validade; apenas uma requisição pode. Useskt whoamipara verificar antes de um lote de leituras.
Os segredos ficam em um de três backends, escolhido por SKT_STORE:
SKT_STORE | Onde |
|---|---|
não definido / keychain | Keychain do SO (macOS Keychain / Linux keyutils / Windows Credential Manager), padrão |
op / 1password | 1Password via o CLI op (SKT_OP_VAULT, SKT_OP_ACCOUNT) |
file | ~/.config/skatteetaten-cli/*.json (0600), texto puro, opt-in para uso headless |
Saída e flags
- A saída padrão são tabelas legíveis para humanos (valores noruegueses:
kr 1 234,56). - Adicione
--jsona qualquer comando para saída legível por máquina — use sempre isso ao processar programaticamente. - Adicione
--maskpara ocultar valores e números de conta nas tabelas (para capturas de tela). - Erros são impressos no stderr com código de saída não zero.
Mapa de comandos
| Comando | Finalidade |
|---|---|
login / logout / status / whoami | autenticação e saúde da sessão |
skattekort | itens da linha do cartão fiscal para o ano ativo (rótulos vindos do dicionário do portal) |
skattemelding [--year N] | declaração de imposto para um ano (padrão é o mais recente entregue) |
oppgjor | skatteoppgjør / página inicial do Min skatt (restskatt, conta, KID) — JSON bruto |
Anos: skattekort usa o ano de renda ativo da configuração do portal; skattemelding usa como padrão o ano anterior. Use --year para escolher outro.
Reconciliação com o banco (o caso de uso principal)
O objetivo do skt é verificar os números do fisco contra a realidade:
skt skattemelding --json | jq '.visningsdata.konto[]
| {bank: .bankensNavn, konto: .kontonummer,
innskudd: .innskudd.beloep, renter: .opptjenteRenter.beloep}'
Cada entrada konto é uma conta bancária com seu depósito e juros ganhos conforme a Skatteetaten os possui. Cruze esses dados com sb1 (o CLI do SpareBank 1): os saldos e juros correspondem ao que o banco realmente reporta? Use as skills sparebank1-* para o lado bancário.
Etiqueta
Endpoints não documentados e não oficiais. Faça uma requisição por chamada; nunca adicione loops de tentativas/polling. Mantenha tudo somente leitura e sobre os próprios dados do usuário. Nunca exponha o cookie de sessão na saída (o CLI já o redaciona).