fix: complete InvesteMoz validation and error corrections

This commit is contained in:
2026-10-29 21:47:33 +02:00
parent 63147312e2
commit daf8623441
718 changed files with 127308 additions and 20959 deletions
+495 -58
View File
@@ -1,63 +1,500 @@
import {acquisitionScope} from './iva-acquisitions.ts';
import {decimalFraction,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
import { inputText } from './input-text.ts';
import { acquisitionScope } from './iva-acquisitions.ts';
import {
decimalFraction,
fractionPresentation,
type FiscalFraction,
} from './fiscal-rational.ts';
export const ispcEligibilitySource='L4-A:Lei9/2025,BR248/1.ºsuplemento,republicaçãoISPC,arts2–5,9-A/13;PDF10–11/p2180(10–11);vigência2026art6/PDF9. Enquadramento preliminar de actividade habitual;opção separada;sem liquidação trimestral,retenção,submissão ou alteração de IVA/IRPC/IRPS.';
export const ispcActivities=[['forestry','Silvícola'],['fishery','Pesqueira'],['livestock','Pecuária'],['agriculture','Agrícola'],['poultry','Avícola'],['beekeeping','Apícola'],['industry','Industrial'],['commerce','Comercial'],['craft','Artesanato'],['services12','Serviços do artigo8(1)b'],['liberal15','Profissão liberal do artigo8(1)c'],['other','Outra actividade,fora dos âmbitos identificados']] as const;
export type IspcActivity=typeof ispcActivities[number][0];
type Choice=''|'yes'|'no';
export type IspcEligibilityInput={entityRef:string;personType:''|'singular'|'collective';origin:'projected'|'effective';assessmentDate:string;currency:string;mode:'regular'|'occasional';activities:IspcActivity[];activityDescription:string;territory:Choice;establishments:string;basis:''|'previous_year'|'start_forecast';referenceYear:string;annualReference:string;annualReferenceRef:string;forecastConfirmed:Choice;forecastConfirmationRef:string;organizedRequired:Choice;sharesInIspc:Choice;sharesAnonymous:Choice;otherActivities:Choice;unlistedServices:Choice;liberalDaysSameEntity:string;liberalClientRef:string;generalRegimeChosen:Choice;generalThreeYearsCompleted:Choice;generalRegimeRef:string;option:'preparation'|'opted'|'not_opted';optionReference:string;optionDate:string};
export type IspcEligibilityResult={calculatedAt:string;key:string;scope:string;input:IspcEligibilityInput;status:'compatible'|'incompatible'|'indeterminate';reason:string;missing:string[];annualReference:FiscalFraction|null;optionStatus:'preparation'|'recorded'|'not_opted'|'indeterminate';optionReason:string;source:string};
export type IspcEligibilityBook={version:1;input:IspcEligibilityInput;result?:IspcEligibilityResult;history?:IspcEligibilityResult[]};
const scope=(d:Record<string,unknown>)=>acquisitionScope(d);
export function ispcReuseValues(d:Record<string,unknown>):Partial<IspcEligibilityInput>{
const p:Partial<IspcEligibilityInput>={},person=String(d.person_type??'');if(['singular','sole_trader'].includes(person))p.personType='singular';else if(person==='collective')p.personType='collective';
if(typeof d.fiscal_activity==='string'&&d.fiscal_activity.trim())p.activityDescription=d.fiscal_activity;
const establishments=String(d.fiscal_establishments??'');if(/^[1-9]\d{0,4}$/.test(establishments))p.establishments=establishments;
const entity=String(d.fiscal_entity_ref||d.organization_name||'');if(entity.trim())p.entityRef=entity;
return p;
export const ispcEligibilitySource =
'L4-A:Lei9/2025,BR248/1.ºsuplemento,republicaçãoISPC,arts2–5,9-A/13;PDF10–11/p2180(10–11);vigência2026art6/PDF9. Enquadramento preliminar de actividade habitual;opção separada;sem liquidação trimestral,retenção,submissão ou alteração de IVA/IRPC/IRPS.';
export const ispcActivities = [
['forestry', 'Silvícola'],
['fishery', 'Pesqueira'],
['livestock', 'Pecuária'],
['agriculture', 'Agrícola'],
['poultry', 'Avícola'],
['beekeeping', 'Apícola'],
['industry', 'Industrial'],
['commerce', 'Comercial'],
['craft', 'Artesanato'],
['services12', 'Serviços do artigo8(1)b'],
['liberal15', 'Profissão liberal do artigo8(1)c'],
['other', 'Outra actividade,fora dos âmbitos identificados'],
] as const;
export type IspcActivity = (typeof ispcActivities)[number][0];
type Choice = '' | 'yes' | 'no';
export type IspcEligibilityInput = {
entityRef: string;
personType: '' | 'singular' | 'collective';
origin: 'projected' | 'effective';
assessmentDate: string;
currency: string;
mode: 'regular' | 'occasional';
activities: IspcActivity[];
activityDescription: string;
territory: Choice;
establishments: string;
basis: '' | 'previous_year' | 'start_forecast';
referenceYear: string;
annualReference: string;
annualReferenceRef: string;
forecastConfirmed: Choice;
forecastConfirmationRef: string;
organizedRequired: Choice;
sharesInIspc: Choice;
sharesAnonymous: Choice;
otherActivities: Choice;
unlistedServices: Choice;
liberalDaysSameEntity: string;
liberalClientRef: string;
generalRegimeChosen: Choice;
generalThreeYearsCompleted: Choice;
generalRegimeRef: string;
option: 'preparation' | 'opted' | 'not_opted';
optionReference: string;
optionDate: string;
};
export type IspcEligibilityResult = {
calculatedAt: string;
key: string;
scope: string;
input: IspcEligibilityInput;
status: 'compatible' | 'incompatible' | 'indeterminate';
reason: string;
missing: string[];
annualReference: FiscalFraction | null;
optionStatus: 'preparation' | 'recorded' | 'not_opted' | 'indeterminate';
optionReason: string;
source: string;
};
export type IspcEligibilityBook = {
version: 1;
input: IspcEligibilityInput;
result?: IspcEligibilityResult;
history?: IspcEligibilityResult[];
};
const scope = (d: Record<string, unknown>) => acquisitionScope(d);
export function ispcReuseValues(
d: Record<string, unknown>,
): Partial<IspcEligibilityInput> {
const p: Partial<IspcEligibilityInput> = {},
person = inputText(d.person_type ?? '');
if (['singular', 'sole_trader'].includes(person)) p.personType = 'singular';
else if (person === 'collective') p.personType = 'collective';
if (typeof d.fiscal_activity === 'string' && d.fiscal_activity.trim())
p.activityDescription = d.fiscal_activity;
const establishments = inputText(d.fiscal_establishments ?? '');
if (/^[1-9]\d{0,4}$/.test(establishments))
p.establishments = establishments;
const entity = inputText(d.fiscal_entity_ref || d.organization_name || '');
if (entity.trim()) p.entityRef = entity;
return p;
}
export function newIspcEligibilityInput(d:Record<string,unknown>):IspcEligibilityInput{return{entityRef:'',personType:'',origin:'projected',assessmentDate:'2026-01-01',currency:d.currency==='MZN'?'MZN':'',mode:'regular',activities:[],activityDescription:'',territory:'',establishments:'',basis:'',referenceYear:'',annualReference:'',annualReferenceRef:'',forecastConfirmed:'',forecastConfirmationRef:'',organizedRequired:'',sharesInIspc:'',sharesAnonymous:'',otherActivities:'',unlistedServices:'',liberalDaysSameEntity:'',liberalClientRef:'',generalRegimeChosen:'',generalThreeYearsCompleted:'',generalRegimeRef:'',option:'preparation',optionReference:'',optionDate:'',...ispcReuseValues(d)};}
function store(d:Record<string,unknown>):Record<string,unknown>{const s=JSON.parse(String(d.modelo_a_snapshot||'{"version":1,"books":{}}'));if(s.version!==1||!s.books||typeof s.books!=='object'||Array.isArray(s.books))throw Error('Livros não recuperáveis;originais preservados.');return s;}
function map(d:Record<string,unknown>):Record<string,IspcEligibilityBook>{const value=store(d).ispcEligibility;if(value===undefined)return{};if(!value||typeof value!=='object'||Array.isArray(value))throw Error('PreparaçãoISPC não recuperável;originais preservados.');return value as Record<string,IspcEligibilityBook>;}
function validate(b:IspcEligibilityBook):void{
const sample=newIspcEligibilityInput({});if(!b||b.version!==1||!b.input||typeof b.input!=='object'||Object.keys(sample).some(k=>k==='activities'?!Array.isArray(b.input.activities)||new Set(b.input.activities).size!==b.input.activities.length||b.input.activities.some(a=>!ispcActivities.some(([kind])=>kind===a)):typeof b.input[k as keyof IspcEligibilityInput]!=='string')||!['','singular','collective'].includes(b.input.personType)||!['projected','effective'].includes(b.input.origin)||!['regular','occasional'].includes(b.input.mode)||!['','previous_year','start_forecast'].includes(b.input.basis)||!['preparation','opted','not_opted'].includes(b.input.option)||['territory','forecastConfirmed','organizedRequired','sharesInIspc','sharesAnonymous','otherActivities','unlistedServices','generalRegimeChosen','generalThreeYearsCompleted'].some(k=>!['','yes','no'].includes(String(b.input[k as keyof IspcEligibilityInput])))||b.history!==undefined&&!Array.isArray(b.history)||b.result!==undefined&&(!b.result.input||!Array.isArray(b.result.missing)||!['compatible','incompatible','indeterminate'].includes(b.result.status)))throw Error('EntradasISPC não recuperáveis;sem substituir por valores vazios.');
export function newIspcEligibilityInput(
d: Record<string, unknown>,
): IspcEligibilityInput {
return {
entityRef: '',
personType: '',
origin: 'projected',
assessmentDate: '2026-01-01',
currency: d.currency === 'MZN' ? 'MZN' : '',
mode: 'regular',
activities: [],
activityDescription: '',
territory: '',
establishments: '',
basis: '',
referenceYear: '',
annualReference: '',
annualReferenceRef: '',
forecastConfirmed: '',
forecastConfirmationRef: '',
organizedRequired: '',
sharesInIspc: '',
sharesAnonymous: '',
otherActivities: '',
unlistedServices: '',
liberalDaysSameEntity: '',
liberalClientRef: '',
generalRegimeChosen: '',
generalThreeYearsCompleted: '',
generalRegimeRef: '',
option: 'preparation',
optionReference: '',
optionDate: '',
...ispcReuseValues(d),
};
}
export function ispcEligibilityBook(d:Record<string,unknown>):IspcEligibilityBook{const b=map(d)[scope(d)]??{version:1,input:newIspcEligibilityInput(d)};validate(b);return b;}
export function saveIspcEligibilityBook(d:Record<string,unknown>,b:IspcEligibilityBook):string{validate(b);return JSON.stringify({...store(d),ispcEligibility:{...map(d),[scope(d)]:b}});}
const validDate=(v:string)=>/^20\d{2}-(0[1-9]|1[0-2])-\d{2}$/.test(v)&&!Number.isNaN(Date.parse(v))&&new Date(v).toISOString().slice(0,10)===v;
function option(i:IspcEligibilityInput):Pick<IspcEligibilityResult,'optionStatus'|'optionReason'>{
if(i.option==='not_opted')return{optionStatus:'not_opted',optionReason:'Sem opçãoISPC declarada;não aplicar a exclusão de outros impostos doart5.'};
if(i.option==='preparation')return{optionStatus:'preparation',optionReason:'Opção em preparação;compatibilidade de acesso não é adesão nem alteração automática de regime.'};
if(!i.optionReference.trim()||!validDate(i.optionDate)||!validDate(i.assessmentDate)||i.optionDate>i.assessmentDate)return{optionStatus:'indeterminate',optionReason:'Identifique referência e data da opção,até à data de avaliação;não inferir adesão pela selecçãoISPC.'};
return{optionStatus:'recorded',optionReason:'Opção registada segundo documento ou pressuposto declarado;sem submissãoAT ou reescrita dos livros deIVA/IRPC/IRPS.'};
function store(d: Record<string, unknown>): Record<string, unknown> {
const s = JSON.parse(
inputText(d.modelo_a_snapshot || '{"version":1,"books":{}}'),
);
if (
s.version !== 1 ||
!s.books ||
typeof s.books !== 'object' ||
Array.isArray(s.books)
)
throw Error('Livros não recuperáveis;originais preservados.');
return s;
}
function assess(i:IspcEligibilityInput):Pick<IspcEligibilityResult,'status'|'reason'|'missing'|'annualReference'>{
let annual:FiscalFraction|null=null;try{annual=decimalFraction(i.annualReference);}catch{ /* Missing or invalid is never zero. */ }
const stop=(status:IspcEligibilityResult['status'],reason:string,missing:string[]=[])=>({status,reason,missing,annualReference:annual});
if(!validDate(i.assessmentDate)||!i.assessmentDate.startsWith('2026-')||i.currency!=='MZN')return stop('indeterminate','Este incremento cobre apenas avaliação2026emMZN;identifique data e moeda sem conversão silenciosa.',['data2026','moedaMZN']);
if(i.mode==='occasional')return stop('indeterminate','Operação ocasional3(3–4):conservar dados;use o percurso específico de operações ocasionais próprias abaixo,com incidênciaIRPS e famílias3(4).',['enquadramento específico da operação ocasional']);
if(i.territory==='no')return stop('incompatible','O âmbito territorial declarado não corresponde ao exercício em território nacional de2(1);nacionalidade do investidor não substitui este facto.');
if(i.activities.includes('other')||i.otherActivities==='yes')return stop('incompatible','Actividade fora dos âmbitos2/3declarada;exclusão3(2)c,não aplicarISPC por nome do sector.');
if(i.organizedRequired==='yes')return stop('incompatible','Obrigação de contabilidade organizada declarada:4(1)b não permite este enquadramento. Manter contabilidade voluntária distinto de obrigação.');
if(i.sharesInIspc==='yes'||i.sharesAnonymous==='yes')return stop('incompatible','Participações abrangidas por3(2)a/b declaradas;enquadramentoISPC incompatível.');
if(/^[1-9]\d{0,4}$/.test(i.establishments)&&Number(i.establishments)>1)return stop('incompatible','Actividade distribuída por vários estabelecimentos:exclusão3(2)d;sem presumir um estabelecimento por oportunidade.');
const service=i.activities.some(a=>['services12','liberal15'].includes(a)),liberal=i.activities.includes('liberal15');
if(service&&i.unlistedServices==='yes')return stop('incompatible','Serviços fora dos previstos declarados:exclusão3(2)f. Categoria e natureza próprias devem ser identificadas.');
if(liberal&&/^\d{1,3}$/.test(i.liberalDaysSameEntity)&&Number(i.liberalDaysSameEntity)<=366&&Number(i.liberalDaysSameEntity)>183)return stop('incompatible','Serviços8(1)càmesma entidade por mais183dias durante o ano:exclusão3(2)e. Não estender esta condição automaticamente aos serviços8(1)b.');
if(i.generalRegimeChosen==='yes'&&i.generalThreeYearsCompleted==='no')return stop('incompatible','Permanência mínima de três anos nos impostos gerais5(3)ainda não cumprida,segundo factos declarados.');
if(annual&&(i.basis==='previous_year'&&i.referenceYear==='2025'||i.basis==='start_forecast'&&i.referenceYear==='2026')&&BigInt(annual.numerator)>4000000n*BigInt(annual.denominator))return stop('incompatible','Volume anual de referência superior4.000.000MZN:fora do acesso4(1)a/4(2). Excesso do próprio ano e20%de8(1)d têm tratamento separado;não liquidado aqui.');
const missing:string[]=[];if(!i.personType)missing.push('pessoa singular ou colectiva');if(i.territory!=='yes')missing.push('exercício em território nacional');if(!i.activities.length||!i.activityDescription.trim())missing.push('actividade/natureza identificadas');if(!/^[1-9]\d{0,4}$/.test(i.establishments))missing.push('número de estabelecimentos');
for(const[field,label]of [['organizedRequired','obrigação de contabilidade organizada'],['sharesInIspc','participações noutras sociedadesISPC'],['sharesAnonymous','participaçõesSA/sócios não identificáveis'],['otherActivities','actividades fora do âmbito'],['generalRegimeChosen','opção pelos impostos gerais']] as const)if(i[field]==='')missing.push(label);
if(!i.basis)missing.push('origem do volume anual de referência');if(!annual)missing.push('montante anual de referência');const expected=i.basis==='previous_year'?'2025':i.basis==='start_forecast'?'2026':'';if(expected&&i.referenceYear!==expected)missing.push(`ano${expected}da referência;não reinterpretar outro ano`);
if(i.basis==='start_forecast'&&(i.forecastConfirmed!=='yes'||i.origin==='effective'&&!i.forecastConfirmationRef.trim()))missing.push('previsão da declaração de início confirmadaAT4(2),ou pressuposto expresso na projecção');
if(service&&i.unlistedServices==='')missing.push('correspondência dos serviços aos âmbitos daLei');
if(liberal&&(!/^\d{1,3}$/.test(i.liberalDaysSameEntity)||Number(i.liberalDaysSameEntity)>366||!i.liberalClientRef.trim()))missing.push('maior duração anual por mesma entidade e suporte declarado');
if(i.generalRegimeChosen==='yes'&&(i.generalThreeYearsCompleted!=='yes'||!i.generalRegimeRef.trim()))missing.push('cumprimento dos três anos5(3)e referência da opção/registo');
if(missing.length)return stop('indeterminate','Condições específicas por esclarecer;desconhecido não significa não aplicável nemzero.',missing);
return stop('compatible','Condições de acesso da actividade habitual compatíveis com os dados de referência declarados;opção separada. Volume do ano em curso, trimestre, excesso e mínimo têm apuramento trimestral próprio; retenções têm registo separado.'+(liberal?' Serviçosliberais:limite5anos9-A,contagemtransitória13a partir da vigência2026;sem presumir permanência fora da cobertura.':''));
function map(d: Record<string, unknown>): Record<string, IspcEligibilityBook> {
const value = store(d).ispcEligibility;
if (value === undefined) return {};
if (!value || typeof value !== 'object' || Array.isArray(value))
throw Error('PreparaçãoISPC não recuperável;originais preservados.');
return value as Record<string, IspcEligibilityBook>;
}
function validate(b: IspcEligibilityBook): void {
const sample = newIspcEligibilityInput({});
if (
!b ||
b.version !== 1 ||
!b.input ||
typeof b.input !== 'object' ||
Object.keys(sample).some((k) =>
k === 'activities'
? !Array.isArray(b.input.activities) ||
new Set(b.input.activities).size !==
b.input.activities.length ||
b.input.activities.some(
(a) => !ispcActivities.some(([kind]) => kind === a),
)
: typeof b.input[k as keyof IspcEligibilityInput] !== 'string',
) ||
!['', 'singular', 'collective'].includes(b.input.personType) ||
!['projected', 'effective'].includes(b.input.origin) ||
!['regular', 'occasional'].includes(b.input.mode) ||
!['', 'previous_year', 'start_forecast'].includes(b.input.basis) ||
!['preparation', 'opted', 'not_opted'].includes(b.input.option) ||
[
'territory',
'forecastConfirmed',
'organizedRequired',
'sharesInIspc',
'sharesAnonymous',
'otherActivities',
'unlistedServices',
'generalRegimeChosen',
'generalThreeYearsCompleted',
].some(
(k) =>
!['', 'yes', 'no'].includes(
String(b.input[k as keyof IspcEligibilityInput]),
),
) ||
(b.history !== undefined && !Array.isArray(b.history)) ||
(b.result !== undefined &&
(!b.result.input ||
!Array.isArray(b.result.missing) ||
!['compatible', 'incompatible', 'indeterminate'].includes(
b.result.status,
)))
)
throw Error(
'EntradasISPC não recuperáveis;sem substituir por valores vazios.',
);
}
export function ispcEligibilityBook(
d: Record<string, unknown>,
): IspcEligibilityBook {
const b = map(d)[scope(d)] ?? {
version: 1,
input: newIspcEligibilityInput(d),
};
validate(b);
return b;
}
export function saveIspcEligibilityBook(
d: Record<string, unknown>,
b: IspcEligibilityBook,
): string {
validate(b);
return JSON.stringify({
...store(d),
ispcEligibility: { ...map(d), [scope(d)]: b },
});
}
const validDate = (v: string) =>
/^20\d{2}-(0[1-9]|1[0-2])-\d{2}$/.test(v) &&
!Number.isNaN(Date.parse(v)) &&
new Date(v).toISOString().slice(0, 10) === v;
function option(
i: IspcEligibilityInput,
): Pick<IspcEligibilityResult, 'optionStatus' | 'optionReason'> {
if (i.option === 'not_opted')
return {
optionStatus: 'not_opted',
optionReason:
'Sem opçãoISPC declarada;não aplicar a exclusão de outros impostos doart5.',
};
if (i.option === 'preparation')
return {
optionStatus: 'preparation',
optionReason:
'Opção em preparação;compatibilidade de acesso não é adesão nem alteração automática de regime.',
};
if (
!i.optionReference.trim() ||
!validDate(i.optionDate) ||
!validDate(i.assessmentDate) ||
i.optionDate > i.assessmentDate
)
return {
optionStatus: 'indeterminate',
optionReason:
'Identifique referência e data da opção,até à data de avaliação;não inferir adesão pela selecçãoISPC.',
};
return {
optionStatus: 'recorded',
optionReason:
'Opção registada segundo documento ou pressuposto declarado;sem submissãoAT ou reescrita dos livros deIVA/IRPC/IRPS.',
};
}
function assess(
i: IspcEligibilityInput,
): Pick<
IspcEligibilityResult,
'status' | 'reason' | 'missing' | 'annualReference'
> {
let annual: FiscalFraction | null = null;
try {
annual = decimalFraction(i.annualReference);
} catch {
/* Missing or invalid is never zero. */
}
const stop = (
status: IspcEligibilityResult['status'],
reason: string,
missing: string[] = [],
) => ({ status, reason, missing, annualReference: annual });
if (
!validDate(i.assessmentDate) ||
!i.assessmentDate.startsWith('2026-') ||
i.currency !== 'MZN'
)
return stop(
'indeterminate',
'Este incremento cobre apenas avaliação2026emMZN;identifique data e moeda sem conversão silenciosa.',
['data2026', 'moedaMZN'],
);
if (i.mode === 'occasional')
return stop(
'indeterminate',
'Operação ocasional3(3–4):conservar dados;use o percurso específico de operações ocasionais próprias abaixo,com incidênciaIRPS e famílias3(4).',
['enquadramento específico da operação ocasional'],
);
if (i.territory === 'no')
return stop(
'incompatible',
'O âmbito territorial declarado não corresponde ao exercício em território nacional de2(1);nacionalidade do investidor não substitui este facto.',
);
if (i.activities.includes('other') || i.otherActivities === 'yes')
return stop(
'incompatible',
'Actividade fora dos âmbitos2/3declarada;exclusão3(2)c,não aplicarISPC por nome do sector.',
);
if (i.organizedRequired === 'yes')
return stop(
'incompatible',
'Obrigação de contabilidade organizada declarada:4(1)b não permite este enquadramento. Manter contabilidade voluntária distinto de obrigação.',
);
if (i.sharesInIspc === 'yes' || i.sharesAnonymous === 'yes')
return stop(
'incompatible',
'Participações abrangidas por3(2)a/b declaradas;enquadramentoISPC incompatível.',
);
if (/^[1-9]\d{0,4}$/.test(i.establishments) && Number(i.establishments) > 1)
return stop(
'incompatible',
'Actividade distribuída por vários estabelecimentos:exclusão3(2)d;sem presumir um estabelecimento por oportunidade.',
);
const service = i.activities.some((a) =>
['services12', 'liberal15'].includes(a),
),
liberal = i.activities.includes('liberal15');
if (service && i.unlistedServices === 'yes')
return stop(
'incompatible',
'Serviços fora dos previstos declarados:exclusão3(2)f. Categoria e natureza próprias devem ser identificadas.',
);
if (
liberal &&
/^\d{1,3}$/.test(i.liberalDaysSameEntity) &&
Number(i.liberalDaysSameEntity) <= 366 &&
Number(i.liberalDaysSameEntity) > 183
)
return stop(
'incompatible',
'Serviços8(1)càmesma entidade por mais183dias durante o ano:exclusão3(2)e. Não estender esta condição automaticamente aos serviços8(1)b.',
);
if (
i.generalRegimeChosen === 'yes' &&
i.generalThreeYearsCompleted === 'no'
)
return stop(
'incompatible',
'Permanência mínima de três anos nos impostos gerais5(3)ainda não cumprida,segundo factos declarados.',
);
if (
annual &&
((i.basis === 'previous_year' && i.referenceYear === '2025') ||
(i.basis === 'start_forecast' && i.referenceYear === '2026')) &&
BigInt(annual.numerator) > 4000000n * BigInt(annual.denominator)
)
return stop(
'incompatible',
'Volume anual de referência superior4.000.000MZN:fora do acesso4(1)a/4(2). Excesso do próprio ano e20%de8(1)d têm tratamento separado;não liquidado aqui.',
);
const missing: string[] = [];
if (!i.personType) missing.push('pessoa singular ou colectiva');
if (i.territory !== 'yes') missing.push('exercício em território nacional');
if (!i.activities.length || !i.activityDescription.trim())
missing.push('actividade/natureza identificadas');
if (!/^[1-9]\d{0,4}$/.test(i.establishments))
missing.push('número de estabelecimentos');
for (const [field, label] of [
['organizedRequired', 'obrigação de contabilidade organizada'],
['sharesInIspc', 'participações noutras sociedadesISPC'],
['sharesAnonymous', 'participaçõesSA/sócios não identificáveis'],
['otherActivities', 'actividades fora do âmbito'],
['generalRegimeChosen', 'opção pelos impostos gerais'],
] as const)
if (i[field] === '') missing.push(label);
if (!i.basis) missing.push('origem do volume anual de referência');
if (!annual) missing.push('montante anual de referência');
const expected =
i.basis === 'previous_year'
? '2025'
: i.basis === 'start_forecast'
? '2026'
: '';
if (expected && i.referenceYear !== expected)
missing.push(`ano${expected}da referência;não reinterpretar outro ano`);
if (
i.basis === 'start_forecast' &&
(i.forecastConfirmed !== 'yes' ||
(i.origin === 'effective' && !i.forecastConfirmationRef.trim()))
)
missing.push(
'previsão da declaração de início confirmadaAT4(2),ou pressuposto expresso na projecção',
);
if (service && i.unlistedServices === '')
missing.push('correspondência dos serviços aos âmbitos daLei');
if (
liberal &&
(!/^\d{1,3}$/.test(i.liberalDaysSameEntity) ||
Number(i.liberalDaysSameEntity) > 366 ||
!i.liberalClientRef.trim())
)
missing.push(
'maior duração anual por mesma entidade e suporte declarado',
);
if (
i.generalRegimeChosen === 'yes' &&
(i.generalThreeYearsCompleted !== 'yes' || !i.generalRegimeRef.trim())
)
missing.push(
'cumprimento dos três anos5(3)e referência da opção/registo',
);
if (missing.length)
return stop(
'indeterminate',
'Condições específicas por esclarecer;desconhecido não significa não aplicável nemzero.',
missing,
);
return stop(
'compatible',
'Condições de acesso da actividade habitual compatíveis com os dados de referência declarados;opção separada. Volume do ano em curso, trimestre, excesso e mínimo têm apuramento trimestral próprio; retenções têm registo separado.' +
(liberal
? ' Serviçosliberais:limite5anos9-A,contagemtransitória13a partir da vigência2026;sem presumir permanência fora da cobertura.'
: ''),
);
}
const key = (d: Record<string, unknown>, b: IspcEligibilityBook) =>
JSON.stringify(['ispc-eligibility/1', scope(d), b.input]);
export function ispcEligibilityCurrent(
d: Record<string, unknown>,
b: IspcEligibilityBook,
): boolean {
return !!b.result && b.result.key === key(d, b);
}
export function recordIspcEligibility(
d: Record<string, unknown>,
b: IspcEligibilityBook,
now = new Date().toISOString(),
): IspcEligibilityBook {
validate(b);
const result: IspcEligibilityResult = {
calculatedAt: now,
key: key(d, b),
scope: scope(d),
input: structuredClone(b.input),
...assess(b.input),
...option(b.input),
source: ispcEligibilitySource,
};
return {
...b,
...(b.result
? { history: [...(b.history ?? []), structuredClone(b.result)] }
: {}),
result,
};
}
export function ispcReuseDiff(
d: Record<string, unknown>,
b: IspcEligibilityBook,
): Array<{ field: keyof IspcEligibilityInput; before: string; after: string }> {
return Object.entries(ispcReuseValues(d))
.filter(
([field, value]) =>
b.input[field as keyof IspcEligibilityInput] !== value,
)
.map(([field, value]) => ({
field: field as keyof IspcEligibilityInput,
before: String(b.input[field as keyof IspcEligibilityInput]),
after: String(value),
}));
}
export function ispcEligibilityReportRows(
d: Record<string, unknown>,
): Array<[string, string, string, string]> {
try {
const b = ispcEligibilityBook(d),
r = b.result;
if (!r) return [];
const i = r.input;
return [
[
'ISPC',
'L4-A — enquadramento2026',
`${r.status === 'compatible' ? 'Compatível com os dados de referência' : r.status === 'incompatible' ? 'Incompatível' : 'Indeterminado'};${r.reason};falta:${r.missing.join('; ') || 'nenhum dado deste recorte'}`,
`${r.scope};${ispcEligibilityCurrent(d, b) ? 'Entradas correspondentes' : 'Histórico preservado;rever entradas'};${r.calculatedAt};${r.source}`,
],
[
'ISPC',
'Origem e âmbito',
`${i.entityRef || 'Entidade por identificar'};${i.personType};${i.origin === 'projected' ? 'Pressupostos de simulação' : 'Dados efectivos declarados'};${i.activities.map((a) => ispcActivities.find(([kind]) => kind === a)?.[1] ?? a).join('; ')};${i.activityDescription};estabelecimentos${i.establishments};territórionacional${i.territory}`,
`Referênciaanual:${i.basis}/${i.referenceYear};${r.annualReference ? fractionPresentation(r.annualReference).decimal : 'Indeterminado'}MZN;${i.annualReferenceRef};previsãoAT${i.forecastConfirmed}/${i.forecastConfirmationRef};liberal${i.liberalDaysSameEntity}dias/${i.liberalClientRef};factos:${JSON.stringify({ organizedRequired: i.organizedRequired, sharesInIspc: i.sharesInIspc, sharesAnonymous: i.sharesAnonymous, otherActivities: i.otherActivities, unlistedServices: i.unlistedServices, generalRegimeChosen: i.generalRegimeChosen, generalThreeYearsCompleted: i.generalThreeYearsCompleted, generalRegimeRef: i.generalRegimeRef })}`,
],
[
'ISPC',
'Opção e próximo passo',
`${r.optionReason};referência${i.optionReference};data${i.optionDate}`,
`Prossiga no apuramento trimestral; esta avaliação não adopta regime nem calcula imposto. ${r.source}`,
],
];
} catch (error) {
return [
[
'ISPC',
'Enquadramento',
'Dados não recuperáveis;originais preservados',
String(error),
],
];
}
}
const key=(d:Record<string,unknown>,b:IspcEligibilityBook)=>JSON.stringify(['ispc-eligibility/1',scope(d),b.input]);
export function ispcEligibilityCurrent(d:Record<string,unknown>,b:IspcEligibilityBook):boolean{return!!b.result&&b.result.key===key(d,b);}
export function recordIspcEligibility(d:Record<string,unknown>,b:IspcEligibilityBook,now=new Date().toISOString()):IspcEligibilityBook{validate(b);const result:IspcEligibilityResult={calculatedAt:now,key:key(d,b),scope:scope(d),input:structuredClone(b.input),...assess(b.input),...option(b.input),source:ispcEligibilitySource};return{...b,...(b.result?{history:[...(b.history??[]),structuredClone(b.result)]}:{}),result};}
export function ispcReuseDiff(d:Record<string,unknown>,b:IspcEligibilityBook):Array<{field:keyof IspcEligibilityInput;before:string;after:string}>{return Object.entries(ispcReuseValues(d)).filter(([field,value])=>b.input[field as keyof IspcEligibilityInput]!==value).map(([field,value])=>({field:field as keyof IspcEligibilityInput,before:String(b.input[field as keyof IspcEligibilityInput]),after:String(value)}));}
export function ispcEligibilityReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=ispcEligibilityBook(d),r=b.result;if(!r)return[];const i=r.input;return[['ISPC','L4-A — enquadramento2026',`${r.status==='compatible'?'Compatível com os dados de referência':r.status==='incompatible'?'Incompatível':'Indeterminado'};${r.reason};falta:${r.missing.join('; ')||'nenhum dado deste recorte'}`,`${r.scope};${ispcEligibilityCurrent(d,b)?'Entradas correspondentes':'Histórico preservado;rever entradas'};${r.calculatedAt};${r.source}`],['ISPC','Origem e âmbito',`${i.entityRef||'Entidade por identificar'};${i.personType};${i.origin==='projected'?'Pressupostos de simulação':'Dados efectivos declarados'};${i.activities.map(a=>ispcActivities.find(([kind])=>kind===a)?.[1]??a).join('; ')};${i.activityDescription};estabelecimentos${i.establishments};territórionacional${i.territory}`,`Referênciaanual:${i.basis}/${i.referenceYear};${r.annualReference?fractionPresentation(r.annualReference).decimal:'Indeterminado'}MZN;${i.annualReferenceRef};previsãoAT${i.forecastConfirmed}/${i.forecastConfirmationRef};liberal${i.liberalDaysSameEntity}dias/${i.liberalClientRef};factos:${JSON.stringify({organizedRequired:i.organizedRequired,sharesInIspc:i.sharesInIspc,sharesAnonymous:i.sharesAnonymous,otherActivities:i.otherActivities,unlistedServices:i.unlistedServices,generalRegimeChosen:i.generalRegimeChosen,generalThreeYearsCompleted:i.generalThreeYearsCompleted,generalRegimeRef:i.generalRegimeRef})}`],['ISPC','Opção e próximo passo',`${r.optionReason};referência${i.optionReference};data${i.optionDate}`,`Prossiga no apuramento trimestral; esta avaliação não adopta regime nem calcula imposto. ${r.source}`]];}catch(error){return[['ISPC','Enquadramento','Dados não recuperáveis;originais preservados',String(error)]];}}