Implement scoped L2 E annual adjustments and asset control with grouped D E manifest

This commit is contained in:
2026-10-25 13:22:17 +02:00
parent 2c2a2f2010
commit dde20c3348
12 changed files with 556 additions and 6 deletions
@@ -0,0 +1,33 @@
import {useState} from 'react';
import {newRegularization,regularizationBook,regularizationSources,saveRegularizationBook,recordRegularizations,regularizationReportRows,frozenAssetRows,type RegularizationEvent,type RegularizationBook} from '@/lib/iva-regularizations';
export function AcquisitionRegularizations({draft,onChange}:{draft:Record<string,unknown>;onChange:(field:string,value:string)=>void}){
const[error,setError]=useState('');let b:RegularizationBook;
try{b=regularizationBook(draft);}catch(cause){return<p role="alert">{String(cause)}</p>;}
const save=(next:RegularizationBook)=>{try{onChange('modelo_a_snapshot',saveRegularizationBook(draft,next));setError('');}catch(cause){setError(String(cause));}};
const change=(id:string,patch:Partial<RegularizationEvent>)=>save({...b,events:b.events.map(e=>e.id===id?{...e,...patch}:e)});
const sources=regularizationSources(draft);
const add=(kind:RegularizationEvent['kind'])=>save({...b,events:[...b.events,newRegularization(crypto.randomUUID(),kind,sources.at(-1)??null)]});
const labels={scope:'As parcelas e o âmbito correspondem ao evento,sem estender o direito a outros bens/operações',recorded:'O valor original foi deduzido ou é pressuposto explicitamente assumido nesta simulação',annual:'Bases finais do ano completo22(4),semIVA,incluindo operações fora de campo',exclusions:'Excluí vendas de activo usado e operações imobiliárias/financeiras acessórias22(5)',supplierCorrection:'O fornecedor anulou/reduziu a operação e emitiu o documento rectificativo',rightUnchanged:'O documento conserva o âmbito e as condições de dedução;sem alteração de direito'};
return<details className="rounded border p-3"><summary>E — activos e regularizações por evento</summary>
<p>Reutiliza resultados congelados de D e documentos existentes. O acerto anual usa o IVA elegível antes de D, já limitado por C, e compara com o deduzido. Uma rectificação da compra tem documento e prazo próprios. Guardar E não altera as deduções originais; depois actualize expressamente o apuramento parcial para conferir F.</p>
<p>18.º(6) com afectação mista continua pendente. Não existe regularização plurianual genérica de activos,correcção de erros ou incobráveis automatizada neste percurso. Submissão fiscal fora do InvesteMoz;19–27/restituição em L3.</p>
{error&&<p role="alert">{error}</p>}
<button type="button" onClick={()=>add('annual')}>Preparar acerto anual do pro rata</button>{' '}
<button type="button" onClick={()=>add('purchase_correction')}>Preparar rectificação da dedução pelo adquirente</button>
{b.events.map((e,index)=><fieldset className="rounded border p-3" key={e.id}><legend>{index+1}. {e.kind==='annual'?'Acerto anual22(6)':'Rectificação51(4)'}</legend>
<label>Resultado original congelado<select value={sources.findIndex(s=>JSON.stringify(s)===JSON.stringify(e.source))} onChange={event=>{const source=sources[Number(event.target.value)];if(source)change(e.id,{source:structuredClone(source),rowIds:source.inputs.filter(r=>e.kind!=='annual'||r.d?.method==='pro_rata').map(r=>r.id)});}}><option value={-1}>Seleccione uma versão</option>{sources.map((s,i)=><option key={i} value={i}>Revisão{s.revision} — {s.calculatedAt}</option>)}</select></label>
<p>Escolher outra versão adopta expressamente as parcelas dessa versão,conservando os outros dados do evento. Desmarque parcelas fora do âmbito;não pode regularizar a mesma aquisição duas vezes.</p>
{e.source?.inputs.map(r=><label className="block" key={r.id}><input type="checkbox" checked={e.rowIds.includes(r.id)} onChange={event=>change(e.id,{rowIds:event.target.checked?[...e.rowIds,r.id]:e.rowIds.filter(id=>id!==r.id)})}/>{r.description||r.id} — {r.documentRef} — {r.period} — {r.origin==='projected'?'Pressuposto de simulação':'Efectivo declarado'}</label>)}
<label>Período da regularização<input type="month" value={e.period} min="2026-01" max="2026-12" onChange={v=>change(e.id,{period:v.target.value})}/></label>
<label>Documento/fonte do evento<input value={e.reference} onChange={v=>change(e.id,{reference:v.target.value})}/></label>
<label>Motivo e âmbito do evento<input value={e.reason} onChange={v=>change(e.id,{reason:v.target.value})}/></label>
{e.kind==='annual'?<><label>Operações anuais finais com direito — sem IVA (MZN)<input value={e.numerator} onChange={v=>change(e.id,{numerator:v.target.value})}/></label><label>Total anual final22(4–5) — sem IVA (MZN)<input value={e.denominator} onChange={v=>change(e.id,{denominator:v.target.value})}/></label></>:<><label>Data de recepção do documento rectificativo<input type="date" value={e.receivedDate} onChange={v=>change(e.id,{receivedDate:v.target.value})}/></label><label>Dedução corrigida documentada (MZN)<input value={e.correctedDeductible} onChange={v=>change(e.id,{correctedDeductible:v.target.value})}/></label></>}
{Object.entries(labels).filter(([k])=>['scope','recorded',...(e.kind==='annual'?['annual','exclusions']:['supplierCorrection','rightUnchanged'])].includes(k)).map(([k,label])=><label className="block" key={k}>{label}<select value={e.facts[k]??''} onChange={v=>change(e.id,{facts:{...e.facts,[k]:v.target.value as ''|'yes'|'no'}})}><option value="">Por confirmar</option><option value="yes">Sim</option><option value="no">Não</option></select></label>)}
<button type="button" onClick={()=>save({...b,events:b.events.filter(row=>row.id!==e.id)})}>Remover evento em preparação (histórico conservado)</button>
</fieldset>)}
{[...new Set(b.events.map(e=>e.period))].filter(Boolean).map(period=><label className="block" key={period}><input type="checkbox" checked={b.completePeriods.includes(period)} onChange={e=>save({...b,completePeriods:e.target.checked?[...b.completePeriods,period]:b.completePeriods.filter(p=>p!==period)})}/>Reconciliei todas as regularizações deste período — {period};os outros motivos não automatizados foram conferidos.</label>)}
<p>Quando existirem eventos E, retire as declarações «Sem operações» nos campos12/13 desse período. Uma cobertura incompleta mantém os totais afectados indeterminados.</p>
<button type="button" onClick={()=>{try{save(recordRegularizations(draft,b));}catch(cause){setError(String(cause));}}}>Calcular e guardar regularizações E</button>
{[...regularizationReportRows(draft),...frozenAssetRows(draft)].map(([,label,value,source],i)=><p key={i}><strong>{label}</strong>: {value}<small className="block">{source}</small></p>)}
</details>;
}
@@ -1,4 +1,5 @@
import { useState } from 'react';
import {AcquisitionRegularizations} from './acquisition-regularizations';
import { AcquisitionOperationLink } from './acquisition-operation-link';
import { AcquisitionImportsExclusions } from './acquisition-imports-exclusions';
import { AcquisitionAllocationEditor } from './acquisition-allocation';
@@ -49,6 +50,7 @@ export function SimulationAcquisitions({draft,onChange}:{draft:Record<string,unk
<label>Descrição<input className="block rounded border p-2" value={row.description} onChange={e=>change(row.id,{description:e.target.value})}/></label>
{row.sourceMonth===null && <label>Reutilizar valor existente, sem presumir que o orçamento é uma factura<select className="block rounded border p-2" value="" onChange={e=>run(()=>{const ref=references.find(r=>r.key===e.target.value);if(ref)change(row.id,{sourceMonth:ref.month,sourcePeriod:ref.period,sourceField:ref.kind,sourceAmount:ref.amount,sourceCurrency:ref.currency,...(ref.kind==='asset'?{}:{period:ref.period})});})}><option value="">Escolher apenas se corresponde a esta aquisição</option>{references.filter(ref=>ref.kind===(row.field==='08'?'asset':row.field==='10'?'operating':'inventory')).map(ref=><option key={ref.key} value={ref.key}>{ref.label}: {ref.amount??'sem informação'} {ref.currency}</option>)}</select></label>}
{select(row,'field','Categoria',[['08','08 — Imobilizado'],['09','09 — Existências'],['10','10 — Outros bens e serviços'],...(row.bc?[['11','11 — Importações de bens'] as [string,string]]:[])])}
{row.field==='11'&&<label><input type="checkbox" checked={row.investmentAsset??false} onChange={e=>change(row.id,{investmentAsset:e.target.checked})}/>Bem de investimento importado — incluir no controlo de activos;conserva campo11 e condições próprias da importação.</label>}
{select(row,'origin','Natureza dos dados',[['projected','Projectados / pressupostos'],['effective','Efectivos declarados']])}
<label>Período de dedução<input className="block rounded border p-2" type="month" value={row.period} onChange={e=>change(row.id,{period:e.target.value})}/></label>
{row.sourceMonth!==null && <label>O valor de origem corresponde a<select className="block rounded border p-2" value={row.sourceBasis} onChange={e=>{const basis=e.target.value as Acquisition['sourceBasis'];change(row.id,{sourceBasis:basis,...(basis==='net'&&!row.net?{net:row.sourceAmount??''}:basis==='gross'&&!row.gross?{gross:row.sourceAmount??''}:{})});}}><option value="">Por classificar</option><option value="net">Valor sem IVA</option><option value="gross">Valor com IVA</option></select></label>}
@@ -72,6 +74,7 @@ export function SimulationAcquisitions({draft,onChange}:{draft:Record<string,unk
{row.sourceMonth===null && <button type="button" className="mr-3 underline" onClick={()=>save({...book,rows:book.rows.filter(r=>r.id!==row.id)})}>Remover esta aquisição introduzida directamente</button>}
{row.sourceMonth!==null && <button type="button" className="underline" onClick={()=>run(()=>{const ref=acquisitionPlanReferences(draft).find(r=>r.month===row.sourceMonth && r.kind===(row.sourceField??'inventory'));if(!ref)throw new Error('Origem não disponível; conserve o registo e reveja o plano.');if(draft.currency!==row.sourceCurrency)throw new Error('Moeda divergente; não adoptar montantes de outra moeda.');change(row.id,{sourceAmount:ref.amount,sourcePeriod:ref.period,...(row.sourceBasis==='net'?{net:ref.amount??'',gross:''}:row.sourceBasis==='gross'?{gross:ref.amount??'',net:''}:{})});})}>Adoptar explicitamente o valor actual do plano (conserva histórico)</button>}
</details>)}
<AcquisitionRegularizations draft={draft} onChange={onChange}/>
{book.periods.map(period=><details key={period.period} className="rounded border p-3"><summary>{period.period} — cobertura das parcelas — {period.complete && period.absent.length===acquisitionExcludedFields.length?'confirmada':'por completar'}</summary>
{book.rows.some(r=>r.bc)&&<label className="block"><input type="checkbox" checked={period.importsComplete??false} onChange={e=>save({...book,periods:book.periods.map(p=>p.period===period.period?{...p,importsComplete:e.target.checked}:p)})}/> Incluí todas as importações de bens/campo11 deste período,mesmo isentas ou sem direito;sem somar novamente IVA de serviços incluídos na base.</label>}
<label className="block"><input type="checkbox" checked={period.complete} onChange={e=>save({...book,periods:book.periods.map(p=>p.period===period.period?{...p,complete:e.target.checked}:p)})}/> Incluí todas as aquisições08–10 deste período, incluindo as sem direito à dedução; uma lista vazia significa que não houve essas aquisições.</label>
+17 -5
View File
@@ -7,6 +7,7 @@ import {evaluateAcquisitionBC,validAcquisitionBC,acquisitionBCSource,acquisition
import { linkedOperationRight, validAcquisitionRightLink, acquisitionRightVersion, acquisitionRightSource, type AcquisitionRightLink, type AcquisitionEligibility } from './iva-acquisition-right.ts';
import { acquisitionTreatmentIssue, acquisitionContinuityVersion, formerExplorationSource, type AcquisitionTreatment } from './iva-acquisition-continuity.ts';
import { addFractions, decimalFraction, fractionLabel, fractionPresentation, positiveFraction, subtractFractions, type FiscalFraction } from './fiscal-rational.ts';
import {regularizationFields,regularizationSourceKey,regularizationReportRows,frozenAssetRows,validateRegularizationStore} from './iva-regularizations.ts';
export const acquisitionVersion = 'modelo-a-internal-acquisitions/1';
export const acquisitionBasis = 'CIVA arts.18(1)(a),18(2) (Lei10/2025),18(3–5),19(1)(a),19(2),20 (Lei22/2022),21(1–3); âmbito interno, afectação exclusiva, mesmo período, sem exclusões ou dedução parcial.';
@@ -23,6 +24,7 @@ export type Acquisition = {
deductionLink?: AcquisitionRightLink;
bc?:AcquisitionBC;
d?:AcquisitionAllocation;
investmentAsset?:boolean;
acquisitionTreatmentOrigin?: {id:'former_exploration_exemption';source:string};
};
export type AcquisitionResult = {id:string; net:string|null; vat:string|null; gross:string|null; deductible:string|null; reason:string; eligibility?:AcquisitionEligibility;deductibleExact?:FiscalFraction;nonDeductibleExact?:FiscalFraction;allocationCalculation?:{version:string;ratio:FiscalFraction;rawRatio:FiscalFraction;before:FiscalFraction;source:string}};
@@ -44,7 +46,9 @@ export function readAcquisitionStore(raw:unknown):Store {
if (!raw) return {version:1,books:{}};
const value=JSON.parse(String(raw));
if (value?.version!==1 || !value.books || typeof value.books!=='object' || Array.isArray(value.books)) throw new Error('Compras fiscais guardadas não recuperáveis; dados preservados.');
validateRegularizationStore(value);
for(const book of Object.values(value.books) as AcquisitionBook[]) {
if(book?.rows?.some(row=>row.investmentAsset!==undefined&&typeof row.investmentAsset!=='boolean'))throw new Error('Classificação do activo não recuperável;originais preservados.');
if(book?.rows?.some(row=>row.d!==undefined&&!validAcquisitionAllocation(row.d)))throw new Error('AfectaçãoD não recuperável;originais preservados.');
if(book?.rows?.some(row=>row.bc!==undefined&&!validAcquisitionBC(row.bc))||book?.periods?.some(p=>p.importsComplete!==undefined&&typeof p.importsComplete!=='boolean'))throw new Error('CondiçõesB/C ou cobertura de importações inválidas;originais preservados.');
if(book?.rightVersion!==undefined&&book.rightVersion!==acquisitionRightVersion)throw new Error('Versão do direito da aquisição não recuperável; original preservado.');
@@ -141,7 +145,8 @@ function sourceKey(draft:Record<string,unknown>,book:AcquisitionBook):string {
// Change detection only, never an authorization or authenticity token.
let hash=14695981039346656037n;for(let i=0;i<raw.length;i++)hash=BigInt.asUintN(64,(hash^BigInt(raw.charCodeAt(i)))*1099511628211n);
const operations=(readAcquisitionStore(draft.modelo_a_snapshot) as Store & {salesOperations?:Record<string,unknown>}).salesOperations?.[acquisitionScope(draft)];
return `${raw.length}:${hash.toString(16)}${operations?`:${JSON.stringify(operations)}`:''}${book.rows.some(r=>r.acquisitionTreatment||r.acquisitionTreatmentOrigin)?`:${acquisitionContinuityVersion}`:''}${book.rightVersion||book.rows.some(r=>r.deductionLink)?`:${acquisitionRightVersion}`:''}${book.rows.some(r=>r.bc)?`:${acquisitionBCSourceKey(draft,book.rows)}`:''}${book.rows.some(r=>r.d)?`:${acquisitionAllocationVersion}:${allocationSourceKey(draft,book.rows)}`:''}`;
const e=regularizationSourceKey(draft);
return `${raw.length}:${hash.toString(16)}${operations?`:${JSON.stringify(operations)}`:''}${book.rows.some(r=>r.acquisitionTreatment||r.acquisitionTreatmentOrigin)?`:${acquisitionContinuityVersion}`:''}${book.rightVersion||book.rows.some(r=>r.deductionLink)?`:${acquisitionRightVersion}`:''}${book.rows.some(r=>r.bc)?`:${acquisitionBCSourceKey(draft,book.rows)}`:''}${book.rows.some(r=>r.d)?`:${acquisitionAllocationVersion}:${allocationSourceKey(draft,book.rows)}`:''}${e?`:E:${e}`:''}`;
}
function location(draft:Record<string,unknown>):string {
const labels=draft.selection_labels as Record<string,unknown>|undefined;
@@ -206,7 +211,13 @@ export function calculateAcquisitions(draft:Record<string,unknown>,book:Acquisit
}
if(!input?.complete) reasons.push('Aquisições08–10: confirme que todas as compras do período foram incluídas, mesmo quando não existam.');
for(const row of book.rows.filter(r=>r.period===period)) {const r=rows.find(x=>x.id===row.id)!;if(r.deductible===null) reasons.push(`${row.description||row.id}: ${r.reason}`);}
for(const field of excluded) if(fields[field]===null) reasons.push(`Campo${field}: fora deste lote, sem declaração expressa de inexistência de operações.`);
const adjustments=regularizationFields(draft,period,book.rows);
if(adjustments){
if(input?.absent.some(f=>f==='12'||f==='13'))throw Error('Existem regularizaçõesE neste período. Retire a declaração de ausência12/13 e confirme a coberturaE,sem apagar o histórico.');
for(const f of ['12','13'])fields[f]=adjustments.fields[f]?fractionPresentation(adjustments.fields[f]!).decimal:null;
reasons.push(...adjustments.reasons);
}
for(const field of excluded) if(fields[field]===null) reasons.push(`Campo${field}: sem apuramento correspondente ou declaração expressa de inexistência de operações.`);
fields['14']=sum(['01','03','05','06','07'].map(f=>fields[f]));
fields['15']=sum(['08','09','10','11','12'].map(f=>fields[f]));
fields['16']=sum(['02','04','13'].map(f=>fields[f]));
@@ -214,14 +225,15 @@ export function calculateAcquisitions(draft:Record<string,unknown>,book:Acquisit
fields['17']=state===null||taxpayer===null?null:money(state>taxpayer?state-taxpayer:0n);
fields['18']=state===null||taxpayer===null?null:money(taxpayer>state?taxpayer-state:0n);
const classified=salesOperationsCurrent(draft,operations)?operations.result?.periods.find(p=>p.period===period):null;
if(classified?.exactFields||book.rows.some(r=>r.bc||r.d)) {
if(classified?.exactFields||book.rows.some(r=>r.bc||r.d)||adjustments) {
const exactFields:Record<string,FiscalFraction|null>={};
for(const f of ['01','02','03','04','05','06','07','08','09','10','11','12','13'])exactFields[f]=classified?.exactFields?.[f]??(fields[f]===null?null:decimalFraction(fields[f]!));
for(const f of ['08','09','10','11'])if(fields[f]!==null){const matching=book.rows.filter(r=>r.period===period&&r.field===f).map(r=>rows.find(v=>v.id===r.id)!);exactFields[f]=addFractions(matching.map(r=>r.deductibleExact??decimalFraction(r.deductible!)));}
if(adjustments)for(const f of ['12','13'])exactFields[f]=adjustments.fields[f];
for(const [f,parts] of [['14',['01','03','05','06','07']],['15',['08','09','10','11','12']],['16',['02','04','13']]] as const)exactFields[f]=parts.some(k=>exactFields[k]===null)?null:addFractions(parts.map(k=>exactFields[k]!));
exactFields['17']=exactFields['16']&&exactFields['15']?positiveFraction(subtractFractions(exactFields['16'],exactFields['15'])):null;
exactFields['18']=exactFields['16']&&exactFields['15']?positiveFraction(subtractFractions(exactFields['15'],exactFields['16'])):null;
if(book.rows.some(r=>r.d)&&allocationHasUnconsolidatedOutputs(draft,period)){
if((book.rows.some(r=>r.d)||adjustments)&&allocationHasUnconsolidatedOutputs(draft,period)){
for(const f of ['14','16','17','18'])exactFields[f]=null;
reasons.push('Origem18(6) identifica base/proporção,sem IVA liquidado consolidado no livro de operações. Não presumir impostozero nem duplicar a base:totais14/16/17/18 permanecem indeterminados;dedução15 conserva apuramento próprio.');
}
@@ -263,6 +275,6 @@ export function acquisitionReportRows(draft:Record<string,unknown>):Array<[strin
if(period.exactFields)out.push(['IVA mensal',`Modelo A — ${period.period} — precisão exacta`,Object.entries(period.exactFields).map(([f,v])=>`${f}: ${v?fractionLabel(v):'Indeterminado'}`).join('; '),'Fracções em MZN; apresentação decimal técnica, sem regra declarativa presumida.']);
if(period.reasons.length)out.push(['IVA mensal',`Modelo A — ${period.period} — pendências`,period.reasons.join(' '),result.sources]);
}
return out;
return [...out,...regularizationReportRows(draft),...frozenAssetRows(draft)];
} catch {return [['IVA mensal','Compras — Modelo A','Não foi possível recuperar os dados guardados','Preservados, sem substituição por zero']];}
}
+84
View File
@@ -0,0 +1,84 @@
import type {AcquisitionCalculation,Acquisition,AcquisitionResult} from './iva-acquisitions.ts';
import {addFractions,decimalFraction,fraction,fractionLabel,fractionPresentation,subtractFractions,positiveFraction,type FiscalFraction} from './fiscal-rational.ts';
export const regularizationSource='L2-E: CIVA22(4–8),Lei13/2016 PDF16/p1426(274),acerto anual no último período do ano;CIVA51(1/4),PDF21/p1426(279),rectificação da dedução pelo adquirente até ao fim do período seguinte à recepção. Decreto7/2008,RCIVA27,BR16 PDF5/p103,registo individual de activos: data,IVA suportado e deduzido. Caixas ModeloA12/13;divergência de remissões textuais11/12 conservada,sem alterar P001/05–06.';
type Choice=''|'yes'|'no';
export type RegularizationEvent={id:string;kind:'annual'|'purchase_correction';period:string;source:AcquisitionCalculation|null;rowIds:string[];numerator:string;denominator:string;reference:string;receivedDate:string;correctedDeductible:string;reason:string;facts:Record<string,Choice>};
export type RegularizationResult={id:string;period:string;status:'determined'|'indeterminate';reason:string;delta:FiscalFraction|null;rawRatio?:FiscalFraction;ratio?:FiscalFraction;details:string;source:string};
type Calculation={version:1;calculatedAt:string;key:string;events:RegularizationResult[]};
export type RegularizationBook={version:1;events:RegularizationEvent[];completePeriods:string[];result?:Calculation;history?:Calculation[]};
type FrozenLine={input:Acquisition;result:AcquisitionResult};
const scope=(draft:Record<string,unknown>)=>String(draft.context_opportunity||'general');
function store(draft:Record<string,unknown>):Record<string,unknown>{const s=JSON.parse(String(draft.modelo_a_snapshot||'{"version":1,"books":{}}'));if(s.version!==1||!s.books)throw Error('Origem fiscal não recuperável;conserve os originais.');return s;}
export function validateRegularizationStore(s:Record<string,unknown>):void{
if(s.regularizations===undefined)return;
if(!s.regularizations||typeof s.regularizations!=='object'||Array.isArray(s.regularizations))throw Error('Mapa de regularizações não recuperável;originais preservados.');
for(const value of Object.values(s.regularizations))assertRegularizationBook(value as RegularizationBook);
}
function assertRegularizationBook(value:RegularizationBook):void{
const badSource=(s:AcquisitionCalculation|null)=>s!==null&&(!s||typeof s!=='object'||!Array.isArray(s.inputs)||!Array.isArray(s.rows)||!Array.isArray(s.periods)||!Number.isInteger(s.revision)||!['currency','opportunity','calculatedAt','sourceKey'].every(k=>typeof s[k as keyof AcquisitionCalculation]==='string'));
if(!value||value.version!==1||!Array.isArray(value.events)||!Array.isArray(value.completePeriods)||value.completePeriods.some(p=>typeof p!=='string')||value.history!==undefined&&!Array.isArray(value.history)||value.events.some(e=>!e||!['annual','purchase_correction'].includes(e.kind)||!['id','period','numerator','denominator','reference','receivedDate','correctedDeductible','reason'].every(k=>typeof e[k as keyof RegularizationEvent]==='string')||!Array.isArray(e.rowIds)||e.rowIds.some(id=>typeof id!=='string')||!e.facts||typeof e.facts!=='object'||Array.isArray(e.facts)||Object.values(e.facts).some(v=>!['','yes','no'].includes(v))||badSource(e.source)))throw Error('Regularizações não recuperáveis;originais preservados,sem substituir por zero.');
if(value.result&&(!Array.isArray(value.result.events)||value.result.version!==1||typeof value.result.key!=='string'||typeof value.result.calculatedAt!=='string'||value.result.events.some(e=>!e||typeof e.id!=='string'||typeof e.period!=='string'||!['determined','indeterminate'].includes(e.status)||e.delta!==null&&(!e.delta||! /^-?\d{1,80}$/.test(e.delta.numerator)||!/^\d{1,80}$/.test(e.delta.denominator)||BigInt(e.delta.denominator)===0n))))throw Error('Resultado de regularizações não recuperável;originais preservados.');
}
export function regularizationBook(draft:Record<string,unknown>):RegularizationBook{
const value=(store(draft).regularizations as Record<string,RegularizationBook>|undefined)?.[scope(draft)];
if(!value)return{version:1,events:[],completePeriods:[]};
assertRegularizationBook(value);
return value;
}
export function saveRegularizationBook(draft:Record<string,unknown>,book:RegularizationBook):string{const s=store(draft);return JSON.stringify({...s,regularizations:{...(s.regularizations as object??{}),[scope(draft)]:book}});}
export function regularizationSources(draft:Record<string,unknown>):AcquisitionCalculation[]{const b=(store(draft).books as Record<string,{result?:AcquisitionCalculation;history?:AcquisitionCalculation[]}>)[scope(draft)];return b?[...(b.history??[]),...(b.result?[b.result]:[])].filter((v,i,a)=>a.findIndex(x=>JSON.stringify(x)===JSON.stringify(v))===i):[];}
export function newRegularization(id:string,kind:RegularizationEvent['kind'],source:AcquisitionCalculation|null):RegularizationEvent{return{id,kind,period:source?source.inputs[0]?.period.slice(0,4)+'-12':'',source:source?structuredClone(source):null,rowIds:source?.inputs.filter(r=>kind==='annual'?r.d?.method==='pro_rata':true).map(r=>r.id)??[],numerator:'',denominator:'',reference:'',receivedDate:'',correctedDeductible:'',reason:'',facts:{}};}
function frozenLines(e:RegularizationEvent):FrozenLine[]{return e.rowIds.map(id=>({input:e.source!.inputs.find(r=>r.id===id)!,result:e.source!.rows.find(r=>r.id===id)!}));}
function sourceAvailable(draft:Record<string,unknown>,e:RegularizationEvent):boolean{return !!e.source&&regularizationSources(draft).some(s=>JSON.stringify(s)===JSON.stringify(e.source));}
function multiply(a:FiscalFraction,b:FiscalFraction){return fraction(BigInt(a.numerator)*BigInt(b.numerator),BigInt(a.denominator)*BigInt(b.denominator));}
const validDate=(s:string)=>/^2026-\d{2}-\d{2}$/.test(s)&&!Number.isNaN(Date.parse(s))&&new Date(s).toISOString().slice(0,10)===s;
function identity(e:RegularizationEvent,id:string):string{const r=e.source?.inputs.find(r=>r.id===id);return JSON.stringify([e.kind,r?.supplier.trim().toLowerCase(),r?.documentType,r?.documentRef.trim().toLowerCase(),r?.documentDate,r?.documentLine.trim(),e.kind==='annual'?e.period.slice(0,4):'']);}
export function evaluateRegularization(draft:Record<string,unknown>,e:RegularizationEvent):RegularizationResult{
const stop=(reason:string):RegularizationResult=>({id:e.id,period:e.period,status:'indeterminate',reason,delta:null,details:'Histórico preservado;sem lançamento automático.',source:regularizationSource});
if(!/^2026-(0[1-9]|1[0-2])$/.test(e.period)||draft.currency!=='MZN'||e.source?.currency!=='MZN'||e.source.opportunity!==scope(draft)||!sourceAvailable(draft,e))return stop('Âmbito2026/MZN e resultado original congelado na mesma oportunidade por identificar;uma edição actual não substitui o resultado original.');
if(!e.rowIds.length||new Set(e.rowIds).size!==e.rowIds.length)return stop('Seleccione parcelas originais distintas.');
const lines=frozenLines(e);if(lines.some(l=>!l.input||!l.result||l.result.deductibleExact===undefined||l.result.eligibility?.status!=='eligible'||!l.input.documentRef.trim()))return stop('Parcela original sem dedução exacta/elegível/documento;não presumir dedução inicial.');
if(!e.reference.trim()||!e.reason.trim()||e.facts.scope!=='yes'||e.facts.recorded!=='yes')return stop('Identifique documento/fonte,motivo,âmbito e montante originalmente deduzido (efectivo ou pressuposto da projecção).');
let delta:FiscalFraction,details:string,rawRatio:FiscalFraction|undefined,ratio:FiscalFraction|undefined;
if(e.kind==='annual'){
if(!e.period.endsWith('-12')||lines.some(l=>l.input.period.slice(0,4)!==e.period.slice(0,4)||l.input.d?.method!=='pro_rata'||!l.result.allocationCalculation))return stop('Acerto22(6):apenas pro rata provisório do mesmo ano,no último período;afectação real e18(6) têm regras próprias.');
if(e.facts.annual!=='yes'||e.facts.exclusions!=='yes')return stop('Confirme bases efectivas anuais22(4),semIVA,incluindo fora de campo,e exclusões22(5);não usar apenas vendas do mês.');
if(!/^\d{1,15}(\.\d{1,6})?$/.test(e.numerator)||!/^\d{1,15}(\.\d{1,6})?$/.test(e.denominator))return stop('Bases anuais finais em falta ou inválidas.');
const n=decimalFraction(e.numerator),d=decimalFraction(e.denominator);if(BigInt(d.numerator)===0n)return stop('Denominador anual zero;sem percentagem por defeito.');
rawRatio=fraction(BigInt(n.numerator)*BigInt(d.denominator),BigInt(n.denominator)*BigInt(d.numerator));if(BigInt(rawRatio.numerator)>BigInt(rawRatio.denominator))return stop('Numerador anual excede denominador.');
ratio=fraction((BigInt(rawRatio.numerator)*100n+BigInt(rawRatio.denominator)-1n)/BigInt(rawRatio.denominator),100n);
delta=addFractions(lines.map(l=>subtractFractions(multiply(l.result.allocationCalculation!.before,ratio!),l.result.deductibleExact!)));
details=lines.map(l=>`${l.input.documentRef}/linha${l.input.documentLine||'única'}:IVA elegível antesD${fractionLabel(l.result.allocationCalculation!.before)},deduzido${fractionLabel(l.result.deductibleExact!)},final${fractionLabel(multiply(l.result.allocationCalculation!.before,ratio!))}`).join('; ')+`;quociente final${fractionLabel(rawRatio)};aplicado${fractionLabel(ratio)}`;
}else{
if(lines.length!==1||!validDate(e.receivedDate))return stop('Rectificação51(4):seleccione uma linha e a data de recepção do documento rectificativo.');
const received=e.receivedDate.slice(0,7),next=new Date(e.receivedDate+'T00:00:00Z');next.setUTCMonth(next.getUTCMonth()+1,1);const last=next.toISOString().slice(0,7);
if(e.receivedDate<lines[0].input.documentDate||e.period<received||e.period>last||e.period<lines[0].input.period)return stop('Período fora da recepção/seguinte51(4),ou anterior à dedução original;sem alteração retroactiva.');
if(e.facts.supplierCorrection!=='yes'||e.facts.rightUnchanged!=='yes')return stop('Confirme rectificação pelo fornecedor e manutenção do âmbito/condições da dedução. Mudança de direito exige enquadramento próprio.');
let corrected:FiscalFraction;try{corrected=decimalFraction(e.correctedDeductible);}catch{return stop('Indique a dedução corrigida documentada,sem taxa ou dedução presumida.');}
if(BigInt(subtractFractions(corrected,lines[0].result.deductibleExact!).numerator)>0n)return stop('Este percurso51(4) trata anulação/redução da dedução pelo adquirente;acréscimos ou erros têm fundamento/prazo próprios.');
delta=subtractFractions(corrected,lines[0].result.deductibleExact!);details=`${lines[0].input.documentRef};deduzido${fractionLabel(lines[0].result.deductibleExact!)};corrigido${fractionLabel(corrected)};recebido${e.receivedDate};limite${last}`;
}
const sign=BigInt(delta.numerator);return{id:e.id,period:e.period,status:'determined',delta,...(rawRatio&&ratio?{rawRatio,ratio}:{}),reason:sign>0n?'A favor do sujeito passivo — campo12':sign<0n?'A favor do Estado — campo13':'Sem diferença;evento conservado,sem nova dedução',details:`${details};revisão original${e.source.revision}/${e.source.calculatedAt};${lines.some(l=>l.input.origin==='projected')?'Pressuposto de simulação;sem declaração fiscal submetida':'Dados efectivos declarados;submissão fora do portal'};${e.reference};${e.reason}`,source:regularizationSource};
}
// Change detection only. Keep frozen source values, without embedding them again in every calculation key.
function fingerprint(value:unknown):string{const raw=JSON.stringify(value);let hash=14695981039346656037n;for(let i=0;i<raw.length;i++)hash=BigInt.asUintN(64,(hash^BigInt(raw.charCodeAt(i)))*1099511628211n);return`${raw.length}:${hash.toString(16)}`;}
function key(book:RegularizationBook){return fingerprint([book.version,book.events,book.completePeriods]);}
export function recordRegularizations(draft:Record<string,unknown>,book:RegularizationBook,now=new Date().toISOString()):RegularizationBook{
if(new Set(book.events.map(e=>e.id)).size!==book.events.length)throw Error('Evento repetido;sem dupla regularização.');
const identities=book.events.flatMap(e=>e.rowIds.map(id=>identity(e,id)));if(new Set(identities).size!==identities.length)throw Error('Mesma aquisição/ano ou documento já incluído noutra regularização deste motivo;consolide o evento original.');
// Mixing an annual correction and a credit note on the same deduction needs sequencing, not two independent deltas.
const seen=new Map<string,string>();for(const e of book.events)for(const id of e.rowIds){const k=identity({...e,kind:'purchase_correction'},id),prior=seen.get(k);if(prior&&prior!==e.kind)throw Error('Acerto anual e documento rectificativo sobre a mesma parcela exigem reconciliação sequencial;sem dupla correcção.');seen.set(k,e.kind);}
const result:Calculation={version:1,calculatedAt:now,key:key(book),events:book.events.map(e=>evaluateRegularization(draft,e))};return{...book,...(book.result?{history:[...(book.history??[]),structuredClone(book.result)]}:{}),result};
}
export function regularizationsCurrent(draft:Record<string,unknown>,b:RegularizationBook):boolean{return !!b.result&&b.result.version===1&&b.result.key===key(b)&&b.result.events.length===b.events.length&&b.events.every(e=>sourceAvailable(draft,e)&&b.result!.events.filter(r=>r.id===e.id&&r.period===e.period).length===1);}
export function regularizationFields(draft:Record<string,unknown>,period:string,currentRows?:Acquisition[]):{fields:Record<string,FiscalFraction|null>;reasons:string[]}|null{
const b=regularizationBook(draft);if(!b.events.some(e=>e.period===period)&&!b.completePeriods.includes(period))return null;
const events=b.result?.events.filter(e=>e.period===period)??[];
if(currentRows&&b.events.some(e=>e.period===period&&e.source&&frozenLines(e).some(l=>l.input&&currentRows.some(r=>r.id===l.input.id&&JSON.stringify(r)!==JSON.stringify(l.input)))))return{fields:{'12':null,'13':null},reasons:['A aquisição actual difere da parcela congelada usada emE;reconcilie a diferença antes de somar a regularização,sem recalcular o histórico.']};
if(!b.completePeriods.includes(period)||!regularizationsCurrent(draft,b)||events.some(e=>!e.delta))return{fields:{'12':null,'13':null},reasons:['RegularizaçõesE:complete/reconcilie o período e guarde o cálculo correspondente;sem zero presumido nem uso de resultado histórico.']};
return{fields:{'12':addFractions(events.map(e=>positiveFraction(e.delta!))),'13':addFractions(events.map(e=>positiveFraction(fraction(-BigInt(e.delta!.numerator),BigInt(e.delta!.denominator)))) )},reasons:['E:apenas eventos documentados declarados completos;12/13 separados,sem recalcular aquisições históricas.']};
}
export function regularizationSourceKey(draft:Record<string,unknown>):string{const b=regularizationBook(draft);const reduced=(store(draft).regulatedReducedBases as Record<string,{rows:unknown[]}>|undefined)?.[scope(draft)]?.rows??[];return b.events.length||b.completePeriods.length?fingerprint([b,regularizationsCurrent(draft,b),reduced]):'';}
export function regularizationReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{const b=regularizationBook(draft);if(!b.events.length)return[];return[['IVA mensal','RegularizaçõesE',regularizationsCurrent(draft,b)?'Resultado correspondente às entradas':'Histórico preservado;rever entradas/origem',regularizationSource],...(b.result?.events??[]).map(e=>['IVA mensal',`Regularização ${e.id} — ${e.period}`,`${e.status==='determined'?e.reason:'Indeterminado: '+e.reason};delta${e.delta?fractionLabel(e.delta):'indeterminado'}`,e.details+';'+e.source] as [string,string,string,string])];}
export function frozenAssetRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{const sources=regularizationSources(draft),seen=new Set<string>(),out:Array<[string,string,string,string]>=[];for(const s of [...sources].reverse())for(const r of s.inputs.filter(r=>r.field==='08'||r.investmentAsset===true)){const k=JSON.stringify([r.supplier,r.documentRef,r.documentDate,r.documentLine]);if(seen.has(k))continue;seen.add(k);const v=s.rows.find(v=>v.id===r.id);out.push(['IVA mensal',`Activo — ${r.description||r.id}`,`${r.documentRef};linha${r.documentLine||'única'};aquisição${r.documentDate};IVA suportado${v?.vat??'indeterminado'};IVA deduzido${v?.deductibleExact?fractionLabel(v.deductibleExact):v?.deductible??'indeterminado'}`,`RCIVA27,Decreto7/2008 PDF5/p103;${s.currency};revisão${s.revision}/${s.calculatedAt};${r.origin==='projected'?'Pressuposto de simulação':'Dados efectivos declarados'};sem amortização fiscal ou regularização plurianual presumidas.`]);}return out;}