feat(portal): deliver ordinary national credit fraction and education continuity
tests / ci (push) Canceled after 0s

This commit is contained in:
2026-11-10 12:47:57 +02:00
parent ff726e577f
commit c359364de3
14 changed files with 749 additions and 126 deletions
+43 -2
View File
@@ -1154,12 +1154,28 @@ export function calculateAnnual(d: Record<string, unknown>, b: AnnualBook) {
b.subjectNuit,
b.year,
b.assessmentKey,
{
ordinary:
assessment?.kind === 'normal' &&
assessment.current &&
assessment.key === b.assessmentKey,
taxableBase: assessment?.record?.model.taxableBase ?? null,
colecta: assessment?.colecta ?? null,
},
);
pending.push(
...m.pending.map((e) => 'País ' + p.country + ': ' + e),
);
return m;
}) ?? [];
const derivedNational = positions.flatMap((p) =>
p.nationalDerivation ? [p.nationalDerivation.income] : [],
);
const currentBase = assessment?.record?.model.taxableBase;
if (currentBase && cmp(addFractions(derivedNational), currentBase) > 0n)
pending.push(
'As parcelas estrangeiras com fracção derivada excedem em conjunto a matéria colectável corrente; reconcilie a afectação por país.',
);
const economicRows =
b.economicCredits?.rows.map((r) => {
const issues = claims
@@ -1384,7 +1400,9 @@ export function calculateAnnual(d: Record<string, unknown>, b: AnnualBook) {
: []),
...(b.internationalCredits
? [
'Crédito internacional do próprio exercício:fracção nacional,convenção e montantes MZN são documentados;sem cálculo presumido,transporte ou consumo oficial. ' +
(positions.some((p) => p.nationalDerivation)
? 'Crédito internacional do próprio exercício:fracção nacional derivada no caso L6 ordinário com parcela líquida correspondida;CDT e montantes MZN documentados;sem repartição presumida de custos/perdas,transporte ou consumo oficial. '
: 'Crédito internacional do próprio exercício:fracção nacional,convenção e montantes MZN são documentados;sem cálculo presumido,transporte ou consumo oficial. ') +
(b.economicCredits
? 'Benefícios positivos ficam separados;crédito económico no detalhe próprio.'
: 'Créditos económicos/benefícios positivos ficam separados.'),
@@ -1630,6 +1648,21 @@ export function annualReportRows(
show(p.paid) +
'; fracção nacional: ' +
show(p.nationalLimit) +
(p.nationalDerivation
? '; derivação L6: colecta ' +
show(p.nationalDerivation.colecta) +
' × parcela líquida ' +
show(p.nationalDerivation.income) +
' / matéria colectável ' +
show(
p.nationalDerivation
.taxableBase,
) +
'; exacta ' +
p.nationalLimit?.numerator +
'/' +
p.nationalLimit?.denominator
: '; limite documentado') +
'; limite CDT: ' +
(p.input.treaty === 'no'
? 'Não aplicável documentado'
@@ -1646,7 +1679,15 @@ export function annualReportRows(
p.pending.join(' | '),
p.input.incomeReference +
'; ' +
p.input.nationalLimitReference +
(p.nationalDerivation
? 'Limite manual anterior conservado, não utilizado nesta derivação'
: p.input.nationalLimitReference) +
(p.nationalDerivation
? '; correspondência: ' +
p.nationalDerivation.reference +
'; ' +
p.nationalDerivation.version
: '') +
'; ' +
p.input.treatyReference +
'; ' +
+64 -3
View File
@@ -38,6 +38,8 @@ export type InternationalPosition = {
incomeReference: string;
nationalLimit: string;
nationalLimitReference: string;
nationalMethod?: 'documented' | 'proportional';
nationalBasisReference?: string;
treaty: '' | 'yes' | 'no';
treatyLimit: string;
treatyReference: string;
@@ -149,6 +151,10 @@ export function validateInternational(c: InternationalCredits) {
) ||
!yesNo.includes(p.incomeIncluded) ||
!yesNo.includes(p.treaty) ||
(p.nationalMethod !== undefined &&
!['documented', 'proportional'].includes(p.nationalMethod)) ||
(p.nationalBasisReference !== undefined &&
typeof p.nationalBasisReference !== 'string') ||
!evidenceValid(p.previousUse) ||
!Array.isArray(p.payments)
)
@@ -278,6 +284,11 @@ export function internationalPosition(
subjectNuit: string,
year: string,
assessmentKey: string,
nationalBasis?: {
ordinary: boolean;
taxableBase: FiscalFraction | null;
colecta: FiscalFraction | null;
},
) {
const pending = [...proofIssues];
let nationalLimit: FiscalFraction | null = null,
@@ -286,6 +297,13 @@ export function internationalPosition(
eligible: FiscalFraction | null = null,
available: FiscalFraction | null = null,
aboveLimit: FiscalFraction | null = null;
let nationalDerivation: {
version: string;
income: FiscalFraction;
taxableBase: FiscalFraction;
colecta: FiscalFraction;
reference: string;
} | null = null;
try {
if (
!p.id.trim() ||
@@ -311,8 +329,46 @@ export function internationalPosition(
'Falta inclusão documentada do rendimento estrangeiro na matéria colectável.',
);
const income = creditMoney(p.incomeAmount);
nationalLimit = creditLimit(p.nationalLimit);
if (!p.nationalLimitReference.trim())
if (p.nationalMethod === 'proportional') {
const basis = nationalBasis;
if (
!basis?.ordinary ||
!basis.taxableBase ||
!basis.colecta ||
creditCompare(basis.taxableBase, zero()) <= 0n ||
creditCompare(basis.colecta, zero()) < 0n
)
throw Error(
'Derivação da fracção nacional exige matéria colectável positiva e colecta L6 ordinária corrente; efeitos L7 e casos especiais conservam correspondência própria.',
);
if (!p.nationalBasisReference?.trim())
throw Error(
'Identifique a correspondência da parcela líquida estrangeira na matéria colectável, incluindo custos/perdas/deduções aplicáveis; o portal não reparte esses valores por presunção.',
);
if (creditCompare(income, basis.taxableBase) > 0n)
throw Error(
'Parcela estrangeira excede a matéria colectável corrente; reconcilie custos, perdas e deduções antes de derivar a fracção.',
);
nationalLimit = fraction(
BigInt(basis.colecta.numerator) *
BigInt(income.numerator) *
BigInt(basis.taxableBase.denominator),
BigInt(basis.colecta.denominator) *
BigInt(income.denominator) *
BigInt(basis.taxableBase.numerator),
);
nationalDerivation = {
version: 'IRPC-national-fraction/1',
income,
taxableBase: structuredClone(basis.taxableBase),
colecta: structuredClone(basis.colecta),
reference: p.nationalBasisReference,
};
} else nationalLimit = creditLimit(p.nationalLimit);
if (
p.nationalMethod !== 'proportional' &&
!p.nationalLimitReference.trim()
)
throw Error(
'Fracção nacional exige suporte próprio; não é calculada nem presumida pelo portal.',
);
@@ -363,6 +419,7 @@ export function internationalPosition(
country: p.country,
paid,
nationalLimit,
...(nationalDerivation ? { nationalDerivation } : {}),
treatyLimit,
previousUse,
eligible,
@@ -403,7 +460,11 @@ export function internationalDeduction(
: null,
}
: {}),
source: internationalCreditSource,
source:
internationalCreditSource +
(positions.some((p) => p.nationalDerivation)
? ' Modo IRPC-national-fraction/1: no caso L6 ordinário corrente com parcela líquida documentada e correspondida, fracção = colecta antes de créditos × parcela líquida estrangeira / matéria colectável. Não efectua repartição de custos/perdas ou qualificação automática de CDT.'
: ''),
countryAllocationCreated: false,
carryCreated: false,
officialBalancesConsumed: false,