import { useEffect, useState } from 'react'; import { fiscalComponentCodes } from '@/lib/simulation-contract'; type Parameter = { parameter_code: string; status: string; value: string | null; unit?: string; scope_key?: string; rule_code?: string; rule_version?: number; validity?: { start: string; end: string | null }; source?: { title: string; diploma: string | null; article: string | null; url: string | null }; }; const labels: Record = { indeterminate_missing: 'Não existe parâmetro aprovado para este âmbito e período.', indeterminate_context: 'As condições publicadas não correspondem às respostas indicadas.', indeterminate_scope: 'O âmbito da regra não está suficientemente definido.', indeterminate_overlap: 'Há regras sobrepostas; é necessária revisão.', indeterminate_period_change: 'A vigência muda dentro do período seleccionado.', indeterminate_invalid: 'O parâmetro publicado não passou a validação de formato.', }; const apiComponents: Record = { irpc: 'IRPC', iva: 'IVA', ispc: 'ISPC', irps: 'IRPS', inss: 'INSS', withholding: 'RETENCOES', retenções: 'RETENCOES', }; function getXsrfToken(): string { return decodeURIComponent(document.cookie.split('; ').find((cookie) => cookie.startsWith('XSRF-TOKEN='))?.slice(11) ?? ''); } export function SimulationFiscalStatus({ salaryView, scenarioMode, component, periodStart, periodEnd, context, }: { salaryView?: string; scenarioMode?: string; component?: string; periodStart?: string; periodEnd?: string; context?: Record; }) { const [parameters, setParameters] = useState([]); const [requestState, setRequestState] = useState('idle'); useEffect(() => { const apiComponent = component ? apiComponents[component.toLowerCase()] : undefined; if (scenarioMode !== 'approved_parameters' || !apiComponent || !periodStart || !periodEnd) { setParameters([]); setRequestState('idle'); return; } const abort = new AbortController(); setRequestState('loading'); void fetch('/api/v1/tax-parameters/resolve', { method: 'POST', credentials: 'same-origin', signal: abort.signal, headers: { 'Content-Type': 'application/json', Accept: 'application/json', 'X-XSRF-TOKEN': getXsrfToken() }, body: JSON.stringify({ component: apiComponent, period_start: periodStart, period_end: periodEnd, context: context ?? {} }), }).then(async (response) => { if (!response.ok) throw new Error('lookup_failed'); const payload = await response.json() as { parameters?: Parameter[] }; setParameters(Array.isArray(payload.parameters) ? payload.parameters : []); setRequestState('done'); }).catch((error: unknown) => { if (error instanceof DOMException && error.name === 'AbortError') return; setParameters([]); setRequestState('error'); }); return () => abort.abort(); }, [scenarioMode, component, periodStart, periodEnd, JSON.stringify(context ?? {})]); const salaryViewMessages: Record = { monthly_net_estimate: 'Estimativa líquida mensal; retenção mensal e apuramento anual são resultados distintos.', monthly_withholding: 'Retenção mensal não representa, por si só, o apuramento anual nem o cumprimento integral das obrigações fiscais.', annual_assessment: 'Apuramento anual; retenções mensais não o substituem.', }; return

Componentes fiscais e contributivas

A consulta identifica parâmetros publicados e as respectivas fontes. Não executa fórmulas nem determina imposto devido ou elegibilidade fiscal.

{scenarioMode === 'approved_parameters' &&

{requestState === 'loading' ? 'A consultar parâmetros aprovados para o período e âmbito indicados…' : requestState === 'error' ? 'Não foi possível consultar os parâmetros; o resultado permanece indeterminado.' : !periodStart || !periodEnd ? 'Indique um período exacto. Para periodicidade mensal ou trimestral, seleccione o mês ou trimestre.' : `Período consultado: ${periodStart} a ${periodEnd}.`}

} {scenarioMode === 'custom_planning' &&

Modo de planeamento separado: pressupostos do utilizador, não taxas legais confirmadas. Nenhum imposto ou elegibilidade é calculado.

} {salaryView && salaryViewMessages[salaryView] &&

{salaryViewMessages[salaryView]}

}
    {fiscalComponentCodes.map((code) => { const selected = code === (component === 'withholding' ? 'RETENCOES' : component?.toUpperCase()); return
  • {code === 'RETENCOES' ? 'Retenções' : code} {!selected || scenarioMode !== 'approved_parameters' ?

    Sem cálculo fiscal

    : requestState !== 'done' ?

    Indeterminado — sem cálculo

    : parameters.length === 0 ?

    Indeterminado — nenhum parâmetro publicado aplicável.

    :
    {parameters.map((parameter) =>
    {parameter.parameter_code} {parameter.status === 'resolved' ? <>

    Parâmetro: {parameter.value} {parameter.unit}

    Regra {parameter.rule_code} v{parameter.rule_version}; âmbito {parameter.scope_key}

    Vigência: {parameter.validity?.start} a {parameter.validity?.end ?? 'sem data final'}

    Fonte: {parameter.source?.title}{parameter.source?.diploma ? ` — ${parameter.source.diploma}` : ''}{parameter.source?.article ? `, ${parameter.source.article}` : ''}

    {parameter.source?.url && Consultar fundamento} :

    {labels[parameter.status] ?? 'Indeterminado — não foi possível validar o parâmetro.'}

    }
    )}
    }
  • ; })}
; }