Referência das ferramentas

Todas as ferramentas devolvem um objeto JSON como texto. As entradas são validadas com zod.

validate_nif

Valida um NIF português e classifica o contribuinte.

• Entrada: { nif: string }
• Saída: { nif, valid: boolean, entityType: string | null }

{ "nif": "123456789", "valid": true, "entityType": "Pessoa singular" }

validate_iban

Valida um IBAN pelo checksum ISO 7064 mod-97.

• Entrada: { iban: string }
• Saída: { iban, valid: boolean, portuguese: boolean }

{ "iban": "PT50000201231234567890154", "valid": true, "portuguese": true }

validate_postal_code

Valida um código postal CP7 (NNNN-NNN).

• Entrada: { postalCode: string }
• Saída: { postalCode, valid: boolean }

list_holidays

Lista os feriados nacionais obrigatórios de Portugal para um ano, incluindo os móveis (baseados na Páscoa). Feriados municipais e a Terça-feira de Carnaval (facultativa) são excluídos, por não serem nacionais por lei.

• Entrada: { year: number } (1970–2100)
• Saída: { year, holidays: Array<{ date, name, movable }> }

{
  "year": 2026,
  "holidays": [
    { "date": "2026-01-01", "name": "Ano Novo", "movable": false },
    { "date": "2026-04-03", "name": "Sexta-feira Santa", "movable": true }
  ]
}

is_holiday

Indica se uma data é feriado nacional.

• Entrada: { date: string } (AAAA-MM-DD)
• Saída: { date, holiday: boolean }

Notas

• Os validadores verificam apenas estrutura e dígitos de controlo — não se um identificador está de facto atribuído/ativo.
• As datas dos feriados são calculadas (Páscoa pelo algoritmo Gregoriano Anónimo), por isso qualquer ano funciona offline.