Implement scoped L3 A B credit carry and VAT closure with frozen L2 sources

This commit is contained in:
2026-10-25 14:01:33 +02:00
parent 508aeb5205
commit f7b778cdce
12 changed files with 496 additions and 2 deletions
@@ -0,0 +1,46 @@
import {useState} from 'react';
import {closureBook,closureSources,newClosure,newClosureCredit,saveClosureBook,recordClosure,adoptPreviousCredit,closureReportRows,type ClosureInput,type ClosureCredit,type ClosureBook} from '@/lib/iva-closure';
export function AcquisitionClosure({draft,onChange}:{draft:Record<string,unknown>;onChange:(field:string,value:string)=>void}){
const[error,setError]=useState('');let b:ClosureBook;try{b=closureBook(draft);}catch(e){return<p role="alert">{String(e)}</p>;}
const save=(next:ClosureBook)=>{try{onChange('modelo_a_snapshot',saveClosureBook(draft,next));setError('');}catch(e){setError(String(e));}};
const change=(id:string,p:Partial<ClosureInput>)=>save({...b,rows:b.rows.map(r=>r.id===id?{...r,...p}:r)});
const sources=closureSources(draft);
const entities=[...new Set(b.rows.map(r=>r.entityRef.trim()).filter(Boolean))];
const creditChange=(r:ClosureInput,id:string,p:Partial<ClosureCredit>)=>change(r.id,{credits:r.credits.map(c=>c.id===id?{...c,...p}:c)});
const choice=(r:ClosureInput,key:'firstDeclaration'|'creditsComplete',label:string)=><label className="block">{label}<select value={r[key]} onChange={e=>change(r.id,{[key]:e.target.value})}><option value="">Por confirmar</option><option value="yes">Sim</option><option value="no">Não</option></select></label>;
return<details className="rounded border p-3"><summary>L3-A/B — crédito,fecho e pagamentos por período</summary>
<p>Reutiliza resultados congelados de L2. Crédito anterior,saldo calculado,pagamento registado e transporte são distintos. Identifique o âmbito fiscal da entidade,sem consolidar oportunidades implicitamente.</p>
<p>Primeira declaração em prazo,2026/MZN e reporte integral. SubstituiçõesC,reembolsoD e restituição de bebidasE continuam próprios. Prazo/data são declarados,não calculados pelo portal. Uma simulação não submete declarações nem efectua pagamentos.</p>
{error&&<p role="alert">{error}</p>}
<button type="button" onClick={()=>save({...b,rows:[...b.rows,newClosure(crypto.randomUUID(),sources.length===1?sources[0]:null,entities.length===1?entities[0]:String(draft.fiscal_entity_ref??draft.organization_name??''))]})}>Preparar fecho de outro período</button>
{b.rows.map(r=><fieldset className="rounded border p-3" key={r.id}><legend>Fecho — {r.period||'período por escolher'}</legend>
<label>Resultado L2 congelado<select value={sources.findIndex(s=>JSON.stringify(s)===JSON.stringify(r.source))} onChange={e=>{const s=sources[Number(e.target.value)];if(s)change(r.id,{source:structuredClone(s),period:s.period});}}><option value={-1}>Escolha versão e período</option>{sources.map((s,i)=><option key={i} value={i}>{s.period} — revisão{s.revision} — {s.calculatedAt}</option>)}</select></label>
<label>Âmbito fiscal da entidade<input value={r.entityRef} onChange={e=>change(r.id,{entityRef:e.target.value})}/></label>
<label>Natureza do fecho<select value={r.origin} onChange={e=>change(r.id,{origin:e.target.value as ClosureInput['origin']})}><option value="projected">Pressuposto de simulação</option><option value="effective">Dados efectivos declarados</option></select></label>
{choice(r,'firstDeclaration','É a primeira declaração deste período (ou pressuposto explícito)')}
<label>Data de entrega ou prevista<input type="date" value={r.submissionDate} onChange={e=>change(r.id,{submissionDate:e.target.value})}/></label>
<label>Situação do prazo<select value={r.filing} onChange={e=>change(r.id,{filing:e.target.value as ClosureInput['filing']})}><option value="">Por identificar</option><option value="timely">Dentro do prazo declarado</option><option value="late">Fora do prazo — procedimento próprio</option></select></label>
<label>Fundamento/referência do prazo declarado<input value={r.filingRef} onChange={e=>change(r.id,{filingRef:e.target.value})}/></label>
<h5>Créditos de origem identificada</h5>
{r.credits.map(c=><fieldset className="rounded border p-2" key={c.id}><legend>{c.kind==='opening'?'19 — saldo de abertura':c.kind==='previous'?'19 — transporte anterior':'20 — crédito comunicado'}</legend>
{c.kind==='previous'?<label>Adoptar expressamente o reporte anterior<select value={c.previousId} onChange={e=>{try{const p=b.result?.rows.find(p=>p.id===e.target.value);if(p)creditChange(r,c.id,adoptPreviousCredit(c,p));}catch(err){setError(String(err));}}}><option value="">Escolha o fecho anterior</option>{b.result?.rows.filter(p=>p.id!==r.id&&p.period<r.period).map(p=><option key={p.id} value={p.id}>{p.period} — {p.entityRef} — {p.status==='determined'?'calculado':'indeterminado'}</option>)}</select></label>:<>
<label>Período de origem do crédito/saldo<input type="month" value={c.period} onChange={e=>creditChange(r,c.id,{period:e.target.value})}/></label>
<label>Documento/referência do crédito<input value={c.reference} onChange={e=>creditChange(r,c.id,{reference:e.target.value})}/></label>
<label>Montante disponível documentado (MZN)<input value={c.amount} onChange={e=>creditChange(r,c.id,{amount:e.target.value})}/></label>
{c.kind==='communication'&&<label>Data da comunicação recebida<input type="date" value={c.date} onChange={e=>creditChange(r,c.id,{date:e.target.value})}/></label>}</>}
{c.kind==='previous'&&<><p>Origem:{c.reference};{c.period};apresentação{c.amount}. Cálculo pela fracção exacta;origem alterada exige adopção expressa.</p><button type="button" onClick={()=>{try{const p=b.result?.rows.find(p=>p.id===c.previousId);if(!p)throw Error('Fecho anterior não recuperável.');creditChange(r,c.id,adoptPreviousCredit(c,p));}catch(e){setError(String(e));}}}>Adoptar versão actual deste reporte</button></>}
<button type="button" onClick={()=>change(r.id,{credits:r.credits.filter(v=>v.id!==c.id)})}>Remover vínculo de crédito desta preparação</button></fieldset>)}
{(['opening','communication','previous'] as const).map(kind=><button type="button" key={kind} onClick={()=>change(r.id,{credits:[...r.credits,newClosureCredit(crypto.randomUUID(),kind)]})}>{kind==='opening'?'Identificar saldo inicial':kind==='communication'?'Identificar crédito comunicado':'Reutilizar reporte anterior'}</button>)}
{choice(r,'creditsComplete','Reconciliei todos os créditos;lista vazia confirma expressamente ausência')}
<label>Juros23<select value={r.interest} onChange={e=>change(r.id,{interest:e.target.value as ClosureInput['interest']})}><option value="">Indeterminados</option><option value="none">Sem juros aplicáveis — motivo identificado</option><option value="documented">Montante identificado,sem cálculo de taxa pelo portal</option></select></label>
{r.interest==='documented'&&<label>Montante de juros (MZN)<input value={r.interestAmount} onChange={e=>change(r.id,{interestAmount:e.target.value})}/></label>}
{r.interest&&<label>Fonte/motivo dos juros ou da sua inexistência<input value={r.interestRef} onChange={e=>change(r.id,{interestRef:e.target.value})}/></label>}
<label>Destino do crédito25<select value={r.destination} onChange={e=>change(r.id,{destination:e.target.value as ClosureInput['destination']})}><option value="">Por escolher</option><option value="report">Reportar integralmente26;sem pedido27 neste percurso</option><option value="refund">Preparar reembolso — percursoD pendente</option></select></label>
<h5>Pagamentos registados,distintos do saldo calculado</h5>
{r.payments.map(p=><fieldset className="rounded border p-2" key={p.id}>{(['reference','date','amount'] as const).map((k,i)=><label key={k}>{['Referência do pagamento','Data do pagamento','Montante do pagamento (MZN)'][i]}<input type={k==='date'?'date':'text'} value={p[k]} onChange={e=>change(r.id,{payments:r.payments.map(v=>v.id===p.id?{...v,[k]:e.target.value}:v)})}/></label>)}<button type="button" onClick={()=>change(r.id,{payments:r.payments.filter(v=>v.id!==p.id)})}>Remover pagamento desta preparação</button></fieldset>)}
<button type="button" onClick={()=>change(r.id,{payments:[...r.payments,{id:crypto.randomUUID(),reference:'',date:'',amount:''}]})}>Registar referência de pagamento</button>
<button type="button" onClick={()=>save({...b,rows:b.rows.filter(v=>v.id!==r.id)})}>Remover fecho em preparação (histórico conservado)</button></fieldset>)}
<button type="button" onClick={()=>{try{save(recordClosure(draft,b));}catch(e){setError(String(e));}}}>Calcular e guardar fecho A/B</button>
{closureReportRows(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 {AcquisitionClosure} from './acquisition-closure';
import {AcquisitionRegularizations} from './acquisition-regularizations';
import { AcquisitionOperationLink } from './acquisition-operation-link';
import { AcquisitionImportsExclusions } from './acquisition-imports-exclusions';
@@ -82,7 +83,8 @@ export function SimulationAcquisitions({draft,onChange}:{draft:Record<string,unk
{acquisitionExcludedFields.map(field=><label className="block" key={field}><input type="checkbox" checked={period.absent.includes(field)} onChange={e=>save({...book,periods:book.periods.map(p=>p.period===period.period?{...p,absent:e.target.checked?[...p.absent,field]:p.absent.filter(f=>f!==field)}:p)})}/> Sem operações no campo{field} — {labels[field]}</label>)}
</details>)}
<button type="button" disabled={!book.periods.length} className="rounded bg-emerald-800 p-2 text-white disabled:opacity-50" onClick={()=>run(()=>save(recordAcquisitions(draft,book)))}>Calcular e guardar versão do apuramento parcial</button>
<p>O preenchimento e o resultado seguem a gravação privada do simulador. Os campos19–27 e a submissão à AT permanecem fora deste lote; 17/18 são diferenças antes de créditos anteriores, sem ordem de pagamento ou promessa de reembolso.</p>
<p>O apuramento01–18 conserva o seu resultado antes dos créditos. O fechoA/B abaixo reutiliza a versão congelada,sem ordem de pagamento,submissãoAT ou promessa de reembolso.</p>
<AcquisitionClosure draft={draft} onChange={onChange}/>
{book.result&&<><p role="status">{acquisitionCurrent(draft,book)?'Resultado correspondente às entradas guardadas.':'Entradas ou origem alteradas: resultado histórico preservado; actualizar o cálculo.'}</p><dl>{acquisitionReportRows(draft).map(([,label,value,origin],i)=><div key={i}><dt className="font-semibold">{label}</dt><dd>{value}<small className="block">{origin}</small></dd></div>)}</dl></>}
</section>;
}
+105
View File
@@ -0,0 +1,105 @@
import type {AcquisitionCalculation} from './iva-acquisitions.ts';
import {addFractions,decimalFraction,fraction,subtractFractions,positiveFraction,fractionLabel,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
export const closureVersion='iva-closure-ab/1';
export const closureSource='L3-A/B: CIVA21(2/5),Lei13/2016 PDF15/p1426(273),23(1),PDF16/p1426(274);RCIVA12/15,Decreto7/2008 PDF3/p101;ModeloA/VAT Return9c0b99a8,p1–2,quadros8/10/11. Crédito anterior/comunicado19/20;22=max(17−19−20,0);25=max(18+19+20−17,0);24=22+23;reporte integral26=25 quando expressamente escolhido. Sem substituição21,reembolso27 ou restituição13(2). Cabeçalho remete18/19 mas caixas são19/20;divergência conservada,distinta deP00105/06.';
type Choice=''|'yes'|'no';
export type ClosureSource={revision:number;calculatedAt:string;fingerprint:string;opportunity:string;currency:string;period:string;location:string;projected:boolean;debit:FiscalFraction|null;credit:FiscalFraction|null};
export type ClosureCredit={id:string;kind:'opening'|'communication'|'previous';period:string;reference:string;date:string;amount:string;previousId:string;carryKey:string};
export type ClosurePayment={id:string;reference:string;date:string;amount:string};
export type ClosureInput={id:string;period:string;entityRef:string;origin:'projected'|'effective';source:ClosureSource|null;firstDeclaration:Choice;filing:''|'timely'|'late';submissionDate:string;filingRef:string;creditsComplete:Choice;credits:ClosureCredit[];interest:''|'none'|'documented';interestAmount:string;interestRef:string;destination:''|'report'|'refund';payments:ClosurePayment[]};
export type ClosureResult={id:string;period:string;entityRef:string;origin:ClosureInput['origin'];status:'determined'|'indeterminate';reason:string;inputKey:string;financialKey:string;carryKey:string;fields:Record<string,FiscalFraction|null>;paid:FiscalFraction|null;outstanding:FiscalFraction|null;overpayment:FiscalFraction|null;source:string};
export type ClosureBook={version:1;rows:ClosureInput[];result?:{calculatedAt:string;key:string;inputs:ClosureInput[];rows:ClosureResult[]};history?:Array<NonNullable<ClosureBook['result']>>};
const scope=(d:Record<string,unknown>)=>String(d.context_opportunity||'general');
const zero=()=>fraction(0n);
export function closureFingerprint(v:unknown):string{const raw=JSON.stringify(v);let h=14695981039346656037n;for(let i=0;i<raw.length;i++)h=BigInt.asUintN(64,(h^BigInt(raw.charCodeAt(i)))*1099511628211n);return`${raw.length}:${h.toString(16)}`;}
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)throw Error('Livros fiscais não recuperáveis;originais preservados.');return s;}
function maps(d:Record<string,unknown>):Record<string,ClosureBook>{const v=store(d).ivaClosures;if(v===undefined)return{};if(!v||typeof v!=='object'||Array.isArray(v))throw Error('Mapa de fechos não recuperável;originais preservados.');return v as Record<string,ClosureBook>;}
function validate(b:ClosureBook):void{
if(!b||b.version!==1||!Array.isArray(b.rows)||b.history!==undefined&&!Array.isArray(b.history)||b.result!==undefined&&(!Array.isArray(b.result.rows)||!Array.isArray(b.result.inputs)||typeof b.result.key!=='string'))throw Error('FechoL3 não recuperável;originais preservados.');
if(b.result?.rows.some(r=>!r||typeof r.id!=='string'||!r.fields||typeof r.fields!=='object'||!['determined','indeterminate'].includes(r.status)||Object.values(r.fields).some(v=>v!==null&&(!v||!/^\d{1,80}$/.test(v.numerator)||!/^\d{1,80}$/.test(v.denominator)||BigInt(v.denominator)===0n))))throw Error('ResultadoL3 não recuperável;originais preservados.');
for(const r of b.rows){if(!r||!['id','period','entityRef','submissionDate','filingRef','interestAmount','interestRef'].every(k=>typeof r[k as keyof ClosureInput]==='string')||!['projected','effective'].includes(r.origin)||!['','yes','no'].includes(r.firstDeclaration)||!['','yes','no'].includes(r.creditsComplete)||!['','timely','late'].includes(r.filing)||!['','none','documented'].includes(r.interest)||!['','report','refund'].includes(r.destination)||!Array.isArray(r.credits)||!Array.isArray(r.payments)||r.credits.some(c=>!c||!['opening','communication','previous'].includes(c.kind)||!['id','period','reference','date','amount','previousId','carryKey'].every(k=>typeof c[k as keyof ClosureCredit]==='string'))||r.payments.some(p=>!p||!['id','reference','date','amount'].every(k=>typeof p[k as keyof ClosurePayment]==='string'))||r.source!==null&&(!r.source||!Number.isInteger(r.source.revision)||!['calculatedAt','fingerprint','opportunity','currency','period','location'].every(k=>typeof r.source![k as keyof ClosureSource]==='string')))throw Error('EntradasL3 não recuperáveis;originais preservados,sem substituir por zero.');}
}
export function closureBook(d:Record<string,unknown>):ClosureBook{const b=maps(d)[scope(d)]??{version:1,rows:[]};validate(b);return b;}
export function saveClosureBook(d:Record<string,unknown>,b:ClosureBook):string{validate(b);const s=store(d);return JSON.stringify({...s,ivaClosures:{...maps(d),[scope(d)]:b}});}
export function closureSources(d:Record<string,unknown>):ClosureSource[]{const b=(store(d).books as Record<string,{result?:AcquisitionCalculation;history?:AcquisitionCalculation[]}>)[scope(d)];return b?[...(b.history??[]),...(b.result?[b.result]:[])].flatMap(calc=>calc.periods.map(p=>({revision:calc.revision,calculatedAt:calc.calculatedAt,fingerprint:closureFingerprint(calc),opportunity:calc.opportunity,currency:calc.currency,period:p.period,location:calc.location,projected:calc.inputs.length===0||calc.inputs.some(r=>r.origin==='projected'),debit:p.exactFields?.['17']??(p.fields['17']===null?null:decimalFraction(p.fields['17'])),credit:p.exactFields?.['18']??(p.fields['18']===null?null:decimalFraction(p.fields['18']))}))).filter((r,i,a)=>a.findIndex(s=>s.fingerprint===r.fingerprint&&s.period===r.period)===i):[];}
export function newClosure(id:string,source:ClosureSource|null,entityRef=''):ClosureInput{return{id,period:source?.period??'',entityRef,origin:'projected',source:source?structuredClone(source):null,firstDeclaration:'',filing:'',submissionDate:'',filingRef:'',creditsComplete:'',credits:[],interest:'',interestAmount:'',interestRef:'',destination:'',payments:[]};}
export function newClosureCredit(id:string,kind:ClosureCredit['kind']):ClosureCredit{return{id,kind,period:'',reference:'',date:'',amount:'',previousId:'',carryKey:''};}
const priorPeriod=(p:string)=>{const d=new Date(p+'-01T00:00:00Z');d.setUTCMonth(d.getUTCMonth()-1);return d.toISOString().slice(0,7);};
const validDate=(d:string)=>/^20\d{2}-(0[1-9]|1[0-2])-\d{2}$/.test(d)&&!Number.isNaN(Date.parse(d))&&new Date(d).toISOString().slice(0,10)===d;
const normalize=(s:string)=>s.trim().toLocaleLowerCase();
function creditIdentity(r:ClosureInput,c:ClosureCredit){return closureFingerprint([normalize(r.entityRef),r.origin,c.kind==='previous'?'carry':'document',c.kind==='previous'?c.previousId:normalize(c.reference),c.period]);}
function paymentIdentity(r:ClosureInput,p:ClosurePayment){return closureFingerprint([normalize(r.entityRef),r.origin,normalize(p.reference)]);}
function inputKey(r:ClosureInput){return closureFingerprint(r);}
function financialKey(r:ClosureInput){const{payments:_,...rest}=r;return closureFingerprint(rest);}
function otherUses(d:Record<string,unknown>,b:ClosureBook):ClosureInput[]{return[...b.rows,...Object.entries(maps(d)).filter(([id])=>id!==scope(d)).flatMap(([,book])=>{validate(book);return book.rows.filter(r=>r.origin==='effective');})];}
function duplicateCredits(d:Record<string,unknown>,b:ClosureBook):Set<string>{const uses=new Map<string,number>();for(const r of otherUses(d,b))for(const c of r.credits){const k=creditIdentity(r,c);uses.set(k,(uses.get(k)??0)+1);}return new Set([...uses].filter(([,n])=>n>1).map(([k])=>k));}
function bookKey(d:Record<string,unknown>,b:ClosureBook){const sources=closureSources(d);return closureFingerprint([b.rows,b.rows.map(r=>sources.some(s=>JSON.stringify(s)===JSON.stringify(r.source))),otherUses(d,b).map(r=>[normalize(r.entityRef),r.origin,r.period,r.credits.map(c=>creditIdentity(r,c)),r.payments.map(p=>paymentIdentity(r,p))])]);}
export function closureCurrent(d:Record<string,unknown>,b:ClosureBook):boolean{return !!b.result&&b.result.key===bookKey(d,b)&&b.result.rows.length===b.rows.length&&b.rows.every(r=>b.result!.rows.filter(x=>x.id===r.id&&x.inputKey===inputKey(r)).length===1);}
export function adoptPreviousCredit(c:ClosureCredit,previous:ClosureResult):ClosureCredit{if(previous.status!=='determined'||!previous.fields['26'])throw Error('Fecho anterior indeterminado;sem crédito presumido.');return{...c,kind:'previous',period:previous.period,reference:`Fecho ${previous.id}`,previousId:previous.id,carryKey:previous.carryKey,amount:fractionPresentation(previous.fields['26']).decimal,date:''};}
export function recordClosure(d:Record<string,unknown>,b:ClosureBook,now=new Date().toISOString()):ClosureBook{
validate(b);if(new Set(b.rows.map(r=>r.id)).size!==b.rows.length)throw Error('Identidade de fecho repetida.');
const contexts=b.rows.map(r=>JSON.stringify([normalize(r.entityRef),r.origin,r.period]));if(new Set(contexts).size!==contexts.length)throw Error('Mesmo âmbito/período repetido neste cenário;sem duplicar o fecho.');
const duplicate=duplicateCredits(d,b),puses=new Map<string,number>();for(const r of otherUses(d,b))for(const p of r.payments){const k=paymentIdentity(r,p);puses.set(k,(puses.get(k)??0)+1);}
const results:ClosureResult[]=[];
for(const row of [...b.rows].sort((a,z)=>a.period.localeCompare(z.period))){
const fields:Record<string,FiscalFraction|null>=Object.fromEntries(['17','18','19','20','21','22','23','24','25','26','27'].map(f=>[f,null]));
const r:ClosureResult={id:row.id,period:row.period,entityRef:row.entityRef,origin:row.origin,status:'indeterminate',reason:'',inputKey:inputKey(row),financialKey:financialKey(row),carryKey:'',fields,paid:null,outstanding:null,overpayment:null,source:closureSource};
const stop=(reason:string)=>{r.reason=reason;results.push(r);};
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!row.entityRef.trim()||d.currency!=='MZN'){stop('Identifique âmbito fiscal e período2026/MZN;sem consolidar oportunidades automaticamente.');continue;}
if(row.origin==='effective'&&otherUses(d,b).some(other=>other!==row&&other.origin==='effective'&&normalize(other.entityRef)===normalize(row.entityRef)&&other.period===row.period)){stop('Mesmo âmbito fiscal/período efectivo reservado noutra oportunidade recuperada;reconcilie a declaração única,sem duplicar ou consolidar dossiers silenciosamente.');continue;}
const source=closureSources(d).find(s=>JSON.stringify(s)===JSON.stringify(row.source));
if(!source||source.period!==row.period||source.opportunity!==scope(d)||source.currency!=='MZN'||!source.debit||!source.credit){stop('ResultadoL2 congelado correspondente ausente ou17/18 indeterminados;sem recalcular nem presumir impostozero.');continue;}
fields['17']=source.debit;fields['18']=source.credit;
if(BigInt(source.debit.numerator)<0n||BigInt(source.credit.numerator)<0n||BigInt(source.debit.numerator)>0n&&BigInt(source.credit.numerator)>0n){stop('Sinais17/18 incompatíveis;resolver origemL2.');continue;}
if(row.origin==='effective'&&source.projected){stop('OrigemL2 contém pressupostos projectados;não os apresentar como declaração efectiva.');continue;}
if(row.firstDeclaration!=='yes'){stop('Este percursoA/B exige primeira declaração;substituição21 permaneceL3-C.');continue;}
if(!validDate(row.submissionDate)||row.submissionDate.slice(0,7)<row.period||!row.filingRef.trim()||row.filing!=='timely'){stop(row.filing==='late'?'Declaração fora do prazo:RCIVA15 e exemplar não permitem uso19/20 neste percurso;conservar conta de crédito e tratar procedimento próprio,sem o apagar.':'Indique data e fundamento da entrega em prazo,efectivos ou pressupostos;sem calendário/prazo presumido.');continue;}
if(row.creditsComplete!=='yes'){stop('Reconcilie todos os créditos aplicáveis;lista vazia só significa ausência quando expressamente confirmada.');continue;}
const credits19:FiscalFraction[]=[],credits20:FiscalFraction[]=[];let invalid='';
for(const c of row.credits){
if(!c.reference.trim()||!/^20\d{2}-(0[1-9]|1[0-2])$/.test(c.period)||c.period>row.period||c.kind!=='communication'&&c.period===row.period||duplicate.has(creditIdentity(row,c))){invalid='Crédito sem origem/período aplicável ou já utilizado/reservado noutra linha/âmbito recuperado;sem utilização duplicada.';break;}
if(c.kind==='previous'){
const p=results.find(p=>p.id===c.previousId);if(!p||p.status!=='determined'||p.period!==priorPeriod(row.period)||p.entityRef.trim().toLowerCase()!==row.entityRef.trim().toLowerCase()||p.origin!==row.origin||p.period!==c.period||p.carryKey!==c.carryKey||!p.fields['26']){invalid='Fecho anterior alterado,indeterminado,fora do mês imediatamente anterior ou de outro âmbito;não adoptar novo crédito silenciosamente.';break;}credits19.push(p.fields['26']);
}else{
let v:FiscalFraction;try{v=decimalFraction(c.amount);}catch{invalid='Montante de crédito em falta/inválido;não substituir porzero.';break;}
if(c.kind==='opening'&&c.period!==priorPeriod(row.period)){invalid='Saldo de abertura exige referência ao saldo disponível do mês imediatamente anterior;origem mais antiga deve ser reconciliada nesse saldo.';break;}
if(c.kind==='opening'&&b.rows.some(p=>p.id!==row.id&&p.entityRef.trim().toLowerCase()===row.entityRef.trim().toLowerCase()&&p.origin===row.origin&&p.period===priorPeriod(row.period))){invalid='Há fecho do período anterior neste livro;reutilize26 expressamente em vez de introduzir outra abertura.';break;}
if(c.kind==='communication'&&(!validDate(c.date)||c.date>row.submissionDate)){invalid='Crédito20 exige comunicação recebida,referência e data não posterior à entrega declarada;pedido não é comunicação.';break;}
(c.kind==='opening'?credits19:credits20).push(v);
}
}
if(invalid){stop(invalid);continue;}
fields['19']=addFractions(credits19);fields['20']=addFractions(credits20);
const balance=subtractFractions(addFractions([source.credit,fields['19'],fields['20']]),source.debit);
fields['22']=positiveFraction(fraction(-BigInt(balance.numerator),BigInt(balance.denominator)));fields['25']=positiveFraction(balance);
if(row.interest==='none'&&row.interestRef.trim())fields['23']=zero();
else if(row.interest==='documented'&&row.interestRef.trim()){try{fields['23']=decimalFraction(row.interestAmount);}catch{/* Preserve unknown. */}}
fields['24']=fields['23']?addFractions([fields['22'],fields['23']]):null;
if(row.destination==='report'){fields['26']=fields['25'];fields['27']=zero();}
if(row.destination!=='report'){stop('Escolha reporte integral para o percursoA/B;pedido de reembolso/alocação27 segueL3-D e não é presumido.');continue;}
if(!fields['24']){stop('Juros23 por identificar:indique montante documentado/pressuposto ou inexistência expressa com motivo;sem taxa presumida.');continue;}
r.status='determined';r.carryKey=closureFingerprint([r.id,r.financialKey,fields['26'],scope(d)]);
const payments:FiscalFraction[]=[];
for(const p of row.payments){if(!p.reference.trim()||!validDate(p.date)||(puses.get(paymentIdentity(row,p))??0)>1){invalid='Pagamento sem referência/data ou repetido noutro período/declaração;conserve o documento e reconcilie a imputação.';break;}try{payments.push(decimalFraction(p.amount));}catch{invalid='Montante de pagamento por identificar;sem baixa presumida.';break;}}
if(invalid){stop(invalid);continue;}
r.paid=addFractions(payments);r.outstanding=positiveFraction(subtractFractions(fields['24'],r.paid));r.overpayment=positiveFraction(subtractFractions(r.paid,fields['24']));
r.status='determined';r.carryKey=closureFingerprint([r.id,r.financialKey,fields['26'],scope(d)]);r.reason='Saldo calculado, pagamentos registados e crédito transportado distintos. Pagamento não altera22/25/26;excedente pago não cria crédito20 sem comunicação.21 não aplicável à primeira declaração;27zero pela opção expressa de reporte integral. '+(row.origin==='projected'?'Pressupostos de simulação,sem declaração ou pagamento efectuados pelo portal.':'Dados efectivos declarados;registo não certifica cobrança nem submissãoAT.');results.push(r);
}
const result={calculatedAt:now,key:bookKey(d,b),inputs:structuredClone(b.rows),rows:results};return{...b,...(b.result?{history:[...(b.history??[]),structuredClone(b.result)]}:{}),result};
}
export function closureReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{
try{
const b=closureBook(d);if(!b.rows.length)return[];
const out:Array<[string,string,string,string]>=[['IVA mensal','L3-A/B — fecho por período',closureCurrent(d,b)?'Resultado correspondente às entradas':'Histórico preservado;rever entradas/origens antes de utilizar',closureSource]];
for(const r of b.result?.rows??[]){
const input=b.result?.inputs.find(x=>x.id===r.id),source=input?.source;
const context=`${r.entityRef};${scope(d)};MZN;${r.origin==='projected'?'Pressuposto de simulação':'Dados efectivos declarados'};versão guardada${b.result!.calculatedAt}`;
out.push(['IVA mensal',`Fecho A/B — ${r.period}`,Object.entries(r.fields).map(([f,v])=>`${f}:${v?fractionPresentation(v).decimal:f==='21'&&input?.firstDeclaration==='yes'?'Não aplicável (primeira declaração)':'Indeterminado'}`).join('; '),`${context};${r.reason}`]);
const credits=(input?.credits??[]).map(c=>`${c.kind==='communication'?'Comunicação20':c.kind==='previous'?'Transporte19':'Abertura19'}: ${c.reference};origem${c.period};montante apresentado${c.amount}MZN${c.date?';recebida'+c.date:''}`).join(' | ')||'Sem créditos registados';
const payments=(input?.payments??[]).map(p=>`${p.reference};${p.date};${p.amount}MZN`).join(' | ')||'Sem pagamentos registados';
out.push(['IVA mensal',`Pagamentos e reporte — ${r.period}`,`Calculado24:${r.fields['24']?fractionLabel(r.fields['24']):'Indeterminado'};pagamentos registados:${r.paid?fractionLabel(r.paid):'Indeterminado'};por liquidar:${r.outstanding?fractionLabel(r.outstanding):'Indeterminado'};excedente pago:${r.overpayment?fractionLabel(r.overpayment):'Indeterminado'};transportado26:${r.fields['26']?fractionLabel(r.fields['26']):'Indeterminado'}`,`${context};OrigemL2:revisão${source?.revision??'por identificar'},${source?.period??''},${source?.location??''},${source?.calculatedAt??''};${credits};${payments};entrega${input?.submissionDate??''},${input?.filingRef??''};juros:${input?.interestRef??''}`]);
}
return out;
}catch{return[['IVA mensal','L3-A/B','Fecho guardado não recuperável','Originais preservados;sem crédito ou pagamento presumidos.']];}
}
+2
View File
@@ -15,6 +15,7 @@ import { investmentLandPreparation } from './investment-land-preparation.ts';
import { monthlyIvaInput, monthlyIvaKey, readMonthlyIvaRecord, readMonthlyIvaSettings } from './monthly-iva.ts';
import { modeloAPurchaseReferences } from './iva-modelo-a.ts';
import { acquisitionReportRows } from './iva-acquisitions.ts';
import {closureReportRows} from './iva-closure.ts';
import { importExemptionReportRows } from './iva-import-exemptions.ts';
import { publicBaseReportRows } from './iva-public-authority-base.ts';
import { commissionBaseReportRows } from './iva-commission-base.ts';
@@ -646,6 +647,7 @@ export function buildProjectDossierRows(
]);
}
rows.push(...acquisitionReportRows(draft));
rows.push(...closureReportRows(draft));
rows.push(...importExemptionReportRows(draft));
rows.push(...publicBaseReportRows(draft));
rows.push(...commissionBaseReportRows(draft));