Prepare exact beverage partitions, fiscal gap diagnostics and L3 form review in QA
This commit is contained in:
@@ -51,7 +51,7 @@ export function evaluateAcquisitionBC(row:Acquisition,currency:string,registered
|
||||
if(row.allocation==='no_right'||row.integrity==='no'||row.exclusion==='excluded')return stop('Sem direito pela afectação,exclusão expressa ou impedimento18(3–5) declarado.','no_right',0);
|
||||
if(row.allocation==='mixed'&&!partial)return stop('Afectação parcial/pro rata depende deD;sem dedução integral presumida.');
|
||||
if(!partial&&(!row.deductionLink||row.deductionLink.scopeConfirmed!=='yes'||!row.deductionLink.allocationRef.trim()||row.allocation!=='taxable_only'))return stop('Confirme afectação exclusiva e referência à operação ligada.');
|
||||
if(!partial&&bc.expense==='beverages'&&bc.facts.beverageSpecial==='yes'&&['deduction','refund'].includes(bc.beveragePath)&&draft&&row.deductionLink)right=linkedBeverageDeductionRight(draft,row.deductionLink,bc.facts.notCoastalFishing==='yes');
|
||||
if(bc.expense==='beverages'&&bc.facts.beverageSpecial==='yes'&&['deduction','refund'].includes(bc.beveragePath)&&draft&&row.deductionLink)right=linkedBeverageDeductionRight(draft,row.deductionLink,bc.facts.notCoastalFishing==='yes');
|
||||
if(right.status==='no_right')return stop(right.reason,'no_right',0);
|
||||
if(right.status!=='eligible')return stop(right.reason);
|
||||
const noExcludedPayments=partial?.noExcludedPayments??row.deductionLink?.noExcludedPayments;
|
||||
|
||||
@@ -0,0 +1,42 @@
|
||||
import type {AcquisitionBook} from './iva-acquisitions.ts';
|
||||
import {beverageParcel} from './iva-beverage-parcels.ts';
|
||||
import {addFractions,decimalFraction,fraction,fractionLabel,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
|
||||
|
||||
/** Technical representation of disjoint VAT portions, not an additional fiscal condition. */
|
||||
export type BeverageAllocation={from:string;to:string;reference:string;deductionFrom:string;deductionTo:string;deductionReference:string};
|
||||
type Source={parcel:string;origin:string;vat:FiscalFraction};
|
||||
export type BeverageRange={from:FiscalFraction;to:FiscalFraction;amount:FiscalFraction};
|
||||
function boundary(raw:string):FiscalFraction{const parts=/^(\d{1,40})\/(\d{1,40})$/.exec(raw);if(!parts)return decimalFraction(raw);if(BigInt(parts[2])===0n)throw Error('Denominador nulo nos limites da parcela.');return fraction(BigInt(parts[1]),BigInt(parts[2]));}
|
||||
export function beverageRange(source:Source,allocation?:BeverageAllocation):BeverageRange {
|
||||
const from=allocation?boundary(allocation.from):fraction(0n),to=allocation?boundary(allocation.to):source.vat,amount=subtractFractions(to,from);
|
||||
if(BigInt(amount.numerator)<=0n||BigInt(subtractFractions(source.vat,to).numerator)<0n)throw Error('Limites da parcela fora do IVA documental; indique início inferior ao fim e fim até ao total da linha.');
|
||||
if(allocation&&!allocation.reference.trim())throw Error('Identifique o suporte da repartição da linha.');
|
||||
return {from,to,amount};
|
||||
}
|
||||
export function beverageRangesOverlap(a:BeverageRange,b:BeverageRange):boolean{return BigInt(subtractFractions(a.to,b.from).numerator)>0n&&BigInt(subtractFractions(b.to,a.from).numerator)>0n;}
|
||||
export function beverageDeductionEvidence(d:Record<string,unknown>,source:Source):{amount:FiscalFraction|null;reason:string;records:Array<{context:string;revision:number;calculatedAt:string;amount:FiscalFraction;documents:string[]}>} {
|
||||
const store=JSON.parse(String(d.modelo_a_snapshot||'{}')),books=(store.books??{}) as Record<string,AcquisitionBook>,records:Array<{context:string;revision:number;calculatedAt:string;amount:FiscalFraction;documents:string[]}>=[];
|
||||
for(const[context,book]of Object.entries(books))for(const calc of [...(book.history??[]),...(book.result?[book.result]:[])]){
|
||||
const inputs=calc.inputs.filter(row=>row.origin==='effective'&&source.origin==='effective'&&beverageParcel(row)===source.parcel);
|
||||
const amounts:FiscalFraction[]=[];
|
||||
for(const input of inputs){const result=calc.rows.find(r=>r.id===input.id);if(!result||result.deductible===null){if(input.bc?.beveragePath==='deduction')return{amount:null,reason:'Dedução efectiva anterior indeterminada; identificar montante exacto e documento antes da repartição.',records};continue;}
|
||||
const amount=result.deductibleExact??decimalFraction(result.deductible);if(BigInt(amount.numerator)>0n)amounts.push(amount);
|
||||
}
|
||||
if(amounts.length)records.push({context,revision:calc.revision,calculatedAt:calc.calculatedAt,amount:addFractions(amounts),documents:inputs.map(row=>`${row.documentRef};linha${row.documentLine};${row.period}`)});
|
||||
}
|
||||
const unique=[...new Map(records.map(r=>[fractionLabel(r.amount),r.amount])).values()];
|
||||
if(unique.length>1)return{amount:null,reason:'Montantes de dedução efectiva divergentes nas versões recuperadas; reconciliar a sequência e o fundamento das regularizações. Uma correcção preparada não liberta IVA para E.',records};
|
||||
return{amount:unique[0]??fraction(0n),reason:records.length?'Dedução efectiva declarada preservada; a sua afectação à parcela exige suporte expresso.':'Sem dedução efectiva positiva identificada nos livros recuperados; não é consulta à conta corrente AT.',records};
|
||||
}
|
||||
export function reconcileBeverageAllocation(d:Record<string,unknown>,source:Source,allocation?:BeverageAllocation):{range:BeverageRange|null;prior:FiscalFraction|null;reason:string} {
|
||||
const evidence=beverageDeductionEvidence(d,source);if(!evidence.amount)return{range:null,prior:null,reason:evidence.reason};
|
||||
try{
|
||||
const range=beverageRange(source,allocation);
|
||||
if(BigInt(evidence.amount.numerator)>0n){
|
||||
if(!allocation||!allocation.deductionReference.trim())return{range:null,prior:evidence.amount,reason:'Dedução efectiva anterior identificada; indique limites e suporte da parcela já deduzida, sem a apagar ou repetir em restituição.'};
|
||||
const deduction=beverageRange(source,{...allocation,from:allocation.deductionFrom,to:allocation.deductionTo});
|
||||
if(BigInt(subtractFractions(deduction.amount,evidence.amount).numerator)!==0n||beverageRangesOverlap(range,deduction))return{range:null,prior:evidence.amount,reason:'Parcela da dedução não coincide com o montante efectivo anterior ou sobrepõe-se à restituição; benefício duplicado impedido. Se toda a linha foi deduzida, é necessária regularização com fundamento próprio, ainda não automatizada nesta via.'};
|
||||
}else if(allocation&&(allocation.deductionFrom||allocation.deductionTo||allocation.deductionReference))return{range:null,prior:evidence.amount,reason:'Foi indicada dedução anterior sem correspondência nos livros efectivos recuperados; resolver a divergência antes de calcular.'};
|
||||
return{range,prior:evidence.amount,reason:evidence.reason};
|
||||
}catch(error){return{range:null,prior:evidence.amount,reason:String(error instanceof Error?error.message:error)};}
|
||||
}
|
||||
@@ -3,37 +3,41 @@ import {beverageParcel} from './iva-beverage-parcels.ts';
|
||||
import {closureFingerprint} from './iva-closure.ts';
|
||||
import {assessFiscalClaim,newFiscalClaimEvents,fiscalClaimDate,type FiscalClaimEvents,type FiscalClaimState} from './fiscal-claim-events.ts';
|
||||
import {decimalFraction,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
|
||||
export const beverageRestitutionSource='L3-E:CIVA13(1)(c/d/h),13(2–3),Lei13/2016 PDF12/p1426(270). Bebidas:dedução ou restituição,sem aplicar20(1)(d);não isenção directa. Provisões de pesca costeira excluídas. Linha documental integral afectada exclusivamente à restituição;sem dedução da mesma parcela. Procedimento/formulário específico não automatizado;sem importar limites/prazos do reembolso geral21.';
|
||||
import {beverageRange,beverageRangesOverlap,beverageDeductionEvidence,reconcileBeverageAllocation,type BeverageAllocation} from './iva-beverage-allocation.ts';
|
||||
export const beverageRestitutionSource='L3-E:CIVA13(1)(c/d/h),13(2–3),Lei13/2016 PDF12/p1426(270). Bebidas:dedução ou restituição,sem aplicar20(1)(d);não isenção directa. Provisões de pesca costeira excluídas. Linha integral ou parcelas documentadas sem sobreposição;dedução efectiva anterior reconciliada por montante e suporte,sem apagar históricos. Procedimento/formulário específico não automatizado;sem importar limites/prazos do reembolso geral21.';
|
||||
export type BeverageRestitutionSource={parcel:string;acquisitionId:string;scope:string;period:string;origin:'projected'|'effective';documentRef:string;documentDate:string;documentLine:string;supplier:string;vat:FiscalFraction;fingerprint:string;operationId:string;operationRef:string;calculatedAt:string};
|
||||
export type BeverageRestitutionInput=FiscalClaimEvents&{id:string;source:BeverageRestitutionSource|null;entityRef:string;exclusive:''|'yes'|'no'};
|
||||
export type BeverageRestitutionInput=FiscalClaimEvents&{id:string;source:BeverageRestitutionSource|null;entityRef:string;exclusive:''|'yes'|'no';allocation?:BeverageAllocation};
|
||||
export type BeverageRestitutionResult=FiscalClaimState&{id:string;inputKey:string;requested:FiscalFraction|null;source:string};
|
||||
type Calc={calculatedAt:string;key:string;inputs:BeverageRestitutionInput[];rows:BeverageRestitutionResult[]};
|
||||
export type BeverageRestitutionBook={version:1;rows:BeverageRestitutionInput[];result?:Calc;history?:Calc[]};
|
||||
const scope=(d:Record<string,unknown>)=>String(d.context_opportunity||'general'),norm=(s:string)=>s.trim().toLocaleLowerCase();
|
||||
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 não recuperáveis;originais preservados.');return s;}
|
||||
function maps(d:Record<string,unknown>):Record<string,BeverageRestitutionBook>{const m=store(d).ivaBeverageRestitutions;if(m===undefined)return{};if(!m||typeof m!=='object'||Array.isArray(m))throw Error('Mapa de restituições não recuperável;originais preservados.');return m as Record<string,BeverageRestitutionBook>;}
|
||||
function validate(b:BeverageRestitutionBook):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)))throw Error('LivroE não recuperável;originais preservados.');for(const r of b.rows)if(!r||!['id','entityRef','requestReference','requestDate','decisionReference','decisionDate','decisionIssuer','approvedAmount'].every(k=>typeof r[k as keyof BeverageRestitutionInput]==='string')||!['','yes','no'].includes(r.exclusive)||!['preparation','submitted'].includes(r.stage)||!['pending','approved','partial','rejected'].includes(r.decision)||!Array.isArray(r.receipts)||r.receipts.some(p=>!p||!['id','reference','date','amount'].every(k=>typeof p[k as keyof typeof p]==='string')))throw Error('EntradasE não recuperáveis;sem apagar documentos.');}
|
||||
function validate(b:BeverageRestitutionBook):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)))throw Error('LivroE não recuperável;originais preservados.');for(const r of b.rows)if(!r||!['id','entityRef','requestReference','requestDate','decisionReference','decisionDate','decisionIssuer','approvedAmount'].every(k=>typeof r[k as keyof BeverageRestitutionInput]==='string')||r.allocation!==undefined&&(!r.allocation||!['from','to','reference','deductionFrom','deductionTo','deductionReference'].every(k=>typeof r.allocation![k as keyof BeverageAllocation]==='string'))||!['','yes','no'].includes(r.exclusive)||!['preparation','submitted'].includes(r.stage)||!['pending','approved','partial','rejected'].includes(r.decision)||!Array.isArray(r.receipts)||r.receipts.some(p=>!p||!['id','reference','date','amount'].every(k=>typeof p[k as keyof typeof p]==='string')))throw Error('EntradasE não recuperáveis;sem apagar documentos.');}
|
||||
export function beverageRestitutionBook(d:Record<string,unknown>):BeverageRestitutionBook{const b=maps(d)[scope(d)]??{version:1,rows:[]};validate(b);return b;}
|
||||
export function saveBeverageRestitutionBook(d:Record<string,unknown>,b:BeverageRestitutionBook):string{validate(b);const s=store(d);return JSON.stringify({...s,ivaBeverageRestitutions:{...maps(d),[scope(d)]:b}});}
|
||||
export function beverageRestitutionSources(d:Record<string,unknown>):BeverageRestitutionSource[]{const b=acquisitionBook(d);if(!acquisitionCurrent(d,b))return[];return b.rows.flatMap(row=>{const result=b.result!.rows.find(r=>r.id===row.id);if(row.bc?.expense!=='beverages'||row.bc.beveragePath!=='refund'||!result?.reason.startsWith('Via restituição13(2)')||result.deductible!=='0.00'||!result.vat||!row.deductionLink)return[];const vat=decimalFraction(result.vat);if(BigInt(vat.numerator)<=0n)return[];return[{parcel:beverageParcel(row),acquisitionId:row.id,scope:scope(d),period:row.period,origin:row.origin,documentRef:row.documentRef,documentDate:row.documentDate,documentLine:row.documentLine,supplier:row.supplier,vat,fingerprint:closureFingerprint([row,result]),operationId:row.deductionLink.operationId,operationRef:row.deductionLink.allocationRef,calculatedAt:b.result!.calculatedAt}];});}
|
||||
function deducted(d:Record<string,unknown>,s:BeverageRestitutionSource):boolean{const books=store(d).books as Record<string,ReturnType<typeof acquisitionBook>>;return Object.entries(books).some(([context,b])=>[...(b.history??[]),...(b.result?[b.result]:[])].some(calc=>calc.inputs.some(row=>beverageParcel(row)===s.parcel&&(row.origin==='effective'&&s.origin==='effective'||context===scope(d)&&calc===b.result)&&calc.rows.some(r=>r.id===row.id&&r.deductible!==null&&(r.deductibleExact?BigInt(r.deductibleExact.numerator)>0n:BigInt(decimalFraction(r.deductible).numerator)>0n)))));}
|
||||
export function newBeverageRestitution(id:string,source:BeverageRestitutionSource|null,entityRef=''):BeverageRestitutionInput{return{...newFiscalClaimEvents(),id,source:source?structuredClone(source):null,entityRef,exclusive:''};}
|
||||
function sameSource(d:Record<string,unknown>,r:BeverageRestitutionInput):boolean{return!!r.source&&beverageRestitutionSources(d).some(s=>s.scope===r.source!.scope&&s.parcel===r.source!.parcel&&s.fingerprint===r.source!.fingerprint)&&!deducted(d,r.source);}
|
||||
function sameSource(d:Record<string,unknown>,r:BeverageRestitutionInput):boolean{return!!r.source&&beverageRestitutionSources(d).some(s=>s.scope===r.source!.scope&&s.parcel===r.source!.parcel&&s.fingerprint===r.source!.fingerprint);}
|
||||
function allUses(d:Record<string,unknown>,b:BeverageRestitutionBook):BeverageRestitutionInput[]{return[...b.rows,...Object.entries(maps(d)).filter(([id])=>id!==scope(d)).flatMap(([,v])=>{validate(v);return v.rows.filter(r=>r.source?.origin==='effective');})];}
|
||||
function past(d:Record<string,unknown>,b:BeverageRestitutionBook):BeverageRestitutionInput[]{return Object.entries({...maps(d),[scope(d)]:b}).flatMap(([context,v])=>[...(v.history??[]),...(v.result?[v.result]:[])].flatMap(c=>c.inputs.filter(r=>context===scope(d)||r.source?.origin==='effective')));}
|
||||
function past(d:Record<string,unknown>,b:BeverageRestitutionBook):BeverageRestitutionInput[]{return Object.entries({...maps(d),[scope(d)]:b}).flatMap(([context,v])=>[...(v.history??[]),...(v.result?[v.result]:[])].flatMap(c=>c.inputs.filter(r=>(context===scope(d)||r.source?.origin==='effective')&&c.rows.some(v=>v.id===r.id&&v.status==='determined'&&v.requested&&BigInt(v.requested.numerator)>0n))));}
|
||||
function committedParcel(r:BeverageRestitutionInput):string{if(!r.source)return '';try{const range=beverageRange(r.source,r.allocation);return closureFingerprint([r.source.parcel,r.source.origin,r.source.vat,range.from,range.to]);}catch{return 'invalid';}}
|
||||
const receiptKey=(r:BeverageRestitutionInput,p:FiscalClaimEvents['receipts'][number])=>JSON.stringify([norm(r.entityRef),r.source?.origin,norm(p.reference)]);
|
||||
function key(d:Record<string,unknown>,b:BeverageRestitutionBook):string{return closureFingerprint([b.rows,b.rows.map(r=>sameSource(d,r)),allUses(d,b).map(r=>[r.id,r.source?.parcel,r.receipts.map(p=>receiptKey(r,p))]),past(d,b).filter(r=>r.stage==='submitted'||r.decision!=='pending'||r.receipts.length).map(r=>[r.id,r.source?.parcel,r.receipts.map(p=>receiptKey(r,p))])]);}
|
||||
function key(d:Record<string,unknown>,b:BeverageRestitutionBook):string{return closureFingerprint([b.rows,b.rows.map(r=>[sameSource(d,r),r.source?beverageDeductionEvidence(d,r.source):null]),allUses(d,b).map(r=>[r.id,r.source,r.allocation,r.receipts.map(p=>receiptKey(r,p))]),past(d,b).filter(r=>r.stage==='submitted'||r.decision!=='pending'||r.receipts.length).map(r=>[r.id,r.source,r.allocation,r.receipts.map(p=>receiptKey(r,p))])]);}
|
||||
export function beverageRestitutionCurrent(d:Record<string,unknown>,b:BeverageRestitutionBook):boolean{return!!b.result&&b.result.key===key(d,b)&&b.rows.length===b.result.rows.length&&b.rows.every(r=>b.result!.rows.some(v=>v.id===r.id&&v.inputKey===closureFingerprint(r)));}
|
||||
export function recordBeverageRestitution(d:Record<string,unknown>,b:BeverageRestitutionBook,now=new Date().toISOString()):BeverageRestitutionBook{
|
||||
validate(b);if(new Set(b.rows.map(r=>r.id)).size!==b.rows.length)throw Error('IdentidadeE repetida.');const uses=allUses(d,b),history=past(d,b);
|
||||
const rows=b.rows.map(row=>{const r:BeverageRestitutionResult={id:row.id,inputKey:closureFingerprint(row),status:'indeterminate',reason:'',requested:null,approved:null,received:null,awaitingReceipt:null,notGranted:null,source:beverageRestitutionSource},stop=(reason:string)=>({...r,reason}),s=row.source;
|
||||
if(!s||!sameSource(d,row)||d.currency!=='MZN'||s.scope!==scope(d))return stop('OrigemL1/L2 alterada,ausente ou parcela já deduzida em registo efectivo;sem restituição presumida.');
|
||||
if(!row.entityRef.trim()||row.exclusive!=='yes')return stop('Identifique entidade e confirme a linha integral exclusivamente para restituição;sem dupla utilização.');
|
||||
if(uses.filter(v=>v.source?.origin===s.origin&&v.source?.parcel===s.parcel).length>1||history.some(v=>v.id!==row.id&&v.source?.origin===s.origin&&v.source?.parcel===s.parcel&&(v.stage==='submitted'||v.decision!=='pending'||v.receipts.length)))return stop('Linha documental já ligada a outro pedido de restituição no âmbito recuperado;sem duplicar a parcela.');
|
||||
r.requested=s.vat;if(!fiscalClaimDate(row.requestDate)||row.requestDate<s.documentDate)return stop('Data do pedido/preparação anterior ao documento ou por identificar.');
|
||||
const events=assessFiscalClaim(row,s.vat,p=>uses.flatMap(v=>v.receipts.filter(q=>receiptKey(v,q)===receiptKey(row,p))).length>1||history.some(v=>v.id!==row.id&&v.receipts.some(q=>receiptKey(v,q)===receiptKey(row,p))));Object.assign(r,events);
|
||||
if(!s||!sameSource(d,row)||d.currency!=='MZN'||s.scope!==scope(d))return stop('OrigemL1/L2 alterada ou ausente;sem restituição presumida.');
|
||||
if(!row.entityRef.trim()||row.exclusive!=='yes')return stop('Identifique entidade e confirme a parcela exclusivamente para restituição;sem dupla utilização.');
|
||||
const reconciled=reconcileBeverageAllocation(d,s,row.allocation);if(!reconciled.range)return stop(reconciled.reason);
|
||||
const related=(v:BeverageRestitutionInput)=>v.source?.origin===s.origin&&v.source?.parcel===s.parcel;
|
||||
const overlaps=(v:BeverageRestitutionInput)=>{try{return beverageRangesOverlap(reconciled.range!,beverageRange(v.source!,v.allocation));}catch{return true;}};
|
||||
if(uses.some(v=>v!==row&&related(v)&&overlaps(v))||history.some(v=>related(v)&&(v.stage==='submitted'||v.decision!=='pending'||v.receipts.length)&&(v.id!==row.id?overlaps(v):committedParcel(v)!==committedParcel(row))))return stop('Parcela documental já ligada a pedido ou histórico comprometido;limites sobrepostos ou alterados. Sem duplicar nem libertar IVA por apagar a preparação.');
|
||||
r.requested=reconciled.range.amount;if(!fiscalClaimDate(row.requestDate)||row.requestDate<s.documentDate)return stop('Data do pedido/preparação anterior ao documento ou por identificar.');
|
||||
const events=assessFiscalClaim(row,reconciled.range.amount,p=>uses.flatMap(v=>v.receipts.filter(q=>receiptKey(v,q)===receiptKey(row,p))).length>1||history.some(v=>v.id!==row.id&&v.receipts.some(q=>receiptKey(v,q)===receiptKey(row,p))));Object.assign(r,events);
|
||||
if(r.status==='determined')r.reason+=' Linha13(2) fora da deduçãoL2 e do crédito geralD;pedido não é isenção directa nem concessão automática. Decisão e recebimento registados fora doInvesteMoz;procedimento/formulário específico e prazos não automatizados,sem os importar deD.';return r;
|
||||
});
|
||||
const result={calculatedAt:now,key:'',inputs:structuredClone(b.rows),rows};const next={...b,...(b.result?{history:[...(b.history??[]),structuredClone(b.result)]}:{}),result};result.key=key(d,next);return next;
|
||||
}
|
||||
export function beverageRestitutionReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=beverageRestitutionBook(d);if(!b.rows.length)return[];const out:Array<[string,string,string,string]>=[['IVA mensal','L3-E — restituição de bebidas',beverageRestitutionCurrent(d,b)?'Resultado correspondente às entradas':'Histórico preservado;rever origem/parcela',beverageRestitutionSource]],fmt=(v:FiscalFraction|null)=>v?fractionPresentation(v).decimal:'Indeterminado';for(const r of b.result?.rows??[]){const i=b.result!.inputs.find(v=>v.id===r.id),s=i?.source;out.push(['IVA mensal',`Restituição de bebidas — ${s?.period??''}`,`ParcelaIVA:${fmt(r.requested)};dedução desta parcela:${r.requested?'0pela via exclusivaE':'Indeterminada;ver origem'};reconhecido:${fmt(r.approved)};recebido:${fmt(r.received)};aguarda recebimento:${fmt(r.awaitingReceipt)}`,`${i?.entityRef??''};${scope(d)};${s?.origin==='effective'?'Dados efectivos declarados':'Pressuposto de simulação'};${s?.documentRef??''};${s?.documentDate??''};linha${s?.documentLine??''};operaçãoL1${s?.operationId??''};${s?.operationRef??''};pedido${i?.requestReference??''},${i?.requestDate??''};decisão${i?.decisionReference??''},${i?.decisionDate??''},${i?.decisionIssuer??''};recibos:${i?.receipts.map(p=>`${p.reference};${p.date};${p.amount}MZN`).join(' | ')||'nenhum registado'};${r.reason}`]);}return out;}catch{return[['IVA mensal','L3-E','Restituição não recuperável','Originais preservados;sem dedução/restituição presumidas.']];}}
|
||||
export function beverageRestitutionReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=beverageRestitutionBook(d);if(!b.rows.length)return[];const out:Array<[string,string,string,string]>=[['IVA mensal','L3-E — restituição de bebidas',beverageRestitutionCurrent(d,b)?'Resultado correspondente às entradas':'Histórico preservado;rever origem/parcela',beverageRestitutionSource]],fmt=(v:FiscalFraction|null)=>v?fractionPresentation(v).decimal:'Indeterminado';for(const r of b.result?.rows??[]){const i=b.result!.inputs.find(v=>v.id===r.id),s=i?.source;out.push(['IVA mensal',`Restituição de bebidas — ${s?.period??''}`,`IVA documental:${fmt(s?.vat??null)};parcelaIVA:${fmt(r.requested)};dedução desta parcela:${r.requested?'0pela via exclusivaE':'Indeterminada;ver origem'};reconhecido:${fmt(r.approved)};recebido:${fmt(r.received)};aguarda recebimento:${fmt(r.awaitingReceipt)}`,`${i?.entityRef??''};${scope(d)};${s?.origin==='effective'?'Dados efectivos declarados':'Pressuposto de simulação'};${s?.documentRef??''};${s?.documentDate??''};linha${s?.documentLine??''};operaçãoL1${s?.operationId??''};${s?.operationRef??''};pedido${i?.requestReference??''},${i?.requestDate??''};decisão${i?.decisionReference??''},${i?.decisionDate??''},${i?.decisionIssuer??''};recibos:${i?.receipts.map(p=>`${p.reference};${p.date};${p.amount}MZN`).join(' | ')||'nenhum registado'};${i?.allocation?`repartiçãoIVA[${i.allocation.from},${i.allocation.to}[;suporte${i.allocation.reference};dedução anterior[${i.allocation.deductionFrom},${i.allocation.deductionTo}[;${i.allocation.deductionReference};`:''}${r.reason}`]);}return out;}catch{return[['IVA mensal','L3-E','Restituição não recuperável','Originais preservados;sem dedução/restituição presumidas.']];}}
|
||||
|
||||
@@ -0,0 +1,48 @@
|
||||
import {salesBook,salesCurrent} from './iva-operations.ts';
|
||||
import {acquisitionBook,acquisitionCurrent} from './iva-acquisitions.ts';
|
||||
import {travelBook,travelCurrent} from './iva-travel.ts';
|
||||
import {travelEventBook,travelEventCurrent} from './iva-travel-events.ts';
|
||||
import {secondhandBook,secondhandCurrent} from './iva-secondhand.ts';
|
||||
import {currencyEventBook,currencyEventCurrent} from './iva-currency-events.ts';
|
||||
export type FiscalCalculationGap={id:string;book:string;period:string;calculation:string;reason:string;required:string[];resolution:string;kind:'inputs_or_rule'|'implementation'|'stale'|'not_calculated';source:string};
|
||||
type Row=Record<string,unknown>;
|
||||
const fieldLabels:Record<string,string>={net:'Base líquida',vat:'IVA',gross:'Total com IVA',deductible:'IVA dedutível',baseAmount:'Base tributável',deduction:'Dedução',requested:'Pedido',approved:'Reconhecido',received:'Recebido',awaitingReceipt:'Por receber',delta:'Regularização',grossMargin:'Margem bruta',scenarioAmount:'Montante do cenário',outstanding:'Por liquidar'};
|
||||
const financial=new Set(['net','vat','gross','deductible','baseAmount','deduction','requested','approved','received','awaitingReceipt','delta','grossMargin','scenarioAmount','outstanding']);
|
||||
const details:Record<string,{required:string[];resolution:string}>={
|
||||
ivaBeverageRestitutions:{required:['origem e parcela13(2) actuais,sem sobreposição','referência/data do pedido e da decisão externa,quando exista','montante reconhecido e comprovativos dos recebimentos efectivamente ocorridos'],resolution:'Reconciliar a parcela ou completar apenas o acto externo em falta. Sem decisão/recebimento documentado,conservar esses estados pendentes;sem concessão ou caixa presumidas.'},
|
||||
ivaRefunds:{required:['afectação25/26/27 actual','fundamento e origem do crédito','pedido,decisão e comprovativos de recebimento próprios'],resolution:'Resolver a condição concreta do pedido ou registar o acto externo documentado;pedido não equivale a decisão ou recebimento.'},
|
||||
ivaSubstitutions:{required:['declaração anterior congelada e fonte actual','referência,motivo e data da substituição','juros e pagamentos adicionais próprios'],resolution:'Reconciliar anterior e actual,sem repetir créditos/pagamentos;guardar novo diferencial. A correspondência ModeloB/edição recebida permanece separada.'},
|
||||
|
||||
salesOperations:{required:['natureza e localização da operação','preço e indicação de IVA incluído/sem IVA','tratamento, condições e suporte próprios do fornecimento'],resolution:'Resolver o motivo da linha e calcular a operação de venda. O IVA documental da aquisição não é origem do IVA do fornecimento.'},
|
||||
books:{required:['IVA documental e documento legal','direito e afectação da aquisição','cobertura das parcelas do período e vendas/regularizações aplicáveis'],resolution:'Resolver as linhas/campos indicados e guardar novo apuramento; preservar versões e valores indeterminados até completar as parcelas.'},
|
||||
regulatedSecondhands:{required:['categoria, origem e regime do bem','venda, compra ou adjudicação e comissão documentadas','base da margem e regra de liquidação aplicável'],resolution:'A base/margem já demonstrada conserva-se. Implementar separadamente a liquidação e a integração nos totais com a regra e o âmbito próprios; base calculada não significa IVA calculado.'},
|
||||
travelOperations:{required:['operador, período e âmbito do registo global','contraprestação da parte especial e custos directos elegíveis de terceiros','excesso anterior, completude e enquadramento tributável'],resolution:'Completar o registo global e a base; implementar IVA devido, dedução43(d) e integração do período com correspondência própria. A taxa do divisor da base não preenche o IVA devido.'},
|
||||
travelSpecialEvents:{required:['origem da operação e natureza do evento','data e referência do pagamento integral/início ou cessação do regime','base, taxa e direito à dedução no cálculo próprio da operação'],resolution:'Resolver o momento do evento e ligá-lo ao apuramento próprio. Momento determinado ou diferimento não calcula base, IVA ou dedução.'},
|
||||
currencyEvents:{required:['natureza e âmbito do evento','datas de factura, prazo legal e recebimentos aplicáveis','moeda e câmbio documentado quando aplicável','base e regra fiscal da operação'],resolution:'Resolver os factos/câmbio indicados e implementar ou reutilizar o cálculo próprio da operação; o evento isolado não liquida imposto.'},
|
||||
};
|
||||
function record(value:unknown):value is Row{return!!value&&typeof value==='object'&&!Array.isArray(value);}
|
||||
/** Reads the applicable scope only; never recalculates or promotes a frozen result. */
|
||||
export function fiscalCalculationGaps(d:Record<string,unknown>):FiscalCalculationGap[]{
|
||||
const store=JSON.parse(String(d.modelo_a_snapshot||'{"version":1,"books":{}}'));if(store.version!==1||!record(store.books))throw Error('Livros não recuperáveis; conservar o original antes de diagnosticar.');
|
||||
const scope=String(d.context_opportunity||'general'),out:FiscalCalculationGap[]=[];
|
||||
const current:Record<string,()=>boolean>={salesOperations:()=>salesCurrent(d,salesBook(d)),books:()=>acquisitionCurrent(d,acquisitionBook(d)),travelOperations:()=>travelCurrent(d,travelBook(d)),travelSpecialEvents:()=>travelEventCurrent(d,travelEventBook(d)),regulatedSecondhands:()=>secondhandCurrent(d,secondhandBook(d)),currencyEvents:()=>currencyEventCurrent(d,currencyEventBook(d))};
|
||||
for(const[name,map]of Object.entries(store)){
|
||||
if(!record(map)||!(scope in map))continue;if(!record(map[scope]))throw Error(`Livro ${name} não recuperável;original preservado.`);const book=map[scope] as Row;if(book.result!==undefined&&!record(book.result))throw Error(`Resultado ${name} não recuperável;original preservado.`);const result=record(book.result)?book.result:null,inputs=(Array.isArray(book.rows)?book.rows:Array.isArray(book.events)?book.events:[]) as Row[],spec=details[name];
|
||||
if(!result){for(const row of inputs)out.push({id:`${name}:${row.id??out.length}:uncalculated`,book:name,period:String(row.period??''),calculation:String(row.description??row.id??name),reason:'Preparação sem resultado guardado; nenhum valor fiscal foi presumido.',required:spec?.required??['dados e condições específicos da preparação existente'],resolution:spec?.resolution??'Completar a preparação no componente existente e guardar o cálculo correspondente.',kind:'not_calculated',source:''});continue;}
|
||||
let fresh=true;try{fresh=current[name]?current[name]():!(Array.isArray(result.inputs)&&JSON.stringify(result.inputs)!==JSON.stringify(inputs));}catch{fresh=false;}
|
||||
if(!fresh)out.push({id:`${name}:stale`,book:name,period:'',calculation:'Actualidade do resultado',reason:'Entradas ou origem alteradas; resultado histórico conservado.',required:['reconciliação das entradas/origens alteradas'],resolution:'Rever apenas o delta e guardar nova versão antes de usar os valores como actuais.',kind:'stale',source:String(result.source??result.sources??'')});
|
||||
const visit=(value:unknown,path:string)=>{
|
||||
if(Array.isArray(value)){value.forEach((v,i)=>visit(v,`${path}[${i}]`));return;}if(!record(value)||value.status==='not_applicable')return;
|
||||
const missing=Object.entries(value).filter(([k,v])=>v===null&&financial.has(k)).map(([k])=>k);
|
||||
if(record(value.fields))for(const[k,v]of Object.entries(value.fields))if(v===null)missing.push(`campo${k}`);
|
||||
if(value.status==='indeterminate'||missing.length){
|
||||
const frozen=Array.isArray(result.inputs)?result.inputs as Row[]:inputs,input=frozen.find(i=>i.id===value.id),origin=record(input?.source)?input.source:null,prior=record(input?.prior)?input.prior:null,supply=name==='salesOperations'&&String(input?.treatment??'').startsWith('onboard_');
|
||||
const implementation=missing.length>0&&value.status!=='indeterminate'&&['regulatedSecondhands','travelOperations','travelSpecialEvents','currencyEvents'].includes(name);
|
||||
out.push({id:`${name}:${path}`,book:name,period:String(value.period??input?.period??origin?.period??prior?.period??''),calculation:`${String(input?.description??origin?.documentRef??value.id??(value.period?'Apuramento do período':'Apuramento'))}${missing.length?` — ${missing.map(f=>fieldLabels[f]??f.replace('campo','Campo ')).join(', ')}`:''}`,reason:String(value.reason??(Array.isArray(value.reasons)?value.reasons.join('; '):'Parcelas incompletas; consultar o apuramento existente.')),required:supply?['natureza do abastecimento e meio elegível','tratamento e montante liquidado do fornecimento, separados da aquisição','procedimento próprio de13(2), quando aplicável']:spec?.required??['dados, documentos e parâmetros indicados no motivo desta linha'],resolution:supply?'Identificar e implementar o tratamento do fornecimento e respectivo montante liquidado; conservar o IVA da aquisição separado. O acompanhamento E não resolve este cálculo.':spec?.resolution??'Resolver o motivo concreto no percurso de origem e guardar nova versão; campos em falta continuam indeterminados.',kind:implementation||supply?'implementation':'inputs_or_rule',source:String(value.source??result.source??result.sources??'')});
|
||||
}
|
||||
for(const[k,v]of Object.entries(value))if(['rows','periods','events'].includes(k))visit(v,`${path}.${k}`);
|
||||
};visit(result,'result');
|
||||
}
|
||||
return out;
|
||||
}
|
||||
export function fiscalCalculationGapReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{return fiscalCalculationGaps(d).map(g=>['IVA mensal',`Cálculo pendente — ${g.calculation}`,`${g.period};${g.kind};${g.reason};Dados necessários:${g.required.join('; ')};Condição:${g.resolution}`,`${g.book};${g.id};${g.source};sem inferir IVA do fornecimento a partir da aquisição.`]);}catch(error){return[['IVA mensal','Diagnóstico dos cálculos','Livros não recuperáveis; originais preservados',String(error)]];}}
|
||||
@@ -0,0 +1,27 @@
|
||||
import {closureBook,closureCurrent} from './iva-closure.ts';
|
||||
import {substitutionBook,substitutionCurrent} from './iva-substitution.ts';
|
||||
import {refundBook,refundCurrent} from './iva-refund.ts';
|
||||
import {beverageRestitutionBook,beverageRestitutionCurrent} from './iva-beverage-restitution.ts';
|
||||
import {fractionPresentation,fractionLabel,type FiscalFraction} from './fiscal-rational.ts';
|
||||
export const l3FormReference={file:'VAT Return.pdf',sha256:'9c0b99a810c7db53eb75d63c22ee22fb86a50ba57bd5509041ed80ee10f75741',page:2,scope:'Preparação dos campos identificados dos quadros8–11 do exemplar recebido;edição/aceitação electrónica não estabelecida.'};
|
||||
export const l3FormalitiesDependencies=[
|
||||
{branch:'A/B',identified:'Quadros8/10/11 e campos19/20/22–27 do exemplar recebido,PDF2;CIVA21(2/5)/23(1);RCIVA12/15.',missing:'Identificação da edição electrónica aplicável e dados de autenticação/meio de pagamento não inferidos dos recibos.',trigger:'Exemplar/instrução da edição electrónica ou dados do sujeito passivo;nenhuma assinatura ou submissão automática.'},
|
||||
{branch:'C',identified:'Quadro9/campo21 e transcrição positiva para22 do exemplar recebido,PDF2.',missing:'RCIVA15 refereModeloB;exemplar recebido assinala substituiçãoModeloA. Correspondência de edição/formulário regulamentar por resolver.',trigger:'ModeloB/instrução que esclareça a correspondência com a edição recebida. Preservar cálculo e preparação de21–24.'},
|
||||
{branch:'D',identified:'Quadro11:25=26+27;pedido27 não volta a19 sem comunicação. Remissãoart20 impressa conservada como divergência;regime2026 assenta em21.',missing:'Exemplares e instruções regulamentares específicos de reembolso:Decretos78/2017,30/2022 e52/2025 identificados na análise anterior;sem correspondência de campos demonstrada.',trigger:'Texto/modelo/instrução integral novo ou já fornecido;sem repetir a pesquisa anterior sem nova evidência. Preparação26/27 não equivale ao pedido regulamentar completo.'},
|
||||
{branch:'E',identified:'CIVA13(1)c/d/h e13(2–3);pedido,decisão e recebimento separados no dossier.',missing:'Modelo e procedimento específico de restituição de bebidas por identificar. Não usar27 como se fosse a restituição13(2).',trigger:'Exemplar ou instrução específica de13(2);sem importar limiares,prazos ou modelos do reembolso geralD.'},
|
||||
] as const;
|
||||
export type L3FormPreparation={id:string;branch:string;period:string;entity:string;current:boolean;reference:string;status:string;fields:Array<{field:string;label:string;value:string;exact:string}>;notes:string[]};
|
||||
const fmt=(v:FiscalFraction|null|undefined)=>v?fractionPresentation(v).decimal:'Indeterminado';
|
||||
const cell=(field:string,label:string,v:FiscalFraction|null|undefined)=>({field,label,value:fmt(v),exact:v?fractionLabel(v):'Indeterminado'});
|
||||
export function l3FormPreparations(d:Record<string,unknown>):L3FormPreparation[]{
|
||||
const out:L3FormPreparation[]=[],ab=closureBook(d),c=substitutionBook(d),rd=refundBook(d),e=beverageRestitutionBook(d);
|
||||
for(const r of ab.result?.rows??[]){const input=ab.result!.inputs.find(i=>i.id===r.id);out.push({id:`AB:${r.id}`,branch:'A/B',period:r.period,entity:r.entityRef,current:closureCurrent(d,ab),reference:`${l3FormReference.file};SHA256${l3FormReference.sha256};PDF2/quadros8,10,11`,status:r.status,fields:[['19','Excesso do período anterior'],['20','Créditos comunicados'],['22','IVA a entregar'],['23','Juros compensatórios'],['24','Importância a pagar'],['25','Crédito de imposto'],['26','Reporte seguinte'],['27','Pedido de reembolso']].map(([f,label])=>cell(f,label,r.fields[f])),notes:[`Versão congelada${ab.result!.calculatedAt};${input?.origin??''};fonteL2${input?.source?.revision??''}.`,'Cabeçalho refere18/19,mas caixas19/20;original não renumerado. Meio de pagamento,assinatura e uso dos serviços ficam por preencher.','27 é afectação a pedido geral,não decisão nem recebimento;05/06 permanecem fora desta preparaçãoL3.']});}
|
||||
for(const r of c.result?.rows??[]){const input=c.result!.inputs.find(i=>i.id===r.id);out.push({id:`C:${r.id}`,branch:'C',period:input?.prior?.period??'',entity:input?.prior?.entityRef??'',current:substitutionCurrent(d,c),reference:`${l3FormReference.file};PDF2/quadro9;${l3FormalitiesDependencies[1].missing}`,status:r.status,fields:[['21','Diferencial'],['22','Diferencial devedor'],['23','Juros adicionais'],['24','Importância adicional a pagar']].map(([f,label])=>cell(f,label,r.fields[f])),notes:[`Anterior${input?.priorReference??''};${input?.priorDate??''};substituição${input?.reference??''};${input?.date??''};${input?.stage??''}.`,r.reason,'Crédito credor aguarda comunicação20;pagamentos anteriores conservam-se e não voltam a ser inscritos como pagamento adicional.']});}
|
||||
for(const r of rd.result?.rows??[]){const input=rd.result!.inputs.find(i=>i.id===r.id);out.push({id:`D:${r.id}`,branch:'D',period:input?.source?.period??'',entity:input?.source?.entityRef??'',current:refundCurrent(d,rd),reference:`${l3FormReference.file};PDF2/quadro11;${l3FormalitiesDependencies[2].missing}`,status:r.status,fields:[cell('25','Crédito de imposto',input?.source?.credit),cell('26','Reporte separado',r.reported),cell('27','Pedido de reembolso',r.requested)],notes:[`Pedido${input?.requestReference??''};${input?.requestDate??''};${input?.stage??''}.`,r.reason,`Acompanhamento separado:reconhecido${fmt(r.approved)};recebido${fmt(r.received)};por receber${fmt(r.awaitingReceipt)}MZN. Estes valores não substituem27.`]});}
|
||||
for(const r of e.result?.rows??[]){const input=e.result!.inputs.find(i=>i.id===r.id);out.push({id:`E:${r.id}`,branch:'E',period:input?.source?.period??'',entity:input?.entityRef??'',current:beverageRestitutionCurrent(d,e),reference:'Dossier de apoio13(2);modelo oficial específico ainda não identificado.',status:r.status,fields:[cell('Dossier','IVA documental',input?.source?.vat),cell('Dossier','Parcela pedida',r.requested),{field:'Dossier',label:'Dedução desta parcela',value:r.requested?'0.00':'Indeterminado',exact:r.requested?'0/1':'Indeterminado'},cell('Dossier','Reconhecido',r.approved),cell('Dossier','Recebido',r.received),cell('Dossier','Por receber',r.awaitingReceipt)],notes:[`Documento${input?.source?.documentRef??''};linha${input?.source?.documentLine??''};operação${input?.source?.operationId??''};pedido${input?.requestReference??''};${input?.requestDate??''}.`,r.reason,'Sem campo27 nem formulárioD presumidos;IVA do fornecimento mantém cálculo próprio.']});}
|
||||
return out;
|
||||
}
|
||||
export const l3PreparationStatus=(status:string)=>status==='determined'?'Cálculo determinado':status==='indeterminate'?'Indeterminado':status;
|
||||
const escape=(s:string)=>s.replace(/[&<>"']/g,c=>({'&':'&','<':'<','>':'>','"':'"',"'":'''}[c]!));
|
||||
export function l3FormPreparationHtml(p:L3FormPreparation):string{return`<!doctype html><html lang="pt"><meta charset="utf-8"><title>Preparação L3 ${escape(p.branch)}</title><style>body{font:16px system-ui;max-width:960px;margin:32px auto;padding:0 24px;line-height:1.5}table{border-collapse:collapse;width:100%}th,td{border:1px solid #999;padding:8px;text-align:left}small{display:block}h1{font-size:26px}@media print{body{margin:0}}</style><h1>Preparação L3 ${escape(p.branch)} — ${escape(p.period)}</h1><p>${escape(p.entity)};${escape(l3PreparationStatus(p.status))};${p.current?'Correspondente às entradas':'Histórico preservado;rever entradas/origem'}. Submissão externa;preparação para conferência,não declaração AT submetida.</p><p>${escape(p.reference)}</p><table><thead><tr><th>Campo</th><th>Finalidade</th><th>MZN</th><th>Valor exacto</th></tr></thead><tbody>${p.fields.map(f=>`<tr><td>${escape(f.field)}</td><td>${escape(f.label)}</td><td>${escape(f.value)}</td><td>${escape(f.exact)}</td></tr>`).join('')}</tbody></table>${p.notes.map(n=>`<p>${escape(n)}</p>`).join('')}<h2>Formalidades ainda por completar</h2>${l3FormalitiesDependencies.filter(dep=>dep.branch===p.branch||p.branch==='A/B'&&dep.branch==='D').map(dep=>`<p>${escape(dep.missing)}<small>Condição de retoma:${escape(dep.trigger)}</small></p>`).join('')}<p>Fracções exactas conservadas;decimais são apresentação técnica,sem arredondamento fiscal final ou alteração de histórico.</p></html>`;}
|
||||
export function l3FormPreparationReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{return l3FormPreparations(d).flatMap(p=>[['IVA mensal',`Preparação formal L3${p.branch} — ${p.period}`,`${p.current?'Entradas correspondentes':'Histórico;rever origem'};${l3PreparationStatus(p.status)};${p.fields.map(f=>`${f.field}/${f.label}:${f.value}MZN;exacto${f.exact}`).join(' | ')}`,`${p.reference};${p.notes.join(' | ')}`]as[string,string,string,string]]);}catch(error){return[['IVA mensal','Preparação formalL3','Dados não recuperáveis;originais preservados',String(error)]];}}
|
||||
@@ -1,3 +1,5 @@
|
||||
import {fiscalCalculationGapReportRows} from './iva-calculation-gaps.ts';
|
||||
import {l3FormPreparationReportRows} from './l3-form-preparation.ts';
|
||||
import { remissionReportRows } from './iva-remission-imports.ts';
|
||||
import { digitalReportRows } from './iva-digital.ts';
|
||||
import { objectiveImportReportRows } from './iva-objective-imports.ts';
|
||||
@@ -683,6 +685,8 @@ export function buildProjectDossierRows(
|
||||
rows.push(...travelReportRows(draft));
|
||||
rows.push(...travelEventReportRows(draft));
|
||||
rows.push(...offerPreparationReportRows(draft));
|
||||
rows.push(...fiscalCalculationGapReportRows(draft));
|
||||
rows.push(...l3FormPreparationReportRows(draft));
|
||||
const operationRows = salesReportRows(draft);
|
||||
rows.push(...operationRows);
|
||||
if (draft.monthly_iva_snapshot) {
|
||||
|
||||
Reference in New Issue
Block a user