correcao de conflitos
tests / ci (push) Canceled after 0s

This commit is contained in:
2026-10-26 12:02:22 +02:00
762 changed files with 108900 additions and 275 deletions
+1 -1
View File
@@ -824,7 +824,7 @@ function scaledDecimal(value: string, scale: number, label: string): bigint {
);
}
function convertCents(
export function convertCents(
value: bigint,
rateScaled: bigint,
rateScale: bigint,
+17
View File
@@ -0,0 +1,17 @@
import {addFractions,subtractFractions,positiveFraction,decimalFraction,type FiscalFraction} from './fiscal-rational.ts';
export type FiscalClaimEvents={stage:'preparation'|'submitted';requestReference:string;requestDate:string;decision:'pending'|'approved'|'partial'|'rejected';decisionReference:string;decisionDate:string;decisionIssuer:string;approvedAmount:string;receipts:Array<{id:string;reference:string;date:string;amount:string}>};
export type FiscalClaimState={status:'determined'|'indeterminate';reason:string;approved:FiscalFraction|null;received:FiscalFraction|null;awaitingReceipt:FiscalFraction|null;notGranted:FiscalFraction|null};
export function newFiscalClaimEvents():FiscalClaimEvents{return{stage:'preparation',requestReference:'',requestDate:'',decision:'pending',decisionReference:'',decisionDate:'',decisionIssuer:'',approvedAmount:'',receipts:[]};}
export const fiscalClaimDate=(v:string)=>/^20\d{2}-(0[1-9]|1[0-2])-\d{2}$/.test(v)&&!Number.isNaN(Date.parse(v))&&new Date(v).toISOString().slice(0,10)===v;
export function assessFiscalClaim(row:FiscalClaimEvents,requested:FiscalFraction,duplicate:(p:FiscalClaimEvents['receipts'][number])=>boolean):FiscalClaimState{
const r:FiscalClaimState={status:'indeterminate',reason:'',approved:null,received:null,awaitingReceipt:null,notGranted:null},stop=(reason:string)=>({...r,reason});
if(!row.requestReference.trim()||!fiscalClaimDate(row.requestDate))return stop('Identifique referência/data do pedido ou preparação.');
if(row.stage==='preparation'&&(row.decision!=='pending'||row.receipts.length))return stop('Preparação não é pedido apresentado;registe apresentação externa antes de decisão/recebimento.');
if(row.decision==='pending'){if(row.receipts.length)return stop('Recebimento sem decisão identificada;conservar registo sem o presumir reconhecido.');return{...r,status:'determined',reason:'Pedido conservado;decisão e recebimento ainda não identificados.'};}
if(!row.decisionReference.trim()||!row.decisionIssuer.trim()||!fiscalClaimDate(row.decisionDate)||row.decisionDate<row.requestDate)return stop('Identifique decisão recebida,número/data e entidade emitente;pedido não equivale a deferimento.');
let approved:FiscalFraction;try{approved=decimalFraction(row.approvedAmount);}catch{return stop('Montante reconhecido por identificar;indeferimento exigezero expresso,sem transformar desconhecido emzero.');}
if(BigInt(subtractFractions(approved,requested).numerator)>0n||row.decision==='approved'&&JSON.stringify(approved)!==JSON.stringify(requested)||row.decision==='rejected'&&BigInt(approved.numerator)!==0n||row.decision==='partial'&&(BigInt(approved.numerator)<=0n||BigInt(subtractFractions(requested,approved).numerator)<=0n))return stop('Montante reconhecido incompatível com decisão/pedido;conservar o âmbito exacto,sem generalizar o deferimento.');
r.approved=approved;r.notGranted=subtractFractions(requested,approved);const receipts:FiscalFraction[]=[];
for(const p of row.receipts){if(!p.reference.trim()||!fiscalClaimDate(p.date)||p.date<row.decisionDate||duplicate(p))return stop('Recebimento sem referência/data posterior à decisão ou já registado noutro pedido;sem duplicar caixa.');try{const value=decimalFraction(p.amount);if(BigInt(value.numerator)<=0n)return stop('Recebimento exige montante positivo identificado.');receipts.push(value);}catch{return stop('Montante recebido por identificar;decisão não cria recebimento.');}}
r.received=addFractions(receipts);if(BigInt(subtractFractions(r.received,approved).numerator)>0n)return stop('Recebimentos excedem o montante reconhecido;reconcilie sem criar crédito ou caixa adicional.');r.awaitingReceipt=positiveFraction(subtractFractions(approved,r.received));return{...r,status:'determined',reason:'Pedido,decisão e recebimento separados;sem execução bancária ou sincronização silenciosa de caixa.'};
}
+22
View File
@@ -0,0 +1,22 @@
/** Exact amounts in currency units; decimal formatting is presentation, never a tax rule. */
export type FiscalFraction = { numerator:string; denominator:string };
function parts(value:FiscalFraction):[bigint,bigint] {
if(!/^-?\d{1,80}$/.test(value.numerator)||!/^\d{1,80}$/.test(value.denominator)||BigInt(value.denominator)===0n)throw new Error('Representação racional inválida; sem substituição por zero.');
return [BigInt(value.numerator),BigInt(value.denominator)];
}
export function fraction(n:bigint,d=1n):FiscalFraction {
if(d===0n)throw new Error('Denominador nulo.');if(d<0n){n=-n;d=-d;}
let a=n<0n?-n:n,b=d;while(b){const r=a%b;a=b;b=r;}return {numerator:String(n/(a||1n)),denominator:String(d/(a||1n))};
}
export function decimalFraction(raw:string):FiscalFraction {
if(!/^\d{1,18}(\.\d{1,6})?$/.test(raw))throw new Error('Montante decimal inválido.');const [a,b='']=raw.split('.');return fraction(BigInt(a+b),10n**BigInt(b.length));
}
export function addFractions(values:FiscalFraction[]):FiscalFraction {return values.reduce((a,b)=>{const [an,ad]=parts(a),[bn,bd]=parts(b);return fraction(an*bd+bn*ad,ad*bd);},fraction(0n));}
export function subtractFractions(a:FiscalFraction,b:FiscalFraction):FiscalFraction {const [an,ad]=parts(a),[bn,bd]=parts(b);return fraction(an*bd-bn*ad,ad*bd);}
export function positiveFraction(value:FiscalFraction):FiscalFraction {return parts(value)[0]>0n?value:fraction(0n);}
export function fractionPresentation(value:FiscalFraction):{decimal:string;approximate:boolean} {
const [raw,d]=parts(value),n=raw<0n?-raw:raw,scaled=n*1000000n;
const q=(scaled+d/2n)/d,dec=(q%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0');
return {decimal:`${raw<0n?'-':''}${q/1000000n}.${dec}`,approximate:scaled%d!==0n};
}
export function fractionLabel(value:FiscalFraction):string {parts(value);return `${value.numerator}/${value.denominator}`;}
+5 -1
View File
@@ -34,12 +34,14 @@ export type ContextReference = {
version: number | string | null;
sha256: string;
fields: Record<string, string>;
analysis?: {documented_sector?: string | null; documented_location?: string | null; [key:string]:unknown};
documents?: ContextDocument[];
visibility?: 'private' | 'public';
state?: string | null;
};
export type RequirementsAssessment = {version: string; fiscal_notice: string; requirements: {opportunity_key: string; opportunity_title: string; code: string; title: string; state: string; step: string; authority: string; documents: string[]; basis: string; source_url: string; decision: string}[]};
export type OpportunityChoice = {
park?: ContextReference | null;
portfolio_origins?: {id:string;title:string;kind:string;href:string;version:number;sha256:string}[];
corridor_key?: string | null;
corridor_name?: string | null;
@@ -56,12 +58,13 @@ export type OpportunityChoice = {
source_sha256?: string | null;
};
export type DossierContext = {
complements?: import('@/components/investment-complements').Complement[];
requirements_assessment?: RequirementsAssessment;
opportunity_choices?: OpportunityChoice[];
revision: number;
selection: Partial<
Record<
'opportunity' | 'sector' | 'territory' | 'park',
'portfolio' | 'opportunity' | 'sector' | 'territory' | 'park',
ContextReference
>
>;
@@ -98,6 +101,7 @@ export type ContextView = {
notice: string;
};
export type ContextPlan = {
complements?: import('@/components/investment-complements').Complement[];
requirements_assessment?: RequirementsAssessment;
opportunity_choices?: OpportunityChoice[];
private_investment?: { before: Preparation; after: Preparation } | null;
+1
View File
@@ -19,6 +19,7 @@ export const pathStates: Record<string, string> = {
expired: 'Acto externo expirado',
};
export type PathResult = {
context_opportunity?: string | null;
id: string;
financial_snapshot: string;
currency: string | null;
+31
View File
@@ -0,0 +1,31 @@
import {selectFx,fxSelectionKey,type FxSelection} from './iva-fx-selection.ts';
import {currencyEventBook,newCurrencyEvent} from './iva-currency-events.ts';
import {convertCents} from './business-financial-plan.ts';
import {decimalFraction,fraction,type FiscalFraction} from './fiscal-rational.ts';
import {closureFingerprint} from './iva-closure.ts';
export type IrpcFxLink={id:string;fingerprint:string};
export type IrpcFxAmount={currency:string;fxSelection?:FxSelection;fxLink?:IrpcFxLink};
export type IrpcFxEvidence={originalAmount:string;originalCurrency:string;convertedCurrency:'MZN';column:string;rate:string;date:string;direction:string;source:string;selectionKey:string;rounding:string};
export function irpcFxSources(d:Record<string,unknown>){return currencyEventBook(d).rows.filter(r=>r.fxSelection).map(r=>({id:r.id,label:`${r.description||r.id} — ${r.sourceCurrency} — ${r.fxSelection?.applied?.rate??'por aplicar'}`,fingerprint:closureFingerprint(r),selection:structuredClone(r.fxSelection!)}));}
export function irpcFxDependency(d:Record<string,unknown>,input:IrpcFxAmount):string{
if(input.currency==='MZN'||!input.fxLink)return'';
const source=irpcFxSources(d).find(s=>s.id===input.fxLink!.id);
return !source?'Selecção cambial de origem indisponível;vínculo e histórico conservados.':source.fingerprint!==input.fxLink.fingerprint?'Selecção cambial de origem alterada;compare a nova selecção antes de a aplicar às retenções.':'';
}
export function irpcFxRow(id:string,input:IrpcFxAmount){const s=input.fxSelection,a=s?.applied;return{...newCurrencyEvent(id,'MZN'),sourceCurrency:input.currency,fxSelection:s,fxDirection:s?.direction??'',fxRate:a?.rate??'',fxDate:a?.date??'',fxSource:a?.source??''};}
export function convertIrpcAmount(d:Record<string,unknown>,amount:string,input:IrpcFxAmount):{value:FiscalFraction;evidence:IrpcFxEvidence|null}{
const original=decimalFraction(amount);if(input.currency==='MZN')return{value:original,evidence:null};
const issue=irpcFxDependency(d,input);if(issue)throw Error(issue);
const s=input.fxSelection;if(!s)throw Error('Reutilize ou aplique a selecção cambial já entregue:moeda original,boletim,coluna,data e sentido;sem taxa actual por defeito.');
const selected=selectFx(s),a=s.applied;
if(!a||a.selectionKey!==fxSelectionKey(s)||a.rate!==selected.rate||a.date!==selected.date||a.source!==selected.source||a.column!==selected.column||s.sourceCurrency!==input.currency)throw Error('Selecção cambial alterada,não confirmada ou de outra moeda;use a conferência e confirmação existentes,sem recalcular históricos.');
const [whole,places='']=selected.rate.split('.'),rate=BigInt(whole+places.padEnd(8,'0')),scale=100000000n;
const micro=BigInt(original.numerator)*1000000n/BigInt(original.denominator);
const converted=s.direction==='mzn_per_unit'?convertCents(micro,rate,scale):convertCents(micro,scale,rate);
return{value:fraction(converted,1000000n),evidence:{originalAmount:amount,originalCurrency:input.currency,convertedCurrency:'MZN',column:selected.column,rate:selected.rate,date:selected.date,direction:s.direction,source:selected.source,selectionKey:a.selectionKey,rounding:'Mesmo convertCents entregue;conversão à unidade de0,000001MZN;apresentação separada,não regra nova de arredondamento do imposto.'}};
}
export function irpcFxEvidenceLabel(e:IrpcFxEvidence):string{const column=({buy:'Compra',sell:'Venda',mean:'Média de referência BM',exception:'Excepção fiscal identificada'} as Record<string,string>)[e.column]??e.column;const direction=e.direction==='mzn_per_unit'?'MZN por '+e.originalCurrency:e.originalCurrency+' por MZN';return`Original: ${e.originalAmount} ${e.originalCurrency}; coluna: ${column}; taxa: ${e.rate}; cotação: ${direction}; data cambial: ${e.date}; fonte: ${e.source.split(';perspectiva:')[0]}. Montante e selecção originais conservados.`;}
export function updateIrpcFx(input:IrpcFxAmount,selection:FxSelection):Partial<IrpcFxAmount>{return{fxSelection:selection,fxLink:input.fxSelection&&fxSelectionKey(input.fxSelection)===fxSelectionKey(selection)?input.fxLink:undefined};}
+69
View File
@@ -0,0 +1,69 @@
import type {IrpcBook} from './irpc-withholdings.ts';
import {addFractions,decimalFraction,fraction,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
export type IrpcInterestRule={
annualRate:string;rateSource:string;fiscalBasis:string;validFrom:string;validTo:string;
dayBasis:''|'365'|'366'|'actual_year';dayBasisRef:string;
rounding:''|'total_cent_half_up'|'total_cent_down';roundingRef:string;
retention:''|'withheld'|'not_withheld';occurrenceRef:string;
};
export const newIrpcInterestRule=():IrpcInterestRule=>({annualRate:'',rateSource:'',fiscalBasis:'',validFrom:'',validTo:'',dayBasis:'',dayBasisRef:'',rounding:'',roundingRef:'',retention:'',occurrenceRef:''});
export const irpcInterestVersion='IRPC-interest/1';
export type IrpcInterestSegment={from:string;to:string;days:number;denominator:number;principal:FiscalFraction;interest:FiscalFraction};
export type IrpcInterestCalculation={version:string;rows:Array<{id:string;document:string;segments:IrpcInterestSegment[];exact:FiscalFraction}>;pending:string[];exact:FiscalFraction|null;total:FiscalFraction|null;rule:IrpcInterestRule;dueDate:string;liquidationDate:string;source:string};
const validDate=(s:string)=>/^20\d{2}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(Date.parse(s))&&new Date(s).toISOString().slice(0,10)===s;
const next=(s:string)=>new Date(Date.parse(s)+86400000).toISOString().slice(0,10);
const less=(a:FiscalFraction,b:FiscalFraction)=>BigInt(a.numerator)*BigInt(b.denominator)<BigInt(b.numerator)*BigInt(a.denominator);
const zero=()=>fraction(0n,1n);
export function validateIrpcInterestRule(r:IrpcInterestRule){
if(!r||Object.keys(newIrpcInterestRule()).some(k=>typeof r[k as keyof IrpcInterestRule]!=='string')||!['','365','366','actual_year'].includes(r.dayBasis)||!['','total_cent_half_up','total_cent_down'].includes(r.rounding)||!['','withheld','not_withheld'].includes(r.retention))throw Error('Parâmetros de juros não recuperáveis;originais conservados.');
}
// No fiscal rate, annual day basis or rounding convention is supplied by default.
// Complete references describe the parameters of this case, not a global 2026 rate.
export function calculateIrpcInterest(b:IrpcBook,current:boolean,period:string,dueDate:string,dueReference:string,liquidationDate:string,r:IrpcInterestRule):IrpcInterestCalculation{
validateIrpcInterestRule(r);
const pending:string[]=[],rows:IrpcInterestCalculation['rows']=[];
const result=(exact:FiscalFraction|null=null,total:FiscalFraction|null=null):IrpcInterestCalculation=>({version:irpcInterestVersion,rows,pending,exact,total,rule:structuredClone(r),dueDate,liquidationDate,source:'Decreto9/2008 art35(1/2):dia imediato ao prazo até pagamento/liquidação;25(1):parâmetro na data da liquidação. Taxa,base anual e arredondamento apenas conforme referências do caso. Sem parâmetro fiscal2026 pré-definido,sem MIMO/Prime presumidos. Mora e retenção por conta não efectuada conservam regra própria.'});
if(!current||!b.result)pending.push('Retenções sem cálculo actual.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(period)||!validDate(dueDate)||!dueReference.trim()||!validDate(liquidationDate)||liquidationDate<=dueDate||dueDate<period+'-01')pending.push('Identifique período,prazo documentado e data de liquidação posterior ao prazo;sem prazo/calendário presumidos.');
if(!validDate(r.validFrom)||!validDate(r.validTo)||r.validFrom>r.validTo||liquidationDate<r.validFrom||liquidationDate>r.validTo)pending.push('Parâmetro fora da versão/período aplicável à data de liquidação.');
const labels:Record<string,string>={rateSource:'fonte da taxa anual final',fiscalBasis:'fundamento fiscal aplicável',dayBasisRef:'fonte da base anual',roundingRef:'fonte do arredondamento',occurrenceRef:'documento da retenção/ocorrência'};
for(const[k,label]of Object.entries(labels))if(!r[k as keyof IrpcInterestRule].trim())pending.push('Falta '+label+'.');
if(!r.dayBasis||!r.rounding||!r.retention)pending.push('Regra de base anual,arredondamento e situação da retenção por identificar.');
let rate:FiscalFraction;
try{rate=decimalFraction(r.annualRate);if(!less(zero(),rate))throw Error();}catch{pending.push('Taxa anual final aplicável por identificar;sem zero ou taxa bancária de substituição.');return result();}
if(pending.length)return result();
const selected=b.result!.rows.filter(v=>v.direction==='paid'&&v.period===period&&v.treatment!=='dispensed');
if(!selected.length){pending.push('Sem retenções a entregar seleccionadas para este período.');return result();}
for(const v of selected){
const input=b.result!.inputs.find(i=>i.id===v.id);
if(!input||v.status!=='calculated'||!v.tax||less(v.tax,zero())||v.settled===null||!['none','complete'].includes(input.settlement)||!input.settlementRef.trim()||!v.nature){pending.push(v.id+': retenção/entregas não reconciliadas.');continue;}
if(v.nature==='on_account'&&r.retention!=='withheld'){pending.push(input.documentRef+': imposto por conta não retido exige o termo da declaração anual e responsabilidade correspondentes;fora deste cálculo.');continue;}
let payments:Array<{date:string;amount:FiscalFraction}>=[];
try{
const seen=new Set<string>();
payments=input.allocations.map(a=>{const p=b.result!.payments.find(p=>p.id===a.paymentId);if(!p||seen.has(p.id)||p.kind!=='remittance'||p.currency!=='MZN'||!validDate(p.date)||p.date<v.eventDate||!p.reference.trim()||p.date>liquidationDate)throw Error();seen.add(p.id);const amount=decimalFraction(a.amount);if(!less(zero(),amount))throw Error();return{date:p.date,amount};});
const allocated=addFractions(payments.map(p=>p.amount));if(less(v.tax,allocated)||!isEqual(allocated,v.settled))throw Error();
}catch{pending.push(input.documentRef+': comprovativos incoerentes ou posteriores à data de liquidação;conserve e reconcilie.');continue;}
let principal=subtractFractions(v.tax,addFractions(payments.filter(p=>p.date<=dueDate).map(p=>p.amount))),cursor=next(dueDate);
const segments:IrpcInterestSegment[]=[];
const charge=(to:string)=>{
if(cursor>to||!less(zero(),principal))return;
while(cursor<=to){
const year=Number(cursor.slice(0,4)),yearEnd=year+'-12-31',end=r.dayBasis==='actual_year'&&yearEnd<to?yearEnd:to;
const denominator=r.dayBasis==='actual_year'?(year%4===0&&(year%100!==0||year%400===0)?366:365):Number(r.dayBasis);
const days=(Date.parse(end)-Date.parse(cursor))/86400000+1;
const interest=fraction(BigInt(principal.numerator)*BigInt(rate.numerator)*BigInt(days),BigInt(principal.denominator)*BigInt(rate.denominator)*100n*BigInt(denominator));
segments.push({from:cursor,to:end,days,denominator,principal,interest});cursor=next(end);
}
};
const grouped=new Map<string,FiscalFraction[]>();for(const p of payments.filter(p=>p.date>dueDate))grouped.set(p.date,[...(grouped.get(p.date)??[]),p.amount]);
for(const[day,parts]of [...grouped].sort(([a],[c])=>a.localeCompare(c))){charge(day);principal=subtractFractions(principal,addFractions(parts));cursor=next(day);}
charge(liquidationDate);rows.push({id:v.id,document:input.documentRef,segments,exact:addFractions(segments.map(s=>s.interest))});
}
if(pending.length)return result();
const exact=addFractions(rows.map(r=>r.exact)),scaled=BigInt(exact.numerator)*100n,d=BigInt(exact.denominator);
let cents=scaled/d;if(r.rounding==='total_cent_half_up'&&scaled%d*2n>=d)cents++;
return result(exact,fraction(cents,100n));
}
function isEqual(a:FiscalFraction,b:FiscalFraction){return BigInt(a.numerator)*BigInt(b.denominator)===BigInt(b.numerator)*BigInt(a.denominator);}
+18
View File
@@ -0,0 +1,18 @@
import type {MrftaModel} from './irpc-mrfta.ts';
import {closureFingerprint} from './iva-closure.ts';
import {fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
// Groups are working sheets, never a decision to split an official declaration.
export function mrftaCases(m:MrftaModel){return m.lines.map(line=>({
key:closureFingerprint([m.period,line.rubric,line.rate,line.cer]),period:m.period,
rubric:line.rubric,rate:line.rate,cer:line.cer,ids:[...line.ids],documents:[...line.documents],references:[...line.references],
base:structuredClone(line.base),tax:structuredClone(line.tax),paid:structuredClone(line.paid),
pending:!line.cer||!/^\d+$/.test(line.cer)||!line.ids.every(id=>m.input.codes.find(c=>c.rowId===id)?.reference.trim())?'CER ou referência por corresponder;sem preenchimento presumido.':'CER transcrito com referência do caso;sem validação por catálogo oficial. Código provisório ou de simulação não é correspondência oficial.',
officialSeparation:'A correspondência de linhas/anexos/declaração oficial permanece por resolver quando há taxas/CER distintos na mesma rubrica.',
}));}
export function mrftaCaseHtml(m:MrftaModel,key:string):string{
const c=mrftaCases(m).find(c=>c.key===key);if(!c)throw Error('Caso MRFTA não encontrado;reprepare as entradas actuais.');
const esc=(v:unknown)=>String(v).replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]!));
const money=(v:FiscalFraction|null)=>{if(!v)return'Indeterminado';const p=fractionPresentation(v);return(p.approximate?'≈':'')+p.decimal+' MZN';};
return `<!doctype html><html lang="pt"><meta charset="utf-8"><title>MRFTA — ficha de caso</title><body><h1>MRFTA — ficha de trabalho por caso</h1><p>Não é uma declaração autónoma,guia,anexo oficial ou submissão. Não funde taxas nem substitui o total do período.</p><p>Período:${esc(c.period)};rubrica:${esc(c.rubric)};taxa:${c.rate}%;CER:${esc(c.cer||'Por corresponder')}.</p><p>Base:${esc(money(c.base))};imposto:${esc(money(c.tax))};entregas:${esc(money(c.paid))}.</p><p>Documentos:${esc(c.documents.join(';'))};origens:${esc(c.ids.join(';'))}.</p><p>${esc(c.references.join(' | '))}</p><p>${esc(c.pending)}</p><p>${esc(c.officialSeparation)}</p><h2>Pendências do período — conservadas</h2><ul>${m.pending.map(p=>'<li>'+esc(p)+'</li>').join('')}</ul><small>${esc(m.source)}</small></body></html>`;
}
+96
View File
@@ -0,0 +1,96 @@
import {irpcInterestVersion,calculateIrpcInterest,validateIrpcInterestRule,type IrpcInterestRule,type IrpcInterestCalculation} from './irpc-interest.ts';
import type {IrpcBook, IrpcResult, IrpcRow} from './irpc-withholdings.ts';
import {addFractions,decimalFraction,fraction,fractionPresentation,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
export type MrftaInput = {
version:1; period:string; declaration:''|'initial'|'replacement'; timing:''|'within'|'late';
nuit:string; name:string; commercialName:string; taxArea:string; address:string; contact:string;
completeness:''|'yes'|'no'; completenessRef:string;
otherRubrics:''|'none'|'pending'; otherRubricsRef:string;
codes:Array<{rowId:string;cer:string;reference:string}>;
interest:{mode:''|'assessment'|'timely';calculation?:'automatic';automatic?:IrpcInterestRule;period:string;amount:string;reference:string;date:string;dueDate:string;dueReference:string};
};
type MrftaLine={ids:string[];documents:string[];references:string[];rubric:string;cer:string;rate:number;base:FiscalFraction;tax:FiscalFraction;paid:FiscalFraction|null};
export type MrftaModel={automatic?:IrpcInterestCalculation;period:string;input:MrftaInput;lines:MrftaLine[];excluded:Array<{id:string;reason:string}>;pending:string[];principal:FiscalFraction;paid:FiscalFraction|null;interest:FiscalFraction|null;total:FiscalFraction|null;interestReason:string;source:string};
export type MrftaRecord={key:string;createdAt:string;model:MrftaModel};
export type MrftaStore={mrfta?:MrftaInput;mrftaResult?:MrftaRecord;mrftaHistory?:MrftaRecord[]};
export const newMrftaInput=():MrftaInput=>({version:1,period:'',declaration:'',timing:'',nuit:'',name:'',commercialName:'',taxArea:'',address:'',contact:'',completeness:'',completenessRef:'',otherRubrics:'',otherRubricsRef:'',codes:[],interest:{mode:'',period:'',amount:'',reference:'',date:'',dueDate:'',dueReference:''}});
export const mrftaSource='AT MRFTA19/39,PDF1–2:quadros1–7;um mês/ano por declaração. Decreto9/2008 arts25/35,PDF6/8,p121/123:juros compensatórios separados. MAIBOR12meses+2p.p.na data da liquidação;publicação MAIBOR descontinuada segundo BM. Sem substituir por MIMO/Prime nem presumir zero. CER exige referência específica;remissões antigas do M/39 não renumeradas no original.';
const date=(s:string)=>/^20\d{2}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(Date.parse(s))&&new Date(s).toISOString().slice(0,10)===s;
const zero=()=>fraction(0n,1n);
const isZero=(v:FiscalFraction)=>BigInt(v.numerator)===0n;
const negative=(v:FiscalFraction)=>BigInt(v.numerator)<0n;
const labels:Record<string,string>={period:'mês/ano',declaration:'tipo de declaração',timing:'dentro/fora do prazo',nuit:'NUIT',name:'nome do sujeito passivo',taxArea:'área fiscal',address:'domicílio fiscal'};
export function validateMrfta(b:MrftaStore){
const i=b.mrfta;
if(i?.interest?.calculation!==undefined&&i.interest.calculation!=='automatic')throw Error('Método de cálculo de juros não recuperável.');
if(i?.interest?.automatic!==undefined)validateIrpcInterestRule(i.interest.automatic);
if(i&&(!['','none','pending'].includes(i.otherRubrics)||typeof i.otherRubricsRef!=='string'))throw Error('Âmbito de outras rubricas MRFTA não recuperável.');
if(i&&(i.version!==1||!['','initial','replacement'].includes(i.declaration)||!['','within','late'].includes(i.timing)||!['','yes','no'].includes(i.completeness)||['period','nuit','name','commercialName','taxArea','address','contact','completenessRef'].some(k=>typeof i[k as keyof MrftaInput]!=='string')||!Array.isArray(i.codes)||i.codes.some(c=>!c||['rowId','cer','reference'].some(k=>typeof c[k as keyof typeof c]!=='string'))||new Set(i.codes.map(c=>c.rowId)).size!==i.codes.length||!i.interest||!['','assessment','timely'].includes(i.interest.mode)||['period','amount','reference','date','dueDate','dueReference'].some(k=>typeof i.interest[k as keyof typeof i.interest]!=='string')))throw Error('Preparação MRFTA não recuperável;originais conservados.');
if(b.mrftaResult&&(!b.mrftaResult.model||typeof b.mrftaResult.key!=='string'||!Array.isArray(b.mrftaResult.model.lines)||!Array.isArray(b.mrftaResult.model.pending))||b.mrftaHistory!==undefined&&!Array.isArray(b.mrftaHistory))throw Error('Histórico MRFTA não recuperável.');
}
function rubric(r:IrpcRow,v:IrpcResult){
if(v.nature==='on_account')return r.kind==='rent'?'Taxa normal — Rendimentos prediais':r.kind==='capital'?'Taxa normal — Rendimentos de capitais e mais valias':null;
if(v.nature!=='definitive')return null;
return ({royalty:'IRPC liberatório — Actividade intelectual ou industrial / prestação de informações',equipment:'IRPC liberatório — Uso ou concessão do uso de equipamento',capital:'IRPC liberatório — Aplicação de capitais e rendimentos prediais',services:'IRPC liberatório — Comissões por intermediação de contratos ou prestação de serviços'} as Record<string,string>)[r.kind]??null;
}
function key(b:IrpcBook&MrftaStore,current:boolean){return JSON.stringify(['MRFTA-L5/1',b.result,b.mrfta,current,...(b.mrfta?.interest.mode===''&&b.mrfta?.interest.calculation==='automatic'?[irpcInterestVersion]:[])]);}
export function mrftaCurrent(b:IrpcBook&MrftaStore,current:boolean){return !!b.mrftaResult&&b.mrftaResult.key===key(b,current);}
export function prepareMrfta(b:IrpcBook&MrftaStore,current:boolean):MrftaModel{
validateMrfta(b);const i=b.mrfta??newMrftaInput(),pending:string[]=[],excluded:MrftaModel['excluded']=[],lines:MrftaLine[]=[];
for(const k of Object.keys(labels))if(!String(i[k as keyof MrftaInput]).trim())pending.push('Falta '+labels[k]+'.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(i.period))pending.push('Mês/ano inválido ou fora do recorte2026.');
if(i.nuit&&!/^\d{9}$/.test(i.nuit))pending.push('NUIT deve ter nove algarismos;confira a identidade fiscal.');
if(i.completeness!=='yes'||!i.completenessRef.trim())pending.push('Conferir completude das retenções deste sujeito passivo/período, incluindo os demais livros;este contexto não é automaticamente a declaração completa.');
if(i.otherRubrics!=='none'||!i.otherRubricsRef.trim())pending.push('IRPS,tributação autónoma e outras rubricas fora deste recorte não são zero presumido;documente a ausência de outros valores devidos ou mantenha o total indeterminado.');
if(!current||!b.result)pending.push('Cálculo das retenções desactualizado ou inexistente;guarde o cálculo actual antes da preparação.');
for(const v of b.result?.rows??[]){
const r=b.result!.inputs.find(r=>r.id===v.id);
if(!r){pending.push('Entrada do resultado ausente: '+v.id);continue;}
if(r.direction==='received'){excluded.push({id:r.id,reason:'Retenção sofrida; não é imposto a entregar pelo titular.'});continue;}
if(v.period&&v.period!==i.period){excluded.push({id:r.id,reason:'Outro período: '+v.period});continue;}
if(v.treatment==='dispensed'&&v.status==='calculated'){excluded.push({id:r.id,reason:'Dispensa documentada;sem imposto a transcrever.'});continue;}
if(v.status!=='calculated'||!v.tax||!v.base||v.rate===null||!v.period){pending.push(`${r.documentRef}: rendimento indeterminado;${v.reason}`);continue;}
const name=rubric(r,v);if(!name){pending.push(`${r.documentRef}: rubrica MRFTA por corresponder;categoria digital/especial não copiada para serviços comuns.`);continue;}
const code=i.codes.find(c=>c.rowId===r.id);if(!code?.cer.trim()||!/^\d+$/.test(code.cer.trim())||!code.reference.trim())pending.push(`${r.documentRef}: CER numérico e referência aplicável por identificar;sem código presumido.`);
const cer=code?.cer.trim()??'',line=lines.find(l=>l.rubric===name&&l.rate===v.rate&&l.cer===cer);
const reference=`CER:${code?.reference??''};contraparte:${r.counterparty};qualificação:${r.qualificationRef};benefício:${r.reliefPreparation?.evidence??r.reliefRef};residência fiscal:${r.reliefPreparation?.residenceDocument??''}`;
if(line){line.ids.push(r.id);line.documents.push(r.documentRef);line.references.push(reference);line.base=addFractions([line.base,v.base]);line.tax=addFractions([line.tax,v.tax]);line.paid=line.paid&&v.settled?addFractions([line.paid,v.settled]):null;}
else lines.push({ids:[r.id],documents:[r.documentRef],references:[reference],rubric:name,cer,rate:v.rate,base:v.base,tax:v.tax,paid:v.settled});
}
for(const line of lines)if(lines.some(other=>other!==line&&other.rubric===line.rubric))pending.push(line.rubric+': taxas ou CER distintos na mesma rubrica;conferir transcrição sem fundir taxas nem perder parcelas.');
const principal=addFractions(lines.map(l=>l.tax)),paid=lines.every(l=>l.paid!==null)?addFractions(lines.map(l=>l.paid!)):null;
if(paid===null)pending.push('Valor já pago não reconciliado;pagamento ao fornecedor não é entrega à AT.');
let interest:FiscalFraction|null=null,interestReason='Juros compensatórios indeterminados: taxa aplicável, âmbito e período por resolver;sem MAIBOR2026 nem substituição automática por MIMO/Prime. Juros de mora e tributação autónoma não apurados.';
if(i.interest.mode==='assessment'){
try{const a=decimalFraction(i.interest.amount);if(negative(a)||i.interest.period!==i.period||!i.interest.reference.trim()||!date(i.interest.date)||i.interest.date.slice(0,7)<i.period)throw Error();interest=a;interestReason=`Juros compensatórios transcritos de liquidação documentada:${i.interest.reference};data:${i.interest.date};período:${i.interest.period};montante original em MZN:${i.interest.amount}. Não são juros calculados pelo portal.`;}catch{interestReason='Liquidação de juros incompleta,negativa ou incoerente;identifique montante,data e documento do mesmo período.';}
}else if(i.interest.mode==='timely'){
const ids=lines.flatMap(l=>l.ids),inputs=(b.result?.inputs??[]).filter(r=>ids.includes(r.id));
const dates=inputs.flatMap(r=>r.allocations.map(a=>b.result?.payments.find(p=>p.id===a.paymentId)?.date??''));
if(i.interest.period===i.period&&date(i.interest.dueDate)&&i.interest.dueReference.trim()&&i.interest.reference.trim()&&paid!==null&&isZero(subtractFractions(principal,paid))&&inputs.length>0&&inputs.every(r=>r.settlement==='complete'&&r.allocations.length>0)&&dates.every(d=>date(d)&&d<=i.interest.dueDate)&&i.interest.dueDate>=i.period+'-01'){
interest=zero();interestReason=`Entregas integralmente reconciliadas até ao prazo documentado:${i.interest.dueDate};${i.interest.dueReference};${i.interest.reference}. Sem atraso neste recorte;sem declarar cumprimento global de obrigações.`;
}else interestReason='Ausência de atraso não demonstrada: confira prazo aplicável, comprovativos completos, datas e montante entregue. Sem zero de juros presumido.';
}
let automatic:IrpcInterestCalculation|undefined;
if(i.interest.mode===''&&i.interest.calculation==='automatic'){
if(!i.interest.automatic||i.interest.period!==i.period||!i.interest.reference.trim())interestReason='Cálculo automático sem parâmetros/ocorrência e período documentados;juros continuam indeterminados.';
else{automatic=calculateIrpcInterest(b,current,i.period,i.interest.dueDate,i.interest.dueReference,i.interest.date,i.interest.automatic);interest=automatic.total;interestReason=automatic.pending.length?automatic.pending.join(' | '):'Juros calculados por parâmetros documentados deste caso — simulação pelos pressupostos introduzidos, sem confirmação fiscal;sem taxa fiscal2026 pré-definida. Taxa anual:'+automatic.rule.annualRate+'%;fonte:'+automatic.rule.rateSource+';fundamento:'+automatic.rule.fiscalBasis+';vigência:'+automatic.rule.validFrom+'–'+automatic.rule.validTo+';base anual:'+(automatic.rule.dayBasis==='actual_year'?'dias efectivos de cada ano':automatic.rule.dayBasis+' dias')+';fonte:'+automatic.rule.dayBasisRef+';arredondamento do total aos cêntimos:'+(automatic.rule.rounding==='total_cent_half_up'?'metade por excesso':'por defeito')+';fonte:'+automatic.rule.roundingRef+';ocorrência:'+automatic.rule.occurrenceRef+';'+automatic.rows.map(r=>r.document+':'+r.segments.map(s=>s.from+'–'+s.to+':'+s.days+'dias/'+s.denominator+';principal '+money(s.principal)+';juros '+money(s.interest)).join(',')).join(' | ');}
}
if(!interest)pending.push(interestReason);
let total:FiscalFraction|null=null;
if(pending.length===0&&interest&&paid){const balance=subtractFractions(addFractions([principal,interest]),paid);if(negative(balance))pending.push('Valor já pago excede imposto e juros;reconcilie sem crédito/reembolso automático.');else total=balance;}
return {...(automatic?{automatic}:{}),period:i.period,input:structuredClone(i),lines,excluded,pending:[...new Set(pending)],principal,paid,interest,total,interestReason,source:mrftaSource};
}
export function recordMrfta(b:IrpcBook&MrftaStore,current:boolean,now=new Date().toISOString()):IrpcBook&MrftaStore{
const model=prepareMrfta(b,current);return{...b,mrftaHistory:b.mrftaResult?[...(b.mrftaHistory??[]),structuredClone(b.mrftaResult)]:b.mrftaHistory??[],mrftaResult:{key:key(b,current),createdAt:now,model}};
}
const money=(f:FiscalFraction|null)=>{if(!f)return'Indeterminado';const p=fractionPresentation(f);return(p.approximate?'≈':'')+p.decimal+' MZN';};
export function mrftaReportRows(b:IrpcBook&MrftaStore,current:boolean):Array<[string,string,string,string]>{
const r=b.mrftaResult;if(!r)return[];const m=r.model;return[['IRPC — retenções','MRFTA — '+m.period,`Subtotal das retenções correspondidas:${money(m.principal)};juros:${money(m.interest)};valor já pago:${money(m.paid)};total a pagar:${money(m.total)};${m.interestReason};pendências:${m.pending.join(' | ')}`,`${mrftaCurrent(b,current)?'Preparação correspondente':'Histórico;preparação desactualizada'};${r.createdAt};completude:${m.input.completenessRef};outras rubricas:${m.input.otherRubricsRef};${m.source}`],...m.lines.map(l=>['IRPC — retenções',l.rubric,`${l.documents.join(';')};base:${money(l.base)};taxa:${l.rate}%;imposto:${money(l.tax)};CER:${l.cer||'por corresponder'};código introduzido,sem validação por catálogo oficial`,`Período:${m.period};apenas rendimento pago;sem assinatura ou uso dos serviços;documentos:${l.ids.join(',')};suporte:${l.references.join(' | ')}`] as [string,string,string,string])];
}
export function mrftaHtml(b:IrpcBook&MrftaStore,current:boolean):string{
if(!current||!mrftaCurrent(b,current))throw Error('Calcule as retenções e prepare o MRFTA com as entradas actuais antes de exportar.');
const m=b.mrftaResult!.model,esc=(v:unknown)=>String(v).replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]!));
return `<!doctype html><html lang="pt"><meta charset="utf-8"><title>MRFTA — preparação</title><body><h1>MRFTA — preenchimento de preparação</h1><p>Quadro1:retenção na fonte;${esc(m.input.declaration==='initial'?'Inicial':m.input.declaration==='replacement'?'Substituição':'Tipo por identificar')}. Quadro2:${esc(m.period)};${esc(m.input.timing==='within'?'Dentro do prazo':m.input.timing==='late'?'Fora do prazo':'Prazo por identificar')}.</p><p>Quadro3 NUIT:${esc(m.input.nuit)};área fiscal:${esc(m.input.taxArea)}. Quadro4:${esc(m.input.name)}. Quadro5:${esc(m.input.commercialName)}. Quadro6:${esc(m.input.address)};${esc(m.input.contact)}.</p><p>Conferência do período:${esc(m.input.completenessRef)}. Outras rubricas:${esc(m.input.otherRubricsRef)}.</p><p>CER introduzidos com referência do caso; sem validação automática por catálogo oficial. Códigos provisórios ou de simulação não são correspondências oficiais.</p><h2>Quadro7</h2><table><thead><tr><th>CER</th><th>Rubrica</th><th>Base</th><th>Taxa</th><th>Imposto</th><th>Documentos</th></tr></thead><tbody>${m.lines.map(l=>`<tr><td>${esc(l.cer||'Por corresponder')}</td><td>${esc(l.rubric)}</td><td>${esc(money(l.base))}</td><td>${l.rate}%</td><td>${esc(money(l.tax))}</td><td>${esc(l.documents.join(';')+';'+l.references.join(' | '))}</td></tr>`).join('')}</tbody></table><p>Subtotal correspondido:${esc(money(m.principal))};JUROS COMPENSATÓRIOS:${esc(money(m.interest))};VALOR JÁ PAGO:${esc(money(m.paid))};TOTAL A PAGAR:${esc(money(m.total))}.</p><p>${esc(m.interestReason)}</p><h2>Casos pendentes</h2><ul>${m.pending.map(p=>'<li>'+esc(p)+'</li>').join('')}</ul><h2>Casos separados</h2><ul>${m.excluded.map(p=>'<li>'+esc(p.id+':'+p.reason)+'</li>').join('')}</ul><p>Quadros8/9 reservados,sem assinatura,carimbo,número de entrada ou aceitação AT. Tributação autónoma e juros de mora não apurados. Este documento de preparação não substitui o original oficial nem submete uma declaração.</p><small>${esc(m.source)}</small></body></html>`;
}
@@ -0,0 +1,20 @@
import {fraction,type FiscalFraction} from './fiscal-rational.ts';
export const normalAssessmentVersion='IRPC-normal-adjustments/4';
export type NormalAssessmentInput={version:1;treatment:''|'general_61_1'|'other';reference:string};
export const newNormalAssessmentInput=():NormalAssessmentInput=>({version:1,treatment:'',reference:''});
export function validateNormalAssessment(i:NormalAssessmentInput){if(!i||i.version!==1||!['','general_61_1','other'].includes(i.treatment)||typeof i.reference!=='string')throw Error('Enquadramento da colecta não recuperável;original conservado.');}
export type NormalAssessmentModel={input:NormalAssessmentInput;period:{year:string;from:string;to:string};classification:string;rate:FiscalFraction|null;taxableBase:FiscalFraction|null;colecta:FiscalFraction|null;centExact:boolean|null;pending:string[];rule:string;source:string;finalBalance:{scope:'L8';status:'not_calculated';payable:null;recoverable:null;reason:string}};
export function calculateNormalAssessment(input:NormalAssessmentInput,base:FiscalFraction|null,context:{year:string;scope:string;currency:string;extended?:boolean;short?:boolean;period?:{from:string;to:string}}):NormalAssessmentModel{
validateNormalAssessment(input);const pending:string[]=[],period={year:context.year,from:/^20\d{2}$/.test(context.year)?context.year+'-01-01':'',to:/^20\d{2}$/.test(context.year)?context.year+'-12-31':''};
if(context.year!=='2026')pending.push('Taxa geral correspondida neste incremento apenas ao exercício2026;sem taxa transportada para outro período.');
if(!(context.scope==='resident_general'||context.extended&&context.scope==='ep_general')||context.currency!=='MZN')pending.push('Colecta delimitada ao sujeito residente no regime geral emMZN;outros âmbitos por corresponder.');
if(input.treatment!=='general_61_1')pending.push(input.treatment==='other'?'Benefício,taxa reduzida,tributação autónoma ou outro caso especial:tratamento próprio;sem taxa geral aplicada por aproximação.':'Enquadramento da taxa geral por identificar;sem escolha presumida.');
if(!input.reference.trim())pending.push('Identifique suporte ou pressuposto da aplicação da taxa geral ao caso;uma actividade semelhante não prova o regime.');
if(base===null)pending.push('Matéria colectável actual indeterminada;lucro tributável não é substituto da base.');
else if(!/^-?\d{1,80}$/.test(base.numerator)||!/^\d{1,80}$/.test(base.denominator)||BigInt(base.denominator)===0n||BigInt(base.numerator)<0n)pending.push('Matéria colectável deve ser um valor conhecido não negativo e reconciliado.');
if(context.period){period.from=context.period.from;period.to=context.period.to;const start=new Date(period.from+'T00:00:00Z'),end=new Date(period.to+'T00:00:00Z');if(!Number.isFinite(+start)||!Number.isFinite(+end)||start.toISOString().slice(0,10)!==period.from||end.toISOString().slice(0,10)!==period.to||!period.from.endsWith('-01')||!period.to.startsWith('2026-'))pending.push('Período fiscal anual não reconciliado.');else if(context.short){if(period.from>period.to||!period.from.startsWith('2026-')||period.from===context.year+'-01-01'&&period.to===context.year+'-12-31')pending.push('Período curto por reconciliar.');}else{start.setUTCFullYear(start.getUTCFullYear()+1);start.setUTCDate(start.getUTCDate()-1);if(start.toISOString().slice(0,10)!==period.to)pending.push('Colecta anual: período de12 meses por reconciliar.');}}
const rate=input.treatment==='general_61_1'&&context.year==='2026'?fraction(32n):null;
const colecta=pending.length===0&&base!==null&&rate?fraction(BigInt(base.numerator)*32n,BigInt(base.denominator)*100n):null;
return{input:structuredClone(input),period,classification:input.treatment==='general_61_1'?'Regime normal — taxa geral do artigo61(1)':input.treatment==='other'?'Caso especial fora deste recorte':'Enquadramento por identificar',rate,taxableBase:base,colecta,centExact:colecta?(BigInt(colecta.numerator)*100n)%BigInt(colecta.denominator)===0n:null,pending,rule:'CIRPC61(1)-general-2026/1',source:context.short?'CIRPC7(4)/61(1):período curto documentado em2026,matéria colectável efectiva ×32%;sem anualizar lucro/base ou proporcionalizar a taxa;saldo finalL8 indeterminado.':context.extended?'CIRPC61(1), taxa geral32% mantida pelos diplomas inventariados até Lei12/2025; período anual documentado com termo em2026. CIRPC15(1)a/c,7(1–3): sujeito residente ou resultado imputável aEP no regime geral; ano civil, autorização ou comunicação expressamente identificadas. Sem arredondamento fiscal ou saldoL8 presumidos.':'CIRPC Lei34/2007 art61(1),PDF17/p768(71):taxa geral32%. Lei4/2012 altera61(2);Lei20/2022 PDF1/p2731 mantém61(1),altera61(2) com termo31/12/2025;Lei12/2025 PDF18/20 não altera61(1),adita61-A para mais-valias,fora deste recorte. Exercício anual2026/MZN/residente geral,matéria colectável actual×32/100 em aritmética racional exacta. Sem arredondamento fiscal ou transcriçãoM20/M22 presumidos.',finalBalance:{scope:'L8',status:'not_calculated',payable:null,recoverable:null,reason:'Saldo final a pagar ou recuperar por determinar emL8:retenções,pagamentos e créditos do fecho anual não apurados nem abatidos à colecta neste incremento. Colecta não equivale ao saldo final.'}};
}
+58
View File
@@ -0,0 +1,58 @@
import {addFractions,decimalFraction,fraction,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
import type {ProfitEvidence} from './irpc-normal-profit.ts';
export const normalBaseVersion='IRPC-normal-adjustments/3';
type Choice=''|'yes'|'no';
export type NormalLoss={id:string;year:string;subjectNuit:string;assessed:string;previouslyUsed:string;requested:string;reference:string;kind:''|'ordinary'|'transfer'|'other';annualPeriods:Choice;generalActivity:Choice;balanceConfirmed:Choice};
export type NormalBaseInput={version:1;subjectNuit:string;identityReference:string;method:''|'direct'|'indirect';methodReference:string;lossesState:''|'known'|'absent';lossesReference:string;unchangedObject:Choice;objectReference:string;losses:NormalLoss[];benefits:ProfitEvidence};
export const newNormalBaseInput=():NormalBaseInput=>({version:1,subjectNuit:'',identityReference:'',method:'',methodReference:'',lossesState:'',lossesReference:'',unchangedObject:'',objectReference:'',losses:[],benefits:{state:'',amount:'',reference:''}});
export const newNormalLoss=(id:string):NormalLoss=>({id,year:'',subjectNuit:'',assessed:'',previouslyUsed:'',requested:'',reference:'',kind:'',annualPeriods:'',generalActivity:'',balanceConfirmed:''});
export function validateNormalBase(i:NormalBaseInput){
if(!i||i.version!==1||['subjectNuit','identityReference','methodReference','lossesReference','objectReference'].some(k=>typeof i[k as 'subjectNuit']!=='string')||!['','direct','indirect'].includes(i.method)||!['','known','absent'].includes(i.lossesState)||!['','yes','no'].includes(i.unchangedObject)||!Array.isArray(i.losses)||new Set(i.losses.map(l=>l.id)).size!==i.losses.length||!i.benefits||!['','known','absent'].includes(i.benefits.state)||typeof i.benefits.amount!=='string'||typeof i.benefits.reference!=='string')throw Error('Preparação da matéria colectável não recuperável.');
for(const l of i.losses)if(!l||Object.keys(newNormalLoss('')).some(k=>typeof l[k as keyof NormalLoss]!=='string')||!['','ordinary','transfer','other'].includes(l.kind)||['annualPeriods','generalActivity','balanceConfirmed'].some(k=>!['','yes','no'].includes(l[k as 'annualPeriods'])))throw Error('Perda fiscal não recuperável;originais conservados.');
}
export type NormalBaseModel={input:NormalBaseInput;taxableProfit:FiscalFraction|null;requestedLosses:FiscalFraction;deductedLosses:FiscalFraction|null;benefitDeduction:FiscalFraction|null;taxableBase:FiscalFraction|null;losses:Array<NormalLoss&{available:FiscalFraction|null;requestedAmount:FiscalFraction|null;deducted:FiscalFraction|null;remaining:FiscalFraction|null;lastOrdinaryYear:number|null;status:'eligible'|'excluded'|'indeterminate';reason:string}>;pending:string[];source:string};
const zero=()=>fraction(0n);
function amount(s:string){if(!/^\d{1,18}(?:\.\d{1,2})?$/.test(s))throw Error();return decimalFraction(s);}
const units=(f:FiscalFraction)=>BigInt(f.numerator)*100n/BigInt(f.denominator);
export function calculateNormalBase(input:NormalBaseInput,profit:FiscalFraction|null,year:string,currentLossReference?:string,short=false):NormalBaseModel{
validateNormalBase(input);const i=structuredClone(input),pending:string[]=[],losses:NormalBaseModel['losses']=[];
if(year!=='2026')pending.push('Matéria colectável delimitada ao exercício2026.');
if(!/^\d{9}$/.test(i.subjectNuit)||!i.identityReference.trim())pending.push('Identifique NUIT e suporte do sujeito passivo do lucro e das perdas.');
if(i.method!=='direct'||!i.methodReference.trim())pending.push('Método declarativo/directo e suporte por identificar;apuramento indirecto fora deste recorte (15(2),41(2)).');
if(!profit)pending.push('Lucro tributável actual indeterminado;nenhuma dedução transforma informação em falta em zero.');
else if(BigInt(profit.numerator)<0n&&!currentLossReference?.trim())pending.push('Resultado fiscal negativo conhecido;tratamento da perda do próprio exercício fora deste recorte,sem matéria colectável zero ou reporte automático.');
if(!i.lossesState||!i.lossesReference.trim())pending.push('Situação e completude das perdas anteriores em falta;sem ausência presumida.');
if(i.lossesState==='absent'&&i.losses.length)pending.push('Ausência declarada de perdas contradiz os registos existentes;reconcilie sem apagar histórico.');
if(i.lossesState==='known'&&!i.losses.length)pending.push('Perdas declaradas conhecidas sem discriminação por exercício.');
if(i.losses.some(l=>!/^20\d{2}$/.test(l.year)||Number(l.year)+5>=Number(year))&&(!i.unchangedObject||!i.objectReference.trim()))pending.push('Documente manutenção ou alteração do objecto/natureza da actividade no termo do exercício (41(7)).');
for(const l of i.losses){const r:NormalBaseModel['losses'][number]={...l,available:null,requestedAmount:null,deducted:null,remaining:null,lastOrdinaryYear:null,status:'indeterminate',reason:''};const issues:string[]=[];
if(!l.reference.trim())issues.push('Documento de apuramento/saldo fiscal por identificar.');
if(l.subjectNuit!==i.subjectNuit||!/^\d{9}$/.test(l.subjectNuit))issues.push('Perda não reconciliada com o mesmo sujeito passivo.');
if(!/^20\d{2}$/.test(l.year)||Number(l.year)>=Number(year))issues.push('Exercício da perda deve ser anterior ao exercício de utilização;perda actual não é dedução a si própria.');
if(i.losses.some(q=>q.id!==l.id&&q.year===l.year&&q.subjectNuit===l.subjectNuit))issues.push('Saldo anual duplicado;reconcilie um saldo por sujeito/exercício.');
if(l.kind!=='ordinary')issues.push('Transmissão/fusão ou outra origem exige correspondência própria;sem aplicação automática de41-A.');
if(l.annualPeriods!=='yes')issues.push('Contagem por exercícios anuais ordinários não demonstrada;períodos especiais/curtos (41(5)) fora deste recorte.');
if(l.generalActivity!=='yes')issues.push('Origem no regime geral,fora de transparência/isenção parcial ou actividade com redução,por demonstrar (41(4/6)).');
if(l.balanceConfirmed!=='yes')issues.push('Saldo fiscal corrigido e utilizações anteriores por reconciliar (41(3));não usar perda contabilística como fiscal.');
try{const assessed=amount(l.assessed),used=amount(l.previouslyUsed);if(units(used)>units(assessed))throw Error();r.available=subtractFractions(assessed,used);}catch{issues.push('Apuramento fiscal e utilização anterior devem ser montantes conhecidos não negativos e coerentes.');}
try{r.requestedAmount=amount(l.requested);if(r.available&&units(r.requestedAmount)>units(r.available))issues.push('Utilização proposta excede saldo fiscal disponível.');}catch{issues.push('Identifique utilização proposta,não negativa,mesmo quando zero.');}
if(l.annualPeriods==='yes'&&/^20\d{2}$/.test(l.year))r.lastOrdinaryYear=Number(l.year)+5;
if(!issues.length){if((r.lastOrdinaryYear!<Number(year))||i.unchangedObject==='no'){
r.status='excluded';r.reason=r.lastOrdinaryYear!<Number(year)?'Prazo dos cinco exercícios ordinários posteriores expirado (41(1));saldo não utilizável neste exercício.':'Objecto/natureza alterados conforme declaração;dedução41(1)não aplicável (41(7)).';
if(units(r.requestedAmount!)!==0n)issues.push('Perda excluída com utilização positiva proposta;corrija a proposta sem dedução presumida.');
}else{r.status='eligible';r.reason='Saldo fiscal ordinário documentado,mesmo sujeito,cinco exercícios posteriores;utilização escolhida explicitamente,sem ordemFIFO ou percentagem presumida.';}}
if(issues.length){r.status='indeterminate';r.reason=issues.join(' ');pending.push(l.year+': '+r.reason);}
losses.push(r);
}
if(short&&losses.some(l=>l.requestedAmount&&BigInt(l.requestedAmount.numerator)>0n))pending.push('Período curto:sequência dos períodos posteriores por reconciliar;41(5) exclui da contagem o período de transição7(4)d inferior a6meses,sem agregar todos os períodos curtos ou presumir prazo por ano civil.');
const requestedLosses=addFractions(losses.filter(l=>l.status==='eligible').map(l=>l.requestedAmount!));
if(profit&&BigInt(requestedLosses.numerator)*BigInt(profit.denominator)>(BigInt(profit.numerator)>0n?BigInt(profit.numerator)*BigInt(requestedLosses.denominator):0n))pending.push('Utilizações propostas excedem o lucro tributável disponível;reparta explicitamente sem criar base negativa ou escolher uma ordem de perdas.');
let benefitDeduction:FiscalFraction|null=null;const benefit=i.benefits;
if(!benefit.state||!benefit.reference.trim())pending.push('Benefícios/deduções à matéria colectável por identificar (15(4));créditos à colecta e retenções não são esta dedução.');
else if(benefit.state==='absent'){if(benefit.amount.trim())pending.push('Ausência de benefícios contradiz montante preenchido.');else benefitDeduction=zero();}
else{try{const value=amount(benefit.amount);if(units(value)!==0n)pending.push('Benefício de montante conhecido:regra,condições,limite e ordem próprios por implementar;sem subtracção livre do valor.');else benefitDeduction=value;}catch{pending.push('Montante conhecido das deduções por preencher ou inválido.');}}
const ready=pending.length===0&&profit!==null,deductedLosses=ready?requestedLosses:null,taxableBase=ready?subtractFractions(subtractFractions(BigInt(profit!.numerator)<0n?zero():profit!,requestedLosses),benefitDeduction!):null;
for(const l of losses){if(l.available){l.deducted=ready?(l.status==='eligible'?l.requestedAmount!:zero()):null;l.remaining=l.deducted?subtractFractions(l.available,l.deducted):null;}}
return{input:i,taxableProfit:profit,requestedLosses,deductedLosses,benefitDeduction,taxableBase,losses,pending,source:'CIRPC15(1)a/15(2–4),41(1–7),Lei34/2007 PDF5/p768(59),PDF12/p768(66). Recorte2026,residente geral,método declarativo,perdas próprias em exercícios anuais ordinários;cinco exercícios posteriores,sem transferência41-A,regimes especiais ou benefícios positivos implementados. Pedido de utilização expresso e limitado ao saldo/lucro;semFIFO obrigatório ou limite percentual inventado. Matéria colectável simulada,não colecta/imposto a pagar,semM20/M22/submissão ou consumo persistente do saldo oficial.'};
}
+82
View File
@@ -0,0 +1,82 @@
import {addFractions,fraction,subtractFractions,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
import {fiscalMoney} from './irpc-normal-schedules.ts';
export const normalCostsVersion='IRPC-normal-adjustments/6';
export const costRules={
allowance:['Ajudas de custo/deslocação em viatura própria','expenseCorrections','36(1)e'],
representation:['Despesas de representação','expenseCorrections','36(1)f/36(3)'],
advertising:['Publicidade ordinária — limite anual partilhado','expenseCorrections','36(1)n,Lei20/2009'],
vehicle:['Outros encargos com viatura ligeira de passageiros','expenseCorrections','36(4)'],
fuel:['Combustível — prova do activo/locação e consumo normal','expenseCorrections','36(1)i/36(4)'],
rental:['Aluguer sem condutor — parcela de quota não aceite documentada','expenseCorrections','36(1)h/36(4)'],
credit:['Provisão/perda por imparidade de créditos ordinários','expenseCorrections','28(1)a/29'],
stock:['Provisão/perda por imparidade de existências','expenseCorrections','28(1)b'],
litigation:['Provisão para processo judicial em curso','expenseCorrections','28(1)c'],
provision_reversal:['Reversão de provisão antes deduzida','incomeCorrections','28(2)'],
taxed_reversal:['Reversão contabilística de provisão antes tributada','incomeCorrections','17/28;sem dupla tributação da parcela comprovada'],
prior_cost:['Custo de exercício anterior incluído no resultado actual','timing','18(2)'],
prior_income:['Proveito de exercício anterior incluído no resultado actual','timing','18(2)'],
estimated_work_loss:['Perda estimada em obra plurianual em curso','expenseCorrections','36(1)m,Lei20/2009'],
work:['Resultado de obra plurianual — percentagem/encerramento','timing','19(1–6)'],
}as const;
export type CostRule=keyof typeof costRules;
export type CostRow={id:string;rule:''|CostRule;document:string;line:string;amount:string;sourceCode:string;reference:string;conditions:''|'yes';facts:Record<string,string>};
export type NormalCostsInput={version:1;rows:CostRow[];advertisingReference:string;salesOrdinary:''|'yes';creditBase:string;creditPrevious:string;creditReference:string;creditRegime:''|'ordinary'|'regulated'};
export const newNormalCosts=():NormalCostsInput=>({version:1,rows:[],advertisingReference:'',salesOrdinary:'',creditBase:'',creditPrevious:'',creditReference:'',creditRegime:''});
export const newCostRow=(id:string):CostRow=>({id,rule:'',document:'',line:'',amount:'',sourceCode:'',reference:'',conditions:'',facts:{}});
export function validateNormalCosts(i:NormalCostsInput){
if(!i||i.version!==1||!Array.isArray(i.rows)||['advertisingReference','creditBase','creditPrevious','creditReference'].some(k=>typeof i[k as 'creditBase']!=='string')||!['','yes'].includes(i.salesOrdinary)||!['','ordinary','regulated'].includes(i.creditRegime))throw Error('Mapa de custos/provisões/periodização não recuperável.');
if(new Set(i.rows.map(r=>r.id)).size!==i.rows.length)throw Error('Identificador repetido no mapa de custos.');
for(const r of i.rows)if(!r||['id','rule','document','line','amount','sourceCode','reference','conditions'].some(k=>typeof r[k as 'id']!=='string')||r.rule!==''&&!Object.hasOwn(costRules,r.rule)||!['','yes'].includes(r.conditions)||!r.facts||typeof r.facts!=='object'||Array.isArray(r.facts)||Object.values(r.facts).some(v=>typeof v!=='string'))throw Error('Linha de custos/provisões/periodização não recuperável.');
}
type Source={currency:string;accountingLines:Array<{code:string;total:string;accountingEffect:string}>;cashSchedule?:Array<{salesReceivablesBalance:string|null;openingReceivablesBalance:string}>};
export type CostClaim={document:string;line:string;sourceCode:string;amount:string};
const z=()=>fraction(0n),cmp=(a:FiscalFraction,b:FiscalFraction)=>BigInt(a.numerator)*BigInt(b.denominator)-BigInt(b.numerator)*BigInt(a.denominator);
const mul=(a:FiscalFraction,n:bigint,d=1n)=>fraction(BigInt(a.numerator)*n,BigInt(a.denominator)*d);
const min=(...v:FiscalFraction[])=>v.reduce((a,b)=>cmp(a,b)<0n?a:b),max0=(v:FiscalFraction)=>cmp(v,z())<0n?z():v;
const costMoney=(v:FiscalFraction|null)=>{if(!v)return'Indeterminado';const p=fractionPresentation(v);return(p.approximate?'≈':'')+p.decimal+' MZN'+(p.approximate?' (exacto '+v.numerator+'/'+v.denominator+')':'');};
const identity=(r:{document:string;line:string})=>r.document.trim()+'\u0000'+r.line.trim();
export function reusableCreditBalance(source:Source|null){const l=source?.cashSchedule?.at(-1);if(!l||l.salesReceivablesBalance===null)return null;try{return addFractions([fiscalMoney(l.salesReceivablesBalance),fiscalMoney(l.openingReceivablesBalance)]);}catch{return null;}}
export function calculateNormalCosts(input:NormalCostsInput,source:Source|null,existing:CostClaim[],period:{from:string;to:string},short=false){
validateNormalCosts(input);const rows=input.rows,claims=rows.flatMap(r=>[{...r},...(r.rule==='work'?[{id:r.id,document:r.document,line:r.line+'/custos',sourceCode:r.facts.costSource??'',amount:r.facts.bookCost??''}]:[])]),pending:string[]=[];
const sourceAmount=(code:string,effect:string)=>{const l=source?.accountingLines.find(l=>l.code===code);if(!l||l.accountingEffect!==effect)throw Error('Seleccione uma linha contabilística compatível.');return fiscalMoney(l.total);};
const pool=(rule:CostRule)=>addFractions(rows.filter(r=>r.rule===rule).map(r=>fiscalMoney(r.amount)));
const pools:Record<string,{label:string;base:FiscalFraction;previous:FiscalFraction|null;annualLimit:FiscalFraction;accumulatedLimit:FiscalFraction|null;reference:string}>={};
const results=rows.map(r=>{const issues:string[]=[],rule=r.rule?costRules[r.rule]:null,topic=rule?.[1]??'',f=r.facts;let amount:FiscalFraction|null=null,accepted:FiscalFraction|null=null,adjustment:FiscalFraction|null=null,limit:FiscalFraction|null=null;const details:string[]=[];
const a=(key:string)=>{if(!f[key]?.trim())throw Error('Falta parâmetro: '+(factLabels[key]??key));return fiscalMoney(f[key]);};
const yesno=(key:string)=>{if(!['yes','no'].includes(f[key]))throw Error('Falta condição documentada: '+(factLabels[key]??key));return f[key]==='yes';};
const ref=(key:string)=>{if(!f[key]?.trim())throw Error('Falta suporte: '+(factLabels[key]??key));};
const balance=()=>{ref('balanceKey');if(rows.some(q=>q!==r&&q.facts.balanceKey===f.balanceKey))throw Error('Saldo/objecto fiscal repetido entre linhas; agregue as parcelas no mesmo mapa para não reutilizar o limite.');return a('previous');};
const checkOrigin=(code:string,value:FiscalFraction,effect:string)=>{if(cmp(value,z())===0n&&!code)return;if(['depreciation','interest_expense'].includes(code))throw Error('Parcela de amortização/juros exige reconciliação própria com o mapa existente; sem dupla qualificação neste incremento.');const total=sourceAmount(code,effect);const allocated=addFractions([...existing,...claims].filter(c=>c.sourceCode===code).map(c=>fiscalMoney(c.amount)));if(cmp(allocated,total)>0n)throw Error('Parcelas dos mapas excedem a linha de origem; reconcilie sem duplicar ajustamentos.');};
if(!rule||!r.document.trim()||!r.line.trim()||!r.reference.trim()||r.conditions!=='yes')issues.push('Regra, documento/linha, condições e suporte em falta.');
if([...existing,...claims.filter(c=>c!==r&&c.id!==r.id)].some(c=>identity(c)===identity(r)))issues.push('Documento/linha repetidos entre mapas.');
if(claims.filter(c=>identity(c)===identity(r)).length>1)issues.push('Documento/linha repetidos no mapa.');
if(short&&['credit','advertising'].includes(r.rule))issues.push('Limite anual neste período curto por corresponder;sem proporcionalização ou anualização presumida.');
if(source?.currency!=='MZN'||!period.to.startsWith('2026-'))issues.push('Recorte anual emMZN com termo em2026 por reconciliar.');
try{amount=fiscalMoney(r.amount);if(cmp(amount,z())<=0n&&r.rule!=='work')throw Error('Identifique parcela positiva conhecida.');
const isIncome=['provision_reversal','taxed_reversal','prior_income','work'].includes(r.rule);const omitted=r.rule==='provision_reversal'&&f.inResult==='no';if(!omitted)checkOrigin(r.sourceCode,amount,isIncome?'income':'expense');else if(r.sourceCode)throw Error('Reversão não incluída no resultado não deve repetir uma linha de proveitos.');
switch(r.rule){
case 'allowance':{const billed=a('billed'),taxed=a('taxedNotBilled');if(cmp(addFractions([billed,taxed]),amount)>0n)throw Error('Parcelas facturadas e tributadas emIRPS não podem sobrepor-se ou exceder o encargo.');const limited=subtractFractions(subtractFractions(amount,billed),taxed);adjustment=mul(limited,1n,2n);accepted=subtractFractions(amount,adjustment);limit=mul(limited,1n,2n);details.push('50% só da parcela não facturada a clientes nem tributada emIRPS; parcelas mutuamente exclusivas.');break;}
case 'representation':accepted=mul(amount,1n,5n);adjustment=subtractFractions(amount,accepted);details.push('20% aceite;80% acrescido. Eventual tributação autónoma não calculada, âmbitoL7.');break;
case 'advertising':{if(f.campaign!=='no')throw Error('Campanha de lançamento com horizonte superior a um ano: periodização36-A e articulação do limite não correspondidas; não tratar como publicidade ordinária.');if(input.salesOrdinary!=='yes'||!input.advertisingReference.trim())throw Error('Confirme completude da publicidade e correspondência do volume de vendas normal do exercício à receita declarada.');const total=pool('advertising');limit=mul(sourceAmount('revenue','income'),1n,100n);pools.advertising={label:'Publicidade — limite anual partilhado',base:sourceAmount('revenue','income'),previous:null,annualLimit:limit,accumulatedLimit:null,reference:input.advertisingReference};const eligible=min(total,limit);accepted=fraction(BigInt(amount.numerator)*BigInt(eligible.numerator)*BigInt(total.denominator),BigInt(amount.denominator)*BigInt(eligible.denominator)*BigInt(total.numerator));adjustment=subtractFractions(amount,accepted);details.push('Limite único anual1% das vendas normais; repartição aritmética proporcional entre parcelas para a simulação, sem ordem fiscal obrigatória.');break;}
case 'vehicle':{if(!yesno('passenger')){accepted=amount;details.push('Viatura fora da categoria ligeira de passageiros;36(4)não aplicado, restantes condições ordinárias documentadas.');}else{accepted=yesno('publicOrRental')?amount:mul(amount,1n,2n);details.push('50% dos outros encargos de passageiros, excepto serviço público de transportes/locação na actividade normal; não inclui quotas, aluguer sem condutor ou combustível já discriminados.');}adjustment=subtractFractions(amount,accepted);break;}
case 'fuel':case 'rental':{let eligible:FiscalFraction;if(r.rule==='fuel'){eligible=a('supportedNormal');if(cmp(eligible,amount)>0n)throw Error('Consumo normal comprovado excede o encargo.');details.push('36i: parcela ligada a activo próprio/locado e consumo normal comprovados.');}else{const excluded=a('nonAcceptedQuota');ref('quotaReference');if(cmp(excluded,amount)>0n)throw Error('Parcela de quota não aceite excede a renda.');eligible=subtractFractions(amount,excluded);details.push('36h: reutiliza parcela de quota não aceite documentada; o portal não apura automaticamente essa quota de viatura.');}if(yesno('passenger')&&!yesno('publicOrRental')){if(cmp(eligible,amount)!==0n)throw Error('Articulação da parcela excluída por36h/i com os50% de36(4) ainda não correspondida; este caso combinado fica pendente, sem somar nem repartir correcções por presunção.');eligible=mul(eligible,1n,2n);details.push('36(4):50% do encargo; sem parcela excluída concorrente porh/i.');}accepted=eligible;adjustment=subtractFractions(amount,accepted);break;}
case 'credit':{if(input.creditRegime!=='ordinary')throw Error('Regime das provisões por identificar ou sujeito a supervisão financeira/seguradora28d; sem limites29 aplicados por aproximação.');if(!input.creditReference.trim())throw Error('Saldo de créditos ordinários e provisão fiscal anterior por documentar.');if(!input.creditBase.trim())throw Error('Créditos ordinários existentes no fim do exercício em falta.');if(!input.creditPrevious.trim())throw Error('Provisão fiscal anterior dos créditos em falta; não presumir zero.');const base=fiscalMoney(input.creditBase),previous=fiscalMoney(input.creditPrevious),total=pool('credit'),annual=mul(base,15n,1000n),accumulated=mul(base,6n,100n);pools.credit={label:'Créditos — limites anual e acumulado',base,previous,annualLimit:annual,accumulatedLimit:accumulated,reference:input.creditReference};if(cmp(previous,accumulated)>0n)throw Error('Provisão fiscal anterior excede6% dos créditos finais; reconcilie subsistência/reversão28(2), sem saldo presumido.');limit=min(annual,subtractFractions(accumulated,previous));const eligible=min(total,limit);accepted=fraction(BigInt(amount.numerator)*BigInt(eligible.numerator)*BigInt(total.denominator),BigInt(amount.denominator)*BigInt(eligible.denominator)*BigInt(total.numerator));adjustment=subtractFractions(amount,accepted);details.push('29:1,5% anual,6% acumulado sobre créditos da actividade normal existentes no fim; saldo fiscal anterior conhecido. Repartição proporcional do limite único, sem consumir saldo oficial.');break;}
case 'stock':case 'litigation':{let previous:FiscalFraction;if(r.rule==='litigation'){if(!yesno('caseOngoing')){accepted=z();adjustment=amount;details.push('Não há processo judicial em curso; provisão não elegível por28c.');break;}if(!yesno('chargeDeductible')){accepted=z();adjustment=amount;details.push('Obrigação não daria lugar a custo dedutível; provisão não aceite por28c.');break;}}else if(!yesno('lossObserved')){accepted=z();adjustment=amount;details.push('Perda de valor não efectivamente observada; estimativa não aceite por28b.');break;}previous=balance();limit=a(r.rule==='stock'?'observedLoss':'obligation');if(cmp(previous,limit)>0n)throw Error('Saldo fiscal anterior excede a cobertura actual; reconcilie a reversão28(2).');accepted=min(amount,subtractFractions(limit,previous));adjustment=subtractFractions(amount,accepted);details.push(r.rule==='stock'?'28b:limite das perdas efectivamente observadas, incluindo saldo anterior.':'28c:obrigações de processo judicial em curso que seriam custos dedutíveis, com saldo anterior reconciliado.');break;}
case 'provision_reversal':case 'taxed_reversal':{const previous=balance();if(cmp(amount,previous)>0n)throw Error('Reversão excede a parcela fiscal anterior demonstrada.');if(!yesno('eventEnded'))throw Error('Evento não cessou/não houve utilização diferente; fundamento da reversão por corresponder.');const inResult=yesno('inResult');if(r.rule==='taxed_reversal'&&!inResult)throw Error('Só excluir proveito de reversão já incluído na contabilidade e antes não deduzido.');accepted=amount;adjustment=r.rule==='taxed_reversal'?mul(amount,-1n):inResult?z():amount;details.push(r.rule==='taxed_reversal'?'Parcela antes tributada comprovada; exclui a reversão contabilística sem duplicar dedução.':'28(2):proveito da provisão antes deduzida; só acresce quando ainda não incluído no resultado.');break;}
case 'prior_cost':case 'prior_income':{if(!/^20\d{2}$/.test(f.originalYear)||Number(f.originalYear)>=2026)throw Error('Exercício de origem deve ser anterior ao exercício actual.');ref('closingEvidence');const unknown=yesno('unknownAtClose');accepted=unknown?amount:z();adjustment=unknown?z():r.rule==='prior_cost'?amount:mul(amount,-1n);details.push(unknown?'18(2):imprevisível ou manifestamente desconhecido no encerramento anterior; imputável ao actual.':'18(2):conhecido/previsível no encerramento anterior; excluído do actual, sem alterar declarações/históricos anteriores.');break;}
case 'estimated_work_loss':accepted=z();adjustment=amount;details.push('36m:perda meramente estimada em obra em curso não dedutível; custo efectivo não confundido com estimativa.');break;
case 'work':{const price=a('price'),totalCost=a('totalCost'),incurred=a('incurred'),priorRevenue=a('priorRevenue'),priorCost=a('priorCost'),bookCost=a('bookCost');ref('projectKey');if(rows.some(q=>q!==r&&q.facts.projectKey===f.projectKey))throw Error('Obra repetida; agregue os valores acumulados sem duplicar resultados.');checkOrigin(f.costSource??'',bookCost,'expense');if(cmp(totalCost,z())<=0n||cmp(incurred,totalCost)>0n||cmp(priorCost,incurred)>0n||cmp(priorRevenue,price)>0n)throw Error('Preço, custo total, incorrido e valores fiscais anteriores incoerentes.');if(!yesno('consistentMethod'))throw Error('Mudança de critério exige correspondência à autorização19(6).');const mandatory=yesno('partialBilling')||yesno('ownFractionalDelivery');let revenue:FiscalFraction,cost:FiscalFraction;
if(f.method==='percentage'){revenue=fraction(BigInt(price.numerator)*BigInt(incurred.numerator)*BigInt(totalCost.denominator),BigInt(price.denominator)*BigInt(incurred.denominator)*BigInt(totalCost.numerator));cost=incurred;}
else if(f.method==='closing'){if(mandatory)throw Error('Facturação parcial com acabamento correspondente/entrega fraccionada: critério da percentagem obrigatório19(2).');const concluded=cmp(mul(incurred,100n),mul(totalCost,95n))>=0n||yesno('publicReception');revenue=concluded?price:z();cost=concluded?incurred:z();}
else throw Error('Seleccione percentagem de acabamento ou encerramento.');if(cmp(priorRevenue,revenue)>0n||cmp(priorCost,cost)>0n)throw Error('Acumulados fiscais anteriores excedem o resultado reconhecível pelo critério; reconcilie sem correcção retrospectiva presumida.');const deferred=a('deferredReceipt');if(cmp(deferred,z())!==0n)throw Error('Receita antecipada19(5) de montante não zero exige correspondência própria.');const currentRevenue=subtractFractions(revenue,priorRevenue),currentCost=subtractFractions(cost,priorCost);accepted=currentCost;adjustment=addFractions([subtractFractions(currentRevenue,amount),subtractFractions(bookCost,currentCost)]);limit=currentRevenue;details.push('19:grau=incorrido/custo total;valores fiscais do exercício obtidos dos acumulados menos o já reconhecido. Proveito fiscal corrente:'+costMoney(currentRevenue)+';custo fiscal corrente:'+costMoney(currentCost)+';sem imposto/pagamento ou perda estimada presumidos.');break;}
default:throw Error('Categoria por identificar.');
}
}catch(e){issues.push(e instanceof Error?e.message:String(e));accepted=null;adjustment=null;}
if(issues.length){accepted=null;adjustment=null;pending.push((r.document||r.id)+': '+issues.join(' '));}return{...structuredClone(r),topic,amountValue:amount,accepted,adjustment,limit,status:issues.length?'indeterminate' as const:'calculated' as const,reason:issues.join(' ')||details.join(' '),ruleSource:rule?'CIRPC'+rule[2]:''};
});
return{input:structuredClone(input),rows:results,pools,pending,effects:results.map(r=>({id:r.id,topic:r.topic,amount:r.amountValue,effect:r.adjustment,reason:r.reason})),net:addFractions(results.flatMap(r=>r.adjustment?[r.adjustment]:[])),source:'CIRPC18(2)/19/28/29/36;Lei34/2007,Lei20/2009,alterações4/2012 e19/2013 e diplomas posteriores inventariados. Recorte2026/MZN,condições documentadas,sem efeitos retroactivos ou consumo de saldos oficiais;L7/L8 separados.'};
}
export type NormalCostsModel=ReturnType<typeof calculateNormalCosts>;
const factLabels:Record<string,string>={billed:'Facturado a clientes',taxedNotBilled:'Tributado emIRPS e não facturado',campaign:'Campanha plurianual',passenger:'Ligeira de passageiros',publicOrRental:'Serviço público/locação na actividade normal',supportedNormal:'Consumo normal comprovado',nonAcceptedQuota:'Quota não aceite documentada',quotaReference:'Suporte da quota',balanceKey:'Identificação do saldo/objecto',previous:'Parcela fiscal anterior',lossObserved:'Perda efectivamente observada',observedLoss:'Perda total observada',caseOngoing:'Processo judicial em curso',chargeDeductible:'Obrigação fiscalmente dedutível',obligation:'Obrigação coberta',eventEnded:'Evento cessou/utilização diferente',inResult:'Incluído no resultado',originalYear:'Exercício de origem',unknownAtClose:'Imprevisível/desconhecido no encerramento',closingEvidence:'Suporte do encerramento',projectKey:'Obra',method:'Critério',price:'Preço',totalCost:'Custo total estimado',incurred:'Custos incorporados acumulados',priorRevenue:'Proveitos fiscais anteriores',priorCost:'Custos fiscais anteriores',costSource:'Origem dos custos',bookCost:'Custo contabilizado corrente',partialBilling:'Facturação parcial com acabamento correspondente',ownFractionalDelivery:'Venda/entrega fraccionada por conta própria',consistentMethod:'Critério uniforme e mantido',publicReception:'Recepção provisória pública',deferredReceipt:'Receita antecipada proposta'};
const originLabels:Record<string,string>={revenue:'Receitas do plano',cost_of_sales:'Custo das vendas',operating_expenses:'Despesas operacionais',personnel:'Pessoal',depreciation:'Depreciação contabilística',interest_expense:'Juros financeiros'};
export function normalCostReport(m:NormalCostsModel):Array<[string,string,string,string]>{const money=costMoney;return[['IRPC normal — L6','Custos com limites, provisões e periodização',`Efeito líquido das parcelas resolvidas:${money(m.net)};${m.pending.join(' | ')}`,m.source],...Object.values(m.pools).map(p=>['IRPC normal — L6',p.label,`Base documentada:${money(p.base)};limite anual:${money(p.annualLimit)};saldo fiscal anterior:${p.previous?money(p.previous):'Não aplicável'};limite acumulado:${p.accumulatedLimit?money(p.accumulatedLimit):'Não aplicável'};limite partilhado entre todas as parcelas, sem consumo do saldo oficial.`,p.reference]as[string,string,string,string]),...m.rows.map(r=>['IRPC normal — L6',(r.rule?costRules[r.rule][0]:'Categoria por identificar')+' — '+r.document+'/'+r.line,`Estado:${r.status==='calculated'?'Calculado no recorte':'Informação insuficiente'};montante identificado:${money(r.amountValue)};parcela aceite/custo fiscal ou reversão:${money(r.accepted)};limite/base ou proveito fiscal:${r.limit?money(r.limit):r.status==='calculated'?'Sem limite monetário próprio; ver regra':'Em falta/não aplicável à parcela'};ajustamento com sinal:${money(r.adjustment)};${r.reason}`,`${r.ruleSource};${r.reference};origem:${originLabels[r.sourceCode]??'Fora do resultado, documentado'};parâmetros:${Object.entries(r.facts).filter(([k])=>factLabels[k]).map(([k,v])=>factLabels[k]+': '+(v==='yes'?'Sim':v==='no'?'Não':v==='percentage'?'Percentagem de acabamento':v==='closing'?'Encerramento':originLabels[v]??(v||'Em falta'))).join('; ')};sem alteração do histórico ou saldo oficial.`]as[string,string,string,string])];}
@@ -0,0 +1,84 @@
import {addFractions,decimalFraction,fraction,subtractFractions,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
import {fiscalMoney,type NormalAsset} from './irpc-normal-schedules.ts';
export const normalDepreciationVersion='IRPC-normal-adjustments/7';
export const depreciationCatalog={
computer:{label:'Computadores, impressoras, UPS e material informático',table:'II',code:'3/9',rate:'25',kind:'equipment',page:17},
server:{label:'Servidores',table:'II',code:'3/9.1',rate:'20',kind:'equipment',page:17},
security:{label:'Equipamento de vigilância e segurança',table:'II',code:'3/23',rate:'20',kind:'equipment',page:18},
machine:{label:'Máquinas não especificadas',table:'II',code:'3/22',rate:'10',kind:'equipment',page:18},
furniture:{label:'Mobiliário',table:'II',code:'5/7',rate:'10',kind:'furniture',page:18},
commercial_building:{label:'Edifícios comerciais e administrativos',table:'II',code:'1/2.2',rate:'2',kind:'building',page:16},
passenger_vehicle:{label:'Veículos automóveis ligeiros e mistos',table:'II',code:'4/9.2',rate:'25',kind:'vehicle',page:18},
software:{label:'Programas de computadores',table:'II',code:'5/8',rate:'25',kind:'software',page:18},
hotel_decoration:{label:'Decorações interiores — hotéis e actividades similares, classe84.2',table:'I',code:'84.2/B',rate:'20',kind:'furniture',page:16},
laundry_machine:{label:'Maquinaria específica de lavandarias/tinturarias',table:'I',code:'84.3/A',rate:'12.5',kind:'equipment',page:16},
}as const;
export type DepreciationCategory=keyof typeof depreciationCatalog;
export type DepreciationAsset={id:string;assetKey:string;description:string;document:string;line:string;category:''|DepreciationCategory|'other'|'nondepreciable';valuation:''|'historical_new'|'used'|'revalued'|'other';specificRate:''|'yes'|'no';method:''|'constant'|'declining'|'low_value';rate:string;factor:string;timing:''|'annual'|'months';start:string;exitState:''|'absent'|'known';exitDate:string;cost:string;land:string;residual:string;accounting:string;previousAccounting:string;previousFiscal:string;priorAvailable:string;previousReference:string;newTangible:''|'yes'|'no';consistentMethod:''|'yes'|'no';switchToStraight:''|'yes'|'no';priorFullQuotas:''|'yes'|'no';vehicleException:''|'yes'|'no';limitedRights:''|'yes'|'no';individual:''|'yes'|'no';conditions:''|'yes';reference:string};
export type NormalDepreciationInput={version:1;completenessReference:string;assets:DepreciationAsset[]};
export const newNormalDepreciation=():NormalDepreciationInput=>({version:1,completenessReference:'',assets:[]});
export const newDepreciationAsset=(id:string):DepreciationAsset=>({id,assetKey:'',description:'',document:'',line:'',category:'',valuation:'',specificRate:'',method:'',rate:'',factor:'',timing:'',start:'',exitState:'',exitDate:'',cost:'',land:'',residual:'',accounting:'',previousAccounting:'',previousFiscal:'',priorAvailable:'',previousReference:'',newTangible:'',consistentMethod:'',switchToStraight:'',priorFullQuotas:'',vehicleException:'',limitedRights:'',individual:'',conditions:'',reference:''});
export function reuseNormalAssets(assets:NormalAsset[]):NormalDepreciationInput{return{version:1,completenessReference:'',assets:assets.map(a=>({...newDepreciationAsset(a.id),assetKey:a.id,description:a.description,category:a.category,document:a.reference,line:a.id,method:'constant',timing:'annual',specificRate:'no',consistentMethod:'yes',conditions:a.conditions,rate:a.rate,cost:a.cost,residual:a.residual,accounting:a.accounting,previousFiscal:a.previousFiscal,start:a.inUseFrom,reference:a.reference}))};}
export function validateNormalDepreciation(i:NormalDepreciationInput){
if(!i||i.version!==1||typeof i.completenessReference!=='string'||!Array.isArray(i.assets)||new Set(i.assets.map(a=>a.id)).size!==i.assets.length)throw Error('Mapa de amortizações não recuperável.');
for(const a of i.assets){if(!a||Object.keys(newDepreciationAsset('')).some(k=>typeof a[k as keyof DepreciationAsset]!=='string')||!['','other','nondepreciable',...Object.keys(depreciationCatalog)].includes(a.category)||!['','historical_new','used','revalued','other'].includes(a.valuation)||!['','constant','declining','low_value'].includes(a.method)||!['','annual','months'].includes(a.timing)||!['','absent','known'].includes(a.exitState)||!['','yes'].includes(a.conditions)||['specificRate','newTangible','consistentMethod','switchToStraight','priorFullQuotas','vehicleException','limitedRights','individual'].some(k=>!['','yes','no'].includes(a[k as 'specificRate'])))throw Error('Activo ou parâmetros de amortização não recuperáveis.');}
}
const zero=()=>fraction(0n),cmp=(a:FiscalFraction,b:FiscalFraction)=>BigInt(a.numerator)*BigInt(b.denominator)-BigInt(b.numerator)*BigInt(a.denominator);
const min=(...a:FiscalFraction[])=>a.reduce((v,w)=>cmp(v,w)<0n?v:w),positive=(a:FiscalFraction)=>cmp(a,zero())<0n?zero():a;
const multiply=(a:FiscalFraction,b:FiscalFraction)=>fraction(BigInt(a.numerator)*BigInt(b.numerator),BigInt(a.denominator)*BigInt(b.denominator));
const ratio=(a:FiscalFraction,b:FiscalFraction)=>fraction(BigInt(a.numerator)*BigInt(b.denominator),BigInt(a.denominator)*BigInt(b.numerator));
const date=(v:string)=>/^20\d{2}-\d{2}-\d{2}$/.test(v)&&Number.isFinite(Date.parse(v))&&new Date(v).toISOString().slice(0,10)===v;
const month=(v:string)=>Number(v.slice(0,4))*12+Number(v.slice(5,7))-1;
const show=(v:FiscalFraction|null)=>{if(!v)return'Indeterminado';const p=fractionPresentation(v);return(p.approximate?'≈':'')+p.decimal+' MZN'+(p.approximate?' (exacto '+v.numerator+'/'+v.denominator+')':'');};
export function calculateNormalDepreciation(input:NormalDepreciationInput,source:{currency:string;accountingLines:Array<{code:string;total:string}>}|null,period:{from:string;to:string},claims:Array<{sourceCode:string;document:string;line:string;amount:string}>,short=false){
validateNormalDepreciation(input);const pending:string[]=[];
if(!input.completenessReference.trim())pending.push('Reconciliação integral dos activos e quotas anteriores com a depreciação da origem em falta.');
if(source?.currency!=='MZN'||!date(period.from)||!date(period.to)||!period.to.startsWith('2026-')||(!short&&month(period.to)-month(period.from)!==11||short&&(month(period.to)<month(period.from)||month(period.to)-month(period.from)>=11)))pending.push('Período anual emMZN com termo em2026 por reconciliar; períodos curtos permanecem separados.');
const assets=input.assets.map(a=>{const issues:string[]=[],notes:string[]=[];let accounting:FiscalFraction|null=null,basis:FiscalFraction|null=null,taxBasis:FiscalFraction|null=null,quota:FiscalFraction|null=null,deduction:FiscalFraction|null=null,adjustment:FiscalFraction|null=null,priorUsed:FiscalFraction|null=null,priorRemaining:FiscalFraction|null=null,remainingFiscal:FiscalFraction|null=null,eligibleCurrent:FiscalFraction|null=null,months:number|null=null;const entry=Object.hasOwn(depreciationCatalog,a.category)?depreciationCatalog[a.category as DepreciationCategory]:null;
if(short&&a.category!=='nondepreciable'&&(a.timing!=='months'||a.method==='low_value'))issues.push('Período curto exige duodécimos;opção integral art17 neste período por corresponder.');
const money=(s:string,label:string)=>{if(!s.trim())throw Error(label+' em falta; não presumir zero.');return fiscalMoney(s);};
const yesno=(v:string,label:string)=>{if(!['yes','no'].includes(v))throw Error(label+' por documentar.');return v==='yes';};
if(!a.assetKey.trim()||!a.description.trim()||!a.document.trim()||!a.line.trim()||!a.reference.trim()||a.conditions!=='yes')issues.push('Identificação do activo, documento/linha, condições ordinárias e suporte em falta.');
if(input.assets.some(b=>b!==a&&(b.assetKey.trim()===a.assetKey.trim()||b.document.trim()===a.document.trim()&&b.line.trim()===a.line.trim()))||claims.some(c=>c.document.trim()===a.document.trim()&&c.line.trim()===a.line.trim()))issues.push('Activo ou documento/linha repetido entre mapas; reconcilie sem dedução duplicada.');
try{accounting=money(a.accounting,'Depreciação contabilística corrente');const cost=money(a.cost,'Custo histórico');
if(a.category==='nondepreciable'){basis=cost;taxBasis=zero();quota=zero();deduction=zero();adjustment=accounting;notes.push('CIRPC26/27:elemento expressamente qualificado como não sujeito a deperecimento; depreciação contabilística integralmente acrescida.');}
else{
if(a.valuation!=='historical_new')throw Error('Tipo de aquisição/base por identificar ou fora do recorte de bens novos a custo histórico; usados/abertura de escrita7(2) e reavaliados15 exigem regra própria.');
if(!entry)throw Error('Categoria/tabela ainda não correspondida; sem taxa livre ou código provisório.');
if(entry){const specific=yesno(a.specificRate,'Existência de taxa específica da tabelaI');if(entry.table==='II'&&specific)throw Error('Taxa específica da tabelaI prevalece; seleccione a categoria específica correspondente.');if(entry.table==='I'&&!specific)throw Error('Categoria específica da tabelaI sem enquadramento documentado.');}
if(!date(a.start)||a.start<'2014-01-01')throw Error('Entrada em funcionamento/utilização desde2014 por identificar; activos anteriores exigem correspondência histórica própria.');
if(!yesno(a.consistentMethod,'Método uniforme desde o início'))throw Error('Mudança de método/razão excepcional requer correspondência própria do artigo10.');
if(a.exitState==='known'&&(!date(a.exitDate)||a.exitDate<a.start)||!a.exitState||a.exitState==='absent'&&a.exitDate.trim())throw Error('Estado/data de transmissão,inutilização ou termo de vida útil incoerente ou em falta.');
if(!a.previousReference.trim())throw Error('Suporte das quotas contabilísticas/fiscais anteriores e da parcela temporariamente tributada em falta.');
const priorBook=money(a.previousAccounting,'Quotas contabilísticas anteriores'),priorFiscal=money(a.previousFiscal,'Quotas fiscais anteriores'),available=money(a.priorAvailable,'Parcela anterior temporariamente tributada recuperável');
if(cmp(priorFiscal,priorBook)>0n||cmp(available,subtractFractions(priorBook,priorFiscal))>0n)throw Error('Quotas anteriores incoerentes; parcela recuperável não pode exceder a diferença contabilizada e não deduzida, excluindo encargos permanentemente não aceites.');
const residual=money(a.residual,'Residual'),land=entry?.kind==='building'?money(a.land,'Terreno/parte não depreciável'):zero();if(entry?.kind!=='building'&&a.land.trim()&&cmp(fiscalMoney(a.land),zero())!==0n)throw Error('Terreno não corresponde a esta categoria de activo.');basis=subtractFractions(subtractFractions(cost,residual),land);if(cmp(basis,zero())<=0n)throw Error('Base depreciável positiva por reconciliar.');if(entry?.kind!=='building'&&cmp(land,zero())!==0n)throw Error('Terreno só deve ser separado no imóvel correspondente.');taxBasis=basis;
if(entry?.kind==='vehicle'&&!yesno(a.vehicleException,'Afectação a serviço público de transportes/locação na actividade normal')){taxBasis=min(basis,positive(subtractFractions(fraction(800000n),residual)));notes.push('CIRPC27e:limite de aquisição800000MZN,sem afectar a depreciação contabilística de origem.');}
if(entry?.kind==='software'&&!yesno(a.limitedRights,'Aquisição onerosa e direitos de utilização exclusiva por tempo limitado'))throw Error('Direitos de software/intangível sem condições do artigo16 documentadas.');
if(cmp(priorFiscal,taxBasis)>0n)throw Error('Quotas fiscais anteriores excedem a base fiscal; reconcilie o saldo anterior.');const remaining=subtractFractions(taxBasis,priorFiscal),priorEligibleBook=min(taxBasis,multiply(priorBook,ratio(taxBasis,basis)));if(cmp(available,positive(subtractFractions(priorEligibleBook,priorFiscal)))>0n)throw Error('Parcela anterior recuperável inclui quota permanentemente não aceite ou excede a contabilização fiscalmente elegível.');eligibleCurrent=min(multiply(accounting,ratio(taxBasis,basis)),positive(subtractFractions(taxBasis,priorEligibleBook)));
let maxRate:FiscalFraction|null=entry?decimalFraction(entry.rate):null,maxLifeMonths:FiscalFraction|null=maxRate?ratio(fraction(2400n),maxRate):null;
if(a.method==='low_value'){if(cmp(cost,fraction(20000n))>0n||!yesno(a.individual,'Activo individual fora de conjunto depreciado como um todo')||cmp(priorFiscal,zero())!==0n||a.start<period.from||a.start>period.to)throw Error('Art17:valor unitário até20000MZN,activo individual e início no período,sem amortização fiscal anterior; condições em falta/incompatíveis.');quota=remaining;months=month(period.to)-month(a.start)+1;notes.push('Art17:opção de depreciação integral em um período,limitada ao que está contabilizado e ao saldo fiscal.');}
else{
if(!entry||!maxRate||!maxLifeMonths)throw Error('Taxa aplicável não identificada.');
if(a.method==='constant'){if(!/^\d+(?:\.\d{1,6})?$/.test(a.rate))throw Error('Taxa constante escolhida por identificar.');const selected=decimalFraction(a.rate);if(cmp(selected,multiply(maxRate,fraction(1n,2n)))<0n||cmp(selected,maxRate)>0n)throw Error('Taxa constante fora do recorte entre metade da máxima e a máxima;quotas inferiores exigem correspondência própria dos limites de vida útil, artigos5/7.');quota=multiply(taxBasis,multiply(selected,fraction(1n,100n)));notes.push('Quota constante pela taxa escolhida:'+a.rate+'%;tabela'+entry.table+'/'+entry.code+'.');}
else if(a.method==='declining'){if(!yesno(a.newTangible,'Activo tangível novo adquirido a terceiros/construído')||['building','furniture','software'].includes(entry.kind)||entry.kind==='vehicle'&&a.vehicleException!=='yes')throw Error('Art6:quotas degressivas só nos activos tangíveis novos elegíveis;edifícios,mobiliário/equipamento social,intangíveis e veículos sem excepção ficam separados.');const life=ratio(fraction(100n),maxRate),maxFactor=cmp(life,fraction(5n))<0n?fraction(3n,2n):cmp(life,fraction(6n))<=0n?fraction(2n):fraction(5n,2n);if(!/^\d+(?:\.\d{1,6})?$/.test(a.factor))throw Error('Coeficiente degressivo escolhido em falta.');const factor=decimalFraction(a.factor);if(cmp(factor,zero())<=0n||cmp(factor,maxFactor)>0n)throw Error('Coeficiente degressivo excede o máximo do artigo8:1,5/2/2,5 conforme vida útil mínima.');quota=multiply(remaining,multiply(maxRate,multiply(factor,fraction(1n,100n))));notes.push('Art8:saldo fiscal por amortizar ×taxa máxima'+entry.rate+'% ×coeficiente'+a.factor+';máximo'+fractionPresentation(maxFactor).decimal+'.');
if(yesno(a.switchToStraight,'Opção pela regra de saldo/vida útil restante8(2)')){if(!yesno(a.priorFullQuotas,'Condição das quotas anteriores8(2)')||!a.start.endsWith('-01-01')||period.from!=='2026-01-01'||a.timing!=='annual')throw Error('Art8(2):condição das quotas anteriores por documentar;este recorte da opção exige início emJaneiro e período anual civil.');const remainingYears=subtractFractions(life,fraction(BigInt(2026-Number(a.start.slice(0,4)))));if(cmp(remainingYears,zero())<=0n)throw Error('Art8(2):vida útil mínima esgotada;sem dividir por anos inexistentes.');const linear=ratio(remaining,remainingYears);if(cmp(quota,linear)<0n){quota=linear;notes.push('Art8(2):usado saldo/número de anos de vida útil mínima restantes,com condições anteriores documentadas.');}}
}else throw Error('Método de amortização por identificar.');
if(!a.timing)throw Error('Opção anual/duodécimos por identificar.');
if(a.timing==='annual'){if(a.exitState==='known'&&a.exitDate<=period.to)throw Error('Evento de saída em período anual:seleccione duodécimos e reconcilie a regra aplicável;sem quota anual presumida.');const lifeEnd=month(a.start)+Number(BigInt(maxLifeMonths.numerator)/BigInt(maxLifeMonths.denominator));if(lifeEnd>month(period.from)&&lifeEnd<=month(period.to)&&cmp(remaining,zero())>0n)throw Error('Vida útil máxima termina dentro do período;opção anual e quotas anteriores exigem correspondência própria. Duodécimos em vigor são calculados até ao limite temporal.');months=a.start>period.to?0:12;}
else{const start=Math.max(month(period.from),month(a.start)),end=Math.min(month(period.to)+1,a.exitState==='known'?month(a.exitDate):month(period.to)+1,month(a.start)+Number(BigInt(maxLifeMonths.numerator)/BigInt(maxLifeMonths.denominator)));months=Math.max(0,end-start);quota=multiply(quota,fraction(BigInt(months),12n));notes.push('Art9:entrada incluída desde o mês da utilização;saída exclui o mês do evento;'+months+'duodécimos.');}
const elapsed=Math.max(0,month(period.from)-month(a.start));if(cmp(fraction(BigInt(elapsed)),maxLifeMonths)>=0n){quota=zero();notes.push('Art5:vida útil máxima esgotada,sem excepção aplicada;nenhuma recuperação de quota fora desse limite.');}else if(a.start>period.to){quota=zero();notes.push('Art3:activo ainda não entrou emuso no período;sem amortização fiscal.');}
}
deduction=min(quota!,remaining,addFractions([eligibleCurrent,available]));priorUsed=positive(subtractFractions(deduction,eligibleCurrent));priorRemaining=subtractFractions(available,priorUsed);remainingFiscal=subtractFractions(remaining,deduction);adjustment=subtractFractions(accounting,deduction);notes.push('Art3(3):dedução limitada ao contabilizado no período ou antes desde o uso;quotas anteriores recuperáveis usadas:'+show(priorUsed)+';saldo anterior aritmético:'+show(priorRemaining)+'. Sem consumo oficial nem recuperação de quota não contabilizada/permanentemente excluída.');
}
}catch(e){issues.push(e instanceof Error?e.message:String(e));}
if(issues.length){deduction=null;adjustment=null;priorUsed=null;priorRemaining=null;remainingFiscal=null;pending.push((a.description||a.id)+': '+issues.join(' '));}
return{...structuredClone(a),catalog:entry,accountingValue:accounting,basis,taxBasis,quota,deduction,adjustment,eligibleCurrent,priorUsed,priorRemaining,remainingFiscal,months,status:issues.length?'indeterminate' as const:'calculated' as const,reason:issues.join(' ')||notes.join(' ')};
});
let accountingTotal:FiscalFraction|null=null;try{accountingTotal=addFractions(assets.map(a=>{if(!a.accountingValue)throw Error();return a.accountingValue;}));const origin=fiscalMoney(source?.accountingLines.find(l=>l.code==='depreciation')?.total??'');if(cmp(accountingTotal,origin)!==0n)pending.push('Soma das quotas contabilísticas dos activos não corresponde à depreciação financeira declarada.');}catch{pending.push('Depreciação contabilística da origem por reconciliar.');}
if(claims.some(c=>c.sourceCode==='depreciation'))pending.push('Depreciação partilhada com outros ajustamentos de origem;reconcilie as parcelas para não duplicar o mesmo encargo.');
const knownAdjustment=addFractions(assets.flatMap(a=>a.adjustment?[a.adjustment]:[])),adjustment=pending.length===0?knownAdjustment:null;
return{input:structuredClone(input),assets,accountingTotal,knownAdjustment,adjustment,pending,source:'Decreto72/2013,art3–10/16/17,tabelasI/II;CIRPC26/27. Recorte anualMZN com termo2026,custo histórico,sem reavaliação,turnos intensivos,concessões/fusões ou excepções presumidas. Fotografia7;mapa interno,não formulário oficial de amortizações.'};
}
export type NormalDepreciationModel=ReturnType<typeof calculateNormalDepreciation>;
export function normalDepreciationReport(m:NormalDepreciationModel):Array<[string,string,string,string]>{return[['IRPC normal — L6','Amortizações — tabelas, métodos, duodécimos e quotas anteriores',`Quotas contabilísticas:${show(m.accountingTotal)};ajustamento das parcelas conhecidas:${show(m.knownAdjustment)};ajustamento reconciliado:${show(m.adjustment)};${m.pending.join(' | ')}`,m.source],...m.assets.map(a=>['IRPC normal — L6',a.description+' — '+a.document+'/'+a.line,`Estado:${a.status==='calculated'?'Calculado no recorte':'Informação insuficiente'};contabilístico:${show(a.accountingValue)};parcela contabilística elegível:${show(a.eligibleCurrent)};base fiscal:${show(a.taxBasis)};quota calculada:${show(a.quota)};dedução fiscal:${show(a.deduction)};ajustamento com sinal:${show(a.adjustment)};duodécimos:${a.months??'Não aplicável'};quota anterior utilizada:${show(a.priorUsed)};saldo anterior aritmético:${show(a.priorRemaining)};${a.reason}`,`${a.catalog?'Decreto72/2013,tabela'+a.catalog.table+',código'+a.catalog.code+',PDF'+a.catalog.page:'Categoria sem código de tabela aplicado'};${a.reference};quotas anteriores:${a.previousReference};método:${a.method==='constant'?'Constante':a.method==='declining'?'Degressivo':a.method==='low_value'?'Valor reduzido':'Por identificar'};sem alteração dos documentos/saldos oficiais ou históricos.`]as[string,string,string,string])];}
@@ -0,0 +1,84 @@
import {addFractions,decimalFraction,fraction,fractionPresentation,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
import type {normalFinancialSource} from './irpc-normal.ts';
import type {SchedulesModel} from './irpc-normal-schedules.ts';
import type {NormalCostsModel} from './irpc-normal-costs.ts';
import type {NormalDepreciationModel} from './irpc-normal-depreciation.ts';
import type {NormalBaseModel} from './irpc-normal-base.ts';
export const normalFormPreparationVersion='IRPC-normal-adjustments/9';
export const m20Accounts={
'7.1':'Venda de bens','7.2':'Prestação de serviços','7.3':'Investimentos realizados pela própria empresa','7.4':'Reversões do período','7.5':'Rendimentos suplementares','7.6':'Outros rendimentos e ganhos operacionais','7.8':'Rendimentos e ganhos financeiros','7.9':'Ganho por aumento do justo valor',
'6.1.1':'Custos dos inventários vendidos ou consumidos','6.2':'Gastos com pessoal','6.3':'Fornecimentos e serviços de terceiros','6.4':'Perda por imparidade / ajustamento','6.5':'Amortizações do período','6.6':'Provisões do período','6.7':'Perda por redução do justo valor','6.8':'Outros gastos e perdas operacionais','6.9':'Gastos e perdas financeiras','8.5':'Imposto sobre o rendimento',
}as const;
export type FormAllocation={id:string;sourceCode:string;account:''|keyof typeof m20Accounts;amount:string;reference:string};
export type NormalFormPreparationInput={version:1;edition:''|'accepted_pdf_and_m20a1';reference:string;completenessReference:string;allocations:FormAllocation[];incomeTax:{state:''|'known'|'absent';amount:string;placement:''|'included'|'outside';reference:string};reducedRate:{state:''|'known'|'absent';reference:string}};
export const newNormalFormPreparation=():NormalFormPreparationInput=>({version:1,edition:'',reference:'',completenessReference:'',allocations:[],incomeTax:{state:'',amount:'',placement:'',reference:''},reducedRate:{state:'',reference:''}});
export const newFormAllocation=(id:string):FormAllocation=>({id,sourceCode:'',account:'',amount:'',reference:''});
const allowed:Record<string,string[]>={revenue:['7.1','7.2','7.3','7.4','7.5','7.6','7.8','7.9'],cost_of_sales:['6.1.1'],personnel:['6.2'],depreciation:['6.5'],interest_expense:['6.9'],operating_expenses:['6.3','6.4','6.6','6.7','6.8','8.5']};
export const normalFormAccountsFor=(source:string)=>allowed[source]??[];
export function validateNormalFormPreparation(i:NormalFormPreparationInput){
if(!i||i.version!==1||!['','accepted_pdf_and_m20a1'].includes(i.edition)||typeof i.reference!=='string'||typeof i.completenessReference!=='string'||!Array.isArray(i.allocations)||new Set(i.allocations.map(a=>a.id)).size!==i.allocations.length||i.allocations.some(a=>!a||Object.keys(newFormAllocation('')).some(k=>typeof a[k as keyof FormAllocation]!=='string')||a.account!==''&&!Object.hasOwn(m20Accounts,a.account))||!i.incomeTax||!['','known','absent'].includes(i.incomeTax.state)||!['','included','outside'].includes(i.incomeTax.placement)||typeof i.incomeTax.amount!=='string'||typeof i.incomeTax.reference!=='string'||!i.reducedRate||!['','known','absent'].includes(i.reducedRate.state)||typeof i.reducedRate.reference!=='string')throw Error('Preparação M20/M22 não recuperável;originais conservados.');
}
const zero=()=>fraction(0n),neg=(v:FiscalFraction)=>fraction(-BigInt(v.numerator),BigInt(v.denominator)),positive=(v:FiscalFraction)=>BigInt(v.numerator)>=0n;
const eq=(a:FiscalFraction,b:FiscalFraction)=>BigInt(a.numerator)*BigInt(b.denominator)===BigInt(b.numerator)*BigInt(a.denominator);
function money(s:string){if(!/^\d{1,18}(?:\.\d{1,6})?$/.test(s))throw Error('Montante não negativo conhecido em falta;zero não é presumido.');return decimalFraction(s);}
export function normalFormRepresentation(v:FiscalFraction|null,unit:'whole'|'cent'='cent',parentheses=false){
if(!v)return{exact:null,display:'Indeterminado',represented:null,ready:false,reason:'Valor em falta;sem zero presumido.'};
const n=BigInt(v.numerator),d=BigInt(v.denominator);if(d<=0n)throw Error('Representação racional inválida.');const p=fractionPresentation(v),whole=n%d===0n,cent=n*100n%d===0n;
const abs=n<0n?-n:n,scaled=abs*100n/d;const exact=n+'/'+d+' MZN',value=whole?(parentheses&&n<0n?'('+String(-n/d)+')':String(n/d)):unit==='cent'&&cent?(n<0n?'-':'')+scaled/100n+'.'+String(scaled%100n).padStart(2,'0'):null;
return{exact,display:whole?(value+' MZN'):(p.approximate?'≈':'')+p.decimal+' MZN (exacto '+n+'/'+d+')',represented:value,ready:value!==null,reason:whole?'Valor exacto em meticais inteiros,sem arredondamento.':unit==='whole'?'Exemplar M20 exige meticais sem centavos;regra de representação da fracção por corresponder.':cent?'Valor exacto ao cêntimo na preparação M22 já demonstrada;sem arredondamento fiscal ou declaração oficial presumidos.':'Fracção de cêntimo conservada;regra de representação fiscal por corresponder.'};
}
type Financial=ReturnType<typeof normalFinancialSource>;
export function reuseDirectFormAllocations(source:Financial){return(source?.accountingLines??[]).filter(l=>['cost_of_sales','personnel','depreciation','interest_expense'].includes(l.code)).map(l=>({id:'source-'+l.code,sourceCode:l.code,account:allowed[l.code][0]as keyof typeof m20Accounts,amount:l.total,reference:'Reutilizado da linha financeira '+l.origin+';conferir completude da conta no suporte da preparação.'}));}
type Model={accountingProfit:FiscalFraction|null;taxableProfit:FiscalFraction|null;taxableBase:FiscalFraction|null;colecta?:FiscalFraction|null;rows:Array<{rule:string;document:string;line:string;adjustment:FiscalFraction|null}>;schedules?:SchedulesModel;depreciation?:NormalDepreciationModel;costs?:NormalCostsModel;base?:NormalBaseModel};
export function prepareNormalForms(input:NormalFormPreparationInput,m:Model,source:Financial){
validateNormalFormPreparation(input);const pending:string[]=[],edition=input.edition==='accepted_pdf_and_m20a1'&&!!input.reference.trim();
if(!edition)pending.push('Identifique os exemplares M22 PDF e M20A.1 inventariados;sem equivalência automática com as outras edições.');
if(!input.completenessReference.trim())pending.push('Suporte da completude contabilística e discriminação da origem em falta.');
const allocations=input.allocations.map(a=>{let value:FiscalFraction|null=null;const issues:string[]=[];try{value=money(a.amount);}catch(e){issues.push(String(e));}if(!normalFormAccountsFor(a.sourceCode).includes(a.account)||!source?.accountingLines.some(l=>l.code===a.sourceCode)||!a.reference.trim())issues.push('Origem/conta e suporte compatíveis por identificar.');return{...structuredClone(a),value:issues.length?null:value,reason:issues.join(' ')};});
const lines=(source?.accountingLines??[]).map(l=>{const rows=allocations.filter(a=>a.sourceCode===l.code),sum=addFractions(rows.flatMap(a=>a.value?[a.value]:[])),ready=rows.length>0&&rows.every(a=>a.value!==null)&&eq(sum,money(l.total));const reason=ready?'Parcelas reconciliadas exactamente com a linha de origem.':'Discriminação em falta,incompleta ou superior à origem;sem duplicar montantes.';if(!ready)pending.push(l.origin+': '+reason);return{code:l.code,total:l.total,allocated:sum,ready,reason};});
for(const a of allocations)if(a.reason)pending.push(a.id+': '+a.reason);
if(!source)pending.push('Resultado financeiro do período/moeda em falta;preparação não cria um resultado substituto.');
const tax=input.incomeTax;let bookTax:FiscalFraction|null=null;
if(!tax.reference.trim()||!tax.state)pending.push('Imposto sobre rendimento contabilizado:valor/ausência e suporte por identificar;colecta não substitui gasto contabilístico.');
else if(tax.state==='absent'){if(tax.amount.trim()||tax.placement)pending.push('Ausência de imposto contabilizado contradiz montante/localização preenchidos.');else bookTax=zero();}
else{try{bookTax=money(tax.amount);if(!tax.placement)throw Error();}catch{bookTax=null;pending.push('Imposto contabilizado conhecido exige montante e indicação se já incluído ou exterior ao resultado do plano.');}}
const allocatedTax=addFractions(allocations.filter(a=>a.account==='8.5'&&a.value).map(a=>a.value!));
if(bookTax&&(!eq(allocatedTax,tax.placement==='included'?bookTax:zero()))){pending.push('Conta8.5 não reconciliada com imposto já incluído/exterior ao plano;sem subtracção duplicada.');bookTax=null;}
const includedTaxEvidence=(m.schedules?.effects??[]).filter(e=>m.schedules!.input.rows.find(r=>r.id===e.id)?.rule==='tax_own');
if(bookTax&&tax.placement!=='included'&&includedTaxEvidence.some(e=>e.effect&&BigInt(e.effect.numerator)>0n)){pending.push(tax.state==='absent'?'Ausência de imposto contabilizado contradiz imposto próprio já identificado nos custos do plano.':'Imposto incluído e exterior coexistem:discriminação das duas componentes ainda por corresponder;sem misturar ou subtrair duas vezes.');bookTax=null;}
const classificationReady=edition&&!!input.completenessReference.trim()&&source!==null&&lines.length>0&&lines.every(l=>l.ready)&&allocations.every(a=>a.value!==null),outsideTax=bookTax&&tax.placement==='outside'?bookTax:zero();
const m20=Object.entries(m20Accounts).map(([account,label])=>{const related=allocations.filter(a=>a.account===account),categorySources=Object.keys(allowed).filter(k=>allowed[k].includes(account));const complete=edition&&!!input.completenessReference.trim()&&source!==null&&categorySources.every(k=>lines.some(l=>l.code===k&&l.ready));let value=complete?addFractions(related.flatMap(a=>a.value?[a.value]:[])):null;if(account==='8.5')value=complete&&bookTax?bookTax:null;return{account,label,value,representation:normalFormRepresentation(value,'whole'),reference:related.map(a=>a.reference).join(' | '),reason:complete?'Classificação documentada e reconciliada no M20A.1/quadro4.':'Campo dependente da discriminação contabilística;sem zero por falta de parcelas.'};});
const netResult=classificationReady&&bookTax&&m.accountingProfit?subtractFractions(m.accountingProfit,outsideTax):null;
const entries:Array<{code:string|null;origin:string;value:FiscalFraction|null;reason:string}>=[];
const add=(code:string|null,origin:string,value:FiscalFraction|null,reason='')=>entries.push({code,origin,value,reason});
for(const r of m.rows)add(r.rule==='noncontractual_fine'||r.rule==='compensatory_interest'?'215':null,r.document+'/'+r.line,r.adjustment,'CIRPC36(1)c;PDF M22/quadro10 campo215.');
for(const e of m.schedules?.effects??[]){const r=m.schedules!.input.rows.find(r=>r.id===e.id)!;if(['capital_in','capital_out'].includes(r.rule)&&e.effect&&eq(e.effect,zero()))continue;const code=({patrimonial_gain:'201',patrimonial_cost:'202',tax_other:'213',undocumented:'223'}as Record<string,string>)[r.rule]??null;add(code,r.document+'/'+r.line,e.effect,code?'Correspondência do rótulo do PDF M22.':r.rule==='tax_own'?'Imposto próprio36(1)a:campo específico por corresponder;campo213 do PDF refere apenas responsabilidade de outrem.':'Periodização/variação sem campo correspondido neste recorte;efeito preservado no cálculo.');}
if(m.depreciation)for(const asset of m.depreciation.assets){const a=asset.adjustment;add(a&&positive(a)?'206':null,'Mapa de amortizações — '+asset.description,a,a&&positive(a)?'Reintegrações/amortizações não aceites:PDF campo206.':'Recuperação de quota anterior/ajustamento negativo:campo de dedução específico ainda por corresponder.');}
else if(m.schedules?.depreciation){const a=m.schedules.depreciation;add(positive(a)?'206':null,'Amortizações do mapa inicial',a);}
for(const r of m.costs?.rows??[]){const code=({allowance:'219',representation:'220',advertising:'221',vehicle:'226',fuel:'225',rental:'224',credit:'209',stock:'209',litigation:'209',taxed_reversal:'239'}as Record<string,string>)[r.rule]??null;add(code,r.document+'/'+r.line,r.adjustment,code?'Correspondência do tratamento demonstrado ao rótulo do PDF M22.':'Tratamento demonstrado sem campo específico correspondido;não usar campo livre por presunção.');}
if(bookTax&&tax.placement==='outside')add(null,'Imposto contabilístico exterior ao plano',bookTax,'Imposto próprio36(1)a:campo específico por corresponder;213 do exemplar é de outrem. Resultado líquido conhecido,sem código presumido ou alteração do motor fiscal.');
const ownTaxEffects=(m.schedules?.effects??[]).filter(e=>m.schedules!.input.rows.find(r=>r.id===e.id)?.rule==='tax_own');
const includedTaxCorresponds=!bookTax||tax.placement!=='included'||ownTaxEffects.every(e=>e.effect!==null)&&eq(addFractions(ownTaxEffects.flatMap(e=>e.effect?[e.effect]:[])),bookTax);
if(!includedTaxCorresponds)pending.push('Imposto já incluído agora discriminado não corresponde ao ajustamento tax_own existente;conferir esse caso sem alterar cálculos ou históricos.');
const unmapped=entries.filter(e=>!e.code&&(!e.value||!eq(e.value,zero())));for(const e of unmapped)pending.push(e.origin+': '+e.reason);
const field=(code:string,label:string,value:FiscalFraction|null,reason:string,notApplicable=false)=>({code,label,value,application:notApplicable?'not_applicable':value?'known':'missing',representation:notApplicable?{...normalFormRepresentation(null),display:'Sem aplicação',reason:'Lucro/perda conhecido:não preencher o campo de sinal oposto.'}:normalFormRepresentation(value),reason,transcriptionReady:edition&&code!=='200'&&normalFormRepresentation(value).ready});
const mappedValue=(code:string,negative=false)=>{if(code==='206'&&m.depreciation?.adjustment===null)return null;const es=entries.filter(e=>e.code===code);if(es.some(e=>e.value===null)||!es.length&&m.taxableProfit===null)return null;const value=addFractions(es.flatMap(e=>e.value?[negative?neg(e.value):e.value]:[]));return positive(value)?value:null;};
const fields=[field('200','Resultado do exercício',netResult,'Valor contabilístico reconciliado próprio;transporte automático M20→M22 impedido só pela divergência201/Q8 versus200/Q10.')];
const labels:Record<string,string>={'201':'Variações patrimoniais positivas','202':'Variações patrimoniais negativas','206':'Amortizações não aceites','209':'Provisões/imparidade além dos limites','213':'Impostos e encargos da responsabilidade de outrem','215':'Multas e juros compensatórios','219':'Parcela não aceite de ajudas de custo','220':'Parcela não aceite de representação','221':'Publicidade além do limite','223':'Despesas não documentadas','224':'Parcela não aceite de aluguer','225':'Combustíveis sem prova/consumo normal','226':'Encargos não aceites com viaturas','239':'Reposição/redução de provisões tributadas'};
for(const[code,label]of Object.entries(labels))fields.push(field(code,label,mappedValue(code,['202','239'].includes(code)),'PDF M22/quadro10;valor do ajustamento demonstrado,sem reaplicar percentagens do rótulo.'));
const v=(code:string)=>fields.find(f=>f.code===code)!.value,patrimonial=netResult&&v('201')&&v('202')?subtractFractions(addFractions([netResult,v('201')!]),v('202')!):null;
fields.push(field('203','Resultado após variações patrimoniais',patrimonial,'200+201−202,sem transferência entre edições.'));
const up=entries.filter(e=>!['201','202'].includes(e.code??'')&&e.value&&positive(e.value)&&!eq(e.value,zero())),down=entries.filter(e=>!['201','202'].includes(e.code??'')&&e.value&&!positive(e.value));
const sumsReady=includedTaxCorresponds&&m.taxableProfit!==null&&entries.every(e=>e.value!==null)&&unmapped.length===0&&patrimonial!==null;
const additions=sumsReady?addFractions([patrimonial!,...up.map(e=>e.value!)]):null,deductions=sumsReady?addFractions(down.map(e=>neg(e.value!))):null,reconstructed=additions&&deductions?subtractFractions(additions,deductions):null;
const matches=reconstructed!==null&&m.taxableProfit!==null&&eq(reconstructed,m.taxableProfit);if(reconstructed&&!matches)pending.push('Percurso M22 não reconcilia com o lucro tributável existente;rever localização do imposto e campos,sem alterar os cálculos demonstrados.');
fields.push(field('238','Soma após acréscimos',additions,'Campo203+campos204–237;indeterminado se há efeito sem correspondência.'),field('258','Soma das deduções',deductions,'Campos239–257;sem presumir campo para dedução não correspondida.'));
const p=m.taxableProfit,loss=p&&!positive(p)?neg(p):null,profit=p&&positive(p)?p:null;
for(const[code,label,value]of [['259','Prejuízo fiscal',loss],['260','Lucro tributável',profit],['269','Prejuízo fiscal — regime geral',loss],['270','Lucro tributável — regime geral',profit],['276','Prejuízos fiscais deduzidos',m.base?.deductedLosses??null],['277','Benefícios fiscais a deduzir',m.base?.benefitDeduction??null],['278','Matéria colectável — regime geral',m.taxableBase],['300','Imposto à taxa normal',m.colecta??null]]as const)fields.push(field(code,label,value,'Reutiliza o cálculo demonstrado;campos independentes da divergência de transporte.',p!==null&&value===null&&['259','260','269','270'].includes(code)));
const reducedAbsent=input.reducedRate.state==='absent'&&!!input.reducedRate.reference.trim();fields.push(field('301','Imposto à taxa reduzida',reducedAbsent?zero():null,'Ausência declarada com suporte;caso conhecido pertence aL7.'),field('302','Colecta total',reducedAbsent?m.colecta??null:null,'300+301 apenas com ausência de taxa reduzida demonstrada;sem saldoL8.'));
if(!reducedAbsent)pending.push('Parcela de taxa reduzida em falta ou conhecida:colecta total302 depende desse âmbitoL7;colecta normal300 preservada.');
fields.push(field('309–316','Liquidação e saldo final',null,'L8:retenções,pagamentos,créditos e saldo final não apurados.'));
return{input:structuredClone(input),allocations,lines,m20,netResult,netRepresentation:normalFormRepresentation(netResult,'whole',true),entries,unmapped,fields,reconciliation:{reconstructedProfit:reconstructed,existingProfit:m.taxableProfit,matches},pending,source:'PDF M22 SHA2564b61bd83d1fbcfd3b7b5c5523cea5923f7d0f65dc4c004eff58e5db38f763c88,Q10–12;M20A.1 SHA2561ceca6f4c6d77853c1b2b445876599b42093175fa89eecf40590180956d83a9e,Q4/M12/D13–D35. Rótulos e estrutura reutilizados;sem valores de terceiros,fórmulas do exemplar ou submissão.',transport:{ready:false,reason:'M20A.1 D35 remete paraM22 campo201/quadro8;PDF M22 usa200/quadro10. Impedimento restrito ao transporte deste resultado;campos independentes continuam preparados.'}};
}
export type NormalFormPreparationModel=ReturnType<typeof prepareNormalForms>;
export function normalFormPreparationReport(m:NormalFormPreparationModel):Array<[string,string,string,string]>{return[['IRPC normal — L6','Representação e preparação M20/M22',m.pending.join(' | ')||'Preparação parcial dos campos correspondidos;sem declaração oficial ou submissão.',m.source],...m.m20.map(f=>['IRPC normal — L6','M20 A.1 conta'+f.account+' — '+f.label,`${f.representation.display};exacto:${f.representation.exact??'Indeterminado'};representável:${f.representation.ready?'Sim':'Pendente'};${f.representation.reason}`,`${f.reference};${f.reason}`]as[string,string,string,string]),['IRPC normal — L6','Resultado líquido M20',m.netRepresentation.display+';'+m.netRepresentation.reason,'Imposto contabilístico identificado;sem usar colecta como despesa presumida.'],...m.fields.map(f=>['IRPC normal — L6','M22 PDF campo'+f.code+' — '+f.label,`${f.representation.display};exacto:${f.representation.exact??'Indeterminado'};preparação de transcrição:${f.transcriptionReady?'Exacta neste recorte':'Pendente/sem aplicação'};${f.representation.reason}`,f.reason]as[string,string,string,string]),...m.unmapped.map(e=>['IRPC normal — L6','Ajustamento sem campo correspondido — '+e.origin,normalFormRepresentation(e.value).display,e.reason]as[string,string,string,string]),['IRPC normal — L6','Transporte entre edições',m.transport.reason,`Lucro reconstruído:${normalFormRepresentation(m.reconciliation.reconstructedProfit).display};lucro existente:${normalFormRepresentation(m.reconciliation.existingProfit).display};reconciliação:${m.reconciliation.matches?'Exacta':'Pendente'};sem alteração de cálculos.`]];}
+20
View File
@@ -0,0 +1,20 @@
import {fraction,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
export const normalFormSource='M/22, exemplar inventariado IRPC M-22- DECLARACAO DE RENDIMENTOS.pdf, SHA256 4b61bd83d1fbcfd3b7b5c5523cea5923f7d0f65dc4c004eff58e5db38f763c88, quadros10/11/12, três páginas conferidas. Correspondência parcial de preparação, sem ficheiro oficial ou submissão.';
export function normalFormFields(m:{profit?:{lines:Array<{code:string;amount:string;reference:string}>};taxableProfit:FiscalFraction|null;taxableBase:FiscalFraction|null;colecta?:FiscalFraction|null;base?:{deductedLosses:FiscalFraction|null;benefitDeduction:FiscalFraction|null}}){
const p=m.taxableProfit,negative=p!==null&&BigInt(p.numerator)<0n;
const values:Array<[string,string,FiscalFraction|null,string]>= [
['259','Prejuízo fiscal',negative?fraction(-BigInt(p!.numerator),BigInt(p!.denominator)):null,'Quadro10; apenas quando há perda conhecida.'],
['260','Lucro tributável',p&&!negative?p:null,'Quadro10; não preencher o campo de lucro com uma perda.'],
['269','Prejuízo fiscal — regime geral',negative?fraction(-BigInt(p!.numerator),BigInt(p!.denominator)):null,'Quadro11; não é uma perda anterior dedutível.'],
['270','Lucro tributável — regime geral',p&&!negative?p:null,'Quadro11; manter separados regimes reduzido/isento.'],
['276','Prejuízos fiscais deduzidos',m.base?.deductedLosses??null,'Quadro11; utilização simulada expressa.'],
['277','Benefícios fiscais a deduzir',m.base?.benefitDeduction??null,'Quadro11; benefícios positivos pertencem aL7.'],
['278','Matéria colectável — regime geral',m.taxableBase,'Quadro11; não é colecta.'],
['300','Imposto à taxa normal',m.colecta??null,'Quadro12; não é saldo final.'],
['200','Resultado do exercício',null,'Resultado financeiro antes de imposto não preenche automaticamente o resultado líquido do formulário; falta reconciliação própria.'],
['302','Colecta total',null,'Inclui eventual parcela de taxa reduzida; não presumir a ausência deL7.'],
['309–316','Liquidação e saldo final',null,'ÂmbitoL8; retenções, pagamentos, créditos e juros não preenchidos porL6.'],
];
const m20Fields=([['cost_of_sales','6.1.1','Custo dos inventários vendidos/consumidos'],['personnel','6.2','Gastos com pessoal'],['depreciation','6.5','Amortizações do período'],['interest_expense','6.9','Gastos financeiros — apenas juros da origem']]as const).map(([key,account,label])=>{const l=m.profit?.lines.find(l=>l.code===key);let value:FiscalFraction|null=null;if(l&&/^\d+(?:\.\d{1,2})?$/.test(l.amount)){const[n,f='']=l.amount.split('.');value=fraction(BigInt(n)*100n+BigInt(f.padEnd(2,'0')),100n);}return{account,label,value,display:value?fractionPresentation(value).decimal+' MZN':'Não preenchido',transcriptionReady:value!==null&&BigInt(value.numerator)%BigInt(value.denominator)===0n,reference:l?.reference??'',reason:'M20 A.1 quadro4, código contabilístico do exemplar, sem inventar número de campo. Valor contabilístico da origem; não é dedução fiscal. Exemplar exige meticais sem centavos; fracções conservadas, sem arredondamento presumido.'};});
return{source:normalFormSource,m20:{status:'partial',fields:m20Fields,source:'Cópia de IRPS-IMOP.xlsx, SHA256 1ceca6f4c6d77853c1b2b445876599b42093175fa89eecf40590180956d83a9e, folhas M,20 e M20A.1; rótulos reutilizados, sem valores de terceiros ou execução das fórmulas do exemplar.',reason:'M20 A.1: correspondência parcial dos custos contabilísticos. Vendas/serviços, fornecimentos/outros gastos, imposto sobre o rendimento e resultado líquido exigem discriminação própria. Divergência concreta: M20A.1 remete resultado para M22 campo201/quadro8; PDF M22 inventariado usa campo200/quadro10. Sem transporte automático entre essas edições; restantes campos independentes conservados.'},fields:values.map(([code,label,value,reason])=>{const centExact=value?(BigInt(value.numerator)*100n)%BigInt(value.denominator)===0n:null;return{code,label,value,centExact,display:value?fractionPresentation(value).decimal+' MZN':'Não preenchido',transcriptionReady:value!==null&&centExact===true,reason:reason+(centExact===false?' Fracção de cêntimo conservada exactamente; regra de representação fiscal por corresponder, sem arredondamento presumido.':'')};})};
}
+39
View File
@@ -0,0 +1,39 @@
import {addFractions,fraction,type FiscalFraction} from './fiscal-rational.ts';
import {convertIrpcAmount,irpcFxDependency,type IrpcFxAmount,type IrpcFxEvidence,irpcFxEvidenceLabel} from './irpc-fx.ts';
import type {rawNormalFinancialSource} from './irpc-normal.ts';
export const normalPeriodFxVersion='IRPC-normal-adjustments/8';
export type NormalPeriodFxInput={version:1;kind:''|'annual'|'start'|'cessation'|'same_year'|'transition';from:string;to:string;planStart:string;reference:string;conversionReference:string;mznMapsReference:string;months:Array<IrpcFxAmount&{period:number}>};
export const newNormalPeriodFx=():NormalPeriodFxInput=>({version:1,kind:'',from:'',to:'',planStart:'',reference:'',conversionReference:'',mznMapsReference:'',months:[]});
export function validateNormalPeriodFx(i:NormalPeriodFxInput){
if(!i||i.version!==1||!['','annual','start','cessation','same_year','transition'].includes(i.kind)||['from','to','planStart','reference','conversionReference','mznMapsReference'].some(k=>typeof i[k as 'from']!=='string')||!Array.isArray(i.months)||new Set(i.months.map(m=>m.period)).size!==i.months.length||i.months.some(m=>!Number.isSafeInteger(m.period)||m.period<1||typeof m.currency!=='string'||m.fxSelection!==undefined&&(!m.fxSelection||typeof m.fxSelection!=='object')||m.fxLink!==undefined&&(!m.fxLink||typeof m.fxLink.id!=='string'||typeof m.fxLink.fingerprint!=='string')))throw Error('Correspondência do período/moeda não recuperável;originais preservados.');
}
const iso=(s:string)=>/^20\d{2}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(Date.parse(s))&&new Date(s).toISOString().slice(0,10)===s;
const month=(s:string)=>Number(s.slice(0,4))*12+Number(s.slice(5,7))-1;
const monthEnd=(s:string)=>{const d=new Date(s+'T00:00:00Z');d.setUTCMonth(d.getUTCMonth()+1,0);return d.toISOString().slice(0,10);};
const amount=(v:FiscalFraction)=>{const n=BigInt(v.numerator)*100n,d=BigInt(v.denominator);if(n%d!==0n)throw Error('Conversão com fracção de cêntimo: representação fiscal por corresponder,sem arredondamento novo.');const c=n/d,a=c<0n?-c:c;return(c<0n?'-':'')+a/100n+'.'+String(a%100n).padStart(2,'0');};
type Source=NonNullable<ReturnType<typeof rawNormalFinancialSource>>;
export function mapNormalPeriodFx(d:Record<string,unknown>,input:NormalPeriodFxInput,raw:Source|null){
validateNormalPeriodFx(input);const pending:string[]=[],short=input.kind!==''&&input.kind!=='annual';let count=0;
if(!input.kind||!input.reference.trim())pending.push('Tipo,evento e suporte da correspondência do período por identificar.');
if(!iso(input.from)||!iso(input.to)||input.from>input.to||!input.from.endsWith('-01')||monthEnd(input.to.slice(0,7)+'-01')!==input.to||!input.to.startsWith('2026-'))pending.push('Recorte:meses completos,termo em2026;datas parciais ou inválidas permanecem por corresponder.');
else{count=month(input.to)-month(input.from)+1;if(count<1||count>12||short&&count>=12||!short&&count!==12)pending.push('Número de meses incompatível com o tipo de período.');}
if(short&&(!input.from.startsWith('2026-')||input.kind==='start'&&input.to!=='2026-12-31'||['cessation','transition'].includes(input.kind)&&input.from!=='2026-01-01'))pending.push('Datas incompatíveis com início,cessação ou transição no ano civil2026.');
if(!iso(input.planStart)||!input.planStart.endsWith('-01'))pending.push('Identifique o primeiro mês civil do plano;meses orçamentais não têm data fiscal presumida.');
if(!input.mznMapsReference.trim())pending.push('Confirme que parcelas,activos,quotas,saldos e mapas fiscais existentes estão reconciliados emMZN com este período;sem converter novamente esses dados.');
if(!raw)pending.push('Plano financeiro reconciliado em falta.');
const selected=raw?.accountingLines[0]?.monthlyAmounts.filter(m=>iso(input.planStart)&&month(input.planStart)+m.period-1>=month(input.from)&&month(input.planStart)+m.period-1<=month(input.to))??[];
if(selected.length!==count||!count)pending.push('Meses do plano não cobrem integralmente o período indicado;sem anualização ou preenchimento de meses em falta.');
if(raw?.currency!=='MZN'&&!input.conversionReference.trim())pending.push('Identifique pressuposto documentado da conversão mensal para a simulação;selecção cambial não confirma,por si,a regra fiscal de conversão anual.');
for(const m of input.months)if(!selected.some(x=>x.period===m.period))pending.push('Selecção cambial sem mês seleccionado no período: '+m.period);
const rows:Array<{code:string;period:number;date:string;originalAmount:string;originalCurrency:string;value:FiscalFraction|null;evidence:IrpcFxEvidence|null;reason:string}>=[];
const lines=raw?.accountingLines.map(l=>{const monthlyAmounts=l.monthlyAmounts.filter(m=>selected.some(x=>x.period===m.period)).map(m=>{let value:FiscalFraction|null=null,evidence:IrpcFxEvidence|null=null,reason='';const day=iso(input.planStart)?new Date(Date.UTC(Number(input.planStart.slice(0,4)),Number(input.planStart.slice(5,7))-1+m.period-1,1)).toISOString().slice(0,10):'';
try{const sign=m.amount.startsWith('-')?-1n:1n,original=sign<0n?m.amount.slice(1):m.amount;const selection=input.months.find(x=>x.period===m.period);if(raw.currency!=='MZN'&&(!selection||selection.currency!==raw.currency))throw Error('Selecção cambial deste mês/moeda em falta;sem usar taxa de outro mês por defeito.');const converted=convertIrpcAmount(d,original,selection??{currency:'MZN'});value=fraction(BigInt(converted.value.numerator)*sign,BigInt(converted.value.denominator));evidence=converted.evidence;amount(value);}catch(e){value=null;reason=String(e);pending.push(l.code+'/mês'+m.period+': '+reason);}
rows.push({code:l.code,period:m.period,date:day,originalAmount:m.amount,originalCurrency:raw.currency,value,evidence,reason});return{period:m.period,amount:value?amount(value):'0.00'};});
const total=addFractions(rows.filter(r=>r.code===l.code&&r.value).map(r=>r.value!));return{...l,monthlyAmounts,total:amount(total)};
})??[];
const ready=pending.length===0;const profit=addFractions(lines.map(l=>{const f=rows.filter(r=>r.code===l.code&&r.value).map(r=>r.value!);const sum=addFractions(f);return l.accountingEffect==='income'?sum:fraction(-BigInt(sum.numerator),BigInt(sum.denominator));}));
return{input:structuredClone(input),short,months:count,originalCurrency:raw?.currency??'',rows,pending,source:ready&&raw?{...raw,currency:'MZN',cashSchedule:raw.currency==='MZN'?raw.cashSchedule.filter(r=>selected.some(m=>m.period===r.period)):[],periods:count,accountingLines:lines,accountingProfitBeforeTax:amount(profit)}:null,rule:'CIRPC7(4)a–d;Decreto72/2013 art9(3)a–c para os casos correspondidos. Meses completos do plano,sem anualização. Conversão para simulação reutiliza mecanismo cambial entregue e pressupostos explícitos;sem confirmação fiscal anual presumida.'};
}
export type NormalPeriodFxModel=ReturnType<typeof mapNormalPeriodFx>;
export function normalPeriodFxDependency(d:Record<string,unknown>,i:NormalPeriodFxInput){return i.months.map(m=>irpcFxDependency(d,m)).filter(Boolean).join(' | ');}
export function normalPeriodFxReport(m:NormalPeriodFxModel):Array<[string,string,string,string]>{return[['IRPC normal — L6','Período e moeda do plano',`${m.input.from}–${m.input.to};${m.months}meses;origem:${m.originalCurrency};resultado emMZN:${m.source?.accountingProfitBeforeTax??'Indeterminado'};${m.originalCurrency!=='MZN'?'Conversão para simulação com pressupostos documentados;regra fiscal anual não confirmada automaticamente.':''}${m.pending.join(' | ')}`,`${m.input.reference};${m.input.conversionReference};${m.input.mznMapsReference};${m.rule}`],...m.rows.map(r=>['IRPC normal — L6',`${({revenue:'Receitas',cost_of_sales:'Custo das vendas',operating_expenses:'Despesas operacionais',personnel:'Pessoal',depreciation:'Depreciação contabilística',interest_expense:'Juros reconhecidos'}as Record<string,string>)[r.code]??r.code}/mês${r.period} (${r.date})`,`Original:${r.originalAmount} ${r.originalCurrency};MZN:${r.value?amount(r.value):'Indeterminado'};${r.reason}`,r.evidence?irpcFxEvidenceLabel(r.evidence):'OrigemMZN;sem conversão']as[string,string,string,string])];}
+64
View File
@@ -0,0 +1,64 @@
import type {NormalDepreciationModel} from './irpc-normal-depreciation.ts';
import type {NormalCostsModel} from './irpc-normal-costs.ts';
import type {SchedulesModel} from './irpc-normal-schedules.ts';
import {addFractions,decimalFraction,fraction,type FiscalFraction} from './fiscal-rational.ts';
export const normalProfitVersion='IRPC-normal-adjustments/2';
export type ProfitEvidence={state:''|'known'|'absent';amount:string;reference:string};
export const profitTopics=[
['positivePatrimonial','Variações patrimoniais positivas fora do resultado'],
['negativePatrimonial','Variações patrimoniais negativas fora do resultado'],
['incomeCorrections','Outras correcções aos proveitos, incluindo exclusões'],
['expenseCorrections','Outras correcções aos custos, além dos acréscimos registados'],
['timing','Diferenças de periodização e de critérios contabilísticos/fiscais'],
['special','Operações especiais, benefícios e regimes fora deste recorte'],
]as const;
export type ProfitTopic=typeof profitTopics[number][0];
export type NormalProfitInput={version:1;completenessReference:string;lines:Array<{code:string;state:''|'known'|'absent';reference:string}>;topics:Record<ProfitTopic,ProfitEvidence>};
export const newNormalProfitInput=():NormalProfitInput=>({version:1,completenessReference:'',lines:[],topics:Object.fromEntries(profitTopics.map(([k])=>[k,{state:'',amount:'',reference:''}]))as NormalProfitInput['topics']});
export function validateNormalProfit(i:NormalProfitInput){
if(!i||i.version!==1||typeof i.completenessReference!=='string'||!Array.isArray(i.lines)||i.lines.some(l=>!l||typeof l.code!=='string'||typeof l.reference!=='string'||!['','known','absent'].includes(l.state))||new Set(i.lines.map(l=>l.code)).size!==i.lines.length||!i.topics||typeof i.topics!=='object'||Array.isArray(i.topics))throw Error('Conferência do lucro tributável não recuperável.');
for(const[k]of profitTopics){const t=i.topics[k];if(!t||!['','known','absent'].includes(t.state)||typeof t.amount!=='string'||typeof t.reference!=='string')throw Error('Estado documental do lucro tributável não recuperável.');}
}
type Source={currency:string;periods:number;accountingLines:Array<{code:string;origin:string;accountingEffect:'income'|'expense';total:string}>};
export type NormalProfitModel={input:NormalProfitInput;lines:Array<{code:string;label:string;amount:string;addedBack:FiscalFraction;remainder:FiscalFraction|null;state:ProfitEvidence['state'];reference:string;reason:string}>;topics:Array<ProfitEvidence&{key:ProfitTopic;label:string;value:FiscalFraction|null;reason:string}>;pending:string[];taxableProfit:FiscalFraction|null;source:string};
const zero=()=>fraction(0n,1n);
function money(s:string){if(!/^-?\d+(?:\.\d{1,2})?$/.test(s))throw Error('Montante inválido');const v=decimalFraction(s.startsWith('-')?s.slice(1):s);return s.startsWith('-')?fraction(-BigInt(v.numerator),BigInt(v.denominator)):v;}
const units=(f:FiscalFraction)=>BigInt(f.numerator)*100n/BigInt(f.denominator);
const difference=(a:FiscalFraction,b:FiscalFraction)=>fraction(BigInt(a.numerator)*BigInt(b.denominator)-BigInt(b.numerator)*BigInt(a.denominator),BigInt(a.denominator)*BigInt(b.denominator));
export function closeNormalProfit(input:NormalProfitInput,source:Source|null,rows:Array<{sourceCode:string;adjustment:FiscalFraction|null;status:string}>,accounting:FiscalFraction|null,additions:FiscalFraction,contextReady:boolean,schedules?:SchedulesModel,costs?:NormalCostsModel,depreciation?:NormalDepreciationModel):NormalProfitModel{
validateNormalProfit(input);const pending:string[]=[],lines:NormalProfitModel['lines']=[],topics:NormalProfitModel['topics']=[];
if(!contextReady)pending.push('Âmbito,exercício,moeda ou correspondência anual ainda insuficientes.');
if(!input.completenessReference.trim())pending.push('Documente que o plano e os ajustamentos abrangem o sujeito passivo/exercício completo;uma oportunidade isolada não equivale automaticamente ao conjunto da empresa.');
if(rows.some(r=>r.status!=='calculated'))pending.push('Existem ajustamentos registados por resolver;acréscimos independentes conservados.');
if(!source)pending.push('Falta resultado financeiro reconciliado.');
for(const l of source?.accountingLines??[]){
const review=input.lines.find(r=>r.code===l.code),state=review?.state??'',reference=review?.reference??'';
const addedBack=addFractions(rows.filter(r=>r.sourceCode===l.code&&r.adjustment).map(r=>r.adjustment!));let remainder:FiscalFraction|null=null;const issues:string[]=[];
try{const amount=money(l.total);remainder=difference(amount,addedBack);if(units(amount)<0n||units(remainder)<0n)issues.push('Valor negativo ou acréscimos superiores à origem;reconcilie a linha sem compensação presumida.');
if(!state||!reference.trim())issues.push('Conferência fiscal e suporte da linha em falta.');
if(state==='absent'&&(units(amount)!==0n||units(addedBack)!==0n))issues.push('Ausência declarada contradiz o montante conhecido da origem.');
if(state==='known'&&l.code==='depreciation'&&units(amount)!==0n&&(depreciation?depreciation.adjustment:schedules?.depreciation)==null)issues.push('Depreciação contabilística conhecida;amortização fiscal por corresponder,não presumir igualdade.');
if(state==='known'&&l.code==='interest_expense'&&units(remainder)!==0n&&schedules?.interest==null)issues.push('Juros financeiros remanescentes conhecidos;dedutibilidade e eventuais limites por corresponder. Só os juros compensatórios já acrescidos estão cobertos.');
if(!['revenue','cost_of_sales','operating_expenses','personnel','depreciation','interest_expense'].includes(l.code))issues.push('Linha financeira sem correspondência neste recorte.');
}catch{issues.push('Montante da linha por reconciliar.');}
const reason=issues.join(' ')|| (state==='absent'?'Ausência expressamente declarada e compatível com a origem zero.':units(remainder??zero())===0n?'Valor conhecido,integralmente corrigido ou igual a zero;sem presumir ausência.':l.accountingEffect==='income'?'Proveito ordinário reconhecido no exercício,qualificado e documentado nos termos dos artigos18/20.':'Parcela remanescente qualificada como custo ordinário indispensável e documentado do artigo22,sem exclusões/limites adicionais declarados.');
if(issues.length)pending.push(l.origin+': '+reason);
lines.push({code:l.code,label:l.origin,amount:l.total,addedBack,remainder,state,reference,reason});
}
for(const l of input.lines)if(!source?.accountingLines.some(s=>s.code===l.code))pending.push('Conferência sem linha de origem actual: '+l.code);
for(const[key,label]of profitTopics){const t=input.topics[key];let value:FiscalFraction|null=null,reason='';
if(!t.state||!t.reference.trim())reason='Informação em falta;sem zero presumido.';
else if(t.state==='absent'){if(t.amount.trim())reason='Ausência declarada com montante preenchido;reconcilie os dois estados.';else{value=zero();reason='Ausência expressamente declarada com suporte;parcela zero apenas por esta declaração.';}}
else{try{value=money(t.amount);if(units(value)!==0n)reason='Montante conhecido,mas tratamento específico ainda por corresponder;conservado sem aplicação presumida.';else reason='Valor conhecido zero com suporte;distinto de ausência declarada.';}catch{reason='Montante conhecido por preencher ou inválido.';}}
const mapped=[...(schedules?.effects??[]),...(costs?.effects??[])].filter(e=>e.topic===key);
const covered=(schedules||costs)&&mapped.length>0&&mapped.every(e=>e.effect!==null)&&value!==null&&t.state==='known'&&units(addFractions(mapped.flatMap(e=>e.amount?[e.amount]:[])))===units(value);
if(covered)reason='Montante reconciliado com as regras do mapa complementar; efeito fiscal discriminado por linha.';
if(value===null||units(value)!==0n&&!covered||t.state==='absent'&&!!t.amount.trim()||mapped.length>0&&!covered)pending.push(label+': '+(mapped.length&&!covered?'Mapa complementar não reconciliado com este estado/montante. ': '')+reason);
topics.push({...structuredClone(t),key,label,value,reason});
}
if(schedules)pending.push(...schedules.pending);
if(costs)pending.push(...costs.pending);
if(depreciation&&!schedules)pending.push(...depreciation.pending);
return{input:structuredClone(input),lines,topics,pending,taxableProfit:pending.length===0&&accounting?addFractions([accounting,additions,...(schedules?[schedules.net]:[]),...(costs?[costs.net]:[]),...(depreciation&&!schedules&&depreciation.adjustment?[depreciation.adjustment]:[])]):null,source:schedules?'CIRPC17/18/20/21/22/24/36; Decreto72/2013 art3–7. Mapa complementar de efeitos com sinal reconciliado por tema, juros financeiros ordinários e quotas anuais constantes documentadas. Simulação emMZN/2026; benefícios e casos especiais separados emL7, saldo anual emL8.':'CIRPC17(1)/18/20/22/36(1)c;recorte anual2026,residente geral,MZN. Resultado antes de imposto + acréscimos36(1)c;demais correcções/variações sem efeito apenas quando ausência ou zero conhecidos expressamente suportados. Receita/custos ordinários classificados pelo utilizador;depreciação fiscal e juros financeiros remanescentes fora deste percurso. Lucro tributável simulado,não matéria colectável,colecta ou declaraçãoM20/22.'};
}
+72
View File
@@ -0,0 +1,72 @@
import {addFractions,decimalFraction,fraction,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
export const normalSchedulesVersion='IRPC-normal-adjustments/5';
export const scheduleRules={
tax_own:['IRPC e impostos sobre o lucro contabilizados','expenseCorrections','36(1)a',1],
tax_other:['Impostos da responsabilidade de outrem','expenseCorrections','36(1)b',1],
undocumented:['Despesa não documentada','expenseCorrections','36(1)g',1],
capital_in:['Entrada de capital fora do resultado','positivePatrimonial','21(1)a',0],
patrimonial_gain:['Variação positiva ordinária fora do resultado','positivePatrimonial','21',1],
capital_out:['Distribuição aos titulares fora do resultado','negativePatrimonial','24(1)c',0],
patrimonial_cost:['Variação negativa indispensável, sem exclusões do artigo24','negativePatrimonial','22/24(1)',-1],
future_cost:['Custo contabilizado em2026 imputável ao exercício seguinte','timing','18(1)',1],
future_income:['Proveito contabilizado em2026 imputável ao exercício seguinte','timing','18(1)',-1],
current_cost:['Custo de2026 ainda não reflectido no resultado','timing','18(1)',-1],
current_income:['Proveito de2026 ainda não reflectido no resultado','timing','18(1)',1],
} as const;
export type ScheduleRule=keyof typeof scheduleRules;
export type ScheduleRow={id:string;rule:''|ScheduleRule;amount:string;sourceCode:string;document:string;line:string;reference:string;fiscalYear:string;conditions:''|'yes'};
export type NormalAsset={id:string;category:''|'computer'|'server'|'other';description:string;cost:string;residual:string;rate:string;accounting:string;previousFiscal:string;inUseFrom:string;tableReference:string;reference:string;conditions:''|'yes'};
export type NormalSchedules={version:1;period:{kind:''|'calendar'|'authorised_annual'|'ep_annual';from:string;to:string;reference:string};rows:ScheduleRow[];interest:{amount:string;reference:string;conditions:''|'yes'};assets:NormalAsset[];assetsReference:string;currentLossReference:string};
export const newNormalSchedules=():NormalSchedules=>({version:1,period:{kind:'',from:'',to:'',reference:''},rows:[],interest:{amount:'',reference:'',conditions:''},assets:[],assetsReference:'',currentLossReference:''});
export const newScheduleRow=(id:string):ScheduleRow=>({id,rule:'',amount:'',sourceCode:'',document:'',line:'',reference:'',fiscalYear:'',conditions:''});
export const newNormalAsset=(id:string):NormalAsset=>({id,category:'',description:'',cost:'',residual:'',rate:'',accounting:'',previousFiscal:'',inUseFrom:'',tableReference:'',reference:'',conditions:''});
export function validateSchedules(s:NormalSchedules){
if(!s||s.version!==1||!Array.isArray(s.rows)||!Array.isArray(s.assets)||!s.interest||typeof s.assetsReference!=='string'||typeof s.currentLossReference!=='string'||['amount','reference','conditions'].some(k=>typeof s.interest[k as 'amount']!=='string')||!['','yes'].includes(s.interest.conditions))throw Error('Mapas L6 não recuperáveis.');
for(const [rows,empty]of [[s.rows,newScheduleRow('')],[s.assets,newNormalAsset('')]]as const){if(new Set(rows.map(r=>r.id)).size!==rows.length)throw Error('Identificador duplicado no mapa L6.');for(const r of rows)if(!r||Object.keys(empty).some(k=>typeof (r as unknown as Record<string,unknown>)[k]!=='string')||!['','yes'].includes(r.conditions))throw Error('Linha L6 não recuperável.');}
if(s.rows.some(r=>r.rule!==''&&!Object.hasOwn(scheduleRules,r.rule)))throw Error('Regra L6 desconhecida.');
if(s.assets.some(a=>!['','computer','server','other'].includes(a.category)))throw Error('Categoria de activo desconhecida.');
if(!s.period||!['','calendar','authorised_annual','ep_annual'].includes(s.period.kind)||['from','to','reference'].some(k=>typeof s.period[k as 'from']!=='string'))throw Error('Período complementar não recuperável.');
}
export function normalSchedulePeriod(s:NormalSchedules,scope:string){
const p=s.period,pending:string[]=[];
const iso=(v:string)=>/^20\d{2}-\d{2}-\d{2}$/.test(v)&&Number.isFinite(Date.parse(v))&&new Date(v).toISOString().slice(0,10)===v;
if(!iso(p.from)||!iso(p.to)||!p.from.endsWith('-01')||!p.to.startsWith('2026-'))pending.push('Período anual por identificar: início no primeiro dia do mês e termo em2026, sem período curto ou alinhamento mensal presumido.');
else{const end=new Date(p.from+'T00:00:00Z');end.setUTCFullYear(end.getUTCFullYear()+1);end.setUTCDate(end.getUTCDate()-1);if(end.toISOString().slice(0,10)!==p.to)pending.push('Os12 meses do plano não correspondem ao período anual indicado.');}
if(!p.kind||!p.reference.trim())pending.push('Identifique tipo de período e correspondência dos12 meses; ausência de informação não é ano civil presumido.');
if(p.kind==='calendar'&&(p.from!=='2026-01-01'||p.to!=='2026-12-31'))pending.push('Datas incompatíveis com o ano civil2026.');
if(p.kind==='ep_annual'&&scope!=='ep_general')pending.push('Período do artigo7(3) exige EP e comunicação documentada; não aplicar a um residente.');
return{...structuredClone(p),pending};
}
const z=()=>fraction(0n);
export const fiscalMoney=(s:string)=>{if(!/^\d{1,18}(?:\.\d{1,2})?$/.test(s))throw Error('Montante não negativo com até dois decimais necessário.');return decimalFraction(s);};
const cmp=(a:FiscalFraction,b:FiscalFraction)=>BigInt(a.numerator)*BigInt(b.denominator)-BigInt(b.numerator)*BigInt(a.denominator);
export type SchedulesModel=ReturnType<typeof calculateSchedules>;
export function calculateSchedules(s:NormalSchedules,source:{accountingLines:Array<{code:string;total:string;accountingEffect:string}>}|null,oldRows:Array<{sourceCode:string;document:string;line:string;amount:string;adjustment:FiscalFraction|null}>,depreciationOverride?:{value:FiscalFraction|null;pending:string[]}){
validateSchedules(s);const pending:string[]=[],effects:Array<{id:string;topic:string;amount:FiscalFraction|null;effect:FiscalFraction|null;reason:string}>=[];
for(const r of s.rows){const issues:string[]=[],rule=r.rule?scheduleRules[r.rule]:null;let amount:FiscalFraction|null=null,effect:FiscalFraction|null=null;
if(!rule||!r.reference.trim()||!r.document.trim()||!r.line.trim()||r.conditions!=='yes')issues.push('Regra, documento/linha, suporte e condições por identificar.');
if(s.rows.some(q=>q!==r&&q.document.trim()===r.document.trim()&&q.line.trim()===r.line.trim())||oldRows.some(q=>q.document.trim()===r.document.trim()&&q.line.trim()===r.line.trim()))issues.push('Documento/linha duplicados entre mapas; sem dupla contagem.');
try{amount=fiscalMoney(r.amount);if(cmp(amount,z())<=0n)throw Error();}catch{issues.push('Parcela positiva por identificar.');}
const topic=rule?.[1]??'';const needsOrigin=topic==='expenseCorrections'||['future_cost','future_income'].includes(r.rule);
if(needsOrigin){const line=source?.accountingLines.find(l=>l.code===r.sourceCode);const wanted=r.rule==='future_income'?'income':'expense';if(!line||line.accountingEffect!==wanted)issues.push('Parcela deve estar incluída numa linha de origem compatível.');else try{const allocated=addFractions([...s.rows.filter(q=>(q.rule&&(['expenseCorrections'].includes(scheduleRules[q.rule][1])||['future_cost','future_income'].includes(q.rule)))&&q.sourceCode===r.sourceCode).map(q=>fiscalMoney(q.amount)),...oldRows.filter(q=>q.sourceCode===r.sourceCode).map(q=>fiscalMoney(q.amount))]);if(cmp(allocated,fiscalMoney(line.total))>0n)issues.push('Parcelas excedem a origem contabilística.');}catch{issues.push('Reconciliação da origem incompleta.');}}
else if(r.sourceCode)issues.push('Variação fora do resultado/custo ou proveito omitido não deve repetir linha já contabilizada.');
if(topic==='timing'&&r.fiscalYear!==(r.rule.startsWith('future_')?'2027':'2026'))issues.push('Exercício de imputação incompatível; este recorte cobre2026/seguinte, sem resolver exercícios anteriores.');
if(!issues.length&&amount&&rule)effect=fraction(BigInt(amount.numerator)*BigInt(rule[3]),BigInt(amount.denominator));
const reason=issues.join(' ')||'CIRPC'+rule?.[2]+'; classificação e condições documentadas pelo utilizador; projecção, sem alteração da contabilidade de origem.';if(issues.length)pending.push(r.document+': '+reason);effects.push({id:r.id,topic,amount,effect,reason});
}
let interest:FiscalFraction|null=null;const interestOrigin=source?.accountingLines.find(l=>l.code==='interest_expense');
try{const corrected=s.rows.filter(r=>r.sourceCode==='interest_expense'&&r.rule&&(scheduleRules[r.rule][1]==='expenseCorrections'||r.rule==='future_cost'));const corrections=corrected.map(r=>{const e=effects.find(e=>e.id===r.id);if(!e?.effect)throw Error();return e.effect;});const remaining=subtractFractions(fiscalMoney(interestOrigin?.total??''),addFractions([...oldRows.filter(r=>r.sourceCode==='interest_expense').flatMap(r=>r.adjustment?[r.adjustment]:[]),...corrections]));interest=fiscalMoney(s.interest.amount);if(cmp(interest,remaining)!==0n||!s.interest.reference.trim()||s.interest.conditions!=='yes')throw Error();}catch{interest=null;}
const assets=(depreciationOverride?[]:s.assets).map(a=>{const issues:string[]=[];let accounting:FiscalFraction|null=null,fiscal:FiscalFraction|null=null,adjustment:FiscalFraction|null=null;
try{const cost=fiscalMoney(a.cost),residual=fiscalMoney(a.residual),previous=fiscalMoney(a.previousFiscal),rate=fiscalMoney(a.rate);accounting=fiscalMoney(a.accounting);const depreciable=subtractFractions(cost,residual);if(cmp(depreciable,z())<0n||cmp(previous,depreciable)>0n||cmp(rate,z())<=0n||cmp(rate,fraction(100n))>0n)throw Error();const annual=fraction(BigInt(depreciable.numerator)*BigInt(rate.numerator),BigInt(depreciable.denominator)*BigInt(rate.denominator)*100n);const available=subtractFractions(depreciable,previous);fiscal=cmp(annual,available)>0n?available:annual;
if(cmp(fiscal,accounting)>0n)issues.push('Quota fiscal superior à contabilizada neste exercício; dedução de quotas anteriormente tributadas exige mapa próprio, sem presunção.');
}catch{issues.push('Custo, residual, taxa, acumulado fiscal e depreciação contabilizada por reconciliar.');}
if(!['computer','server'].includes(a.category)||a.rate!==(a.category==='computer'?'25':'20'))issues.push('Categoria/taxa não correspondida: este recorte cobre tabelaII, grupo3, itens9 (25%) e9.1 (20%), sem regra específica da tabelaI prevalecente.');
if(!/^20\d{2}-\d{2}-\d{2}$/.test(a.inUseFrom)||!Number.isFinite(Date.parse(a.inUseFrom))||new Date(a.inUseFrom).toISOString().slice(0,10)!==a.inUseFrom||a.inUseFrom>(s.period.from||'2026-01-01')||a.inUseFrom<'2014-01-01'||!a.description.trim()||!a.tableReference.trim()||!a.reference.trim()||a.conditions!=='yes')issues.push('Identifique activo próprio, em uso no início do período, tabela/taxa aplicável, vida útil e condições do método constante anual; casos especiais/duodécimos separados.');
if(['computer','server'].includes(a.category)&&/^20\d{2}-\d{2}-\d{2}$/.test(a.inUseFrom)){const limit=new Date(a.inUseFrom+'T00:00:00Z');if(Number.isFinite(+limit)){limit.setUTCFullYear(limit.getUTCFullYear()+(a.category==='computer'?8:10));if((s.period.from||'2026-01-01')>=limit.toISOString().slice(0,10))issues.push('Período máximo de vida útil excedido, artigo5; excepção específica não implementada.');}}
if(!issues.length&&accounting&&fiscal)adjustment=subtractFractions(accounting,fiscal);if(issues.length)pending.push(a.description+': '+issues.join(' '));return{...structuredClone(a),accountingValue:accounting,fiscal,adjustment,reason:issues.join(' ')||'Decreto72/2013 art3–7; quota constante anual documentada, limitada ao saldo fiscal depreciável; diferença para a depreciação contabilística.'};});
let depreciation:FiscalFraction|null=depreciationOverride?.value??null;if(!depreciationOverride)try{const total=addFractions(assets.map(a=>a.accountingValue??z()));if(s.assetsReference.trim()&&assets.every(a=>a.adjustment!==null)&&cmp(total,fiscalMoney(source?.accountingLines.find(l=>l.code==='depreciation')?.total??''))===0n)depreciation=addFractions(assets.map(a=>a.adjustment!));}catch{/* linha de origem desconhecida */}
if(assets.length&&(oldRows.some(r=>r.sourceCode==='depreciation')||s.rows.some(r=>r.sourceCode==='depreciation'))){depreciation=null;pending.push('Depreciação repartida entre mapas de ajustamentos e activos: reconcilie as parcelas sem sobreposição antes de aplicar a quota fiscal.');}
if(assets.length&&depreciation===null)pending.push('Mapa de activos sem reconciliação integral com a depreciação da origem; efeito fiscal não aplicado.');
if(depreciationOverride)pending.push(...depreciationOverride.pending);
return{input:structuredClone(s),effects,interest,depreciation,assets,pending,net: addFractions([...effects.flatMap(r=>r.effect?[r.effect]:[]),...(depreciation?[depreciation]:[])]),source:'CIRPC18/21/22/24/36; Decreto72/2013 art3–7. Entradas documentadas, sem taxas de activos sugeridas nem casos especiais presumidos.'};
}
+106
View File
@@ -0,0 +1,106 @@
import {normalFormPreparationVersion,validateNormalFormPreparation,prepareNormalForms,normalFormPreparationReport,type NormalFormPreparationInput,type NormalFormPreparationModel} from './irpc-normal-form-preparation.ts';
import {normalPeriodFxVersion,validateNormalPeriodFx,mapNormalPeriodFx,normalPeriodFxDependency,normalPeriodFxReport,type NormalPeriodFxInput,type NormalPeriodFxModel} from './irpc-normal-period-fx.ts';
import {normalDepreciationVersion,validateNormalDepreciation,calculateNormalDepreciation,normalDepreciationReport,type NormalDepreciationInput,type NormalDepreciationModel} from './irpc-normal-depreciation.ts';
import {normalCostsVersion,validateNormalCosts,calculateNormalCosts,normalCostReport,type NormalCostsInput,type NormalCostsModel} from './irpc-normal-costs.ts';
import {normalFormFields} from './irpc-normal-forms.ts';
import {normalSchedulesVersion,normalSchedulePeriod,validateSchedules,calculateSchedules,type NormalSchedules,type SchedulesModel} from './irpc-normal-schedules.ts';
import {normalAssessmentVersion,validateNormalAssessment,calculateNormalAssessment,type NormalAssessmentInput,type NormalAssessmentModel} from './irpc-normal-assessment.ts';
import {normalBaseVersion,validateNormalBase,calculateNormalBase,type NormalBaseInput,type NormalBaseModel} from './irpc-normal-base.ts';
import {normalProfitVersion,validateNormalProfit,closeNormalProfit,type NormalProfitInput,type NormalProfitModel} from './irpc-normal-profit.ts';
import {forecastBusinessPlan,restoreBusinessPlanSnapshot} from './business-financial-plan.ts';
import {buildFinancialFiscalBridge} from './financial-fiscal-bridge.ts';
import {acquisitionScope} from './iva-acquisitions.ts';
import {addFractions,decimalFraction,fraction,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
export const irpcNormalVersion='IRPC-normal-adjustments/1';
export const irpcNormalSource='CIRPC Lei34/2007 art17(1),PDF6/p768(60):resultado e correcções;art36(1)c,PDF10/p768(64):multas e encargos por infracções sem origem contratual,incluindo juros compensatórios. Lei4/2012 PDF2 altera17(6)/acrescenta36(1)o;Lei19/2013 PDF2 mantém36(1)a–o e acrescenta p/q. Lei12/2025 altera3/5/20/62/67/75,adita61-A e revoga39/47/75(2)/76;sem alteração deste recorte36(1)c. Não é apuramento integral nem Modelo20/22.';
export type NormalAdjustment={id:string;sourceCode:string;document:string;line:string;amount:string;rule:''|'noncontractual_fine'|'compensatory_interest'|'other';included:''|'yes'|'no';reference:string};
export type NormalBook={version:1;year:string;mappingReference:string;scope:''|'resident_general'|'ep_general'|'other';scopeReference:string;rows:NormalAdjustment[];profit?:NormalProfitInput;base?:NormalBaseInput;assessment?:NormalAssessmentInput;schedules?:NormalSchedules;costs?:NormalCostsInput;depreciation?:NormalDepreciationInput;forms?:NormalFormPreparationInput;periodsFx?:NormalPeriodFxInput;result?:NormalRecord;history?:NormalRecord[]};
type NormalModel={formPreparation?:NormalFormPreparationModel;periodsFx?:NormalPeriodFxModel;depreciation?:NormalDepreciationModel;costs?:NormalCostsModel;fiscalPeriod?:{kind:string;from:string;to:string;reference:string;pending:string[]};schedules?:SchedulesModel;currentLoss?:FiscalFraction|null;assessment?:NormalAssessmentModel;colecta?:FiscalFraction|null;base?:NormalBaseModel;profit?:NormalProfitModel;version:string;year:string;currency:string;origin:'projected';accountingProfit:FiscalFraction|null;additions:FiscalFraction;partialAdjustedResult:FiscalFraction|null;taxableProfit:FiscalFraction|null;taxableBase:FiscalFraction|null;tax:null;rows:Array<NormalAdjustment&{status:'calculated'|'indeterminate'|'outside_scope';adjustment:FiscalFraction|null;reason:string}>;pending:string[];source:string};
type NormalRecord={key:string;createdAt:string;model:NormalModel};
export const newNormalBook=():NormalBook=>({version:1,year:'',mappingReference:'',scope:'',scopeReference:'',rows:[]});
export const newNormalAdjustment=(id:string):NormalAdjustment=>({id,sourceCode:'',document:'',line:'',amount:'',rule:'',included:'',reference:''});
export function rawNormalFinancialSource(d:Record<string,unknown>){
const p=restoreBusinessPlanSnapshot(String(d.business_plan_snapshot??''));if(!p)return null;
const forecast=forecastBusinessPlan(p),bridge=buildFinancialFiscalBridge(forecast);
return{...bridge,periods:forecast.rows.length,origin:'projected' as const,scope:acquisitionScope(d)};
}
export function normalFinancialSource(d:Record<string,unknown>){const raw=rawNormalFinancialSource(d),input=normalBook(d).periodsFx;return input?mapNormalPeriodFx(d,input,raw).source:raw;}
function store(d:Record<string,unknown>){const s=JSON.parse(String(d.modelo_a_snapshot||'{"version":1,"books":{}}'));if(s.version!==1||!s.books||typeof s.books!=='object'||Array.isArray(s.books))throw Error('Livros fiscais não recuperáveis;originais preservados.');return s;}
export function validateNormal(b:NormalBook){
if(b?.forms!==undefined)validateNormalFormPreparation(b.forms);
if(b?.periodsFx!==undefined)validateNormalPeriodFx(b.periodsFx);
if(b?.depreciation!==undefined)validateNormalDepreciation(b.depreciation);
if(b?.costs!==undefined)validateNormalCosts(b.costs);
if(b?.schedules!==undefined)validateSchedules(b.schedules);
if(b?.assessment!==undefined)validateNormalAssessment(b.assessment);
if(b?.base!==undefined)validateNormalBase(b.base);
if(b?.profit!==undefined)validateNormalProfit(b.profit);
if(!b||b.version!==1||['year','mappingReference','scopeReference'].some(k=>typeof b[k as 'year']!=='string')||!['','resident_general','ep_general','other'].includes(b.scope)||!Array.isArray(b.rows)||b.history!==undefined&&!Array.isArray(b.history))throw Error('Preparação IRPC normal não recuperável.');
for(const r of b.rows)if(!r||Object.keys(newNormalAdjustment('')).some(k=>typeof r[k as keyof NormalAdjustment]!=='string')||!['','noncontractual_fine','compensatory_interest','other'].includes(r.rule)||!['','yes','no'].includes(r.included))throw Error('Ajustamento IRPC não recuperável;original conservado.');
if(new Set(b.rows.map(r=>r.id)).size!==b.rows.length)throw Error('Identificador de ajustamento duplicado.');
for(const r of [b.result,...(b.history??[])])if(r&&(!r.model||![irpcNormalVersion,normalProfitVersion,normalBaseVersion,normalAssessmentVersion,normalSchedulesVersion,normalCostsVersion,normalDepreciationVersion,normalPeriodFxVersion,normalFormPreparationVersion].includes(r.model.version)||typeof r.key!=='string'||typeof r.createdAt!=='string'||!Array.isArray(r.model.rows)||!Array.isArray(r.model.pending)))throw Error('Histórico IRPC normal não recuperável.');
}
export function normalBook(d:Record<string,unknown>):NormalBook{
const m=store(d).irpcNormal;if(m===undefined)return newNormalBook();if(!m||typeof m!=='object'||Array.isArray(m))throw Error('Mapa IRPC normal não recuperável.');const b=m[acquisitionScope(d)]??newNormalBook();validateNormal(b);return b;
}
export function saveNormalBook(d:Record<string,unknown>,b:NormalBook){validateNormal(b);const s=store(d);if(s.irpcNormal!==undefined&&(!s.irpcNormal||typeof s.irpcNormal!=='object'||Array.isArray(s.irpcNormal)))throw Error('Mapa IRPC normal não recuperável.');return JSON.stringify({...s,irpcNormal:{...s.irpcNormal,[acquisitionScope(d)]:b}});}
function key(d:Record<string,unknown>,b:NormalBook){return JSON.stringify([b.forms?normalFormPreparationVersion:b.periodsFx?normalPeriodFxVersion:b.depreciation?normalDepreciationVersion:b.costs?normalCostsVersion:b.schedules?normalSchedulesVersion:b.assessment?normalAssessmentVersion:b.base?normalBaseVersion:b.profit?normalProfitVersion:irpcNormalVersion,acquisitionScope(d),d.business_plan_snapshot??'',b.year,b.mappingReference,b.scope,b.scopeReference,b.rows,...(b.profit?[b.profit]:[]),...(b.base?[b.base]:[]),...(b.assessment?[b.assessment]:[]),...(b.schedules?[b.schedules]:[]),...(b.costs?[b.costs]:[]),...(b.depreciation?[b.depreciation]:[]),...(b.periodsFx?[b.periodsFx,normalPeriodFxDependency(d,b.periodsFx)]:[]),...(b.forms?[b.forms]:[])]);}
export function normalCurrent(d:Record<string,unknown>,b:NormalBook){return !!b.result&&b.result.key===key(d,b);}
const zero=()=>fraction(0n,1n);
const cents=(s:string)=>{if(!/^-?\d+(?:\.\d{1,2})?$/.test(s))throw Error('Montante MZN inválido;máximo dois decimais.');const v=decimalFraction(s.startsWith('-')?s.slice(1):s);return s.startsWith('-')?fraction(-BigInt(v.numerator),BigInt(v.denominator)):v;};
const integerCents=(v:FiscalFraction)=>BigInt(v.numerator)*100n/BigInt(v.denominator);
export function calculateNormal(d:Record<string,unknown>,b:NormalBook):NormalModel{
validateNormal(b);const pending:string[]=[],raw=rawNormalFinancialSource(d),periodsFx=b.periodsFx?mapNormalPeriodFx(d,b.periodsFx,raw):undefined,source=periodsFx?periodsFx.source:raw,fiscalPeriod=periodsFx?{kind:b.periodsFx!.kind,from:b.periodsFx!.from,to:b.periodsFx!.to,reference:b.periodsFx!.reference,pending:periodsFx.pending}:b.schedules?normalSchedulePeriod(b.schedules,b.scope):undefined;
if(periodsFx&&b.periodsFx!.kind==='annual'&&b.periodsFx!.from!=='2026-01-01'){
const formal=b.schedules?normalSchedulePeriod(b.schedules,b.scope):null;
if(!formal||formal.pending.length||formal.from!==b.periodsFx!.from||formal.to!==b.periodsFx!.to)fiscalPeriod!.pending.push('Ano diferente do civil exige o período autorizado/comunicado já documentado nos mapas,com as mesmas datas.');
}
if(fiscalPeriod)pending.push(...fiscalPeriod.pending);
if(!source)pending.push('Falta plano financeiro reconciliado.');
if(source?.currency!=='MZN')pending.push('Ponte em MZN necessária;sem conversão fiscal anual presumida.');
if(!/^2026$/.test(b.year)||!b.mappingReference.trim()||source?.periods!==(periodsFx?.months??12))pending.push('Documente correspondência dos 12 meses do plano ao exercício2026;outros exercícios/horizontes permanecem separados.');
if(!(b.scope==='resident_general'||b.schedules&&b.scope==='ep_general')||!b.scopeReference.trim())pending.push('Identifique sujeito residente no regime geral,fora de transparência/regimes especiais;EP e outros âmbitos não abrangidos.');
const rows:NormalModel['rows']=b.rows.map(r=>({...structuredClone(r),status:'indeterminate',adjustment:null,reason:''}));
const amounts=new Map<string,FiscalFraction>(),groups=new Map<string,NormalModel['rows']>();
for(const r of rows){
const line=source?.accountingLines.find(l=>l.code===r.sourceCode);
const issue:string[]=[];
if(!r.document.trim()||!r.line.trim()||!r.reference.trim())issue.push('Identifique documento,linha e suporte da qualificação.');
if(!line||line.accountingEffect!=='expense')issue.push('Seleccione linha de custo existente na ponte.');
if(r.included!=='yes')issue.push('Custo incluído no resultado de partida por demonstrar;sem acréscimo duplicado de montante já excluído.');
try{const a=cents(r.amount);if(integerCents(a)<=0n)throw Error();amounts.set(r.id,a);}catch{issue.push('Montante positivo MZN,até dois decimais,por identificar.');}
if(r.rule==='other'){r.status='outside_scope';issue.push('Outro ajustamento por corresponder;sem regra inventada.');}
else if(!r.rule)issue.push('Seleccione natureza da multa não contratual ou dos juros compensatórios;juros comerciais/penalidades contratuais não equiparados.');
if(rows.some(q=>q!==r&&q.document.trim()===r.document.trim()&&q.line.trim()===r.line.trim()&&r.document.trim()&&r.line.trim()))issue.push('Documento/linha repetidos;reconcilie sem duplicar o encargo.');
if(line){const g=groups.get(line.code)??[];g.push(r);groups.set(line.code,g);}
r.reason=issue.join(' ');
}
for(const [code,group]of groups){const line=source!.accountingLines.find(l=>l.code===code)!;const requested=addFractions(group.map(r=>amounts.get(r.id)??zero()));if(integerCents(requested)>integerCents(cents(line.total)))for(const r of group)r.reason+=' Parcelas excedem o custo da linha de origem;sem dupla contagem.';}
for(const r of rows){if(!r.reason){r.status='calculated';r.adjustment=amounts.get(r.id)!;r.reason='Acréscimo integral de custo incluído no resultado de partida,qualificado pelo utilizador como '+(r.rule==='noncontractual_fine'?'multa/encargo de infracção sem origem contratual':'juros compensatórios')+';CIRPC36(1)c. Projecção pelos pressupostos do plano.';}else pending.push(r.document+': '+r.reason);}
const additions=addFractions(rows.flatMap(r=>r.adjustment?[r.adjustment]:[]));
const accountingProfit=source?.currency==='MZN'?cents(source.accountingProfitBeforeTax):null;
const contextReady=(!fiscalPeriod||fiscalPeriod.pending.length===0)&&!!source&&source.currency==='MZN'&&source.periods===(periodsFx?.months??12)&&b.year==='2026'&&!!b.mappingReference.trim()&&(b.scope==='resident_general'||!!b.schedules&&b.scope==='ep_general')&&!!b.scopeReference.trim();
if(rows.length===0&&!b.profit)pending.push('Sem ajustamentos documentados;ausência de registos não prova inexistência de correcções.');
if(!b.profit)pending.push('L6 parcial:resultado ajustado apenas destes acréscimos;restantes custos/variações patrimoniais,amortizações,perdas,deduções e colecta por tratar. Lucro tributável,matéria colectável e imposto indeterminados.');
const depreciation=b.depreciation?calculateNormalDepreciation(b.depreciation,source,fiscalPeriod??{from:b.year+'-01-01',to:b.year+'-12-31'},[...b.rows,...(b.schedules?.rows??[]),...(b.costs?.rows??[])],!!periodsFx?.short):undefined;
const schedules=b.schedules?calculateSchedules(b.schedules,source,rows,depreciation?{value:depreciation.adjustment,pending:depreciation.pending}:undefined):undefined;
const costs=b.costs?calculateNormalCosts(b.costs,source,[...b.rows,...(b.schedules?.rows??[])],fiscalPeriod??{from:'2026-01-01',to:b.year+'-12-31'},!!periodsFx?.short):undefined;
const profit=b.profit?closeNormalProfit(b.profit,source,rows,accountingProfit,additions,contextReady,schedules,costs,depreciation):undefined;
if(profit&&periodsFx)profit.source='CIRPC17/18/20/21/22/24/36;'+periodsFx.rule+' L7 mantém benefícios/casos especiais;L8 mantém saldo final.';
if(profit)pending.push(...profit.pending,...(!b.base?['Matéria colectável,perdas reportadas,deduções e imposto não apurados neste percurso.']:[]));
const base=b.base?calculateNormalBase(b.base,profit?.taxableProfit??null,b.year,b.schedules?.currentLossReference,!!periodsFx?.short):undefined;
if(base)pending.push(...base.pending,...(!b.assessment?['Colecta/imposto a pagar,créditos anuais eM20/M22 não determinados;matéria colectável não é imposto.']:[]));
const assessment=b.assessment?calculateNormalAssessment(b.assessment,base?.taxableBase??null,{year:b.year,scope:b.scope,extended:!!b.schedules||!!periodsFx,short:!!periodsFx?.short,currency:source?.currency??'',...(fiscalPeriod?{period:{from:fiscalPeriod.from,to:fiscalPeriod.to}}:{})}):undefined;
if(assessment)pending.push(...assessment.pending,assessment.finalBalance.reason);
const currentLoss=b.schedules&&profit?.taxableProfit&&BigInt(profit.taxableProfit.numerator)<0n?fraction(-BigInt(profit.taxableProfit.numerator),BigInt(profit.taxableProfit.denominator)):null;
const model:NormalModel={...(periodsFx?{periodsFx}:{}),...(depreciation?{depreciation}:{}),...(costs?{costs}:{}),...(schedules?{schedules,currentLoss,fiscalPeriod}:{}),...(assessment?{assessment,colecta:assessment.colecta}:{}),...(base?{base}:{}),...(profit?{profit}:{}),version:b.forms?normalFormPreparationVersion:b.periodsFx?normalPeriodFxVersion:b.depreciation?normalDepreciationVersion:b.costs?normalCostsVersion:b.schedules?normalSchedulesVersion:b.assessment?normalAssessmentVersion:b.base?normalBaseVersion:b.profit?normalProfitVersion:irpcNormalVersion,year:b.year,currency:source?.currency??'',origin:'projected',accountingProfit,additions,partialAdjustedResult:contextReady&&rows.length>0&&rows.every(r=>r.status==='calculated')&&accountingProfit?addFractions([accountingProfit,additions]):null,taxableProfit:profit?.taxableProfit??null,taxableBase:base?.taxableBase??null,tax:null,rows,pending,source:irpcNormalSource+(periodsFx?' '+periodsFx.rule:b.schedules?' Mapas complementares: CIRPC18/21/22/24/36; Decreto72/2013 art3–7. EP: CIRPC15(1)c, apenas resultado imputável ao estabelecimento no regime geral, anual2026/MZN.':'')};
if(b.forms){model.formPreparation=prepareNormalForms(b.forms,model,source);model.pending.push(...model.formPreparation.pending.map(p=>'Preparação M20/M22: '+p));}
return model;
}
export function recordNormal(d:Record<string,unknown>,b:NormalBook,now=new Date().toISOString()):NormalBook{return{...b,history:b.result?[...(b.history??[]),structuredClone(b.result)]:b.history??[],result:{key:key(d,b),createdAt:now,model:calculateNormal(d,b)}};}
const money=(v:FiscalFraction|null)=>v?fractionPresentation(v).decimal+' MZN':'Indeterminado';
function normalBaseReport(m:NormalBaseModel):Array<[string,string,string,string]>{return[['IRPC normal — L6','Matéria colectável — deduções/perdas',`Lucro tributável:${money(m.taxableProfit)};perdas propostas elegíveis:${money(m.requestedLosses)};perdas deduzidas nesta simulação:${money(m.deductedLosses)};benefícios deduzidos:${money(m.benefitDeduction)};matéria colectável simulada:${money(m.taxableBase)};imposto a pagar:Indeterminado. ${m.pending.join(' | ')}`,`NUIT:${m.input.subjectNuit};${m.input.identityReference};método:${m.input.method==='direct'?'Declarativo/directo':m.input.method==='indirect'?'Indirecto':'Por identificar'};${m.input.methodReference};perdas:${m.input.lossesState==='absent'?'Ausência declarada':m.input.lossesState==='known'?'Conhecidas':'Informação em falta'};${m.input.lossesReference};objecto:${m.input.unchangedObject==='yes'?'Sem alteração declarada':m.input.unchangedObject==='no'?'Alteração declarada':'Por esclarecer'};${m.input.objectReference};${m.source}`],['IRPC normal — L6','Benefícios à matéria colectável',`Estado:${m.input.benefits.state==='known'?'Valor conhecido':m.input.benefits.state==='absent'?'Ausência declarada':'Informação em falta'};montante original:${m.input.benefits.amount||'Não preenchido'};dedução:${money(m.benefitDeduction)};não inclui créditos à colecta ou retenções sofridas.`,m.input.benefits.reference],...m.losses.map(l=>['IRPC normal — L6','Perda fiscal de '+l.year,`Estado:${l.status==='eligible'?'Elegível neste recorte':l.status==='excluded'?'Excluída neste exercício':'Indeterminada'};apurada:${l.assessed};utilizada antes:${l.previouslyUsed};saldo:${money(l.available)};utilização proposta:${l.requested};dedução nesta simulação:${money(l.deducted)};saldo aritmético posterior:${money(l.remaining)};último exercício ordinário:${l.lastOrdinaryYear??'Por determinar'};${l.reason}`,`NUIT:${l.subjectNuit};${l.reference};sem consumo do saldo oficial nem reporte automático.`]as[string,string,string,string])];}
function normalAssessmentReport(m:NormalAssessmentModel):Array<[string,string,string,string]>{return[['IRPC normal — L6','Colecta — regime normal',`Matéria colectável:${money(m.taxableBase)};taxa:${m.rate?m.rate.numerator+'%':'Por identificar'};colecta simulada:${money(m.colecta)};${m.classification};${m.centExact===false?'Valor racional exacto com fracção de cêntimo;sem arredondamento fiscal aplicado.':''}${m.pending.join(' | ')}`,`Exercício:${m.period.year};período:${m.period.from}–${m.period.to};${m.input.reference};${m.rule};${m.source}`],['IRPC normal — L6','Saldo final — âmbito L8','A pagar:Indeterminado;a recuperar:Indeterminado. '+m.finalBalance.reason,'Sequência:lucro tributável → matéria colectável → colecta → saldo final;retenções,pagamentos e créditos anuais reservados aL8.']];}
export function normalReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=normalBook(d),r=b.result;if(!r)return[];const m=r.model;return[['IRPC normal — L6','Ajustamentos ao resultado financeiro',`Exercício:${m.year};resultado contabilístico antes de imposto:${money(m.accountingProfit)};acréscimos demonstrados:${money(m.additions)};resultado parcial ajustado:${money(m.partialAdjustedResult)};${m.profit?'lucro tributável simulado:'+money(m.taxableProfit)+(m.base?';matéria colectável simulada:'+money(m.taxableBase)+(m.assessment?';colecta simulada:'+money(m.colecta??null)+';saldo final a pagar ou recuperar:Indeterminado (L8).':';imposto a pagar:Indeterminado.'):';matéria colectável/imposto:Indeterminados.'):'lucro tributável/matéria colectável/imposto:Indeterminados.'} Projecção com pressupostos;${m.pending.join(' | ')}`,`${normalCurrent(d,b)?'Entradas correspondentes':'Histórico;origem ou entradas alteradas'};${r.createdAt};${m.source}`],...(m.formPreparation?normalFormPreparationReport(m.formPreparation):[]),...(m.periodsFx?normalPeriodFxReport(m.periodsFx):[]),...(m.depreciation?normalDepreciationReport(m.depreciation):[]),...(m.costs?normalCostReport(m.costs):[]),...(m.base?normalBaseReport(m.base):[]),...(m.assessment?normalAssessmentReport(m.assessment):[]),...(m.schedules?[['IRPC normal — L6','Mapas complementares',`Efeito líquido adicional:${money(m.schedules.net)};perda fiscal do próprio exercício:${money(m.currentLoss??null)};sem reporte ou consumo automático. ${m.schedules.pending.join(' | ')}`,m.schedules.source]as[string,string,string,string],...m.schedules.effects.map(e=>{const i=m.schedules!.input.rows.find(r=>r.id===e.id)!;return['IRPC normal — L6',i.document+'/'+i.line,`Montante:${money(e.amount)};efeito:${money(e.effect)};${e.reason}`,`${i.reference};exercício de imputação:${i.fiscalYear||'Não aplicável'}`]as[string,string,string,string];}),...m.schedules.assets.map(a=>['IRPC normal — L6',a.description,`Depreciação contabilística:${money(a.accountingValue)};quota fiscal:${money(a.fiscal)};acréscimo:${money(a.adjustment)};${a.reason}`,`${a.tableReference};${a.reference}`]as[string,string,string,string]),['IRPC normal — L6','Juros financeiros ordinários',`Remanescente aceite no recorte:${money(m.schedules.interest)};não corresponde a juros de mora/compensatórios L5.`,m.schedules.input.interest.reference]as[string,string,string,string]]:[]),...(m.schedules&&!m.formPreparation?[...normalFormFields(m).fields.map(f=>['IRPC normal — L6','M22 campo '+f.code+' — '+f.label,`${f.display};exacto:${f.value?f.value.numerator+'/'+f.value.denominator:'Indeterminado'};transcrição:${f.transcriptionReady?'Preparação parcial com valor exacto ao cêntimo':'Pendente ou sem aplicação'};${f.reason}`,normalFormFields(m).source]as[string,string,string,string]),...normalFormFields(m).m20.fields.map(f=>['IRPC normal — L6','M20 A.1 — conta '+f.account+' — '+f.label,`${f.display};representação em meticais inteiros:${f.transcriptionReady?'Exacta':'Pendente'};${f.reason}`,`${f.reference};${normalFormFields(m).m20.source}`]as[string,string,string,string]),['IRPC normal — L6','M20 — correspondência',normalFormFields(m).m20.reason,normalFormFields(m).m20.source]as[string,string,string,string]]:[]),...m.rows.map(r=>['IRPC normal — L6',r.document+'/'+r.line,`${({calculated:'Calculado neste recorte',indeterminate:'Indeterminado',outside_scope:'Fora deste recorte'})[r.status]};montante:${r.amount};acréscimo:${money(r.adjustment)};${r.reason}`,`Origem:${({revenue:'Receitas',cost_of_sales:'Custo das vendas',operating_expenses:'Despesas operacionais',personnel:'Pessoal',depreciation:'Depreciação contabilística',interest_expense:'Juros reconhecidos'}as Record<string,string>)[r.sourceCode]??'Por corresponder'};incluído:${r.included==='yes'?'Sim':r.included==='no'?'Não':'Por demonstrar'};suporte:${r.reference}`]as[string,string,string,string]),...(m.profit?[...m.profit.lines.map(l=>['IRPC normal — L6','Conferência: '+l.label,`Estado:${l.state==='known'?'Valor conhecido':l.state==='absent'?'Ausência declarada':'Informação em falta'};origem:${l.amount};acréscimos:${money(l.addedBack)};remanescente:${money(l.remainder)};${l.reason}`,l.reference]as[string,string,string,string]),...m.profit.topics.map(t=>['IRPC normal — L6',t.label,`Estado:${t.state==='known'?'Valor conhecido':t.state==='absent'?'Ausência declarada':'Informação em falta'};montante:${money(t.value)};${t.reason}`,t.reference]as[string,string,string,string]),['IRPC normal — L6','Âmbito da conferência',m.profit.input.completenessReference,m.profit.source]as[string,string,string,string]]:[])];}catch(e){return[['IRPC normal — L6','Não recuperável',String(e),'Originais conservados.']];}}
export function normalHtml(d:Record<string,unknown>){const b=normalBook(d);if(!normalCurrent(d,b))throw Error('Calcule e guarde as entradas actuais antes de exportar.');const esc=(s:string)=>s.replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]!));return'<!doctype html><html lang="pt"><meta charset="utf-8"><title>IRPC normal — ajustamentos</title><h1>L6 — mapa parcial de ajustamentos</h1><p>Projecção pelos pressupostos do plano. Não é demonstração contabilística,liquidação ou Modelo20/22.</p>'+normalReportRows(d).map(r=>'<section><h2>'+esc(r[1])+'</h2><p>'+esc(r[2])+'</p><small>'+esc(r[3])+'</small></section>').join('')+'</html>';}
@@ -0,0 +1,96 @@
import type {IrpcRow} from './irpc-withholdings.ts';
export const irpcReliefVersion = 'IRPC-L5-reliefs/1';
export type IrpcReliefPreparation = {
rule?: '' | 'cirpc68d' | 'cirpc68f' | 'ptMz12';
facts?: Partial<Record<'subjectToIrpc' | 'notTransparent' | 'treatyResident' | 'beneficialOwner' | 'payerResidentMz' | 'armLength' | 'royaltyDefinition', '' | 'yes' | 'no'>>;
kind: 'dispensation' | 'exemption' | 'treaty';
instrument: string;
article: string;
country: string;
residenceDocument: string;
validFrom: string;
validTo: string;
conditions: string;
evidence: string;
};
export const irpcReliefRules = [
['', 'Correspondência por identificar'],
['cirpc68d', 'Dispensa — artigo 68(d), serviços / uso de equipamento'],
['cirpc68f', 'Dispensa — artigo 68(f), gestão de imóveis próprios'],
['ptMz12', 'Portugal–Moçambique — royalties, artigo 12'],
] as const;
const documentLabels: Record<string,string> = {instrument:'diploma/convenção',article:'artigo',validFrom:'início do período',validTo:'fim do período',conditions:'condições',evidence:'documentos',country:'Estado contratante',residenceDocument:'prova de residência'};
const factLabels: Record<string,string> = {subjectToIrpc:'Titular sujeito a IRPC neste rendimento',notTransparent:'Fora da transparência fiscal',treatyResident:'Residência convencional em Portugal',beneficialOwner:'Beneficiário efectivo',payerResidentMz:'Devedor residente em Moçambique',armLength:'Sem excesso por relações especiais',royaltyDefinition:'Definição convencional de royalties'};
export function evaluateIrpcRelief(row: IrpcRow, eventDate: string):
{applied: false; reason: string} | {applied: true; treatment: 'dispensed' | 'treaty'; rate: number; reason: string; rule: string} {
const e = row.reliefPreparation;
if (!e) return {applied: false, reason: 'Identifique a regra da dispensa/convenção e os documentos aplicáveis.'};
const preparation = prepareIrpcRelief(row, e);
if (preparation.missing.length || !preparation.validPeriod || eventDate < e.validFrom || eventDate > e.validTo)
return {applied: false, reason: 'Informação insuficiente ou período incompatível na dispensa/convenção: ' + preparation.missing.map(k=>documentLabels[k]).join(', ') + '. Confira o período e a prova aplicáveis ao primeiro evento.'};
const f = e.facts ?? {};
const article = e.article.toLowerCase().replace(/[^a-z0-9]/g, '');
if (e.rule === 'cirpc68d' && article !== '68d' || e.rule === 'cirpc68f' && article !== '68f' || e.rule === 'ptMz12' && article !== '12')
return {applied: false, reason: 'O artigo invocado diverge da regra seleccionada; reconcilie a referência sem apagar a prova.'};
const onAccount = row.residence === 'resident' || row.residence === 'nonresident' && row.permanentEstablishment === 'yes' && row.attributable === 'yes';
if (e.rule === 'cirpc68d' || e.rule === 'cirpc68f') {
if (e.kind !== 'dispensation' || f.subjectToIrpc !== 'yes' || row.recipientIrpc !== 'yes' || !row.ordinary || row.ordinary.nonDigital !== 'yes' || !row.ordinary.reference.trim())
return {applied: false, reason: 'Dispensa: identifique o titular sujeito a IRPC relativamente a este rendimento e a classificação não digital, com suporte.'};
if (e.rule === 'cirpc68d' && (!onAccount || !['equipment', 'services'].includes(row.kind)))
return {applied: false, reason: 'Artigo 68(d) exige rendimento 67(1)b/g com natureza de imposto por conta; não dispensa retenções definitivas.'};
if (e.rule === 'cirpc68f' && (row.kind !== 'rent' || row.ordinary.rentOwnPropertyManagement !== 'yes' || f.notTransparent !== 'yes'))
return {applied: false, reason: 'Artigo 68(f): faltam rendas de sociedade de gestão de imóveis próprios e exclusão documentada da transparência fiscal (6(1)c).'};
return {applied: true, treatment: 'dispensed', rate: 0, rule: e.rule,
reason: `Dispensa de retenção ${e.rule === 'cirpc68d' ? '68(d), rendimentos 67(1)b/g' : '68(f), rendimentos prediais 67(1)c e 6(1)c'}; CIRPC Lei 34/2007, PDF19/p768(73). Sem retenção nesta operação; não é isenção do rendimento nem crédito anual.`};
}
if (e.rule === 'ptMz12') {
if (e.kind !== 'treaty' || !['PT', 'PORTUGAL'].includes(e.country.trim().toUpperCase()) || row.residence !== 'nonresident' || row.permanentEstablishment !== 'no' || !['royalty', 'equipment'].includes(row.kind) || row.ordinary?.nonDigital !== 'yes' || !row.ordinary.reference.trim())
return {applied: false, reason: 'Convenção PT–MZ, artigo 12: este recorte exige titular residente em Portugal, sem EP em Moçambique e royalties/uso de equipamento qualificados não digitais. Outros casos conservam correspondência própria.'};
if (['treatyResident', 'beneficialOwner', 'payerResidentMz', 'armLength', 'royaltyDefinition'].some(k => f[k as keyof typeof f] !== 'yes'))
return {applied: false, reason: 'Informação insuficiente: documente residência convencional (art.4), beneficiário efectivo, devedor residente em Moçambique, definição de royalties e ausência de excesso por relações especiais (art.12(2–6)).'};
return {applied: true, treatment: 'treaty', rate: 10, rule: e.rule,
reason: 'Limite convencional de 10% sobre royalties brutas: CDT PT–MZ artigo12(2–6), RAR36/1992; definição12(3) e IRPC actualizados pelo Protocolo/RAR36/2009 arts1/7. Cálculo da retenção; formalidades de accionamento e MRFTA não equivalem a submissão ou aceitação AT.'};
}
return {applied: false, reason: 'Dispensa, isenção ou convenção sem correspondência executável neste recorte; conserve os documentos e identifique a regra específica.'};
}
export const newIrpcReliefPreparation = (): IrpcReliefPreparation => ({
kind: 'dispensation', instrument: '', article: '', country: '',
residenceDocument: '', validFrom: '', validTo: '', conditions: '', evidence: '',
});
// A preparation records an invocation; it does not activate a tax rule.
export function prepareIrpcRelief(row: IrpcRow, evidence: IrpcReliefPreparation) {
const missing = (['instrument', 'article', 'validFrom', 'validTo', 'conditions', 'evidence'] as const)
.filter(key => !evidence[key].trim()).map(String);
if (evidence.kind === 'treaty') {
if (!evidence.country.trim()) missing.push('country');
if (!evidence.residenceDocument.trim()) missing.push('residenceDocument');
}
const validDate = (s: string) => /^\d{4}-\d{2}-\d{2}$/.test(s) &&
Number.isFinite(Date.parse(s)) && new Date(s).toISOString().slice(0, 10) === s;
const validPeriod = validDate(evidence.validFrom) && validDate(evidence.validTo) && evidence.validFrom <= evidence.validTo;
const outsidePeriod = validPeriod && row.events.some(event => validDate(event.date) &&
(event.date < evidence.validFrom || event.date > evidence.validTo));
return {
counterparty: row.counterparty, residence: row.residence,
permanentEstablishment: row.permanentEstablishment, attributable: row.attributable,
documentRef: row.documentRef, qualificationRef: row.qualificationRef,
previousReference: row.reliefRef, evidence: structuredClone(evidence),
missing, validPeriod, outsidePeriod,
status: 'preparation' as const,
notice: 'Condições e documentos invocados; o cálculo verifica apenas a regra seleccionada e o período aplicável.',
};
}
export function irpcReliefEvidenceLabel(row: IrpcRow): string {
const e = row.reliefPreparation;
if (!e) return row.reliefRef || 'Sem benefício invocado';
const p = prepareIrpcRelief(row, e);
return `${irpcReliefRules.find(([rule])=>rule===e.rule)?.[1]??'Regra por corresponder'};${e.instrument};artigo:${e.article};período:${e.validFrom}–${e.validTo};Estado:${e.country};residência fiscal:${e.residenceDocument};condições:${e.conditions};provas:${e.evidence};${Object.entries(e.facts??{}).map(([k,v])=>`${factLabels[k]??k}:${v==='yes'?'Sim':v==='no'?'Não':'Por esclarecer'}`).join(';')};${p.missing.length?'Falta: '+p.missing.map(k=>documentLabels[k]).join(', '):'Elementos documentais registados'};${p.validPeriod?'Período válido':'Período por resolver'};referência anterior:${row.reliefRef}`;
}
+122
View File
@@ -0,0 +1,122 @@
import {validateMrfta,mrftaReportRows,type MrftaStore} from './irpc-mrfta.ts';
import {irpcReliefVersion,evaluateIrpcRelief,irpcReliefEvidenceLabel,type IrpcReliefPreparation} from './irpc-relief-preparation.ts';
import {convertIrpcAmount,irpcFxDependency,irpcFxEvidenceLabel,type IrpcFxAmount,type IrpcFxEvidence} from './irpc-fx.ts';
import {acquisitionBook,acquisitionScope} from './iva-acquisitions.ts';
import {salesBook} from './iva-operations.ts';
import {closureFingerprint} from './iva-closure.ts';
import {addFractions,decimalFraction,fraction,fractionPresentation,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
export const irpcWithholdingVersion='irpc-L5/1';
export const irpcWithholdingSource='Lei12/2025,BR248/2025,PDF19/p2180(19):arts5(5/7),20(2)c,62(5)a/b e67(5/7);CIRPC Lei34/2007 arts2,62/67/68,PDF17–19/p768(71–73);Lei19/2013 PDF2/p682(22),62(3/4);Lei20/2022 BR252 p2731/PDF1,62(1–5). Art67(7)remete62(6),enquanto taxa nova consta62(5):divergência formal preservada,sem renumerar o original. MRFTA19/39AT,p1–2. Código2002 revogado não usado. Outros regimes/taxas dependem da correspondência específica,sem zero presumido.';
type Choice=''|'yes'|'no';
export type IrpcKind=''|'digital_goods'|'digital_services'|'emoney_commission'|'royalty'|'equipment'|'rent'|'capital'|'services'|'telecom'|'international_transport'|'connected_installation'|'aircraft_maintenance_charter'|'rural_public_electrification'|'maritime_fishing_cabotage'|'other';
export const irpcKinds:Array<[IrpcKind,string]>=[['','Por identificar'],['digital_goods','Transmissão de bens digitais'],['digital_services','Prestação de serviços digitais'],['emoney_commission','Comissão de agente de moeda electrónica'],['royalty','Propriedade intelectual/industrial'],['equipment','Uso de equipamento'],['rent','Rendimento predial'],['capital','Aplicação de capitais'],['services','Outras prestações/intermediação'],['telecom','Serviços de telecomunicações — artigo62(4)a'],['international_transport','Transportes internacionais — artigo62(4)a'],['connected_installation','Montagem/instalação de equipamentos conexos a telecomunicações/transportes —62(4)a'],['aircraft_maintenance_charter','Manutenção e fretamento de aeronaves —62(4)a'],['rural_public_electrification','Construção/reabilitação de infraestruturas de produção,transporte e distribuição de energia eléctrica,nas zonas rurais,em projectos públicos de electrificação rural —62(4)b'],['maritime_fishing_cabotage','Afretamento de embarcações marítimas para pesca/cabotagem —62(4)c'],['other','Outro enquadramento']];
export type IrpcEvent={kind:'cost'|'payment'|'maturity'|'availability'|'liquidation'|'quantification';date:string;reference:string};
export type IrpcPayment=IrpcFxAmount&{id:string;kind:'beneficiary'|'remittance'|'withholding_proof';reference:string;date:string;amount:string;currency:string};
export type IrpcOrdinaryFacts={nonDigital:Choice;capitalType:''|'unlisted_interest'|'unlisted_dividend'|'listed_debt_mz'|'listed_other_mz'|'liquidity_repo'|'other';rentOwnPropertyManagement:Choice;specialFacts:Choice;capitalSeatAndManagement?:Choice;reference:string};
export const emptyIrpcOrdinaryFacts=():IrpcOrdinaryFacts=>({nonDigital:'',capitalType:'',rentOwnPropertyManagement:'',specialFacts:'',capitalSeatAndManagement:'',reference:''});
export type IrpcRow=IrpcFxAmount&{reliefPreparation?:IrpcReliefPreparation;ordinary?:IrpcOrdinaryFacts;id:string;direction:'paid'|'received';counterparty:string;documentRef:string;description:string;base:string;currency:string;origin:'projected'|'effective';kind:IrpcKind;recipientIrpc:Choice;payerIrpc:Choice;residence:''|'resident'|'nonresident';permanentEstablishment:Choice;attributable:Choice;mozambique:Choice;qualificationRef:string;specialRelief:''|'none'|'claimed';reliefRef:string;eventsComplete:Choice;events:IrpcEvent[];settlement:''|'none'|'complete';settlementRef:string;allocations:Array<{paymentId:string;amount:string}>;source?:{id:string;key:string;fingerprint:string};};
export type IrpcResult={treatment?:'dispensed'|'treaty';reliefRule?:string;id:string;status:'calculated'|'indeterminate'|'outside_scope';reason:string;period:string;eventDate:string;nature:'definitive'|'on_account'|null;rate:number|null;base:FiscalFraction|null;tax:FiscalFraction|null;settled:FiscalFraction|null;outstanding:FiscalFraction|null;direction:IrpcRow['direction'];conversion?:IrpcFxEvidence|null};
export type IrpcBook=MrftaStore&{version:1;rows:IrpcRow[];payments:IrpcPayment[];result?:{version:string;key:string;calculatedAt:string;inputs:IrpcRow[];payments:IrpcPayment[];rows:IrpcResult[];paymentConversions?:Record<string,IrpcFxEvidence|null>};history?:Array<NonNullable<IrpcBook['result']>>};
export const newIrpcRow=(id:string):IrpcRow=>({id,direction:'paid',counterparty:'',documentRef:'',description:'',base:'',currency:'MZN',origin:'projected',kind:'',recipientIrpc:'',payerIrpc:'',residence:'',permanentEstablishment:'',attributable:'',mozambique:'',qualificationRef:'',specialRelief:'',reliefRef:'',eventsComplete:'',events:[],settlement:'',settlementRef:'',allocations:[]});
function store(d:Record<string,unknown>){const s=JSON.parse(String(d.modelo_a_snapshot||'{"version":1,"books":{}}'));if(s.version!==1||!s.books||typeof s.books!=='object'||Array.isArray(s.books))throw Error('Livros fiscais não recuperáveis;originais preservados.');return s;}
function map(d:Record<string,unknown>):Record<string,IrpcBook>{const m=store(d).irpcWithholdings;if(m===undefined)return{};if(!m||typeof m!=='object'||Array.isArray(m))throw Error('Mapa IRPC não recuperável;originais preservados.');return m;}
function validate(b:IrpcBook){
if(!b||b.version!==1||!Array.isArray(b.rows)||!Array.isArray(b.payments)||b.history!==undefined&&!Array.isArray(b.history))throw Error('Livro IRPC não recuperável.');
validateMrfta(b);
for(const r of b.rows){const template=newIrpcRow('');if(!r||Object.keys(template).filter(k=>typeof template[k as keyof IrpcRow]==='string').some(k=>typeof r[k as keyof IrpcRow]!=='string')||!['paid','received'].includes(r.direction)||!['projected','effective'].includes(r.origin)||!irpcKinds.some(([k])=>k===r.kind)||!['','resident','nonresident'].includes(r.residence)||!['','none','claimed'].includes(r.specialRelief)||!['','none','complete'].includes(r.settlement)||['recipientIrpc','payerIrpc','permanentEstablishment','attributable','mozambique','eventsComplete'].some(k=>!['','yes','no'].includes(r[k as keyof IrpcRow]as string))||!Array.isArray(r.events)||!Array.isArray(r.allocations)||r.events.some(e=>!e||!['cost','payment','maturity','availability','liquidation','quantification'].includes(e.kind)||typeof e.date!=='string'||typeof e.reference!=='string')||r.allocations.some(a=>!a||typeof a.paymentId!=='string'||typeof a.amount!=='string')||r.source!==undefined&&(!r.source||!['id','key','fingerprint'].every(k=>typeof r.source![k as keyof NonNullable<IrpcRow['source']>]==='string')))throw Error('Entradas IRPC não recuperáveis;sem apagar ou repor vazios.');}
for(const r of b.rows)if(r.reliefPreparation&&(r.reliefPreparation.rule!==undefined&&!['','cirpc68d','cirpc68f','ptMz12'].includes(r.reliefPreparation.rule)||r.reliefPreparation.facts!==undefined&&(!r.reliefPreparation.facts||typeof r.reliefPreparation.facts!=='object'||Array.isArray(r.reliefPreparation.facts)||Object.values(r.reliefPreparation.facts).some(v=>!['','yes','no'].includes(v)))))throw Error('Condições da dispensa/convenção não recuperáveis.');
for(const r of b.rows)if(r.reliefPreparation&&(!['dispensation','exemption','treaty'].includes(r.reliefPreparation.kind)||['instrument','article','country','residenceDocument','validFrom','validTo','conditions','evidence'].some(k=>typeof r.reliefPreparation![k as keyof IrpcReliefPreparation]!=='string')))throw Error('Preparação de dispensa/convenção não recuperável;original preservado.');
for(const r of b.rows)if(r.ordinary&&(['nonDigital','rentOwnPropertyManagement','specialFacts'].some(k=>!['','yes','no'].includes(r.ordinary![k as 'nonDigital'|'rentOwnPropertyManagement'|'specialFacts']))||typeof r.ordinary.reference!=='string'||!['','unlisted_interest','unlisted_dividend','listed_debt_mz','listed_other_mz','liquidity_repo','other'].includes(r.ordinary.capitalType)))throw Error('Factos específicos IRPC não recuperáveis.');
for(const r of b.rows)if(r.ordinary?.capitalSeatAndManagement!==undefined&&!['','yes','no'].includes(r.ordinary.capitalSeatAndManagement))throw Error('Factos de sede/direcção não recuperáveis.');
for(const v of [...b.rows,...b.payments])if(v.fxSelection!==undefined&&(!v.fxSelection||typeof v.fxSelection!=='object'||Array.isArray(v.fxSelection))||v.fxLink!==undefined&&(!v.fxLink||typeof v.fxLink.id!=='string'||typeof v.fxLink.fingerprint!=='string'))throw Error('Vínculo/selecção cambial não recuperável;original preservado.');
for(const p of b.payments)if(!p||!['id','reference','date','amount','currency'].every(k=>typeof p[k as keyof IrpcPayment]==='string')||!['beneficiary','remittance','withholding_proof'].includes(p.kind))throw Error('Pagamento IRPC inválido;originais preservados.');
if(b.result&&(!Array.isArray(b.result.rows)||!Array.isArray(b.result.inputs)||typeof b.result.key!=='string'||b.result.version!==irpcWithholdingVersion))throw Error('Resultado IRPC não recuperável.');
if(b.payments.some((p,i)=>p.reference.trim()&&b.payments.some((q,j)=>i!==j&&q.kind===p.kind&&q.reference.trim()===p.reference.trim()&&q.date===p.date&&q.currency===p.currency)))throw Error('Pagamento/prova já registado:reutilize a referência existente em vez de duplicar.');
if(new Set(b.rows.map(r=>r.id)).size!==b.rows.length||new Set(b.payments.map(p=>p.id)).size!==b.payments.length)throw Error('Identificadores IRPC repetidos.');
}
export function irpcBook(d:Record<string,unknown>):IrpcBook{const b=map(d)[acquisitionScope(d)]??{version:1,rows:[],payments:[]};validate(b);return b;}
export function saveIrpcBook(d:Record<string,unknown>,b:IrpcBook):string{validate(b);return JSON.stringify({...store(d),irpcWithholdings:{...map(d),[acquisitionScope(d)]:b}});}
export function irpcSources(d:Record<string,unknown>){return[
...acquisitionBook(d).rows.map(r=>({id:'acquisition:'+r.id,key:closureFingerprint(r),counterparty:r.supplier,documentRef:r.documentRef+(r.documentLine?' / linha '+r.documentLine:''),description:r.description,amount:r.net,currency:acquisitionBook(d).currency,direction:'paid' as const,origin:r.origin})),
...salesBook(d).rows.map(r=>({id:'sale:'+r.id,key:closureFingerprint(r),counterparty:'',documentRef:r.evidence,description:r.description,amount:r.basis==='net'?r.amount:'',currency:r.sourceCurrency,direction:'received' as const,origin:'projected' as const})),
];}
export function reuseIrpcSources(d:Record<string,unknown>,b:IrpcBook):IrpcBook{validate(b);const rows=[...b.rows];for(const s of irpcSources(d))if(!rows.some(r=>r.source?.id===s.id)){const r={...newIrpcRow('irpc:'+s.id),counterparty:s.counterparty,documentRef:s.documentRef,description:s.description,base:s.amount,currency:s.currency,direction:s.direction,origin:s.origin};rows.push({...r,source:{id:s.id,key:s.key,fingerprint:closureFingerprint(r)}});}return{...b,rows};}
function sourceIssue(d:Record<string,unknown>,r:IrpcRow){if(!r.source)return'';const s=irpcSources(d).find(s=>s.id===r.source!.id);return !s?'Operação de origem não está disponível neste contexto;vínculo e edições conservados.':s.key!==r.source.key?'Documento/operação de origem alterado;compare o histórico e reconcilie a divergência antes de calcular.':'';}
const date=(s:string)=>/^20\d{2}-(0[1-9]|1[0-2])-\d{2}$/.test(s)&&!Number.isNaN(Date.parse(s))&&new Date(s).toISOString().slice(0,10)===s;
const positive=(f:FiscalFraction)=>BigInt(f.numerator)>0n;
export function evaluateIrpc(d:Record<string,unknown>,r:IrpcRow):IrpcResult{
const v:IrpcResult={id:r.id,status:'indeterminate',reason:'Identifique o rendimento e os intervenientes.',period:'',eventDate:'',nature:null,rate:null,base:null,tax:null,settled:null,outstanding:null,direction:r.direction};
const issue=sourceIssue(d,r)||irpcFxDependency(d,r);if(issue)return{...v,reason:issue};
if(r.recipientIrpc==='no')return{...v,status:'outside_scope',reason:'Titular fora de IRPC;sem converter em IRPS ou em isenção.'};
if(!r.counterparty.trim()||!r.documentRef.trim()||r.recipientIrpc!=='yes'||r.payerIrpc!=='yes'||!r.residence||!r.kind||!r.qualificationRef.trim())return{...v,reason:'Faltam contraparte,documento,qualificação do rendimento,titular IRPC,devedor IRPC ou residência. A via devedor IRPS exige âmbito próprio.'};
if(r.mozambique!=='yes')return{...v,reason:'Falta correspondência territorial aos arts5/67;ser estrangeiro não resolve incidência nem isenção.'};
if(r.specialRelief!=='none'&&r.specialRelief!=='claimed')return{...v,reason:'Convenção,isenção ou dispensa invocada/desconhecida:identificar artigo,período,condições e prova;sem taxa reduzida ou zero automáticos.'};
if(!r.eventsComplete||r.eventsComplete!=='yes'||!r.events.length||r.events.some(e=>!date(e.date)||!e.reference.trim()))return{...v,reason:'Identifique os eventos aplicáveis67(5),incluindo reconhecimento do custo,e confirme a sua completude com suporte;uma factura ou pagamento isolado não fixa o momento.'};
v.eventDate=r.events.map(e=>e.date).sort()[0];v.period=v.eventDate.slice(0,7);
if(!v.eventDate.startsWith('2026-'))return{...v,reason:'Primeiro evento aplicável fora de2026;corresponder versão/período próprio,sem deslocar para o pagamento posterior.'};
try{const converted=convertIrpcAmount(d,r.base,r);v.base=converted.value;v.conversion=converted.evidence;}catch(e){return{...v,reason:'Base do rendimento/conversão por resolver: '+String(e)};}
if(r.specialRelief==='claimed'){
const relief=evaluateIrpcRelief(r,v.eventDate);if(!relief.applied)return{...v,reason:relief.reason};
v.treatment=relief.treatment;v.reliefRule=relief.rule;v.rate=relief.rate;v.nature=relief.treatment==='treaty'?'definitive':'on_account';v.reason=relief.reason;
v.tax=fraction(BigInt(v.base.numerator)*BigInt(relief.rate),BigInt(v.base.denominator)*100n);v.status='calculated';return v;
}
const digital=['digital_goods','digital_services','emoney_commission'].includes(r.kind);
if(digital){
if(r.residence==='nonresident'&&r.permanentEstablishment==='no'||r.residence==='nonresident'&&r.permanentEstablishment==='yes'&&r.attributable==='no')v.nature='definitive';
else return{...v,reason:'Para residente ou rendimento imputável aEP,corresponder concretamente a taxa62(5) com as dispensas68,em especial68(d),antes da liquidação. EP desconhecido permanece indeterminado;90dias/serviço digital não criam ausência deEP automática.'};
v.rate=10;v.reason='Taxa10%62(5) no âmbito digital/moeda electrónica demonstrado;retenção definitiva67(3). Procedimento67(7)/remissão62(6) e CER permanecem separados.';
}else{
const f=r.ordinary;
if(!f||f.nonDigital!=='yes'||!f.reference.trim())return{...v,reason:'Classifique o rendimento não abrangido pelo ramo digital/moeda electrónica e identifique os factos específicos. Cotejo62/67:Lei34/2007,Lei19/2013 eLei20/2022 agora disponível;sem taxa genérica.'};
const nonresident=r.residence==='nonresident';
if(nonresident&&r.permanentEstablishment!=='no'&&!(r.permanentEstablishment==='yes'&&['yes','no'].includes(r.attributable)))return{...v,reason:'Falta identificar EP e imputação;ausência física ou nacionalidade não resolvem este facto.'};
const attributable=!nonresident||r.permanentEstablishment==='yes'&&r.attributable==='yes';
v.nature=r.kind==='rent'||attributable?'on_account':'definitive';
if(['equipment','services'].includes(r.kind)&&v.nature==='on_account')return{...v,reason:'Rendimento67(1)b/g com imposto por conta:dispensa68(d) identificada,por corresponder no ramo de dispensas;não reter20% nem declarar isenção do rendimento.'};
if(r.kind==='rent'&&f.rentOwnPropertyManagement!=='no')return{...v,reason:'Rendimento predial mantém natureza por conta67(3). Identifique a gestão de imóveis próprios e eventual dispensa68(f)/transparência;apenas este caso depende dessa correspondência.'};
if(r.kind==='capital'){
if(!f.capitalType||f.capitalType==='other')return{...v,reason:'Identifique juros/dividendos não cotados,títulos cotadosBM ou permutas de liquidez;62(3/4) não permite taxa única para capitais.'};
if(r.residence==='resident'&&['listed_debt_mz','liquidity_repo'].includes(f.capitalType)){if(f.capitalSeatAndManagement!=='yes')return{...v,reason:'Art62(3):identifique sede e direcção efectiva nacionais do titular,além da categoria exacta dos títulos/permuta;residência genérica não substitui estes factos.'};v.nature='definitive';}
if(v.nature==='on_account'&&f.capitalType!=='listed_debt_mz')return{...v,reason:'Capitais com imposto por conta:correspondência específica das dispensas68(a/b/c/g),incluindo titular e operação,permanece separada;sem bloquear capitais definitivos independentes.'};
if(f.capitalType==='liquidity_repo'&&r.residence!=='resident')return{...v,reason:'Permutas de liquidez62(3)b exigem entidade com sede/direcção efectiva nacional;caso não residente mantém correspondência própria.'};
}
const special=['telecom','international_transport','connected_installation','aircraft_maintenance_charter','rural_public_electrification','maritime_fishing_cabotage'].includes(r.kind)||r.kind==='capital'&&f.capitalType==='listed_other_mz';
if(special){
if(!nonresident||r.permanentEstablishment!=='no')return{...v,reason:'Taxa especial62(4) refere entidades62(2),não residentes semEP. O caso residente/EP tem correspondência própria;sem copiar10%.'};
if(f.specialFacts!=='yes')return{...v,reason:'Confirme os factos exactos62(4)a–d:conexão dos equipamentos,projecto público rural,pesca/cabotagem ou título cotadoBM que não é dívida/bilhete62(3)a,conforme categoria. Sem taxa especial por descrição genérica.'};
v.rate=10;v.reason='Taxa especial10%62(4),redacçãoLei19/2013,conservada emLei20/2022 eLei12/2025;entidade não residente semEP e categoria específica identificadas. Não é a taxa digital62(5).';
}else{
if(!['royalty','equipment','rent','capital','services'].includes(r.kind))return{...v,reason:'Natureza fora dos ramos agrupados;identificar artigo e condições próprios,sem taxa por defeito.'};
v.rate=20;v.reason=(r.kind==='capital'&&r.residence==='resident'&&['listed_debt_mz','liquidity_repo'].includes(f.capitalType)?'Retenção liberatória20%62(3)a/b:juros de dívida/bilhetes cotados ou permuta de liquidez qualificados,com sede e direcção efectiva nacionais. ':'')+'Taxa20%62(1),com62(2/3) quando aplicável;incidência67(1),natureza67(3). Lei20/2022,p2731,confrontada:as medidas agrícolas terminam31/12/2025 e não são transportadas para2026. Sem aplicar10% digital a rendimentos não digitais.';
}
}
v.tax=fraction(BigInt(v.base.numerator)*BigInt(v.rate!),BigInt(v.base.denominator)*100n);v.status='calculated';v.reason+=' Base separada do IVA;entrega/prova e liquidação anual mantêm reconciliação própria.';return v;
}
function sharedPayments(d:Record<string,unknown>,b:IrpcBook){const used=b.payments.filter(p=>b.rows.some(r=>r.allocations.some(a=>a.paymentId===p.id)));return Object.entries(map(d)).filter(([ctx])=>ctx!==acquisitionScope(d)).flatMap(([ctx,other])=>{validate(other);const payments=other.payments.filter(q=>used.some(p=>p.reference.trim()===q.reference.trim()&&p.date===q.date&&p.currency===q.currency&&p.kind===q.kind));return payments.length?[[ctx,payments,other.rows.flatMap(r=>r.allocations.filter(a=>payments.some(p=>p.id===a.paymentId)))]]:[];});}
function key(d:Record<string,unknown>,b:IrpcBook){const fx=[...b.rows,...b.payments].filter(r=>r.currency!=='MZN'&&r.fxLink).map(r=>irpcFxDependency(d,r));return JSON.stringify([irpcWithholdingVersion,acquisitionScope(d),b.rows,b.payments,b.rows.map(r=>sourceIssue(d,r)),sharedPayments(d,b),...(fx.length?[fx]:[]),...(b.rows.some(r=>r.specialRelief==='claimed')?[irpcReliefVersion]:[])]);}
export function irpcCurrent(d:Record<string,unknown>,b:IrpcBook){return !!b.result&&b.result.key===key(d,b);}
export function recordIrpc(d:Record<string,unknown>,b:IrpcBook,now=new Date().toISOString()):IrpcBook{
validate(b);const rows=b.rows.map(r=>evaluateIrpc(d,r));const paymentConversions:Record<string,IrpcFxEvidence|null>={};const allocations=new Map<string,FiscalFraction[]>();
const fail=(i:number,reason:string)=>{rows[i]={...rows[i],status:'indeterminate',reason,settled:null,outstanding:null};};
b.rows.forEach((r,i)=>{
if(rows[i].status!=='calculated')return;
if(rows[i].treatment==='dispensed'){if(r.allocations.length){fail(i,'Dispensa com entrega/prova associada: reconcilie sem apagar o pagamento nem gerar crédito automático.');return;}rows[i].settled=fraction(0n,1n);rows[i].outstanding=fraction(0n,1n);return;}
if(r.settlement==='none'&&r.allocations.length){fail(i,'Ausência de entrega/prova contradiz pagamentos associados;conserve e reconcilie.');return;}
if(!r.settlement||!r.settlementRef.trim()){rows[i].reason+=' Entrega à AT/retenção sofrida ainda não reconciliada;não presumir zero pago.';return;}
const parts:FiscalFraction[]=[];const seen=new Set<string>();
for(const a of r.allocations){const p=b.payments.find(p=>p.id===a.paymentId);try{
if(!p||seen.has(p.id)||p.kind==='remittance'&&p.currency!=='MZN'||!date(p.date)||p.date<rows[i].eventDate||!p.reference.trim()||p.kind!==(r.direction==='paid'?'remittance':'withholding_proof'))throw Error();
seen.add(p.id);const amount=decimalFraction(a.amount);paymentConversions[p.id]=convertIrpcAmount(d,p.amount,p).evidence;parts.push(amount);allocations.set(p.id,[...(allocations.get(p.id)??[]),amount]);
}catch(e){fail(i,'Pagamento/prova ausente,incoerente,repetido ou de outra natureza:pagamento ao fornecedor e imposto IVA não são entrega IRPC. '+String(e));return;}}
const settled=addFractions(parts);if(positive(subtractFractions(settled,rows[i].tax!))){fail(i,'Valor associado excede a retenção calculada;reconcilie excesso sem gerar crédito automático.');return;}
rows[i].settled=settled;rows[i].outstanding=subtractFractions(rows[i].tax!,settled);
});
for(const [id,parts]of allocations){const p=b.payments.find(p=>p.id===id)!;let excess=false;try{const elsewhere:FiscalFraction[]=[];for(const [ctx,other]of Object.entries(map(d))){if(ctx===acquisitionScope(d))continue;validate(other);for(const q of other.payments.filter(q=>q.reference.trim()===p.reference.trim()&&q.date===p.date&&q.kind===p.kind&&q.currency===p.currency)){if(q.amount!==p.amount||q.currency!=='MZN'&&JSON.stringify(q.fxSelection)!==JSON.stringify(p.fxSelection))throw Error('Montantes/conversões divergentes');for(const r of other.rows)for(const a of r.allocations.filter(a=>a.paymentId===q.id))elsewhere.push(decimalFraction(a.amount));}}excess=positive(subtractFractions(addFractions([...parts,...elsewhere]),convertIrpcAmount(d,p.amount,p).value));}catch{excess=true;}if(excess)b.rows.forEach((r,i)=>{if(r.allocations.some(a=>a.paymentId===id))fail(i,'Mesmo pagamento utilizado além do montante disponível;reparta sem duplicação.');});}
// An identical source document/income cannot become a second tax just by adding a row.
b.rows.forEach((r,i)=>{if(b.rows.some((s,j)=>j!==i&&(r.source&&s.source?.id===r.source.id||r.documentRef.trim()&&s.documentRef.trim()===r.documentRef.trim()&&s.counterparty.trim()===r.counterparty.trim()&&s.direction===r.direction))){fail(i,'Documento/rendimento repetido neste livro;identifique parcelas próprias antes de somar,sem duplicação.');}});
return{...b,history:b.result?[...(b.history??[]),structuredClone(b.result)]:b.history,result:{version:irpcWithholdingVersion,key:key(d,b),calculatedAt:now,inputs:structuredClone(b.rows),payments:structuredClone(b.payments),rows,paymentConversions}};
}
const amount=(v:FiscalFraction|null)=>{if(!v)return'Indeterminado';const p=fractionPresentation(v);return(p.approximate?'≈':'')+p.decimal+' MZN';};
export function irpcReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=irpcBook(d),r=b.result;if(!r)return mrftaReportRows(b,false);return [...r.rows.map((v):[string,string,string,string]=>{const i=r.inputs.find(i=>i.id===v.id)!;return['IRPC — retenções',`${i.documentRef} — ${i.counterparty}`,`${({calculated:'Calculado',indeterminate:'Indeterminado',outside_scope:'Fora deste âmbito'})[v.status]};tratamento:${v.treatment==='dispensed'?'Dispensa de retenção':v.treatment==='treaty'?'Limite convencional':'Retenção interna'};enquadramento: ${irpcKinds.find(([k])=>k===i.kind)?.[1]??i.kind};${i.direction==='paid'?'retida a entregar':'sofrida'};base:${amount(v.base)};taxa:${v.treatment==='dispensed'?'Dispensa (sem retenção)':(v.rate??'por corresponder')+'%'};retenção:${amount(v.tax)};entrega/prova:${amount(v.settled)};saldo:${amount(v.outstanding)};${v.reason}`,`${acquisitionScope(d)};${i.origin};${v.period};evento:${v.eventDate};${v.nature==='on_account'?'Imposto por conta (sem crédito anual automático)':v.nature==='definitive'?'Retenção definitiva':'Natureza por determinar'};${irpcCurrent(d,b)?'Entradas correspondentes':'Histórico;entradas/origem divergentes'};dispensa/convenção:${irpcReliefEvidenceLabel(i)};reconciliação:${i.settlementRef};comprovativos:${i.allocations.map(a=>{const p=r.payments.find(p=>p.id===a.paymentId);return p?`${p.reference}/${p.date}:parcela${a.amount}MZN de${p.amount}${p.currency};${r.paymentConversions?.[p.id]?irpcFxEvidenceLabel(r.paymentConversions[p.id]!):'sem conversão usada'}`:'referência por resolver';}).join(' | ')};${r.calculatedAt};${v.conversion?'Câmbio:'+irpcFxEvidenceLabel(v.conversion)+';':''}${irpcWithholdingSource}`];}),...mrftaReportRows(b,irpcCurrent(d,b))];}catch(e){return[['IRPC — retenções','Livro não recuperável',String(e),'Originais e histórico preservados.']];}}
export function irpcPreparationHtml(d:Record<string,unknown>):string{const b=irpcBook(d);if(!b.result||!irpcCurrent(d,b))throw Error('Calcule e guarde as entradas actuais antes de preparar.');const esc=(v:unknown)=>String(v).replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]!));return'<!doctype html><html lang="pt"><meta charset="utf-8"><title>IRPC — preparação das retenções</title><body><h1>Preparação IRPC — L5</h1><p>Mapa de trabalho;sem submissão,recepção ou aceitação AT. MRFTA19/39:quadro1 retenção;quadro2 mês/ano único por declaração;quadro7 base/taxa/imposto. CER e correspondência das rubricas digitais/moeda electrónica por esclarecer;67(7)remete62(6),mas taxa nova em62(5). Não preencher assinatura ou uso dos serviços. Não consolidar períodos diferentes nem transformar retenções sofridas em imposto a entregar.</p>'+irpcReportRows(d).map(r=>'<section><h2>'+esc(r[1])+'</h2><p>'+esc(r[2])+'</p><small>'+esc(r[3])+'</small></section>').join('')+'<p>Instruções do exemplar:prazo nominal dia20 do mês seguinte à dedução,sem ajuste de calendário/prorrogação ou procedimento2026 presumidos. Juros não calculados. GuiaM/39 anterior preservada,sem actualizar remissões do original.</p></body></html>';}
+63
View File
@@ -0,0 +1,63 @@
import {acquisitionScope} from './iva-acquisitions.ts';
import {decimalFraction,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
export const ispcEligibilitySource='L4-A:Lei9/2025,BR248/1.ºsuplemento,republicaçãoISPC,arts2–5,9-A/13;PDF10–11/p2180(10–11);vigência2026art6/PDF9. Enquadramento preliminar de actividade habitual;opção separada;sem liquidação trimestral,retenção,submissão ou alteração de IVA/IRPC/IRPS.';
export const ispcActivities=[['forestry','Silvícola'],['fishery','Pesqueira'],['livestock','Pecuária'],['agriculture','Agrícola'],['poultry','Avícola'],['beekeeping','Apícola'],['industry','Industrial'],['commerce','Comercial'],['craft','Artesanato'],['services12','Serviços do artigo8(1)b'],['liberal15','Profissão liberal do artigo8(1)c'],['other','Outra actividade,fora dos âmbitos identificados']] as const;
export type IspcActivity=typeof ispcActivities[number][0];
type Choice=''|'yes'|'no';
export type IspcEligibilityInput={entityRef:string;personType:''|'singular'|'collective';origin:'projected'|'effective';assessmentDate:string;currency:string;mode:'regular'|'occasional';activities:IspcActivity[];activityDescription:string;territory:Choice;establishments:string;basis:''|'previous_year'|'start_forecast';referenceYear:string;annualReference:string;annualReferenceRef:string;forecastConfirmed:Choice;forecastConfirmationRef:string;organizedRequired:Choice;sharesInIspc:Choice;sharesAnonymous:Choice;otherActivities:Choice;unlistedServices:Choice;liberalDaysSameEntity:string;liberalClientRef:string;generalRegimeChosen:Choice;generalThreeYearsCompleted:Choice;generalRegimeRef:string;option:'preparation'|'opted'|'not_opted';optionReference:string;optionDate:string};
export type IspcEligibilityResult={calculatedAt:string;key:string;scope:string;input:IspcEligibilityInput;status:'compatible'|'incompatible'|'indeterminate';reason:string;missing:string[];annualReference:FiscalFraction|null;optionStatus:'preparation'|'recorded'|'not_opted'|'indeterminate';optionReason:string;source:string};
export type IspcEligibilityBook={version:1;input:IspcEligibilityInput;result?:IspcEligibilityResult;history?:IspcEligibilityResult[]};
const scope=(d:Record<string,unknown>)=>acquisitionScope(d);
export function ispcReuseValues(d:Record<string,unknown>):Partial<IspcEligibilityInput>{
const p:Partial<IspcEligibilityInput>={},person=String(d.person_type??'');if(['singular','sole_trader'].includes(person))p.personType='singular';else if(person==='collective')p.personType='collective';
if(typeof d.fiscal_activity==='string'&&d.fiscal_activity.trim())p.activityDescription=d.fiscal_activity;
const establishments=String(d.fiscal_establishments??'');if(/^[1-9]\d{0,4}$/.test(establishments))p.establishments=establishments;
const entity=String(d.fiscal_entity_ref||d.organization_name||'');if(entity.trim())p.entityRef=entity;
return p;
}
export function newIspcEligibilityInput(d:Record<string,unknown>):IspcEligibilityInput{return{entityRef:'',personType:'',origin:'projected',assessmentDate:'2026-01-01',currency:d.currency==='MZN'?'MZN':'',mode:'regular',activities:[],activityDescription:'',territory:'',establishments:'',basis:'',referenceYear:'',annualReference:'',annualReferenceRef:'',forecastConfirmed:'',forecastConfirmationRef:'',organizedRequired:'',sharesInIspc:'',sharesAnonymous:'',otherActivities:'',unlistedServices:'',liberalDaysSameEntity:'',liberalClientRef:'',generalRegimeChosen:'',generalThreeYearsCompleted:'',generalRegimeRef:'',option:'preparation',optionReference:'',optionDate:'',...ispcReuseValues(d)};}
function store(d:Record<string,unknown>):Record<string,unknown>{const s=JSON.parse(String(d.modelo_a_snapshot||'{"version":1,"books":{}}'));if(s.version!==1||!s.books||typeof s.books!=='object'||Array.isArray(s.books))throw Error('Livros não recuperáveis;originais preservados.');return s;}
function map(d:Record<string,unknown>):Record<string,IspcEligibilityBook>{const value=store(d).ispcEligibility;if(value===undefined)return{};if(!value||typeof value!=='object'||Array.isArray(value))throw Error('PreparaçãoISPC não recuperável;originais preservados.');return value as Record<string,IspcEligibilityBook>;}
function validate(b:IspcEligibilityBook):void{
const sample=newIspcEligibilityInput({});if(!b||b.version!==1||!b.input||typeof b.input!=='object'||Object.keys(sample).some(k=>k==='activities'?!Array.isArray(b.input.activities)||new Set(b.input.activities).size!==b.input.activities.length||b.input.activities.some(a=>!ispcActivities.some(([kind])=>kind===a)):typeof b.input[k as keyof IspcEligibilityInput]!=='string')||!['','singular','collective'].includes(b.input.personType)||!['projected','effective'].includes(b.input.origin)||!['regular','occasional'].includes(b.input.mode)||!['','previous_year','start_forecast'].includes(b.input.basis)||!['preparation','opted','not_opted'].includes(b.input.option)||['territory','forecastConfirmed','organizedRequired','sharesInIspc','sharesAnonymous','otherActivities','unlistedServices','generalRegimeChosen','generalThreeYearsCompleted'].some(k=>!['','yes','no'].includes(String(b.input[k as keyof IspcEligibilityInput])))||b.history!==undefined&&!Array.isArray(b.history)||b.result!==undefined&&(!b.result.input||!Array.isArray(b.result.missing)||!['compatible','incompatible','indeterminate'].includes(b.result.status)))throw Error('EntradasISPC não recuperáveis;sem substituir por valores vazios.');
}
export function ispcEligibilityBook(d:Record<string,unknown>):IspcEligibilityBook{const b=map(d)[scope(d)]??{version:1,input:newIspcEligibilityInput(d)};validate(b);return b;}
export function saveIspcEligibilityBook(d:Record<string,unknown>,b:IspcEligibilityBook):string{validate(b);return JSON.stringify({...store(d),ispcEligibility:{...map(d),[scope(d)]:b}});}
const validDate=(v:string)=>/^20\d{2}-(0[1-9]|1[0-2])-\d{2}$/.test(v)&&!Number.isNaN(Date.parse(v))&&new Date(v).toISOString().slice(0,10)===v;
function option(i:IspcEligibilityInput):Pick<IspcEligibilityResult,'optionStatus'|'optionReason'>{
if(i.option==='not_opted')return{optionStatus:'not_opted',optionReason:'Sem opçãoISPC declarada;não aplicar a exclusão de outros impostos doart5.'};
if(i.option==='preparation')return{optionStatus:'preparation',optionReason:'Opção em preparação;compatibilidade de acesso não é adesão nem alteração automática de regime.'};
if(!i.optionReference.trim()||!validDate(i.optionDate)||!validDate(i.assessmentDate)||i.optionDate>i.assessmentDate)return{optionStatus:'indeterminate',optionReason:'Identifique referência e data da opção,até à data de avaliação;não inferir adesão pela selecçãoISPC.'};
return{optionStatus:'recorded',optionReason:'Opção registada segundo documento ou pressuposto declarado;sem submissãoAT ou reescrita dos livros deIVA/IRPC/IRPS.'};
}
function assess(i:IspcEligibilityInput):Pick<IspcEligibilityResult,'status'|'reason'|'missing'|'annualReference'>{
let annual:FiscalFraction|null=null;try{annual=decimalFraction(i.annualReference);}catch{ /* Missing or invalid is never zero. */ }
const stop=(status:IspcEligibilityResult['status'],reason:string,missing:string[]=[])=>({status,reason,missing,annualReference:annual});
if(!validDate(i.assessmentDate)||!i.assessmentDate.startsWith('2026-')||i.currency!=='MZN')return stop('indeterminate','Este incremento cobre apenas avaliação2026emMZN;identifique data e moeda sem conversão silenciosa.',['data2026','moedaMZN']);
if(i.mode==='occasional')return stop('indeterminate','Operação ocasional3(3–4):conservar dados;use o percurso específico de operações ocasionais próprias abaixo,com incidênciaIRPS e famílias3(4).',['enquadramento específico da operação ocasional']);
if(i.territory==='no')return stop('incompatible','O âmbito territorial declarado não corresponde ao exercício em território nacional de2(1);nacionalidade do investidor não substitui este facto.');
if(i.activities.includes('other')||i.otherActivities==='yes')return stop('incompatible','Actividade fora dos âmbitos2/3declarada;exclusão3(2)c,não aplicarISPC por nome do sector.');
if(i.organizedRequired==='yes')return stop('incompatible','Obrigação de contabilidade organizada declarada:4(1)b não permite este enquadramento. Manter contabilidade voluntária distinto de obrigação.');
if(i.sharesInIspc==='yes'||i.sharesAnonymous==='yes')return stop('incompatible','Participações abrangidas por3(2)a/b declaradas;enquadramentoISPC incompatível.');
if(/^[1-9]\d{0,4}$/.test(i.establishments)&&Number(i.establishments)>1)return stop('incompatible','Actividade distribuída por vários estabelecimentos:exclusão3(2)d;sem presumir um estabelecimento por oportunidade.');
const service=i.activities.some(a=>['services12','liberal15'].includes(a)),liberal=i.activities.includes('liberal15');
if(service&&i.unlistedServices==='yes')return stop('incompatible','Serviços fora dos previstos declarados:exclusão3(2)f. Categoria e natureza próprias devem ser identificadas.');
if(liberal&&/^\d{1,3}$/.test(i.liberalDaysSameEntity)&&Number(i.liberalDaysSameEntity)<=366&&Number(i.liberalDaysSameEntity)>183)return stop('incompatible','Serviços8(1)càmesma entidade por mais183dias durante o ano:exclusão3(2)e. Não estender esta condição automaticamente aos serviços8(1)b.');
if(i.generalRegimeChosen==='yes'&&i.generalThreeYearsCompleted==='no')return stop('incompatible','Permanência mínima de três anos nos impostos gerais5(3)ainda não cumprida,segundo factos declarados.');
if(annual&&(i.basis==='previous_year'&&i.referenceYear==='2025'||i.basis==='start_forecast'&&i.referenceYear==='2026')&&BigInt(annual.numerator)>4000000n*BigInt(annual.denominator))return stop('incompatible','Volume anual de referência superior4.000.000MZN:fora do acesso4(1)a/4(2). Excesso do próprio ano e20%de8(1)d têm tratamento separado;não liquidado aqui.');
const missing:string[]=[];if(!i.personType)missing.push('pessoa singular ou colectiva');if(i.territory!=='yes')missing.push('exercício em território nacional');if(!i.activities.length||!i.activityDescription.trim())missing.push('actividade/natureza identificadas');if(!/^[1-9]\d{0,4}$/.test(i.establishments))missing.push('número de estabelecimentos');
for(const[field,label]of [['organizedRequired','obrigação de contabilidade organizada'],['sharesInIspc','participações noutras sociedadesISPC'],['sharesAnonymous','participaçõesSA/sócios não identificáveis'],['otherActivities','actividades fora do âmbito'],['generalRegimeChosen','opção pelos impostos gerais']] as const)if(i[field]==='')missing.push(label);
if(!i.basis)missing.push('origem do volume anual de referência');if(!annual)missing.push('montante anual de referência');const expected=i.basis==='previous_year'?'2025':i.basis==='start_forecast'?'2026':'';if(expected&&i.referenceYear!==expected)missing.push(`ano${expected}da referência;não reinterpretar outro ano`);
if(i.basis==='start_forecast'&&(i.forecastConfirmed!=='yes'||i.origin==='effective'&&!i.forecastConfirmationRef.trim()))missing.push('previsão da declaração de início confirmadaAT4(2),ou pressuposto expresso na projecção');
if(service&&i.unlistedServices==='')missing.push('correspondência dos serviços aos âmbitos daLei');
if(liberal&&(!/^\d{1,3}$/.test(i.liberalDaysSameEntity)||Number(i.liberalDaysSameEntity)>366||!i.liberalClientRef.trim()))missing.push('maior duração anual por mesma entidade e suporte declarado');
if(i.generalRegimeChosen==='yes'&&(i.generalThreeYearsCompleted!=='yes'||!i.generalRegimeRef.trim()))missing.push('cumprimento dos três anos5(3)e referência da opção/registo');
if(missing.length)return stop('indeterminate','Condições específicas por esclarecer;desconhecido não significa não aplicável nemzero.',missing);
return stop('compatible','Condições de acesso da actividade habitual compatíveis com os dados de referência declarados;opção separada. Volume do ano em curso, trimestre, excesso e mínimo têm apuramento trimestral próprio; retenções têm registo separado.'+(liberal?' Serviçosliberais:limite5anos9-A,contagemtransitória13a partir da vigência2026;sem presumir permanência fora da cobertura.':''));
}
const key=(d:Record<string,unknown>,b:IspcEligibilityBook)=>JSON.stringify(['ispc-eligibility/1',scope(d),b.input]);
export function ispcEligibilityCurrent(d:Record<string,unknown>,b:IspcEligibilityBook):boolean{return!!b.result&&b.result.key===key(d,b);}
export function recordIspcEligibility(d:Record<string,unknown>,b:IspcEligibilityBook,now=new Date().toISOString()):IspcEligibilityBook{validate(b);const result:IspcEligibilityResult={calculatedAt:now,key:key(d,b),scope:scope(d),input:structuredClone(b.input),...assess(b.input),...option(b.input),source:ispcEligibilitySource};return{...b,...(b.result?{history:[...(b.history??[]),structuredClone(b.result)]}:{}),result};}
export function ispcReuseDiff(d:Record<string,unknown>,b:IspcEligibilityBook):Array<{field:keyof IspcEligibilityInput;before:string;after:string}>{return Object.entries(ispcReuseValues(d)).filter(([field,value])=>b.input[field as keyof IspcEligibilityInput]!==value).map(([field,value])=>({field:field as keyof IspcEligibilityInput,before:String(b.input[field as keyof IspcEligibilityInput]),after:String(value)}));}
export function ispcEligibilityReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=ispcEligibilityBook(d),r=b.result;if(!r)return[];const i=r.input;return[['ISPC','L4-A — enquadramento2026',`${r.status==='compatible'?'Compatível com os dados de referência':r.status==='incompatible'?'Incompatível':'Indeterminado'};${r.reason};falta:${r.missing.join('; ')||'nenhum dado deste recorte'}`,`${r.scope};${ispcEligibilityCurrent(d,b)?'Entradas correspondentes':'Histórico preservado;rever entradas'};${r.calculatedAt};${r.source}`],['ISPC','Origem e âmbito',`${i.entityRef||'Entidade por identificar'};${i.personType};${i.origin==='projected'?'Pressupostos de simulação':'Dados efectivos declarados'};${i.activities.map(a=>ispcActivities.find(([kind])=>kind===a)?.[1]??a).join('; ')};${i.activityDescription};estabelecimentos${i.establishments};territórionacional${i.territory}`,`Referênciaanual:${i.basis}/${i.referenceYear};${r.annualReference?fractionPresentation(r.annualReference).decimal:'Indeterminado'}MZN;${i.annualReferenceRef};previsãoAT${i.forecastConfirmed}/${i.forecastConfirmationRef};liberal${i.liberalDaysSameEntity}dias/${i.liberalClientRef};factos:${JSON.stringify({organizedRequired:i.organizedRequired,sharesInIspc:i.sharesInIspc,sharesAnonymous:i.sharesAnonymous,otherActivities:i.otherActivities,unlistedServices:i.unlistedServices,generalRegimeChosen:i.generalRegimeChosen,generalThreeYearsCompleted:i.generalThreeYearsCompleted,generalRegimeRef:i.generalRegimeRef})}`],['ISPC','Opção e próximo passo',`${r.optionReason};referência${i.optionReference};data${i.optionDate}`,`Prossiga no apuramento trimestral; esta avaliação não adopta regime nem calcula imposto. ${r.source}`]];}catch(error){return[['ISPC','Enquadramento','Dados não recuperáveis;originais preservados',String(error)]];}}
+45
View File
@@ -0,0 +1,45 @@
import {acquisitionScope} from './iva-acquisitions.ts';
import {ispcEligibilityBook,ispcEligibilityCurrent,type IspcEligibilityResult} from './ispc-eligibility.ts';
import {addFractions,decimalFraction,fraction,fractionPresentation,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
export const ispcQuarterSource='Lei 9/2025, republicação ISPC, arts 8, 9, 10, 10-A e 11; BR248/2025, PDF11/p2180(11). Taxa do escalão anual aplicada à base trimestral (8(1)a e 9); 20% apenas na parcela em excesso de 4.000.000; actividades cumuladas: taxa mais alta (8(2)). Sem fraccionar os limites anuais por quatro nem copiar o volume do ano anterior. Preparação do apuramento; sem submissão ou pagamento AT.';
export type IspcQuarterInput={year:string;quarter:string;sales:[string,string,string,string];salesRefs:[string,string,string,string];annualBandVolume:string;annualBandOrigin:''|'forecast'|'closed_year';annualBandRef:string;coverage:''|'all_taxpayer_activity';};
export type IspcQuarterResult={key:string;calculatedAt:string;scope:string;input:IspcQuarterInput;eligibility:IspcEligibilityResult|null;status:'calculated'|'indeterminate'|'not_applicable';reason:string;missing:string[];base:FiscalFraction|null;prior:FiscalFraction|null;ordinary:FiscalFraction|null;excess:FiscalFraction|null;rate:number|null;tax:FiscalFraction|null;payment:FiscalFraction|null;declaration:boolean;projected:boolean;source:string};
export type IspcQuarterBook={version:1;input:IspcQuarterInput;result?:IspcQuarterResult;history?:IspcQuarterResult[]};
export const newIspcQuarterInput=():IspcQuarterInput=>({year:'2026',quarter:'1',sales:['','','',''],salesRefs:['','','',''],annualBandVolume:'',annualBandOrigin:'',annualBandRef:'',coverage:''});
function snapshot(d:Record<string,unknown>){const s=JSON.parse(String(d.modelo_a_snapshot||'{"version":1,"books":{}}'));if(s.version!==1||!s.books||typeof s.books!=='object'||Array.isArray(s.books))throw Error('Livros não recuperáveis; originais preservados.');return s;}
function validate(b:IspcQuarterBook){if(!b||b.version!==1||!b.input||['year','quarter','annualBandVolume','annualBandOrigin','annualBandRef','coverage'].some(k=>typeof b.input[k as keyof IspcQuarterInput]!=='string')||!['','forecast','closed_year'].includes(b.input.annualBandOrigin)||!['','all_taxpayer_activity'].includes(b.input.coverage)||!Array.isArray(b.input.sales)||b.input.sales.length!==4||b.input.sales.some(v=>typeof v!=='string')||!Array.isArray(b.input.salesRefs)||b.input.salesRefs.length!==4||b.input.salesRefs.some(v=>typeof v!=='string')||b.history!==undefined&&!Array.isArray(b.history)||b.result!==undefined&&(!b.result.input||!Array.isArray(b.result.missing)))throw Error('Apuramento ISPC não recuperável; sem substituir por zero ou apagar histórico.');}
function books(d:Record<string,unknown>):Record<string,IspcQuarterBook>{const v=snapshot(d).ispcQuarters;if(v===undefined)return{};if(!v||typeof v!=='object'||Array.isArray(v))throw Error('Mapa trimestral ISPC inválido; originais preservados.');return v;}
export function ispcQuarterBook(d:Record<string,unknown>):IspcQuarterBook{const b=books(d)[acquisitionScope(d)]??{version:1,input:newIspcQuarterInput()};validate(b);return b;}
export function saveIspcQuarterBook(d:Record<string,unknown>,b:IspcQuarterBook):string{validate(b);return JSON.stringify({...snapshot(d),ispcQuarters:{...books(d),[acquisitionScope(d)]:b}});}
const cmp=(a:FiscalFraction,b:FiscalFraction)=>BigInt(a.numerator)*BigInt(b.denominator)-BigInt(b.numerator)*BigInt(a.denominator);
const minimum=(a:FiscalFraction,b:FiscalFraction)=>cmp(a,b)<=0n?a:b;
const positive=(a:FiscalFraction)=>cmp(a,fraction(0n))>0n?a:fraction(0n);
const atRate=(v:FiscalFraction,r:number)=>fraction(BigInt(v.numerator)*BigInt(r),BigInt(v.denominator)*100n);
function eligibility(d:Record<string,unknown>){const b=ispcEligibilityBook(d);return ispcEligibilityCurrent(d,b)?b.result??null:null;}
const key=(d:Record<string,unknown>,b:IspcQuarterBook)=>JSON.stringify(['ispc-quarter/1',acquisitionScope(d),b.input,eligibility(d)]);
export const ispcQuarterCurrent=(d:Record<string,unknown>,b:IspcQuarterBook)=>!!b.result&&b.result.key===key(d,b);
export function recordIspcQuarter(d:Record<string,unknown>,b:IspcQuarterBook,now=new Date().toISOString()):IspcQuarterBook{
validate(b);const i=b.input,e=eligibility(d),r:IspcQuarterResult={key:key(d,b),calculatedAt:now,scope:acquisitionScope(d),input:structuredClone(i),eligibility:e?structuredClone(e):null,status:'indeterminate',reason:'',missing:[],base:null,prior:null,ordinary:null,excess:null,rate:null,tax:null,payment:null,declaration:false,projected:e?.input.origin==='projected'||i.annualBandOrigin==='forecast',source:ispcQuarterSource};
const finish=()=>({...b,...(b.result?{history:[...(b.history??[]),structuredClone(b.result)]}:{}),result:r});
if(!e){r.missing.push('Avaliação de elegibilidade actual correspondente às entradas');r.reason='Reveja e guarde o enquadramento; a avaliação anterior continua no histórico.';return finish();}
if(e.status==='incompatible'||e.optionStatus==='not_opted'){r.status='not_applicable';r.reason='Os factos guardados não permitem aplicar ISPC ou indicam que não optou. Outros regimes mantêm os seus percursos.';return finish();}
if(e.status!=='compatible'){r.missing.push(...e.missing);r.reason='Enquadramento indeterminado; não produzir imposto zero.';return finish();}
// A preparation scenario may estimate tax, but never asserts an effective election.
if(e.optionStatus==='indeterminate'||e.input.origin==='effective'&&e.optionStatus!=='recorded'){r.missing.push('Opção documentada para apuramento efectivo; a preparação permite somente simulação');}
if(e.optionStatus==='preparation')r.projected=true;
if(i.year!=='2026'||!['1','2','3','4'].includes(i.quarter))r.missing.push('Ano 2026 e trimestre entre 1 e 4');
if(i.coverage!=='all_taxpayer_activity')r.missing.push('Confirmar volume de todas as actividades do sujeito passivo, não apenas desta oportunidade');
const q=Number(i.quarter),amounts:FiscalFraction[]=[],allFour=i.annualBandOrigin==='closed_year'&&!e.input.activities.some(a=>['liberal15','services12'].includes(a));
if(e.input.origin==='effective'&&e.input.optionDate&&['1','2','3','4'].includes(i.quarter)&&e.input.optionDate>`2026-${['03-31','06-30','09-30','12-31'][q-1]}`)r.missing.push('A opção registada é posterior ao trimestre; esclarecer operações abrangidas sem retroagir automaticamente');
if(['1','2','3','4'].includes(i.quarter))for(let n=0;n<(allFour?4:q);n++){try{amounts[n]=decimalFraction(i.sales[n]);}catch{r.missing.push(`Volume do trimestre ${n+1}, incluindo zero expresso`);}if(!i.salesRefs[n].trim())r.missing.push(`Suporte ou pressuposto do trimestre ${n+1}`);}
const liberal=e.input.activities.includes('liberal15'),service=e.input.activities.includes('services12');
let band:FiscalFraction|null=null;
if(!liberal&&!service){try{band=decimalFraction(i.annualBandVolume);}catch{r.missing.push('Volume anual de 2026 para identificar o escalão; distinto do volume de acesso 2025');}if(!i.annualBandOrigin||!i.annualBandRef.trim())r.missing.push('Origem (previsão ou ano encerrado) e suporte do escalão anual');}
if(r.missing.length){r.reason='Faltam dados específicos para este apuramento; os restantes percursos mantêm-se disponíveis.';return finish();}
r.base=amounts[q-1];r.prior=addFractions(amounts.slice(0,q-1));const cumulative=addFractions(amounts.slice(0,q)),annualTotal=addFractions(amounts);
if(band&&(cmp(band,cumulative)<0n||i.annualBandOrigin==='closed_year'&&cmp(band,annualTotal)!==0n)){r.reason='Volume anual do escalão diverge dos trimestres declarados; reveja a divergência antes de calcular.';r.missing.push('Reconciliar referência anual 2026 com o acumulado trimestral');return finish();}
r.rate=liberal?15:service?12:band&&cmp(band,fraction(1000000n))<=0n?3:band&&cmp(band,fraction(2500000n))<=0n?4:5;
r.ordinary=minimum(r.base,positive(subtractFractions(fraction(4000000n),r.prior)));r.excess=subtractFractions(r.base,r.ordinary);r.tax=addFractions([atRate(r.ordinary,r.rate),atRate(r.excess,20)]);r.payment=cmp(r.tax,fraction(500n))<0n?fraction(0n):r.tax;r.declaration=true;r.status='calculated';r.reason=`${r.projected?'Simulação com pressupostos explícitos; sem adesão automática.':'Apuramento segundo factos e opção documentados.'} Taxa ${r.rate}% sobre a parcela ordinária trimestral e 20% apenas sobre o excesso anual. ${cmp(r.tax,fraction(500n))<0n?'Prestação inferior a 500 MZN: sem pagamento; obrigação declarativa preservada.':'Prestação igual ou superior a 500 MZN: montante a preparar para pagamento.'} Sem dedução de custos, retenções sofridas presumidas, compensação ou acumulação de prestações dispensadas.`;return finish();
}
const amount=(v:FiscalFraction|null)=>v?`${fractionPresentation(v).decimal} MZN (${v.numerator}/${v.denominator})`:'Indeterminado';
export function ispcQuarterReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=ispcQuarterBook(d),r=b.result;if(!r)return[];return[['ISPC',`Apuramento ${r.input.year}/T${r.input.quarter}`,`${r.status==='calculated'?'Calculado':r.status==='not_applicable'?'Não aplicável':'Indeterminado'}; ${r.reason}; falta: ${r.missing.join('; ')||'nenhum dado deste recorte'}`,`${r.scope}; ${ispcQuarterCurrent(d,b)?'Entradas correspondentes':'Histórico preservado; rever entradas'}; ${r.calculatedAt}; ${r.source}`],['ISPC','Base e taxa trimestral',`Base: ${amount(r.base)}; anterior no ano: ${amount(r.prior)}; ordinária: ${amount(r.ordinary)} a ${r.rate??'indeterminada'}%; excesso: ${amount(r.excess)} a 20%`,`Volume anual de escalão: ${r.input.annualBandVolume||'não necessário para taxa de serviços'}; ${r.input.annualBandOrigin}; ${r.input.annualBandRef}; suportes: ${r.input.salesRefs.join('; ')}`],['ISPC','Imposto, pagamento e declaração',`Imposto: ${amount(r.tax)}; prestação a pagar: ${amount(r.payment)}; obrigação declarativa: ${r.declaration?'mantida':'por determinar neste percurso'}; ${r.projected?'simulação':'factos efectivos'}`,`Opção: ${r.eligibility?.optionStatus??'indeterminada'}; referência: ${r.eligibility?.input.optionReference??''}; histórico: ${b.history?.length??0} versão(ões) anterior(es). Sem submissão AT.`]];}catch(error){return[['ISPC','Apuramento não recuperável',String(error),'Originais preservados.']];}}
+86
View File
@@ -0,0 +1,86 @@
import {acquisitionScope} from './iva-acquisitions.ts';
import {ispcEligibilityBook,ispcEligibilityCurrent} from './ispc-eligibility.ts';
import {ispcWithholdingBook} from './ispc-withholding.ts';
import {ispcQuarterBook,ispcQuarterCurrent} from './ispc-quarter.ts';
import {addFractions,decimalFraction,fraction,fractionPresentation,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
export type ResidualKind='occasional'|'acquisitions'|'formalities';
export type ResidualResult={key:string;scope:string;calculatedAt:string;status:'calculated'|'settled_by_withholding'|'partial'|'indeterminate'|'not_applicable';reason:string;missing:string[];input:Record<string,string>;amounts:Record<string,FiscalFraction|null>;details:Record<string,string>;source:string};
export type ResidualBook={version:1;kind:ResidualKind;input:Record<string,string>;result?:ResidualResult;history?:ResidualResult[]};
export const residualSources={occasional:'ISPC Lei9/2025 arts3(3–4),4,5,8,9,10-A,12(3);BR248 PDF10–11. IRPS republicação Lei19/2017,BR202/7.ºsuplemento,art8(3h,4),9;PDF4/p2602(128). Lei11/2025 não altera estes artigos. Operação imprevisível/não reiterada, pessoa singular sem actividade habitual e famílias restritas; imposto próprio distinto de retenção liberatória documentada.',acquisitions:'ISPC12(3–4):limite global anual2.500.000MZN para factura por conta/retencão5%. Parcela acima do limite não adquire taxa por ultrapassagem. IRPS57(1,2k,4),republicação19/2017 PDF13/p2602(137),e65(1)naLei11/2025 PDF17:acto isolado qualificado e sem opçãoISPC aplicável,20%sobre rendimento ilíquido declarado; não confundir com20%do excesso de vendasISPC8(1)d.',formalities:'AT Comunicado9/2026,06/10/2026,p1:ModeloB–Geral enquanto se ajusta sistema;pagamentos trimestrais emJaneiro/Abril/Julho/Outubro. AT ModeloBGeral2p:quadros1/2/3/5/6/8/10. Modelo30 disponível contém75.000/3%antigos,não usado para calcular2026. Sem submissãoAT automática.'};
const blank=(kind:ResidualKind):Record<string,string>=>kind==='occasional'?{personType:'',currency:'',origin:'projected',operationDate:'',quarter:'',noHabitual:'',territory:'',sporadic:'',activity:'',reference:'',amount:'',allQuarterOperations:'',priorYearTurnover:'',priorYearRef:'',organizedRequired:'',option:'preparation',optionRef:'',optionDate:'',settlement:'',annual2026:'',annualOrigin:'',annualRef:'',priorInYear:'',buyerIspc:'',unregistered:'',buyerAnnualPurchases:'',withheldActual:'',withheldRef:''}:kind==='acquisitions'?{route:'unknown',noIspcOnExcess:'',isolatedAct:'',incomeInMoz:'',grossExcess:'',grossRef:'',supplierOptionRef:'',reference:''}:{sourceKind:'quarter',name:'',nuit:'',fiscalArea:'',address:'',declaration:'initial',formMonth:'',formYear:'2026',formPeriodRef:'',interestSituation:'',interestAmount:'',interestRef:'',externalStatus:'preparation',externalRef:'',externalDate:''};
function store(d:Record<string,unknown>){const s=JSON.parse(String(d.modelo_a_snapshot||'{"version":1,"books":{}}'));if(s.version!==1||!s.books||typeof s.books!=='object'||Array.isArray(s.books))throw Error('Livros não recuperáveis; originais preservados.');return s;}
function maps(d:Record<string,unknown>):Record<string,Record<string,ResidualBook>>{const v=store(d).ispcResiduals;if(v===undefined)return{};if(!v||typeof v!=='object'||Array.isArray(v))throw Error('Mapa residualISPC inválido; originais preservados.');return v;}
function validate(b:ResidualBook,kind:ResidualKind){
const enums:Record<string,string[]>=kind==='occasional'?{personType:['','singular','collective'],origin:['projected','effective'],noHabitual:['','yes','no'],territory:['','yes','no'],sporadic:['','yes','no'],activity:['','forestry','fishery','livestock','agriculture','poultry','beekeeping','other'],allQuarterOperations:['','yes','no'],organizedRequired:['','yes','no'],option:['preparation','opted','not_opted'],settlement:['','self','withheld'],annualOrigin:['','forecast','closed_year'],buyerIspc:['','yes','no'],unregistered:['','yes','no']}:kind==='acquisitions'?{route:['unknown','ispc_supplier','irps_isolated'],noIspcOnExcess:['','yes','no'],isolatedAct:['','yes','no'],incomeInMoz:['','yes','no']}:{sourceKind:['quarter','occasional','acquisitions'],declaration:['initial','substitution'],interestSituation:['','none','amount'],externalStatus:['preparation','submitted','received','paid']};
if(b?.input&&Object.entries(enums).some(([k,v])=>!v.includes(b.input[k])))throw Error('Opções residuais não recuperáveis;entradas preservadas.');
if(!b||b.version!==1||b.kind!==kind||!b.input||Object.keys(blank(kind)).some(k=>typeof b.input[k]!=='string')||b.history!==undefined&&!Array.isArray(b.history)||b.result!==undefined&&(!b.result.input||!b.result.amounts||!Array.isArray(b.result.missing)))throw Error('Livro residualISPC não recuperável; sem substituir por vazio.');}
export function ispcResidualBook(d:Record<string,unknown>,kind:ResidualKind):ResidualBook{const m=maps(d)[acquisitionScope(d)];if(m!==undefined&&(!m||typeof m!=='object'||Array.isArray(m)))throw Error('Contexto residual inválido.');let b=m?.[kind];if(!b){const input=blank(kind);if(kind==='occasional'){const i=ispcEligibilityBook(d).input;Object.assign(input,{personType:i.personType,currency:i.currency,origin:i.origin,operationDate:i.assessmentDate,territory:i.territory,option:i.option,optionRef:i.optionReference,optionDate:i.optionDate});}if(kind==='formalities'){if(ispcEligibilityBook(d).input.mode==='occasional'&&m?.occasional?.result)input.sourceKind='occasional';else if(!ispcQuarterBook(d).result&&m?.acquisitions?.result)input.sourceKind='acquisitions';Object.assign(input,{name:String(d.legal_name??d.organization_name??''),nuit:String(d.nuit??''),address:String(d.address??'')});}b={version:1,kind,input};}validate(b,kind);return b;}
export function saveIspcResidualBook(d:Record<string,unknown>,b:ResidualBook):string{validate(b,b.kind);const scope=acquisitionScope(d);return JSON.stringify({...store(d),ispcResiduals:{...maps(d),[scope]:{...maps(d)[scope],[b.kind]:b}}});}
const cmp=(a:FiscalFraction,b:FiscalFraction)=>BigInt(a.numerator)*BigInt(b.denominator)-BigInt(b.numerator)*BigInt(a.denominator);
const rate=(a:FiscalFraction,n:number)=>fraction(BigInt(a.numerator)*BigInt(n),BigInt(a.denominator)*100n);
const min=(a:FiscalFraction,b:FiscalFraction)=>cmp(a,b)<0n?a:b;
const positive=(a:FiscalFraction)=>cmp(a,fraction(0n))>0n?a:fraction(0n);
const validDate=(s:string)=>/^2026-\d{2}-\d{2}$/.test(s)&&!Number.isNaN(Date.parse(s))&&new Date(s).toISOString().slice(0,10)===s;
const amount=(s:string,label:string,r:ResidualResult)=>{try{return decimalFraction(s);}catch{r.missing.push(label);return null;}};
function dependency(d:Record<string,unknown>,kind:ResidualKind,i:Record<string,string>):unknown{if(kind==='acquisitions'){const e=ispcEligibilityBook(d);return[ispcWithholdingBook(d).input,e.input,e.result?.key];}if(kind==='formalities'){if(i.sourceKind==='quarter'){const b=ispcQuarterBook(d);return[b.input,b.result?.key,ispcQuarterCurrent(d,b)];}const b=ispcResidualBook(d,i.sourceKind==='occasional'?'occasional':'acquisitions');return[b.input,b.result?.key,b.result?.calculatedAt,ispcResidualCurrent(d,b)];}return null;}
const key=(d:Record<string,unknown>,b:ResidualBook)=>JSON.stringify(['ispc-residual/1',acquisitionScope(d),b.kind,b.input,dependency(d,b.kind,b.input)]);
export const ispcResidualCurrent=(d:Record<string,unknown>,b:ResidualBook)=>!!b.result&&b.result.key===key(d,b);
function occasional(i:Record<string,string>,r:ResidualResult){
if(i.personType==='collective'||i.noHabitual==='no'||i.territory==='no'||i.sporadic==='no'||i.activity==='other'){r.status='not_applicable';r.reason='Os factos excluem o recorte ocasional3(3–4); conserve o percurso habitual ou o imposto próprio aplicável, sem presumir isenção.';return;}
if(i.territory!=='yes')r.missing.push('Operação em território nacional,sem inferir da moeda ou nacionalidade');
if(!i.personType)r.missing.push('Pessoa singular por identificar');
if(i.currency!=='MZN'||!validDate(i.operationDate)||!['1','2','3','4'].includes(i.quarter)||validDate(i.operationDate)&&Math.ceil(Number(i.operationDate.slice(5,7))/3)!==Number(i.quarter))r.missing.push('Data/trimestre de2026 coerentes e moedaMZN');
if(i.noHabitual!=='yes'||i.sporadic!=='yes'||!['forestry','fishery','livestock','agriculture','poultry','beekeeping'].includes(i.activity)||!i.reference.trim())r.missing.push('Pessoa sem actividade habitual,acto imprevisível/não reiterado,família3(4)e suporte da operação');
const base=amount(i.amount,'Volume das operações ocasionais deste trimestre, incluindo zero expresso',r);r.amounts.base=base;
r.details.IRPS='Acto isolado8(3h)referente a8(2a),não previsível/reiterado8(4);família3(4)ISPC. Não se infere pelo nome do sector.';
if(i.settlement==='withheld'){
const purchases=amount(i.buyerAnnualPurchases,'Aquisições globais anuais do adquirente, incluindo estas operações',r),actual=amount(i.withheldActual,'Montante efectivamente retido',r);
if(i.buyerIspc!=='yes'||i.unregistered!=='yes'||!i.withheldRef.trim())r.missing.push('AdquirenteISPC,fornecedor não inscrito e documento de retenção liberatória12(3)');
if(purchases&&base&&(cmp(purchases,base)<0n||cmp(purchases,fraction(2500000n))>0n))r.missing.push('Reconciliar aquisições globais do adquirente dentro do limite2.500.000;fora dele usar tratamento próprio');
if(!r.missing.length&&base&&actual){r.amounts.tax=rate(base,5);r.amounts.withheld=actual;if(cmp(actual,r.amounts.tax)!==0n){r.missing.push('Retenção documentada diverge de5%da base;reconciliar diferença sem presumir quitação');return;}r.status='settled_by_withholding';r.details.rate='5';r.reason='Retenção liberatória documentada para estas operações; não somar nova liquidação própria3/4/5%nem usar a retenção como crédito duplicado. Pagamento próprio adicional não é gerado.';}return;
}
if(i.settlement!=='self'){r.missing.push('Via de liquidação própria ou retenção liberatória documentada');return;}
if(i.organizedRequired==='yes'){r.status='not_applicable';r.reason='Obrigação de contabilidade organizada declarada:fora da liquidação própriaISPC4(1b);entradas e documentos conservados,sem presumir isenção noutro imposto.';return;}
if(i.allQuarterOperations!=='yes')r.missing.push('Volume de todas as operações ocasionais do sujeito passivo no trimestre');
const access=amount(i.priorYearTurnover,'Volume de referência2025, sem inferir zero por ausência de actividade habitual',r);if(!i.priorYearRef.trim()||i.organizedRequired!=='no')r.missing.push('Suporte da referência anual e inexistência de obrigação de contabilidade organizada4(1)');if(access&&cmp(access,fraction(4000000n))>0n){r.status='not_applicable';r.reason='Volume de acesso4(1)superior4.000.000MZN declarado:fora da liquidação própriaISPC;sem atribuir taxa de outro regime por presunção.';return;}
if(i.option==='not_opted'){r.status='not_applicable';r.reason='Sem opçãoISPC para esta operação; não aplicar exclusãoIRPS5nem taxaISPC automaticamente.';return;}
if(!['preparation','opted'].includes(i.option)||i.option==='opted'&&(!i.optionRef.trim()||!validDate(i.optionDate)||i.optionDate>i.operationDate)||i.origin==='effective'&&i.option!=='opted')r.missing.push('Opção documentada aplicável à operação efectiva;preparação apenas permite cenário');
const annual=amount(i.annual2026,'Volume anual2026 para escalão, distinto do acesso2025',r),prior=amount(i.priorInYear,'Volume anterior no ano2026',r);if(!['forecast','closed_year'].includes(i.annualOrigin)||!i.annualRef.trim())r.missing.push('Referência anual suportada e previsão identificada como cenário');
if(base&&prior&&annual&&(cmp(annual,addFractions([base,prior]))<0n||i.annualOrigin==='closed_year'&&i.quarter==='4'&&cmp(annual,addFractions([base,prior]))!==0n))r.missing.push('Reconciliar volume anual com acumulado anterior e trimestre');
if(r.missing.length||!base||!prior||!annual)return;
const n=cmp(annual,fraction(1000000n))<=0n?3:cmp(annual,fraction(2500000n))<=0n?4:5,ordinary=min(base,positive(subtractFractions(fraction(4000000n),prior))),excess=subtractFractions(base,ordinary),tax=addFractions([rate(ordinary,n),rate(excess,20)]);r.amounts={...r.amounts,ordinary,excess,tax,payment:cmp(tax,fraction(500n))<0n?fraction(0n):tax};r.details.projected=i.origin==='projected'||i.option==='preparation'||i.annualOrigin==='forecast'?'yes':'no';r.details.rate=String(n);r.details.declaration='Mantida mesmo quando prestação inferior500MZN';r.status='calculated';r.reason=`${r.details.projected==='yes'?'Cenário declarado;sem adesão automática.':'Opção e factos efectivos declarados.'} Operações ocasionais próprias3(3–4),base trimestral9,taxa${n}%e20%somente no excesso de vendas acima4.000.000. Não há retenção presumida nem dedução de custos/IVA.`;
}
function acquisitions(d:Record<string,unknown>,i:Record<string,string>,r:ResidualResult){
const w=ispcWithholdingBook(d).input,e=ispcEligibilityBook(d);if(!ispcEligibilityCurrent(d,e)||e.result?.status!=='compatible'||e.result.optionStatus==='not_opted'||e.result.optionStatus==='indeterminate'||e.input.origin==='effective'&&e.result.optionStatus!=='recorded'){r.missing.push('Enquadramento/opção actual do adquirenteISPC');return;}
if(w.applicable!=='yes'||w.naturalOccasional!=='yes'||w.unregistered!=='yes'||w.related!=='yes'||!['forestry','fishery','livestock','agriculture','poultry','beekeeping'].includes(w.activity)||!w.reference.trim()){r.missing.push('Condições específicas12(3–4)e suporte no livro das aquisições');return;}
const base=amount(w.base,'Base das aquisições',r),prior=amount(w.priorAnnualPurchases,'Aquisições globais anteriores do ano',r);if(!base||!prior)return;const covered=min(base,positive(subtractFractions(fraction(2500000n),prior))),excess=subtractFractions(base,covered);r.amounts={base,prior,covered,excess,coveredTax:rate(covered,5),excessTax:null,total:null};r.details.quarter=w.quarter;r.details.acquisitionRef=w.reference;
if(cmp(excess,fraction(0n))<=0n){r.status='not_applicable';r.reason='Sem parcela acima do limite; o cálculo5%já disponível permanece no seu livro, sem segunda liquidação.';return;}
r.status='partial';r.reason='Parcela até ao limite separada a5%; parcela excedente quantificada, sem presumir5%ou20%pelo simples excesso. Montante total continua indeterminado até identificar tratamento próprio.';
if(i.route==='irps_isolated'){
const net=amount(i.grossExcess,'Rendimento ilíquido da parcela excedente, distinto de rendimento líquido e do preço líquido de IVA',r);if(i.noIspcOnExcess!=='yes'||i.isolatedAct!=='yes'||i.incomeInMoz!=='yes'||!i.grossRef.trim()||!i.reference.trim())r.missing.push('Acto isoladoIRPS8(3h,4),rendimento emMoçambique,sem opçãoISPC5aplicável à parcela,e referências da classificação/base');
if(net&&cmp(net,excess)!==0n)r.missing.push('Base ilíquida57(4)não coincide com a parcela bruta identificada;reconciliar sem deduzir custos/IVA automaticamente');
if(!r.missing.length&&net){r.amounts.excessTax=rate(net,20);r.amounts.total=addFractions([r.amounts.coveredTax!,r.amounts.excessTax]);r.status='calculated';r.reason='Correspondência positiva independente:IRPS57(2k)acto isolado,20%sobre rendimento ilíquido57(4)da parcela identificada,sem opçãoISPCaplicável. Não se usa taxa20%do excesso de vendasISPC. Retenções5%e20%separadas,não são crédito do imposto próprio do adquirente.';}
}else if(i.route==='ispc_supplier'){if(!i.supplierOptionRef.trim())r.missing.push('Referência da opção/registoISPCdo fornecedor aplicável a estas operações');r.reason='Fornecedor com opçãoISPC declarada:art5impede aplicarIRPSporpresunção. A parcela fora12(3)exige factura/registo do fornecedor e liquidação própria correspondente; o comprador não atribui5%ou20%automaticamente. Sem total de retenção presumido.';}
else r.missing.push('Enquadramento específico da parcela excedente:opçãoISPCdo fornecedor ou acto isoladoIRPS,base e suporte');
}
function formalities(d:Record<string,unknown>,i:Record<string,string>,r:ResidualResult){
let src:ResidualResult|undefined;if(i.sourceKind==='quarter'){const b=ispcQuarterBook(d),v=b.result;if(!v||!ispcQuarterCurrent(d,b)||v.status!=='calculated'){r.missing.push('Apuramento trimestral actual e calculado');return;}r.amounts={base:v.base,tax:v.tax,payment:v.payment,ordinary:v.ordinary,excess:v.excess};r.details={quarter:v.input.quarter,rate:String(v.rate),sourceDate:v.calculatedAt};}
else{const b=ispcResidualBook(d,i.sourceKind==='occasional'?'occasional':'acquisitions');src=b.result;if(!src||!ispcResidualCurrent(d,b)){r.missing.push('Resultado actual do percurso seleccionado');return;}if(src.status==='settled_by_withholding'){r.status='not_applicable';r.reason='Operação própria já com retenção liberatória documentada:conservar comprovativo,sem emitir liquidação própria duplicada.';return;}if(src.status!=='calculated'){r.missing.push('Cálculo completo do percurso seleccionado;as partes determinadas permanecem consultáveis');return;}r.amounts={...src.amounts,tax:src.amounts.total??src.amounts.tax,payment:src.amounts.total??src.amounts.payment};r.details={quarter:src.input.quarter||src.details.quarter,rate:src.details.rate||'retenções separadas',sourceDate:src.calculatedAt};}
const first=r.amounts.covered??r.amounts.ordinary??r.amounts.base,second=r.amounts.excess??fraction(0n),firstRate=i.sourceKind==='acquisitions'?5:Number(r.details.rate);
if(first&&[3,4,5,12,15].includes(firstRate)){const firstTax=r.amounts.coveredTax??rate(first,firstRate),secondTax=r.amounts.excessTax??rate(second,20);r.amounts.q8base01=first;r.amounts.q8tax05=firstTax;r.amounts.q8base02=second;r.amounts.q8tax06=secondTax;r.details.q8rate01=String(firstRate);r.details.q8rate02='20';if(r.amounts.tax&&cmp(addFractions([firstTax,secondTax]),r.amounts.tax)!==0n)r.missing.push('Parcelas do quadro8divergem do cálculo guardado;conferir apenas essa correspondência');}
if(i.sourceKind==='acquisitions'&&!(i.retentionFormRef??'').trim())r.missing.push('Modelo/código de entrega da retençãoISPC12(3)e da retençãoIRPS57(2k),distintos do imposto próprio;comunicado9não resolve isoladamente este modelo');
if(r.amounts.tax&&r.amounts.payment&&cmp(r.amounts.tax,fraction(0n))>0n&&cmp(r.amounts.tax,fraction(500n))<0n&&cmp(r.amounts.payment,fraction(0n))===0n)r.missing.push('Representação da dispensa de pagamento10-A noB–Geral:declarar imposto apurado sem presumir zero no campo de montante apurado');
r.details.model='Modelo B–Geral;comunicadoAT9/2026';r.details.paymentMonth=['Abril2026','Julho2026','Outubro2026','Janeiro2027'][Number(r.details.quarter)-1]||'Trimestre por identificar';r.details.formPeriod=i.formMonth?`${i.formMonth}/${i.formYear}`:'Indeterminado:quadro2pede mês/ano;comunicado identifica trimestre/mês de pagamento,sem resolver a codificação do período';
if(!/^[0-9]{9}$/.test(i.nuit)||!i.name.trim()||!i.fiscalArea.trim()||!i.address.trim())r.missing.push('NUIT9dígitos,nome,área fiscal/UGC e domicílio para formalização;preparação do cálculo não exige esses campos');
if(!/^(0[1-9]|1[0-2])$/.test(i.formMonth)||!['2026','2027'].includes(i.formYear)||!i.formPeriodRef.trim())r.missing.push('Mês/ano a inscrever no quadro2e instrução/correspondência utilizada; não preencher automaticamente com mês de pagamento');
if(!['none','amount'].includes(i.interestSituation)||!i.interestRef.trim())r.missing.push('Situação dos juros compensatórios e suporte;desconhecido não é zero');
if(i.interestSituation==='amount')r.amounts.interest=amount(i.interestAmount,'Juros documentados,não calculados por falta de taxa/período regulamentar',r);else if(i.interestSituation==='none')r.amounts.interest=fraction(0n);
r.amounts.finalPayment=r.amounts.payment&&r.amounts.interest?addFractions([r.amounts.payment,r.amounts.interest]):null;
if(i.externalStatus!=='preparation'&&(!i.externalRef.trim()||!i.externalDate.trim()))r.missing.push('Referência e data da submissão/recepção/pagamento declarado;sem confirmação automáticaAT');
r.status=r.missing.length?'partial':'calculated';r.reason='Preparação dos campos identificados do B–Geral,com cálculo e prestação separados. O Modelo30antigo não recebe taxas2026. Submissão,recepção e pagamento são actos externos;este registo conserva referências e histórico,sem os efectuar ou certificar.';
}
export function priorOccasionalSettlement(b:ResidualBook):ResidualResult|undefined{if(b.kind!=='occasional'||b.input.settlement!=='self')return;return[b.result,...(b.history??[])].find(r=>r?.status==='settled_by_withholding'&&r.input.reference.trim()===b.input.reference.trim()&&r.input.operationDate===b.input.operationDate&&r.input.quarter===b.input.quarter&&r.input.amount===b.input.amount);}
export function recordIspcResidual(d:Record<string,unknown>,b:ResidualBook,now=new Date().toISOString()):ResidualBook{validate(b,b.kind);const r:ResidualResult={key:key(d,b),scope:acquisitionScope(d),calculatedAt:now,status:'indeterminate',reason:'Dados específicos em falta;sem presumir zero.',missing:[],input:structuredClone(b.input),amounts:{},details:{},source:residualSources[b.kind]};if(b.kind==='occasional'){occasional(b.input,r);const prior=priorOccasionalSettlement(b);if(prior&&r.status==='calculated'){r.details.priorWithholdingRef=prior.input.withheldRef;r.details.priorWithholdingDate=prior.calculatedAt;if(b.input.withholdingCorrected==='yes'&&(b.input.withholdingCorrectionRef??'').trim()){r.details.withholdingCorrectionRef=b.input.withholdingCorrectionRef;r.reason+=' Correcção da retenção anterior declarada segundo referência externa,sem certificar esse acto;histórico preservado.';}else{r.status='partial';r.amounts.hypotheticalOwnTax=r.amounts.tax;r.amounts.tax=null;r.amounts.payment=null;r.amounts.withheld=prior.amounts.withheld??prior.amounts.tax;r.missing.push('Retenção liberatória anterior para a mesma operação;reconciliar eventual correcção documentada antes de nova prestação própria');r.reason='A via foi alterada,mas a retenção liberatória documentada permanece no histórico. Não é gerada segunda prestação;os dados da operação e as duas versões ficam preservados.';}}}else if(b.kind==='acquisitions')acquisitions(d,b.input,r);else formalities(d,b.input,r);return{...b,...(b.result?{history:[...(b.history??[]),structuredClone(b.result)]}:{}),result:r};}
const labels:Record<string,string>={base:'Base',prior:'Acumulado global anterior',ordinary:'Parcela ordinária',excess:'Parcela excedente',tax:'Imposto',payment:'Prestação própria',withheld:'Retenção documentada',hypotheticalOwnTax:'Cálculo próprio apenas hipotético,sem prestação gerada',covered:'Parcela abrangida pelo limite',coveredTax:'Retenção5%da parcela abrangida',excessTax:'RetençãoIRPS20%da parcela qualificada',total:'Total de retenções',interest:'Juros documentados',finalPayment:'Preparação do montante a entregar'};
export function ispcResidualReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{const rows:Array<[string,string,string,string]>=[];for(const kind of ['occasional','acquisitions','formalities']as const){try{const b=ispcResidualBook(d,kind),r=b.result;if(!r)continue;const title={occasional:'Operações ocasionais próprias',acquisitions:'Aquisições acima do limite',formalities:'Formalidades2026—B–Geral'}[kind];rows.push(['ISPC',title,`${({calculated:'Calculado',settled_by_withholding:'Retenção liberatória documentada',partial:'Parcial',indeterminate:'Indeterminado',not_applicable:'Não aplicável ao recorte'} as Record<string,string>)[r.status]};${r.reason};falta:${r.missing.join('; ')||'nenhum dado deste recorte'}`,`${ispcResidualCurrent(d,b)?'Entradas correspondentes':'Histórico preservado;rever entradas'};${r.calculatedAt};${r.source}`]);for(const[k,v]of Object.entries(r.amounts).filter(([k])=>!k.startsWith('q8')))rows.push(['ISPC',`${title}—${kind==='formalities'&&r.input.sourceKind==='acquisitions'&&k==='payment'?'Retenções a entregar pelo adquirente':labels[k]||k}`,v?`${fractionPresentation(v).decimal}MZN (${v.numerator}/${v.denominator})`:'Indeterminado',`${r.input.reference||r.details.acquisitionRef||r.input.externalRef||'Pressupostos/documentos declarados'};${r.scope}`]);}catch(e){rows.push(['ISPC','Residual não recuperável',String(e),'Originais preservados.']);}}return rows;}
export function ispcFormalPreparationHtml(d:Record<string,unknown>):string{const b=ispcResidualBook(d,'formalities'),r=b.result;if(!r||!ispcResidualCurrent(d,b)||!Object.keys(r.amounts).length)throw Error('Guarde primeiro preparação actual com cálculo identificado.');const esc=(v:unknown)=>String(v??'').replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]!));const v=(n:string)=>r.amounts[n]?fractionPresentation(r.amounts[n]!).decimal:'Indeterminado';const fields=[['Quadro1—tipo',b.input.declaration==='initial'?'Inicial':'Substituição'],['Quadro2—mês/ano',r.details.formPeriod],['Contexto—trimestre e mês de pagamento',`2026/T${r.details.quarter};${r.details.paymentMonth} (não copiado automaticamente para quadro2)`],['Quadro3—NUIT/ÁreaFiscal',`${b.input.nuit}/${b.input.fiscalArea}`],['Quadro5—nome',b.input.name],['Quadro6—domicílio',b.input.address],['Quadro8—linha1:base01/taxa/montante05',`${b.input.sourceKind==='acquisitions'?'ISPC—retenção12(3)':'ISPC—parcela ordinária'};base01:${v('q8base01')};taxa:${r.details.q8rate01}%;montante05:${v('q8tax05')}`],['Quadro8—linha2:base02/taxa/montante06',r.amounts.q8base02&&cmp(r.amounts.q8base02,fraction(0n))>0n?`${b.input.sourceKind==='acquisitions'?'IRPS—acto isolado57(2k)':'ISPC—excesso de vendas8(1)d'};base02:${v('q8base02')};taxa20%;montante06:${v('q8tax06')}`:'Não aplicável ao cálculo seleccionado;sem segunda parcela'],['Quadro8—subtotal1campo09',v('tax')],['Quadro10—montante/juros/importância',`Imposto calculado:${v('tax')};prestação legal:${v('payment')};juros:${v('interest')};totalpreparado:${v('finalPayment')}`],['Modelo/código das retenções',b.input.retentionFormRef||'Por corresponder se aplicável'],['Estado externo declarado',`${({preparation:'Em preparação',submitted:'Submetido segundo referência declarada',received:'Recebido segundo referência declarada',paid:'Pago segundo referência declarada'} as Record<string,string>)[b.input.externalStatus]};${b.input.externalRef};${b.input.externalDate}`],['Falta',r.missing.join('; ')||'Nenhum dado deste recorte']];return`<!doctype html><html lang="pt"><meta charset="utf-8"><title>PreparaçãoISPC—B–Geral</title><style>body{font:16px system-ui;margin:32px}td,th{border:1px solid #777;padding:10px;vertical-align:top}table{border-collapse:collapse;width:100%}</style><h1>Preparação de campos ISPC—Modelo B–Geral</h1><p>Correspondência de apoio; não é formulário oficial emitido, declaração submetida ou comprovativo de pagamento. Original e instrução AT preservados,sem os alterar.</p><table>${fields.map(([a,c])=>`<tr><th>${esc(a)}</th><td>${esc(c)}</td></tr>`).join('')}</table><p>${esc(r.source)}</p><p>Quadros8e10têm numeração própria;campos homónimos não são somados entre quadros. Não preencher área de serviços nem assinatura automaticamente.</p></html>`;}
+24
View File
@@ -0,0 +1,24 @@
import {ispcEligibilityBook,ispcEligibilityCurrent} from './ispc-eligibility.ts';
import {acquisitionScope} from './iva-acquisitions.ts';
import {addFractions,decimalFraction,fraction,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
export type IspcWithholdingInput={applicable:''|'no'|'yes';quarter:string;base:string;priorAnnualPurchases:string;naturalOccasional:''|'yes'|'no';unregistered:''|'yes'|'no';related:''|'yes'|'no';activity:''|'forestry'|'fishery'|'livestock'|'agriculture'|'poultry'|'beekeeping'|'other';reference:string;};
export type IspcWithholdingResult={input:IspcWithholdingInput;key:string;status:'calculated'|'indeterminate'|'not_applicable';reason:string;withheld:FiscalFraction|null;calculatedAt:string;source:string};
export type IspcWithholdingBook={version:1;input:IspcWithholdingInput;result?:IspcWithholdingResult;history?:IspcWithholdingResult[]};
export const ispcWithholdingSource='Lei9/2025,republicaçãoISPC,arts3(3–4),12(3–4);PDF10–11/p2180(10–11). Retenção liberatória5% sobre aquisição a pessoa singular ocasional não inscrita, ligada à actividade, até limite global anual2.500.000MZN; factura por conta do fornecedor e entrega trimestral em modelo próprio. Não é crédito contra o imposto próprio nem se aplica o mínimo500 desta prestação à retenção.';
const blank=():IspcWithholdingInput=>({applicable:'',quarter:'1',base:'',priorAnnualPurchases:'',naturalOccasional:'',unregistered:'',related:'',activity:'',reference:''});
function snapshot(d:Record<string,unknown>){const s=JSON.parse(String(d.modelo_a_snapshot||'{"version":1,"books":{}}'));if(s.version!==1||!s.books||typeof s.books!=='object'||Array.isArray(s.books))throw Error('Livros não recuperáveis; originais preservados.');return s;}
function validate(b:IspcWithholdingBook){if(!b||b.version!==1||!b.input||Object.keys(blank()).some(k=>typeof b.input[k as keyof IspcWithholdingInput]!=='string')||['applicable','naturalOccasional','unregistered','related'].some(k=>!['','yes','no'].includes(b.input[k as keyof IspcWithholdingInput]))||!['','forestry','fishery','livestock','agriculture','poultry','beekeeping','other'].includes(b.input.activity)||b.history!==undefined&&!Array.isArray(b.history))throw Error('RetençõesISPC não recuperáveis; originais preservados.');}
function map(d:Record<string,unknown>):Record<string,IspcWithholdingBook>{const v=snapshot(d).ispcWithholdings;if(v===undefined)return{};if(!v||typeof v!=='object'||Array.isArray(v))throw Error('Mapa de retençõesISPC inválido.');return v;}
export function ispcWithholdingBook(d:Record<string,unknown>):IspcWithholdingBook{const b=map(d)[acquisitionScope(d)]??{version:1,input:blank()};validate(b);return b;}
export function saveIspcWithholdingBook(d:Record<string,unknown>,b:IspcWithholdingBook):string{validate(b);return JSON.stringify({...snapshot(d),ispcWithholdings:{...map(d),[acquisitionScope(d)]:b}});}
export function recordIspcWithholding(d:Record<string,unknown>,b:IspcWithholdingBook,now=new Date().toISOString()):IspcWithholdingBook{validate(b);const i=b.input,e=ispcEligibilityBook(d),r:IspcWithholdingResult={input:structuredClone(i),key:JSON.stringify([acquisitionScope(d),i]),status:'indeterminate',reason:'Identifique se existem aquisições abrangidas; não presumir retenção zero.',withheld:null,calculatedAt:now,source:ispcWithholdingSource};
if(i.applicable==='no'){r.status='not_applicable';r.reason='Sem aquisições abrangidas, segundo declaração expressa; entradas anteriores preservadas.';}
else if(i.applicable==='yes'&&(!ispcEligibilityCurrent(d,e)||e.result?.status!=='compatible'||e.result.optionStatus==='not_opted'||e.result.optionStatus==='indeterminate'||e.input.origin==='effective'&&e.result.optionStatus!=='recorded')){r.reason='Guarde o enquadramento e a opção aplicáveis do adquirenteISPC antes de calcular retenção efectiva; sem inferir adesão.';}
else if(i.applicable==='yes'){
if(i.naturalOccasional==='no'||i.unregistered==='no'||i.related==='no'||i.activity==='other'){r.status='not_applicable';r.reason='Aquisição fora do recorte12(3–4) declarado; outros regimes de retenção mantêm análise própria,sem presumir isenção.';}
else if(i.naturalOccasional==='yes'&&i.unregistered==='yes'&&i.related==='yes'&&i.activity&&i.reference.trim()&&['1','2','3','4'].includes(i.quarter)){
try{const base=decimalFraction(i.base),prior=decimalFraction(i.priorAnnualPurchases),total=addFractions([base,prior]);if(BigInt(total.numerator)>2500000n*BigInt(total.denominator))r.reason='Total global anual superior2.500.000MZN: tratamento da aquisição acima do limite por corresponder; não reter automaticamente5% nem truncar a base.';else{r.status='calculated';r.withheld=fraction(BigInt(base.numerator)*5n,BigInt(base.denominator)*100n);r.reason='Retenção5% calculada separadamente do imposto próprio; emitir factura por conta do fornecedor e preparar entrega trimestral em modelo próprio. Sem deduzir esta retenção da prestaçãoISPC.';}}catch{r.reason='Base e aquisições globais anteriores do ano necessários,incluindo zero expresso; não presumir montantes.';}
}else r.reason='Identifique pessoa singular ocasional3(3–4),actividade abrangida,não inscrição,ligação à actividade,trimestre e suporte; dados desconhecidos não viram não aplicáveis.';
}
return{...b,...(b.result?{history:[...(b.history??[]),structuredClone(b.result)]}:{}),result:r};}
export function ispcWithholdingReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=ispcWithholdingBook(d),r=b.result;if(!r)return[];return[['ISPC','Retenção em aquisições ocasionais',`${r.status}; ${r.withheld?fractionPresentation(r.withheld).decimal+' MZN':'Indeterminado/não aplicado'}; ${r.reason}`,`2026/T${r.input.quarter}; base:${r.input.base}; anteriores globais:${r.input.priorAnnualPurchases}; suporte:${r.input.reference}; ${r.key===JSON.stringify([acquisitionScope(d),b.input])?'Entradas correspondentes':'Histórico preservado;rever entradas'}; ${r.calculatedAt}; ${r.source}`]];}catch(e){return[['ISPC','Retenção não recuperável',String(e),'Originais preservados.']];}}
@@ -0,0 +1,55 @@
import type {Acquisition,AcquisitionResult} from './iva-acquisitions.ts';
import {acquisitionScope} from './iva-acquisitions.ts';
import {evaluateAcquisitionBC} from './iva-acquisition-bc.ts';
import {reducedBaseBook,reducedBaseCurrent,reducedBaseTreatments,evaluateReducedBase} from './iva-reduced-bases.ts';
import {decimalFraction,fraction,fractionLabel,fractionPresentation,subtractFractions,type FiscalFraction} from './fiscal-rational.ts';
export const acquisitionAllocationVersion='acquisition-allocation/1';
export const acquisitionAllocationSource='L2-D: CIVA22(1–8),Lei13/2016 PDF16/p1426(274);Lei10/2025,18(6),PDF13/p2180(13).22(4)numerador anual semIVA com direito18/19;denominador anual semIVA de todas operações,incluindo fora de campo;22(5)exclui vendas de activo usado e operações imobiliárias/financeiras acessórias.22(8)quociente à centésima imediatamente superior.22(2)afectação real com comunicação prévia;22(6–7)provisório,regularização anual emE. Não substitui condições18–20 ou calcula restituiçãoL3.';
type Choice=''|'yes'|'no';
export type AcquisitionAllocation={version:1;method:''|'actual'|'pro_rata'|'reduced';numerator:string;denominator:string;unit:string;referenceYear:string;basis:''|'prior_year'|'initial_changed';scopeRef:string;source:string;communicationRef:string;declarationRef:string;actualRequired:Choice;noExcludedPayments:Choice;facts:Record<string,Choice>;reducedId:string;reducedFingerprint:string};
export function newAcquisitionAllocation(period:string):AcquisitionAllocation{return{version:1,method:'',numerator:'',denominator:'',unit:'',referenceYear:String(Number(period.slice(0,4))-1),basis:'',scopeRef:'',source:'',communicationRef:'',declarationRef:'',actualRequired:'',noExcludedPayments:'',facts:{},reducedId:'',reducedFingerprint:''};}
export function validAcquisitionAllocation(v:unknown):v is AcquisitionAllocation{if(!v||typeof v!=='object'||Array.isArray(v))return false;const d=v as AcquisitionAllocation;return d.version===1&&['','actual','pro_rata','reduced'].includes(d.method)&&['','prior_year','initial_changed'].includes(d.basis)&&['numerator','denominator','unit','referenceYear','scopeRef','source','communicationRef','declarationRef','reducedId','reducedFingerprint'].every(k=>typeof d[k as keyof AcquisitionAllocation]==='string')&&[d.actualRequired,d.noExcludedPayments].every(v=>['','yes','no'].includes(v))&&!!d.facts&&typeof d.facts==='object'&&!Array.isArray(d.facts)&&Object.values(d.facts).every(v=>['','yes','no'].includes(v));}
export function allocationReducedChoices(draft:Record<string,unknown>){return reducedBaseBook(draft).rows.map(row=>({id:row.id,label:`${row.description||row.id} — ${row.period} — ${reducedBaseTreatments.find(t=>t.id===row.treatment)?.label??row.treatment}`,row}));}
export function adoptAllocationReduced(draft:Record<string,unknown>,d:AcquisitionAllocation,id:string):AcquisitionAllocation{const source=allocationReducedChoices(draft).find(r=>r.id===id);if(!source)throw Error('Base reduzida de origem indisponível;originais preservados.');return {...d,reducedId:id,reducedFingerprint:JSON.stringify(source.row),facts:{...d.facts,scopeConfirmed:''}};}
export function allocationSourceKey(draft:Record<string,unknown>,rows:Acquisition[]):string{return rows.some(r=>r.d)?JSON.stringify({version:acquisitionAllocationVersion,reducedOperations:reducedBaseBook(draft).rows,sources:rows.filter(r=>r.d?.method==='reduced').map(r=>({row:allocationReducedChoices(draft).find(s=>s.id===r.d?.reducedId)?.row??null,current:reducedBaseCurrent(draft,reducedBaseBook(draft))}))}):'';}
export function allocationHasUnconsolidatedOutputs(draft:Record<string,unknown>,period:string):boolean{return reducedBaseBook(draft).rows.some(r=>r.period===period);}
type Decision={ratio:FiscalFraction|null;rawRatio?:FiscalFraction;reason:string;source:string};
export function acquisitionAllocationDecision(draft:Record<string,unknown>|undefined,row:Acquisition):Decision{
const d=row.d;const stop=(reason:string):Decision=>({ratio:null,reason,source:acquisitionAllocationSource});
if(!d||!validAcquisitionAllocation(d))return stop('Método/parâmetrosD não recuperáveis;sem percentagem por defeito.');
if(!draft||draft.currency!=='MZN'||row.sourceCurrency!=='MZN'||!/^2026-(0[1-9]|1[0-2])$/.test(row.period))return stop('ÂmbitoD2026/MZN ou contexto em falta.');
if(!d.scopeRef.trim()||!d.source.trim()||d.facts.scopeConfirmed!=='yes')return stop('Âmbito da aquisição/actividade,fonte e correspondência por confirmar;sem inferir da oportunidade.');
if(d.method==='reduced'){
if(row.allocation!=='taxable_only')return stop('18(6) neste percurso exige afectação exclusiva à operação de base reduzida;combinação com afectação mista ainda não demonstrada.');
const b=reducedBaseBook(draft),source=b.rows.find(r=>r.id===d.reducedId);if(!source||!reducedBaseCurrent(draft,b)||JSON.stringify(source)!==d.reducedFingerprint)return stop('Origem de base reduzida alterada/incompleta:rever e adoptar expressamente;histórico conservado.');
const result=evaluateReducedBase(source,draft.currency),rule=reducedBaseTreatments.find(r=>r.id===source.treatment);if(!rule||result.status!=='determined')return stop('Condições da base reduzida de origem ainda indeterminadas;não basta escolher percentagem.');
return{ratio:fraction(BigInt(rule.percent),100n),reason:`18(6):proporção específica${rule.percent}% reutilizada de${rule.branch}/${source.id};aplicada uma vez ao IVA elegível,sem converter percentagem de base em taxaIVA.`,source:acquisitionAllocationSource+';'+b.result!.source};
}
if(row.allocation!=='mixed')return stop('Método22 exige afectação mista expressamente identificada;conserve a afectação exclusiva quando aplicável.');
if(d.facts.rightBasis!=='yes')return stop('Identifique a parte/operações com direito18/19;isenção ou sector não estabelecem o direito.');
if(!/^\d{1,15}(\.\d{1,6})?$/.test(d.numerator)||!/^\d{1,15}(\.\d{1,6})?$/.test(d.denominator))return stop('Numerador/denominador em falta ou inválidos;sem percentagem presumida.');
const n=decimalFraction(d.numerator),den=decimalFraction(d.denominator);if(BigInt(den.numerator)===0n)return stop('Denominador zero:não existe quociente aplicável.');
const rawRatio=fraction(BigInt(n.numerator)*BigInt(den.denominator),BigInt(n.denominator)*BigInt(den.numerator));if(BigInt(rawRatio.numerator)>BigInt(rawRatio.denominator))return stop('Numerador excede denominador;resolver bases sem limitar silenciosamente a100%.');
if(d.method==='actual'){
if(!d.unit.trim()||d.facts.actualScope!=='yes'||d.facts.communication!=='yes'||!d.communicationRef.trim()||d.facts.conditionsMet!=='yes')return stop('Afectação real22(2):critério/unidade,repartição efectiva,comunicação prévia e condições concretamente aplicáveis por completar;sem criar aprovação adicional.');
return{ratio:rawRatio,rawRatio,reason:`Afectação real22(2):${d.numerator}/${d.denominator} ${d.unit};critério e comunicação${d.communicationRef}. Fracção real exacta,sem arredondamento de pro rata.`,source:acquisitionAllocationSource};
}
if(d.method!=='pro_rata')return stop('Escolha afectação real,pro rata provisório ou proporção específica18(6).');
if(d.actualRequired==='yes')return stop('Está identificada imposição de afectação real22(3);não aplicar pro rata em substituição.');
if(d.facts.annualScope!=='yes'||d.facts.netExclusions!=='yes')return stop('Confirmar totais anuais semIVA e âmbito22(4–5):inclui fora de campo;exclui vendas de activo usado e imobiliárias/financeiras acessórias. Não usar só vendas de um mês como total anual.');
const year=Number(row.period.slice(0,4));
if(d.basis==='prior_year'){if(d.referenceYear!==String(year-1))return stop('Pro rata provisório22(6) usa operações do ano anterior ao exercício;sem substituir pelo mês corrente.');}
else if(d.basis==='initial_changed'){if(d.referenceYear!==String(year)||d.facts.initialChanged!=='yes'||!d.declarationRef.trim())return stop('Estimativa22(7):início/alteração substancial,ano e referência da declaração de início/alterações por identificar.');}
else return stop('Indique base provisória22(6) ou estimativa expressa22(7);regularização final22(6) segueE.');
const numerator=BigInt(rawRatio.numerator),denominator=BigInt(rawRatio.denominator);const hundredths=(numerator*100n+denominator-1n)/denominator;
return{ratio:fraction(hundredths,100n),rawRatio,reason:`Pro rata provisório22(4/6/7/8):quociente${fractionLabel(rawRatio)}→${hundredths}% (quociente à centésima superior). Base anual${d.referenceYear},${d.basis==='prior_year'?'ano anterior':'estimativa declarada'}. Acerto anual emE,sem recalcular históricos.`,source:acquisitionAllocationSource};
}
export function evaluateAcquisitionAllocation(row:Acquisition,currency:string,registered:Choice,draft:Record<string,unknown>|undefined,raw:AcquisitionResult):AcquisitionResult{
const decision=acquisitionAllocationDecision(draft,row),d=row.d!;
const unknown=(reason:string):AcquisitionResult=>({...raw,deductible:null,reason,eligibility:{status:'indeterminate',reason,source:decision.source}});
if(!decision.ratio)return unknown(decision.reason);if(!row.bc)return unknown('Complete a natureza/condiçõesB/C da aquisição antes da proporção;sem isenção de condições documentais.');
const base=evaluateAcquisitionBC(row,currency,registered,draft,raw,{right:{status:'eligible',reason:decision.reason,source:decision.source,scopeId:draft?acquisitionScope(draft):undefined},noExcludedPayments:d.noExcludedPayments});
if(base.deductible===null||base.eligibility?.status!=='eligible')return base;
const before=base.deductibleExact??decimalFraction(base.deductible);const exact=fraction(BigInt(before.numerator)*BigInt(decision.ratio.numerator),BigInt(before.denominator)*BigInt(decision.ratio.denominator));const reason=base.reason+' '+decision.reason;
return {...base,deductible:fractionPresentation(exact).decimal,deductibleExact:exact,nonDeductibleExact:subtractFractions(decimalFraction(base.vat!),exact),reason,eligibility:{...base.eligibility,status:'eligible',reason},allocationCalculation:{version:acquisitionAllocationVersion,ratio:decision.ratio,rawRatio:decision.rawRatio??decision.ratio,before,source:decision.source}};
}
+101
View File
@@ -0,0 +1,101 @@
import type {Acquisition,AcquisitionResult} from './iva-acquisitions.ts';
import type {AcquisitionEligibility} from './iva-acquisition-right.ts';
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
import {linkedOperationRight,linkedBeverageDeductionRight} from './iva-acquisition-right.ts';
import {acquisitionTreatmentIssue} from './iva-acquisition-continuity.ts';
import {decimalFraction,fraction,fractionPresentation,subtractFractions} from './fiscal-rational.ts';
export const acquisitionBCVersion='acquisition-imports-exclusions/1';
export const acquisitionBCSource='L2-B/C: CIVA18(1)(a/b),18(2),19,20(1)(a–f)/20(2)/20(3)(a/b),21. Lei13/2016 PDF14–15,p1426(272–273);Lei22/2022 PDF3,p2252(27),art20(2–3);Lei10/2025 PDF13,p2180(13),18(2)/19(2). Bebidas13(2):Lei13/2016 PDF12,p1426(270). MZN/2026,mesmo mês documental;sem pro rata18(6),regularizações ou restituiçãoL3.';
type Choice=''|'yes'|'no';
export const expenseOptions=[['ordinary','Despesa sem exclusão especial'],['vehicle','Viatura de turismo,barco de recreio,helicóptero,avião,moto ou outro veículo'],['fuel','Combustível normalmente utilizável em viaturas automóveis'],['travel','Transportes e viagens do sujeito passivo/pessoal'],['lodging_food','Alojamento e alimentação'],['beverages','Bebidas,tabaco e recepção'],['telephone','Comunicações telefónicas'],['luxury','Divertimento e luxo'],['other','Outro caso — por enquadrar']] as const;
export type AcquisitionBC={version:1;expense:string;reducedSupply:Choice;evidence:string;facts:Record<string,Choice>;fuelKind:''|'diesel'|'other';dieselUse:''|'heavy_passengers'|'public_passengers'|'machine'|'agriculture'|'other';beveragePath:''|'deduction'|'refund';importer:string;belongs:Choice;ownImportVat:Choice;vatBasis:''|'due'|'exempt'|'zero'|'unknown';vatRef:string;goodsRef:string;source?:{map:string;id:string;fingerprint:string}};
export function newAcquisitionBC():AcquisitionBC{return{version:1,expense:'',reducedSupply:'',evidence:'',facts:{},fuelKind:'',dieselUse:'',beveragePath:'',importer:'',belongs:'',ownImportVat:'',vatBasis:'',vatRef:'',goodsRef:''};}
export function acquisitionBCDetails(b:AcquisitionBC):string{
const labels:Record<string,string>={exigibleInPeriod:'IVA aduaneiro exigível no período de exercício confirmado pelo documento',tourism:'Bem abrangido20(1)(a)',saleOrExploit:'Venda/exploração como objecto da actividade',resale:'Combustível para revenda',dieselScope:'Âmbito específico do uso de gasóleo confirmado',commercialTraveller:'Viajante comercial por conta própria',ownLandline:'Telefone fixo em nome do sujeito passivo',beverageSpecial:'Bebidas no âmbito13(2)',onlyDeduction:'Parcela exclusivamente para dedução',notCoastalFishing:'Sem provisões de pesca costeira'};
const keys:Record<string,string[]>={vehicle:['tourism',...(b.facts.tourism==='yes'?['saleOrExploit']:[])],fuel:['resale',...(b.fuelKind==='diesel'&&b.dieselUse!=='other'?['dieselScope']:[])],lodging_food:['commercialTraveller'],telephone:['ownLandline'],beverages:['beverageSpecial',...(b.facts.beverageSpecial==='yes'?[...(b.beveragePath==='deduction'?['onlyDeduction']:[]),'notCoastalFishing']:[])]};
return [...(b.facts.exigibleInPeriod!==undefined?['exigibleInPeriod']:[]),...(keys[b.expense]??[])].map(k=>`${labels[k]}:${b.facts[k]==='yes'?'Sim':b.facts[k]==='no'?'Não':'Por indicar'}`).concat(b.expense==='fuel'?[`Combustível:${b.fuelKind==='diesel'?'Gasóleo':b.fuelKind==='other'?'Outro':'Por indicar'}`,`Utilização:${({heavy_passengers:'Pesado de passageiros',public_passengers:'Transporte público licenciado,excepto rent a car',machine:'Máquina,não veículo matriculado',agriculture:'Tractor agrícola,emprego exclusivo/predominante',other:'Outro uso50%','':'Por indicar'})[b.dieselUse]}`]:[],b.expense==='beverages'&&b.facts.beverageSpecial==='yes'?[`Via:${b.beveragePath==='deduction'?'DeduçãoL2':b.beveragePath==='refund'?'RestituiçãoL3':'Por indicar'}`]:[]).join('; ');
}
export function validAcquisitionBC(v:unknown):v is AcquisitionBC{
if(!v||typeof v!=='object'||Array.isArray(v))return false;const b=v as AcquisitionBC;
return b.version===1&&['expense','evidence','vatRef','goodsRef','importer','fuelKind','dieselUse','beveragePath','vatBasis'].every(k=>typeof b[k as keyof AcquisitionBC]==='string')&&[b.reducedSupply,b.belongs,b.ownImportVat].every(v=>['','yes','no'].includes(v))&&!!b.facts&&typeof b.facts==='object'&&!Array.isArray(b.facts)&&Object.values(b.facts).every(v=>['','yes','no'].includes(v))&&(!b.source||['map','id','fingerprint'].every(k=>typeof b.source?.[k as keyof typeof b.source]==='string'));
}
type ImportSource={id:string;treatment?:string;description?:string;documentRef?:string;documentDate?:string;period?:string;importDate?:string;importer?:string};
const importMaps=['importExemptions','objectiveImports','remissionImports'];
export function acquisitionImportSources(draft:Record<string,unknown>){const store=readAcquisitionStore(draft.modelo_a_snapshot) as unknown as Record<string,Record<string,{rows:ImportSource[]}>>;return importMaps.flatMap(map=>(store[map]?.[acquisitionScope(draft)]?.rows??[]).map(row=>({map,row,label:`${row.description||row.id} — ${row.period??''} — ${row.documentRef||'documento por indicar'}`})));}
export function reuseAcquisitionImport(draft:Record<string,unknown>,row:Acquisition,map:string,id:string):Acquisition{
const src=acquisitionImportSources(draft).find(v=>v.map===map&&v.row.id===id);if(!src)throw Error('Origem da importação indisponível;dados conservados.');
const bc=row.bc??newAcquisitionBC();return {...row,description:row.description||src.row.description||'',documentRef:row.documentRef||src.row.documentRef||'',documentDate:row.documentDate||src.row.documentDate||src.row.importDate||'',period:row.period||src.row.period||'',bc:{...bc,importer:bc.importer||src.row.importer||'',source:{map,id,fingerprint:JSON.stringify(src.row)}}};
}
export function acquisitionBCSourceKey(draft:Record<string,unknown>,rows:Acquisition[]):string{return rows.some(r=>r.bc)?JSON.stringify({version:acquisitionBCVersion,sources:rows.filter(r=>r.bc?.source).map(r=>acquisitionImportSources(draft).find(s=>s.map===r.bc!.source!.map&&s.row.id===r.bc!.source!.id)?.row??null)}):'';}
function validDate(value:string){const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateAcquisitionBC(row:Acquisition,currency:string,registered:Choice,draft:Record<string,unknown>|undefined,raw:AcquisitionResult,partial?:{right:AcquisitionEligibility;noExcludedPayments:Choice}):AcquisitionResult{
const bc=row.bc!;let right=partial?.right??(row.deductionLink&&draft?linkedOperationRight(draft,row.deductionLink):{status:'indeterminate' as const,reason:'Vínculo à operação de destino em falta.',source:acquisitionBCSource});
const stop=(reason:string,status:'eligible'|'no_right'|'indeterminate'='indeterminate',percent?:number):AcquisitionResult=>{
const exact=percent!==undefined&&raw.vat!==null?decimalFraction(raw.vat):null;
const deductibleExact=exact?fraction(BigInt(exact.numerator)*BigInt(percent!),BigInt(exact.denominator)*100n):undefined;
return {...raw,reason,deductible:deductibleExact?fractionPresentation(deductibleExact).decimal:null,...(deductibleExact?{deductibleExact,nonDeductibleExact:subtractFractions(exact!,deductibleExact)}:{}),eligibility:{...right,status,reason,source:acquisitionBCSource+'; '+right.source}};
};
if(!validAcquisitionBC(bc))return stop('CondiçõesB/C não recuperáveis;sem regra por defeito.');
if(currency!=='MZN'||row.sourceCurrency!==currency||!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||raw.vat===null)return stop(raw.reason||'IVA/moeda/período em falta.');
if(row.domestic==='no'){
if(!/^\d{1,15}(\.\d{1,6})?$/.test(row.vat.trim()))return stop('Indique expressamente o IVA do bilhete;diferença entre custo líquido/bruto não constitui montante aduaneiro identificado.');
if(row.net.trim()&&raw.net===null||row.gross.trim()&&raw.gross===null)return stop('Valores de custo preenchidos inválidos;conservar e resolver a divergência.');
}else if(raw.net===null||raw.gross===null)return stop(raw.reason);
if(raw.net!==null&&raw.gross!==null&&fractionPresentation(subtractFractions(decimalFraction(raw.gross),decimalFraction(raw.net))).decimal!==raw.vat)return stop('Líquido + IVA diverge do bruto declarado;sem substituir valores.');
const treatmentIssue=acquisitionTreatmentIssue(row.acquisitionTreatment);if(treatmentIssue)return stop(treatmentIssue);
if(!['projected','effective'].includes(row.origin))return stop('Indique dados efectivos ou pressupostos de projecção.');
if(row.sourceMonth!==null&&(!row.sourceBasis||row.sourceAmount===null||(row.sourceBasis==='net'?raw.net:raw.gross)===null||JSON.stringify(decimalFraction(row.sourceAmount))!==JSON.stringify(decimalFraction((row.sourceBasis==='net'?raw.net:raw.gross)!))))return stop('Valor de origem divergente ou por classificar;sem sobrescrita.');
if(row.domestic==='no'&&row.field!=='11'||row.domestic==='yes'&&row.field==='11'||!['yes','no'].includes(row.domestic))return stop('Separe aquisição interna08–10 da importação de bens11.');
if(bc.source){const src=draft?acquisitionImportSources(draft).find(s=>s.map===bc.source!.map&&s.row.id===bc.source!.id):undefined;if(!src||JSON.stringify(src.row)!==bc.source.fingerprint)return stop('OrigemL1 da importação alterada:adopte explicitamente os dados actuais,conservando edições e histórico.');if(['service_in_customs_value','accessory_service_first_destination'].includes(src.row.treatment??''))return stop('Origem é serviço incluído na base aduaneira12(1)(e),não IVA próprio da importação de bens;identifique o bilhete dos bens,sem somar novamente IVA do serviço.');}
if(registered!=='yes')return stop('Enquadramento do adquirente no regime normal por confirmar.');
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(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;
if(noExcludedPayments==='no')return stop('Pagamentos15(6)(c)/19(2) excluídos.','no_right',0);
if(noExcludedPayments!=='yes')return stop('Exclusão19(2) por esclarecer.');
if(!validDate(row.documentDate)||row.documentDate.slice(0,7)!==row.period)return stop('Documento e exercício no mesmo mês neste incremento;dedução posterior não presumida.');
if(!row.documentRef.trim()||row.legalDocument!=='yes'||row.held!=='yes'||row.integrity!=='yes')return stop('Referência,forma legal,posse e integridade do documento por completar.');
if(row.domestic==='no'){
if(row.documentType!=='customs'||!bc.importer.trim()||!bc.goodsRef.trim()||!bc.vatRef.trim()||bc.belongs!=='yes'||bc.ownImportVat!=='yes')return stop('Bilhete de despacho,importador/titularidade,bens/linha e IVA próprio devido na importação por completar;fornecedor inscrito no IVA interno não é exigido.');
if(bc.facts.exigibleInPeriod!=='yes')return stop('Exigibilidade do IVA aduaneiro no período de exercício por confirmar pelo documento21(1);não inferida só da emissão do bilhete.Dedução posterior conserva percurso próprio.');
if(!['due','exempt','zero'].includes(bc.vatBasis))return stop('IVA da importação desconhecido;não inferir montante da classificaçãoL1 ou calcular direitosL13.');
if(['exempt','zero'].includes(bc.vatBasis)&&decimalFraction(raw.vat).numerator!=='0')return stop('IVA positivo incompatível com isenção/zero declarado;resolver divergência sem substituir montante.');
}else if(!['invoice','equivalent'].includes(row.documentType)||!row.supplier.trim()||row.supplierRegistered!=='yes')return stop('Factura/documento equivalente e fornecedor interno inscrito por completar.');
if(row.domestic==='yes'&&bc.reducedSupply==='yes')return stop('IVA suportado em fornecimento17-A:exclusão20(2),Lei22/2022;distinta do destino19(2).','no_right',0);
if(row.domestic==='yes'&&bc.reducedSupply!=='no')return stop('Indique se o IVA suportado respeita a fornecimento17-A;sem inferir pela taxa ou valor.');
if(!expenseOptions.some(([id])=>id===bc.expense)||bc.expense==='other'||!bc.evidence.trim())return stop('Natureza da despesa e fundamento factual/documental por identificar.');
const f=bc.facts;
switch(bc.expense){
case 'ordinary':return stop('Elegível pelas condições declaradas18/19;sem exclusão especial20 identificada.','eligible',100);
case 'vehicle':
if(f.tourism==='')return stop('Classificação do veículo na definição20(1)(a) em falta.');
if(f.tourism==='no')return stop('Veículo fora da definição20(1)(a),segundo características/utilização documentadas.','eligible',100);
if(f.tourism!=='yes')return stop('Indique se o bem está abrangido por20(1)(a).');
if(f.saleOrExploit==='yes')return stop('Excepção20(3)(a):venda/exploração do bem constitui objecto da actividade;combustível conserva20(1)(b).','eligible',100);
return f.saleOrExploit==='no'?stop('Bem abrangido20(1)(a),sem excepção20(3)(a).','no_right',0):stop('Venda/exploração como objecto da actividade por esclarecer.');
case 'fuel':
if(f.resale==='yes')return stop('Combustível adquirido para revenda,conforme ressalva20(3)(a);fundamento específico documentado.','eligible',100);
if(f.resale!=='no')return stop('Destino de revenda do combustível por esclarecer.');
if(bc.fuelKind==='other')return stop('Combustível normalmente utilizável em viaturas,fora da excepção gasóleo20(1)(b).','no_right',0);
if(bc.fuelKind!=='diesel')return stop('Natureza do combustível por indicar.');
if(bc.dieselUse==='other')return stop('Gasóleo20(1)(b):dedução50%,não taxa de IVA nem pro rata geral.','eligible',50);
if(['heavy_passengers','public_passengers','machine','agriculture'].includes(bc.dieselUse)){
if(f.dieselScope!=='yes')return stop('Confirme o âmbito específico20(1)(b)(i–iv);não basta escolher a categoria.');
return stop('Gasóleo20(1)(b)(i–iv):dedução integral no uso específico confirmado;transporte público exclui rent a car,máquina não é veículo matriculado,tractor agrícola tem emprego exclusivo/predominante.','eligible',100);
}return stop('Utilização do gasóleo por indicar.');
case 'travel':return stop('Transportes/viagens do sujeito passivo e pessoal excluídos20(1)(c).','no_right',0);
case 'lodging_food':return f.commercialTraveller==='yes'?stop('Excepção20(3)(b):viajante comercial por conta própria,no quadro da actividade profissional.','eligible',100):f.commercialTraveller==='no'?stop('Alojamento/alimentação excluídos20(1)(d),sem excepção20(3)(b).','no_right',0):stop('Âmbito de viajante comercial por conta própria por esclarecer.');
case 'telephone':return f.ownLandline==='yes'?stop('Telefone fixo em nome do sujeito passivo:excepção expressa20(1)(e).','eligible',100):f.ownLandline==='no'?stop('Comunicações telefónicas fora da excepção20(1)(e).','no_right',0):stop('Telefone fixo e titularidade por esclarecer.');
case 'luxury':return stop('Despesa de divertimento/luxo20(1)(f),segundo natureza/montante e exploração normal declarados.','no_right',0);
case 'beverages':
if(bc.facts.beverageSpecial==='no')return stop('Bebidas/tabaco/recepção excluídos20(1)(d),fora do fundamento especial13(2).','no_right',0);
if(bc.facts.beverageSpecial==='yes'&&bc.beveragePath==='refund'&&right.reason.startsWith('Via de dedução13(2)'))return stop('Via restituição13(2):linha documental integral escolhida para acompanhamentoL3-E,sem dedução desta parcela. Não representa pedido apresentado,concessão ou recebimento.','no_right',0);
if(bc.facts.beverageSpecial==='yes'&&bc.beveragePath==='deduction'&&bc.facts.onlyDeduction==='yes'&&right.reason.startsWith('Via de dedução13(2)'))return stop(right.reason+' IVA suportado identificado neste documento;mesma parcela não segue restituiçãoL3.','eligible',100);
return stop('Via especial13(2) por delimitar:dedução ou restituiçãoL3,sem dupla contagem;tabaco/recepção não herdam a excepção de bebidas.');
}
return stop('Tratamento não implementado;rascunho preservado.');
}
@@ -0,0 +1,14 @@
import type { Acquisition } from './iva-acquisitions.ts';
export type AcquisitionTreatment = '' | 'normal' | 'former_exploration_exemption';
export const acquisitionContinuityVersion='acquisition-continuity/1';
export const formerExplorationSource = 'Aviso da Assembleia da República,BR89/I Série,08/06/2017,PDF1/p.569:ordena eliminação de14(2)(c) e transcreve «c) eliminado». CIVA republicado Lei13/2016,PDF13/p.1426(271),continha aquisição de serviços de perfuração,pesquisa e construção de infra-estruturas na actividade mineira/petrolífera em fase de prospecção/pesquisa. Lei22/2022art.1 eLei10/2025art.1 não reintroduzem14(2)(c). Cobertura2026/MZN;sem cálculo retroactivo.';
export const formerExplorationNotice = 'A antiga isenção da aquisição de serviços de perfuração, pesquisa e infra-estruturas de prospecção mineira/petrolífera do artigo14(2)(c) foi eliminada pela rectificação publicada no BR89 de08/06/2017. Não se aplica nesta cobertura2026. Não indique IVA zero nem dedução por esta referência. Valores e documento conservados; escolha expressamente continuar a aquisição sem esta isenção e reveja o enquadramento normal. Outra eventual base legal deve ser identificada, não presumida.';
export function acquisitionTreatmentIssue(treatment:unknown):string|null {
if(treatment===undefined||treatment===''||treatment==='normal')return null;
return treatment==='former_exploration_exemption'?formerExplorationNotice:'Tratamento especial guardado desconhecido; dados conservados, sem isenção ou dedução presumidas. Identifique o enquadramento antes de continuar.';
}
export function continueWithoutFormerExploration(row:Acquisition):Acquisition {
if(row.acquisitionTreatment!=='former_exploration_exemption')throw new Error('A continuidade exige a antiga referência14(2)(c) seleccionada; aquisição conservada.');
return {...row,acquisitionTreatment:'normal',acquisitionTreatmentOrigin:{id:'former_exploration_exemption',source:formerExplorationSource}};
}
+31
View File
@@ -0,0 +1,31 @@
import {acquisitionScope} from './iva-acquisitions.ts';
import {operationTreatments,salesBook,salesCurrent,type SalesOperation,type SalesLineResult} from './iva-operations.ts';
export const acquisitionRightVersion='acquisition-operation-right/1';
export const acquisitionRightSource='L2-A — CIVA19(1)(a)/(b)(i/iv/v),19(2),Lei13/2016 PDF15/p1426(273);Lei10/2025 PDF13/p2180(13):18(2),19(2),exclusão17-A. Condições da aquisição18/20/21 continuam próprias. Sem resolverP00105/06,importações,afectação parcial,excepções ou regularizações.';
export type AcquisitionRightLink={version:1;scopeId:string;operationId:string;fingerprint:string;scopeConfirmed:''|'yes'|'no';allocationRef:string;noExcludedPayments:''|'yes'|'no'};
export type AcquisitionEligibility={status:'eligible'|'no_right'|'indeterminate';reason:string;source:string;operationId?:string;operationPeriod?:string;operationTreatment?:string;operationDescription?:string;operationArticle?:string;scopeId?:string};
export function validAcquisitionRightLink(value:unknown):value is AcquisitionRightLink{if(!value||typeof value!=='object'||Array.isArray(value))return false;const v=value as AcquisitionRightLink;return v.version===1&&['scopeId','operationId','fingerprint','allocationRef'].every(k=>typeof v[k as keyof AcquisitionRightLink]==='string')&&['','yes','no'].includes(v.scopeConfirmed)&&['','yes','no'].includes(v.noExcludedPayments);}
function fingerprint(row:SalesOperation,result:SalesLineResult|undefined){return JSON.stringify({version:acquisitionRightVersion,input:row,classification:result?{article:result.article,source:result.source,status:result.status}:null});}
export function linkedBeverageDeductionRight(draft:Record<string,unknown>,link:AcquisitionRightLink,notCoastalFishing:boolean):AcquisitionEligibility{
const base=linkedOperationRight(draft,link),b=salesBook(draft),row=b.rows.find(r=>r.id===link.operationId),line=b.result?.rows.find(r=>r.id===link.operationId),rule=operationTreatments.find(t=>t.id===row?.treatment);
if(link.scopeId!==acquisitionScope(draft)||!salesCurrent(draft,b)||!row||!line||!rule||link.fingerprint!==fingerprint(row,line)||row.supplyCategory!=='beverages'||!['onboard_seagoing_ship','onboard_international_aircraft','onboard_rescue_coastal_ship'].includes(row.treatment)||!row.description.trim()||!row.establishment.trim()||!row.evidence.trim()||rule.conditions.some((_,i)=>!row.confirmed.includes(i))||!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||row.sourceCurrency!=='MZN'||!/^\d{1,15}(\.\d{1,6})?$/.test(row.amount)||!['net','included'].includes(row.basis)||row.treatment==='onboard_rescue_coastal_ship'&&!notCoastalFishing)return {...base,status:'indeterminate',reason:'Correspondência própria13(2) por demonstrar em origemL1 actual:c/d/h,bebidas,condições e documento;pesca costeira conserva exclusão de provisões.'};
return {...base,status:'eligible',reason:'Via de dedução13(2) de bebidas em13(1)(c/d/h),nas condições demonstradas;20(1)(d) não se aplica para este efeito. Não concede isenção directa nem restituição.',source:base.source+';CIVA13(2–3),Lei13/2016 PDF12/p1426(270)'};
}
export function acquisitionOperationChoices(draft:Record<string,unknown>){const book=salesBook(draft);return book.rows.map(row=>({id:row.id,label:`${row.description||row.id} — ${row.period} — ${operationTreatments.find(t=>t.id===row.treatment)?.label??row.treatment}`,row,current:salesCurrent(draft,book)}));}
export function createAcquisitionRightLink(draft:Record<string,unknown>,operationId:string):AcquisitionRightLink{const b=salesBook(draft),row=b.rows.find(r=>r.id===operationId);if(!row)throw Error('Operação de origem não encontrada nesta oportunidade;dados preservados.');return{version:1,scopeId:acquisitionScope(draft),operationId,fingerprint:fingerprint(row,b.result?.rows.find(r=>r.id===operationId)),scopeConfirmed:'',allocationRef:'',noExcludedPayments:''};}
export function linkedOperationRight(draft:Record<string,unknown>,link:AcquisitionRightLink):AcquisitionEligibility{
const base:AcquisitionEligibility={status:'indeterminate',reason:'',source:acquisitionRightSource,operationId:link.operationId,scopeId:link.scopeId};const stop=(reason:string,status:AcquisitionEligibility['status']='indeterminate')=>({...base,status,reason});
if(!validAcquisitionRightLink(link)||link.scopeId!==acquisitionScope(draft))return stop('Vínculo inválido ou pertencente a outra oportunidade;sem direito presumido.');
const b=salesBook(draft),row=b.rows.find(r=>r.id===link.operationId),line=b.result?.rows.find(r=>r.id===link.operationId);if(!row)return stop('Operação ligada removida/não recuperável;escolha uma origem disponível,sem apagar o histórico.');
base.operationPeriod=row.period;base.operationTreatment=row.treatment;base.operationDescription=row.description;base.operationArticle=line?.article;base.source+=';'+(line?.source??'Fonte da classificação por recuperar');
if(!salesCurrent(draft,b)||!line||line.status==='indeterminate')return stop('Classificação L1 de origem incompleta ou alterada;recupere/actualize a classificação,sem dedução por rótulo.');
if(link.fingerprint!==fingerprint(row,line))return stop('Operação de origem alterada:reveja e adopte explicitamente a origem actual;montantes e histórico da aquisição conservados.');
const rule=operationTreatments.find(t=>t.id===row.treatment);if(!rule)return stop('Correspondência do direito ainda não identificada para esta operação.');
if(/17-A/.test(rule.article))return stop('Operação abrangida por17-A:19(2),redacçãoLei10/2025,não permite dedução apesar de ter IVA liquidado.','no_right');
if(/19\(1\)\(b\)\((i|iv|v)\)/.test(rule.article))return stop('Direito da operação identificado em'+rule.article+';a aquisição continua sujeita às suas condições próprias.','eligible');
if(line.status==='calculated'&&rule.rate===16)return stop('Operação sujeita e não isenta:direito19(1)(a),sujeito a19(2) e condições próprias da aquisição.','eligible');
// This is a bounded match to the already implemented article9 catalogue, after
// checking its express article19 exceptions. Never use the ModeloA box as law.
if(line.status==='exempt'&&/\b9\(/.test(rule.article))return stop('Operação isenta do artigo9 fora das correspondências com direito identificadas19(1)(b);não confere dedução neste fundamento.','no_right');
return stop('Classificação disponível,mas correspondência do direito não implementada neste percurso;não inferir direito pela caixa05/06/07 ou por IVAzero.');
}
+282
View File
@@ -0,0 +1,282 @@
import { modeloAPurchaseReferences } from './iva-modelo-a.ts';
import { monthlyIvaInput, monthlyIvaKey, readMonthlyIvaRecord, readMonthlyIvaSettings } from './monthly-iva.ts';
import { restoreBusinessPlanSnapshot } from './business-financial-plan.ts';
import { salesBook, salesCurrent as salesOperationsCurrent } from './iva-operations.ts';
import {evaluateAcquisitionAllocation,validAcquisitionAllocation,allocationSourceKey,allocationHasUnconsolidatedOutputs,acquisitionAllocationVersion,acquisitionAllocationSource,type AcquisitionAllocation} from './iva-acquisition-allocation.ts';
import {evaluateAcquisitionBC,validAcquisitionBC,acquisitionBCSource,acquisitionBCSourceKey,acquisitionBCDetails,expenseOptions,type AcquisitionBC} from './iva-acquisition-bc.ts';
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';
import {beverageParcelReserved} from './iva-beverage-parcels.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.';
export const acquisitionSources = 'Modelo A DOCX 62c198e9 / v1 63d45fa8; VAT Return.pdf SHA256 9c0b99a810c7db53eb75d63c22ee22fb86a50ba57bd5509041ed80ee10f75741, p.1; CIVA republicado Lei13/2016, PDF14–16; Lei22/2022, art.20; Lei10/2025, arts.18/19, PDF13.';
type Choice = '' | 'yes' | 'no';
export type Acquisition = {
id: string; field: '08'|'09'|'10'|'11'; period: string; origin: 'projected'|'effective';
sourceMonth: number|null; sourcePeriod?:string; sourceField?:'inventory'|'asset'|'operating'; sourceAmount: string|null; sourceCurrency: string; sourceBasis: ''|'net'|'gross';
net: string; vat: string; gross: string; documentType: ''|'invoice'|'equivalent'|'customs'; documentRef: string; documentDate: string; documentLine:string;
supplier: string; supplierRegistered: Choice; legalDocument: Choice; held: Choice; domestic: Choice;
allocation: ''|'taxable_only'|'mixed'|'no_right'; exclusion: ''|'none'|'excluded'|'special';
integrity: Choice; description: string;
acquisitionTreatment?: AcquisitionTreatment;
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}};
type PeriodInput = {period:string; complete:boolean; absent:string[];importsComplete?:boolean};
export type AcquisitionBook = {currency:string; rightVersion?:string; taxpayerRegistered?:Choice; rows:Acquisition[]; periods:PeriodInput[]; result?:AcquisitionCalculation;history?:AcquisitionCalculation[]};
export type AcquisitionCalculation = {version:string; revision:number; calculatedAt:string; opportunity:string; location:string; currency:string; sourceKey:string; basis:string; sources:string;
declarations?:{taxpayerRegistered:Choice;periods:PeriodInput[]}; rows:AcquisitionResult[]; inputs:Acquisition[]; periods:Array<{period:string; fields:Record<string,string|null>; exactFields?:Record<string,FiscalFraction|null>; reasons:string[]}>};
type Store = {version:1; books:Record<string,AcquisitionBook>};
const excluded = ['03','04','05','06','07','11','12','13'];
export const acquisitionExcludedFields = excluded;
export function acquisitionScope(draft:Record<string,unknown>):string {
if(!draft.context_opportunity) {
try {const context=JSON.parse(String(draft.context_applicability_snapshot??''));if(context.opportunity_choices?.length>1)throw new Error('Escolha a oportunidade em tratamento antes de preparar as compras.');}
catch(cause) {if(cause instanceof Error && cause.message.startsWith('Escolha'))throw cause;}
}
return String(draft.context_opportunity || 'general');
}
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.');
if(book?.rows?.some(row=>row.deductionLink!==undefined&&!validAcquisitionRightLink(row.deductionLink)))throw new Error('Vínculo da aquisição não recuperável; original preservado.');
if(book?.history!==undefined&&!Array.isArray(book.history))throw new Error('Histórico de aquisições não recuperável; originais preservados, sem substituição.');
if(!book || !Array.isArray(book.rows) || !Array.isArray(book.periods) || typeof book.currency!=='string') throw new Error('Formato de compras não recuperável; sem substituição.');
const stringKeys=Object.keys(newAcquisition('','','')).filter(key=>!['sourceMonth','sourceAmount'].includes(key));
if(book.rows.some(row=>!row || stringKeys.some(key=>typeof row[key as keyof Acquisition]!=='string') || !(row.sourceMonth===null || Number.isInteger(row.sourceMonth)) || !(row.sourceAmount===null || typeof row.sourceAmount==='string')) || book.periods.some(p=>!p || typeof p.period!=='string' || typeof p.complete!=='boolean' || !Array.isArray(p.absent) || p.absent.some(f=>typeof f!=='string'))) throw new Error('Linhas ou períodos de compras não recuperáveis; os dados guardados foram preservados.');
}
return value;
}
export function acquisitionBook(draft:Record<string,unknown>):AcquisitionBook {
return readAcquisitionStore(draft.modelo_a_snapshot).books[acquisitionScope(draft)] ?? {currency:String(draft.currency ?? ''),rows:[],periods:[]};
}
export function saveAcquisitionBook(draft:Record<string,unknown>,book:AcquisitionBook):string {
const store=readAcquisitionStore(draft.modelo_a_snapshot);
return JSON.stringify({...store,books:{...store.books,[acquisitionScope(draft)]:book}});
}
export function newAcquisition(id:string,period:string,currency:string):Acquisition {
return {id,field:'09',period,origin:'projected',sourceMonth:null,sourceAmount:null,sourceCurrency:currency,sourceBasis:'',net:'',vat:'',gross:'',documentType:'',documentRef:'',documentDate:'',documentLine:'',supplier:'',supplierRegistered:'',legalDocument:'',held:'',domestic:'',allocation:'',exclusion:'',integrity:'',description:''};
}
function periods(draft:Record<string,unknown>):string[] {
try {return monthlyIvaInput(draft,readMonthlyIvaSettings(String(draft.monthly_iva_settings ?? ''))).monthly_sales.map(r=>r.date.slice(0,7));}
catch {return [];}
}
export function acquisitionPlanReferences(draft:Record<string,unknown>):Array<{key:string;kind:'inventory'|'asset'|'operating';month:number;period:string;amount:string|null;currency:string;label:string}> {
const dates=periods(draft),plan=restoreBusinessPlanSnapshot(String(draft.business_plan_snapshot??''));
if(!plan || !dates.length)return [];
if(plan.currency!==draft.currency)throw new Error('Moeda do plano divergente; não reutilizar como moeda do projecto.');
const inventory=modeloAPurchaseReferences(draft).map(r=>({key:`inventory:${r.month}`,kind:'inventory' as const,month:r.month,period:dates[r.month-1],amount:r.declared,currency:plan.currency,label:`Compras/encomendas — mês ${r.month}`}));
const asset={key:'asset:1',kind:'asset' as const,month:1,period:dates[0],amount:plan.assetInvestment?.trim()||null,currency:plan.currency,label:'Orçamento de investimento em activos — período a confirmar'};
const operating=dates.map((period,index)=>({key:`operating:${index+1}`,kind:'operating' as const,month:index+1,period,amount:(plan.monthlyOperatingExpensesByPeriod?plan.monthlyOperatingExpensesByPeriod[index]:plan.monthlyOperatingExpenses)?.trim()||null,currency:plan.currency,label:`Orçamento de despesas operacionais — mês ${index+1}`}));
return [...inventory,asset,...operating];
}
export function reuseAcquisitions(draft:Record<string,unknown>,book:AcquisitionBook):AcquisitionBook {
const dates=periods(draft); if(!dates.length) throw new Error('Defina o período mensal e resolva a moeda da projecção antes de reutilizar compras.');
const rows=[...book.rows];
for(const reference of modeloAPurchaseReferences(draft)) {
if(rows.some(r=>r.sourceMonth===reference.month)) continue;
rows.push({...newAcquisition(`plan-${reference.month}`,dates[reference.month-1],String(draft.currency ?? '')),sourceMonth:reference.month,sourcePeriod:dates[reference.month-1],sourceAmount:reference.declared,description:`Compras/encomendas do plano — mês ${reference.month}`});
}
return {...book,rows,periods:dates.map(period=>book.periods.find(p=>p.period===period) ?? {period,complete:false,absent:[]})};
}
// Decimal arithmetic for aggregation only. No binary rounding and no invented purchase tax rate.
function amount(raw:unknown):bigint|null {
if(typeof raw!=='string' || !/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim())) return null;
const [a,b='']=raw.trim().split('.');return BigInt(a)*1000000n+BigInt(b.padEnd(6,'0'));
}
function money(value:bigint):string {const a=value/1000000n,b=(value%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0');return `${a}.${b}`;}
function sum(values:Array<string|null>):string|null {const parsed=values.map(amount);return parsed.some(v=>v===null)?null:money((parsed as bigint[]).reduce((a,b)=>a+b,0n));}
function dateValid(raw:string):boolean {const date=new Date(`${raw}T00:00:00Z`);return /^\d{4}-\d{2}-\d{2}$/.test(raw) && Number.isFinite(date.getTime()) && date.toISOString().slice(0,10)===raw;}
function evaluateAcquisitionBase(row:Acquisition,currency:string,taxpayerRegistered:Choice=''):AcquisitionResult {
let n=amount(row.net),v=amount(row.vat),g=amount(row.gross);
if(n!==null && v!==null && g===null && !row.gross.trim()) g=n+v;
if(g!==null && v!==null && n===null && !row.net.trim() && g>=v) n=g-v;
if(n!==null && g!==null && v===null && !row.vat.trim() && g>=n) v=g-n;
const result:AcquisitionResult={id:row.id,net:n===null?null:money(n),vat:v===null?null:money(v),gross:g===null?null:money(g),deductible:null,reason:''};
const stop=(reason:string,deductible:string|null=null)=>({...result,reason,deductible});
if(currency!=='MZN' || row.sourceCurrency!==currency) return stop('Divergência ou moeda fora de MZN; sem conversão.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)) return stop('Período fora do âmbito 2026 ou em falta.');
const treatmentIssue=acquisitionTreatmentIssue(row.acquisitionTreatment);
if(treatmentIssue)return stop(treatmentIssue);
if(n===null || v===null || g===null || n+v!==g) return stop('Indique dois valores válidos; líquido + IVA deve corresponder ao bruto.');
if(row.sourceMonth!==null && (!row.sourceBasis || amount(row.sourceAmount)!==(row.sourceBasis==='net'?n:g))) return stop('Classifique ou resolva a divergência do valor de origem; não foi reinterpretado.');
if(v===0n&&!row.deductionLink) return stop('IVA explicitamente indicado como zero; não existe imposto a deduzir nesta aquisição.','0.00');
if(taxpayerRegistered!=='yes') return stop('Confirme o enquadramento do adquirente como sujeito passivo de IVA no regime normal; não é inferido da organização.');
if(row.allocation==='no_right' || row.exclusion==='excluded' || row.supplierRegistered==='no' || row.legalDocument==='no' || row.integrity==='no') return stop('Sem dedução no âmbito declarado: afectação, exclusão, fornecedor ou documento não elegível.','0.00');
if(row.domestic!=='yes') return stop('Aquisição interna por confirmar; importações fora deste lote.');
if(row.allocation!=='taxable_only' || row.exclusion!=='none') return stop('Confirme afectação exclusiva a operações tributadas e ausência de exclusões; casos mistos/especiais não calculados.');
if(!['invoice','equivalent'].includes(row.documentType) || !row.documentRef.trim() || !row.supplier.trim() || row.supplierRegistered!=='yes' || row.legalDocument!=='yes' || row.held!=='yes' || row.integrity!=='yes') return stop('Documento, fornecedor inscrito, posse e condições de dedução ainda incompletos.');
if(!dateValid(row.documentDate) || row.documentDate.slice(0,7)!==row.period) return stop('Data do documento e período de dedução devem coincidir neste lote; dedução posterior não presumida.');
return stop(row.origin==='projected'?'Dedução projectada sob pressupostos explícitos; não certifica factura ou declaração.':'Dedução segundo dados e condições declarados; sem submissão ou certificação pela AT.',money(v));
}
export function evaluateAcquisition(row:Acquisition,currency:string,taxpayerRegistered:Choice='',draft?:Record<string,unknown>):AcquisitionResult {
const result=evaluateAcquisitionBase(row,currency,taxpayerRegistered);
if(row.d)return evaluateAcquisitionAllocation(row,currency,taxpayerRegistered,draft,result);
if(row.bc)return evaluateAcquisitionBC(row,currency,taxpayerRegistered,draft,result);
if(!row.deductionLink)return result;
const right=draft?linkedOperationRight(draft,row.deductionLink):{status:'indeterminate' as const,reason:'Contexto da operação em falta.',source:acquisitionRightSource};
const finish=(status:AcquisitionEligibility['status'],reason:string,deductible:string|null=null):AcquisitionResult=>({...result,deductible,reason,eligibility:{...right,status,reason,source:right.source+'; '+acquisitionBasis}});
if(currency!=='MZN'||row.sourceCurrency!==currency||!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||acquisitionTreatmentIssue(row.acquisitionTreatment)||result.net===null||result.vat===null||result.gross===null||(amount(result.net)! + amount(result.vat)!)!==amount(result.gross))return finish('indeterminate',result.reason);
if(row.deductionLink.scopeConfirmed!=='yes'||!row.deductionLink.allocationRef.trim())return finish('indeterminate','Confirme a afectação exclusiva à operação ligada e indique o motivo/referência; não inferida da oportunidade.');
if(row.domestic!=='yes'||row.allocation==='mixed'||row.exclusion==='special')return finish('indeterminate','Importação, afectação parcial ou despesa especial: enquadramento específico B/C/D ainda necessário; sem dedução integral presumida.');
if(right.status==='indeterminate')return finish('indeterminate',right.reason);
if(right.status==='no_right')return finish('no_right',right.reason,'0.00');
if(row.allocation==='no_right'||row.exclusion==='excluded'||row.supplierRegistered==='no'||row.legalDocument==='no'||row.integrity==='no')return finish('no_right',result.reason,'0.00');
if(row.deductionLink.noExcludedPayments==='no')return finish('no_right','Afectação a pagamentos do artigo15(6)(c): exclusão19(2).','0.00');
if(row.deductionLink.noExcludedPayments!=='yes')return finish('indeterminate','Indique se a aquisição está fora dos pagamentos excluídos15(6)(c)/19(2).');
if(result.deductible===null)return finish('indeterminate',result.reason);
return finish('eligible',right.reason+' '+result.reason,result.deductible);
}
function sourceKey(draft:Record<string,unknown>,book:AcquisitionBook):string {
const raw=JSON.stringify([acquisitionScope(draft),draft.currency??'',draft.province_id??'',draft.district_id??'',draft.business_plan_snapshot,draft.monthly_iva_settings,draft.monthly_iva_snapshot,book.currency,book.taxpayerRegistered,book.rows,book.periods]);
// 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)];
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;
return ['province_id','district_id'].filter(key=>draft[key]).map(key=>String(draft[`${key}_label`]??labels?.[key]??draft[key])).join(' / ');
}
export function acquisitionCurrent(draft:Record<string,unknown>,book:AcquisitionBook):boolean {return !!book.result && book.result.version===acquisitionVersion && book.result.opportunity===acquisitionScope(draft) && book.result.sourceKey===sourceKey(draft,book);}
export function calculateAcquisitions(draft:Record<string,unknown>,book:AcquisitionBook,now=new Date().toISOString()):AcquisitionCalculation {
const scope=acquisitionScope(draft),dates=book.periods.map(p=>p.period);
if(book.currency!=='MZN' || draft.currency!==book.currency) throw new Error('Resolva a moeda de origem das compras; valores preservados sem conversão.');
if(!dates.length||dates.some(period=>!/^2026-(0[1-9]|1[0-2])$/.test(period))||new Set(dates).size!==dates.length) throw new Error('Indique os meses aplicáveis às aquisições em2026,sem períodos duplicados; não inferidos do orçamento ou das vendas.');
if(new Set(book.rows.map(r=>r.id)).size!==book.rows.length) throw new Error('Existem compras com identidade repetida.');
const documents=book.rows.filter(r=>r.documentRef.trim() && r.supplier.trim()).map(r=>JSON.stringify([r.origin,r.supplier.trim().toLowerCase(),r.documentRef.trim().toLowerCase(),r.documentDate,r.documentLine?.trim()??'']));
if(new Set(documents).size!==documents.length) throw new Error('Documento/linha repetido: discrimine linhas distintas ou remova a duplicação antes de deduzir.');
if(book.rows.some(r=>!['08','09','10','11'].includes(r.field) || r.field==='11'&&!r.bc || !dates.includes(r.period))) throw new Error('Classifique cada aquisição num campo08–10 ou importaçãoB no campo11 e num mês incluído na cobertura declarada.');
const references=acquisitionPlanReferences(draft);
for(const row of book.rows.filter(r=>r.sourceMonth!==null)) {
const current=references.find(p=>p.month===row.sourceMonth && p.kind===(row.sourceField??'inventory'));
if(!current || current.amount!==row.sourceAmount || (current.kind!=='asset' && row.sourcePeriod && current.period!==row.sourcePeriod)) throw new Error('As compras ou orçamentos do plano mudaram. Resolva a divergência de origem antes de calcular; histórico preservado.');
}
if(book.rightVersion||book.rows.some(r=>r.deductionLink||r.bc)){
const identities=book.rows.filter(r=>r.documentRef.trim()&&(r.supplier.trim()||r.field==='11')).map(r=>JSON.stringify([r.field==='11'?'customs':r.supplier.trim().toLowerCase(),r.documentRef.trim().toLowerCase(),r.documentDate,r.documentLine.trim()]));
if(new Set(identities).size!==identities.length)throw new Error('Documento/linha repetido entre projecção e efectivo; sem dupla dedução.');
}
const rows=book.rows.map(row=>{
const result=evaluateAcquisition(row,book.currency,book.taxpayerRegistered,draft);
if(result.deductible!==null&&(result.deductibleExact?BigInt(result.deductibleExact.numerator)>0n:Number(result.deductible)>0)&&beverageParcelReserved(draft,row))return {...result,deductible:null,deductibleExact:undefined,nonDeductibleExact:undefined,reason:'Parcela ligada a pedido/decisão/recebimento de restituição13(2);sem a voltar a deduzir. Reconciliar o procedimento conservando o histórico.',eligibility:{status:'indeterminate' as const,reason:'Parcela reservada para restituição13(2).',source:acquisitionBCSource}};
if(!row.deductionLink&&!row.d&&(book.rightVersion||book.rows.some(r=>r.deductionLink)))return {...result,deductible:null,reason:'Aquisição sem vínculo à operação de destino; direito indeterminado.',eligibility:{status:'indeterminate' as const,reason:'Aquisição sem vínculo à operação de destino; direito indeterminado.',source:acquisitionRightSource}};
return result;
});
const record=readMonthlyIvaRecord(String(draft.monthly_iva_snapshot ?? ''));
let salesCurrent=false;
try {salesCurrent=!!record && record.execution.status==='completed' && monthlyIvaKey(record.input)===monthlyIvaKey(monthlyIvaInput(draft,readMonthlyIvaSettings(String(draft.monthly_iva_settings ?? ''))));} catch { /* Preserve history, never fabricate 01/02. */ }
const projection=record?.execution.result_snapshot?.monthly_projection as {rows?:Array<{date:string;net_sales:string|null;vat:string|null}>}|undefined;
const calculated=dates.map(period=>{
const input=book.periods.find(p=>p.period===period), reasons:string[]=[], fields:Record<string,string|null>={};
const declaredAmount=(key:string)=>{const value=amount(String(draft[key]??''));return value!==null && value>0n;};
if(input?.absent.includes('11') && (declaredAmount('imports') || book.rows.some(r=>r.period===period && r.domestic==='no'))) throw new Error('Existem importações declaradas. Não confirme ausência no campo11; enquadramento fora deste lote.');
if(input?.absent.includes('07') && declaredAmount('sales_exempt')) throw new Error('Existem vendas isentas declaradas. Resolva o período e a classificação antes de confirmar ausência no campo07.');
if(input?.absent.includes('05') && (declaredAmount('exports')||declaredAmount('sales_zero_rate'))) throw new Error('Existem exportações ou vendas de outro enquadramento. Não confirme ausência no campo05 sem resolver a classificação.');
const sales=salesCurrent?projection?.rows?.find(r=>r.date.slice(0,7)===period):null;
fields['01']=sales?.net_sales??null;fields['02']=sales?.vat??null;
if((!sales || sales.net_sales===null || sales.vat===null)&&!(book.rows.some(r=>r.deductionLink||r.d)&&salesOperationsCurrent(draft,salesBook(draft))&&salesBook(draft).result?.periods.some(p=>p.period===period))) reasons.push('01/02: vendas ou IVA mensal em falta, execução incompleta ou desactualizada.');
for(const field of excluded) fields[field]=input?.absent.includes(field)?'0.00':null;
const operations=salesBook(draft);
if(operations.rows.length || operations.result) {
const classified=salesOperationsCurrent(draft,operations)?operations.result?.periods.find(p=>p.period===period):null;
for(const field of ['01','02','03','04','05','06','07'])fields[field]=classified?.fields[field]??null;
if(!classified)reasons.push('Operações L1 alteradas ou sem resultado correspondente: recalcule a classificação; não usar01/02 antigos nem ausência presumida.');
else reasons.push(...classified.reasons);
}
for(const field of ['08','09','10']) {
const matching=book.rows.filter(r=>r.period===period && r.field===field);
fields[field]=input?.complete ? sum(matching.map(r=>rows.find(x=>x.id===r.id)!.deductible)) : null;
if((operations.rows.length || operations.result) && operations.rows.some(r=>r.period===period && !['general','export_goods'].includes(r.treatment)) && matching.some(r=>!r.deductionLink&&!r.d&&rows.find(x=>x.id===r.id)!.deductible!=='0.00')) {
fields[field]=null;
reasons.push(`Campo${field}: operações reduzidas/isentas/outras exigem afectar cada aquisição; não reutilizar dedução exclusiva geral como se fosse universal (L2).`);
}
}
if(book.rows.some(r=>r.bc)||input?.importsComplete!==undefined){
const imported=book.rows.filter(r=>r.period===period&&r.field==='11');
if(imported.length||input?.importsComplete)fields['11']=input?.importsComplete?sum(imported.map(r=>rows.find(x=>x.id===r.id)!.deductible)):null;
if(imported.length&&!input?.importsComplete)reasons.push('Campo11:confirme a cobertura de todas as importações do período,distinta das compras08–10.');
}
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}`);}
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]));
const state=amount(fields['16']),taxpayer=amount(fields['15']);
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)||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)||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.');
}
for(const f of Object.keys(exactFields))fields[f]=exactFields[f]?fractionPresentation(exactFields[f]!).decimal:null;
reasons.push('Totais derivados das fracções exactas, sem somar aproximações das linhas; decimais a6casas são apresentação técnica, não arredondamento declarativo.');
return {period,fields,exactFields,reasons};
}
return {period,fields,reasons};
});
return {version:acquisitionVersion,revision:(book.result?.revision??0)+1,calculatedAt:now,opportunity:scope,location:location(draft),currency:book.currency,sourceKey:sourceKey(draft,book),basis:book.rows.some(r=>r.d)?acquisitionAllocationSource:book.rows.some(r=>r.bc)?acquisitionBCSource:acquisitionBasis,sources:acquisitionSources+(book.rows.some(r=>r.acquisitionTreatment==='former_exploration_exemption'||r.acquisitionTreatmentOrigin)?`; ${formerExplorationSource}`:''),declarations:{taxpayerRegistered:book.taxpayerRegistered??'',periods:structuredClone(book.periods)},rows,inputs:structuredClone(book.rows),periods:calculated};
}
export function recordAcquisitions(draft:Record<string,unknown>,book:AcquisitionBook,now=new Date().toISOString()):AcquisitionBook {
const result=calculateAcquisitions(draft,book,now);
return {...book,...(book.result?{history:[...(book.history??[]),structuredClone(book.result)]}:{}),result};
}
export function acquisitionReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]> {
if(!draft.modelo_a_snapshot) return [];
try {
const book=acquisitionBook(draft),result=book.result;
if(!result) return [['IVA mensal','Compras — Modelo A','Sem cálculo guardado para a oportunidade escolhida','Sem dedução presumida']];
const context=`${result.currency}; oportunidade ${result.opportunity}; localização ${result.location || 'não indicada'}; ${result.version}; revisão ${result.revision}; ${result.calculatedAt}`;
const out:Array<[string,string,string,string]>=[['IVA mensal','Apuramento parcial Modelo A',acquisitionCurrent(draft,book)?'Versão correspondente às entradas':'Histórico desactualizado; não aplicar à projecção actual',context],['IVA mensal','Fundamento das aquisições',result.basis,result.sources]];
for(const row of result.inputs) {
const r=result.rows.find(x=>x.id===row.id)!;
if(row.d)out.push(['IVA mensal',`AfectaçãoD — ${row.id}`,`${{actual:'Afectação real22(2)',pro_rata:'Pro rata provisório22',reduced:'Proporção específica18(6)','':'Método por identificar'}[row.d.method]};âmbito${row.d.scopeRef};quociente${r.allocationCalculation?fractionLabel(r.allocationCalculation.rawRatio):'Indeterminado'};proporção aplicada${r.allocationCalculation?fractionLabel(r.allocationCalculation.ratio):'Indeterminada'};IVA elegível antesD${r.allocationCalculation?fractionLabel(r.allocationCalculation.before):'Indeterminado'};dedutível${r.deductibleExact?fractionLabel(r.deductibleExact):'Indeterminado'};não dedutível${r.nonDeductibleExact?fractionLabel(r.nonDeductibleExact):'Indeterminado'}`,`${row.d.source};${row.d.method==='reduced'?'origem '+row.d.reducedId:'bases '+row.d.numerator+'/'+row.d.denominator+' '+(row.d.method==='actual'?row.d.unit:'MZN')+';ano '+(row.d.method==='pro_rata'?row.d.referenceYear:row.period.slice(0,4))+';comunicação '+row.d.communicationRef+';declaração '+row.d.declarationRef};${r.allocationCalculation?.source??r.eligibility?.source??''}`]);
if(row.bc)out.push(['IVA mensal',`CondiçõesB/C — ${row.id}`,`${row.field==='11'?'Bilhete de despacho de importação;importador '+row.bc.importer+';bens '+row.bc.goodsRef+';IVA '+({due:'devido identificado',exempt:'isento',zero:'zero expresso',unknown:'desconhecido','':'por indicar'}[row.bc.vatBasis])+';fonte '+row.bc.vatRef:'Despesa '+(expenseOptions.find(([id])=>id===row.bc!.expense)?.[1]??'por identificar')+';IVA suportado17-A:'+({yes:'Sim',no:'Não','':'Por indicar'}[row.bc.reducedSupply])};dedutível exacto:${r.deductibleExact?fractionLabel(r.deductibleExact):'Indeterminado'};não dedutível:${r.nonDeductibleExact?fractionLabel(r.nonDeductibleExact):'Indeterminado'}`,`${row.bc.evidence};${acquisitionBCDetails(row.bc)};origem${row.bc.source?'registo de importaçãoL1 '+row.bc.source.id:'introdução directa'};${acquisitionBCSource}`]);
if(r.eligibility)out.push(['IVA mensal',`Direito da aquisição ${row.id}`,`${{eligible:'Elegível',no_right:'Sem direito',indeterminate:'Indeterminado'}[r.eligibility.status]}: ${r.eligibility.reason}`,`${r.eligibility.source}; ${row.d?'âmbitoD '+row.d.scopeRef:'operação '+(r.eligibility.operationId??'por identificar')+'; '+(r.eligibility.operationPeriod??'')+'; '+(r.eligibility.operationArticle??'')+'; afectação '+(row.deductionLink?.allocationRef??'')}`]);
const source=row.sourceMonth===null?'Introduzido pelo utilizador':`Plano (${row.sourceField==='asset'?'orçamento de activos':row.sourceField==='operating'?'orçamento operacional':'compras/encomendas'}), mês ${row.sourceMonth}, ${row.sourcePeriod??'período de origem não indicado'}, ${row.sourceAmount??'valor em falta'} ${row.sourceCurrency}; ${row.sourceBasis==='net'?'sem IVA':row.sourceBasis==='gross'?'com IVA':'base por classificar'}`;
const allocation={taxable_only:row.deductionLink?'exclusiva à operação ligada':'exclusiva a operações tributadas',mixed:'mista',no_right:'sem direito à dedução','':'por indicar'}[row.allocation];
out.push(['IVA mensal',`Aquisição ${row.id} — campo${row.field} — ${row.period}`,`${row.description}; líquido ${r.net??'Indeterminado'}; IVA ${r.vat??'Indeterminado'}; bruto ${r.gross??'Indeterminado'}; dedutível ${r.deductible??'Indeterminado'}`,`${context}; ${row.origin==='projected'?'Projecção':'Dados efectivos declarados'}; ${source}; ${row.documentType==='invoice'?'Factura':row.documentType==='equivalent'?'Documento equivalente':row.documentType==='customs'?'Bilhete de despacho de importação':'Documento por indicar'} ${row.documentRef}, ${row.documentDate}, linha ${row.documentLine||'única'}; fornecedor ${row.supplier}; afectação ${allocation}; ${r.reason}`]);
if(row.acquisitionTreatment==='former_exploration_exemption'||row.acquisitionTreatmentOrigin)out.push(['IVA mensal',`Continuidade14(2)(c) — ${row.id}`,row.acquisitionTreatment==='former_exploration_exemption'?'Antiga isenção eliminada; dedução indeterminada por esta referência':'Continuidade normal expressamente escolhida; montantes e documento conservados; condições de dedução da aquisição, sem aplicar antiga isenção',`${context}; ${formerExplorationSource}; origem conservada ${row.acquisitionTreatmentOrigin?.id??'former_exploration_exemption'}`]);
}
for(const period of result.periods) {
const entries=Object.entries(period.fields).sort(([a],[b])=>Number(a)-Number(b));
const declaration=result.declarations?.periods.find(p=>p.period===period.period);
const declarationOrigin=declaration?`Aquisições08–10 ${declaration.complete?'declaradas completas':'por completar'};${declaration.importsComplete!==undefined?`importações11 ${declaration.importsComplete?'declaradas completas':'por completar'};`:''} ausência de operações expressamente declarada nos campos ${declaration.absent.join(', ')||'nenhum'}.`:'Declarações detalhadas não recuperáveis nesta versão histórica.';
out.push(['IVA mensal',`Modelo A — ${period.period} — parcelas01–13`,entries.filter(([field])=>Number(field)<=13).map(([field,value])=>`${field}: ${value??'Indeterminado'}`).join('; '),`${context}; ${declarationOrigin}`]);
out.push(['IVA mensal',`Modelo A — ${period.period} — totais14–18`,entries.filter(([field])=>Number(field)>=14).map(([field,value])=>`${field}: ${value??'Indeterminado'}`).join('; '),context]);
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,...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']];}
}
+57
View File
@@ -0,0 +1,57 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const actSaleBaseVersion='act-goods-base/1';
export const actSaleBaseSource='CIVA republicado Lei13/2016,15(2)(h),PDF13/p1426(271): nas transmissões de bens resultantes de actos de arrematação ou venda judicial ou administrativa,de conciliação ou contratos de transacção,a base é o valor por que as arrematações ou vendas foram efectuadas ou,se for caso,o valor normal dos bens. Art15(4)/(5)/(6),PDF14/p1426(272),valor normal,composição e exclusões,sem próprioIVA. Lei22/2022PDF3mantém15(2)(h)/(4–6)por remissão;Lei10/2025não altera15. Recorte2026/MZN;determinação da base,sem inferir incidência,taxa,IVA,dedução/campo11 ou totaisModeloA;sem substituir regime especial15(2)(g)de leilão em comissão.';
export const actSaleKinds=[{id:'auction',label:'Arrematação'},{id:'judicial_sale',label:'Venda judicial'},{id:'administrative_sale',label:'Venda administrativa'},{id:'conciliation',label:'Conciliação'},{id:'settlement',label:'Contrato de transacção'}] as const;
export const actSaleTreatments=[{id:'act_sale_amount',label:'Valor da arrematação ou venda efectuada'},{id:'act_normal_value',label:'Valor normal dos bens,quando aplicável'}] as const;
export const actSaleConditions=[
['taxableDomesticGoods','Está identificada uma transmissão de bens sujeita a IVA no território nacional; não é qualquer pagamento,indemnização ou prestação de serviços'],
['goodsByAct','Estes bens são transmitidos em resultado do acto de arrematação,venda judicial/administrativa,conciliação ou contrato de transacção identificado'],
['valuationApplies','O valor escolhido corresponde ao fundamento aplicável nesta transmissão:valor por que a arrematação/venda foi efectuada ou,se for caso,valor normal; não é uma opção automática pelo menor valor'],
['netComposition','O montante indicado exclui o próprio IVA e reflecte a composição aplicável do artigo15(5)/(6),identificada no fundamento,sem omissões ou duplicações'],
['notAuctionCommissionRegime','Esta transmissão corresponde ao artigo15(2)(h),não a uma venda abrangida pela regra especial do organizador de leilão em comissão do artigo15(2)(g)'],
] as const;
type Choice=''|'yes'|'no';type Condition=typeof actSaleConditions[number][0];
export type ActSaleRow={id:string;treatment:string;actKind:string;description:string;period:string;origin:'projected'|'effective';currency:string;actRef:string;documentRef:string;documentDate:string;actValue:string;normalValue:string;valuationRef:string;valuationScope:string;compositionRef:string;evidence:string;conditions:Partial<Record<Condition,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type ActSaleCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:ActSaleRow[];rows:LineResult[]};
export type ActSaleBook={rows:ActSaleRow[];result?:ActSaleCalculation;history?:ActSaleCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{actSaleBases?:Record<string,ActSaleBook>};
export function newActSaleBase(id:string,currency:string):ActSaleRow{return{id,treatment:'',actKind:'',description:'',period:'',origin:'projected',currency,actRef:'',documentRef:'',documentDate:'',actValue:'',normalValue:'',valuationRef:'',valuationScope:'',compositionRef:'',evidence:'',conditions:{}};}
export function switchActValuation(row:ActSaleRow,treatment:string):ActSaleRow{return{...row,treatment,conditions:{...row.conditions,valuationApplies:''}};}
export function switchActKind(row:ActSaleRow,actKind:string):ActSaleRow{return{...row,actKind,conditions:{...row.conditions,goodsByAct:'',valuationApplies:''}};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.actSaleBases!==undefined&&(!store.actSaleBases||typeof store.actSaleBases!=='object'||Array.isArray(store.actSaleBases)))throw new Error('Bases de transmissão por acto não recuperáveis;originais preservados.');
const fields=Object.keys(newActSaleBase('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.actSaleBases??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof ActSaleRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de transmissão por acto não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function actSaleBook(draft:Record<string,unknown>):ActSaleBook{return readStore(draft).actSaleBases?.[acquisitionScope(draft)]??{rows:[]};}
export function saveActSaleBook(draft:Record<string,unknown>,book:ActSaleBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,actSaleBases:{...current.actSaleBases,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateActSale(row:ActSaleRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
const rule=actSaleTreatments.find(item=>item.id===row.treatment),kind=actSaleKinds.find(item=>item.id===row.actKind);
if(!rule||!kind)return stop('Identifique o acto e o fundamento do valor aplicável; acto ou valorização desconhecidos não determinam base.');
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto;sem conversão silenciosa.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique o período em2026 e dados efectivos declarados ou pressupostos de projecção; não se infere o período do orçamento.');
const failed=actSaleConditions.filter(([key])=>row.conditions[key]==='no');if(failed.length)return stop('Não se aplica esta base de transmissão por acto: '+failed.map(([,label])=>label).join('; ')+'. Não é isenção nem IVA zero.','not_applicable');
const missing=actSaleConditions.filter(([key])=>row.conditions[key]!=='yes');if(missing.length)return stop('Condições por indicar: '+missing.map(([,label])=>label).join('; ')+'. Desconhecido não significa não aplicável ou zero.');
if(!row.description.trim()||!row.actRef.trim()||!row.documentRef.trim()||!row.valuationRef.trim()||!row.valuationScope.trim()||!row.compositionRef.trim()||!row.evidence.trim()||!validDate(row.documentDate))return stop('Identifique bens,acto,documento/data,fundamento e âmbito do valor escolhido e composição,ou pressupostos expressos;reutilize referências existentes,sem novo certificado ou avaliador imposto pelo portal.');
const value=decimal(row.treatment==='act_sale_amount'?row.actValue:row.normalValue);if(value===null)return stop('Indique o montante sem IVA correspondente ao fundamento escolhido; valor desconhecido ou inválido não é zero. Não se escolhe automaticamente o menor valor.');
const base=money(value);return{...result,status:'determined',baseAmount:base,reason:`Base15(2)(h),${kind.label}: ${rule.label} = ${base}MZN,${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. Valor sem IVA,com fundamento e âmbito identificados;valor normal não é avaliado automaticamente pelo portal. Base não é imposto;IVA/taxa,dedução/campo11 e totaisModeloA não são determinados por este cálculo.`};
}
function key(draft:Record<string,unknown>,book:ActSaleBook):string{return JSON.stringify({version:actSaleBaseVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function actSaleCurrent(draft:Record<string,unknown>,book:ActSaleBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordActSaleBases(draft:Record<string,unknown>,book:ActSaleBook):ActSaleBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:ActSaleCalculation={version:actSaleBaseVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:actSaleBaseSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateActSale(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveActSaleBook(draft,next);return next;
}
export function actSaleReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=actSaleBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base P094 — ${row.period} — ${row.id}`,`${row.description};base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${actSaleCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${actSaleKinds.find(item=>item.id===row.actKind)?.label??'Acto por indicar'};acto ${row.actRef};${actSaleTreatments.find(item=>item.id===row.treatment)?.label??'Valorização por indicar'};montante ${row.treatment==='act_sale_amount'?row.actValue:row.normalValue} ${row.currency};fundamento da valorização ${row.valuationRef};âmbito ${row.valuationScope};composição ${row.compositionRef};documento ${row.documentRef},${row.documentDate};condições ${actSaleConditions.map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento factual ${row.evidence};não preenche totaisModeloA ou campo11.`]);}
catch{return[['IVA mensal','Base de transmissão por acto','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
+181
View File
@@ -0,0 +1,181 @@
// Accepted official exemplar: preserve qualifiers and uncoded group headings, not tariff inference.
export const annexIVersion='annexI-lei22-2022/1';
export const annexISource='Lei22/2022, art.3(1), AnexoI, PDF5–11, p.2252(29)–(35); efeitos01/01/2023';
export const annexIPdfSha256='ea1b0dc6f5cf6e595f6d9a19e7042f398999e0087caef1785f6e8fac571b5f53';
export type AnnexIEntry={id:string;code:string;label:string;pdfPage:number;lastPdfPage:number;context?:string;relatedTreatments?:string[];relatedRequired?:boolean};
export const annexIEntries:AnnexIEntry[]=[
{"id":"annexI-2022-001","code":"0102.21.00","label":"-Bovinos domésticos - Reprodutores de raça pura","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-002","code":"0102.31.00","label":"-Búfalos - Reprodutores de raça pura","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-003","code":"0103.10.00","label":"Animais vivos da espécie suína - Reprodutores de raça pura","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-004","code":"0104.10.10","label":"- Ovinos - Reprodutores de raça pura","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-005","code":"0104.20.10","label":"- Caprinos - Reprodutores de raça pura","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-006","code":"0105.11.10","label":"- Galos e galinhas (De peso não superior a 185g) - Reprodutores certificados","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-007","code":"0105.12.10","label":"- Peruas e perus (De peso não superior a 185g) -Reprodutores certificados","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-008","code":"0105.13.10","label":"- Patos - Reprodutores certificados","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-009","code":"0105.14.10","label":"-Gansos - Reprodutores certificados","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-010","code":"0105.94.10","label":"-Galos e galinhas - Reprodutores certificados e poedeiras","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-011","code":"0301.99.10","label":"- Peixes reprodutores","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-012","code":"0306.36.10","label":"- Camarões - Larvas de camarão com comprimento não superior a 1 mm","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-013","code":"0402.21.10","label":"- Leite em pó, grânulos ou outras formas sólidas, concentrados sem adição de açúcar ou de outros edulcorantes, com um teor, em peso, de matérias gordas, superior a 1,5%, para uso na indústria acondicionado em embalagens de capacidade igual ou superior a 25Kg","pdfPage":5,"lastPdfPage":5,"relatedTreatments":["listed_infant_powdered_milk"],"relatedRequired":false},
{"id":"annexI-2022-014","code":"0404.90.10","label":"-Soro de leite para aleitamento de crias de animais","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-015","code":"0407.11.00","label":"Ovos de aves, com casca, frescos, conservados ou cozidos. - Ovos para incubação certificados","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-016","code":"0511.10.00","label":"- Sémen de bovino","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-017","code":"0511.10.10","label":"- Sémen de outras espécies","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-018","code":"0511.99.10","label":"- Embriões de bovino","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-019","code":"0511.99.20","label":"- Embriões de outras espécies","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-020","code":"0602.90.20","label":"-Mudas de plantas florestais e de fruteiras","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-021","code":"0701.10.00","label":"- Batata-semente","pdfPage":5,"lastPdfPage":5,"relatedTreatments":["listed_potato"],"relatedRequired":false},
{"id":"annexI-2022-022","code":"0701.90.00","label":"-Outras","pdfPage":5,"lastPdfPage":5,"relatedTreatments":["listed_potato"],"relatedRequired":false},
{"id":"annexI-2022-023","code":"0702.00.00","label":"Tomate, frescos ou refrigerados","pdfPage":5,"lastPdfPage":5,"relatedTreatments":["listed_fresh_chilled_tomato"],"relatedRequired":true},
{"id":"annexI-2022-024","code":"0703.10.11","label":"- Cebolas -De semente","pdfPage":5,"lastPdfPage":5,"relatedTreatments":["listed_onion"],"relatedRequired":false},
{"id":"annexI-2022-025","code":"0703.10.19","label":"-Outras","pdfPage":5,"lastPdfPage":5,"relatedTreatments":["listed_onion"],"relatedRequired":false},
{"id":"annexI-2022-026","code":"0713.32.10","label":"- Feijão Adzuki destinado à sementeira","pdfPage":5,"lastPdfPage":5},
{"id":"annexI-2022-027","code":"0713.33.10","label":"- Feijão comum -destinado à sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-028","code":"0713.39.10","label":"- Outros feijões -destinados à sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-029","code":"0801.19.10","label":"- Semente de coco híbrido","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-030","code":"0801.19.20","label":"- Semente de coco não híbrido","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-031","code":"1001.11.00","label":"-Trigo duro - para sementeira","pdfPage":6,"lastPdfPage":6,"relatedTreatments":["listed_wheat"],"relatedRequired":false},
{"id":"annexI-2022-032","code":"1001.91.00","label":"-Outros -Para sementeira","pdfPage":6,"lastPdfPage":6,"relatedTreatments":["listed_wheat"],"relatedRequired":false},
{"id":"annexI-2022-033","code":"1002.10.00","label":"-Centeio -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-034","code":"1003.10.00","label":"-Cevada -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-035","code":"1004.10.00","label":"-Aveia -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-036","code":"1005.10.00","label":"- Milho - Para sementeira","pdfPage":6,"lastPdfPage":6,"relatedTreatments":["listed_maize"],"relatedRequired":false},
{"id":"annexI-2022-037","code":"1006.10.10","label":"- Arroz com casca -Destinado à sementeira","pdfPage":6,"lastPdfPage":6,"relatedTreatments":["listed_rice"],"relatedRequired":false},
{"id":"annexI-2022-038","code":"1007.10.00","label":"- Sorgo de grão -para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-039","code":"1008.21.00","label":"-Painço -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-040","code":"1008.90.21","label":"- Mexoeira -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-041","code":"1008.90.91","label":"-Outros cereais -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-042","code":"1101.00.00","label":"Farinhas de trigo ou mistura de trigo com centeio","pdfPage":6,"lastPdfPage":6,"relatedTreatments":["listed_wheat_flour"],"relatedRequired":false},
{"id":"annexI-2022-043","code":"1102.20.00","label":"- Farinha de milho","pdfPage":6,"lastPdfPage":6,"relatedTreatments":["listed_maize_flour"],"relatedRequired":true},
{"id":"annexI-2022-044","code":"1201.10.00","label":"Soja, mesmo triturada -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-045","code":"1202.30.00","label":"Amendoins. -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-046","code":"1204.00.10","label":"-Sementes de linho -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-047","code":"1206.00.10","label":"Sementes de girassol -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-048","code":"1207.21.00","label":"- Sementes de algodão -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-049","code":"1207.30.00","label":"- Sementes de rícino","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-050","code":"1207.40.10","label":"- Sementes de gergelim -Para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-051","code":"1207.50.00","label":"-Sementes de mostarda","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-052","code":"1207.60.00","label":"-Sementes de cártamo","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-053","code":"1207.70.00","label":"-Sementes de Melão","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-054","code":"1207.91.00","label":"-Sementes de dormideira ou papoula","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-055","code":"1207.99.10","label":"-Outras sementes para sementeira","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-056","code":"1209.10.00","label":"-Sementes de beterraba sacarina","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-057","code":"1209.21.00","label":"- Semente de alfafa (Luzerna)","pdfPage":6,"lastPdfPage":6},
{"id":"annexI-2022-058","code":"1209.22.00","label":"-Sementes de trevo (Tlurifolium spp)","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-059","code":"1209.23.00","label":"- Sementes de festuca","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-060","code":"1209.24.00","label":"- Sementes de pasto dos prados de Kentucky (Poa pratensis L.)","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-061","code":"1209.25.00","label":"-Sementes de azevém (Lolium multiflorum Lam, Lolium perente L.)","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-062","code":"1209.29.00","label":"-Outras (sementes)","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-063","code":"1209.30.00","label":"-Sementes de plantas herbáceas cultivadas especialmente pelas suas flores","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-064","code":"1209.91.00","label":"- Outras -Sementes de produtos hortícolas","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-065","code":"1209.99.00","label":"- Outras sementes","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-066","code":"1901.10.10","label":"- Preparações alimentícias à base de lacticínios, para lactentes e crianças de tenra idade, acondicionadas para venda à retalho","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-067","code":"1901.10.30","label":"- Preparações alimentares, terapêuticas à base de lacticínios ou de cereais","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-068","code":"2106.90.20","label":"- Produto composto para fortificação de alimentos destinados ao consumo humano, contendo alguns dos seguintes micronutrientes, vitaminas, iodo, zinco, ácido fólico e ferro (por exemplo, produtos denominados PREMIX)","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-069","code":"2309.90.10","label":"- Preparações, aditivos do tipo utilizado na aquacultura do camarão, na avicultura, na pecuária e pré-mistura de alta concentração.","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-070","code":"3101.00.00","label":"Adubos (fertilizantes) de origem animal ou vegetal, mesmo misturados entre si ou tratados quimicamente; adubos (fertilizantes) resultantes da mistura ou do tratamento químico de produtos de origem animal ou vegetal","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-071","code":"3102.10.00","label":"Adubos (fertilizantes) minerais ou químicos, azotados (nitrogenados): - Ureia, mesmo em solução aquosa","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-072","code":"3102.21.00","label":"Adubos (fertilizantes) minerais ou químicos, azotados (nitrogenados): - Sulfato de amónio","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-073","code":"3102.29.00","label":"-Outros adubos (fertilizantes) minerais ou químicos, azotados (nitrogenados)","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-074","code":"3102.30.00","label":"Adubos (fertilizantes) minerais ou químicos, azotados (nitrogenados): -Nitrato de amónio, mesmo em solução aquosa","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-075","code":"3102.40.00","label":"Adubos (fertilizantes) minerais ou químicos, azotados (nitrogenados): - Misturas de nitrato de amónio com carbonato de cálcio ou com outras matérias inorgânicas desprovidas de poder fertilizante","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-076","code":"3102.50.00","label":"Adubos (fertilizantes) minerais ou químicos, azotados (nitrogenados): - Nitrato de sódio","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-077","code":"3102.60.00","label":"Adubos (fertilizantes) minerais ou químicos, azotados (nitrogenados): - Sais duplos e misturas de nitrato de cálcio e nitrato de amónio","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-078","code":"3102.80.00","label":"Adubos (fertilizantes) minerais ou químicos, azotados (nitrogenados): - Misturas de ureia com nitrato de amónio em soluções aquosas ou amoniacais","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-079","code":"3102.90.00","label":"Adubos (fertilizantes) minerais ou químicos, azotados (nitrogenados): - Outros incluídas as misturas não mencionadas nas sub posições precedentes","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-080","code":"3103.11.00","label":"Adubos (fertilizantes) minerais ou químicos, fosfatados: - Superfosfatos Que contenham, em peso, 35% ou mais de pentóxido de difósforo","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-081","code":"3103.19.00","label":"Outros superfosfatos","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-082","code":"3103.90.00","label":"- Outros adubos (fertilizantes) minerais ou químicos, fosfatados","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-083","code":"3104.20.00","label":"Adubos (fertilizantes) minerais ou químicos, potássicos: - Cloreto de potássio","pdfPage":7,"lastPdfPage":7},
{"id":"annexI-2022-084","code":"3104.30.00","label":"Adubos (fertilizantes) minerais ou químicos, potássicos: - Sulfato de potássio","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-085","code":"3104.90.00","label":"- Outros adubos (fertilizantes) minerais ou químicos, potássicos","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-086","code":"3105.10.00","label":"Adubos (fertilizantes) minerais ou químicos, contendo dois ou três dos seguintes elementos fertilizantes: azoto (nitrogénio), fósforo e potássio; outros adubos (fertilizantes). -Produtos do presente capítulo apresentados em tabletes ou forma semelhantes, ou ainda em embalagens com peso bruto não superior a 10 kg","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-087","code":"3105.20.00","label":"- Adubos (fertilizantes) minerais ou químicos, contendo os três elementos fertilizantes: azoto (nitrogénio), fósforo e potássio","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-088","code":"3105.30.00","label":"- Adubos (fertilizantes) minerais ou químicos, Hidrogéno-ortofosfato de diamónio (fosfato diamónico ou dimoniacal)","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-089","code":"3105.40.00","label":"-Diidrogeno-ortofosfato de amónio (fosfato monoamónico ou monoamonical), mesmo misturado com hidrogeno-ortofosfato de diamónio (fosfato diamónico ou diamonical)","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-090","code":"3105.51.00","label":"- Outros adubos (fertilizantes) minerais ou químicos, contendo os dois elementos fertilizantes, azoto (nitrogénio) e fósforo: -que contenham nitratos e fosfatos","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-091","code":"3105.59.00","label":"- Outros adubos (fertilizantes) minerais ou químicos, contendo os dois elementos fertilizantes: azoto (nitrogénio) e fósforo","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-092","code":"3105.60.00","label":"- Adubos (fertilizantes) minerais ou químicos, contendo os dois elementos fertilizantes: fósforos e potássio","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-093","code":"3105.90.00","label":"- Outros adubos (fertilizantes) minerais ou químicos, contendo dois ou três dos seguintes elementos fertilizantes: azoto (nitrogénio), fósforo e potássio; outros adubos (fertilizantes), produtos do presente capítulo apresentados em tabletes ou forma semelhantes, ou ainda em embalagens com peso bruto não superior a 10 kg","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-094","code":"3808.91.00","label":"- Insecticidas","pdfPage":8,"lastPdfPage":8,"relatedTreatments":["listed_insecticides"],"relatedRequired":true},
{"id":"annexI-2022-095","code":"3808.92.00","label":"- Fungicidas","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-096","code":"3808.93.00","label":"- Herbicida, inibidores de germinação e reguladores de crescimento para plantas","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-097","code":"3808.94.00","label":"- Desinfectantes","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-098","code":"3808.99.00","label":"- Outros produtos semelhantes","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-099","code":"3821.00.00","label":"Meios de cultura preparados para o desenvolvimento de microrganismos e a manutenção de microrganismos (incluindo os vírus e os organismos similares) ou de células vegetais, humanas ou animais","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-100","code":"3822.00.00","label":"Reagentes de diagnóstico ou de laboratório em qualquer suporte e reagentes de diagnóstico ou de laboratório preparados, mesmos apresentados num suporte, excepto os das posições 30.02 ou 30.06; materiais de referência certificados","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-101","code":"3926.90.10","label":"- Flutuadores para a pesca","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-102","code":"3926.90.40","label":"- Brincos para identificação de animais","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-103","code":"5608.11.00","label":"-Redes confeccionadas para a pesca","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-104","code":"6304.20.00","label":"- Mosquiteiros para cama","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-105","code":"6305.10.00","label":"- Sacos de juta ou de outras fibras têxteis liberianas","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-106","code":"8201.10.00","label":"- Pás","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-107","code":"8201.30.00","label":"- Alviões, picaretas, enxadas, sachos, ancinhos e raspadeiras","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-108","code":"8201.40.00","label":"- Machados, padrões e ferramentas semelhantes de gume","pdfPage":8,"lastPdfPage":8},
{"id":"annexI-2022-109","code":"8201.50.00","label":"- Tesouras de podar (incluindo as tesouras para aves domésticas), manipuladas com uma das mãos","pdfPage":8,"lastPdfPage":9},
{"id":"annexI-2022-110","code":"8201.60.00","label":"- Tesouras para sebes, tesouras de podar e ferramentas semelhantes, manipuladas com as duas mãos","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-111","code":"8201.90.00","label":"- Outras ferramentas manuais para agricultura, horticultura e silvicultura","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-112","code":"8202.10.00","label":"- Serras manuais","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-113","code":"8202.20.00","label":"- Folhas para serras de fita","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-114","code":"8208.40.00","label":"- Correntes cortantes de serras","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-115","code":"8413.20.00","label":"Bombas para líquidos, mesmo com dispositivo medidor, elevadores de líquidos. -Bombas manuais, excepto das subposições 8413.11 e 8413.19","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-116","code":"8413.81.00","label":"- Outras Bombas","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-117","code":"8413.82.00","label":"- Elevadores de líquidos","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-118","code":"8419.31.00","label":"- Secadores - Para produtos agrícolas","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-119","code":"8421.11.00","label":"Centrifugadores, incluindo os secadores centrífugos; -Desnatadeiras","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-120","code":"8424.81.00","label":"- Aparelhos mecânicos (mesmo manuais) para projectar, dispersar ou pulverizar líquidos ou pós, para agricultura ou horticultura","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-121","code":"8424.90.00","label":"- Partes","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-122","code":"8425.31.00","label":"- Guinchos e cabrestantes de motor eléctrico","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-123","code":"8425.39.00","label":"- Outros guinchos e cabrestantes","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-124","code":"8432.10.00","label":"- Arados e charruas","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-125","code":"8432.21.00","label":"-Grades de discos","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-126","code":"8432.29.00","label":"- Outros: Grades, escarificadores, cultivadores, extirpadores, enxadas e sachadores","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-127","code":"8432.31.00","label":"- Semeadores, plantadores e transplantadores","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-128","code":"8432.41.00","label":"- Espalhadores de estrume e distribuidores de adubos (fertilizantes)","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-129","code":"8432.80.00","label":"- Outras máquinas e aparelhos de uso agrícola, hortícola ou florestal, para preparação ou trabalho do solo ou para cultura","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-130","code":"8432.90.00","label":"- Partes de máquinas e aparelhos de uso agrícola, hortícola ou florestal, para preparação ou trabalho do solo ou para cultura","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-131","code":"8433.11.00","label":"-Cortadores de relva motorizados, cujo dispositivo de corte gira num plano horizontal, para colheita ou debulha de produtos agrícolas","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-132","code":"8433.19.00","label":"-Outros cortadores de relva motorizados, para colheita ou debulha de produtos agrícolas","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-133","code":"8433.20.00","label":"- Ceifeiras, incluindo as barras de corte para montagem em tractores","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-134","code":"8433.30.00","label":"- Outras máquinas e aparelhos para colher e dispor o feno","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-135","code":"8433.40.00","label":"- Enfardadeiras de palha ou de forragem, incluindo as enfardadeiras- apanhadeiras","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-136","code":"8433.51.00","label":"-Ceifeiras-debulhadoras","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-137","code":"8433.52.00","label":"- Outras máquinas e aparelhos para debulha","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-138","code":"8433.53.00","label":"- Máquinas para colheita de raízes ou tubérculos","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-139","code":"8433.59.00","label":"- Outras máquinas e aparelhos para colheita e para debulha","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-140","code":"8433.60.00","label":"- Máquinas para limpar ou seleccionar ovos, frutas ou outros produtos agrícolas","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-141","code":"8433.90.00","label":"- Partes de máquina e aparelhos para colheita ou debulha de produtos agrícolas, incluindo as enfardadeiras de palha ou forragem; cortadores de relva e ceifeiras; máquinas para limpar e seleccionar ovos, frutas ou outros produtos agrícolas, excepto os da posição nº. 84.37.","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-142","code":"8434.10.00","label":"- Máquinas de ordenhar","pdfPage":9,"lastPdfPage":9},
{"id":"annexI-2022-143","code":"8434.20.00","label":"- Máquinas e aparelhos, para a indústria de lacticínios","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-144","code":"8434.90.00","label":"- Partes de máquinas e aparelhos de ordenhar e para a indústria de lacticínios","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-145","code":"8435.10.00","label":"Prensas, esmagadores, máquinas e aparelhos semelhantes, para fabricação de vinho, sidra, sumos de frutas ou bebidas semelhantes - Máquinas e aparelhos","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-146","code":"8435.90.00","label":"- Partes de prensas, esmagadores, máquinas e aparelhos semelhantes, para fabricação de vinho, sidra, sumos de frutas ou bebidas semelhantes","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-147","code":"8436.10.00","label":"- Máquinas e aparelhos, para preparação de alimentos e rações para animais","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-148","code":"8436.21.00","label":"- Chocadeiras e criadeiras para avicultura","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-149","code":"8436.29.00","label":"- Outras máquinas e aparelhos, para agricultura, horticultura, silvicultura, avicultura ou apicultura, incluindo os germinadores equipados com dispositivos mecânicos ou térmicos","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-150","code":"8436.80.00","label":"- Outras máquinas e aparelhos","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-151","code":"8436.91.00","label":"-Partes de máquinas e aparelhos, para agricultura, horticultura, silvicultura, avicultura ou apicultura, incluindo os germinadores equipados com dispositivos mecânicos ou térmicos e as chocadeiras e criadeiras para silvicultura","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-152","code":"8436.99.00","label":"- Partes de outras máquinas e aparelhos","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-153","code":"8437.10.00","label":"- Máquinas para limpeza, selecção ou peneiração de grão ou de produtos agrícolas secos","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-154","code":"8437.80.00","label":"- Outras máquinas e aparelhos para a indústria de moagem ou tratamento de cereais ou de produtos hortícolas secos, excepto dos tipos utilizados em fazendas","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-155","code":"8437.90.00","label":"- Partes de máquinas para limpeza, selecção ou peneiração de grãos ou de produtos hortícolas secos; máquinas e aparelhos para a indústria de moagem ou tratamento de cereais ou de produtos hortícolas secos, excepto dos tipos utilizados em fazendas","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-156","code":"8438.30.00","label":"Máquinas e aparelhos não especificados nem compreendidos noutras posições do presente capítulo… - Máquinas e aparelhos para indústria do açúcar","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-157","code":"8438.60.00","label":"- Máquinas e aparelhos para preparação de frutas ou de produtos hortícolas","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-158","code":"8501.61.00","label":"-Geradores de corrente alternada (alternadores) -De potência não superior a 75 KVA","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-159","code":"8502.11.00","label":"- Grupos electrogéneos de motor de pistão de ignição por compressão (motores diesel ou semi-diesel) -De potência não superior a 75 KVA","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-160","code":"8502.20.00","label":"- Grupos electrogéneos de motor de pistão de ignição por faísca (motor de explosão)","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-161","code":"8701.10.00","label":"- Tractores de um eixo","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-162","code":"8701.20.00","label":"- Tractores rodoviários para semi-reboques","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-163","code":"8701.30.00","label":"- Tractores de lagartas","pdfPage":10,"lastPdfPage":10},
{"id":"annexI-2022-164","code":"8701.91.00","label":"Nã superior a 18KW","pdfPage":10,"lastPdfPage":10,"context":"Outros tractores"},
{"id":"annexI-2022-165","code":"8701.92.00","label":"Superior a 18KW, mas não superior a 37KW","pdfPage":10,"lastPdfPage":10,"context":"Outros tractores"},
{"id":"annexI-2022-166","code":"8701.93.00","label":"Superior a 37KW, mas não superior a 75KW","pdfPage":10,"lastPdfPage":10,"context":"Outros tractores"},
{"id":"annexI-2022-167","code":"8701.94.00","label":"Superior a 75KW, mas não superior a 130KW","pdfPage":10,"lastPdfPage":10,"context":"Outros tractores"},
{"id":"annexI-2022-168","code":"8701.95.00","label":"Superior a 130KW","pdfPage":11,"lastPdfPage":11,"context":"Outros tractores"},
{"id":"annexI-2022-169","code":"8704.21.90","label":"- Outros veículos automóveis para transporte de mercadorias, com motor de pistão de ignição por compressão (diesel ou semi-diesel), de peso bruto não superior a 5 toneladas","pdfPage":11,"lastPdfPage":11},
{"id":"annexI-2022-170","code":"8716.80.00","label":"- Outros veículos não auto propulsionados (carroças de tracção animal)","pdfPage":11,"lastPdfPage":11},
{"id":"annexI-2022-171","code":"9507.20.00","label":"- Anzóis, mesmo montados em terminais (sedelas)","pdfPage":11,"lastPdfPage":11},
{"id":"annexI-2022-172","code":"9507.90.00","label":"- Outros artigos para a pesca à linha","pdfPage":11,"lastPdfPage":11}
];
export function annexIEntry(id:unknown):AnnexIEntry|undefined {return typeof id==='string'?annexIEntries.find(entry=>entry.id===id):undefined;}
export function annexIReference(entry:AnnexIEntry):string {return `AnexoI/2022: ${entry.id}; código ${entry.code}; ${entry.context?entry.context+' — ':''}${entry.label}; PDF${entry.pdfPage}${entry.lastPdfPage===entry.pdfPage?'':`–${entry.lastPdfPage}`}; ${annexIVersion}`;}
@@ -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)};}
}
+4
View File
@@ -0,0 +1,4 @@
import type {Acquisition} from './iva-acquisitions.ts';
export function beverageParcel(row:Acquisition):string{return JSON.stringify([row.field==='11'?'customs':row.supplier.trim().toLocaleLowerCase(),row.documentRef.trim().toLocaleLowerCase(),row.documentDate,row.documentLine.trim()]);}
type Claim={source:{parcel:string;origin:string}|null;stage:string;decision:string;receipts:unknown[]};
export function beverageParcelReserved(d:Record<string,unknown>,row:Acquisition):boolean{const store=JSON.parse(String(d.modelo_a_snapshot||'{}')),map=store.ivaBeverageRestitutions as Record<string,{rows:Claim[];result?:{inputs:Claim[]};history?:Array<{inputs:Claim[]}>}>|undefined;return Object.entries(map??{}).some(([scope,b])=>[...b.rows,...[...(b.history??[]),...(b.result?[b.result]:[])].flatMap(c=>c.inputs)].some(r=>r.source&&(scope===String(d.context_opportunity||'general')||r.source.origin==='effective')&&r.source.origin===row.origin&&r.source.parcel===beverageParcel(row)&&(r.stage==='submitted'||r.decision!=='pending'||r.receipts.length>0)));}
@@ -0,0 +1,43 @@
import {acquisitionBook,acquisitionCurrent,type Acquisition} from './iva-acquisitions.ts';
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';
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';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')||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}];});}
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);}
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')&&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),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 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??''}`,`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.']];}}
+48
View File
@@ -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)]];}}
+124
View File
@@ -0,0 +1,124 @@
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';refundAmount?:string;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)||r.refundAmount!==undefined&&typeof r.refundAmount!=='string'||!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 substitutionPayments(d:Record<string,unknown>):string[]{const m=store(d).ivaSubstitutions as Record<string,{result?:{inputs:Array<{id:string;prior:{entityRef:string;origin:string}|null;payments:ClosurePayment[]}>;rows:Array<{id:string;status:string;paid:FiscalFraction|null}>};history?:Array<{inputs:Array<{id:string;prior:{entityRef:string;origin:string}|null;payments:ClosurePayment[]}>;rows:Array<{id:string;status:string;paid:FiscalFraction|null}>}>}>|undefined;return Object.entries(m??{}).flatMap(([id,b])=>[...(b.history??[]),...(b.result?[b.result]:[])].flatMap(c=>c.inputs.filter(r=>r.prior&&(id===scope(d)||r.prior.origin==='effective')&&c.rows.some(v=>v.id===r.id&&v.status==='determined'&&v.paid)).flatMap(r=>r.payments.map(p=>closureFingerprint([normalize(r.prior!.entityRef),r.prior!.origin,normalize(p.reference)])))));}
function bookKey(d:Record<string,unknown>,b:ClosureBook){const sources=closureSources(d);const values:unknown[]=[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))])];const reserved=substitutionPayments(d),conflicts=b.rows.flatMap(r=>r.payments.map(p=>paymentIdentity(r,p))).filter(k=>reserved.includes(k));if(conflicts.length)values.push(conflicts);return closureFingerprint(values);}
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:''};}
function refundLockConflict(d:Record<string,unknown>,row:ClosureInput,fields:Record<string,FiscalFraction|null>):boolean{
const books=store(d).ivaRefunds as Record<string,{rows:Array<{source:{closureId:string;entityRef:string;origin:string;period:string;credit:FiscalFraction;carry:FiscalFraction;requested:FiscalFraction}|null;stage:string;decision:string;receipts:unknown[]}>;result?:{inputs:Array<{source:{closureId:string;entityRef:string;origin:string;period:string;credit:FiscalFraction;carry:FiscalFraction;requested:FiscalFraction}|null;stage:string;decision:string;receipts:unknown[]}>};history?:Array<{inputs:Array<{source:{closureId:string;entityRef:string;origin:string;period:string;credit:FiscalFraction;carry:FiscalFraction;requested:FiscalFraction}|null;stage:string;decision:string;receipts:unknown[]}>}>}>|undefined;
return Object.entries(books??{}).some(([context,book])=>[...book.rows,...[...(book.history??[]),...(book.result?[book.result]:[])].flatMap(c=>c.inputs)].some(r=>r.source&&(context===scope(d)||r.source.origin==='effective')&&r.source.closureId===row.id&&normalize(r.source.entityRef)===normalize(row.entityRef)&&r.source.origin===row.origin&&r.source.period===row.period&&(r.stage==='submitted'||r.decision!=='pending'||r.receipts.length>0)&&[['25',r.source.credit],['26',r.source.carry],['27',r.source.requested]].some(([f,v])=>JSON.stringify(fields[f as string])!==JSON.stringify(v))));
}
function effectiveCarryAlreadyUsed(d:Record<string,unknown>,row:ClosureInput,fields:Record<string,FiscalFraction|null>):boolean{
if(row.origin!=='effective'||row.destination!=='refund')return false;
const books=maps(d),own=books[scope(d)];if(!own)return false;
const prior=[...(own.history??[]),...(own.result?[own.result]:[])].flatMap(c=>c.rows).filter(r=>r.id===row.id&&r.origin==='effective'&&r.fields['26']&&fields['26']&&BigInt(subtractFractions(r.fields['26'],fields['26']).numerator)>0n);
return prior.some(p=>Object.values(books).some(b=>[...(b.history??[]),...(b.result?[b.result]:[])].some(c=>c.inputs.some(input=>input.origin==='effective'&&normalize(input.entityRef)===normalize(row.entityRef)&&input.period>row.period&&input.credits.some(credit=>credit.kind==='previous'&&credit.previousId===p.id&&credit.carryKey===p.carryKey)&&c.rows.some(r=>r.id===input.id&&r.status==='determined')))));
}
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();}
else if(row.destination==='refund'){
let amount:FiscalFraction;try{amount=decimalFraction(row.refundAmount??'');}catch{stop('Identifique a parcela destinada ao pedido;sem montante presumido.');continue;}
if(BigInt(amount.numerator)===0n||BigInt(subtractFractions(fields['25'],amount).numerator)<0n){stop('Parcela do pedido deve ser positiva e não exceder o crédito25;sem dupla utilização.');continue;}
fields['27']=amount;fields['26']=subtractFractions(fields['25'],amount);r.source+=' D:afectação expressa26+27=25,sem concessão/recebimento;CIVA21 eModeloA11.';
}else{stop('Escolha reporte integral ou parcela para preparação de reembolsoD;sem destino presumido.');continue;}
if(refundLockConflict(d,row,fields)){stop('Crédito ligado a pedido apresentado/decisão/recebimento;conserve a afectação e reconcilie o procedimento,sem o voltar a reportar ou alterar silenciosamente.');continue;}
if(effectiveCarryAlreadyUsed(d,row,fields)){stop('Reporte efectivo já utilizado numa declaração posterior recuperada;prepare o pedido sobre o saldo disponível do período reconciliado,sem reafectar retroactivamente crédito consumido.');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||substitutionPayments(d).includes(paymentIdentity(row,p))){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;'+(row.destination==='refund'?'26/27 separados pela afectação;27 é parcela destinada a pedidoD,sem concessão nem recebimento. ':'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 hasRefund=b.result?.rows.some(r=>r.fields['27']&&BigInt(r.fields['27'].numerator)>0n);
const description=hasRefund?closureSource.replace('Sem substituição21,reembolso27 ou restituição13(2).','ExtensãoD:26+27=25;27é parcela destinada a pedido,não decisão/recebimento. Substituição21 e restituição13(2) mantêm percursos próprios.'):closureSource;
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',description]];
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.']];}
}
+61
View File
@@ -0,0 +1,61 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const commissionBaseVersion='commission-goods-base/1';
export const commissionBaseSource='CIVA republicado Lei13/2016,15(2)(e),PDF13/p1426(271): nas transmissões de bens entre comitente e comissário,preço de venda acordado pelo comissário diminuído da comissão;entre comissário e comitente,preço de compra acordado pelo comissário aumentado da comissão. Art3(3)(c),PDF6/p1426(264): transferências em execução de contrato de comissão,incluindo consignação;na comissão de venda considera-se comprador o comissário,na de compra o comitente. Art15(5)/(6),PDF14,p1426(272),composição/exclusões,sem próprioIVA;regra especial de leilão15(2)(g)não substituída. Lei22/2022PDF3mantém15(2)(e);Lei10/2025PDF12mantém3(3)(c)por remissão e não altera15. Recorte2026/MZN,base de bens;sem incidência,taxa,IVA,serviço autónomo,dedução/campo11 ou totaisModeloA presumidos.';
export const commissionBaseTreatments=[
{id:'commission_sale_transfer',label:'Comitente → comissário — comissão de venda',direction:'Comitente para comissário',priceLabel:'Preço de venda acordado pelo comissário,antes da dedução da comissão,sem IVA',operator:'−'},
{id:'commission_purchase_transfer',label:'Comissário → comitente — comissão de compra',direction:'Comissário para comitente',priceLabel:'Preço de compra acordado pelo comissário,antes do acréscimo da comissão,sem IVA',operator:'+'},
] as const;
export const commissionBaseConditions=[
['taxableDomesticGoods','Está identificada uma transmissão de bens sujeita a IVA no território nacional; não é um serviço autónomo de intermediação nem qualquer pagamento de comissão'],
['commissionContract','A transferência destes bens entre comitente e comissário executa o contrato de comissão identificado,conforme3(3)(c),incluindo consignação quando aplicável'],
['directionConfirmed','A operação e os papéis correspondem ao sentido escolhido:comissão de venda(comitente para comissário)ou de compra(comissário para comitente)'],
['netComposition','O preço acordado pelo comissário e a comissão desta operação estão identificados sem o próprio IVA,com composição15(5)/(6)aplicável; o preço ainda não sofreu o ajuste da comissão efectuado por esta fórmula'],
['notSpecialAuction','Esta operação não está abrangida pela regra especial das vendas em leilão do artigo15(2)(g); essa base não é substituída pela comissão genérica'],
] as const;
type Condition=typeof commissionBaseConditions[number][0];
type Choice=''|'yes'|'no';
export type CommissionBaseRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';currency:string;principal:string;agent:string;agreementRef:string;agreedPrice:string;priceRef:string;commissionAmount:string;commissionRef:string;compositionRef:string;documentRef:string;documentDate:string;evidence:string;conditions:Partial<Record<Condition,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type CommissionBaseCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:CommissionBaseRow[];rows:LineResult[]};
export type CommissionBaseBook={rows:CommissionBaseRow[];result?:CommissionBaseCalculation;history?:CommissionBaseCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{commissionBases?:Record<string,CommissionBaseBook>};
export function newCommissionBase(id:string,currency:string):CommissionBaseRow{return{id,treatment:'',description:'',period:'',origin:'projected',currency,principal:'',agent:'',agreementRef:'',agreedPrice:'',priceRef:'',commissionAmount:'',commissionRef:'',compositionRef:'',documentRef:'',documentDate:'',evidence:'',conditions:{}};}
export function switchCommissionDirection(row:CommissionBaseRow,treatment:string):CommissionBaseRow{return{...row,treatment,conditions:{...row.conditions,directionConfirmed:''}};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.commissionBases!==undefined&&(!store.commissionBases||typeof store.commissionBases!=='object'||Array.isArray(store.commissionBases)))throw new Error('Bases de comissão não recuperáveis;originais preservados.');
const fields=Object.keys(newCommissionBase('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.commissionBases??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof CommissionBaseRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de comissão não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function commissionBaseBook(draft:Record<string,unknown>):CommissionBaseBook{return readStore(draft).commissionBases?.[acquisitionScope(draft)]??{rows:[]};}
export function saveCommissionBaseBook(draft:Record<string,unknown>,book:CommissionBaseBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,commissionBases:{...current.commissionBases,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateCommissionBase(row:CommissionBaseRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
const rule=commissionBaseTreatments.find(item=>item.id===row.treatment);
if(!rule)return stop('Escolha a transferência de bens em comissão de venda ou de compra; comissão desconhecida não determina uma base.');
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto;sem conversão silenciosa.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique o período em2026 e dados efectivos declarados ou pressupostos de projecção; não se infere o período do orçamento.');
const failed=commissionBaseConditions.filter(([key])=>row.conditions[key]==='no');if(failed.length)return stop('Não se aplica esta base de comissão: '+failed.map(([,label])=>label).join('; ')+'. Não é isenção nem IVA zero.','not_applicable');
const missing=commissionBaseConditions.filter(([key])=>row.conditions[key]!=='yes');if(missing.length)return stop('Condições por indicar: '+missing.map(([,label])=>label).join('; ')+'. Desconhecido não significa não aplicável ou zero.');
if(!row.description.trim()||!row.principal.trim()||!row.agent.trim()||!row.agreementRef.trim()||!row.priceRef.trim()||!row.commissionRef.trim()||!row.compositionRef.trim()||!row.documentRef.trim()||!row.evidence.trim()||!validDate(row.documentDate))return stop('Identifique bens,comitente,comissário,contrato,documento/data e referências do preço,comissão e composição,ou pressupostos expressos;reutilize referências existentes,sem novo certificado.');
const price=decimal(row.agreedPrice),commission=decimal(row.commissionAmount);if(price===null||commission===null)return stop('Indique preço acordado e comissão sem IVA;montante desconhecido ou inválido não é zero. Não se presume percentagem,base de percentagem ou valor da comissão.');
if(row.treatment==='commission_sale_transfer'&&commission>price)return stop(`Preço menos comissão produz diferença aritmética negativa de −${money(commission-price)}MZN. Valores conservados;este recorte não a apresenta como base fiscal determinada nem a substitui por zero ou valor absoluto.`);
const base=money(row.treatment==='commission_sale_transfer'?price-commission:price+commission);
return{...result,status:'determined',baseAmount:base,reason:`Base15(2)(e),${rule.direction}: preço ${money(price)} ${rule.operator} comissão ${money(commission)} = ${base}MZN,${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. Valores sem IVA,ajuste efectuado uma única vez. Base não é imposto;IVA/taxa,dedução/campo11 e totaisModeloA não são determinados por este cálculo.`};
}
function key(draft:Record<string,unknown>,book:CommissionBaseBook):string{return JSON.stringify({version:commissionBaseVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function commissionBaseCurrent(draft:Record<string,unknown>,book:CommissionBaseBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordCommissionBases(draft:Record<string,unknown>,book:CommissionBaseBook):CommissionBaseBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:CommissionBaseCalculation={version:commissionBaseVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:commissionBaseSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateCommissionBase(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveCommissionBaseBook(draft,next);return next;
}
export function commissionBaseReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=commissionBaseBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base P091 — ${row.period} — ${row.id}`,`${row.description};base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${commissionBaseCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${commissionBaseTreatments.find(item=>item.id===row.treatment)?.label??row.treatment};comitente ${row.principal};comissário ${row.agent};contrato ${row.agreementRef};preço ${row.agreedPrice} ${row.currency},referência ${row.priceRef};comissão ${row.commissionAmount} ${row.currency},referência ${row.commissionRef};composição ${row.compositionRef};documento ${row.documentRef},${row.documentDate};condições ${commissionBaseConditions.map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};não preenche totaisModeloA ou campo11.`]);}
catch{return[['IVA mensal','Base de comissão','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
+65
View File
@@ -0,0 +1,65 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const compositionBaseVersion='consideration-composition-base/1';
export const compositionBaseSource='CIVA republicado Lei13/2016,15(5)(a)/(b),PDF14/p1426(272):o valor tributável inclui impostos,direitos,taxas e outras imposições,excepto o próprioIVA;e despesas acessórias debitadas relativas a comissões,embalagem,transporte e seguros por conta do cliente. Respeitar regras especiais15(2) e exclusões15(6);não substitui a exclusãoTC emP095. Lei22/2022PDF3mantém15(5)por remissão;Lei10/2025não altera15. Recorte2026/MZN,composição da base apenas,sem incidência,taxas,IVA,dedução/campo11 ou totaisModeloA.';
export const compositionTreatments=[{id:'tax_component',label:'Impostos,direitos,taxas ou outras imposições,excepto próprio IVA'},{id:'accessory_component',label:'Despesas acessórias debitadas por conta do cliente'}] as const;
export const compositionConditions=[
['taxableOperation','A operação sujeita a IVA e a contraprestação correspondente estão identificadas'],
['initialNet','O montante inicial está identificado,sem próprio IVA e com as exclusões aplicáveis15(6)já consideradas; a referência explica a composição'],
['completeComposition','As parcelas aplicáveis15(5)estão reconciliadas com o montante inicial,sem omissões ou dupla contagem'],
['specialRules','Esta composição respeita a regra aplicável da operação,sem substituir bases especiais15(2),exclusões15(6)ou a exclusão da TC de combustíveis'],
] as const;
type Choice=''|'yes'|'no';type Condition=typeof compositionConditions[number][0];
export type CompositionPart={id:string;treatment:string;description:string;amount:string;included:Choice;reference:string;natureConfirmed:Choice;ownVatExcluded:Choice};
export type CompositionRow={id:string;description:string;period:string;origin:'projected'|'effective';currency:string;initialAmount:string;initialRef:string;operationRef:string;documentRef:string;documentDate:string;compositionRef:string;evidence:string;conditions:Partial<Record<Condition,Choice>>;parts:CompositionPart[]};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type CompositionCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:CompositionRow[];rows:LineResult[]};
export type CompositionBook={rows:CompositionRow[];result?:CompositionCalculation;history?:CompositionCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{considerationCompositions?:Record<string,CompositionBook>};
export function newCompositionPart(id:string):CompositionPart{return{id,treatment:'',description:'',amount:'',included:'',reference:'',natureConfirmed:'',ownVatExcluded:''};}
export function newCompositionBase(id:string,currency:string):CompositionRow{return{id,description:'',period:'',origin:'projected',currency,initialAmount:'',initialRef:'',operationRef:'',documentRef:'',documentDate:'',compositionRef:'',evidence:'',conditions:{},parts:[]};}
export function switchCompositionPart(part:CompositionPart,treatment:string):CompositionPart{return{...part,treatment,natureConfirmed:''};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.considerationCompositions!==undefined&&(!store.considerationCompositions||typeof store.considerationCompositions!=='object'||Array.isArray(store.considerationCompositions)))throw new Error('Composições não recuperáveis;originais preservados.');
const fields=Object.keys(newCompositionBase('','')).filter(key=>!['conditions','parts'].includes(key));const partFields=Object.keys(newCompositionPart(''));
for(const book of Object.values(store.considerationCompositions??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof CompositionRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)||!Array.isArray(row.parts)||row.parts.some(part=>!part||partFields.some(key=>typeof part[key as keyof CompositionPart]!=='string'))))throw new Error('Linhas de composição não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function compositionBook(draft:Record<string,unknown>):CompositionBook{return readStore(draft).considerationCompositions?.[acquisitionScope(draft)]??{rows:[]};}
export function saveCompositionBook(draft:Record<string,unknown>,book:CompositionBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,considerationCompositions:{...current.considerationCompositions,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateComposition(row:CompositionRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto;sem conversão silenciosa.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique mês em2026 e dados efectivos declarados ou pressupostos de projecção.');
const failed=compositionConditions.filter(([key])=>row.conditions[key]==='no');if(failed.length)return stop('Não se aplica esta composição: '+failed.map(([,label])=>label).join('; ')+'. Não é isenção nem IVA zero.','not_applicable');
const missing=compositionConditions.filter(([key])=>row.conditions[key]!=='yes');if(missing.length)return stop('Condições por indicar: '+missing.map(([,label])=>label).join('; ')+'. Desconhecido não é zero.');
if(!row.description.trim()||!row.initialRef.trim()||!row.operationRef.trim()||!row.documentRef.trim()||!row.compositionRef.trim()||!row.evidence.trim()||!validDate(row.documentDate))return stop('Identifique operação,montante inicial,documento/data,composição e fundamento ou pressupostos expressos;reutilize referências existentes,sem certificado/aprovador novo.');
const initial=decimal(row.initialAmount);if(initial===null)return stop('Indique o montante inicial sem próprio IVA e com exclusões aplicáveis consideradas;desconhecido não é zero.');
if(!row.parts.length||new Set(row.parts.map(p=>p.id)).size!==row.parts.length||row.parts.some(p=>!p.id.trim()))return stop('Identifique as parcelas desta operação com identificadores distintos;sem soma de linhas vazias ou duplicadas.');
let additions=0n;const formulas:string[]=[];
for(const part of row.parts){
const rule=compositionTreatments.find(t=>t.id===part.treatment);if(!rule)return stop('Identifique a natureza de cada parcela:imposição excepto próprioIVA ou despesa acessória debitada por conta do cliente.');
if(part.natureConfirmed==='no'||part.ownVatExcluded==='no')return stop('A parcela '+part.id+' não corresponde ao tratamento ou inclui próprioIVA;reveja a composição,não se transforma em exclusão/isenção automática.','not_applicable');
if(part.natureConfirmed!=='yes'||part.ownVatExcluded!=='yes'||!['yes','no'].includes(part.included))return stop('Confirme a natureza,exclusão do próprioIVA e se a parcela '+part.id+' já está no montante inicial;desconhecido não permite presumir soma ou ausência.');
if(!part.description.trim()||!part.reference.trim())return stop('Identifique descrição e referência da parcela '+part.id+',ou pressuposto expresso;sem novo documento obrigatório.');
const amount=decimal(part.amount);if(amount===null)return stop('Indique o montante exacto da parcela '+part.id+';desconhecido não é zero.');
if(part.included==='no')additions+=amount;
formulas.push(`${part.id}:${rule.label},${money(amount)}MZN,${part.included==='yes'?'já incluída,sem segunda soma':'acrescida uma vez'}`);
}
const base=initial+additions;return{...result,status:'determined',baseAmount:money(base),reason:`Base15(5):montante inicial ${money(initial)} + parcelas ainda não incluídas ${money(additions)} = ${money(base)}MZN;${formulas.join('; ')},${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. Base única por operação,não uma base por parcela. Base não é imposto;IVA/taxa,dedução/campo11 e totaisModeloA não são determinados por esta composição.`};
}
function key(draft:Record<string,unknown>,book:CompositionBook):string{return JSON.stringify({version:compositionBaseVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function compositionCurrent(draft:Record<string,unknown>,book:CompositionBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordCompositions(draft:Record<string,unknown>,book:CompositionBook):CompositionBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:CompositionCalculation={version:compositionBaseVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:compositionBaseSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateComposition(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveCompositionBook(draft,next);return next;
}
export function compositionReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=compositionBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base P101 — ${row.period} — ${row.id}`,`${row.description};base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${compositionCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};operação ${row.operationRef};montante inicial ${row.initialAmount} ${row.currency},referência ${row.initialRef};parcelas ${row.parts.map(p=>`${p.id}/${p.treatment},${p.description},${p.amount} ${row.currency},já incluída:${p.included==='yes'?'Sim':p.included==='no'?'Não':'Por indicar'},natureza:${p.natureConfirmed},sem próprioIVA:${p.ownVatExcluded},referência ${p.reference}`).join('; ')};composição ${row.compositionRef};documento ${row.documentRef},${row.documentDate};condições ${compositionConditions.map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};não preenche totaisModeloA ou campo11.`]);}
catch{return[['IVA mensal','Composição da contraprestação','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
+103
View File
@@ -0,0 +1,103 @@
import {selectFx,fxSelectionKey,fxTempoSource,type FxSelection} from './iva-fx-selection.ts';
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
import {convertCents as convertScaledAmount} from './business-financial-plan.ts';
export const currencyEventVersion='currency-events/1';
export const currencyEventSource='CIVA Lei13/2016,7(1)–(7),PDF8/p1426(266);8,PDF9/p1426(267);15(8),PDF14/p1426(272).Lei22/2022 eLei10/2025 não alteram7/8,15(8)mantido.RIVA21/2008PDF4:regra histórica5dias úteis,não prazo automático vigente;usar prazo e disposição aplicáveis identificados. P104:orientação operacional da Tempo25/10/2026 compra/venda/médiaBM conforme natureza e perspectiva;data de submissão indicada;excepções fiscais identificadas. Cenários históricos permanecem condicionados;sem base/IVA/dedução automaticamente activados.';
export const currencyEventTreatments=[
{id:'foreign_scenario',branch:'P104',label:'Moeda estrangeira — selecção operacional / cenário histórico'},
{id:'goods_available',branch:'P131',label:'Bens postos à disposição7(1)a'},
{id:'goods_transport',branch:'P131',label:'Início do transporte7(2)'},
{id:'goods_installation',branch:'P131',label:'Instalação/montagem concluída7(2)'},
{id:'service_completed',branch:'P131',label:'Serviço realizado7(1)b'},
{id:'service_early_charge',branch:'P131',label:'Serviço cobrado/debitado antes da realização7(1)b'},
{id:'import_clearance',branch:'P131',label:'Desembaraço aduaneiro7(1)c'},
{id:'import_auction',branch:'P131',label:'Arrematação/venda na importação7(1)c'},
{id:'continuous_period',branch:'P131',label:'Termo do período de pagamento sucessivo7(3)'},
{id:'contract_effects',branch:'P131',label:'Efeitos translativos posteriores7(7)'},
{id:'own_goods',branch:'P132',label:'Afectação/transmissão assimilada3(3)e/f e7(4)'},
{id:'own_services',branch:'P132',label:'Serviço assimilado4(2) e7(4)'},
{id:'commission_delivery',branch:'P132',label:'Comissário põe bens à disposição7(5)'},
{id:'consignment_deadline',branch:'P132',label:'Termo de180dias da consignação7(6)'},
{id:'advance_payment',branch:'P132',label:'Pagamento anterior à factura8c'},
] as const;
type Choice=''|'yes'|'no';
export type CurrencyEventRow={fxSelection?:FxSelection;id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';operationRef:string;documentRef:string;documentDate:string;scope:string;evidence:string;eventDate:string;eventRef:string;otherDate:string;reviewDate:string;factsConfirmed:Choice;invoiceRequired:Choice;invoiceState:''|'issued'|'not_issued';invoiceDate:string;invoiceRef:string;legalDeadline:string;deadlineRef:string;paymentState:''|'none'|'received';paymentDate:string;paymentRef:string;amount:string;paymentAmount:string;currency:string;sourceCurrency:string;fxRate:string;fxDate:string;fxSource:string;fxRuleRef:string;fxDirection:''|'mzn_per_unit'|'units_per_mzn';};
type DueEvent={date:string;amount:string|null;reason:string};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate'|'conditional';eventDate:string|null;dueEvents:DueEvent[];remainingPending:boolean;scenarioAmount:string|null;baseAmount:null;vat:null;rate:null;reason:string};
export type CurrencyEventCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:CurrencyEventRow[];rows:LineResult[]};
export type CurrencyEventBook={rows:CurrencyEventRow[];result?:CurrencyEventCalculation;history?:CurrencyEventCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{currencyEvents?:Record<string,CurrencyEventBook>};
export function newCurrencyEvent(id:string,currency:string):CurrencyEventRow{return{id,treatment:'',description:'',period:'',origin:'projected',operationRef:'',documentRef:'',documentDate:'',scope:'',evidence:'',eventDate:'',eventRef:'',otherDate:'',reviewDate:'',factsConfirmed:'',invoiceRequired:'',invoiceState:'',invoiceDate:'',invoiceRef:'',legalDeadline:'',deadlineRef:'',paymentState:'',paymentDate:'',paymentRef:'',amount:'',paymentAmount:'',currency,sourceCurrency:'',fxRate:'',fxDate:'',fxSource:'',fxRuleRef:'',fxDirection:''};}
export function switchCurrencyEvent(row:CurrencyEventRow,treatment:string):CurrencyEventRow{return{...row,treatment,factsConfirmed:'',invoiceRequired:''};}
function readStore(draft:Record<string,unknown>):Store{const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.currencyEvents!==undefined&&(!store.currencyEvents||typeof store.currencyEvents!=='object'||Array.isArray(store.currencyEvents)))throw new Error('Moeda/eventos não recuperáveis;originais preservados.');
const fields=Object.keys(newCurrencyEvent('',''));
for(const b of Object.values(store.currencyEvents??{}))if(!b||!Array.isArray(b.rows)||(b.history!==undefined&&!Array.isArray(b.history))||b.rows.some(r=>!r||fields.some(k=>typeof r[k as keyof CurrencyEventRow]!=='string')))throw new Error('Linhas de moeda/eventos não recuperáveis;sem lista vazia por defeito.');return store;}
export function currencyEventBook(draft:Record<string,unknown>):CurrencyEventBook{return readStore(draft).currencyEvents?.[acquisitionScope(draft)]??{rows:[]};}
export function saveCurrencyEventBook(draft:Record<string,unknown>,book:CurrencyEventBook):string{const store=readStore(draft),encoded=JSON.stringify({...store,currencyEvents:{...store.currencyEvents,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function date(s:string):number|null{const n=Date.parse(s+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(n)&&new Date(n).toISOString().slice(0,10)===s?n:null;}
function decimal(s:string,places=6):bigint|null{if(!new RegExp('^\\d{1,15}(\\.\\d{1,'+places+'})?$').test(s.trim()))return null;const[w,f='']=s.trim().split('.');return BigInt(w)*10n**BigInt(places)+BigInt(f.padEnd(places,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
export function evaluateCurrencyEvent(row:CurrencyEventRow):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',eventDate:null,dueEvents:[],remainingPending:false,scenarioAmount:null,baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
if(!currencyEventTreatments.some(t=>t.id===row.treatment))return stop('Identifique percurso de moeda/evento.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||date(row.documentDate)===null||![row.description,row.operationRef,row.documentRef,row.scope,row.evidence].every(v=>!!v.trim()))return stop('Identifique mês de contexto2026,operação,documento/data,âmbito e factos ou pressupostos expressos.');
if(row.factsConfirmed==='no')return stop('Os factos declarados afastam este percurso;sem isenção ou IVA zero por defeito.','not_applicable');
if(row.factsConfirmed!=='yes')return stop('Factos do percurso por esclarecer;não usar datas ou câmbio por defeito.');
if(row.treatment==='foreign_scenario'){
const amount=decimal(row.amount),fx=decimal(row.fxRate,8);
if(row.currency!=='MZN'||!['USD','EUR','ZAR','GBP','CNY','BRL','JPY','CHF','AUD','CAD'].includes(row.sourceCurrency)||amount===null||fx===null||fx===0n||date(row.fxDate)===null||![row.fxSource,row.fxRuleRef].every(v=>!!v.trim())||!['mzn_per_unit','units_per_mzn'].includes(row.fxDirection))return stop('Indique moeda original,valor,taxa positiva,direcção,data,fonte e regra/pressuposto expresso.Sem substituir moeda original porMZN ou reutilizar taxa de apresentação como regra fiscal.');
result.scenarioAmount=money(row.fxDirection==='mzn_per_unit'?convertScaledAmount(amount,fx,100000000n):(amount*100000000n+fx/2n)/fx);
if(row.fxSelection){
const converted=result.scenarioAmount;result.scenarioAmount=null;
try{const selected=selectFx(row.fxSelection),applied=row.fxSelection.applied;if(!applied||applied.selectionKey!==fxSelectionKey(row.fxSelection)||applied.rate!==selected.rate||applied.date!==selected.date||row.sourceCurrency!==row.fxSelection.sourceCurrency||row.fxDirection!==row.fxSelection.direction||row.fxRate!==selected.rate||row.fxDate!==selected.date||row.fxSource!==applied.source)return stop('Selecção cambial alterada ou não aplicada explicitamente;histórico preservado,sem recálculo automático.');
result.scenarioAmount=converted;
const columnLabel=({buy:'Compra',sell:'Venda',mean:'Média de referência BM',exception:'Excepção fiscal identificada'} as Record<string,string>)[selected.column];
return stop(`Conversão operacional segundo a orientação da Tempo de25/10/2026:${row.amount} ${row.sourceCurrency} → ${result.scenarioAmount} MZN. Coluna ${columnLabel};taxa ${row.fxRate};${row.fxDirection==='mzn_per_unit'?'MZN por unidade da moeda original':'unidades da moeda original por MZN'};data ${row.fxDate};boletim ${row.fxSelection.bulletinRef}. Sem cálculo de IVA ou dedução e sem alteração dos livros fiscais anteriores.`,'determined');
}catch(error){return stop(String(error));}
}
return stop(`P104:cenário condicionado=${result.scenarioAmount}MZN,origem${row.sourceCurrency},taxa${row.fxRate},${row.fxDirection},data${row.fxDate}. CotejoLei2/2006 concluido:106(5)nao define taxa/data;regra complementar15(8) ainda por demonstrar;referência indicada é pressuposto,não validação da taxa legal.Base fiscal permanece indeterminada.Sem IVA ou activação nos livros anteriores.`,`conditional`);
}
const review=date(row.reviewDate),event=date(row.eventDate);if(review===null||!row.eventRef.trim())return stop('Identifique data de conferência e documento/âmbito do evento específico.');
if(row.treatment==='consignment_deadline'){
const delivery=date(row.otherDate);if(delivery===null)return stop('Identifique entrega das mercadorias à consignação3(3)d;7(6) exige termo180dias,não embalagensP102.');
result.eventDate=new Date(delivery+180*86400000).toISOString().slice(0,10);
}else if(row.treatment==='advance_payment'){
if(date(row.paymentDate)===null)return stop('Identifique recebimento anterior à factura para8c.');result.eventDate=null;
}else{
if(event===null)return stop('Identifique a data própria do evento7,sem inferir da emissão do documento.');result.eventDate=row.eventDate;
if(row.treatment==='service_early_charge'&&(date(row.otherDate)===null||event>=date(row.otherDate)!))return stop('Indique realização do serviço posterior à cobrança/débito;aplique o evento apenas ao montante respectivo.');
if(row.treatment==='contract_effects'&&(date(row.otherDate)===null||event<date(row.otherDate)!))return stop('Indique disponibilização anterior ou simultânea aos efeitos translativos;este7(7) exclui3(3)a/b,que têm percursos próprios.');
}
if(['import_clearance','import_auction'].includes(row.treatment)){
if(date(result.eventDate!)!>review)return stop('Evento aduaneiro futuro na conferência;sem exigibilidade declarada.');
result.dueEvents=[{date:result.eventDate!,amount:decimal(row.amount)===null?null:money(decimal(row.amount)!),reason:'7(1)c:desembaraço/arrematação/venda na importação;factura comercial não desloca o evento aduaneiro'}];return stop('Importação7(1)c:facto gerador/exigibilidade pelo evento aduaneiro identificado;sem aplicar8 por factura comercial,nem calcular base/IVA.','determined');
}
if(row.invoiceRequired==='')return stop('Identifique se esta operação dá lugar à obrigação de factura25;7 e8 são estados separados.');
if(row.invoiceRequired==='no'){
if(result.eventDate&&date(result.eventDate)!>review)return stop('Evento futuro na conferencia;sem exigibilidade declarada.');
if(row.treatment==='advance_payment')return stop('Percurso8c exige operação com obrigação de factura;conferir enquadramento.','not_applicable');
result.dueEvents=[{date:result.eventDate!,amount:decimal(row.amount)===null?null:money(decimal(row.amount)!),reason:'Exigibilidade segundo evento7,sem obrigação de factura declarada'}];return stop('Facto gerador e exigibilidade7 identificados no âmbito declarado;sem calcular IVA,base ou dedução.','determined');
}
const deadline=date(row.legalDeadline);if(deadline===null||!row.deadlineRef.trim()||(result.eventDate&&deadline<date(result.eventDate)!))return stop('Facto gerador identificado;indique prazo legal de emissão e disposição/calendário aplicáveis.Sem presumir automaticamente cinco dias úteis2008 ou feriados.');
if(!['issued','not_issued'].includes(row.invoiceState)||!['none','received'].includes(row.paymentState))return stop('Identifique emissão e recebimentos;desconhecido não é ausência de pagamento.');
const invoice=row.invoiceState==='issued'?date(row.invoiceDate):null;
if(row.invoiceState==='issued'&&(invoice===null||invoice>review||!row.invoiceRef.trim()))return stop('Identifique factura efectivamente emitida/data/referência até à conferência.');
const normalDate=invoice!==null&&invoice<=deadline?row.invoiceDate:row.legalDeadline;const total=decimal(row.amount);
let paid=0n;
if(row.paymentState==='received'){
const payment=date(row.paymentDate),amount=decimal(row.paymentAmount);
if(payment===null||payment>review||amount===null||total===null||amount>total||!row.paymentRef.trim())return stop('Identifique recebimento,parcela e total do âmbito na mesma moeda;pagamento não pode exceder o total.Sem duplicar parcelas nem substituir montante desconhecido porzero.');
if((invoice===null||payment<invoice)&&payment<date(normalDate)!){paid=amount;result.dueEvents.push({date:row.paymentDate,amount:money(amount),reason:'8c:montante recebido antes da factura,sem prejuízo do termo do prazo8b'});}
else if(row.treatment==='advance_payment')return stop('Pagamento não é anterior à factura/termo aplicável;não antecipar por8c.','not_applicable');
}
if(row.treatment==='advance_payment'&&row.paymentState!=='received')return stop('Identifique o recebimento anterior à factura.');
const remainder=total===null?null:total-paid;
if(date(normalDate)!<=review){if(remainder===null||remainder>0n)result.dueEvents.push({date:normalDate,amount:remainder===null?null:money(remainder),reason:invoice!==null&&invoice<=deadline?'8a:factura emitida dentro do prazo':'8b:termo do prazo de emissão'});}
else result.remainingPending=remainder===null||remainder>0n;
return stop('Exigibilidade separada em parcelas8a/b/c,sem dupla contagem do recebimento e restante. Facto gerador7 conservado;prazo legal parametrizado com referência aplicável.Sem IVA,base fiscal,nova dedução ou totaisModeloA.','determined');
}
function key(draft:Record<string,unknown>,book:CurrencyEventBook):string{return JSON.stringify({version:currencyEventVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},rows:book.rows});}
export function currencyEventCurrent(draft:Record<string,unknown>,book:CurrencyEventBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordCurrencyEvents(draft:Record<string,unknown>,book:CurrencyEventBook):CurrencyEventBook{if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Indique operações com identidades distintas;originais conservados.');const result:CurrencyEventCalculation={version:currencyEventVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:currencyEventSource,inputs:structuredClone(book.rows),rows:book.rows.map(evaluateCurrencyEvent)};const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveCurrencyEventBook(draft,next);return next;}
export function currencyEventReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{try{const book=currencyEventBook(draft),r=book.result;if(!r)return[];return r.inputs.map((row,i):[string,string,string,string]=>{if(row.treatment==='foreign_scenario'&&row.fxSelection)return['IVA mensal',`P104 — ${row.period} — ${row.id}`,`${row.description};${r.rows[i].reason};Original:${row.amount} ${row.sourceCurrency};Convertido:${r.rows[i].scenarioAmount??'Indeterminado'} MZN`,`${r.opportunity};${currencyEventCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${r.revision};${r.calculatedAt};documento:${row.documentRef},${row.documentDate};âmbito:${row.scope};boletim:${row.fxSelection.bulletinRef};fonte:${row.fxSelection.source};natureza:${row.fxSelection.nature};perspectiva:${row.fxSelection.bulletinPerspective};relação:${row.fxSelection.relation};taxa:${row.fxRate};data:${row.fxDate};sentido:${row.fxDirection};regra/excepção:${row.fxRuleRef};sem base/IVA/dedução activados.`];return['IVA mensal',`${currencyEventTreatments.find(t=>t.id===row.treatment)?.branch??'Evento'} — ${row.period} — ${row.id}`,`${row.description};${r.rows[i].reason};facto gerador:${r.rows[i].eventDate??'Indeterminado/não apurado'};parcelas:${r.rows[i].dueEvents.map(p=>p.date+': '+(p.amount??'Montante indeterminado')+' '+row.currency+' ('+p.reason+')').join('; ')||'Nenhuma apurada'};restante pendente:${r.rows[i].status==='indeterminate'?'Indeterminado':r.rows[i].remainingPending?'Sim':'Não'};${row.treatment==='foreign_scenario'&&r.rows[i].status==='determined'?'conversão operacional':'cenário condicionado'}:${r.rows[i].scenarioAmount??'Indeterminado'};base/IVA:Indeterminados`,`${r.opportunity};${r.location};${currencyEventCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${r.revision};${r.calculatedAt};${r.source};${row.origin};documento ${row.documentRef},${row.documentDate};ambito ${row.scope};${row.treatment==='foreign_scenario'?`origem ${row.amount} ${row.sourceCurrency};taxa ${row.fxRate},${row.fxDirection},${row.fxDate};fonte ${row.fxSource};pressuposto ${row.fxRuleRef}`:`evento ${row.eventDate},${row.eventRef};outra data ${row.otherDate};conferencia ${row.reviewDate};factura ${row.invoiceRequired},${row.invoiceState},${row.invoiceDate},${row.invoiceRef};prazo ${row.legalDeadline},${row.deadlineRef};recebimento ${row.paymentState},${row.paymentDate},${row.paymentAmount},${row.paymentRef};total do ambito ${row.amount} ${row.currency}`};fundamento ${row.evidence};sem nova dedução/campo11/IVA ou activação cambial nos livros anteriores.`];});}catch{return[['IVA mensal','Moeda/eventos','Dados não recuperáveis','Originais preservados;sem substituição porzero.']];}}
+84
View File
@@ -0,0 +1,84 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const digitalVersion='digital-operations/1';
export const digitalSource='CIVA: Lei10/2025, PDF12/p2180(12), artigos3(2)/(7),6(7)k/(8)/(9); enumeração6(7)k i–v mantida de Lei13/2016 PDF8/p1426(266). Obrigações26(1–3),2016PDF17/p1426(275), e23(2),25(7),26(4),32(1)c e33(2),2025PDF13–14. Recorte2026. Natureza, localização e responsável separados de isenção, taxa, base, IVA e dedução. Modelos/formalidades remetidos para regulamentação não são presumidos.';
export const digitalTreatments=[
{id:'web',kind:'service',branch:'P121',clause:'6(7)k i',label:'Sítios, alojamento, manutenção remota e acesso a plataformas/cloud'},
{id:'software_service',kind:'service',branch:'P121',clause:'6(7)k ii/6(9)',label:'Programa/actualização como serviço, incluindo SaaS'},
{id:'information',kind:'service',branch:'P121',clause:'6(7)k iii',label:'Imagens, textos, informação e acesso a bases de dados'},
{id:'media',kind:'service',branch:'P121',clause:'6(7)k iv/6(9)',label:'Música, filmes, jogos, emissões e streaming'},
{id:'teaching',kind:'service',branch:'P121',clause:'6(7)k v',label:'Ensino à distância por meios electrónicos'},
{id:'analogous',kind:'service',branch:'P121',clause:'6(7)k vi/6(9)',label:'Outro serviço digital análogo, financeiro ou de intermediação digital'},
{id:'software_asset',kind:'goods',branch:'P130',clause:'3(2)/(7)',label:'Software como activo digital'},
{id:'content_asset',kind:'goods',branch:'P130',clause:'3(2)/(7)',label:'Conteúdo digital como activo'},
{id:'data_asset',kind:'goods',branch:'P130',clause:'3(2)/(7)',label:'Dados digitais com finalidade económica'},
{id:'crypto_asset',kind:'goods',branch:'P130',clause:'3(2)/(7)',label:'Criptomoeda como activo digital'},
{id:'ebook_asset',kind:'goods',branch:'P130',clause:'3(2)/(7)',label:'E-book como activo digital'},
{id:'profile_asset',kind:'goods',branch:'P130',clause:'3(2)/(7)',label:'Perfil em rede social como activo'},
{id:'access_asset',kind:'goods',branch:'P130',clause:'3(2)/(7)',label:'Conta, acesso ou identificador digital equiparável'},
{id:'other_asset',kind:'goods',branch:'P130',clause:'3(2)/(7)',label:'Outro activo virtual equiparável, com natureza fundamentada'},
] as const;
type Choice=''|'yes'|'no';
export type DigitalRow={id:string;kind:string;treatment:string;description:string;period:string;origin:'projected'|'effective';operationDate:string;operationRef:string;documentRef:string;documentDate:string;subjectRef:string;useRef:string;natureRef:string;scope:string;evidence:string;providerPlace:string;providerCountry:string;providerRef:string;buyerPlace:string;buyerCountry:string;buyerRef:string;buyerTaxable:string;buyerTaxRef:string;providerTaxable:string;providerTaxRef:string;representative:string;representativeRef:string;communicationPrior:string;communicationRef:string;businessUse:string;businessRef:string;goodsPlace:string;goodsPlaceRef:string;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';kind:string;territory:'national'|'outside'|null;responsible:'acquirer'|'provider'|'representative'|'outside'|'indeterminate';obligationReason:string;declarationReferenceDate:string|null;procedure:'regulation_pending'|'general'|'outside'|'indeterminate';baseAmount:null;vat:null;rate:null;deduction:null;reason:string};
export type DigitalCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;sourceKey:string;source:string;inputs:DigitalRow[];rows:LineResult[]};
export type DigitalBook={rows:DigitalRow[];result?:DigitalCalculation;history?:DigitalCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{digitalOperations?:Record<string,DigitalBook>};
export function newDigitalRow(id:string):DigitalRow{return{id,kind:'',treatment:'',description:'',period:'',origin:'projected',operationDate:'',operationRef:'',documentRef:'',documentDate:'',subjectRef:'',useRef:'',natureRef:'',scope:'',evidence:'',providerPlace:'',providerCountry:'',providerRef:'',buyerPlace:'',buyerCountry:'',buyerRef:'',buyerTaxable:'',buyerTaxRef:'',providerTaxable:'',providerTaxRef:'',representative:'',representativeRef:'',communicationPrior:'',communicationRef:'',businessUse:'',businessRef:'',goodsPlace:'',goodsPlaceRef:'',conditions:{}};}
export function digitalConditions(kind:string):Array<readonly[string,string]>{return kind==='goods'?[
['digitalAsset','Activo intangível em formato electrónico, com valor económico e susceptível de apropriação, titularidade, controlo, transferência ou licenciamento —3(7)'],
['assetTransfer','Esta operação transmite o bem digital identificado; a qualificação como activo distingue-se da prestação de um serviço'],
]:kind==='service'?[
['digitalService','Prestação intangível por meios electrónicos/software/plataforma/rede, nos termos de6(9); não exige ausência total de intervenção humana'],
['serviceSupply','A operação identificada é prestação de serviço, distinguida da transmissão de um activo digital'],
]:[];}
export function switchDigitalKind(row:DigitalRow,kind:string):DigitalRow{return{...row,kind,treatment:'',conditions:{}};}
export function switchDigitalTreatment(row:DigitalRow,treatment:string):DigitalRow{return{...row,treatment,conditions:{}};}
function readStore(draft:Record<string,unknown>):Store{
const s=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(s.digitalOperations!==undefined&&(!s.digitalOperations||typeof s.digitalOperations!=='object'||Array.isArray(s.digitalOperations)))throw new Error('Operações digitais não recuperáveis; originais conservados.');
const fields=Object.keys(newDigitalRow('')).filter(k=>k!=='conditions');
for(const b of Object.values(s.digitalOperations??{}))if(!b||!Array.isArray(b.rows)||(b.history!==undefined&&!Array.isArray(b.history))||b.rows.some(r=>!r||fields.some(k=>typeof r[k as keyof DigitalRow]!=='string')||!r.conditions||typeof r.conditions!=='object'||Array.isArray(r.conditions)))throw new Error('Linhas digitais não recuperáveis; sem lista vazia por defeito.');
return s;
}
export function digitalBook(draft:Record<string,unknown>):DigitalBook{return readStore(draft).digitalOperations?.[acquisitionScope(draft)]??{rows:[]};}
export function saveDigitalBook(draft:Record<string,unknown>,book:DigitalBook):string{const s=readStore(draft),encoded=JSON.stringify({...s,digitalOperations:{...s.digitalOperations,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function date(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
function declarationDate(period:string):string{const[y,m]=period.split('-').map(Number);return new Date(Date.UTC(y,m,10)).toISOString().slice(0,10);}
export function evaluateDigital(row:DigitalRow):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',kind:row.kind,territory:null,responsible:'indeterminate',obligationReason:'Responsável por esclarecer; nenhuma obrigação ou quantia presumida.',declarationReferenceDate:null,procedure:'indeterminate',baseAmount:null,vat:null,rate:null,deduction:null,reason:''};
const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
const rule=digitalTreatments.find(t=>t.id===row.treatment&&t.kind===row.kind);
if(!rule)return stop('Distinga transmissão de bem digital de prestação de serviço e identifique o tratamento. Software, licenciamento ou acesso não decidem essa distinção apenas pelo nome.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||!date(row.operationDate)||row.operationDate.slice(0,7)!==row.period)return stop('Identifique mês2026 e data correspondente, efectivos ou pressupostos expressos.');
const conditions=digitalConditions(row.kind);
if(conditions.some(([k])=>row.conditions[k]==='no'))return stop('A natureza não corresponde a este percurso digital; conservar dados e utilizar o tratamento aplicável. Não significa isenção ou IVA zero.','not_applicable');
if(conditions.some(([k])=>row.conditions[k]!=='yes'))return stop('Natureza digital ou distinção bem/serviço por esclarecer; categoria comercial não substitui os factos da operação.');
if(!row.description.trim()||!row.operationRef.trim()||!row.documentRef.trim()||!date(row.documentDate)||!row.subjectRef.trim()||!row.useRef.trim()||!row.natureRef.trim()||!row.scope.trim()||!row.evidence.trim())return stop('Identifique objecto, direitos/funcionalidade, destinatário/utilização, fundamento da natureza, operação, documento ou pressuposto, âmbito e período. Reutilize referências existentes; sem certificado ou aprovador adicional.');
if(!['MZ','foreign'].includes(row.buyerCountry)||!row.buyerPlace.trim()||!row.buyerRef.trim())return stop('Identifique estabelecimento ou domicílio do adquirente e referência; nacionalidade, moeda, IP ou servidor isolado não substituem esse facto.');
if(row.buyerCountry==='foreign')return{...result,status:'determined',territory:'outside',responsible:'outside',procedure:'outside',obligationReason:'6(8): fora do âmbito territorial nacional desta operação; não determina imposto estrangeiro.',reason:`${rule.branch},${rule.clause}: adquirente estabelecido/domiciliado no estrangeiro,6(8), ainda que transmitente/prestador nacional. Não é benefício fiscal, isenção ou IVA zero.`};
if(!['MZ','foreign'].includes(row.providerCountry)||!row.providerPlace.trim()||!row.providerRef.trim())return stop('Identifique sede/estabelecimento/domicílio a partir do qual o transmitente/prestador fornece, com país e referência.');
if(row.providerCountry==='foreign'){
result.territory='national';result.status='determined';result.reason=`${rule.branch},${rule.clause}: transmitente/prestador sem sede/EP/domicílio nacional a partir do qual fornece e adquirente nacional;6(7)k na redacção2025. A qualidade fiscal do adquirente não é presumida e distingue-se da localização.`;
if(row.buyerTaxable==='yes'&&row.buyerTaxRef.trim())return{...result,responsible:'acquirer',procedure:'regulation_pending',declarationReferenceDate:declarationDate(row.period),obligationReason:'26(4): obrigações a cargo do adquirente sujeito passivo nacional;25(7): declaração mensal e mapa de retenções em modelos apropriados, nos termos a regulamentar.32(1)c: referência legal até dia10 do mês seguinte. Sem ajuste de calendário/prorrogação presumidos, sem submissão ou pagamento.23(2)exclui6(7)k;33(2)refere26(1–3), não substituir este percurso digital por operações isoladas.'};
if(row.buyerTaxable==='no'&&row.buyerTaxRef.trim()&&row.providerTaxable==='yes'&&row.providerTaxRef.trim()){
if(row.representative==='yes'&&row.representativeRef.trim()&&row.communicationPrior==='yes'&&row.communicationRef.trim())return{...result,responsible:'representative',procedure:'general',obligationReason:'26(1)/(2): representante residente identificado, com procuração/poderes e comunicação à contraparte antes da operação; responsabilidade solidária com o representado.33(2) remete26(1–3) para declaração de operações isoladas. Não aplicar automaticamente prazo digital32(1)c ou atribuir retenção a consumidor.'};
if(row.representative==='no'&&row.businessUse==='yes'&&row.businessRef.trim())return{...result,responsible:'acquirer',procedure:'general',obligationReason:'26(3): falta de representante e aquisição no exercício de actividade comercial, industrial ou profissional expressamente identificadas; obrigações pelo adquirente.33(2) e23(2) quanto26(3), sem substituir pelo percurso26(4) de sujeito passivo nacional ou presumir montante/prazo.'};
}
return{...result,obligationReason:row.buyerTaxable==='no'?'26(4) não atribui por este fundamento as obrigações ao adquirente não sujeito passivo. Conferir26(1–3): qualidade do fornecedor não residente, representante com poderes/comunicação ou aquisição no exercício de actividade. Localização nacional mantida; nenhuma retenção automaticamente imputada ao consumidor.':'Qualidade fiscal do adquirente ou referência por esclarecer; localização nacional mantida. Não atribuir automaticamente26(4) nem obrigação de retenção a consumidor.'};
}
if(row.kind==='goods'){
if(!['MZ','foreign'].includes(row.goodsPlace)||!row.goodsPlaceRef.trim())return stop('Bem digital equiparado a corpóreo3(2)/(7): para o percurso doméstico6(1), identificar onde se encontra na colocação à disposição, com fundamento próprio. Não inferir do servidor, nacionalidade ou domicílio do adquirente.');
result.territory=row.goodsPlace==='MZ'?'national':'outside';
if(result.territory==='outside')return{...result,status:'determined',responsible:'outside',procedure:'outside',obligationReason:'6(1): localização exterior expressamente fundamentada; sem imposto estrangeiro presumido.',reason:`P130,3(2)/(7) e6(1): local do bem na colocação à disposição identificado fora do território; classificação não concede isenção.`};
}else result.territory='national';
return{...result,status:'determined',responsible:row.providerTaxable==='yes'&&!!row.providerTaxRef.trim()?'provider':'indeterminate',procedure:row.providerTaxable==='yes'&&!!row.providerTaxRef.trim()?'general':'indeterminate',obligationReason:row.providerTaxable==='yes'&&!!row.providerTaxRef.trim()?'Transmitente/prestador sujeito passivo nacional: obrigações gerais identificadas23(1)/25.26(4) e prazo digital32(1)c não se aplicam por este fundamento. Sem cálculo, submissão ou pagamento.':'Qualidade fiscal do transmitente/prestador ou fundamento por esclarecer; não atribuir obrigação automaticamente.',reason:`${rule.branch},${rule.clause}: operação doméstica;${row.kind==='service'?'localização6(3), estabelecimento nacional a partir do qual o serviço é prestado':'localização6(1), bem na colocação à disposição em Moçambique segundo referência expressa'}. Não confirma isenção, taxa, base, IVA ou dedução.`};
}
function key(draft:Record<string,unknown>,book:DigitalBook):string{return JSON.stringify({version:digitalVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},rows:book.rows});}
export function digitalCurrent(draft:Record<string,unknown>,book:DigitalBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordDigital(draft:Record<string,unknown>,book:DigitalBook):DigitalBook{
if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Identifique operações distintas; originais conservados.');
const result:DigitalCalculation={version:digitalVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),sourceKey:key(draft,book),source:digitalSource,inputs:structuredClone(book.rows),rows:book.rows.map(evaluateDigital)};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveDigitalBook(draft,next);return next;
}
export function digitalReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=digitalBook(draft),r=b.result;if(!r)return[];return r.inputs.map((row,i)=>{const line=r.rows[i],rule=digitalTreatments.find(t=>t.id===row.treatment);return['IVA mensal',`${rule?.branch??'Digital'} — ${row.period} — ${row.id}`,`${row.description};natureza:${row.kind==='goods'?'Bem digital':'Serviço digital'};localização:${line.territory==='national'?'Moçambique':line.territory==='outside'?'Fora do território':'Indeterminada'};${line.reason};responsável:${line.responsible};${line.obligationReason};${line.declarationReferenceDate?'Data de referência32(1)c:'+line.declarationReferenceDate+';':''}base/IVA/dedução:Indeterminados`,`${r.opportunity};${digitalCurrent(draft,b)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${r.revision};${r.calculatedAt};${r.source};${row.origin==='projected'?'Pressupostos projectados':'Dados efectivos declarados'};${rule?.label??''};operação${row.operationRef},${row.operationDate};objecto${row.subjectRef};natureza${row.natureRef};utilização${row.useRef};fornecedor${row.providerPlace},${row.providerCountry},${row.providerRef};adquirente${row.buyerPlace},${row.buyerCountry},${row.buyerRef};${row.buyerCountry==='MZ'&&row.providerCountry==='foreign'?'qualidade fiscal adquirente'+row.buyerTaxable+','+row.buyerTaxRef+';':''}${row.buyerCountry==='MZ'&&row.providerCountry==='MZ'?'qualidade fiscal fornecedor'+row.providerTaxable+','+row.providerTaxRef+';':''}${row.kind==='goods'&&row.buyerCountry==='MZ'&&row.providerCountry==='MZ'?'local do bem6(1)'+row.goodsPlace+','+row.goodsPlaceRef+';':''}${row.buyerCountry==='MZ'&&row.providerCountry==='foreign'&&row.buyerTaxable==='no'?'fornecedor não residente sujeito passivo'+row.providerTaxable+','+row.providerTaxRef+';representante'+row.representative+','+row.representativeRef+';comunicação anterior'+row.communicationPrior+','+row.communicationRef+';actividade comercial/industrial/profissional'+row.businessUse+','+row.businessRef+';':''}âmbito${row.scope};documento/pressuposto${row.documentRef},${row.documentDate};factos${row.evidence};${digitalConditions(row.kind).map(([k,label])=>label+':'+(row.conditions[k]??'Por esclarecer')).join(';')};sem lançamento fiscal, dedução/campo11, regularização ou totaisModeloA.`];});}catch{return[['IVA mensal','Digital','Dados não recuperáveis','Originais conservados; nenhuma classificação por defeito.']];}}
+77
View File
@@ -0,0 +1,77 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const exclusionBaseVersion='consideration-exclusions-base/1';
export const exclusionBaseSource='CIVA republicado Lei13/2016,15(6)(a–d),PDF14/p1426(272):exclui indemnizações declaradas judicialmente por incumprimento total/parcial de contratos;descontos,abatimentos ou bónus concedidos;quantias pagas em nome e por conta do adquirente/destinatário registadas em adequadas contas de terceiros;embalagens não efectivamente transaccionadas com elementos27(5)(b)na factura/documento equivalente.27(5)(b),PDF17/p1426(275):indicação separada e menção expressa da devolução acordada. Lei22/2022PDF3mantém15(6);Lei10/2025PDF14mantém27(5)(b),altera27(10),não15. Recorte2026/MZN,base apenas,sem IVA/dedução/campo11/regularizações ou totaisModeloA.';
export const exclusionTreatments=[{id:'judicial_indemnity',label:'Indemnização declarada judicialmente por incumprimento contratual'},{id:'granted_discount',label:'Desconto,abatimento ou bónus concedido'},{id:'third_party_payment',label:'Quantia paga em nome e por conta do adquirente/destinatário'},{id:'returnable_packaging',label:'Embalagem não efectivamente transaccionada,com devolução acordada'}] as const;
export const exclusionConditions=[
['operationIdentified','A operação e os montantes relacionados estão identificados'],
['initialNet','O montante inicial exclui o próprio IVA e tem a composição aplicável15(5)identificada,antes das exclusões ainda não consideradas'],
['completeComposition','As exclusões aplicáveis estão reconciliadas com o montante inicial,sem omissões ou dupla subtracção'],
['specialRules','Esta composição respeita a regra aplicável da operação,sem substituir bases especiais ou regularizações de outros períodos'],
] as const;
export const exclusionPartConditions={
judicial_indemnity:[['judicialDeclaration','A indemnização recebida foi declarada judicialmente'],['contractBreach','Corresponde ao incumprimento total ou parcial de contrato']],
granted_discount:[['granted','O desconto,abatimento ou bónus está concedido e corresponde a esta operação']],
third_party_payment:[['paidInName','A quantia foi paga em nome do adquirente/destinatário identificado'],['paidForAccount','A quantia foi paga por conta desse adquirente/destinatário'],['thirdPartyAccounts','Está registada pelo contribuinte em adequadas contas de terceiros']],
returnable_packaging:[['notTransacted','As embalagens não foram efectivamente transaccionadas'],['separateIndication','Constam separadamente na factura ou documento equivalente'],['returnMention','Consta menção expressa de que foi acordada a devolução das embalagens']],
} as const;
export function partConditions(treatment:string):ReadonlyArray<readonly[string,string]>{return exclusionPartConditions[treatment as keyof typeof exclusionPartConditions]??[];}
type Choice=''|'yes'|'no';type Condition=typeof exclusionConditions[number][0];
export type ExclusionPart={id:string;treatment:string;description:string;amount:string;included:Choice;reference:string;scope:string;accountRef:string;beneficiaryRef:string;documentExcerpt:string;conditions:Partial<Record<string,Choice>>};
export type ExclusionRow={id:string;description:string;period:string;origin:'projected'|'effective';currency:string;initialAmount:string;initialRef:string;operationRef:string;documentRef:string;documentDate:string;exclusionRef:string;evidence:string;conditions:Partial<Record<Condition,Choice>>;parts:ExclusionPart[]};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type ExclusionCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:ExclusionRow[];rows:LineResult[]};
export type ExclusionBook={rows:ExclusionRow[];result?:ExclusionCalculation;history?:ExclusionCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{considerationExclusions?:Record<string,ExclusionBook>};
export function newExclusionPart(id:string):ExclusionPart{return{id,treatment:'',description:'',amount:'',included:'',reference:'',scope:'',accountRef:'',beneficiaryRef:'',documentExcerpt:'',conditions:{}};}
export function newExclusionBase(id:string,currency:string):ExclusionRow{return{id,description:'',period:'',origin:'projected',currency,initialAmount:'',initialRef:'',operationRef:'',documentRef:'',documentDate:'',exclusionRef:'',evidence:'',conditions:{},parts:[]};}
export function switchExclusionPart(part:ExclusionPart,treatment:string):ExclusionPart{return{...part,treatment,conditions:{}};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.considerationExclusions!==undefined&&(!store.considerationExclusions||typeof store.considerationExclusions!=='object'||Array.isArray(store.considerationExclusions)))throw new Error('Exclusões não recuperáveis;originais preservados.');
const fields=Object.keys(newExclusionBase('','')).filter(key=>!['conditions','parts'].includes(key));const partFields=Object.keys(newExclusionPart('')).filter(key=>key!=='conditions');
for(const book of Object.values(store.considerationExclusions??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof ExclusionRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)||!Array.isArray(row.parts)||row.parts.some(part=>!part||partFields.some(key=>typeof part[key as keyof ExclusionPart]!=='string')||!part.conditions||typeof part.conditions!=='object'||Array.isArray(part.conditions))))throw new Error('Linhas de exclusão não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function exclusionBook(draft:Record<string,unknown>):ExclusionBook{return readStore(draft).considerationExclusions?.[acquisitionScope(draft)]??{rows:[]};}
export function saveExclusionBook(draft:Record<string,unknown>,book:ExclusionBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,considerationExclusions:{...current.considerationExclusions,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateExclusion(row:ExclusionRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto;sem conversão silenciosa.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique mês em2026 e dados efectivos declarados ou pressupostos de projecção.');
const failed=exclusionConditions.filter(([key])=>row.conditions[key]==='no');if(failed.length)return stop('Não se aplica esta composição: '+failed.map(([,label])=>label).join('; ')+'. Não é isenção nem IVA zero.','not_applicable');
const missing=exclusionConditions.filter(([key])=>row.conditions[key]!=='yes');if(missing.length)return stop('Condições por indicar: '+missing.map(([,label])=>label).join('; ')+'. Desconhecido não é zero.');
if(!row.description.trim()||!row.initialRef.trim()||!row.operationRef.trim()||!row.documentRef.trim()||!row.exclusionRef.trim()||!row.evidence.trim()||!validDate(row.documentDate))return stop('Identifique operação,montante inicial,documento/data,composição e fundamento ou pressupostos expressos;reutilize referências existentes,sem certificado/aprovador novo.');
const initial=decimal(row.initialAmount);if(initial===null)return stop('Indique o montante inicial sem próprio IVA,com as inclusões aplicáveis consideradas e antes das exclusões ainda não realizadas;desconhecido não é zero.');
if(!row.parts.length||new Set(row.parts.map(p=>p.id)).size!==row.parts.length||row.parts.some(p=>!p.id.trim()))return stop('Identifique as parcelas desta operação com identificadores distintos;sem subtracção de linhas vazias ou duplicadas.');
let exclusions=0n;const formulas:string[]=[];
for(const part of row.parts){
const rule=exclusionTreatments.find(t=>t.id===part.treatment);if(!rule)return stop('Identifique o tratamento de cada parcela;uma descrição genérica não demonstra exclusão.');
const own=partConditions(part.treatment),failed=own.filter(([key])=>part.conditions[key]==='no');
if(failed.length)return stop('Não se aplica a exclusão da parcela '+part.id+': '+failed.map(([,label])=>label).join('; ')+'. Sem subtracção automática ou IVA zero.','not_applicable');
if(own.some(([key])=>part.conditions[key]!=='yes')||!['yes','no'].includes(part.included))return stop('Confirme as condições próprias da parcela '+part.id+' e se ainda está incluída no montante inicial;desconhecido não permite presumir exclusão ou zero.');
if(!part.description.trim()||!part.reference.trim()||!part.scope.trim())return stop('Identifique descrição,referência e âmbito da parcela '+part.id+',ou pressuposto expresso. Na indemnização,a referência identifica a declaração judicial e o contrato;no desconto,a concessão.');
if(part.treatment==='third_party_payment'&&(!part.accountRef.trim()||!part.beneficiaryRef.trim()))return stop('Identifique as adequadas contas de terceiros e o adquirente/destinatário em nome e por conta de quem se pagou,ou pressupostos expressos;despesa própria não equivale a pagamento por conta alheia.');
if(part.treatment==='returnable_packaging'&&!part.documentExcerpt.trim())return stop('Identifique na referência da factura/documento a indicação separada e a menção expressa da devolução acordada,ou pressuposto expresso;sem exigir devolução já realizada.');
const amount=decimal(part.amount);if(amount===null)return stop('Indique o montante exacto da parcela '+part.id+';desconhecido não é zero.');
if(part.included==='yes')exclusions+=amount;
formulas.push(`${part.id}:${rule.label},${money(amount)}MZN,${part.included==='yes'?'excluída uma vez':'já excluída,sem segunda subtracção'}`);
}
if(exclusions>initial)return stop('As exclusões ainda incluídas excedem o montante inicial;reveja a composição,sem base negativa ou piso zero presumido.');
const base=initial-exclusions;return{...result,status:'determined',baseAmount:money(base),reason:`Base15(6):montante inicial ${money(initial)} − exclusões ainda incluídas ${money(exclusions)} = ${money(base)}MZN;${formulas.join('; ')},${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. Base única por operação. Base não é imposto;IVA/taxa,dedução/campo11,regularizações e totaisModeloA não são determinados por esta composição.`};
}
function key(draft:Record<string,unknown>,book:ExclusionBook):string{return JSON.stringify({version:exclusionBaseVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function exclusionCurrent(draft:Record<string,unknown>,book:ExclusionBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordExclusions(draft:Record<string,unknown>,book:ExclusionBook):ExclusionBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:ExclusionCalculation={version:exclusionBaseVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:exclusionBaseSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateExclusion(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveExclusionBook(draft,next);return next;
}
export function exclusionReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=exclusionBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base P102 — ${row.period} — ${row.id}`,`${row.description};base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${exclusionCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};operação ${row.operationRef};montante inicial ${row.initialAmount} ${row.currency},referência ${row.initialRef};parcelas ${row.parts.map(p=>`${p.id}/${p.treatment},${p.description},${p.amount} ${row.currency},já incluída:${p.included==='yes'?'Sim':p.included==='no'?'Não':'Por indicar'},referência ${p.reference},âmbito ${p.scope}${p.treatment==='third_party_payment'?`,contas ${p.accountRef},adquirente/destinatário ${p.beneficiaryRef}`:''}${p.treatment==='returnable_packaging'?`,menção documental ${p.documentExcerpt}`:''},condições ${partConditions(p.treatment).map(([key,label])=>label+': '+(p.conditions[key]==='yes'?'Sim':p.conditions[key]==='no'?'Não':'Por indicar')).join('; ')}`).join('; ')};composição ${row.exclusionRef};documento ${row.documentRef},${row.documentDate};condições ${exclusionConditions.map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};não preenche totaisModeloA ou campo11.`]);}
catch{return[['IVA mensal','Composição da contraprestação','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
@@ -0,0 +1,26 @@
import type { OperationTreatment } from './iva-operations.ts';
const source = 'CIVA republicado Lei13/2016, BR156/10.º suplemento,13(1)(b/j/k/l),PDF12/p.1426(270);19(1)(b)(i),PDF15/p.1426(273). Alterações Lei22/2022art.1 e Lei10/2025art.1 não alteram13 e mantêm19(1)(b)(i). Âmbito2026/MZN. Exige enquadramento/documento ou pressuposto expresso da projecção; não certifica reconhecimento, acordo, despacho ou exportação.';
const make = (id:string,label:string,letter:string,conditions:string[]):OperationTreatment => ({id,label,field:'05',rate:0,article:`CIVA arts.13(1)(${letter}),19(1)(b)(i)`,source,logicVersion:'export-beneficiaries/1',conditions:[
'Operação abrangida pelo CIVA em Moçambique, com territorialidade identificada; não importação nem operação localizada no estrangeiro',
...conditions,
]});
export const exportBeneficiaryTreatments:OperationTreatment[] = [
make('export_nonresident_buyer','Exportação por adquirente sem residência ou estabelecimento nacional','b',[
'Transmissão de bens expedidos ou transportados com destino ao estrangeiro pelo adquirente sem residência ou estabelecimento em território nacional, ou por terceiro por conta deste; adquirente, interveniente e saída identificados',
'Os bens não se destinam ao abastecimento de barcos desportivos ou de recreio, aviões de turismo ou qualquer outro meio de transporte de uso privado; destino concreto identificado, sem presumir pela nacionalidade do comprador',
'Enquadramento na regulamentação própria prevista em13(1)(b) identificado no fundamento/documento ou como pressuposto expresso da projecção; sem essa identificação não confirmar a condição nem presumir despacho ou isenção',
]),
make('export_diplomatic_mission','Fornecimentos a entidades diplomáticas ou consulares','j',[
'Transmissão de bens ou prestação de serviços destinada à entidade diplomática ou consular identificada; não basta destinatário estrangeiro',
'A isenção desta operação resulta de acordo ou convénio internacional celebrado por Moçambique, identificado com disposição, âmbito e período aplicáveis no fundamento; uma entidade diplomática por si não comprova a isenção',
]),
make('export_international_organisation','Fornecimentos a organismos internacionais ou seus membros elegíveis','k',[
'Transmissão de bens ou prestação de serviços destinada a organismo internacional reconhecido por Moçambique ou a membro desse organismo; organismo, reconhecimento e qualidade do destinatário identificados',
'A operação cumpre os limites e condições do acordo ou convénio internacional celebrado por Moçambique identificado no fundamento, incluindo disposição, âmbito e período; não presumir isenção geral de todas as compras ou de qualquer membro',
]),
make('export_humanitarian_organisation','Bens para exportação por organismo humanitário, caritativo ou educativo','l',[
'Transmissão de bens a organismo devidamente reconhecido, que os exporta para o estrangeiro no âmbito das suas actividades humanitárias, caritativas ou educativas; organismo, bens, saída e actividade identificados, não serviço nem simples intenção genérica de exportar',
'Prévio reconhecimento do direito à isenção para esta operação, na forma determinada em decreto regulamentar, identificado no fundamento/documento ou como pressuposto expresso da projecção; não confundir reconhecimento do organismo com reconhecimento do direito',
]),
];
+29
View File
@@ -0,0 +1,29 @@
import type { OperationTreatment } from './iva-operations.ts';
const source = 'CIVA republicado pela Lei13/2016, BR156/10.º suplemento, art.13(1)(o/p/q/r/t), PDF12/p.1426(270); art.19(1)(b)(i), PDF15/p.1426(273). Lei22/2022 art.1, PDF3/p.2252(27), mantém19(1)(b)(i); Lei10/2025 art.1, PDF12–13/p.2180(12)–(13), não altera13 e mantém19(1)(b)(i). Âmbito técnico2026/MZN; classificação de vendas, sem dedução automática de compras ou declaraçãoAT.';
const scope = 'Operação abrangida pelo CIVA em Moçambique, com territorialidade identificada; não inferida apenas da residência do cliente ou do sector';
const make = (id:string,label:string,letter:string,conditions:string[]):OperationTreatment => ({id,label,field:'05',rate:0,article:`CIVA arts.13(1)(${letter}),19(1)(b)(i)`,source,logicVersion:'export-direct-operations/1',conditions:[scope,...conditions]});
export const directExportTreatments:OperationTreatment[] = [
make('export_railway_cfm','Operação ferroviária dos CFM com companhia estrangeira','o',[
'Transmissão de bens ou prestação de serviços efectuada pelos Caminhos de Ferro de Moçambique a companhia ferroviária estrangeira identificada; não basta ser qualquer operador ferroviário',
'Operação no quadro da exploração de ferrovias ou dos seus equipamentos, com ligação identificada; não isenção de qualquer venda a companhia estrangeira',
]),
make('export_international_passengers','Transporte de passageiros proveniente do ou com destino ao estrangeiro','p',[
'Serviço identificado como transporte de passageiros; não transporte de mercadorias nem serviço autónomo de alojamento ou agência',
'Percurso proveniente do estrangeiro ou com destino ao estrangeiro, com origem e destino identificados no documento ou pressuposto; nacionalidade do passageiro não comprova o percurso',
]),
make('export_work_on_movables','Trabalhos em bens móveis para reexpedição ao estrangeiro','q',[
'Prestação de serviços que consiste em trabalhos sobre bens móveis identificados, adquiridos ou importados para esses trabalhos em território nacional',
'Os bens trabalhados são expedidos ou transportados de seguida para o estrangeiro, com correspondência entre entrada, trabalhos e saída identificada',
'Expedição efectuada pelo prestador, pelo destinatário não estabelecido no território nacional ou por terceiro em nome e por conta de qualquer deles; interveniente e relação identificados',
]),
make('export_gold_bom','Ouro não trabalhado transmitido ao Banco de Moçambique','r',[
'Bem identificado como ouro em barra ou noutra forma não trabalhada; não jóia nem artigo de ouro trabalhado',
'Adquirente identificado como Banco de Moçambique; não qualquer banco ou comprador estrangeiro',
]),
make('export_packaging','Taras e embalagens para mercadorias a exportar','t',[
'Transmissão de taras ou embalagens identificadas que servem de invólucro de mercadorias; não serviço autónomo de transporte ou armazenagem',
'Mercadorias a exportar identificadas e afectação das taras/embalagens a essas mercadorias documentada ou expressamente pressuposta; não inferida só da actividade exportadora do comprador',
]),
];
+20
View File
@@ -0,0 +1,20 @@
import type { OperationTreatment } from './iva-operations.ts';
const source='CIVA republicado Lei13/2016,13(1)(m/n/s),PDF12/p.1426(270);remissões12(1)(c),PDF11/p.1426(269),14,PDF13/p.1426(271),19(1)(b)(i),PDF15/p.1426(273). Lei22/2022art.1 eLei10/2025art.1 mantêm13 e19(1)(b)(i);Lei10/2025PDF12–13/p.2180(12)–(13). Âmbito2026/MZN;classificação do serviço,sem certificar regime/documentos ou deduzir compras automaticamente.';
const scope='O próprio serviço está localizado e abrangido pelo CIVA em Moçambique, com territorialidade identificada; cliente estrangeiro ou operação subjacente no estrangeiro não determinam, por si, a localização deste serviço';
const make=(id:string,label:string,letter:string,conditions:string[]):OperationTreatment=>({id,label,field:'05',rate:0,article:`CIVA arts.13(1)(${letter}),19(1)(b)(i)`,source,logicVersion:'export-linked-services/1',conditions:[scope,...conditions]});
export const exportServiceTreatments:OperationTreatment[]=[
make('export_customs_related_services','Serviços ligados a bens nos regimes indicados no artigo13(1)(m)','m',[
'Serviço directamente relacionado com trânsito, exportação ou importação dos bens identificados, com ligação concreta descrita',
'Os bens estão isentos por admissão temporária, draubaque ou trânsito nos termos de12(1)(c), ou entraram em depósitos de regime aduaneiro ou livre de outras áreas do14; regime e documento/pressuposto identificados, não apenas localização do projecto numa zona',
'O serviço não está entre os serviços referidos no artigo9; a exclusão foi analisada para esta operação concreta, não presumida por o cliente exportar',
]),
make('export_dispatch_services','Serviços ligados à expedição de bens para o estrangeiro','n',[
'Serviço identificado e relacionado com expedição de bens destinados ao estrangeiro; bens, destino e ligação concreta do serviço identificados no documento ou pressuposto',
'O serviço não está entre os serviços referidos no artigo9; não basta uma venda a cliente estrangeiro nem um serviço genérico ao exportador',
]),
make('export_disclosed_intermediation','Intermediação em nome e por conta de outrem — artigo13(1)(s)','s',[
'Prestação de intermediação em nome e por conta de outrem, com mandante e mandato/pressuposto identificados; não actuação em nome próprio',
'O intermediário intervém numa operação descrita no artigo13 ou realizada fora do território nacional, com operação e fundamento/localização identificados; a referência a outra linha não comprova automaticamente esses factos',
]),
];
export function isExportService(id:string):boolean{return exportServiceTreatments.some(item=>item.id===id);}
@@ -0,0 +1,50 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
import {goodsLocationBook,goodsLocationCurrent} from './iva-goods-location.ts';
import {serviceLocationBook,serviceLocationCurrent} from './iva-service-location.ts';
import {listedServiceBook,listedServiceCurrent} from './iva-listed-services.ts';
import {currencyEventBook,currencyEventCurrent} from './iva-currency-events.ts';
import {digitalBook,digitalCurrent} from './iva-digital.ts';
export const foreignOperationVersion='foreign-operations/1';
export const foreignOperationSource='CIVA6,Lei13/2016PDF7–8 e redacção2025:reutilizar localização já apurada.19(1)bii,2016PDF15/p1426(273),mantidoLei10/2025PDF13:operações no estrangeiro que seriam tributáveis se efectuadas no território nacional;19(2)alterado2025 mantém exclusões próprias. Enquadramento potencial,não dedução concedida/campo11.Não confundir fora do território com isenção/IVAzero,moeda estrangeira,cliente estrangeiro ou caixa06.';
type Choice=''|'yes'|'no';
export type ForeignOperationRow={id:string;sourceKind:''|'goods'|'services'|'listed'|'digital';sourceRowId:string;territorialPart:''|'outside'|'national';eventRowId:string;hypotheticalTaxable:Choice;hypotheticalRef:string;excluded19_2:Choice;scope:string;evidence:string;};
type Source={id:string;description:string;period:string;operationRef:string;scope:string;status:string;territory:string|null;current:boolean;revision:number;source:string;reason:string;};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';territory:string|null;relation19:'potential'|'not_demonstrated'|'excluded_19_2'|'indeterminate';source:Source|null;event:Record<string,unknown>|null;deduction:null;baseAmount:null;vat:null;rate:null;reason:string};
export type ForeignOperationCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;sourceKey:string;source:string;inputs:ForeignOperationRow[];rows:LineResult[]};
export type ForeignOperationBook={rows:ForeignOperationRow[];result?:ForeignOperationCalculation;history?:ForeignOperationCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{foreignOperations?:Record<string,ForeignOperationBook>};
export function newForeignOperation(id:string):ForeignOperationRow{return{id,sourceKind:'',sourceRowId:'',territorialPart:'',eventRowId:'',hypotheticalTaxable:'',hypotheticalRef:'',excluded19_2:'',scope:'',evidence:''};}
export function switchForeignSource(row:ForeignOperationRow,sourceKind:ForeignOperationRow['sourceKind'],sourceRowId=''):ForeignOperationRow{return{...row,sourceKind,sourceRowId,territorialPart:'',eventRowId:'',hypotheticalTaxable:'',excluded19_2:''};}
export function foreignSources(draft:Record<string,unknown>,kind:ForeignOperationRow['sourceKind']):Source[]{
if(kind==='digital'){const b=digitalBook(draft),r=b.result;return r?r.inputs.map((input,i)=>({id:input.id,description:input.description,period:input.period,operationRef:input.operationRef,scope:input.scope,status:r.rows[i].status,territory:r.rows[i].territory,current:digitalCurrent(draft,b),revision:r.revision,source:r.source,reason:r.rows[i].reason})):[];}
if(kind==='goods'){const b=goodsLocationBook(draft),r=b.result;return r?r.inputs.map((input,i)=>({id:input.id,description:input.description,period:input.period,operationRef:input.operationRef,scope:input.scope,status:r.rows[i].status,territory:r.rows[i].territory,current:goodsLocationCurrent(draft,b),revision:r.revision,source:r.source,reason:r.rows[i].reason})):[];}
if(kind==='services'){const b=serviceLocationBook(draft),r=b.result;return r?r.inputs.map((input,i)=>({id:input.id,description:input.description,period:input.period,operationRef:input.operationRef,scope:input.scope,status:r.rows[i].status,territory:r.rows[i].territory,current:serviceLocationCurrent(draft,b),revision:r.revision,source:r.source,reason:r.rows[i].reason})):[];}
if(kind==='listed'){const b=listedServiceBook(draft),r=b.result;return r?r.inputs.map((input,i)=>({id:input.id,description:input.description,period:input.period,operationRef:input.operationRef,scope:input.scope,status:r.rows[i].status,territory:r.rows[i].territory,current:listedServiceCurrent(draft,b),revision:r.revision,source:r.source,reason:r.rows[i].reason})):[];}
return[];
}
export function foreignEvents(draft:Record<string,unknown>):Array<{id:string;description:string;operationRef:string;period:string;current:boolean;revision:number;status:string;eventDate:string|null;dueEvents:unknown[];remainingPending:boolean}>{const b=currencyEventBook(draft),r=b.result;return r?r.inputs.filter(x=>x.treatment!=='foreign_scenario').map(input=>{const line=r.rows[r.inputs.findIndex(x=>x.id===input.id)];return{id:input.id,description:input.description,operationRef:input.operationRef,period:input.period,current:currencyEventCurrent(draft,b),revision:r.revision,status:line.status,eventDate:line.eventDate,dueEvents:line.dueEvents,remainingPending:line.remainingPending};}):[];}
function readStore(draft:Record<string,unknown>):Store{const s=readAcquisitionStore(draft.modelo_a_snapshot) as Store;if(s.foreignOperations!==undefined&&(!s.foreignOperations||typeof s.foreignOperations!=='object'||Array.isArray(s.foreignOperations)))throw new Error('Operações no estrangeiro não recuperáveis;originais conservados.');const fields=Object.keys(newForeignOperation(''));for(const b of Object.values(s.foreignOperations??{}))if(!b||!Array.isArray(b.rows)||(b.history!==undefined&&!Array.isArray(b.history))||b.rows.some(r=>!r||fields.some(k=>typeof r[k as keyof ForeignOperationRow]!=='string')))throw new Error('Linhas de operações no estrangeiro não recuperáveis;sem lista vazia por defeito.');return s;}
export function foreignOperationBook(draft:Record<string,unknown>):ForeignOperationBook{return readStore(draft).foreignOperations?.[acquisitionScope(draft)]??{rows:[]};}
export function saveForeignOperationBook(draft:Record<string,unknown>,book:ForeignOperationBook):string{const s=readStore(draft),encoded=JSON.stringify({...s,foreignOperations:{...s.foreignOperations,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
export function evaluateForeignOperation(draft:Record<string,unknown>,row:ForeignOperationRow):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',territory:null,relation19:'indeterminate',source:null,event:null,deduction:null,baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
try{const source=foreignSources(draft,row.sourceKind).find(s=>s.id===row.sourceRowId);if(!source)return stop('Escolha uma classificação de localização já guardada nesta oportunidade. Prepare-a nas secções existentes;sem nova classificação por endereço,nacionalidade ou moeda.');result.source=source;
if(!source.current||source.status!=='determined'||!source.territory)return stop('Localização alterada ou indeterminada;resultado anterior conservado,sem o tratar como classificação actual.');result.territory=source.territory;
if(!/^2026-(0[1-9]|1[0-2])$/.test(source.period)||!row.scope.trim()||!row.evidence.trim())return stop('Identifique âmbito da análise e factos/pressupostos;reutilize operação/período/documentos da localização.');
if(source.territory==='national')return stop('Localização reutilizada aponta para Moçambique;P002operação no estrangeiro não se aplica neste âmbito.Não equivale a isenção nem decide tributação interna.','not_applicable');
if(source.territory==='partial'){
if(!['outside','national'].includes(row.territorialPart))return stop('Transporte tem parcela nacional e exterior;delimite a parcela desta análise,sem transformar todo o trajecto em estrangeiro.');
if(row.territorialPart==='national'){result.territory='national';return stop('Análise limitada à parcela nacional do trajecto;P002estrangeiro não se aplica a essa parcela.','not_applicable');}result.territory='outside_portion';
}
if(row.eventRowId){const event=foreignEvents(draft).find(e=>e.id===row.eventRowId);if(!event||!event.current||event.status!=='determined'||event.operationRef!==source.operationRef||event.period!==source.period)return stop('Evento escolhido não está actual ou não corresponde à mesma operação/período;conserve localização e corrija apenas a associação.Não inferir evento pela data do documento.');result.event=event;}
if(!row.hypotheticalRef.trim()||!['yes','no'].includes(row.hypotheticalTaxable))return stop('Operação/parcela estrangeira identificada;fundamente se seria tributável caso efectuada em Moçambique19(1)bii.Não presumir esse facto pela localização ou pela taxa estrangeira.');
if(row.hypotheticalTaxable==='no'){result.relation19='not_demonstrated';return stop('Operação no estrangeiro identificada;pressuposto de tributabilidade interna19(1)bii não demonstrado pelos factos declarados.Isto não decide outros enquadramentos de dedução.','determined');}
if(!['yes','no'].includes(row.excluded19_2))return stop('Tributabilidade interna hipotética indicada;conferir exclusões19(2),incluindo17-A e pagamentos15(6)c.Sem presumir dedução.');
if(row.excluded19_2==='yes'){result.relation19='excluded_19_2';return stop('Operação no estrangeiro identificada;exclusão19(2) declarada e fundamentada afasta este enquadramento potencial.Não calcula ou regulariza dedução.','determined');}
result.relation19='potential';return stop('Operação/parcela no estrangeiro reutilizada da localização;seria tributável em Moçambique segundo fundamento declarado,sem exclusão19(2) indicada.Enquadramento potencial19(1)bii,dependente das demais condições18/20 e âmbito dos bens/serviços utilizados.Não é concessão/cálculo de dedução,campo11,isenção ou IVA zero.','determined');
}catch{return stop('Localização/eventos de origem não recuperáveis;originais preservados,sem inferir classificação ou valores.');}
}
function key(draft:Record<string,unknown>,book:ForeignOperationBook):string{return JSON.stringify({version:foreignOperationVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},rows:book.rows,dependencies:book.rows.map(row=>({source:foreignSources(draft,row.sourceKind).find(s=>s.id===row.sourceRowId),event:row.eventRowId?foreignEvents(draft).find(e=>e.id===row.eventRowId):null}))});}
export function foreignOperationCurrent(draft:Record<string,unknown>,book:ForeignOperationBook):boolean{try{return!!book.result&&book.result.sourceKey===key(draft,book);}catch{return false;}}
export function recordForeignOperations(draft:Record<string,unknown>,book:ForeignOperationBook):ForeignOperationBook{if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Indique identidades distintas;originais conservados.');const result:ForeignOperationCalculation={version:foreignOperationVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),sourceKey:key(draft,book),source:foreignOperationSource,inputs:structuredClone(book.rows),rows:book.rows.map(r=>evaluateForeignOperation(draft,r))};const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveForeignOperationBook(draft,next);return next;}
export function foreignOperationReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=foreignOperationBook(draft),r=b.result;if(!r)return[];return r.inputs.map((row,i)=>{const line=r.rows[i];return['IVA mensal',`P002 — ${line.source?.period??'Período indeterminado'} — ${row.id}`,`${line.source?.description??'Origem por escolher'};${line.reason};dedução/IVA:Indeterminados`,`${r.opportunity};${foreignOperationCurrent(draft,b)?'Resultado actual':'Origens/entradas alteradas;resultado histórico conservado'};versão${r.revision};${r.calculatedAt};${r.source};localização${row.sourceKind}/${row.sourceRowId},versão${line.source?.revision??'indeterminada'};${line.source?.reason??''};operação${line.source?.operationRef??''};âmbito origem${line.source?.scope??''};parcela${row.territorialPart};evento${row.eventRowId||'Sem associação necessária'},${line.event?JSON.stringify(line.event):'Não apurado por esta análise'};hipótese interna${row.hypotheticalTaxable},fundamento${row.hypotheticalRef};exclusão19(2)${row.excluded19_2};âmbito${row.scope};factos${row.evidence};sem base/IVA/dedução/campo11/totaisModeloA.`];});}catch{return[['IVA mensal','P002','Dados não recuperáveis','Originais preservados;sem classificação por defeito.']];}}
+61
View File
@@ -0,0 +1,61 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const fuelBaseVersion='regulated-fuel-base/1';
export const fuelBaseSource='CIVA republicado Lei13/2016,15(2)(i),PDF13/p1426(271): nas transmissões de combustíveis cujo preço é fixado por Autoridade Pública,efectuadas por revendedores,o valor da contraprestação determinado nos termos dos números1 e5 não inclui a Taxa sobre os Combustíveis. Art15(5)/(6),PDF14/p1426(272),composição/exclusões,sem próprioIVA. Lei22/2022PDF3mantém15(2)(i)/(1)/(5)/(6)por remissão;Lei10/2025não altera15. Recorte2026/MZN;base apenas,sem presumir preço regulado,valorTC,incidência,taxaIVA,IVA,dedução/campo11 ou totaisModeloA.';
export const fuelBaseTreatments=[{id:'fuel_tax_included',label:'Montante sem IVA ainda inclui a Taxa sobre Combustíveis'},{id:'fuel_tax_excluded',label:'Montante sem IVA já exclui a Taxa sobre Combustíveis'}] as const;
export const fuelBaseConditions=[
['taxableFuelResale','Está identificada uma transmissão de combustíveis sujeita a IVA,efectuada por revendedor; não é qualquer aquisição ou prestação de serviços'],
['publicFixedPrice','O preço deste combustível é fixado pela Autoridade Pública identificada na referência aplicável'],
['priceScopeMatches','A referência do preço e o respectivo âmbito abrangem este combustível,operação,local e data; não se presume um preço actual para outro período'],
['netComposition','O montante indicado exclui o próprio IVA e reflecte a composição aplicável do artigo15(1)/(5)/(6),sem omissões ou duplicações'],
['fuelTaxTreatment','O tratamento escolhido corresponde à composição do montante:TC ainda incluída ou já excluída; a mesma TC não será subtraída duas vezes'],
] as const;
type Choice=''|'yes'|'no';type Condition=typeof fuelBaseConditions[number][0];
export type FuelBaseRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';currency:string;operationDate:string;priceRef:string;priceScope:string;priceFrom:string;priceTo:string;documentRef:string;documentDate:string;consideration:string;fuelTax:string;fuelTaxRef:string;compositionRef:string;evidence:string;conditions:Partial<Record<Condition,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type FuelBaseCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:FuelBaseRow[];rows:LineResult[]};
export type FuelBaseBook={rows:FuelBaseRow[];result?:FuelBaseCalculation;history?:FuelBaseCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{regulatedFuelBases?:Record<string,FuelBaseBook>};
export function newFuelBase(id:string,currency:string):FuelBaseRow{return{id,treatment:'',description:'',period:'',origin:'projected',currency,operationDate:'',priceRef:'',priceScope:'',priceFrom:'',priceTo:'',documentRef:'',documentDate:'',consideration:'',fuelTax:'',fuelTaxRef:'',compositionRef:'',evidence:'',conditions:{}};}
export function switchFuelTaxTreatment(row:FuelBaseRow,treatment:string):FuelBaseRow{return{...row,treatment,conditions:{...row.conditions,fuelTaxTreatment:''}};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.regulatedFuelBases!==undefined&&(!store.regulatedFuelBases||typeof store.regulatedFuelBases!=='object'||Array.isArray(store.regulatedFuelBases)))throw new Error('Bases de combustíveis não recuperáveis;originais preservados.');
const fields=Object.keys(newFuelBase('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.regulatedFuelBases??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof FuelBaseRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de combustíveis não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function fuelBaseBook(draft:Record<string,unknown>):FuelBaseBook{return readStore(draft).regulatedFuelBases?.[acquisitionScope(draft)]??{rows:[]};}
export function saveFuelBaseBook(draft:Record<string,unknown>,book:FuelBaseBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,regulatedFuelBases:{...current.regulatedFuelBases,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateFuelBase(row:FuelBaseRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
if(!fuelBaseTreatments.some(item=>item.id===row.treatment))return stop('Indique se o montante sem IVA ainda inclui a TC ou já a exclui;não se presume a composição.');
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto;sem conversão silenciosa.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique mês em2026 e dados efectivos declarados ou pressupostos de projecção;sem inferir do orçamento.');
const failed=fuelBaseConditions.filter(([key])=>row.conditions[key]==='no');if(failed.length)return stop('Não se aplica esta base especial de combustíveis: '+failed.map(([,label])=>label).join('; ')+'. Não é isenção nem IVA zero.','not_applicable');
const missing=fuelBaseConditions.filter(([key])=>row.conditions[key]!=='yes');if(missing.length)return stop('Condições por indicar: '+missing.map(([,label])=>label).join('; ')+'. Desconhecido não significa não aplicável ou zero.');
if(!row.description.trim()||!row.priceRef.trim()||!row.priceScope.trim()||!row.documentRef.trim()||!row.compositionRef.trim()||!row.evidence.trim()||!validDate(row.documentDate))return stop('Identifique combustível/transmissão,referência e âmbito do preço,documento/data,composição e fundamento ou pressupostos expressos;reutilize referências existentes,sem novo certificado/aprovador.');
if(!validDate(row.operationDate)||row.operationDate.slice(0,7)!==row.period||!validDate(row.priceFrom)||row.operationDate<row.priceFrom||(row.priceTo!==''&&(!validDate(row.priceTo)||row.priceFrom>row.priceTo||row.operationDate>row.priceTo)))return stop('Identifique a data da transmissão no mês escolhido e o intervalo aplicável do preço que a abrange. Sem aplicar preço de outro período;na projecção indique pressupostos temporais expressos. O fim pode ficar vazio quando não existe termo fixado,com a correspondência temporal confirmada.');
const amount=decimal(row.consideration);if(amount===null)return stop('Indique o montante da contraprestação sem IVA;valor desconhecido ou inválido não é zero.');
let base=amount,formula='montante já sem TC,sem nova subtracção';
if(row.treatment==='fuel_tax_included'){
const tc=decimal(row.fuelTax);if(tc===null||!row.fuelTaxRef.trim())return stop('Identifique o montante exacto e a referência da TC incluída nesta contraprestação,ou pressuposto expresso;sem taxa TC presumida ou valor desconhecido igual a zero.');
if(tc>amount)return stop('A TC indicada excede a contraprestação sem IVA;reveja a composição e os montantes,sem base negativa ou zero substituto.');
base=amount-tc;formula=`${money(amount)} − ${money(tc)} de TC`;
}
return{...result,status:'determined',baseAmount:money(base),reason:`Base15(2)(i): ${formula} = ${money(base)}MZN,${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. Preço/âmbito/período e composição identificados;sem determinar automaticamente preço ou taxaTC. Base não é imposto;IVA/taxa,dedução/campo11 e totaisModeloA não são determinados por este cálculo.`};
}
function key(draft:Record<string,unknown>,book:FuelBaseBook):string{return JSON.stringify({version:fuelBaseVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function fuelBaseCurrent(draft:Record<string,unknown>,book:FuelBaseBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordFuelBases(draft:Record<string,unknown>,book:FuelBaseBook):FuelBaseBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:FuelBaseCalculation={version:fuelBaseVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:fuelBaseSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateFuelBase(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveFuelBaseBook(draft,next);return next;
}
export function fuelBaseReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=fuelBaseBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base P095 — ${row.period} — ${row.id}`,`${row.description};base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${fuelBaseCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};transmissão ${row.operationDate};preço ${row.priceRef};âmbito ${row.priceScope};intervalo ${row.priceFrom} a ${row.priceTo||'sem termo fixado,correspondência temporal confirmada'};${fuelBaseTreatments.find(item=>item.id===row.treatment)?.label??'Composição por indicar'};contraprestação ${row.consideration} ${row.currency};${row.treatment==='fuel_tax_included'?`TC incluída ${row.fuelTax} ${row.currency},referência ${row.fuelTaxRef}`:'TC já excluída,sem segunda subtracção'};composição ${row.compositionRef};documento ${row.documentRef},${row.documentDate};condições ${fuelBaseConditions.map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};não preenche totaisModeloA ou campo11.`]);}
catch{return[['IVA mensal','Base de combustíveis','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
+8
View File
@@ -0,0 +1,8 @@
export type FundraisingContext={entityReference:string;annualEvents:string;eventNumber:string;activity:string};
export const fundraisingActivities=[['health_public','Saúde pública — 9(1)(a)'],['social_assistance','Assistência social — 9(2)(a)'],['security_public','Segurança pública — 9(2)(b)'],['social_care','Equipamentos sociais — 9(2)(c)'],['activity_facilities','Prática artística/desportiva/recreativa — 9(2)(d)'],['cultural_visits','Visitas culturais — 9(2)(e)'],['statutory_membership','Serviços colectivos por quota — 9(2)(g)'],['education_public','Ensino público — 9(3)(a)'],['training_public','Formação pública — 9(3)(b)']];
export function fundraisingError(value:FundraisingContext|undefined,nonprofit:boolean):string|undefined {
if(!value||typeof value.entityReference!=='string'||!value.entityReference.trim())return 'Identifique a entidade organizadora; o limite anual não é por oportunidade.';
if(typeof value.annualEvents!=='string'||typeof value.eventNumber!=='string'||!/^[1-8]$/.test(value.annualEvents)||!/^[1-8]$/.test(value.eventNumber)||Number(value.eventNumber)>Number(value.annualEvents))return 'Indique o total anual da entidade (incluindo esta manifestação) e o número desta manifestação: de1a8, sem exceder o total. Desconhecido não significa zero.';
const activities=fundraisingActivities.map(([id])=>id).filter(id=>nonprofit?!id.endsWith('_public'):id!=='statutory_membership');
if(!activities.includes(value.activity))return 'Escolha uma actividade habitual isenta abrangida por9(2)(h) e compatível com a entidade; não basta ser uma angariação de fundos.';
}
+26
View File
@@ -0,0 +1,26 @@
export const fxTempoSource='Orientação operacional expressa da Tempo,25/10/2026:compra de moeda→taxa de compra;venda→taxa de venda;operações comerciais→taxa média de referência do Banco de Moçambique na data de submissão indicada. Interpretar compra/venda pela perspectiva do boletim. Excepções fiscais específicas conservam disposição,data,taxa e âmbito;sem recálculo automático dos históricos.';
export type FxSelection={issuer?:string;nature:''|'purchase'|'sale'|'commercial';submissionDate:string;bulletinDate:string;bulletinRef:string;source:string;sourceCurrency:string;direction:''|'mzn_per_unit'|'units_per_mzn';bulletinPerspective:string;relation:''|'same'|'opposite';buy:string;sell:string;mean:string;mode:'general'|'exception';exceptionRef:string;exceptionScope:string;exceptionDate:string;exceptionRate:string;applied?:{column:string;rate:string;date:string;source:string;selectedAt:string;selectionKey:string}};
export function emptyFxSelection():FxSelection{return{nature:'',submissionDate:'',bulletinDate:'',bulletinRef:'',source:'',sourceCurrency:'',direction:'',bulletinPerspective:'',relation:'',buy:'',sell:'',mean:'',mode:'general',exceptionRef:'',exceptionScope:'',exceptionDate:'',exceptionRate:''};}
function date(s:string){const d=new Date(s+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===s;}
function positive(s:string){return /^\d{1,15}(\.\d{1,8})?$/.test(s)&&Number(s)>0;}
export function fxSelectionKey(s:FxSelection):string{const {applied,...inputs}=s;void applied;return JSON.stringify(inputs);}
export function selectFx(s:FxSelection):NonNullable<FxSelection['applied']>{
if(!['purchase','sale','commercial'].includes(s.nature)||!date(s.submissionDate)||!s.bulletinRef.trim()||!s.source.trim()||!s.sourceCurrency.trim()||!['mzn_per_unit','units_per_mzn'].includes(s.direction))throw Error('Indique natureza,data de submissão,moeda,direcção e boletim/fonte;sem usar taxa actual ouzero por defeito.');
let column='',rate='',day='';
if(s.mode==='exception'){
if(!s.exceptionRef.trim()||!s.exceptionScope.trim()||!date(s.exceptionDate)||!positive(s.exceptionRate))throw Error('Excepção exige disposição fiscal,âmbito,data e taxa identificados;os restantes percursos continuam disponíveis.');
column='exception';rate=s.exceptionRate;day=s.exceptionDate;
}else{
if(s.mode!=='general'||s.bulletinDate!==s.submissionDate||!date(s.bulletinDate))throw Error('Use boletim da data de submissão indicada;ausência de boletim não autoriza usar a taxa mais recente.');
if(s.nature==='commercial'){
let officialUrl=false;try{officialUrl=['bancomoc.mz','www.bancomoc.mz'].includes(new URL(s.source).hostname);}catch{/* An identified official local exemplar does not require another validation. */}if(!officialUrl&&s.issuer?.trim()!=='Banco de Moçambique')throw Error('Operação comercial usa taxa média de referência do Banco de Moçambique;identifique a origemBM do boletim arquivado ou a suaURL,sem exigir nova validação da fonte aceite.');
column='mean';rate=s.mean;
}else{
if(!s.bulletinPerspective.trim()||!['same','opposite'].includes(s.relation))throw Error('Identifique a perspectiva indicada no boletim e a relação com a natureza declarada;sem inverter a operação do cliente por presunção.');
column=(s.nature==='purchase')===(s.relation==='same')?'buy':'sell';rate=column==='buy'?s.buy:s.sell;
}
day=s.submissionDate;
}
if(!positive(rate))throw Error('Taxa da coluna aplicável ausente ou inválida;não calcular média a partir de compra/venda.');
return{column,rate,date:day,source:`${s.bulletinRef};${s.source};perspectiva:${s.bulletinPerspective||'média de referênciaBM'};natureza:${s.nature};relação:${s.relation||'não aplicável à média'};${s.mode==='exception'?s.exceptionRef+';'+s.exceptionScope:fxTempoSource}`,selectedAt:new Date().toISOString(),selectionKey:fxSelectionKey(s)};
}
+65
View File
@@ -0,0 +1,65 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const goodsAllocationVersion='goods-allocation-base/1';
export const goodsAllocationSource='CIVA3(3)e/f,Lei13/2016PDF6–7/p1426(264–265):afectação permanente de bens a uso próprio/particular/alheio,transmissão gratuita,afectação a sector isento ou ao activo imobilizado de bens20(1)a,com dedução total/parcial anterior nos bens/elementos;excepção de amostras/ofertas de pequeno valor na alíneae. Art15(2)b,PDF13/p1426(271):preço de aquisição ou,na sua falta,preço de custo,reportados ao momento da operação. Art20(1)a,PDF15/p1426(273). Lei22/2022PDF3mantém15(2)b e20(1)a;Lei10/2025mantém3(3)e/f e não altera15/20. Recorte2026/MZN,sem nova dedução/campo11,regularização,taxa,IVA ou totaisModeloA. Uso temporário de bens como serviçoP089 é distinto.';
export const goodsAllocationTreatments=[{id:'permanent_private_goods',label:'Afectação permanente a uso próprio,particular ou fins alheios',clause:'e'},{id:'free_goods_transfer',label:'Transmissão gratuita de bens',clause:'e'},{id:'exempt_sector_goods',label:'Afectação de bens a sector de actividade isento',clause:'f'},{id:'fixed_asset_20a',label:'Afectação ao activo imobilizado de bens20(1)a',clause:'f'}] as const;
export const goodsAllocationConditions=[['businessGoods','São bens da empresa identificados,não uma prestação de serviços ou venda onerosa normal'],['priorDeduction','Houve dedução total ou parcial anterior nos bens ou elementos que os constituem,com referência histórica'],['factsCorrespond','Objecto,destino,operação,data eâmbito correspondem ao percurso identificado']] as const;
export const allocationOwnConditions={
permanent_private_goods:[['permanentAllocation','A afectação dos bens é permanente,não mero uso temporário'],['privatePurpose','Uso próprio do titular,pessoal ou fins alheios à empresa identificado'],['notSmallGift','Não se trata de amostra ou oferta de pequeno valor abrangida pela excepção3(3)e']],
free_goods_transfer:[['gratuitousTransfer','Está identificada uma transmissão gratuita dos bens'],['notSmallGift','Não se trata de amostra ou oferta de pequeno valor abrangida pela excepção3(3)e']],
exempt_sector_goods:[['exemptSector','Os bens são afectados ao sector de actividade isento identificado']],
fixed_asset_20a:[['fixedAsset','Está identificada a afectação ao activo imobilizado'],['goods20a','Os bens correspondem aos referidos em20(1)a,com âmbito e referência identificados']],
} as const;
export function allocationSpecificConditions(treatment:string):ReadonlyArray<readonly[string,string]>{return allocationOwnConditions[treatment as keyof typeof allocationOwnConditions]??[];}
type Choice=''|'yes'|'no';type Condition=typeof goodsAllocationConditions[number][0];
export type GoodsAllocationRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';currency:string;operationDate:string;operationRef:string;documentRef:string;documentDate:string;goodsRef:string;deductionRef:string;destinationRef:string;exceptionRef:string;asset20aRef:string;valuationMode:string;acquisitionPrice:string;acquisitionRef:string;currentCost:string;costRef:string;valuationDate:string;valuationScope:string;evidence:string;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';classification:'assimilated_goods'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type GoodsAllocationCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:GoodsAllocationRow[];rows:LineResult[]};
export type GoodsAllocationBook={rows:GoodsAllocationRow[];result?:GoodsAllocationCalculation;history?:GoodsAllocationCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{regulatedGoodsAllocations?:Record<string,GoodsAllocationBook>};
export function newGoodsAllocation(id:string,currency:string):GoodsAllocationRow{return{id,treatment:'',description:'',period:'',origin:'projected',currency,operationDate:'',operationRef:'',documentRef:'',documentDate:'',goodsRef:'',deductionRef:'',destinationRef:'',exceptionRef:'',asset20aRef:'',valuationMode:'',acquisitionPrice:'',acquisitionRef:'',currentCost:'',costRef:'',valuationDate:'',valuationScope:'',evidence:'',conditions:{}};}
export function switchAllocationTreatment(row:GoodsAllocationRow,treatment:string):GoodsAllocationRow{return{...row,treatment,conditions:Object.fromEntries(goodsAllocationConditions.map(([key])=>[key,row.conditions[key]??'']))};}
export function switchAllocationValuation(row:GoodsAllocationRow,valuationMode:string):GoodsAllocationRow{return{...row,valuationMode,conditions:{...row.conditions,valuationConfirmed:'',acquisitionUnavailable:''}};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.regulatedGoodsAllocations!==undefined&&(!store.regulatedGoodsAllocations||typeof store.regulatedGoodsAllocations!=='object'||Array.isArray(store.regulatedGoodsAllocations)))throw new Error('Afectações de bens não recuperáveis;originais preservados.');
const fields=Object.keys(newGoodsAllocation('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.regulatedGoodsAllocations??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof GoodsAllocationRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de afectações de bens não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function goodsAllocationBook(draft:Record<string,unknown>):GoodsAllocationBook{return readStore(draft).regulatedGoodsAllocations?.[acquisitionScope(draft)]??{rows:[]};}
export function saveGoodsAllocationBook(draft:Record<string,unknown>,book:GoodsAllocationBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,regulatedGoodsAllocations:{...current.regulatedGoodsAllocations,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateGoodsAllocation(row:GoodsAllocationRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',classification:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,classification:status==='not_applicable'?'not_applicable' as const:result.classification,reason});
const rule=goodsAllocationTreatments.find(t=>t.id===row.treatment);if(!rule)return stop('Identifique afectação permanente,transmissão gratuita,sector isento ou activo imobilizado20(1)a.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||!validDate(row.operationDate)||row.operationDate.slice(0,7)!==row.period)return stop('Identifique mês2026,data correspondente e dados efectivos ou pressupostos expressos.');
const conditions=[...goodsAllocationConditions,...allocationSpecificConditions(row.treatment)];if(conditions.some(([key])=>row.conditions[key]==='no'))return stop('Este percurso de transmissão assimilada não se aplica aos factos declarados;conferir natureza,dedução histórica ou excepção,não presumir isenção/IVAzero.','not_applicable');
if(conditions.some(([key])=>row.conditions[key]!=='yes'))return stop('Factos próprios ou dedução anterior por esclarecer;desconhecido não é não aplicável ou zero. Dedução histórica não é nova dedução concedida.');
if(!row.description.trim()||!row.operationRef.trim()||!row.documentRef.trim()||!validDate(row.documentDate)||!row.goodsRef.trim()||!row.deductionRef.trim()||!row.destinationRef.trim()||!row.evidence.trim())return stop('Identifique bens,operação,documento/data,dedução histórica,destino eâmbito factual ou pressupostos expressos;reutilize referências,sem certificado/aprovador novo.');
if(rule.clause==='e'&&!row.exceptionRef.trim())return stop('Identifique os factos/referência que distinguem a operação da excepção de amostras/ofertas de pequeno valor,ou pressuposto expresso;sem limiar inventado.');
if(row.treatment==='fixed_asset_20a'&&!row.asset20aRef.trim())return stop('Identifique enquadramento dos bens20(1)a eafectação ao activo imobilizado,com referência/âmbito.');
result.classification='assimilated_goods';
if(currency!=='MZN'||row.currency!==currency)return stop('Operação3(3)'+rule.clause+' identificada;moeda fora do recorteMZN ou divergente,base indeterminada,sem conversão silenciosa.');
if(!['acquisition','cost'].includes(row.valuationMode))return stop('Operação3(3)'+rule.clause+' identificada;base15(2)b por esclarecer:preço aquisição ou,na sua falta demonstrada,preço custo,reportados ao momento da operação.');
if(row.conditions.valuationConfirmed!=='yes'||!validDate(row.valuationDate)||row.valuationDate!==row.operationDate||!row.valuationScope.trim())return stop('Operação assimilada identificada;base por esclarecer. Confirme preço de aquisição/custo reportado ao momento desta operação,data/âmbito ecomposição sem próprioIVA;não usar custo histórico automaticamente.');
if(row.valuationMode==='cost'&&row.conditions.acquisitionUnavailable!=='yes')return stop('Operação assimilada identificada;não substituir aquisição desconhecida por custo. O custo15(2)b só é usado na falta demonstrada de preço aquisição;conferir esse facto.');
const raw=row.valuationMode==='acquisition'?row.acquisitionPrice:row.currentCost,ref=row.valuationMode==='acquisition'?row.acquisitionRef:row.costRef;const amount=decimal(raw);
if(amount===null||!ref.trim())return stop('Operação assimilada identificada;indique o preço e referência correspondentes ao modo escolhido,reportados ao momento da operação;desconhecido não é zero.');
return{...result,status:'determined',baseAmount:money(amount),reason:`P124:transmissão assimilada3(3)${rule.clause};P088:base15(2)b=${money(amount)}MZN,${row.valuationMode==='acquisition'?'preço aquisição':'preço custo,na falta demonstrada de preço aquisição'},reportado a${row.operationDate},${row.origin==='projected'?'sob pressupostos expressos':'segundo dados efectivos declarados'}. Dedução anterior total/parcial é facto histórico dos bens/elementos,não nova dedução/campo11. Não confundir afectação/transmissão de bens comserviço por uso temporárioP089. Sem calcular IVA,taxa,regularização ou totaisModeloA.`};
}
function key(draft:Record<string,unknown>,book:GoodsAllocationBook):string{return JSON.stringify({version:goodsAllocationVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function goodsAllocationCurrent(draft:Record<string,unknown>,book:GoodsAllocationBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordGoodsAllocations(draft:Record<string,unknown>,book:GoodsAllocationBook):GoodsAllocationBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:GoodsAllocationCalculation={version:goodsAllocationVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:goodsAllocationSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateGoodsAllocation(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveGoodsAllocationBook(draft,next);return next;
}
export function goodsAllocationReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=goodsAllocationBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>{const line=result.rows[index],rule=goodsAllocationTreatments.find(t=>t.id===row.treatment);return['IVA mensal',`Afectação P124/baseP088 — ${row.period} — ${row.id}`,`${row.description};classificação:${line.classification==='assimilated_goods'?'Transmissão assimilada de bens':line.classification==='not_applicable'?'Percurso não aplicável':'Indeterminada'};base:${line.baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${line.reason}`,`${result.opportunity};${result.location};${goodsAllocationCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${rule?.label??'Percurso por indicar'};operação ${row.operationRef},${row.operationDate};bens ${row.goodsRef};dedução histórica ${row.deductionRef};destino ${row.destinationRef};${rule?.clause==='e'?`excepção amostras/ofertas ${row.exceptionRef};`:''}${row.treatment==='fixed_asset_20a'?`enquadramento20(1)a ${row.asset20aRef};`:''}base ${row.valuationMode};${row.valuationMode==='cost'?`custo ${row.currentCost},${row.costRef};falta aquisição ${row.conditions.acquisitionUnavailable??'por indicar'}`:`aquisição ${row.acquisitionPrice},${row.acquisitionRef}`};data/âmbito base ${row.valuationDate},${row.valuationScope};documento ${row.documentRef},${row.documentDate};condições ${[...goodsAllocationConditions,...allocationSpecificConditions(row.treatment)].map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};sem nova dedução/campo11/IVA/regularização/totaisModeloA.`];});}
catch{return[['IVA mensal','Afectação de bens','Dados não recuperáveis','Originais preservados;sem base ou classificação por defeito.']];}
}
+61
View File
@@ -0,0 +1,61 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const goodsLocationVersion='goods-territoriality/1';
export const goodsLocationSource='CIVA republicado Lei13/2016,6(1)/(2),PDF7/p1426(265):localização dos bens no território nacional ao iniciar transporte/expedição para o adquirente ou,sem transporte/expedição,ao pôr à sua disposição. Não obstante6(1),são também tributáveis transmissões pelo importador e subsequentes de bens transportados/expedidos do estrangeiro,antes da importação. Lei10/2025PDF12mantém6(1)/(2),altera6(7–9)quanto a digitais;recorte2026,bens corpóreos,não digitais. Endereço/nacionalidade do cliente não substituem localização dos bens. Classificação territorial apenas,não isenção/taxa/IVA/dedução/campo11/direitos aduaneiros ou totaisModeloA.';
export const goodsLocationTreatments=[{id:'goods_with_transport',label:'Bens com transporte ou expedição para o adquirente'},{id:'goods_without_transport',label:'Bens sem transporte ou expedição'},{id:'goods_before_import',label:'Transmissão pelo importador ou subsequente,antes da importação'}] as const;
export const goodsLocationConditions=[
['goodsSupply','Está identificada uma transmissão de bens corpóreos,não uma prestação de serviços ou bens digitais abrangidos por regras próprias'],
['factsCorrespond','Os factos,referências e âmbito correspondem a esta operação e período,não apenas ao endereço ou nacionalidade do adquirente'],
] as const;
export const goodsOwnConditions={
goods_with_transport:[['transportToBuyer','Os bens são transportados ou expedidos para o adquirente'],['notBeforeImport','Não corresponde à transmissão pré-importação abrangida pelo artigo6(2)']],
goods_without_transport:[['noTransport','Não há expedição ou transporte dos bens para esta transmissão'],['notBeforeImport','Não corresponde à transmissão pré-importação abrangida pelo artigo6(2)']],
goods_before_import:[['fromAbroad','Os bens são transportados ou expedidos do estrangeiro'],['nationalImport','Está identificada a importação desses bens para o território nacional'],['importerChain','A transmissão é feita pelo importador ou é subsequente na cadeia desses bens'],['beforeImport','Esta transmissão ocorre antes da importação identificada']],
} as const;
export function ownGoodsConditions(treatment:string):ReadonlyArray<readonly[string,string]>{return goodsOwnConditions[treatment as keyof typeof goodsOwnConditions]??[];}
type Choice=''|'yes'|'no';type Condition=typeof goodsLocationConditions[number][0];
export type GoodsLocationRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';operationDate:string;operationRef:string;documentRef:string;documentDate:string;goodsPlace:string;placeCountry:string;placeRef:string;transportRef:string;importRef:string;chainRef:string;scope:string;evidence:string;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';territory:'national'|'outside'|null;baseAmount:null;vat:null;rate:null;reason:string};
export type GoodsLocationCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:GoodsLocationRow[];rows:LineResult[]};
export type GoodsLocationBook={rows:GoodsLocationRow[];result?:GoodsLocationCalculation;history?:GoodsLocationCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{goodsLocations?:Record<string,GoodsLocationBook>};
export function newGoodsLocation(id:string):GoodsLocationRow{return{id,treatment:'',description:'',period:'',origin:'projected',operationDate:'',operationRef:'',documentRef:'',documentDate:'',goodsPlace:'',placeCountry:'',placeRef:'',transportRef:'',importRef:'',chainRef:'',scope:'',evidence:'',conditions:{}};}
export function switchGoodsTreatment(row:GoodsLocationRow,treatment:string):GoodsLocationRow{return{...row,treatment,conditions:Object.fromEntries(goodsLocationConditions.map(([key])=>[key,row.conditions[key]??'']))};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.goodsLocations!==undefined&&(!store.goodsLocations||typeof store.goodsLocations!=='object'||Array.isArray(store.goodsLocations)))throw new Error('Bases de contraprestação não recuperáveis;originais preservados.');
const fields=Object.keys(newGoodsLocation('')).filter(key=>key!=='conditions');
for(const book of Object.values(store.goodsLocations??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof GoodsLocationRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de contraprestação não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function goodsLocationBook(draft:Record<string,unknown>):GoodsLocationBook{return readStore(draft).goodsLocations?.[acquisitionScope(draft)]??{rows:[]};}
export function saveGoodsLocationBook(draft:Record<string,unknown>,book:GoodsLocationBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,goodsLocations:{...current.goodsLocations,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateGoodsLocation(row:GoodsLocationRow):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',territory:null,baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
const rule=goodsLocationTreatments.find(t=>t.id===row.treatment);if(!rule)return stop('Identifique transporte,ausência de transporte ou transmissão antes da importação;desconhecido não determina território.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||!validDate(row.operationDate)||row.operationDate.slice(0,7)!==row.period)return stop('Identifique mês em2026 e data da operação correspondentes,com dados efectivos declarados ou pressupostos expressos de projecção.');
const required=[...goodsLocationConditions,...ownGoodsConditions(row.treatment)];const failed=required.filter(([key])=>row.conditions[key]==='no');if(failed.length)return stop('Este percurso não se aplica: '+failed.map(([,label])=>label).join('; ')+'. Rever o percurso,não classificar automaticamente como fora do território ou isento.','not_applicable');
if(required.some(([key])=>row.conditions[key]!=='yes'))return stop('Confirme os factos próprios deste percurso;desconhecido não é fora do território,isenção ou IVA zero.');
if(!row.description.trim()||!row.operationRef.trim()||!row.documentRef.trim()||!validDate(row.documentDate)||!row.scope.trim()||!row.evidence.trim())return stop('Identifique bens/operação,documento/data,âmbito e factos ou pressupostos expressos;reutilize referências existentes,sem certificado/aprovador novo.');
if(row.treatment==='goods_before_import'){
if(!row.transportRef.trim()||!row.importRef.trim()||!row.chainRef.trim())return stop('Identifique transporte/expedição do estrangeiro,importação nacional e posição da transmissão na cadeia,ou pressupostos expressos;não inferir a condição pelo endereço do adquirente.');
return{...result,status:'determined',territory:'national',reason:`Art6(2):transmissão pelo importador ou subsequente de bens transportados/expedidos do estrangeiro,antes da importação nacional identificada;abrangida territorialmente emMoçambique,${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. A localização física anterior no estrangeiro não afasta por si esta regra. Classificação não determina isenção,base,taxa,IVA,dedução/campo11,direitos ou totaisModeloA.`};
}
if(!row.goodsPlace.trim()||!row.placeRef.trim()||!['MZ','foreign'].includes(row.placeCountry))return stop('Identifique onde os bens se encontram no momento relevante e respectiva referência:início do transporte/expedição ou colocação à disposição sem transporte;endereço do cliente não substitui esse facto.');
if(row.treatment==='goods_with_transport'&&!row.transportRef.trim())return stop('Identifique o transporte/expedição correspondente ao início referido,ou pressuposto expresso.');
const territory=row.placeCountry==='MZ'?'national':'outside';return{...result,status:'determined',territory,reason:`Art6(1):bens ${territory==='national'?'situados emMoçambique':'situados fora deMoçambique'} ${row.treatment==='goods_with_transport'?'ao iniciar o transporte/expedição para o adquirente':'ao serem postos à disposição do adquirente,sem transporte/expedição'},${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. Factos de6(2)conferidos como não aplicáveis a este percurso. ${territory==='outside'?'Fora deste âmbito territorial não equivale a isenção ou taxa/IVA zero.':'Abrangência territorial não confirma isenção,taxa ou IVA.'} Classificação não determina base,dedução/campo11,direitos ou totaisModeloA.`};
}
function key(draft:Record<string,unknown>,book:GoodsLocationBook):string{return JSON.stringify({version:goodsLocationVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},rows:book.rows});}
export function goodsLocationCurrent(draft:Record<string,unknown>,book:GoodsLocationBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordGoodsLocations(draft:Record<string,unknown>,book:GoodsLocationBook):GoodsLocationBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:GoodsLocationCalculation={version:goodsLocationVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:goodsLocationSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateGoodsLocation(row))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveGoodsLocationBook(draft,next);return next;
}
export function goodsLocationReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=goodsLocationBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Localização P105 — ${row.period} — ${row.id}`,`${row.description};classificação territorial: ${result.rows[index].territory==='national'?'Moçambique':result.rows[index].territory==='outside'?'Fora do território nacional':'Indeterminada'};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${goodsLocationCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${goodsLocationTreatments.find(t=>t.id===row.treatment)?.label??'Percurso por indicar'};operação ${row.operationRef},${row.operationDate};${row.treatment==='goods_before_import'?`transporte ${row.transportRef};importação ${row.importRef};cadeia ${row.chainRef}`:`local dos bens ${row.goodsPlace},${row.placeCountry};referência ${row.placeRef}${row.treatment==='goods_with_transport'?`;transporte ${row.transportRef}`:''}`};âmbito ${row.scope};documento ${row.documentRef},${row.documentDate};condições ${[...goodsLocationConditions,...ownGoodsConditions(row.treatment)].map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento factual ${row.evidence};não determina isenção/IVA/campo11/totaisModeloA.`]);}
catch{return[['IVA mensal','Localização de bens','Dados não recuperáveis','Originais preservados;sem classificar por defeito.']];}
}
@@ -0,0 +1,57 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const goodsPresumptionVersion='goods-presumptions/1';
export const goodsPresumptionSource='CIVA Lei13/2016,3(3)d PDF6/p1426(264):mercadorias enviadas à consignação não devolvidas em180dias da entrega;3(4) PDF7/p1426(265):salvo prova em contrário,presunção de transmissão dos bens adquiridos/importados/produzidos não encontrados nos estabelecimentos e dos consumidos em quantidades excessivas face ao volume de produção;presunção de aquisição dos bens encontrados nesses locais.Lei22/2022 não altera3;Lei10/2025 PDF12 mantém3(3)d/3(4).Não são embalagensP102 nem aplicação automática da margemP092/P093/P125.';
export const goodsPresumptionTreatments=[{id:'consignment_180',branch:'P123',label:'Consignação — não devolução em180dias'},{id:'missing_goods',branch:'P126',label:'Presunção de transmissão — bens não localizados'},{id:'excess_consumption',branch:'P126',label:'Presunção de transmissão — consumo excessivo'},{id:'found_goods',branch:'P126',label:'Presunção de aquisição — bens encontrados'}] as const;
export const goodsPresumptionConditions={consignment_180:[['consignment','Mercadorias enviadas à consignação,com entrega ao destinatário identificado'],['notReturned','O conjunto identificado não foi devolvido até à data de conferência']],missing_goods:[['acquiredImportedProduced','Bens adquiridos,importados ou produzidos pelo sujeito passivo'],['notLocated','Não se encontram em nenhum dos estabelecimentos do sujeito passivo,segundo o levantamento identificado']],excess_consumption:[['acquiredImportedProduced','Bens adquiridos,importados ou produzidos pelo sujeito passivo'],['excessive','Consumo em quantidades excessivas,tendo em conta o volume de produção identificado']],found_goods:[['found','Bens encontrados em estabelecimento do sujeito passivo identificado']]} as const;
export function presumptionConditions(t:string):ReadonlyArray<readonly[string,string]>{return goodsPresumptionConditions[t as keyof typeof goodsPresumptionConditions]??[];}
type Choice=''|'yes'|'no';
export type GoodsPresumptionRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';operationDate:string;operationRef:string;documentRef:string;documentDate:string;goodsRef:string;scope:string;evidence:string;deliveryDate:string;recipientRef:string;inventoryRef:string;productionRef:string;quantity:string;quantityUnit:string;contraryProof:Choice;contraryProofRef:string;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';classification:'consignment_transmission'|'presumed_transmission'|'presumed_acquisition'|'rebutted'|'not_applicable'|'indeterminate';deadline:string|null;elapsedDays:number|null;baseAmount:null;vat:null;rate:null;reason:string};
export type GoodsPresumptionCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:GoodsPresumptionRow[];rows:LineResult[]};
export type GoodsPresumptionBook={rows:GoodsPresumptionRow[];result?:GoodsPresumptionCalculation;history?:GoodsPresumptionCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{goodsPresumptions?:Record<string,GoodsPresumptionBook>};
export function newGoodsPresumption(id:string):GoodsPresumptionRow{return{id,treatment:'',description:'',period:'',origin:'projected',operationDate:'',operationRef:'',documentRef:'',documentDate:'',goodsRef:'',scope:'',evidence:'',deliveryDate:'',recipientRef:'',inventoryRef:'',productionRef:'',quantity:'',quantityUnit:'',contraryProof:'',contraryProofRef:'',conditions:{}};}
export function switchPresumptionTreatment(row:GoodsPresumptionRow,treatment:string):GoodsPresumptionRow{return{...row,treatment,conditions:{},contraryProof:''};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.goodsPresumptions!==undefined&&(!store.goodsPresumptions||typeof store.goodsPresumptions!=='object'||Array.isArray(store.goodsPresumptions)))throw new Error('Presunções não recuperáveis;originais preservados.');
const fields=Object.keys(newGoodsPresumption('')).filter(k=>k!=='conditions');
for(const book of Object.values(store.goodsPresumptions??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(k=>typeof row[k as keyof GoodsPresumptionRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas não recuperáveis;originais conservados,sem lista vazia por defeito.');
return store;
}
export function goodsPresumptionBook(draft:Record<string,unknown>):GoodsPresumptionBook{return readStore(draft).goodsPresumptions?.[acquisitionScope(draft)]??{rows:[]};}
export function saveGoodsPresumptionBook(draft:Record<string,unknown>,book:GoodsPresumptionBook):string{const store=readStore(draft),encoded=JSON.stringify({...store,goodsPresumptions:{...store.goodsPresumptions,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function date(s:string):number|null{const n=Date.parse(s+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(n)&&new Date(n).toISOString().slice(0,10)===s?n:null;}
export function evaluateGoodsPresumption(row:GoodsPresumptionRow):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',classification:'indeterminate',deadline:null,elapsedDays:null,baseAmount:null,vat:null,rate:null,reason:''};
const stop=(reason:string,status:LineResult['status']='indeterminate',classification:LineResult['classification']=status==='not_applicable'?'not_applicable':result.classification)=>({...result,status,classification,reason});
const rule=goodsPresumptionTreatments.find(t=>t.id===row.treatment);if(!rule)return stop('Identifique o percurso;sem presunção por defeito.');
const operation=date(row.operationDate);
if(operation===null||!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||row.period!==row.operationDate.slice(0,7)||!['projected','effective'].includes(row.origin))return stop('Identifique data de conferência/mês2026 e dados efectivos ou pressupostos expressos.');
if(![row.description,row.operationRef,row.documentRef,row.goodsRef,row.scope,row.evidence].every(v=>!!v.trim())||date(row.documentDate)===null)return stop('Identifique bens,conjunto/âmbito,operação,documento/data e factos ou pressupostos;reutilize dados disponíveis,sem certificado/aprovador novo.');
const conditions=presumptionConditions(row.treatment);
if(conditions.some(([k])=>row.conditions[k]==='no'))return stop('Os factos declarados afastam este percurso específico;isso não determina isenção,IVA zero ou a classificação de outra operação.','not_applicable');
if(conditions.some(([k])=>row.conditions[k]!=='yes'))return stop('Factos próprios por esclarecer;desconhecido não é não aplicável.');
if(row.treatment==='consignment_180'){
const delivery=date(row.deliveryDate);if(delivery===null||delivery>operation||!row.recipientRef.trim())return stop('Identifique entrega ao destinatário e data anterior ou igual à conferência;sem prazo presumido.');
result.elapsedDays=(operation-delivery)/86400000;result.deadline=new Date(delivery+180*86400000).toISOString().slice(0,10);
if(result.elapsedDays<=180)return stop(`Prazo de180dias ainda não ultrapassado na conferência;limite ${result.deadline},decorridos ${result.elapsedDays}dias.Sem transmissão por não devolução nesta data. O dia180 conserva o prazo até ao fim do dia.`,`not_applicable`);
return stop(`P123:mercadorias identificadas enviadas à consignação,não devolvidas após180dias desde entrega${row.deliveryDate};limite${result.deadline};decorridos${result.elapsedDays}dias. Transmissão3(3)d identificada no recorte de conferência;não são embalagensP102. Data de exigibilidade/base/IVA não calculadas neste percurso;devolução posterior requer tratamento próprio,sem apagar histórico.`,`determined`,'consignment_transmission');
}
if(!row.inventoryRef.trim())return stop('Identifique levantamento/inventário e os estabelecimentos abrangidos;ausência numa única localização não demonstra ausência em todos os estabelecimentos.');
if(row.treatment==='excess_consumption'&&(!row.productionRef.trim()||!row.quantityUnit.trim()||!/^\d{1,15}(\.\d{1,6})?$/.test(row.quantity)||!/[1-9]/.test(row.quantity)))return stop('Identifique quantidade/unidade consumida e volume de produção/comparação que fundamenta o excesso;sem percentagem ou limiar inventado.');
if(row.contraryProof==='yes')return row.contraryProofRef.trim()?stop('Prova em contrário identificada para o conjunto/âmbito declarado:presunção3(4) afastada,sem atribuir isenção ou IVA zero e sem apagar histórico.','not_applicable','rebutted'):stop('Identifique o âmbito e referência da prova em contrário declarada;sem afastar presunção só por seleccionar Sim.');
if(row.contraryProof!=='no')return stop('Existência de prova em contrário por esclarecer;presunção ilidível,não conclusão definitiva nem infracção presumida.');
return stop(`P126:presunção ilidível3(4) de ${row.treatment==='found_goods'?'aquisição dos bens encontrados':'transmissão dos bens '+(row.treatment==='missing_goods'?'não localizados nos estabelecimentos abrangidos':'consumidos em quantidades excessivas face ao volume de produção')};segundo factos/pressupostos e âmbito identificados,sem prova em contrário declarada. Não comprova factura,aquisição efectiva,isenção ou dedução.Nenhuma base/taxa/IVA calculada;manter a possibilidade de prova em contrário.`,`determined`,row.treatment==='found_goods'?'presumed_acquisition':'presumed_transmission');
}
function key(draft:Record<string,unknown>,book:GoodsPresumptionBook):string{return JSON.stringify({version:goodsPresumptionVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},rows:book.rows});}
export function goodsPresumptionCurrent(draft:Record<string,unknown>,book:GoodsPresumptionBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordGoodsPresumptions(draft:Record<string,unknown>,book:GoodsPresumptionBook):GoodsPresumptionBook{
if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:GoodsPresumptionCalculation={version:goodsPresumptionVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:goodsPresumptionSource,inputs:structuredClone(book.rows),rows:book.rows.map(evaluateGoodsPresumption)};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveGoodsPresumptionBook(draft,next);return next;
}
export function goodsPresumptionReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=goodsPresumptionBook(draft),r=book.result;if(!r)return[];return r.inputs.map((row,i)=>['IVA mensal',`${goodsPresumptionTreatments.find(t=>t.id===row.treatment)?.branch??'Presunção'} — ${row.period} — ${row.id}`,`${row.description};${r.rows[i].reason};base/IVA:Indeterminados`,`${r.opportunity};${r.location};${goodsPresumptionCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${r.revision};${r.calculatedAt};${r.source};${row.origin};operação ${row.operationRef},${row.operationDate};documento ${row.documentRef},${row.documentDate};bens ${row.goodsRef};âmbito ${row.scope};${row.treatment==='consignment_180'?`entrega${row.deliveryDate},destinatário${row.recipientRef},limite${r.rows[i].deadline??'indeterminado'}`:`inventário ${row.inventoryRef};${row.treatment==='excess_consumption'?`consumo ${row.quantity} ${row.quantityUnit},produção/comparação ${row.productionRef};`:''}provaemcontrário ${row.contraryProof},${row.contraryProofRef}`};condições${JSON.stringify(row.conditions)};fundamento ${row.evidence};sem nova dedução/campo11/IVA/margem automática.`]);}
catch{return[['IVA mensal','Consignação/presunções','Dados não recuperáveis','Originais conservados;sem classificação por defeito.']];}
}
+162
View File
@@ -0,0 +1,162 @@
import { acquisitionScope } from './iva-acquisitions.ts';
import { internationalShipEligibility,internationalAircraftEligibility } from './iva-international-assets.ts';
type Choice = ''|'yes'|'no';
export const importExemptionVersion = 'import-exemptions/1';
export const importExemptionSource = 'CIVA republicado pela Lei13/2016, BR156/10.º suplemento, art.12(1)(d/f),PDF11/p.1426(269). Lei22/2022,PDF2/p.2252(26),mantém d/f; Lei10/2025,PDF12–13/p.2180(12–13),mantém d/f. Cobertura2026/MZN; classificação do IVA na importação,sem cálculo de direitos aduaneiros ou dedução no campo11.';
export const importBeneficiaryVersion = 'import-beneficiaries/1';
export const importBeneficiarySource = 'CIVA republicado pela Lei13/2016, BR156/10.º suplemento, art.12(1)(j/l),PDF11/p.1426(269). Lei22/2022,PDF2/p.2252(26),e Lei10/2025,PDF13/p.2180(13),mantêm j/l. Cobertura2026/MZN; importação de objectos de arte e veículo de combate a incêndios nas condições próprias,sem dedução no campo11 nem cálculo de direitos aduaneiros.';
export const importAssetVersion = 'import-assets/1';
export const importAssetSource = 'CIVA republicado pela Lei13/2016, BR156/10.º suplemento, art.12(1)(h/i),PDF11/p.1426(269),por referência a13(1)(f/g),PDF12/p.1426(270),e actividades de13(1)(c/d). Lei22/2022,PDF2/p.2252(26),e Lei10/2025,PDF13/p.2180(13),mantêm h/i;13 não alterado nesses diplomas. Cobertura2026/MZN; importação de embarcação/avião elegível ou objecto incorporado/utilizado na respectiva exploração,sem dedução no campo11,base aduaneira ou cálculo de direitos aduaneiros.';
export const importCustomsVersion = 'import-customs-regimes/1';
export const importCustomsSource = 'CIVA republicado pela Lei13/2016, BR156/10.º suplemento, art.12(1)(c),PDF11/p.1426(269): importações de bens nos regimes de trânsito, importação temporária ou draubaque que sejam isentas totalmente de direitos aduaneiros. Lei22/2022,PDF2/p.2252(26),e Lei10/2025,PDF13/p.2180(13),mantêm c) por remissão,sem nova redacção expandida neste recorte. Cobertura2026/MZN; classificação de IVA na importação,sem cálculo de direitos,base aduaneira,saída de regime ou dedução no campo11.';
export const importSpecialRegimeVersion = 'import-special-regimes/1';
export const importSpecialRegimeSource = 'CIVA republicado pela Lei13/2016, BR156/10.º suplemento, art.14(1)(a) e condição inicial14(1),PDF13/p.1426(271). Lei22/2022 e Lei10/2025 não alteram14 neste acervo. Importações sob controlo alfandegário e disposições especificamente aplicáveis, enquanto os bens permanecem nos regimes enumerados, sem utilização nem consumo finais nas áreas mencionadas. Cobertura2026/MZN; sem dedução/campo11, cálculo de direitos ou saída do regime.';
export const importSupplyVersion = 'import-onboard-supplies/1';
export const importSupplySource = 'CIVA republicado pela Lei13/2016,BR156/10.º suplemento,12(1)(g),12(3)(a)(i–iv)/(b),PDF11–12/p.1426(269–270),e definição13(3). Lei22/2022PDF2/p.2252(26) e Lei10/2025PDF13/p.2180(13) mantêm g/3 por remissão. Cobertura2026/MZN; abastecimentos importados na janela própria,consumidos ou a bordo de embarcação de navegação internacional marítima/fluvial/lacustre ou avião de navegação aérea internacional;exclusões próprias de provisões e depósitos normais. Sem exigir companhia principalmente internacional,sem dedução/campo11,direitos ou base aduaneira.';
export const importServiceVersion = 'import-included-services/1';
export const importInvestmentVersion = 'import-investment-equipment/1';
export const importDevelopmentVersion = 'import-un-development/1';
export const importDevelopmentSource = 'CIVA republicado Lei13/2016,12(2)(c),PDF11/p.1426(269): materiais/equipamentos de projectos de desenvolvimento financiados pelas agências e instituições especializadas das Nações Unidas,devidamente acreditadas junto do Governo Moçambicano,destinados exclusivamente à implementação dos projectos;isenção ou redução de IVA na mesma proporção da redução de direitos. Art12(4),PDF12/p.1426(270): despacho favorável do Ministro que superintende Finanças,requerimento prévio da entidade promotora com lista discriminada e plano de importações;concessão pelos serviços aduaneiros segundo o plano e após confronto com a lista aprovada. Lei22/2022PDF2–3 eLei10/2025PDF13 mantêm12(2)/4 por remissão. Cobertura2026/MZN;sem calcular direitos/base aduaneira/taxa normal ou dedução/campo11;pedido não equivale a concessão.';
export const importDevelopmentFields = [
['developmentProject','Projecto de desenvolvimento identificado'],
['developmentAgency','Agência ou instituição especializada das Nações Unidas e referência da acreditação'],
['developmentDecisionRef','Despacho favorável / pressuposto expresso da projecção'],
['developmentListRef','Lista discriminada aprovada / referência da previsão'],
['developmentPlanRef','Plano de importações / referência da previsão'],
['developmentScope','Âmbito nesta importação: bens, operação, período e condições abrangidos'],
['developmentRightsRef','Fundamento da isenção ou redução de direitos / pressuposto expresso'],
] as const;
const developmentConditions = [
['developmentMaterials','Os bens desta importação são materiais ou equipamentos do projecto de desenvolvimento identificado'],
['developmentUNFunding','O projecto é financiado pela agência ou instituição especializada das Nações Unidas identificada; não basta financiamento externo genérico'],
['developmentAccredited','A agência ou instituição especializada identificada está devidamente acreditada junto do Governo Moçambicano'],
['developmentExclusiveUse','Os materiais ou equipamentos destinam-se exclusivamente à implementação deste projecto'],
['developmentFavourableDecision','Existe despacho favorável do Ministro que superintende a área de Finanças para este âmbito, ou esse despacho é pressuposto expresso da projecção; requerimento apresentado não equivale a decisão favorável'],
['developmentPriorRequest','A entidade promotora apresentou requerimento prévio acompanhado de lista discriminada dos bens a importar e respectivo plano de importações, ou estes elementos são pressupostos expressos da projecção'],
['developmentCustomsConformity','A concessão pelos serviços aduaneiros para esta importação segue o plano e o confronto com a lista aprovada no despacho, ou tal conformidade é pressuposto expresso da projecção; não se estende a outros bens ou operações'],
] as const;
export const importInvestmentSource = 'CIVA republicado Lei13/2016,12(1)(k),PDF11/p.1426(269): importações de bens de equipamento classificados na classe K da Pauta Aduaneira destinados a investimentos em empreendimentos autorizados ao abrigo da Lei de Investimentos e respectivo Regulamento. Lei22/2022,PDF2/p.2252(26),e Lei10/2025,PDF13/p.2180(13),mantêm k por remissão. Cobertura2026/MZN; classificação do IVA desta importação nas condições próprias,sem conceder autorização de investimento,classificar automaticamente mercadorias,estender o âmbito da autorização,calcular direitos/base aduaneira ou dedução/campo11.';
export const importServiceSource = 'CIVA republicado Lei13/2016,12(1)(e),PDF11/p.1426(269): prestações de serviços cujo valor esteja incluído na base tributável da importação de bens,conforme16. Art16(1)/16(1)(b)/16(2),PDF14/p.1426(272): valor aduaneiro e despesas acessórias até primeiro destino,do documento de transporte ou,na falta,primeira ruptura de carga no interior do País. Lei22/2022PDF1–2 e Lei10/2025PDF12–13 mantêm e por remissão e não alteram16. Cobertura2026/MZN; IVA do serviço,sem calcular base aduaneira,direitos,IVA dos bens,dedução/campo11 ou rectificação automática de factura.';
export const importExemptionRules = [
{id:'un_development_exemption',branch:'P060',label:'Projecto de desenvolvimento ONU — isenção integral',article:'12(2)(c)/12(4)',conditions:[...developmentConditions,['developmentFullRightsExemption','Esta importação beneficia de isenção integral de direitos no fundamento identificado; uma redução parcial não equivale a isenção integral de IVA']]},
{id:'un_development_reduction',branch:'P060',label:'Projecto de desenvolvimento ONU — redução proporcional',article:'12(2)(c)/12(4)',conditions:[...developmentConditions,['developmentRightsReduction','Esta importação beneficia da redução parcial de direitos na percentagem identificada; não é uma taxa aduaneira nem a fracção de direitos ainda a pagar']]},
{id:'authorized_investment_equipment',branch:'P056',label:'Equipamento classe K para empreendimento autorizado',article:'12(1)(k)',conditions:[['investmentEquipment','Os bens importados são bens de equipamento; não basta uma compra de materiais, consumíveis ou serviços para um investimento'],['investmentClassK','Os bens de equipamento identificados estão classificados na classe K da Pauta Aduaneira; uma descrição genérica ou código isolado não é classificação automática pelo portal'],['investmentAuthorized','O empreendimento está autorizado ao abrigo da Lei de Investimentos e respectivo Regulamento; a referência identifica a autorização aplicável ou o pressuposto expresso da projecção, não apenas um pedido apresentado'],['investmentDestination','Estes bens destinam-se ao investimento no empreendimento autorizado identificado; a operação, período e condições correspondem ao âmbito aplicável da autorização, sem o estender automaticamente a outros bens ou operações']]},
{id:'service_in_customs_value',branch:'P050',label:"Serviço já compreendido no valor aduaneiro",article:'12(1)(e)',conditions:[["serviceImportLinked", "A prestação está ligada à importação de bens identificada na referência própria; não basta tratar-se de serviço prestado a um importador"], ["serviceFullValueIncluded", "O valor integral do serviço desta linha está incluído na base tributável da importação identificada, nos termos do artigo16; documento ou pressuposto discrimina a inclusão, não apenas a intenção de a incluir"], ["serviceInCustomsValue", "O valor deste serviço já está compreendido no valor aduaneiro que integra a base do artigo16(1); não é uma nova parcela a somar pelo simulador"]]},
{id:'accessory_service_first_destination',branch:'P050',label:"Serviço acessório até ao primeiro destino",article:'12(1)(e)',conditions:[["serviceImportLinked", "A prestação está ligada à importação de bens identificada na referência própria; não basta tratar-se de serviço prestado a um importador"], ["serviceFullValueIncluded", "O valor integral do serviço desta linha está incluído na base tributável da importação identificada, nos termos do artigo16; documento ou pressuposto discrimina a inclusão, não apenas a intenção de a incluir"], ["serviceAccessoryCost", "O serviço é uma despesa acessória da importação (embalagem, transporte, seguro ou outro encargo) adicionada à base por ainda não estar compreendida no valor aduaneiro, conforme16(1)(b)"], ["serviceToFirstDestination", "A despesa verifica-se até ao primeiro lugar de destino no interior do País: o constante do documento de transporte ou, na sua falta, o local da primeira ruptura de carga no interior do País, conforme16(2); destino e percurso identificados no fundamento"]]},
{id:'ship_provisions_import',branch:'P052',label:"Embarcação internacional — Provisões de bordo",article:'12(1)(g)',conditions:[["supplyInternationalShip", "A embarcação identificada efectua navegação marítima, fluvial ou lacustre internacional; não basta pertencer a uma empresa marítima"], ["supplyProvisions", "São provisões de bordo: produtos destinados exclusivamente ao consumo da tripulação e dos passageiros"], ["supplyImportWindow", "Os bens são importados desde a entrada no território nacional até à chegada ao porto ou aeroporto nacionais de destino, ou durante a permanência nesses locais pelo período normal necessário ao cumprimento das tarefas; trajecto e datas constam do fundamento"], ["supplyOnboard", "Os bens importados são consumidos ou encontram-se a bordo da embarcação ou avião identificados no fundamento factual"], ["supplyNoDismantleOtherUse", "As provisões não se encontram em embarcação a desmantelar ou utilizada para fins diferentes da navegação internacional, durante essa situação"], ["supplyNoFloatingHospitality", "As provisões não se encontram em embarcação utilizada em hotel, restaurante, sala de jogos flutuante ou fim semelhante, durante permanência em porto ou águas territoriais/interiores nacionais"], ["supplyNoRecreation", "As provisões não se encontram em embarcação de recreio durante permanência em porto ou águas territoriais/interiores nacionais"], ["supplyNoCoastalFishing", "As provisões não se encontram em embarcação de pesca costeira"]]},
{id:'ship_fuel_import',branch:'P052',label:"Embarcação internacional — Combustíveis ou carburantes",article:'12(1)(g)',conditions:[["supplyInternationalShip", "A embarcação identificada efectua navegação marítima, fluvial ou lacustre internacional; não basta pertencer a uma empresa marítima"], ["supplyFuel", "São combustíveis ou carburantes destinados ao funcionamento das máquinas de propulsão ou de outros aparelhos de uso técnico instalados a bordo"], ["supplyImportWindow", "Os bens são importados desde a entrada no território nacional até à chegada ao porto ou aeroporto nacionais de destino, ou durante a permanência nesses locais pelo período normal necessário ao cumprimento das tarefas; trajecto e datas constam do fundamento"], ["supplyOnboard", "Os bens importados são consumidos ou encontram-se a bordo da embarcação ou avião identificados no fundamento factual"], ["supplyNormalTanks", "Os combustíveis/carburantes importados são os contidos nos depósitos normais; depósitos suplementares ou externos não cumprem esta condição"]]},
{id:'ship_technical_products_import',branch:'P052',label:"Embarcação internacional — Lubrificantes e outros produtos de funcionamento técnico",article:'12(1)(g)',conditions:[["supplyInternationalShip", "A embarcação identificada efectua navegação marítima, fluvial ou lacustre internacional; não basta pertencer a uma empresa marítima"], ["supplyTechnicalProducts", "São lubrificantes ou outros produtos, distintos dos combustíveis/carburantes, destinados ao funcionamento das máquinas de propulsão ou de outros aparelhos de uso técnico instalados a bordo"], ["supplyImportWindow", "Os bens são importados desde a entrada no território nacional até à chegada ao porto ou aeroporto nacionais de destino, ou durante a permanência nesses locais pelo período normal necessário ao cumprimento das tarefas; trajecto e datas constam do fundamento"], ["supplyOnboard", "Os bens importados são consumidos ou encontram-se a bordo da embarcação ou avião identificados no fundamento factual"]]},
{id:'ship_cargo_accessories_import',branch:'P052',label:"Embarcação internacional — Produtos acessórios para mercadorias transportadas",article:'12(1)(g)',conditions:[["supplyInternationalShip", "A embarcação identificada efectua navegação marítima, fluvial ou lacustre internacional; não basta pertencer a uma empresa marítima"], ["supplyCargoAccessories", "São produtos acessórios destinados à preparação, tratamento e conservação das mercadorias transportadas a bordo"], ["supplyImportWindow", "Os bens são importados desde a entrada no território nacional até à chegada ao porto ou aeroporto nacionais de destino, ou durante a permanência nesses locais pelo período normal necessário ao cumprimento das tarefas; trajecto e datas constam do fundamento"], ["supplyOnboard", "Os bens importados são consumidos ou encontram-se a bordo da embarcação ou avião identificados no fundamento factual"]]},
{id:'aircraft_provisions_import',branch:'P052',label:"Avião internacional — Provisões de bordo",article:'12(1)(g)',conditions:[["supplyInternationalAircraft", "O avião identificado efectua navegação aérea internacional; não se exige que a companhia se dedique principalmente ao tráfego internacional neste ramo"], ["supplyProvisions", "São provisões de bordo: produtos destinados exclusivamente ao consumo da tripulação e dos passageiros"], ["supplyImportWindow", "Os bens são importados desde a entrada no território nacional até à chegada ao porto ou aeroporto nacionais de destino, ou durante a permanência nesses locais pelo período normal necessário ao cumprimento das tarefas; trajecto e datas constam do fundamento"], ["supplyOnboard", "Os bens importados são consumidos ou encontram-se a bordo da embarcação ou avião identificados no fundamento factual"]]},
{id:'aircraft_fuel_import',branch:'P052',label:"Avião internacional — Combustíveis ou carburantes",article:'12(1)(g)',conditions:[["supplyInternationalAircraft", "O avião identificado efectua navegação aérea internacional; não se exige que a companhia se dedique principalmente ao tráfego internacional neste ramo"], ["supplyFuel", "São combustíveis ou carburantes destinados ao funcionamento das máquinas de propulsão ou de outros aparelhos de uso técnico instalados a bordo"], ["supplyImportWindow", "Os bens são importados desde a entrada no território nacional até à chegada ao porto ou aeroporto nacionais de destino, ou durante a permanência nesses locais pelo período normal necessário ao cumprimento das tarefas; trajecto e datas constam do fundamento"], ["supplyOnboard", "Os bens importados são consumidos ou encontram-se a bordo da embarcação ou avião identificados no fundamento factual"], ["supplyNormalTanks", "Os combustíveis/carburantes importados são os contidos nos depósitos normais; depósitos suplementares ou externos não cumprem esta condição"]]},
{id:'aircraft_technical_products_import',branch:'P052',label:"Avião internacional — Lubrificantes e outros produtos de funcionamento técnico",article:'12(1)(g)',conditions:[["supplyInternationalAircraft", "O avião identificado efectua navegação aérea internacional; não se exige que a companhia se dedique principalmente ao tráfego internacional neste ramo"], ["supplyTechnicalProducts", "São lubrificantes ou outros produtos, distintos dos combustíveis/carburantes, destinados ao funcionamento das máquinas de propulsão ou de outros aparelhos de uso técnico instalados a bordo"], ["supplyImportWindow", "Os bens são importados desde a entrada no território nacional até à chegada ao porto ou aeroporto nacionais de destino, ou durante a permanência nesses locais pelo período normal necessário ao cumprimento das tarefas; trajecto e datas constam do fundamento"], ["supplyOnboard", "Os bens importados são consumidos ou encontram-se a bordo da embarcação ou avião identificados no fundamento factual"]]},
{id:'aircraft_cargo_accessories_import',branch:'P052',label:"Avião internacional — Produtos acessórios para mercadorias transportadas",article:'12(1)(g)',conditions:[["supplyInternationalAircraft", "O avião identificado efectua navegação aérea internacional; não se exige que a companhia se dedique principalmente ao tráfego internacional neste ramo"], ["supplyCargoAccessories", "São produtos acessórios destinados à preparação, tratamento e conservação das mercadorias transportadas a bordo"], ["supplyImportWindow", "Os bens são importados desde a entrada no território nacional até à chegada ao porto ou aeroporto nacionais de destino, ou durante a permanência nesses locais pelo período normal necessário ao cumprimento das tarefas; trajecto e datas constam do fundamento"], ["supplyOnboard", "Os bens importados são consumidos ou encontram-se a bordo da embarcação ou avião identificados no fundamento factual"]]},
{id:'special_economic_zone_import',branch:'P080',label:"Importação — Zona económica especial",article:'14(1)(a)',conditions:[["specialEconomicZone", "Os bens importados são colocados no regime de zona económica especial identificado no documento; a localização geográfica, por si só, não comprova o regime"], ["specialCustomsControl", "Esta importação encontra-se sob controlo alfandegário"], ["specialApplicableProvisions", "A importação está sujeita às disposições especificamente aplicáveis ao regime identificado; indicar no fundamento factual o regime e documento aplicáveis"], ["specialRegimePermanence", "Os bens permanecem sob o regime identificado no período desta classificação"], ["specialNoFinalUseConsumption", "Os bens não têm utilização nem consumo finais nas áreas mencionadas no regime"]]},
{id:'free_zone_import',branch:'P080',label:"Importação — Zona franca",article:'14(1)(a)',conditions:[["freeZone", "Os bens importados são colocados no regime de zona franca identificado no documento"], ["specialCustomsControl", "Esta importação encontra-se sob controlo alfandegário"], ["specialApplicableProvisions", "A importação está sujeita às disposições especificamente aplicáveis ao regime identificado; indicar no fundamento factual o regime e documento aplicáveis"], ["specialRegimePermanence", "Os bens permanecem sob o regime identificado no período desta classificação"], ["specialNoFinalUseConsumption", "Os bens não têm utilização nem consumo finais nas áreas mencionadas no regime"]]},
{id:'free_warehouse_import',branch:'P080',label:"Importação — Depósito franco",article:'14(1)(a)',conditions:[["freeWarehouse", "Os bens importados são colocados no regime de depósito franco identificado no documento"], ["specialCustomsControl", "Esta importação encontra-se sob controlo alfandegário"], ["specialApplicableProvisions", "A importação está sujeita às disposições especificamente aplicáveis ao regime identificado; indicar no fundamento factual o regime e documento aplicáveis"], ["specialRegimePermanence", "Os bens permanecem sob o regime identificado no período desta classificação"], ["specialNoFinalUseConsumption", "Os bens não têm utilização nem consumo finais nas áreas mencionadas no regime"]]},
{id:'general_free_warehouse_import',branch:'P080',label:"Importação — Depósito geral franco",article:'14(1)(a)',conditions:[["generalFreeWarehouse", "Os bens importados são colocados no regime de depósito geral franco identificado no documento"], ["specialCustomsControl", "Esta importação encontra-se sob controlo alfandegário"], ["specialApplicableProvisions", "A importação está sujeita às disposições especificamente aplicáveis ao regime identificado; indicar no fundamento factual o regime e documento aplicáveis"], ["specialRegimePermanence", "Os bens permanecem sob o regime identificado no período desta classificação"], ["specialNoFinalUseConsumption", "Os bens não têm utilização nem consumo finais nas áreas mencionadas no regime"]]},
{id:'customs_warehouse_import',branch:'P080',label:"Importação — Depósito de regime aduaneiro",article:'14(1)(a)',conditions:[["customsWarehouse", "Os bens importados são introduzidos no depósito de regime aduaneiro identificado no documento"], ["specialCustomsControl", "Esta importação encontra-se sob controlo alfandegário"], ["specialApplicableProvisions", "A importação está sujeita às disposições especificamente aplicáveis ao regime identificado; indicar no fundamento factual o regime e documento aplicáveis"], ["specialRegimePermanence", "Os bens permanecem sob o regime identificado no período desta classificação"], ["specialNoFinalUseConsumption", "Os bens não têm utilização nem consumo finais nas áreas mencionadas no regime"]]},
{id:'duty_free_shop_import',branch:'P080',label:"Importação — Loja franca",article:'14(1)(a)',conditions:[["dutyFreeShop", "Os bens importados são introduzidos na loja franca identificada no documento"], ["specialCustomsControl", "Esta importação encontra-se sob controlo alfandegário"], ["specialApplicableProvisions", "A importação está sujeita às disposições especificamente aplicáveis ao regime identificado; indicar no fundamento factual o regime e documento aplicáveis"], ["specialRegimePermanence", "Os bens permanecem sob o regime identificado no período desta classificação"], ["specialNoFinalUseConsumption", "Os bens não têm utilização nem consumo finais nas áreas mencionadas no regime"]]},
{id:'reimport_same_state',branch:'P049',label:'Reimportação por quem exportou, no mesmo estado',article:'12(1)(d)',conditions:[['sameExporter','A reimportação é efectuada por quem exportou os bens'],['sameState','Os bens regressam no mesmo estado em que foram exportados'],['customsExempt','Esta reimportação beneficia de isenção de direitos aduaneiros']]},
{id:'central_bank_gold',branch:'P051',label:'Importação de ouro pelo Banco de Moçambique',article:'12(1)(f)',conditions:[['gold','Os bens importados são ouro'],['centralBank','A importação é efectuada pelo Banco de Moçambique']]},
{id:'author_art_import',branch:'P055',label:'Objectos de arte pelos artistas-autores, herdeiros ou legatários',article:'12(1)(j)',conditions:[['artObjects','Os bens importados são objectos de arte'],['eligibleArtImporter','A importação é efectuada pelos próprios artistas-autores, residentes no território nacional, seus herdeiros ou legatários; a identidade, residência e relação aplicáveis estão identificadas no fundamento factual']]},
{id:'fire_brigade_vehicle',branch:'P057',label:'Veículo de combate a incêndios por corporação de bombeiros',article:'12(1)(l)',conditions:[['fireVehicle','O bem importado é um veículo de combate a incêndios'],['fireBrigade','A importação é efectuada por uma corporação de bombeiros'],['exclusiveOwnUse','O veículo destina-se exclusivamente a ser utilizado na actividade própria da corporação']]},
{id:'eligible_ship_import',branch:'P053',label:'Importação de embarcação elegível',article:'12(1)(h)',conditions:[['eligibleShip',internationalShipEligibility],['importedShip','O bem importado é a própria embarcação elegível identificada; não um serviço nem qualquer bem adquirido pelo operador']]},
{id:'ship_operation_object_import',branch:'P053',label:'Importação de objecto incorporado ou utilizado na exploração de embarcação elegível',article:'12(1)(h)',conditions:[['eligibleShip',internationalShipEligibility],['shipObjectLink','O objecto importado está incorporado na embarcação elegível identificada ou é utilizado na sua exploração; objecto, embarcação e ligação concreta identificados no documento ou pressuposto, não um fornecimento genérico ao operador']]},
{id:'eligible_aircraft_import',branch:'P054',label:'Importação de avião de companhia principalmente internacional',article:'12(1)(i)',conditions:[['eligibleAircraft',internationalAircraftEligibility],['importedAircraft','O bem importado é o próprio avião elegível identificado; não um serviço nem qualquer bem adquirido pela companhia']]},
{id:'aircraft_operation_object_import',branch:'P054',label:'Importação de objecto incorporado ou utilizado na exploração de avião elegível',article:'12(1)(i)',conditions:[['eligibleAircraft',internationalAircraftEligibility],['aircraftObjectLink','O objecto importado está incorporado no avião elegível identificado ou é utilizado na sua exploração; objecto, avião e ligação concreta identificados no documento ou pressuposto, não um fornecimento genérico à companhia']]},
{id:'customs_transit_import',branch:'P048',label:'Importação de bens em trânsito com isenção total de direitos',article:'12(1)(c)',conditions:[['customsTransit','Os bens identificados são importados sob regime de trânsito; regime e operação constam do documento ou pressuposto expresso, não apenas passagem geográfica'],['fullCustomsExemption','Esta importação beneficia de isenção total de direitos aduaneiros, identificada no fundamento factual; redução parcial ou mera suspensão não comprovam esta condição']]},
{id:'customs_temporary_import',branch:'P048',label:'Importação temporária de bens com isenção total de direitos',article:'12(1)(c)',conditions:[['customsTemporary','Os bens identificados são importados sob regime de importação temporária; regime e operação constam do documento ou pressuposto expresso, não apenas intenção de utilização temporária'],['fullCustomsExemption','Esta importação beneficia de isenção total de direitos aduaneiros, identificada no fundamento factual; redução parcial ou mera suspensão não comprovam esta condição']]},
{id:'customs_drawback_import',branch:'P048',label:'Importação de bens em draubaque com isenção total de direitos',article:'12(1)(c)',conditions:[['customsDrawback','Os bens identificados são importados sob regime de draubaque; regime e operação constam do documento ou pressuposto expresso, não qualquer promessa de restituição futura'],['fullCustomsExemption','Esta importação beneficia de isenção total de direitos aduaneiros, identificada no fundamento factual; redução parcial ou mera suspensão não comprovam esta condição']]},
] as const;
type Condition = 'developmentMaterials'|'developmentUNFunding'|'developmentAccredited'|'developmentExclusiveUse'|'developmentFavourableDecision'|'developmentPriorRequest'|'developmentCustomsConformity'|'developmentFullRightsExemption'|'developmentRightsReduction'|'investmentEquipment'|'investmentClassK'|'investmentAuthorized'|'investmentDestination'|'serviceImportLinked'|'serviceFullValueIncluded'|'serviceInCustomsValue'|'serviceAccessoryCost'|'serviceToFirstDestination'|'supplyCargoAccessories'|'supplyFuel'|'supplyImportWindow'|'supplyInternationalAircraft'|'supplyInternationalShip'|'supplyNoCoastalFishing'|'supplyNoDismantleOtherUse'|'supplyNoFloatingHospitality'|'supplyNoRecreation'|'supplyNormalTanks'|'supplyOnboard'|'supplyProvisions'|'supplyTechnicalProducts'|'specialEconomicZone'|'freeZone'|'freeWarehouse'|'generalFreeWarehouse'|'customsWarehouse'|'dutyFreeShop'|'specialCustomsControl'|'specialApplicableProvisions'|'specialRegimePermanence'|'specialNoFinalUseConsumption'|'sameExporter'|'sameState'|'customsExempt'|'gold'|'centralBank'|'artObjects'|'eligibleArtImporter'|'fireVehicle'|'fireBrigade'|'exclusiveOwnUse'|'eligibleShip'|'importedShip'|'shipObjectLink'|'eligibleAircraft'|'importedAircraft'|'aircraftObjectLink'|'customsTransit'|'customsTemporary'|'customsDrawback'|'fullCustomsExemption';
function beneficiaryImport(id:string):boolean {return id==='author_art_import'||id==='fire_brigade_vehicle';}
function assetImport(id:string):boolean {return ['eligible_ship_import','ship_operation_object_import','eligible_aircraft_import','aircraft_operation_object_import'].includes(id);}
function customsImport(id:string):boolean {return ['customs_transit_import','customs_temporary_import','customs_drawback_import'].includes(id);}
function specialRegimeImport(id:string):boolean {return ["special_economic_zone_import", "free_zone_import", "free_warehouse_import", "general_free_warehouse_import", "customs_warehouse_import", "duty_free_shop_import"].includes(id);}
function supplyImport(id:string):boolean {return ["ship_provisions_import", "ship_fuel_import", "ship_technical_products_import", "ship_cargo_accessories_import", "aircraft_provisions_import", "aircraft_fuel_import", "aircraft_technical_products_import", "aircraft_cargo_accessories_import"].includes(id);}
export function isImportService(id:string):boolean {return ['service_in_customs_value','accessory_service_first_destination'].includes(id);}
export function isDevelopmentImport(id:string):boolean {return ['un_development_exemption','un_development_reduction'].includes(id);}
export function importRuleSource(id:string):string {return isDevelopmentImport(id)?importDevelopmentSource:id==='authorized_investment_equipment'?importInvestmentSource:isImportService(id)?importServiceSource:supplyImport(id)?importSupplySource:specialRegimeImport(id)?importSpecialRegimeSource:customsImport(id)?importCustomsSource:assetImport(id)?importAssetSource:beneficiaryImport(id)?importBeneficiarySource:importExemptionSource;}
export type ImportExemptionRow = {id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';currency:string;declaredValue:string;goodsCode:string;originCountry:string;importer:string;documentRef:string;documentDate:string;evidence:string;conditions:Partial<Record<Condition,Choice>>;serviceImportRef?:string;serviceBaseRef?:string;serviceFirstDestination?:string;serviceProvider?:string;investmentAuthorizationRef?:string;investmentScope?:string} & Partial<Record<typeof importDevelopmentFields[number][0]|'developmentReductionPercent'|'developmentNormalVat'|'developmentNormalVatRef',string>>;
type ImportResult = {id:string;status:'exempt'|'reduced'|'not_applicable'|'indeterminate';importVat:string|null;serviceVat?:string|null;reason:string};
export type ImportExemptionCalculation = {version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:ImportExemptionRow[];rows:ImportResult[]};
export type ImportExemptionBook = {rows:ImportExemptionRow[];result?:ImportExemptionCalculation;history?:ImportExemptionCalculation[]};
type Store = {version:1;books:Record<string,unknown>;importExemptions?:Record<string,ImportExemptionBook>;[key:string]:unknown};
function store(draft:Record<string,unknown>):Store {
const value:Store=draft.modelo_a_snapshot?JSON.parse(String(draft.modelo_a_snapshot)):{version:1,books:{}};
if(value?.version!==1||!value.books||typeof value.books!=='object'||Array.isArray(value.books))throw new Error('Dados fiscais não recuperáveis; originais preservados, sem substituição.');
if(value.importExemptions!==undefined&&(!value.importExemptions||typeof value.importExemptions!=='object'||Array.isArray(value.importExemptions)))throw new Error('Importações guardadas não recuperáveis; originais preservados.');
for(const book of Object.values(value.importExemptions??{})) {
if(Array.isArray(book?.rows)&&book.rows.some(row=>row&&[...importDevelopmentFields.map(([key])=>key),'developmentReductionPercent','developmentNormalVat','developmentNormalVatRef'].some(key=>row[key as keyof ImportExemptionRow]!==undefined&&typeof row[key as keyof ImportExemptionRow]!=='string')))throw new Error('Referências do projecto de desenvolvimento não recuperáveis; originais preservados.');
if(Array.isArray(book?.rows)&&book.rows.some(row=>row&&['investmentAuthorizationRef','investmentScope'].some(key=>row[key as keyof ImportExemptionRow]!==undefined&&typeof row[key as keyof ImportExemptionRow]!=='string')))throw new Error('Referências do investimento não recuperáveis; originais preservados.');
if(Array.isArray(book?.rows)&&book.rows.some(row=>row&&['serviceImportRef','serviceBaseRef','serviceFirstDestination','serviceProvider'].some(key=>row[key as keyof ImportExemptionRow]!==undefined&&typeof row[key as keyof ImportExemptionRow]!=='string')))throw new Error('Referências do serviço associado à importação não recuperáveis; originais preservados.');
if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||['id','treatment','description','period','origin','currency','declaredValue','goodsCode','originCountry','importer','documentRef','documentDate','evidence'].some(k=>typeof row[k as keyof ImportExemptionRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de importação não recuperáveis; sem substituição por lista vazia.');
}
return value;
}
export function importExemptionBook(draft:Record<string,unknown>):ImportExemptionBook {return store(draft).importExemptions?.[acquisitionScope(draft)]??{rows:[]};}
export function saveImportExemptionBook(draft:Record<string,unknown>,book:ImportExemptionBook):string {
const current=store(draft),encoded=JSON.stringify({...current,importExemptions:{...current.importExemptions,[acquisitionScope(draft)]:book}});store({...draft,modelo_a_snapshot:encoded});return encoded;
}
export function newImportExemption(id:string,currency:string):ImportExemptionRow {return {id,treatment:'',description:'',period:'',origin:'projected',currency,declaredValue:'',goodsCode:'',originCountry:'',importer:'',documentRef:'',documentDate:'',evidence:'',conditions:{}};}
function validDate(value:string):boolean {const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateImportExemption(row:ImportExemptionRow,currency:unknown):ImportResult {
const result:ImportResult={id:row.id,status:'indeterminate',importVat:null,reason:'',...(isImportService(row.treatment)?{serviceVat:null}:{})};
const stop=(reason:string,status:ImportResult['status']='indeterminate')=>({...result,status,reason});
const rule=importExemptionRules.find(r=>r.id===row.treatment);
if(!rule)return stop('Escolha o ramo aplicável; referência desconhecida ou em falta não concede isenção.');
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto; valores conservados, sem conversão.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period))return stop(isImportService(row.treatment)?'Indique o período do serviço em2026; a importação é identificada separadamente, sem inferir o mês do orçamento.':'Indique o período da importação em2026; não é inferido do mês do orçamento.');
if(!['projected','effective'].includes(row.origin))return stop('Indique dados efectivos ou pressupostos de projecção.');
const failed=rule.conditions.filter(([key])=>row.conditions[key]==='no');
if(failed.length)return stop('Não se aplica esta isenção: '+failed.map(([,label])=>label).join('; ')+'. O IVA fora deste fundamento permanece por enquadrar, sem taxa presumida.','not_applicable');
const missing=rule.conditions.filter(([key])=>row.conditions[key]!=='yes');
if(missing.length)return stop('Condições por indicar: '+missing.map(([,label])=>label).join('; ')+'. Desconhecido não significa não aplicável nem IVA zero.');
if(isDevelopmentImport(row.treatment)&&importDevelopmentFields.some(([key])=>!row[key]?.trim()))return stop('Identifique projecto, agência/acreditação, despacho favorável, lista aprovada, plano, âmbito desta importação e fundamento aduaneiro, ou os pressupostos expressos da projecção. Reutilize as referências documentais disponíveis; não é exigido novo certificado.');
if(row.treatment==='authorized_investment_equipment'&&(!row.investmentAuthorizationRef?.trim()||!row.investmentScope?.trim()))return stop('Identifique a autorização aplicável ao empreendimento e o seu âmbito nesta importação, ou os pressupostos expressos da projecção. Um pedido em preparação ou apresentado não equivale a autorização.');
if(isImportService(row.treatment)&&(!row.serviceImportRef?.trim()||!row.serviceBaseRef?.trim()||!row.declaredValue.trim()||(row.treatment==='accessory_service_first_destination'&&!row.serviceFirstDestination?.trim())))return stop('Identifique a importação de bens, a referência da base que inclui o valor do serviço e o montante desta linha; no serviço acessório, indique o primeiro destino e o fundamento documental ou pressuposto.');
if(!row.description.trim()||!row.importer.trim()||!row.documentRef.trim()||!row.evidence.trim())return stop(isImportService(row.treatment)?'Identifique o serviço, importador destinatário, documento/previsão e fundamento factual da inclusão; sem exigir segunda validação da fonte oficial.':'Identifique bens, importador, documento aduaneiro ou previsão e o fundamento factual das condições; não é exigida segunda validação da fonte oficial.');
if(!validDate(row.documentDate))return stop('Data do documento/previsão em falta ou inválida; o período da importação é indicado separadamente.');
if(row.declaredValue.trim()&&!/^\d{1,15}(\.\d{1,6})?$/.test(row.declaredValue.trim()))return stop('Valor declarado/previsional inválido; conserve o original e reveja, sem presumir base aduaneira ou imposto normal.');
if(row.treatment==='un_development_reduction') {
const normal=developmentDecimal(row.developmentNormalVat),percent=developmentDecimal(row.developmentReductionPercent);
if(percent===null)return stop('Indique a percentagem da redução de direitos identificada no fundamento; não é inferida da taxa aduaneira, do financiador ou do valor dos bens.');
if(percent===0n)return stop('Redução de direitos de0% não concede benefício proporcional de IVA neste fundamento; não se presume o imposto normal.','not_applicable');
if(percent>=100000000n)return stop('A redução parcial deve ser superior a0% e inferior a100%; para isenção integral use o tratamento próprio e as suas condições.');
if(normal===null||!row.developmentNormalVatRef?.trim())return stop('Indique o IVA desta importação sem benefício e a sua referência documental ou pressuposto; montante desconhecido não é zero e o portal não presume taxa/base aduaneira.');
const vat=developmentExactMoney(normal*(100000000n-percent));
return {...result,status:'reduced',importVat:vat,reason:`Redução proporcional ${rule.article} nas condições ${row.origin==='projected'?'expressamente assumidas na projecção':'efectivas declaradas'}. IVA informado sem benefício ${row.developmentNormalVat}MZN × (1 − ${row.developmentReductionPercent}/100) = ${vat}MZN. Proporção da redução de direitos, não taxa de IVA; aritmética decimal exacta, sem arredondamento fiscal presumido. Não calcula direitos/base aduaneira nem dedução.`};
}
if(isImportService(row.treatment))return {...result,status:'exempt',serviceVat:'0.00',reason:`Isenção do serviço ${rule.article} nas condições ${row.origin==='projected'?'expressamente assumidas na projecção':'efectivas declaradas'}. IVA do serviço:0.00MZN; não é o IVA dos bens importados, não soma novamente o serviço à base nem corrige factura ou dedução.`};
return {...result,status:'exempt',importVat:'0.00',reason:`Isenção ${rule.article} nas condições ${row.origin==='projected'?'expressamente assumidas na projecção':'efectivas declaradas'}. IVA na importação:0.00MZN por isenção, sem inferir direitos aduaneiros, certificação pela AT ou dedução.`};
}
function developmentDecimal(raw:unknown):bigint|null {
if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;
const [whole,decimal='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(decimal.padEnd(6,'0'));
}
function developmentExactMoney(numerator:bigint):string {
const scale=100000000000000n;
return `${numerator/scale}.${(numerator%scale).toString().padStart(14,'0').replace(/0+$/,'').padEnd(2,'0')}`;
}
function key(draft:Record<string,unknown>,book:ImportExemptionBook):string {
const base={version:importExemptionVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows};
return JSON.stringify({...base,...(book.rows.some(row=>isDevelopmentImport(row.treatment))?{developmentVersion:importDevelopmentVersion}:{}),...(book.rows.some(row=>row.treatment==='authorized_investment_equipment')?{investmentVersion:importInvestmentVersion}:{}),...(book.rows.some(row=>beneficiaryImport(row.treatment))?{beneficiaryVersion:importBeneficiaryVersion}:{}),...(book.rows.some(row=>assetImport(row.treatment))?{assetVersion:importAssetVersion}:{}),...(book.rows.some(row=>customsImport(row.treatment))?{customsVersion:importCustomsVersion}:{}),...(book.rows.some(row=>specialRegimeImport(row.treatment))?{specialRegimeVersion:importSpecialRegimeVersion}:{}),...(book.rows.some(row=>supplyImport(row.treatment))?{supplyVersion:importSupplyVersion}:{}),...(book.rows.some(row=>isImportService(row.treatment))?{serviceVersion:importServiceVersion}:{})});
}
export function importExemptionCurrent(draft:Record<string,unknown>,book:ImportExemptionBook):boolean {return !!book.result&&book.result.sourceKey===key(draft,book);}
export function recordImportExemptions(draft:Record<string,unknown>,book:ImportExemptionBook):ImportExemptionBook {
if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Indique importações com identificadores distintos; versões anteriores conservadas.');
const result:ImportExemptionCalculation={version:importExemptionVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:[...new Set(book.rows.map(row=>importRuleSource(row.treatment)))].join(' | '),inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateImportExemption(row,draft.currency))};
return {...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};
}
export function importExemptionReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]> {
try {
const book=importExemptionBook(draft),result=book.result;if(!result)return [];
const context=`${result.opportunity}; ${result.location}; ${importExemptionCurrent(draft,book)?'Resultado actual':'Entradas alteradas; resultado histórico conservado'}; versão${result.revision}; ${result.calculatedAt}; ${result.source}`;
return result.inputs.map((row,index)=>['IVA mensal',`${isImportService(row.treatment)?'Serviço associado à importação':'Importação'} ${importExemptionRules.find(r=>r.id===row.treatment)?.branch??row.treatment} — ${row.period} — ${row.id}`,`${row.description}; ${isImportService(row.treatment)?'IVA do serviço':'IVA na importação'}: ${(isImportService(row.treatment)?result.rows[index].serviceVat:result.rows[index].importVat)??'Indeterminado'} ${row.currency}; ${result.rows[index].reason}`,`${context}; ${row.origin==='projected'?'Projecção':'Dados efectivos declarados'}; importador ${row.importer}; valor declarado/previsional ${row.declaredValue||'Não informado'} ${row.currency}, sem fixar base aduaneira; ${isImportService(row.treatment)?`importação associada ${row.serviceImportRef||'por indicar'}; base com inclusão do serviço ${row.serviceBaseRef||'por indicar'}; prestador ${row.serviceProvider||'por indicar'}${row.treatment==='accessory_service_first_destination'?`; primeiro destino ${row.serviceFirstDestination||'por indicar'}`:''}`:`código ${row.goodsCode||'não indicado'}; origem ${row.originCountry||'não indicada'}`}${row.treatment==='authorized_investment_equipment'?`; autorização/pressuposto ${row.investmentAuthorizationRef||'por indicar'}; âmbito aplicável ${row.investmentScope||'por indicar'}`:''}${isDevelopmentImport(row.treatment)?`; ${importDevelopmentFields.map(([key,label])=>label+': '+(row[key]||'por indicar')).join('; ')}${row.treatment==='un_development_reduction'?`; redução dos direitos ${row.developmentReductionPercent||'por indicar'}%; IVA informado sem benefício ${row.developmentNormalVat||'por indicar'} ${row.currency}; referência do IVA sem benefício ${row.developmentNormalVatRef||'por indicar'}`:''}`:''}; documento ${row.documentRef},${row.documentDate}; condições ${(importExemptionRules.find(rule=>rule.id===row.treatment)?.conditions??[]).map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')}; fundamento factual ${row.evidence}; campo11 e totaisModeloA não preenchidos por esta classificação.`]);
}catch {return [['IVA mensal','Importações','Dados não recuperáveis','Originais preservados; sem substituir por zero.']];}
}
@@ -0,0 +1,32 @@
import type { OperationTreatment } from './iva-operations.ts';
const source = 'CIVA republicado Lei13/2016, BR156/10.º suplemento, art.13(1)(c/d/f/g/i), PDF12/p.1426(270); art.19(1)(b)(i), PDF15/p.1426(273). Lei22/2022 art.1, PDF3/p.2252(27), e Lei10/2025 art.1, PDF12–13/p.2180(12)–(13), mantêm19(1)(b)(i), sem alterar13. Âmbito2026/MZN; sem dedução automática de compras ou submissãoAT.';
const scope = 'Operação abrangida pelo CIVA em Moçambique, com territorialidade identificada; não basta o sector, a localização do investimento ou a residência estrangeira do cliente';
const ship = 'Embarcação identificada, afecta a navegação marítima em alto mar com transporte remunerado de passageiros ou actividade comercial, industrial ou de pesca; ou a salvamento, assistência marítima ou pesca costeira, nos termos de13(1)(c/d). A natureza e utilização constam do documento ou pressuposto; não qualquer barco de recreio';
const aircraft = 'Avião identificado e utilizado por companhia de navegação aérea que se dedica principalmente ao tráfego internacional; companhia e utilização identificadas, não bastando um voo internacional isolado';
export const internationalShipEligibility = ship;
export const internationalAircraftEligibility = aircraft;
const make=(id:string,label:string,letter:string,conditions:string[]):OperationTreatment=>({id,label,field:'05',rate:0,article:`CIVA arts.13(1)(${letter}),19(1)(b)(i)`,source,logicVersion:'international-assets/1',conditions:[scope,...conditions]});
export const internationalAssetTreatments:OperationTreatment[] = [
make('international_ship_operations','Operações sobre embarcação elegível e objectos da sua exploração','f',[
ship,
'Operação identificada: transmissão, transformação, reparação, manutenção, frete ou aluguer da embarcação; ou transmissão, aluguer, reparação ou conservação de objectos incorporados ou utilizados na sua exploração, incluindo equipamento de pesca',
'A operação e o objecto estão ligados à embarcação elegível identificada; não qualquer venda ou serviço a uma empresa marítima',
]),
make('international_aircraft_operations','Operações sobre avião de companhia principalmente internacional','g',[
aircraft,
'Operação identificada: transmissão, transformação, reparação, manutenção, frete ou aluguer do avião; ou transmissão, reparação ou manutenção de objectos nele incorporados ou utilizados na sua exploração. Não estender o aluguer do avião ao aluguer autónomo de objectos não enumerado nesta alínea',
'A operação e o objecto estão ligados ao avião elegível identificado; não qualquer fornecimento à companhia aérea',
]),
make('international_ship_direct_services','Serviços para necessidades directas de embarcação elegível ou sua carga','i',[
ship,
'Prestação de serviços identificada e efectuada para necessidades directas da embarcação elegível ou da respectiva carga, com ligação concreta descrita; não qualquer serviço ao armador',
'Serviço distinto dos já mencionados em13(1)(f/g); confirme a natureza específica, sem duplicar o enquadramento das operações sobre embarcação ou avião',
]),
make('international_aircraft_direct_services','Serviços para necessidades directas de avião elegível ou sua carga','i',[
aircraft,
'Prestação de serviços identificada e efectuada para necessidades directas do avião elegível ou da respectiva carga, com ligação concreta descrita; não qualquer serviço à companhia aérea',
'Serviço distinto dos já mencionados em13(1)(f/g); confirme a natureza específica, sem duplicar o enquadramento das operações sobre embarcação ou avião',
]),
];
+81
View File
@@ -0,0 +1,81 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const listedServiceVersion='listed-nondigital-services/1';
export const listedServiceSource='CIVA2(1)a/b,2(2),6(3),6(7)a–j e6(8),Lei13/2016PDF6–8/p1426(264–266);obrigações23(1)/(2),25(4),26(1–3),2016PDF16–17;Lei10/2025PDF12mantém alíneasa–j ealtera6(7)/(8)/(9),PDF13art23(2)excluik,PDF14mantém26(1–3),adita26(4)digital ealtera33(2). Recorte2026,não digital. Regime digital/P121 eoutros6(4)/(5)seguem percurso próprio. Localização/obrigações não confirmam isenção,taxa,IVA,dedução/campo11 ou montante a pagar.';
export const listedServiceTreatments=[
{id:'rights_service',branch:'P111',clause:'a',label:'P111 — Direitos de autor,patentes,licenças e marcas'},
{id:'advertising_service',branch:'P112',clause:'b',label:'P112 — Publicidade'},
{id:'telecom_service',branch:'P113',clause:'c',label:'P113 — Telecomunicações'},
{id:'consulting_service',branch:'P114',clause:'d',label:'P114 — Consultoria,engenharia,advocacia,economia e contabilidade'},
{id:'data_service',branch:'P115',clause:'e',label:'P115 — Tratamento de dados e informações'},
{id:'finance_service',branch:'P116',clause:'f',label:'P116 — Banca,finanças,seguro e resseguro'},
{id:'staff_service',branch:'P117',clause:'g',label:'P117 — Colocação de pessoal'},
{id:'intermediation_service',branch:'P118',clause:'h',label:'P118 — Intermediação em nome e por conta de outrem'},
{id:'abstention_service',branch:'P119',clause:'i',label:'P119 — Obrigação de não exercer actividade ou direito'},
{id:'movable_lease_service',branch:'P120',clause:'j',label:'P120 — Locação de bens móveis corpóreos e financeira'},
] as const;
export const listedServiceConditions=[['serviceSupply','Está identificada uma prestação de serviços desta operação e período'],['nonDigital','A natureza foi conferida:este caso não é bem/serviço digital abrangido por6(7)k/6(9)/26(4)'],['placeRulesExcluded','Foram conferidas as regras de imóveis,trabalhos em móveis,actividades e transporte6(4)/(5):não exigem outro percurso neste caso']] as const;
export const listedOwnConditions={
rights_service:[['rightsNature','Cessão ou autorização para utilizar direitos de autor,licenças,marcas de fábrica/comércio ou outros direitos análogos identificados']],
advertising_service:[['advertisingNature','Serviço de publicidade identificado']],
telecom_service:[['telecomNature','Serviço de telecomunicações identificado']],
consulting_service:[['consultingNature','Consultores,engenheiros,advogados,economistas,contabilistas ou gabinetes de estudo,organização,investigação e desenvolvimento ou domínio similar identificado']],
data_service:[['dataNature','Tratamento de dados ou fornecimento de informações identificado']],
finance_service:[['financeNature','Operação bancária,financeira,de seguro ou resseguro identificada;localização não determina a eventual isenção']],
staff_service:[['staffNature','Colocação de pessoal identificada']],
intermediation_service:[['intermediaryNature','Intermediário intervém em nome e por conta de outrem no fornecimento de serviço enumerado neste número']],
abstention_service:[['abstentionNature','Obrigação de não exercer,mesmo parcialmente,actividade profissional ou direito mencionado nas alíneas deste número']],
movable_lease_service:[['leaseNature','Locação de bens móveis corpóreos,incluindo locação financeira,com bens e contrato identificados']],
} as const;
export function ownListedConditions(treatment:string):ReadonlyArray<readonly[string,string]>{return listedOwnConditions[treatment as keyof typeof listedOwnConditions]??[];}
type Choice=''|'yes'|'no';type Condition=typeof listedServiceConditions[number][0];
export type ListedServiceRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';operationDate:string;operationRef:string;documentRef:string;documentDate:string;providerPlace:string;providerCountry:string;providerRef:string;buyerPlace:string;buyerCountry:string;buyerRef:string;recipientType:string;recipientRef:string;providerTaxable:string;providerTaxRef:string;useRef:string;subjectRef:string;targetClause:string;targetRef:string;scope:string;evidence:string;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';territory:'national'|'outside'|null;responsible:'acquirer'|'provider'|'outside'|'indeterminate';obligationReason:string;baseAmount:null;vat:null;rate:null;reason:string};
export type ListedServiceCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:ListedServiceRow[];rows:LineResult[]};
export type ListedServiceBook={rows:ListedServiceRow[];result?:ListedServiceCalculation;history?:ListedServiceCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{listedServices?:Record<string,ListedServiceBook>};
export function newListedService(id:string):ListedServiceRow{return{id,treatment:'',description:'',period:'',origin:'projected',operationDate:'',operationRef:'',documentRef:'',documentDate:'',providerPlace:'',providerCountry:'',providerRef:'',buyerPlace:'',buyerCountry:'',buyerRef:'',recipientType:'',recipientRef:'',providerTaxable:'',providerTaxRef:'',useRef:'',subjectRef:'',targetClause:'',targetRef:'',scope:'',evidence:'',conditions:{}};}
export function switchListedTreatment(row:ListedServiceRow,treatment:string):ListedServiceRow{return{...row,treatment,conditions:Object.fromEntries(listedServiceConditions.map(([key])=>[key,row.conditions[key]??'']))};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.listedServices!==undefined&&(!store.listedServices||typeof store.listedServices!=='object'||Array.isArray(store.listedServices)))throw new Error('Serviços enumerados não recuperáveis;originais preservados.');
const fields=Object.keys(newListedService('')).filter(key=>key!=='conditions');
for(const book of Object.values(store.listedServices??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof ListedServiceRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de serviços enumerados não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function listedServiceBook(draft:Record<string,unknown>):ListedServiceBook{return readStore(draft).listedServices?.[acquisitionScope(draft)]??{rows:[]};}
export function saveListedServiceBook(draft:Record<string,unknown>,book:ListedServiceBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,listedServices:{...current.listedServices,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateListedService(row:ListedServiceRow):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',territory:null,responsible:'indeterminate',obligationReason:'Responsável indeterminado;sem obrigação ou montante presumido.',baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
const rule=listedServiceTreatments.find(t=>t.id===row.treatment);if(!rule)return stop('Identifique o serviço enumerado,não digital,e a natureza efectiva da operação.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||!validDate(row.operationDate)||row.operationDate.slice(0,7)!==row.period)return stop('Identifique mês2026,data correspondente e dados efectivos ou pressupostos expressos.');
const required=[...listedServiceConditions,...ownListedConditions(row.treatment)];
if(required.some(([key])=>row.conditions[key]==='no'))return stop('Este percurso não se aplica:conferir natureza digital,regra territorial própria ou tratamento indicado;nenhum IVAzero/isenção presumido.','not_applicable');
if(required.some(([key])=>row.conditions[key]!=='yes'))return stop('Natureza ou regra própria por esclarecer;desconhecido não é fora do território,isenção ou IVAzero.');
if(!row.description.trim()||!row.operationRef.trim()||!row.documentRef.trim()||!validDate(row.documentDate)||!row.scope.trim()||!row.evidence.trim()||!row.useRef.trim()||!row.subjectRef.trim())return stop('Identifique serviço,objecto,destinatário/utilização,operação,documento/data,âmbito e factos ou pressupostos expressos;reutilize referências,sem certificado/aprovador novo.');
if(['intermediation_service','abstention_service'].includes(row.treatment)&&(!'abcdefghij'.includes(row.targetClause)||row.targetClause.length!==1||row.targetClause===rule.clause||!row.targetRef.trim()))return stop('Identifique o serviço/direito/actividade subjacente e a sua alínea de6(7),com referência;digitalk exige percurso próprio,não presumir pelo título.');
if(!['MZ','foreign'].includes(row.buyerCountry)||!row.buyerPlace.trim()||!row.buyerRef.trim())return stop('Identifique o estabelecimento estável ou domicílio do adquirente,país e referência correspondentes,não apenas nacionalidade.');
if(row.buyerCountry==='foreign')return{...result,status:'determined',territory:'outside',responsible:'outside',obligationReason:'Artigo6(8):fora do âmbito territorial de Moçambique;sem obrigação nacional calculada por este percurso ou imposto estrangeiro presumido.',reason:`${rule.branch}:6(8),Lei10/2025PDF12,adquirente estabelecido ou domiciliado no estrangeiro;serviço6(7)${rule.clause} não tributável neste âmbito,ainda que prestador tenha sede/EP/domicílio nacional. Não é concessão de isenção nem IVAzero;sem dedução/campo11 ou imposto estrangeiro presumido.`};
if(!['MZ','foreign'].includes(row.providerCountry)||!row.providerPlace.trim()||!row.providerRef.trim())return stop('Identifique sede/EP/domicílio do prestador a partir do qual o serviço é prestado,país e referência.');
if(row.providerCountry==='foreign'){
if(row.recipientType==='other')return stop('Adquirente não corresponde a2(1)a/b:6(7)não demonstrado por este percurso;conferir outra regra aplicável,sem classificar automaticamente fora do território.','not_applicable');
if(!['a','b'].includes(row.recipientType)||!row.recipientRef.trim())return stop('Identifique qualidade do adquirente2(1)a/b e referência;inclui quem pratica exclusivamente operações isentas sem direito à dedução,não exigir direito à dedução.');
return{...result,status:'determined',territory:'national',responsible:'acquirer',obligationReason:'Adquirente sujeito passivo2(2)/6(7)/23(2),redacção2025:entrega declaração33(2)eimposto exigível,nos termos a regulamentar. Não se aplica26(4)digital,nem prazo32(1)c digital a este caso. Eventual isenção/taxa/montante eprocedimento de pagamento não são apurados aqui.',reason:`${rule.branch}:6(7)${rule.clause},prestador estrangeiro sem sede/EP/domicílio nacional a partir do qual presta;adquirente2(1)${row.recipientType} comEP/domicílio nacional,mesmo que pratique exclusivamente operações isentas sem dedução. Localização nacional não confirma isenção,IVA ou dedução/campo11.`};
}
const liable=row.providerTaxable==='yes'&&!!row.providerTaxRef.trim();
return{...result,status:'determined',territory:'national',responsible:liable?'provider':'indeterminate',obligationReason:liable?'Prestador sujeito passivo no regime geral:23(1),sem activação automática de cobrança;eventual isenção,taxa,IVA eapuramento independentes.':'Localização6(3)determinada;qualidade fiscal do prestador ou referência por esclarecer,sem atribuir obrigação automaticamente.',reason:`${rule.branch}:6(3),prestador comsede/EP/domicílio nacional a partir do qual presta eadquirente nacional,sem regras6(4)/(5)ou digitais aplicáveis. Qualidade do adquirente2(1)a/b não é pré-condição deste percurso doméstico. Localização não concede isenção nem calculaIVA/dedução.`};
}
function key(draft:Record<string,unknown>,book:ListedServiceBook):string{return JSON.stringify({version:listedServiceVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},rows:book.rows});}
export function listedServiceCurrent(draft:Record<string,unknown>,book:ListedServiceBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordListedServices(draft:Record<string,unknown>,book:ListedServiceBook):ListedServiceBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:ListedServiceCalculation={version:listedServiceVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:listedServiceSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateListedService(row))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveListedServiceBook(draft,next);return next;
}
export function listedServiceReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=listedServiceBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>{const line=result.rows[index];return['IVA mensal',`Serviço ${listedServiceTreatments.find(t=>t.id===row.treatment)?.branch??'enumerado'} — ${row.period} — ${row.id}`,`${row.description};classificação territorial: ${line.territory==='national'?'Moçambique':line.territory==='outside'?'Fora do território nacional':'Indeterminada'};IVA: Indeterminado;${line.reason};responsável: ${line.responsible==='acquirer'?'Adquirente':line.responsible==='provider'?'Prestador':line.responsible==='outside'?'Fora deste âmbito':'Indeterminado'};${line.obligationReason}`,`${result.opportunity};${result.location};${listedServiceCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${listedServiceTreatments.find(t=>t.id===row.treatment)?.label??'Percurso por indicar'};operação ${row.operationRef},${row.operationDate};prestador ${row.providerPlace},${row.providerCountry},${row.providerRef};adquirente ${row.buyerPlace},${row.buyerCountry},${row.buyerRef};${row.buyerCountry==='MZ'&&row.providerCountry==='foreign'?`qualidade adquirente2(1)${row.recipientType},${row.recipientRef};`:''}${row.buyerCountry==='MZ'&&row.providerCountry==='MZ'?`qualidade prestador ${row.providerTaxable},${row.providerTaxRef};`:''}objecto ${row.subjectRef};destinatário/utilização ${row.useRef};${['intermediation_service','abstention_service'].includes(row.treatment)?`subjacente6(7)${row.targetClause},${row.targetRef};`:''}âmbito ${row.scope};documento ${row.documentRef},${row.documentDate};condições ${[...listedServiceConditions,...ownListedConditions(row.treatment)].map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};sem isenção/IVA/campo11/totaisModeloA.`];});}
catch{return[['IVA mensal','Serviços enumerados','Dados não recuperáveis','Originais preservados;sem classificação por defeito.']];}
}
+100
View File
@@ -0,0 +1,100 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const minerVersion='miner-imports/1';
export const minerSource='Lei n.º2/2011,de11/01:Regime Aduaneiro Aplicável aos Mineiros na República da África do Sul;BR1-I,4.ºsuplemento,arts1–4PDF1(sem número impresso),art5PDF2/p110-(8). OriginalMCNet149:Lei-2-2011-BR-1-4-suplemento-MCNet.pdf;ficheiro conjunto,não regra da Lei do Voluntariado. Decreto3/2011,de16/03,arts1–8,BR11-I,PDF2–3/p152–153. CIVA12(2)b,2016PDF11/p1426(269),mantido2022/2025:IVA na proporção da redução de direitos. Âmbito demonstradoRSA/2026/MZN;sem direitos,base aduaneira ou dedução.';
type Choice=''|'yes'|'no';
export const minerTreatments=[
{id:'baggage',label:'Bagagem sem fins comerciais',article:'Lei2/2011,2(1)a;Decreto3/2011,1b/3(1)a',conditions:[['personalBaggage','Objectos pessoais pertencentes ao mineiro durante a estadia na RSA,em quantidades razoáveis e sem fins comerciais']]},
{id:'monthly',label:'Remessa mensal',article:'Lei2/2011,2(1)c;Decreto3/2011,1e/3(1)b',conditions:[['ownedRSA','Bens pertencentes ao mineiro,adquiridos na RSA,para uso próprio ou da família'],['route','Remessa por empresa licenciada ou por meios próprios quando acompanhada pelo mineiro']]},
{id:'accumulated',label:'Remessas acumuladas até seis meses',article:'Decreto3/2011,4',conditions:[['ownedRSA','Bens pertencentes ao mineiro,adquiridos na RSA,para a família'],['licensedCompany','Remessa acumulada por empresa transportadora/distribuidora autorizada'],['unusedMonths','Meses e saldo indicados não foram usados noutras remessas;conferir o registo completo']]},
{id:'appliance',label:'Um electrodoméstico de cada tipo por ano',article:'Lei2/2011,2(1)b;Decreto3/2011,3(1)c/8(3)',conditions:[['oneAppliance','Um único electrodoméstico do tipo identificado nesta linha'],['annualQuota','Não foi usado este direito para o mesmo tipo/ano,incluindo fora deste dossier']]},
{id:'vehicle',label:'Veículo ou tractor e alfaias — direito em cinco anos',article:'Lei2/2011,2(1)d/2;Decreto3/2011,3(1)d/6(3)/(8)/(9)/8(3)',conditions:[['oneVehicle','Um veículo automóvel OU um tractor agrícola com respectivas alfaias,identificado nesta linha'],['vehicleQuota','Direito identificado disponível:um veículo e um tractor/alfaias em cada cinco anos,considerando benefícios usados fora deste dossier'],['noAlienation','Sem alienação antes de cinco anos da importação;incumprimento exige pagamento das imposições,não regularização automática pelo simulador']]},
{id:'return_baggage',label:'Bagagem no fim do contrato e regresso definitivo',article:'Lei2/2011,2(3);Decreto3/2011,6(1)',conditions:[['endContract','Contrato de trabalho terminado e regresso definitivo ao País'],['personalBaggage','Bens abrangidos pelo conceito de bagagem,identificados e sem finalidade comercial']]},
{id:'return_vehicle',label:'Veículo/tractor no regresso,como bagagem',article:'Decreto3/2011,6(1)–(3)/(5)–(9)',conditions:[['endContract','Contrato terminado e regresso definitivo'],['oneVehicle','Um veículo OU tractor agrícola e alfaias,identificado como bagagem'],['vehicleQuota','Direito disponível,sem nova isenção/redução antes de cinco anos do benefício anterior aplicável'],['noAlienation','Respeitar a restrição de alienação durante cinco anos da importação']]},
{id:'separate_vehicle',label:'Veículo separado da bagagem — redução de 50%',article:'Decreto3/2011,6(3)–(9)',conditions:[['endContract','Contrato terminado e regresso definitivo'],['oneVehicle','Veículo novo ou usado separado da bagagem identificado como substituição do benefício do regresso'],['substitution','Tratamento excepcional de separado de bagagem concedido para este veículo/âmbito,ou pressuposto expresso da projecção;pedido não equivale a concessão'],['vehicleQuota','Direito disponível,sem repetir benefício de veículo antes de cinco anos'],['noAlienation','Respeitar restrição de alienação durante cinco anos']]},
] as const;
export const minerCommon=[['national','Beneficiário originário de nacionalidade moçambicana'],['rsa','Serviço nas minas da República da África do Sul abrangido pelos acordos de trabalho migratório'],['contract','Contrato regular visado pelo Ministério do Trabalho de Moçambique,com referência identificada'],['noAlcoholTobacco','Linha não inclui bebidas alcoólicas nem tabaco;separar esses bens,excluídos pela Lei2/2011art3']] as const;
type Condition=typeof minerCommon[number][0]|typeof minerTreatments[number]['conditions'][number][0]|'heir'|'unusedRight'|'acquiredAlive'|'stayException'|'deadlineExtension';
export type MinerRow={id:string;treatment:string;description:string;period:string;currency:string;origin:'projected'|'effective';beneficiary:string;contractRef:string;documentRef:string;documentDate:string;scope:string;evidence:string;conditions:Partial<Record<Condition,Choice>>;rightHolder:''|'miner'|'heir';deathDate:string;requestDate:string;heirRef:string;importDate:string;route:''|'accompanied'|'company'|'declaration';customsRef:string;customsScope:string;quantity:string;kind:string;value:string;periodTotal:string;quotaRef:string;accumulationStart:string;accumulationMonths:string;arrivalDate:string;stayStart:string;stayEnd:string;exceptionRef:string;extensionRef:string;previousBenefit:''|'none'|'known';previousBenefitDate:string;normalVat:string;normalVatRef:string;};
type Line={id:string;status:'exempt'|'reduced'|'not_applicable'|'indeterminate';importVat:string|null;deduction:null;source:string;reason:string;};
export type MinerCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;sourceKey:string;source:string;inputs:MinerRow[];rows:Line[]};
export type MinerBook={rows:MinerRow[];result?:MinerCalculation;history?:MinerCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{minerImports?:Record<string,MinerBook>};
export function newMiner(id:string,currency:string):MinerRow{return{id,treatment:'',description:'',period:'',currency,origin:'projected',beneficiary:'',contractRef:'',documentRef:'',documentDate:'',scope:'',evidence:'',conditions:{},rightHolder:'',deathDate:'',requestDate:'',heirRef:'',importDate:'',route:'',customsRef:'',customsScope:'',quantity:'',kind:'',value:'',periodTotal:'',quotaRef:'',accumulationStart:'',accumulationMonths:'',arrivalDate:'',stayStart:'',stayEnd:'',exceptionRef:'',extensionRef:'',previousBenefit:'',previousBenefitDate:'',normalVat:'',normalVatRef:''};}
export function minerVehicle(id:string):boolean{return['vehicle','return_vehicle','separate_vehicle'].includes(id);}
export function minerReturn(id:string):boolean{return['return_baggage','return_vehicle','separate_vehicle'].includes(id);}
function readStore(draft:Record<string,unknown>):Store{const s=readAcquisitionStore(draft.modelo_a_snapshot) as Store;const fields=Object.keys(newMiner('','')).filter(k=>k!=='conditions');if(s.minerImports!==undefined&&(!s.minerImports||typeof s.minerImports!=='object'||Array.isArray(s.minerImports)))throw new Error('Importações dos mineiros não recuperáveis;originais preservados.');for(const b of Object.values(s.minerImports??{}))if(!b||!Array.isArray(b.rows)||(b.history!==undefined&&!Array.isArray(b.history))||b.rows.some(r=>!r||fields.some(k=>typeof r[k as keyof MinerRow]!=='string')||!r.conditions||typeof r.conditions!=='object'||Array.isArray(r.conditions)))throw new Error('Linhas dos mineiros não recuperáveis;sem substituição por lista vazia.');return s;}
export function minerBook(draft:Record<string,unknown>):MinerBook{return readStore(draft).minerImports?.[acquisitionScope(draft)]??{rows:[]};}
export function saveMinerBook(draft:Record<string,unknown>,book:MinerBook):string{const s=readStore(draft),encoded=JSON.stringify({...s,minerImports:{...s.minerImports,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function date(raw:string):Date|null{const d=new Date(raw+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(raw)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===raw?d:null;}
function anniversary(raw:string,years:number):string{const d=date(raw)!;d.setUTCFullYear(d.getUTCFullYear()+years);return d.toISOString().slice(0,10);}
export function minerNeedsDeadlineExtension(row:MinerRow):boolean{const a=date(row.arrivalDate),r=date(row.requestDate);return minerReturn(row.treatment)&&row.rightHolder==='miner'&&!!a&&!!r&&(r.getTime()-a.getTime())/86400000>90;}
export function minerNeedsStayException(row:MinerRow):boolean{return row.treatment==='separate_vehicle'&&!!date(row.stayStart)&&!!date(row.stayEnd)&&row.stayEnd<anniversary(row.stayStart,1);}
function decimal(raw:string):bigint|null{if(!/^\d{1,15}(\.\d{1,6})?$/.test(raw))return null;const[w,f='']=raw.split('.');return BigInt(w)*1000000n+BigInt(f.padEnd(6,'0'));}
function half(raw:bigint):string{const n=raw*5n;return`${n/10000000n}.${(n%10000000n).toString().padStart(7,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
export function evaluateMiner(row:MinerRow,currency:unknown):Line{
const rule=minerTreatments.find(t=>t.id===row.treatment),result:Line={id:row.id,status:'indeterminate',importVat:null,deduction:null,source:minerSource+(rule?';'+rule.article:''),reason:''};const stop=(reason:string,status:Line['status']='indeterminate')=>({...result,status,reason});
if(!rule)return stop('Escolha percurso documentado do regimeRSA;outros países,importações temporárias ou benefício diferente permanecem por enquadrar,não são automaticamente isentos.');
if(currency!=='MZN'||row.currency!==currency||!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!date(row.importDate)||row.importDate.slice(0,7)!==row.period)return stop('Indique moedaMZN e data/período coerentes da importação2026;sem conversão ou datas presumidas.');
if(!['projected','effective'].includes(row.origin)||![row.beneficiary,row.description,row.contractRef,row.documentRef,row.scope,row.evidence,row.customsRef,row.customsScope].every(v=>!!v.trim())||!date(row.documentDate))return stop('Identifique beneficiário,bens,contrato,documento/previsão,data,âmbito e referência/pressuposto aduaneiro.Reutilize documentos,não é exigido novo certificado.');
const conditions=[...minerCommon,...rule.conditions];const failed=conditions.filter(([k])=>row.conditions[k]==='no');if(failed.length)return stop('Não se aplica este fundamento aos factos indicados: '+failed.map(([,label])=>label).join('; ')+'. Outros enquadramentos permanecem por apurar.','not_applicable');if(conditions.some(([k])=>row.conditions[k]!=='yes'))return stop('Condições do beneficiário,bens ou percurso por esclarecer;desconhecido não é IVA zero.');
const route=['appliance','vehicle','return_vehicle','separate_vehicle'].includes(row.treatment)?'declaration':row.treatment==='accumulated'?'company':row.route;
if(!['accompanied','company','declaration'].includes(route)||(['monthly','accumulated','baggage','return_baggage'].includes(row.treatment)&&route==='declaration'))return stop('Identifique via acompanhada ou empresa nos bens/bagagem;electrodomésticos e veículos seguem declaração aduaneira. Não exigir procedimentoKAWENA a outras vias.');
if(!['miner','heir'].includes(row.rightHolder))return stop('Indique titular originário ou transmissão do direito a herdeiro legal.');
if(row.rightHolder==='heir'){
if(['heir','unusedRight','acquiredAlive'].some(k=>row.conditions[k as Condition]==='no'))return stop('Transmissão a herdeiro não demonstrada:apenas direito não usado e bens adquiridos em vida pelo mineiro.','not_applicable');
if(['heir','unusedRight','acquiredAlive'].some(k=>row.conditions[k as Condition]!=='yes')||!row.heirRef.trim()||!date(row.deathDate)||!date(row.requestDate))return stop('Identifique qualidade de herdeiro,direito não usado,bens adquiridos em vida,óbito e requerimento;sem conceder direito sucessório automaticamente.');
if(row.requestDate<row.deathDate||row.requestDate>anniversary(row.deathDate,1))return stop('Requerimento do herdeiro fora do período de um ano contado do óbito,ou anterior ao mesmo;este fundamento não se aplica.','not_applicable');
}
if(['monthly','accumulated'].includes(row.treatment)){
const amount=decimal(row.value),total=decimal(row.periodTotal);if(amount===null||total===null||amount>total||!row.quotaRef.trim())return stop('Indique valor desta remessa e total do âmbito mensal/acumulado,incluindo outras remessas e esta,com registo ou pressuposto expresso;vazio não significa zero.');
let months=1;
if(row.treatment==='accumulated'){
months=Number(row.accumulationMonths);if(!/^[1-6]$/.test(row.accumulationMonths)||!/^\d{4}-(0[1-9]|1[0-2])$/.test(row.accumulationStart))return stop('Indique início e duração de um a seis meses acumulados;sem acumular indefinidamente.');
const start=Number(row.accumulationStart.slice(0,4))*12+Number(row.accumulationStart.slice(5)),end=Number(row.period.slice(0,4))*12+Number(row.period.slice(5));if(end-start+1!==months)return stop('Meses indicados não correspondem ao início/fim do saldo acumulado;conserve origem e reveja a janela,sem reutilização automática.');
}
if(total>15000000000n*BigInt(months))return stop('Total excede a cobertura de15.000MZN por mês prevista nos exemplaresLei2/2011/Decreto3/2011.Não se concede benefício ao excesso nem se presume revisão do limite ao abrigo2(5);conferir disposição específica se invocada.');
}
if(row.treatment==='appliance'&&(!row.kind.trim()||row.quantity!=='1'||!row.quotaRef.trim()))return stop('Identifique tipo de electrodoméstico,uma unidade e registo/pressuposto do direito anual,incluindo operações externas ao dossier.');
if(minerVehicle(row.treatment)){
if(!['vehicle','tractor'].includes(row.kind)||row.quantity!=='1'||!row.quotaRef.trim()||!['none','known'].includes(row.previousBenefit))return stop('Identifique veículo ou tractor/alfaias,uma unidade e histórico do direito abrangido,incluindo benefícios fora do dossier;desconhecido não é ausência de benefício.');
if(row.previousBenefit==='known'){if(!date(row.previousBenefitDate))return stop('Indique data do benefício anterior aplicável ao direito identificado.');if(row.importDate<anniversary(row.previousBenefitDate,5))return stop('Ainda não decorreram cinco anos desde o benefício anterior aplicável indicado;sem nova isenção ou redução neste direito.','not_applicable');}
}
if(minerReturn(row.treatment)){
const arrival=date(row.arrivalDate),request=date(row.requestDate);if(!arrival||!request||row.requestDate<row.arrivalDate)return stop('Indique chegada e requerimento do benefício no regresso;pedido não equivale a decisão.');
if(minerNeedsDeadlineExtension(row)){const max=new Date(arrival),day=max.getUTCDate();max.setUTCDate(1);max.setUTCMonth(max.getUTCMonth()+6);const end=new Date(max);end.setUTCMonth(end.getUTCMonth()+1);end.setUTCDate(0);max.setUTCDate(Math.min(day,end.getUTCDate()));if(row.conditions.deadlineExtension!=='yes'||!row.extensionRef.trim()||request>max)return stop('Prazo normal de90dias ultrapassado;identifique prorrogação excepcional justificada até seis meses,não presumida pelo simulador.');}
if(minerVehicle(row.treatment)){
if(!date(row.stayStart)||!date(row.stayEnd)||row.stayEnd<row.stayStart||row.stayEnd>row.arrivalDate)return stop('Indique estadia naRSA para o benefício de veículo no regresso,coerente com a data da chegada.');
if(row.stayEnd<anniversary(row.stayStart,1)&&!(row.treatment==='separate_vehicle'&&row.conditions.stayException==='yes'&&row.exceptionRef.trim()))return stop('Estadia inferior a um ano;excepção6(7) só no separado de bagagem com autorização/âmbito identificados ou pressuposto expresso,não automática.');
}
}
const moment=route==='company'?'saída do armazém de regime para entrega às famílias':route==='accompanied'?'entrada no território na estância aduaneira':'desembaraço mediante Documento Único';
const context=`${rule.article};${row.origin==='projected'?'pressupostos expressos de projecção':'factos efectivos declarados'}. Momento/procedimento8:${moment}. Sem despacho ou DU emitido pelo portal,direitos,base aduaneira ou dedução/campo11.`;
if(row.treatment==='separate_vehicle'){
const normal=decimal(row.normalVat);if(normal===null||!row.normalVatRef.trim())return stop('Indique IVA normal desta importação e referência/pressuposto para aplicar redução proporcional de50%;sem presumir base ou taxa normal.');
return{...result,status:'reduced',importVat:half(normal),reason:`Redução50% das imposições no cenário específico de veículo separado da bagagem6(4),não taxa deIVA nem benefício geral. IVA informado${row.normalVat}×50%=${half(normal)}MZN,aritmética exacta sem arredondamento fiscal presumido.${context}`};
}
return{...result,status:'exempt',importVat:'0.00',reason:`Classificação de isenção no âmbito documentado de direitos/imposições,IVA12(2)b na proporção do benefício integral indicado. IVA importação:0.00MZN;sem concessão administrativa automática.${context}`};
}
function key(draft:Record<string,unknown>,b:MinerBook):string{return JSON.stringify({version:minerVersion,scope:acquisitionScope(draft),currency:draft.currency,location:draft.selection_labels??{},rows:b.rows});}
export function minerCurrent(draft:Record<string,unknown>,b:MinerBook):boolean{return!!b.result&&b.result.sourceKey===key(draft,b);}
export function recordMiners(draft:Record<string,unknown>,book:MinerBook):MinerBook{
if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Identifique linhas distintas;originais preservados.');
const rows=book.rows.map(r=>evaluateMiner(r,draft.currency));
// Declarative quotas cover external operations too; detect contradictions inside this saved scope.
book.rows.forEach((row,i)=>{if(!['exempt','reduced'].includes(rows[i].status))return;
const peers=book.rows.filter(r=>r.beneficiary===row.beneficiary&&r.origin===row.origin&&evaluateMiner(r,draft.currency).status!=='not_applicable');
let conflict=false;
if(row.treatment==='appliance')conflict=peers.filter(r=>r.treatment==='appliance'&&r.kind===row.kind&&r.period.slice(0,4)===row.period.slice(0,4)).length>1;
if(minerVehicle(row.treatment))conflict=peers.filter(r=>minerVehicle(r.treatment)&&r.kind===row.kind&&date(r.importDate)&&(r.importDate<=row.importDate?row.importDate<anniversary(r.importDate,5):r.importDate<anniversary(row.importDate,5))).length>1;
if(['monthly','accumulated'].includes(row.treatment)){
const start=row.treatment==='accumulated'?row.accumulationStart:row.period;
const relevant=peers.filter(r=>['monthly','accumulated'].includes(r.treatment)&&(r.treatment==='accumulated'?r.accumulationStart:r.period)<=row.period&&r.period>=start);
if(relevant.some(r=>r.treatment==='accumulated'||row.treatment==='accumulated')&&relevant.length>1)conflict=true;
if(relevant.some(r=>decimal(r.value)===null))conflict=true;
const sum=relevant.reduce((s,r)=>s+(decimal(r.value)??0n),0n),total=decimal(row.periodTotal);if(total!==null&&sum>total)conflict=true;
}
if(conflict)rows[i]={...rows[i],status:'indeterminate',importVat:null,reason:'Linhas guardadas sobrepõem ou excedem o mesmo direito/período/saldo declarado;reveja o conjunto e o registo externo,sem dupla utilização nem exclusão silenciosa.'};
});
const result:MinerCalculation={version:minerVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),sourceKey:key(draft,book),source:minerSource,inputs:structuredClone(book.rows),rows};const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveMinerBook(draft,next);return next;
}
export function minerReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=minerBook(draft),r=b.result;if(!r)return[];return r.inputs.map((row,i)=>['IVA mensal',`P059 — ${row.period} — ${row.id}`,`${row.description};${r.rows[i].reason};IVA:${r.rows[i].importVat??'Indeterminado'};dedução:Não apurada`,`${r.opportunity};${minerCurrent(draft,b)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${r.revision};${r.calculatedAt};${row.origin};beneficiário${row.beneficiary};contrato${row.contractRef};documento${row.documentRef},${row.documentDate};âmbito${row.scope};factos${row.evidence};condições${JSON.stringify(Object.fromEntries([...minerCommon,...(minerTreatments.find(t=>t.id===row.treatment)?.conditions??[])].map(([k])=>[k,row.conditions[k]??'Por esclarecer'])))};importação${row.importDate};aduaneiro${row.customsRef},${row.customsScope};titular${row.rightHolder}${row.rightHolder==='heir'?`;herança${row.heirRef};óbito${row.deathDate};pedido${row.requestDate}`:''}${['monthly','accumulated'].includes(row.treatment)?`;remessa${row.value};total${row.periodTotal};registo${row.quotaRef}`:''}${row.treatment==='accumulated'?`;janela${row.accumulationStart}/${row.accumulationMonths}meses`:''}${row.treatment==='appliance'||minerVehicle(row.treatment)?`;tipo${row.kind};quantidade${row.quantity};histórico${row.quotaRef}`:''}${minerVehicle(row.treatment)?`;benefício anterior${row.previousBenefit},${row.previousBenefit==='known'?row.previousBenefitDate:'nenhum declarado'}`:''}${minerReturn(row.treatment)?`;chegada${row.arrivalDate};pedido${row.requestDate}${minerNeedsDeadlineExtension(row)?`;prorrogação${row.extensionRef||'Por identificar'}`:''}`:''}${row.treatment==='return_vehicle'||row.treatment==='separate_vehicle'?`;estadia${row.stayStart}/${row.stayEnd}${minerNeedsStayException(row)?`;excepção${row.exceptionRef||'Por identificar'}`:''}`:''}${row.treatment==='separate_vehicle'?`;IVA normal${row.normalVat};referência${row.normalVatRef}`:''};${r.rows[i].source};sem lançamento automático nos totaisModeloA/campo11.`]);}catch{return[['IVA mensal','P059','Dados não recuperáveis','Originais preservados;sem substituição porzero.']];}}
+1 -1
View File
@@ -45,7 +45,7 @@ export function modeloAComponentRows(snapshot: Record<string, unknown>): Array<[
return [
['Correspondência Modelo A',modeloAReference.status],
['Campos01/02', 'Base líquida e IVA mensal da versão publicada. Os restantes campos não foram presumidos iguais a zero.'],
['Apuramento do período — campos14–18', 'Indeterminado: faltam componentes e enquadramentos do Modelo A. IVA das vendas não é imposto final a pagar.'],
['Apuramento nesta execução de vendas — campos14–18', 'Indeterminado nesta execução isolada de01/02. Consulte o bloco separado de aquisições e apuramento parcial, quando preenchido. IVA das vendas não é imposto final a pagar.'],
['Origem dos dados','Projecção do negócio; não são operações efectivas nem declaração fiscal.'],
['Exemplar de referência',`${modeloAReference.file}; SHA256 ${modeloAReference.sha256}. ${modeloAReference.edition}`],
];
+59
View File
@@ -0,0 +1,59 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const noncashBaseVersion='noncash-consideration-base/1';
export const noncashBaseSource='CIVA republicado Lei13/2016,15(3)/(4),PDF14/p1426(272): contraprestação não definida,no todo ou em parte,em dinheiro;valor tributável=montante recebido ou a receber acrescido do valor normal dos bens ou serviços dados em troca. Valor normal:preço em concorrência normal,a fornecedor independente,no mesmo estádio de comercialização,tempo e lugar da operação ou mais próximos,aumentado dos elementos15(5)na medida não incluídos. Composição/exclusões15(5)/(6),sem próprioIVA. Lei22/2022PDF3mantém15(3–6)por remissão;Lei10/2025não altera15. Recorte2026/MZN,sem conversão cambial;base apenas,sem avaliação automática,incidência,taxaIVA,IVA,dedução/campo11 ou totaisModeloA.';
export const noncashBaseTreatments=[{id:'noncash_only',label:'Contraprestação inteiramente não monetária'},{id:'cash_and_noncash',label:'Contraprestação em parte monetária e em parte não monetária'}] as const;
export const noncashBaseConditions=[
['taxableOperation','Está identificada a operação sujeita a IVA cuja contraprestação não é definida no todo ou em parte em dinheiro'],
['exchangeIdentified','Estão identificados os bens ou serviços dados em troca como contraprestação desta operação; não se somam o valor da própria operação e a respectiva contraprestação'],
['cashComposition','A composição escolhida corresponde à operação:inteiramente não monetária,sem parte em dinheiro,ou com montante monetário recebido/a receber identificado'],
['normalValueBasis','O valor normal corresponde ao artigo15(4):concorrência normal,fornecedor independente,mesmo estádio de comercialização,tempo/lugar da operação ou mais próximos,com fundamento identificado'],
['netComposition','Os montantes excluem o próprio IVA e incluem a composição aplicável15(5)/(6),sem omissões ou dupla contagem dos mesmos elementos'],
] as const;
type Choice=''|'yes'|'no';type Condition=typeof noncashBaseConditions[number][0];
export type NoncashBaseRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';currency:string;exchangeDescription:string;agreementRef:string;documentRef:string;documentDate:string;cashAmount:string;cashRef:string;normalValue:string;valuationRef:string;valuationScope:string;compositionRef:string;evidence:string;conditions:Partial<Record<Condition,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type NoncashBaseCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:NoncashBaseRow[];rows:LineResult[]};
export type NoncashBaseBook={rows:NoncashBaseRow[];result?:NoncashBaseCalculation;history?:NoncashBaseCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{noncashBases?:Record<string,NoncashBaseBook>};
export function newNoncashBase(id:string,currency:string):NoncashBaseRow{return{id,treatment:'',description:'',period:'',origin:'projected',currency,exchangeDescription:'',agreementRef:'',documentRef:'',documentDate:'',cashAmount:'',cashRef:'',normalValue:'',valuationRef:'',valuationScope:'',compositionRef:'',evidence:'',conditions:{}};}
export function switchNoncashComposition(row:NoncashBaseRow,treatment:string):NoncashBaseRow{return{...row,treatment,conditions:{...row.conditions,cashComposition:''}};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.noncashBases!==undefined&&(!store.noncashBases||typeof store.noncashBases!=='object'||Array.isArray(store.noncashBases)))throw new Error('Bases de contraprestação não recuperáveis;originais preservados.');
const fields=Object.keys(newNoncashBase('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.noncashBases??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof NoncashBaseRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de contraprestação não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function noncashBaseBook(draft:Record<string,unknown>):NoncashBaseBook{return readStore(draft).noncashBases?.[acquisitionScope(draft)]??{rows:[]};}
export function saveNoncashBaseBook(draft:Record<string,unknown>,book:NoncashBaseBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,noncashBases:{...current.noncashBases,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateNoncashBase(row:NoncashBaseRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
if(!noncashBaseTreatments.some(item=>item.id===row.treatment))return stop('Identifique a composição não monetária total ou parcial;parte monetária desconhecida não equivale a ausência de dinheiro.');
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto;sem conversão silenciosa ou taxa de câmbio presumida.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique mês em2026 e dados efectivos declarados ou pressupostos de projecção;sem inferir do orçamento.');
const failed=noncashBaseConditions.filter(([key])=>row.conditions[key]==='no');if(failed.length)return stop('Não se aplica esta determinação da base: '+failed.map(([,label])=>label).join('; ')+'. Não é isenção nem IVA zero.','not_applicable');
const missing=noncashBaseConditions.filter(([key])=>row.conditions[key]!=='yes');if(missing.length)return stop('Condições por indicar: '+missing.map(([,label])=>label).join('; ')+'. Desconhecido não significa não aplicável ou zero.');
if(!row.description.trim()||!row.exchangeDescription.trim()||!row.agreementRef.trim()||!row.documentRef.trim()||!row.valuationRef.trim()||!row.valuationScope.trim()||!row.compositionRef.trim()||!row.evidence.trim()||!validDate(row.documentDate))return stop('Identifique operação,contraprestação em bens/serviços,acordo,documento/data,fundamento e âmbito do valor normal e composição,ou pressupostos expressos;reutilize referências existentes,sem novo certificado/avaliador/aprovador.');
const normal=decimal(row.normalValue);if(normal===null)return stop('Indique o valor normal dos bens/serviços dados em troca;desconhecido não é zero nem valor avaliado automaticamente pelo portal.');
let base=normal,formula=`valor normal ${money(normal)},sem parte monetária expressamente confirmada`;
if(row.treatment==='cash_and_noncash'){
const cash=decimal(row.cashAmount);if(cash===null||!row.cashRef.trim())return stop('Identifique montante monetário recebido/a receber e referência ou pressuposto expresso;um montante desconhecido não é zero.');
base=cash+normal;formula=`montante monetário ${money(cash)} + valor normal ${money(normal)}`;
}
return{...result,status:'determined',baseAmount:money(base),reason:`Base15(3)/(4): ${formula} = ${money(base)}MZN,${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. Valor normal/fundamento/âmbito e composição identificados,sem avaliação automática. Base não é imposto;IVA/taxa,dedução/campo11 e totaisModeloA não são determinados por este cálculo.`};
}
function key(draft:Record<string,unknown>,book:NoncashBaseBook):string{return JSON.stringify({version:noncashBaseVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function noncashBaseCurrent(draft:Record<string,unknown>,book:NoncashBaseBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordNoncashBases(draft:Record<string,unknown>,book:NoncashBaseBook):NoncashBaseBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:NoncashBaseCalculation={version:noncashBaseVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:noncashBaseSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateNoncashBase(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveNoncashBaseBook(draft,next);return next;
}
export function noncashBaseReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=noncashBaseBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base P100 — ${row.period} — ${row.id}`,`${row.description};base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${noncashBaseCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${noncashBaseTreatments.find(item=>item.id===row.treatment)?.label??'Composição por indicar'};bens/serviços dados em troca ${row.exchangeDescription};acordo ${row.agreementRef};${row.treatment==='cash_and_noncash'?`montante monetário ${row.cashAmount} ${row.currency},referência ${row.cashRef}`:'Sem parte monetária,expressamente confirmado'};valor normal ${row.normalValue} ${row.currency};fundamento ${row.valuationRef};âmbito ${row.valuationScope};composição ${row.compositionRef};documento ${row.documentRef},${row.documentDate};condições ${noncashBaseConditions.map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento factual ${row.evidence};não preenche totaisModeloA ou campo11.`]);}
catch{return[['IVA mensal','Base de contraprestação não monetária','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
+42
View File
@@ -0,0 +1,42 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
import {operationTreatments,newSalesOperation,evaluateSalesOperation,salesBook,type SalesOperation} from './iva-operations.ts';
export const objectiveImportVersion='objective-imports/1';
export const objectiveImportSource='CIVA12(1)a,Lei10/2025,BR248-I/suplemento,PDF12/p2180(12),efeitos01/01/2026:importações definitivas de bens cuja transmissão interna beneficie de isenção objectiva;enumeração exemplificativa. Correspondências9(1)b/c/e/f/g,9(9)b,9(10),9(11),9(12)g/h/i;catálogo interno e anexosLei22/2022 já conferidos. Sem dedução/campo11,direitos ou alteração dos livros internos.';
const fixed=['health_assistive','human_materials','mosquito_nets','medicines','pharma_manufacturing_inputs','cultural_publications','official_military_supplies','industrial_feed_inputs','annexI_goods','veterinary_goods'];
export const objectiveImportTreatments=operationTreatments.filter(t=>fixed.includes(t.id)||t.id.startsWith('listed_'));
type Choice=''|'yes'|'no';
export type ObjectiveImportRow={id:string;description:string;period:string;currency:string;origin:'projected'|'effective';importer:string;documentRef:string;documentDate:string;scope:string;evidence:string;definitive:Choice;goods:Choice;sameGoods:Choice;internalApplicable:Choice;reference:SalesOperation;reusedFrom:string};
type Line={id:string;status:'exempt'|'not_applicable'|'indeterminate';importVat:string|null;deduction:null;source:string;reason:string};
export type ObjectiveImportCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;sourceKey:string;source:string;inputs:ObjectiveImportRow[];rows:Line[]};
export type ObjectiveImportBook={rows:ObjectiveImportRow[];result?:ObjectiveImportCalculation;history?:ObjectiveImportCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{objectiveImports?:Record<string,ObjectiveImportBook>};
export function newObjectiveImport(id:string,currency:string):ObjectiveImportRow{return{id,description:'',period:'',currency,origin:'projected',importer:'',documentRef:'',documentDate:'',scope:'',evidence:'',definitive:'',goods:'',sameGoods:'',internalApplicable:'',reference:newSalesOperation(id+'-reference','',currency),reusedFrom:''};}
export function objectiveImportSources(draft:Record<string,unknown>):SalesOperation[]{return salesBook(draft).rows.filter(r=>objectiveImportTreatments.some(t=>t.id===r.treatment));}
export function reuseObjectiveImport(row:ObjectiveImportRow,source:SalesOperation):ObjectiveImportRow{
const reference={...row.reference};
// This explicit action fills missing values only; confirmations belong to this import.
if(!reference.treatment||reference.treatment==='other')reference.treatment=source.treatment;
if(reference.treatment===source.treatment){reference.annexIItem ||= source.annexIItem;reference.pharmaAnnexItem ||= source.pharmaAnnexItem;reference.annexIOnly ??= source.annexIOnly;}
return{...row,description:row.description||source.description,period:row.period||source.period,evidence:row.evidence||source.evidence,reference,reusedFrom:source.id};
}
function readStore(draft:Record<string,unknown>):Store{const s=readAcquisitionStore(draft.modelo_a_snapshot) as Store;const books=s.objectiveImports;if(books!==undefined&&(!books||typeof books!=='object'||Array.isArray(books)))throw new Error('Importações objectivas não recuperáveis;originais preservados.');const fields=Object.keys(newObjectiveImport('','MZN')).filter(k=>k!=='reference');for(const b of Object.values(books??{}))if(!b||!Array.isArray(b.rows)||(b.history!==undefined&&!Array.isArray(b.history))||b.rows.some(r=>!r||fields.some(k=>typeof r[k as keyof ObjectiveImportRow]!=='string')||!r.reference||typeof r.reference.treatment!=='string'||!Array.isArray(r.reference.confirmed)))throw new Error('Linhas de importação objectiva não recuperáveis;sem substituição por lista vazia.');return s;}
export function objectiveImportBook(draft:Record<string,unknown>):ObjectiveImportBook{return readStore(draft).objectiveImports?.[acquisitionScope(draft)]??{rows:[]};}
export function saveObjectiveImportBook(draft:Record<string,unknown>,book:ObjectiveImportBook):string{const s=readStore(draft),encoded=JSON.stringify({...s,objectiveImports:{...s.objectiveImports,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function date(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateObjectiveImport(row:ObjectiveImportRow,currency:unknown):Line{
const rule=objectiveImportTreatments.find(t=>t.id===row.reference.treatment),result:Line={id:row.id,status:'indeterminate',importVat:null,deduction:null,source:objectiveImportSource+(rule?';'+rule.source:''),reason:''};const stop=(reason:string,status:Line['status']='indeterminate')=>({...result,status,reason});
if(currency!=='MZN'||row.currency!==currency||!/^2026-(0[1-9]|1[0-2])$/.test(row.period))return stop('Indique período2026 e moedaMZN coerente com o projecto;sem conversão presumida.');
if(!['projected','effective'].includes(row.origin)||![row.description,row.importer,row.documentRef,row.scope,row.evidence].every(v=>!!v.trim())||!date(row.documentDate))return stop('Identifique bens,importador,documento/previsão,data,âmbito e factos/pressupostos.Reutilize os elementos disponíveis.');
if([row.definitive,row.goods,row.sameGoods,row.internalApplicable].some(v=>v==='no'))return stop('Este fundamento12(1)a não se aplica aos factos indicados;IVA fora deste fundamento permanece por enquadrar,sem taxa presumida.','not_applicable');
if([row.definitive,row.goods,row.sameGoods,row.internalApplicable].some(v=>v!=='yes'))return stop('Confirme importação definitiva de bens,a correspondência dos mesmos bens e a aplicabilidade da isenção objectiva interna.Desconhecido não significa IVA zero.');
if(!rule)return stop('Escolha correspondência interna documentada.A lista implementada cobre as remissões expressas12(1)a;é exemplificativa e não declara excluídos outros fundamentos.Não basta descrição,isenção de serviços,exportação,taxa reduzida ou benefício terminado.');
// Evaluate the legal hypothetical domestic transmission, never create a domestic sale or use its amount/totals.
const reference={...row.reference,id:row.id+'-reference',description:row.description,period:row.period,sourcePeriod:row.period,sourceCurrency:row.currency,sourceAmount:null,establishment:row.importer,amount:'0',basis:'net' as const,evidence:row.evidence};
const v=evaluateSalesOperation(reference,row.currency);result.source=objectiveImportSource+';'+v.source;
if(v.status!=='exempt')return stop('Correspondência interna ainda não demonstrada: '+v.reason);
return{...result,status:'exempt',importVat:'0.00',reason:`Isenção12(1)a por correspondência a${rule.article},nas condições ${row.origin==='projected'?'expressamente assumidas da projecção':'efectivas declaradas'}. IVA na importação:0.00MZN. Hipótese de transmissão interna,não venda criada nem montante somado.Sem direitos,base aduaneira,dedução/campo11 ou concessão administrativa automática.`};
}
function key(draft:Record<string,unknown>,book:ObjectiveImportBook):string{return JSON.stringify({version:objectiveImportVersion,catalog:objectiveImportTreatments,scope:acquisitionScope(draft),currency:draft.currency,location:draft.selection_labels??{},rows:book.rows});}
export function objectiveImportCurrent(draft:Record<string,unknown>,book:ObjectiveImportBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordObjectiveImports(draft:Record<string,unknown>,book:ObjectiveImportBook):ObjectiveImportBook{if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Indique linhas com identidades distintas;originais conservados.');const result:ObjectiveImportCalculation={version:objectiveImportVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),sourceKey:key(draft,book),source:objectiveImportSource,inputs:structuredClone(book.rows),rows:book.rows.map(r=>evaluateObjectiveImport(r,draft.currency))};const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveObjectiveImportBook(draft,next);return next;}
export function objectiveImportReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=objectiveImportBook(draft),r=b.result;if(!r)return[];return r.inputs.map((row,i)=>['IVA mensal',`P046 — ${row.period} — ${row.id}`,`${row.description};${r.rows[i].reason};IVA importação:${r.rows[i].importVat??'Indeterminado'};dedução:Não apurada`,`${r.opportunity};${objectiveImportCurrent(draft,b)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${r.revision};${r.calculatedAt};${row.origin};importador${row.importer};documento${row.documentRef},${row.documentDate};âmbito${row.scope};factos${row.evidence};reutilização${row.reusedFrom||'Introdução directa'};correspondência${row.reference.treatment};condições internas confirmadas${row.reference.confirmed.join(',')}${row.reference.treatment==='annexI_goods'?`;AnexoI${row.reference.annexIItem??''},apenasAnexoI${String(row.reference.annexIOnly??'Por esclarecer')}`:row.reference.treatment==='pharma_manufacturing_inputs'?`;AnexoIII${row.reference.pharmaAnnexItem??''}`:''};${r.rows[i].source};sem alteração dos livros internos,ModeloA,campo11 ou totais.`]);}catch{return[['IVA mensal','P046','Dados não recuperáveis','Originais preservados;sem classificação por defeito.']];}}
+10
View File
@@ -0,0 +1,10 @@
import JSZip from 'jszip';
import type {OfferPreparation} from './iva-offer-preparations.ts';
import {recordOfferWorkflow,offerAttachmentValid,offerWrittenRequest} from './iva-offer-workflow.ts';
export async function buildOfferPackage(row:OfferPreparation,load:(url:string)=>Promise<ArrayBuffer>){
const item=recordOfferWorkflow(row,'form'),w=item.workflow!,zip=new JSZip();
for(const [folder,attachment]of [['despacho',w.decisionAttachment],['formulario',w.formAttachment]] as const){if(!attachment)continue;if(!offerAttachmentValid(attachment))throw Error('Referência de anexo inválida.');const bytes=await load(attachment.url),hash=Array.from(new Uint8Array(await crypto.subtle.digest('SHA-256',bytes))).map(b=>b.toString(16).padStart(2,'0')).join('');if(hash!==attachment.sha256)throw Error('O anexo diverge do hash registado;conjunto não emitido.');zip.file(folder+'/'+attachment.name.replace(/[^\p{L}\p{N}._-]/gu,'_'),bytes);}
zip.file('pedido.txt',offerWrittenRequest(item,w));zip.file('preparacao-formulario.txt',`${w.formName}\nFonte/aplicabilidade:${w.formSource}\n${w.formContent}\nDespacho:${item.request?.decisionRef};SHA256:${w.decisionAttachment!.sha256}\nApresentação fora do InvesteMoz.`);
zip.file('manifesto.json',JSON.stringify({branch:item.branch,request:item.request,workflow:w,scope:'Submissão externa;conteúdo de preparação e anexos,não recibo de entrega à autoridade.'},null,2));
return{row:item,bytes:await zip.generateAsync({type:'uint8array'})};
}
@@ -0,0 +1,80 @@
import { acquisitionBook, acquisitionScope } from './iva-acquisitions.ts';
import { importExemptionBook,isImportService } from './iva-import-exemptions.ts';
import {offerWorkflowApplied,offerWorkflowReport,type OfferWorkflow} from './iva-offer-workflow.ts';
type Choice = ''|'yes'|'no';
export const offerPreparationSource='CIVA,Lei13/2016,14(2)(a/b) e14(3),PDF13/p.1426(271). Procedimento operacional definido pela Tempo25/10/2026,distinto das fontes legais;correspondência específica do formulário ainda por demonstrar. Não concede isenção nem preenche dedução/campo11.';
export type OfferRequest = {state:'preparation'|'presented'|'granted'|'denied';reference:string;presentedOn:string;decisionRef:string;decisionOn:string;goods:string;operation:''|'acquisition'|'import';periodFrom:string;periodTo:string;conditions:string;operationScope?:string;periodScope?:string};
export const offerRequestLabels = {preparation:'Em preparação',presented:'Apresentado',granted:'Deferido',denied:'Indeferido'};
export type OfferPreparation = {workflow?:OfferWorkflow;id:string;branch:'P084'|'P085';operation:''|'acquisition'|'import';description:string;period:string;currency:string;amount:string;counterparty:string;documentRef:string;documentDate:string;beneficiary:string;purpose:string;evidence:string;nationalInstitution:Choice;publicSocialInstitution:Choice;goodsSuitable:Choice;publicInterestUse:Choice;disaster:string;disasterKind:string;mitigation:Choice;reusedFrom?:{key:string;copiedAt:string};humanitarianPurpose?:string;availableDocuments?:string;request?:OfferRequest;requestRecords?:Array<{recordedAt:string;request:OfferRequest}>;normalVat?:string;normalVatSource?:string;conditionalAssumption?:Choice};
export type OfferPreparationBook={rows:OfferPreparation[];history?:Array<{savedAt:string;rows:OfferPreparation[]}>;saved?:{savedAt:string;rows:OfferPreparation[]}};
type Store={version:1;books:Record<string,unknown>;offerPreparations?:Record<string,OfferPreparationBook>;[key:string]:unknown};
export function newOfferPreparation(id:string,branch:OfferPreparation['branch'],currency:string):OfferPreparation{return {id,branch,operation:branch==='P085'?'acquisition':'',description:'',period:'',currency,amount:'',counterparty:'',documentRef:'',documentDate:'',beneficiary:'',purpose:'',evidence:'',nationalInstitution:'',publicSocialInstitution:'',goodsSuitable:'',publicInterestUse:'',disaster:'',disasterKind:'',mitigation:''};}
function read(draft:Record<string,unknown>):Store {
const value:Store=draft.modelo_a_snapshot?JSON.parse(String(draft.modelo_a_snapshot)):{version:1,books:{}};
if(value?.version!==1||!value.books||typeof value.books!=='object'||Array.isArray(value.books))throw new Error('Dados fiscais não recuperáveis; originais preservados.');
if(value.offerPreparations!==undefined&&(!value.offerPreparations||typeof value.offerPreparations!=='object'||Array.isArray(value.offerPreparations)))throw new Error('Rascunhos de ofertas não recuperáveis; sem substituição por lista vazia.');
for(const book of Object.values(value.offerPreparations??{})){
if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history)))throw new Error('Formato de rascunhos de ofertas não recuperável; originais preservados.');
for(const row of book.rows){
if(!row||!['P084','P085'].includes(row.branch)||Object.keys(newOfferPreparation('','P084','')).some(key=>typeof row[key as keyof OfferPreparation]!=='string')||(row.branch==='P085'&&row.operation==='import'))throw new Error('Rascunho de oferta não recuperável ou operação fora do ramo; dados conservados.');
if(['humanitarianPurpose','availableDocuments','normalVat','normalVatSource','conditionalAssumption'].some(key=>row[key as keyof OfferPreparation]!==undefined&&typeof row[key as keyof OfferPreparation]!=='string')||(row.requestRecords!==undefined&&!Array.isArray(row.requestRecords)))throw new Error('Elementos do percurso de ofertas não recuperáveis; originais preservados.');
if(row.workflow!==undefined&&(!row.workflow||!Array.isArray(row.workflow.records)||['recipient','writtenRequest','decisionIssuer','scopeConfirmed','formName','formSource','formContent','submission','submissionReference'].some(k=>typeof row.workflow?.[k as keyof OfferWorkflow]!=='string')))throw new Error('Percurso pedido/decisão/formulário não recuperável;originais preservados.');
if(row.request!==undefined&&(!row.request||!Object.hasOwn(offerRequestLabels,row.request.state)||Object.entries(emptyOfferRequest()).some(([key])=>typeof row.request?.[key as keyof OfferRequest]!=='string')))throw new Error('Pedido de oferta não recuperável; decisão e originais conservados.');
}
}
return value;
}
export function offerPreparationBook(draft:Record<string,unknown>):OfferPreparationBook{return read(draft).offerPreparations?.[acquisitionScope(draft)]??{rows:[]};}
export function saveOfferPreparationBook(draft:Record<string,unknown>,book:OfferPreparationBook):string{
const previous=read(draft);const next={...previous,offerPreparations:{...previous.offerPreparations,[acquisitionScope(draft)]:book}};const encoded=JSON.stringify(next);read({...draft,modelo_a_snapshot:encoded});return encoded;
}
export function recordOfferPreparations(book:OfferPreparationBook):OfferPreparationBook{
if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Indique rascunhos com identificadores distintos.');
return {...book,history:[...(book.history??[]),...(book.saved?[structuredClone(book.saved)]:[])],saved:{savedAt:new Date().toISOString(),rows:structuredClone(book.rows)}};
}
export type OfferReusable={key:string;label:string;operation:'acquisition'|'import';values:Partial<OfferPreparation>};
export function offerReusableData(draft:Record<string,unknown>):OfferReusable[]{
const purchases=acquisitionBook(draft).rows.map(row=>({key:'acquisition:'+row.id,label:'Aquisição: '+(row.description||row.documentRef||row.id),operation:'acquisition' as const,values:{description:row.description,period:row.period,currency:row.sourceCurrency,amount:row.net,documentRef:row.documentRef,documentDate:row.documentDate,counterparty:row.supplier}}));
const imports=importExemptionBook(draft).rows.filter(row=>!isImportService(row.treatment)).map(row=>({key:'import:'+row.id,label:'Importação: '+(row.description||row.documentRef||row.id),operation:'import' as const,values:{description:row.description,period:row.period,currency:row.currency,amount:row.declaredValue,documentRef:row.documentRef,documentDate:row.documentDate,counterparty:row.importer}}));
return [...purchases,...imports];
}
export function reuseOfferData(row:OfferPreparation,source:OfferReusable):OfferPreparation {
if(row.branch==='P085'&&source.operation==='import')throw new Error('P085 abrange aquisição; esta referência de importação conserva-se no seu percurso.');
const next={...row};
if(next.currency&&source.values.currency&&next.currency!==source.values.currency)throw new Error('Moeda da referência divergente; valores e edições conservados, sem conversão.');
// Only fill empty inputs. Deliberate edits and answers are never replaced.
if(!next.operation)next.operation=source.operation;
if(next.operation!==source.operation)throw new Error('A operação já escolhida diverge da origem; rascunho conservado.');
for(const [key,value] of Object.entries(source.values))if(!next[key as keyof OfferPreparation]&&typeof value==='string')Object.assign(next,{[key]:value});
return {...next,reusedFrom:{key:source.key,copiedAt:new Date().toISOString()}};
}
export function emptyOfferRequest():OfferRequest{return {state:'preparation',reference:'',presentedOn:'',decisionRef:'',decisionOn:'',goods:'',operation:'',periodFrom:'',periodTo:'',conditions:''};}
export function recordOfferRequest(row:OfferPreparation):OfferPreparation{
const request=row.request??emptyOfferRequest();
const validPeriod=(value:string)=>{if(/^\d{4}-(0[1-9]|1[0-2])$/.test(value))return true;if(!/^\d{4}-\d{2}-\d{2}$/.test(value))return false;const d=new Date(value+'T00:00:00Z');return Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;};
const temporalScope=!!request.periodScope?.trim()||(validPeriod(request.periodFrom)&&validPeriod(request.periodTo)&&request.periodFrom.length===request.periodTo.length&&request.periodTo>=request.periodFrom);
if(['granted','denied'].includes(request.state)&&(!request.goods.trim()||(!['acquisition','import'].includes(request.operation)&&!request.operationScope?.trim())||!temporalScope||!request.conditions.trim()))throw new Error('Conserve o âmbito da decisão: bens, operação, período e condições. Pode usar datas, meses ou o âmbito temporal literal do documento, inclusive sem termo. Pode continuar a guardar o rascunho incompleto.');
return {...row,requestRecords:[...(row.requestRecords??[]),{recordedAt:new Date().toISOString(),request:structuredClone(request)}]};
}
export function offerScenarios(row:OfferPreparation):{normalVat:string|null;conditionalVat:string|null;conditionalReason:string;applied:boolean;appliedVat?:string}{
const normalVat=row.normalVatSource?.trim()&&/^\d{1,15}(\.\d{1,6})?$/.test(row.normalVat??'')?row.normalVat!:null;
const result={normalVat,conditionalVat:null as string|null,conditionalReason:'Hipótese de isenção não assumida; benefício não aplicado.',applied:false as const};
const workflow=offerWorkflowApplied(row);if(workflow.applied)return {...result,applied:true,appliedVat:'0.00',conditionalReason:workflow.reason};
if(row.conditionalAssumption!=='yes')return result;
const choices=row.branch==='P084'?[row.nationalInstitution,row.publicSocialInstitution,row.goodsSuitable,row.publicInterestUse]:[row.mitigation];
if(choices.includes('no'))return {...result,conditionalReason:'Condição material contrariada; este cenário de isenção não está demonstrado. Benefício não aplicado.'};
if(choices.some(value=>value!=='yes')||!row.description.trim()||!row.beneficiary.trim()||!row.purpose.trim()||!row.operation||!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||row.currency!=='MZN'||(row.branch==='P085'&&(!row.disaster.trim()||!row.humanitarianPurpose?.trim())))return {...result,conditionalReason:'Pressupostos, contexto ou condições materiais por indicar; sem IVA zero presumido. Benefício não aplicado.'};
if(row.workflow)return {...result,conditionalVat:'0.00',conditionalReason:'Cenário condicionado à isenção antes de despacho favorável e âmbito demonstrado;procedimento operacional fornecido pela Tempo.Não é benefício concedido nem imposto aplicado;apresentar pedido não concede isenção.'};
return {...result,conditionalVat:'0.00',conditionalReason:'Cenário condicionado à isenção: hipótese expressa de cumprimento das condições e aplicação do procedimento, cuja correspondência permanece pendente. Não é benefício concedido nem imposto aplicado; apresentar pedido não concede isenção.'};
}
export function offerPathReport(row:OfferPreparation):string {
const request=row.request??emptyOfferRequest(),scenario=offerScenarios(row);
if(row.workflow)return offerWorkflowReport(row)+`;Cenário normal — IVA ${scenario.normalVat??'Indeterminado'};Cenário condicionado à isenção — IVA ${scenario.conditionalVat??'Indeterminado'};IVA do âmbito deferido:${scenario.appliedVat??'Não aplicado'};${scenario.conditionalReason}`;
const scope=(r:OfferRequest)=>`bens ${r.goods||'por indicar'}; operação ${r.operationScope||r.operation||'por indicar'}; período ${r.periodScope||`${r.periodFrom||'por indicar'} a ${r.periodTo||'por indicar'}`}; condições ${r.conditions||'por indicar'}; documento ${r.decisionRef||'por indicar'},${r.decisionOn||'data por indicar'}`;
return `${row.branch==='P084'?`Pedido ${offerRequestLabels[request.state]} (estado declarado, sem concessão pelo simulador); referência ${request.reference||'por indicar'}, apresentação ${request.presentedOn||'por indicar'}; âmbito em edição ${scope(request)}; ${(row.requestRecords??[]).map(record=>`estado registado ${offerRequestLabels[record.request.state]} em ${record.recordedAt}, ${scope(record.request)}`).join(' | ')||'sem estado/decisão registado'}; não estender decisão aos restantes bens, operações, períodos ou oportunidades; apresentar pedido não concede isenção`:`Emergência ${row.disaster||'por indicar'}; finalidade humanitária ${row.humanitarianPurpose||'por indicar'}; procedimento de emergência/doação por corresponder, sem aplicação automática`}; documentos disponíveis ${row.availableDocuments||row.documentRef||'por indicar'}; Cenário normal — IVA ${scenario.normalVat??'Indeterminado'} ${row.currency}, documento/pressuposto ${row.normalVatSource||'por indicar'}; Cenário condicionado à isenção — IVA ${scenario.conditionalVat??'Indeterminado'} ${row.currency}; ${scenario.conditionalReason}`;
}
export function offerPreparationReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{return offerPreparationBook(draft).rows.map(row=>['IVA mensal',`Rascunho de oferta ${row.branch} — ${row.id}`,`${row.description||'Bens por indicar'}; ${offerWorkflowApplied(row).applied?'tratamento deferido no âmbito do despacho':'preparação, benefício não aplicado'}; ${row.amount||'Valor não informado'} ${row.currency}; ${row.period||'Período não informado'}`,`${offerPreparationSource} Oportunidade ${acquisitionScope(draft)}; operação ${row.operation||'por indicar'}; contraparte ${row.counterparty||'por indicar'}; documento ${row.documentRef||'por indicar'},${row.documentDate||'data por indicar'}; beneficiário ${row.beneficiary||'por indicar'}; finalidade ${row.purpose||'por indicar'}; ${row.branch==='P084'?`instituição nacional ${row.nationalInstitution||'por indicar'}, interesse público/relevantes fins sociais ${row.publicSocialInstitution||'por indicar'}, bens adequados ${row.goodsSuitable||'por indicar'}, utilização de interesse público ${row.publicInterestUse||'por indicar'}`:`calamidade ${row.disaster||'por indicar'}, natureza ${row.disasterKind||'por indicar'}, atenuação dos efeitos ${row.mitigation||'por indicar'}`}; fundamento ${row.evidence||'por indicar'}; origem reutilizada ${row.reusedFrom?.key||'entrada directa'}; ${offerPathReport(row)}; sem isenção automática ou dedução.`]);}
catch{return [['IVA mensal','Rascunhos de ofertas','Dados não recuperáveis','Originais preservados; sem substituição por zero.']];}
}
+29
View File
@@ -0,0 +1,29 @@
import type {OfferPreparation,OfferRequest} from './iva-offer-preparations.ts';
export const offerWorkflowSource='Procedimento operacional fornecido pela Tempo em25/10/2026:pedido escrito ao Ministério das Finanças/AT → pedido apresentado → decisão recebida e despacho anexo → preparação do formulário aplicável com despacho. Origem distinta do CIVA14(2)a/b e14(3) e do cotejo documental do ModeloI.1;sem nova certificação ou aprovação criada pelo portal.';
export type OfferAttachment={id:string;draftId:string;name:string;sha256:string;scan:string;url:string};
export type OfferWorkflow={recipient:string;writtenRequest:string;requestAttachment?:OfferAttachment;decisionIssuer:string;decisionAttachment?:OfferAttachment;scopeConfirmed:''|'yes'|'no';scopeKey?:string;formName:string;formSource:string;formContent:string;formAttachment?:OfferAttachment;formDecisionId?:string;formDecisionHash?:string;formPreparedAt?:string;submission:'outside';submissionReference:string;records:Array<{at:string;stage:string;request:OfferRequest;workflow:Omit<OfferWorkflow,'records'>}>};
export function emptyOfferWorkflow():OfferWorkflow{return{recipient:'Ministério das Finanças / Autoridade Tributária',writtenRequest:'',decisionIssuer:'',scopeConfirmed:'',formName:'',formSource:'',formContent:'',submission:'outside',submissionReference:'',records:[]};}
export function offerScopeKey(row:OfferPreparation):string{return JSON.stringify({branch:row.branch,description:row.description,beneficiary:row.beneficiary,operation:row.operation,period:row.period,currency:row.currency,amount:row.amount,purpose:row.purpose,evidence:row.evidence,national:row.nationalInstitution,social:row.publicSocialInstitution,suitable:row.goodsSuitable,use:row.publicInterestUse,disaster:row.disaster,mitigation:row.mitigation,humanitarian:row.humanitarianPurpose,request:row.request,issuer:row.workflow?.decisionIssuer,document:row.workflow?.decisionAttachment?.id,hash:row.workflow?.decisionAttachment?.sha256});}
export function offerAttachmentValid(a:OfferAttachment|undefined):a is OfferAttachment{return!!a&&/^[0-9a-f-]{36}$/i.test(a.id)&&/^[0-9a-f-]{36}$/i.test(a.draftId)&&!!a.name&&/^[0-9a-f]{64}$/.test(a.sha256)&&a.url===`/api/v1/simulation-drafts/${a.draftId}/offer-documents/${a.id}`;}
export function offerWrittenRequest(row:OfferPreparation,w:OfferWorkflow):string{return`Ao ${w.recipient}\nAssunto:Pedido de isenção — ${row.branch}\nEntidade/destinatário:${row.beneficiary}\nFinalidade:${row.purpose}\n${row.branch==='P084'?'Justificação do interesse público/fins sociais:'+row.evidence:'Calamidade:'+row.disaster+';finalidade humanitária:'+row.humanitarianPurpose}\nBens:${row.description}\nOperação:${row.operation};período:${row.period};valor de referência:${row.amount} ${row.currency}\nDocumentos:${row.availableDocuments||row.documentRef}\n${w.writtenRequest}\nPreparação InvesteMoz;a apresentação ocorre fora do portal. Não constitui concessão.`;}
export function offerWorkflowApplied(row:OfferPreparation):{applied:boolean;reason:string}{const w=row.workflow,r=row.request;if(!w||!r||r.state!=='granted')return{applied:false,reason:'Sem despacho de deferimento registado;mantém-se hipótese condicionada.'};if(!r.decisionRef.trim()||!validDate(r.decisionOn)||!w.decisionIssuer.trim()||!offerAttachmentValid(w.decisionAttachment))return{applied:false,reason:'Despacho recebido incompleto:número,data,emitente e anexo por registar.'};if(w.scopeConfirmed!=='yes'||w.scopeKey!==offerScopeKey(row))return{applied:false,reason:'Correspondência desta linha ao âmbito do despacho não confirmada ou dados alterados;sem extensão automática.'};if((!r.operationScope?.trim()&&r.operation&&r.operation!==row.operation)||(!r.periodScope?.trim()&&/^\d{4}-\d{2}$/.test(row.period)&&(row.period<r.periodFrom.slice(0,7)||row.period>r.periodTo.slice(0,7))))return{applied:false,reason:'A operação ou o período desta linha está fora do âmbito expresso do despacho;sem extensão automática.'};const conditions=row.branch==='P084'?[row.nationalInstitution,row.publicSocialInstitution,row.goodsSuitable,row.publicInterestUse]:[row.mitigation];if(conditions.some(v=>v!=='yes')||!row.description||!row.beneficiary||!row.purpose||!row.operation||(row.branch==='P085'&&(row.operation!=='acquisition'||!row.disaster||!row.humanitarianPurpose)))return{applied:false,reason:'Condições próprias do tratamento por demonstrar;despacho não alarga o fundamento legal.'};return{applied:true,reason:`Tratamento deferido apenas nesta linha:${r.goods};${r.operationScope||r.operation};${r.periodScope||r.periodFrom+' a '+r.periodTo};condições:${r.conditions}. Despacho${r.decisionRef},${r.decisionOn},${w.decisionIssuer}. Sem extensão às restantes linhas,períodos ou oportunidades;sem dedução automática.`};}
function validDate(v:string){const d=new Date(v+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(v)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===v;}
export function recordOfferWorkflow(row:OfferPreparation,stage:'request'|'presented'|'decision'|'form'):OfferPreparation{
const w=structuredClone(row.workflow??emptyOfferWorkflow()),r=structuredClone(row.request);if(!r)throw Error('Prepare primeiro o pedido.');
if(!w.recipient.trim()||!row.beneficiary.trim()||!row.description.trim()||!row.purpose.trim()||!row.operation)throw Error('Indique entidade,finalidade,bens,operação e destinatário do pedido;rascunho incompleto pode ser guardado.');
if(stage==='presented'&&(!r.reference.trim()||!validDate(r.presentedOn)||r.state!=='presented'))throw Error('Registe referência,data e estado apresentado;submissão fora do InvesteMoz.');
if(stage==='decision'||stage==='form'){
if(!['granted','denied'].includes(r.state)||!r.decisionRef.trim()||!validDate(r.decisionOn)||!w.decisionIssuer.trim()||!offerAttachmentValid(w.decisionAttachment))throw Error('Decisão recebida exige número,data,emitente e despacho anexo.');
const dates=validDate(r.periodFrom)&&validDate(r.periodTo)&&r.periodFrom<=r.periodTo;const months=/^\d{4}-(0[1-9]|1[0-2])$/.test(r.periodFrom)&&/^\d{4}-(0[1-9]|1[0-2])$/.test(r.periodTo)&&r.periodFrom<=r.periodTo;
if(!r.goods.trim()||(!r.operation&&!r.operationScope?.trim())||(!r.periodScope?.trim()&&!dates&&!months)||!r.conditions.trim())throw Error('Conserve o âmbito literal:bens,operação,período e condições da decisão.');
if(stage==='decision')w.scopeKey=w.scopeConfirmed==='yes'?offerScopeKey(row):undefined;
}
if(stage==='form'){
if(r.state!=='granted')throw Error('Não preparar formulário de isenção como deferido após indeferimento.');
if(!offerWorkflowApplied({...row,workflow:w}).applied)throw Error('Confira explicitamente a correspondência desta linha ao despacho antes de preparar o formulário;alterações não renovam a confirmação automaticamente.');
if(!w.formName.trim()||!w.formSource.trim()||(!w.formContent.trim()&&!offerAttachmentValid(w.formAttachment)))throw Error('Identifique formulário aplicável e referência da sua aplicabilidade;prepare conteúdo ou anexe o exemplar preenchido.Sem presumir que ModeloI.1 abrange todos os casos.');
w.formDecisionId=w.decisionAttachment!.id;w.formDecisionHash=w.decisionAttachment!.sha256;w.formPreparedAt=new Date().toISOString();
}
const {records,...snapshot}=w;w.records=[...records,{at:new Date().toISOString(),stage,request:r,workflow:snapshot}];return{...row,workflow:w};
}
export function offerWorkflowReport(row:OfferPreparation):string{const w=row.workflow;if(!w)return'';const state=offerWorkflowApplied(row);return`${offerWorkflowSource} Pedido:${row.request?.reference||'por indicar'};apresentado em:${row.request?.presentedOn||'por indicar'};estado:${row.request?.state||'preparation'};decisão:${row.request?.decisionRef||'por indicar'},${row.request?.decisionOn||'por indicar'};Pedido escrito:${offerWrittenRequest(row,w)};decisão emitente:${w.decisionIssuer||'por indicar'};anexo:${w.decisionAttachment?.name||'por anexar'},SHA256:${w.decisionAttachment?.sha256||'por indicar'};${state.reason};formulário:${w.formName||'por identificar'},fonte/aplicabilidade:${w.formSource||'por indicar'};conteúdo:${w.formContent||'por preparar'};despacho ligado ao formulário:${w.formDecisionId||'por preparar'}/${w.formDecisionHash||''};submissão fora do InvesteMoz:${w.submissionReference||'não registada'};histórico:${w.records.map(e=>e.stage+'@'+e.at+':'+e.request.state+':'+e.request.decisionRef).join(' | ')}`;}
+37
View File
@@ -0,0 +1,37 @@
import type { OperationTreatment } from './iva-operations.ts';
export type SupplyCategory = '' | 'provisions' | 'beverages' | 'fuel' | 'cargo_products';
export const supplyCategories: Array<[Exclude<SupplyCategory, ''>, string]> = [
['provisions', 'Provisões de bordo, excepto bebidas — consumo exclusivo da tripulação e passageiros'],
['beverages', 'Bebidas como provisões de bordo — consumo exclusivo da tripulação e passageiros'],
['fuel', 'Combustíveis, carburantes, lubrificantes ou outros produtos para propulsão ou aparelhos de uso técnico a bordo'],
['cargo_products', 'Produtos acessórios para preparação, tratamento ou conservação das mercadorias transportadas a bordo'],
];
const source = 'CIVA republicado Lei 13/2016, BR156/10.º suplemento, art.13(1)(c/d/e/h),13(2–3), PDF12/p.1426(270);19(1)(b)(i), PDF15/p.1426(273). Lei22/2022 art.1, PDF3/p.2252(27), e Lei10/2025 art.1, PDF12–13/p.2180(12)–(13), não alteram13 e mantêm19(1)(b)(i). Âmbito2026/MZN; bebidas em c/d/h não têm isenção directa automática:13(2) prevê dedução ou restituição, sem aplicar20(1)(d) para esse efeito.';
const make = (id:string,label:string,letter:string,conditions:string[]):OperationTreatment => ({id,label,field:'05',rate:0,article:`CIVA arts.13(1)(${letter}),13(2–3),19(1)(b)(i)`,source,logicVersion:'onboard-supplies/1',conditions:[
'Transmissão de bens localizada em Moçambique, com territorialidade identificada; não importação nem serviço autónomo',
'Bens efectivamente postos a bordo do meio identificado; natureza e destino correspondem à categoria escolhida do artigo13(3), sustentados pelo documento ou pressuposto expresso da projecção',
...conditions,
]});
export const onboardSupplyTreatments:OperationTreatment[] = [
make('onboard_seagoing_ship','Abastecimento de embarcação de navegação marítima em alto mar','c',[
'Embarcação identificada que efectua navegação marítima em alto mar e assegura transporte remunerado de passageiros ou actividade comercial, industrial ou de pesca; utilização identificada, não qualquer barco de recreio',
]),
make('onboard_rescue_coastal_ship','Abastecimento de embarcação de salvamento, assistência marítima ou pesca costeira','d',[
'Embarcação identificada de salvamento, assistência marítima ou pesca costeira; actividade identificada, não presumida pelo nome do operador',
]),
make('onboard_departing_warship','Abastecimento de embarcação de guerra com destino estrangeiro','e',[
'Embarcação de guerra identificada que deixa o país com destino a porto ou ancoradouro situado no estrangeiro; saída e destino identificados, não simples utilização militar',
]),
make('onboard_international_aircraft','Abastecimento de avião de companhia principalmente internacional','h',[
'Avião identificado utilizado por companhia de navegação aérea que se dedica principalmente ao tráfego internacional nos termos de13(1)(g); companhia e utilização identificadas, não apenas um voo internacional isolado',
]),
];
export function isOnboardSupply(id:string):boolean { return onboardSupplyTreatments.some(rule=>rule.id===id); }
export function onboardSupplyIssue(id:string,category:unknown):string|null {
if(!isOnboardSupply(id))return null;
if(!supplyCategories.some(([value])=>value===category))return 'Identifique a natureza do abastecimento segundo o artigo13(3). Informação em falta não significa ausência de bebidas ou provisões; nenhum montante fiscal foi presumido.';
if(id==='onboard_rescue_coastal_ship'&&(category==='provisions'||category==='beverages'))return 'As provisões de bordo estão excluídas da isenção de13(1)(d), incluindo bebidas, nas embarcações de salvamento, assistência marítima e pesca costeira. Esta isenção não se aplica; o tratamento fiscal alternativo deve ser identificado, sem presumir taxa ou zero.';
if(category==='beverages'&&id!=='onboard_departing_warship')return 'Bebidas em13(1)(c/h):13(2) prevê isenção por dedução ou restituição, não isenção directa deste fornecimento; para esse efeito não se aplica20(1)(d). O montante liquidado e o procedimento aplicável não são determinados neste incremento: sem crédito, restituição, taxa ou zero automáticos. Conserve o preço e identifique o tratamento antes do apuramento.';
return null;
}
+276
View File
@@ -0,0 +1,276 @@
import { acquisitionScope, readAcquisitionStore } from './iva-acquisitions.ts';
import { fundraisingError, type FundraisingContext } from './iva-fundraising.ts';
import { pharmaAnnexEntry, pharmaAnnexReference, pharmaAnnexSource, pharmaAnnexVersion } from './iva-pharma-annex.ts';
import { annexIEntry, annexIReference, annexISource, annexIVersion } from './iva-annex-i.ts';
import { productionOptionCheck, productionOptionVersion, type ProductionTaxOption } from './iva-production-option.ts';
import { temporaryBenefits, temporaryBenefit, temporaryBenefitNotice, temporaryBenefitVersion } from './iva-temporary-benefits.ts';
import { directExportTreatments } from './iva-export-operations.ts';
import { exportBeneficiaryTreatments } from './iva-export-beneficiaries.ts';
import { specialRegimeTreatments, specialRegimeIssue, specialRegimeOptions, isSpecialRegime, type SpecialRegime } from './iva-special-regimes.ts';
import { internationalAssetTreatments } from './iva-international-assets.ts';
import { exportServiceTreatments, isExportService } from './iva-export-services.ts';
import { onboardSupplyTreatments, onboardSupplyIssue, supplyCategories, isOnboardSupply, type SupplyCategory } from './iva-onboard-supplies.ts';
import { monthlySalesFromDraft, readMonthlyIvaSettings } from './monthly-iva.ts';
import { addFractions, decimalFraction, fraction, fractionLabel, fractionPresentation, type FiscalFraction } from './fiscal-rational.ts';
export const operationVersion = 'iva-operations-l1/2';
// The accepted v2 full-catalogue key predates scoped keys. Freeze its members
// so later, independent catalogue additions cannot invalidate those snapshots.
const legacyV2TreatmentIds = ['general','private_health','private_education','private_training','personal_lessons','export_goods','housing_rent','public_health','public_education','public_training','foreign_operation','other'];
const source2022 = 'Lei22/2022, BR250, 2.º suplemento, PDF1–4 (2252(25)–(28)); arts.1/2/6; efeitos01/01/2023';
const source2016 = 'CIVA republicado Lei13/2016, BR156, 10.º suplemento, PDF9–15 (1426(267)–(273))';
const source2025 = 'Lei10/2025, BR248, suplemento1, PDF14–15 (2180(14)–(15)); arts.1/2/3/5; efeitos01/01/2026';
const healthGoodsSource = 'CIVA republicado Lei13/2016, PDF9, p.1426(267), art.9(1)(b–f); PDF15, p.1426(273), art.19(1); Lei22/2022 art.1, PDF1, p.2252(25), mantém9(1)(b–f). Âmbito técnico2026/MZN';
const internalOperation = 'Operação interna localizada em Moçambique; não é importação nem operação localizada no estrangeiro';
export const modeloA06Correspondence = 'P001 residual:identificação05/06/07 do exemplar preservada. Não há atribuição automática06por localização estrangeira ou operação desconhecida. Retoma apenas com esclarecimento concreto novo;provas anteriores preservadas. Esta limitação não impede os tratamentos independentes já disponíveis.';
export type OperationTreatment = {id:string; label:string; field:string|null; rate:number|null; article:string; source:string; conditions:string[];logicVersion?:string};
const nonprofitConditions = [
'Não distribui nem disponibiliza lucros; os corpos gerentes não têm interesse directo ou indirecto nos resultados, por si ou interposta pessoa',
'Escrituração abrange todas as actividades e está à disposição dos serviços fiscais para comprovação',
'Preços homologados pela autoridade competente ou, quando não susceptíveis de homologação, inferiores aos de operações análogas das empresas comerciais sujeitas a imposto',
'Não entra em concorrência directa com sujeitos passivos do imposto',
];
function socialTreatment(id:string,label:string,article:string,conditions:string[],nonprofit:boolean):OperationTreatment {
return {id,label,field:'07',rate:0,article:`CIVA arts.9(2)(${article}),10(${nonprofit?'2':'1'}),19(1)`,source:'CIVA republicado Lei13/2016, PDF9, p.1426(267), art.9(2)(a/c/d); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26),10(1–2). Âmbito técnico2026/MZN',conditions:[internalOperation,...(nonprofit?nonprofitConditions:['Entidade pública: órgão ou instituição da Administração Pública que desempenha funções administrativas do Estado, nos termos da legislação aplicável']),...conditions]};
}
const culturalSource = 'CIVA republicado Lei13/2016, PDF9, p.1426(267), art.9(2)(e–g); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF1, p.2252(25), mantém9(2)(e–g), e PDF2, p.2252(26),10(1–2). Âmbito técnico2026/MZN';
const culturalTreatments:OperationTreatment[] = ([false,true] as const).flatMap(nonprofit=>{
const suffix=nonprofit?'nonprofit':'public',entity=nonprofit?'organismo sem finalidade lucrativa':'entidade pública';
const make=(id:string,label:string,article:string,conditions:string[]):OperationTreatment=>({...socialTreatment(id,label,article,conditions,nonprofit),source:culturalSource});
return [
make(`cultural_visits_${suffix}`,`Visitas culturais/naturais — ${entity}`,'e',['Visita, guiada ou não, a museu, galeria de arte, monumento, parque, perímetro florestal, jardim botânico/zoológico ou similar pertencente ao Estado, a entidade pública ou a entidade sem finalidade lucrativa','Serviço efectuado pela própria entidade, por intermédio dos seus próprios agentes; organismo sem finalidade lucrativa devidamente autorizado quando aplicável','Se houver bens, são transmissões estreitamente conexas com essa visita; não venda autónoma nem serviço de intermediário']),
make(`religious_personnel_${suffix}`,`Cedência de pessoal religiosa/filosófica — ${entity}`,'f',['Cedência de pessoal efectuada por instituição religiosa ou filosófica identificada','Destino identificado: actividade isenta nos termos do CIVA, com fundamento específico, ou assistência espiritual; não qualquer fornecimento de mão-de-obra']),
];
});
culturalTreatments.push({id:'statutory_membership',label:'Serviços colectivos aos associados por quota estatutária',field:'07',rate:0,article:'CIVA arts.9(2)(g),10(2),19(1)',source:culturalSource,conditions:[internalOperation,...nonprofitConditions,'Serviços efectuados no interesse colectivo dos próprios associados por organismo sem finalidade lucrativa','Objectivos de natureza política, sindical, religiosa, patriótica, filantrópica, recreativa, desportiva, cultural, cívica ou de representação de interesses económicos, identificados','A única contraprestação é uma quota fixada nos respectivos estatutos; não pagamentos adicionais por serviços individuais']});
const listedGoodsTreatments:OperationTreatment[] = [
['maize','Milho','Bem transmitido identificado como milho'],
['maize_flour','Farinha de milho','Bem transmitido identificado como farinha de milho'],
['rice','Arroz','Bem transmitido identificado como arroz'],
['bread','Pão','Bem transmitido identificado como pão'],
['iodised_salt','Sal iodado','Sal identificado como iodado; não qualquer sal'],
['infant_powdered_milk','Leite em pó para lactente até um ano','Leite em pó identificado como destinado a lactente até um ano; não qualquer leite ou alimento infantil'],
['wheat','Trigo','Bem transmitido identificado como trigo'],
['wheat_flour','Farinha de trigo','Bem transmitido identificado como farinha de trigo'],
['fresh_chilled_tomato','Tomate fresco ou refrigerado','Tomate identificado como fresco ou refrigerado; não alargar automaticamente a conserva ou preparação'],
['potato','Batata','Bem transmitido identificado como batata'],
['onion','Cebola','Bem transmitido identificado como cebola'],
['frozen_horse_mackerel','Carapau congelado','Peixe identificado como carapau congelado; não qualquer espécie ou estado de conservação'],
['lighting_kerosene','Petróleo de iluminação','Produto identificado como petróleo de iluminação; não qualquer combustível'],
['domestic_lpg','Gás doméstico — GPL','Produto identificado como gás doméstico GPL; não qualquer gás industrial'],
['jet_fuel','Jet fuel','Produto identificado como jet fuel; não qualquer combustível de transporte'],
['eligible_bicycles','Bicicletas comuns e de ferro até 4 velocidades','Produto identificado na enumeração legal «bicicletas comuns e de ferro até 4 velocidades», com características sustentadas; não qualquer veículo'],
['condoms','Preservativos','Bem transmitido identificado como preservativo'],
['insecticides','Insecticidas','Bem transmitido identificado como insecticida; não qualquer produto químico'],
].map(([id,label,condition])=>({id:`listed_${id}`,label:`Lista legal — ${label}`,field:'05',rate:0,article:'CIVA arts.9(10),19(1)(b)(v), redacção Lei22/2022',source:'Lei22/2022 art.1, PDF2, p.2252(26),9(10); CIVA republicado Lei13/2016, PDF15, p.1426(273),19(1)(b)(v). Âmbito técnico2026/MZN',conditions:[internalOperation,'Transmissão do próprio bem enumerado, identificado; não um serviço autónomo nem extensão por sector, marca ou destino',condition]}));
export const operationTreatments:OperationTreatment[] = [
...exportServiceTreatments,
...onboardSupplyTreatments,
...internationalAssetTreatments,
...directExportTreatments,
...exportBeneficiaryTreatments,
...specialRegimeTreatments,
...temporaryBenefits.map(item=>({id:item.id,label:`Benefício terminado31/12/2025 — ${item.label}`,field:null,rate:null,article:`CIVA art.${item.article}`,source:`${item.source} CIVA republicado Lei13/2016,9(14),PDF10/p.1426(268),apenas para9(13)(b/f). Âmbito:cessação nas operações internas2026/MZN;sem cálculo histórico.`,conditions:[],logicVersion:temporaryBenefitVersion})),
{id:'annexI_goods',label:'Equipamento, sementes e outros bens do Anexo I — artigo9(12)(h)',field:'07',rate:0,logicVersion:annexIVersion,article:'CIVA arts.9(12)(h),19(1); Lei22/2022 art.3(1)',source:`CIVA republicado Lei13/2016, PDF10, p.1426(268),9(12)(h), e PDF15, p.1426(273),19(1); rectificação BR89/2017, PDF1, p.569; ${annexISource}. Âmbito técnico2026/MZN`,conditions:[internalOperation,'O bem transmitido corresponde ao código e à designação da posição escolhida no Anexo I; não basta a actividade agrícola, a marca ou uma indicação genérica de equipamento','Qualificadores expressos na posição conferidos e fundamentados, incluindo natureza, destino, certificação, peso, capacidade ou potência quando exigidos nessa linha; não acrescentar condições a linhas que não as exigem']},
{id:'pharma_manufacturing_inputs',label:'Bens do Anexo III para fabrico de medicamentos — estabelecimento integrado no SNS',field:'07',rate:0,logicVersion:pharmaAnnexVersion,article:'CIVA arts.9(1)(g),19(1); Lei22/2022 art.3(1)',source:`CIVA republicado Lei13/2016, PDF9, p.1426(267),9(1)(g), e PDF15, p.1426(273),19(1); rectificação BR89/2017, PDF1, p.569; ${pharmaAnnexSource}. Âmbito técnico2026/MZN`,conditions:[internalOperation,'Transmissão efectuada pelo próprio estabelecimento público ou privado identificado, integrado no Serviço Nacional de Saúde; não basta que o adquirente ou destino seja um hospital','Bens a utilizar como matérias-primas, produtos intermédios ou componentes para o fabrico de medicamentos, com utilização/fundamento identificados; não mera venda de produto acabado ou utilização genérica','Bem corresponde cumulativamente ao código e à designação da linha seleccionada no Anexo III; confirmar as especificações aplicáveis sem corrigir ou completar a pauta por suposição']},
...([false,true] as const).map(nonprofit=>({...socialTreatment(`fundraising_${nonprofit?'nonprofit':'public'}`,`Angariação ocasional de fundos — ${nonprofit?'organismo sem finalidade lucrativa':'entidade pública'}`,'h',['Actividade habitual isenta identificada:9(1)(a),9(2)(a/b/c/d/e/g) ou9(3)(a/b), com condições dessa isenção e fundamento identificados','Manifestação ocasional destinada à angariação de fundos em proveito exclusivo da entidade organizadora','Total anual declarado inclui esta manifestação e as realizadas fora deste dossier; não superior a oito no ano'],nonprofit),logicVersion:'fundraising/1',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(2)(h); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF1, p.2252(25),9(1–3), e PDF2, p.2252(26),10(1–2). Âmbito técnico2026/MZN'})),
...(['agriculture','forestry','livestock','fishing'] as const).flatMap((kind,index)=>{
const label=['Produção agrícola, avicultura e apicultura','Produção silvícola','Produção pecuária','Pesca'][index],letter=['a','b','c','d'][index];
const conditions=[internalOperation,'Operação no âmbito da própria produção identificada, utilizando os próprios recursos; não mera revenda/comércio','Se houver transformação, é acessória, pelo próprio produtor sobre produtos da sua produção, por meios geralmente utilizados nas respectivas explorações'];
const source=`CIVA republicado Lei13/2016, PDF10, p.1426(268),9(7)(${letter}); PDF11, p.1426(269),11; PDF15, p.1426(273),19(1)(b)(v); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(7). Âmbito técnico2026/MZN`;
const exempt:OperationTreatment={id:`production_${kind}`,label:`${label} — isenção`,field:kind==='agriculture'?'05':'07',rate:0,article:`CIVA arts.9(7)(${letter}),19(1)${kind==='agriculture'?'(b)(v)':',11'}`,source,conditions:[...conditions,...(kind==='agriculture'?[]:['Regime de isenção aplicável nesta operação: não existe opção de tributação eficaz do art.11 no período; fundamento/histórico identificado'])]};
return kind==='agriculture'?[exempt]:[exempt,{id:`production_${kind}_opted`,logicVersion:productionOptionVersion,label:`${label} — opção de tributação eficaz`,field:'01',rate:16,article:`CIVA arts.9(7)(${letter}),11,15(1),17(1),19(1)(a),34`,source:`${source}; ${source2022}; ${source2025}`,conditions:[...conditions,'Opção declarada à Direcção da Área Fiscal competente, na declaração adequada; se opção no início, consta da declaração de início da actividade','Operação no regime normal por opção eficaz; contraprestação completa, sem base especial do art.15(2) ou outro tratamento próprio']}];
}),
...listedGoodsTreatments,
{...socialTreatment('public_security','Bens e serviços ligados à segurança por entidade pública','b',['Transmissão de bens ou prestação ligada à segurança identificada e efectuada pela própria entidade pública; não presumir segurança social nem extensão a prestador privado contratado'],false),source:'CIVA republicado Lei13/2016, PDF9, p.1426(267),9(2)(b); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF1, p.2252(25), mantém9(2)(b); PDF2, p.2252(26),10(1). Âmbito técnico2026/MZN'},
{id:'official_military_supplies',label:'Fornecimentos oficiais militares/paramilitares elegíveis',field:'07',rate:0,article:'CIVA arts.9(11),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(11); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(11). Âmbito técnico2026/MZN',conditions:[internalOperation,'Bem/serviço no fornecimento de material de guerra e de aquartelamento ou fardamento militar/paramilitar, identificado','Destino de utilização oficial das Forças de Defesa e Segurança Nacional; actividade efectuada exclusivamente para aqueles serviços','Estabelecimento reconhecido pelo Ministério competente, com reconhecimento identificado; não basta o cliente ser militar']},
{id:'sisa_subject_operation',label:'Operação sujeita a SISA, ainda que dela isenta',field:'07',rate:0,article:'CIVA arts.9(12)(d),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(12)(d); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(12)(d). Âmbito técnico2026/MZN',conditions:[internalOperation,'Operação e fundamento de sujeição a SISA identificados, ainda que exista isenção desse imposto; não qualquer operação imobiliária','Esta linha corresponde à operação sujeita a SISA, não a locação, mediação ou outro serviço autónomo; este bloco não calcula SISA']},
{id:'exempt_activity_asset_sale',label:'Alienação de bem exclusivamente afecto a actividade isenta',field:'07',rate:0,article:'CIVA arts.9(12)(e),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(12)(e); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(12)(e). Âmbito técnico2026/MZN',conditions:[internalOperation,'Transmissão de bem identificado, com histórico de afectação disponível','Bem afecto exclusivamente a sector de actividade isento; não mera afectação parcial ou existência de alguma operação isenta na entidade']},
{id:'no_deduction_right_asset_sale',label:'Alienação de bem sem direito anterior à dedução',field:'07',rate:0,article:'CIVA arts.9(12)(e),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(12)(e); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(12)(e). Âmbito técnico2026/MZN',conditions:[internalOperation,'Transmissão de bem identificado, com histórico fiscal da aquisição/afectação disponível','Bem não foi objecto de direito à dedução, com fundamento identificado; não basta não ter exercido um direito existente nem desconhecer o histórico']},
{id:'excluded_deduction_asset_sale',label:'Alienação de bem adquirido com exclusão do artigo 20',field:'07',rate:0,article:'CIVA arts.9(12)(e),20,19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(12)(e); PDF15, p.1426(273),19(1)/20(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(12)(e), e PDF3, p.2252(27),20(2–3). Âmbito técnico2026/MZN',conditions:[internalOperation,'Transmissão de bem identificado e aquisição correspondente documentada ou expressamente pressuposta','Aquisição feita com exclusão do direito à dedução nos termos do artigo20: identificar número/alínea aplicável e conferir as excepções do20(3); não assumir exclusão apenas por falta de documento ou dedução não exercida']},
{id:'special_tax_games',label:'Jogos e operações sujeitos ao imposto especial sobre o jogo',field:'07',rate:0,article:'CIVA arts.9(8),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(8); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(8). Âmbito técnico2026/MZN',conditions:[internalOperation,'Exploração/prática de jogo de fortuna ou azar ou diversão social nos termos da legislação própria, respectiva comissão, título de aposta ou bilhete de acesso/ingresso à área de jogo, identificado','Esta operação está sujeita ao imposto especial sobre o jogo, com fundamento identificado; não qualquer entretenimento ou serviço acessório autónomo; o imposto especial não é calculado neste bloco']},
{id:'stamped_values',label:'Transmissão de valores selados',field:'07',rate:0,article:'CIVA arts.9(12)(a),19(1), redacção Lei22/2022',source:'Lei22/2022 art.1, PDF2, p.2252(26),9(12)(a); CIVA republicado Lei13/2016, PDF15, p.1426(273),19(1). Âmbito técnico2026/MZN',conditions:[internalOperation,'Bem transmitido identificado como valor selado, com natureza sustentada pelo documento ou pressuposto da operação','A linha corresponde à transmissão do valor selado; comissão de venda ou serviço autónomo não é abrangido automaticamente por esta opção']},
{id:'public_passenger_transport',label:'Serviço de transporte público de passageiros',field:'07',rate:0,article:'CIVA arts.9(12)(j),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(12)(j); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(12)(j). Âmbito técnico2026/MZN',conditions:[internalOperation,'Serviço identificado como transporte público de passageiros, com natureza da prestação sustentada; não inferido apenas da natureza pública do prestador','A linha corresponde ao transporte de passageiros; não transporte de mercadorias, aluguer autónomo de veículo ou outro serviço acessório sem enquadramento próprio']},
{id:'industrial_feed',label:'Rações de produção industrial para animais elegíveis',field:'05',rate:0,article:'CIVA arts.9(12)(f),19(1)(b)(v)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(12)(f); PDF15, p.1426(273),19(1)(b)(v); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(12)(f). Âmbito técnico2026/MZN',conditions:[internalOperation,'Transmissão de bens resultantes de actividade industrial de produção de rações, identificada; não presumir isenção de qualquer alimento para animais','Rações destinadas à alimentação de animais de reprodução e abate para consumo humano, com destino identificado']},
{id:'industrial_feed_inputs',label:'Insumos enumerados para produção industrial de rações',field:'07',rate:0,article:'CIVA arts.9(12)(g),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(12)(g); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(12)(g). Âmbito técnico2026/MZN',conditions:[internalOperation,'Bem identificado na enumeração: grão de soja, bagaço de soja, soja integral, farinha de peixe, farinha de carne, pós de osso, monofosfato de cálcio, lisina ou metionina','Utilização como matéria-prima na actividade industrial de produção de rações destinadas à alimentação de animais de reprodução e abate para consumo humano, identificada']},
{id:'veterinary_goods',label:'Agulhas, seringas e medicamentos de uso veterinário',field:'07',rate:0,article:'CIVA arts.9(12)(i),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(12)(i); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(12)(i). Âmbito técnico2026/MZN',conditions:[internalOperation,'Transmissão de agulha, seringa ou medicamento identificado; não qualquer equipamento ou serviço veterinário','Uso veterinário identificado para os bens da operação']},
{id:'agricultural_services',label:'Serviços agrícolas de canais, regadio, drenagem e pulverização',field:'07',rate:0,article:'CIVA arts.9(15),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(15); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(15). Âmbito técnico2026/MZN',conditions:[internalOperation,'Serviço identificado: abertura de canais, ceifa, drenagem, fornecimento de água para irrigação, limpeza de valas de drenagem ou pulverização da terra','Serviço efectuado no âmbito da actividade agrícola, com afectação identificada; não qualquer obra, limpeza ou fornecimento de água']},
{id:'author_rights',label:'Direitos de autor pelo autor, herdeiro ou legatário',field:'07',rate:0,article:'CIVA arts.9(9)(a),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(9)(a); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(9). Âmbito técnico2026/MZN',conditions:[internalOperation,'Operação identificada como transmissão de direitos de autor ou autorização para utilização de obra intelectual','Efectuada pelo próprio autor, seu herdeiro ou legatário, com qualidade identificada; não presumir isenção de revenda/intermediação por terceiro']},
{id:'cultural_publications',label:'Jornais, revistas e livros de natureza elegível',field:'07',rate:0,article:'CIVA arts.9(9)(b),19(1)',source:'CIVA republicado Lei13/2016, PDF10, p.1426(268),9(9)(b); PDF15, p.1426(273),19(1); Lei22/2022 art.1, PDF2, p.2252(26), mantém9(9). Âmbito técnico2026/MZN',conditions:[internalOperation,'Transmissão de jornal, revista ou livro identificado; não qualquer material escolar, serviço editorial ou fornecimento autónomo','Natureza cultural, educativa, técnica ou recreativa da publicação identificada e sustentada; não inferida apenas do nome do fornecedor ou sector']},
...culturalTreatments,
{id:'general',label:'Operação interna geral',field:'01',rate:16,article:'CIVA arts.1,6,15(1),17(1–2); art.34 (Lei10/2025)',source:`${source2016}; ${source2022}; ${source2025}`,conditions:['Operação localizada e tributável em Moçambique, no regime normal','Contraprestação completa; sem base especial do art.15(2), isenção ou taxa reduzida']},
{id:'private_health',label:'Serviços médicos e sanitários privados',field:'03',rate:5,article:'CIVA arts.15(10),17-A(a)',source:source2022,conditions:['Serviço médico/sanitário ou operação estreitamente conexa','Prestador hospitalar privado, clínica, dispensário ou similar']},
{id:'private_education',label:'Ensino privado reconhecido',field:'03',rate:5,article:'CIVA arts.15(10),17-A(b)',source:source2022,conditions:['Ensino ou bens/serviços conexos prestados pelo estabelecimento','Estabelecimento privado integrado no Sistema Nacional de Ensino e reconhecido pelo Ministério competente']},
{id:'private_training',label:'Formação profissional privada',field:'03',rate:5,article:'CIVA arts.15(10),17-A(c)',source:source2022,conditions:['Formação profissional ou fornecimentos conexos pelo prestador, não venda autónoma de materiais','Prestador privado']},
{id:'personal_lessons',label:'Lições ministradas a título pessoal',field:'03',rate:5,article:'CIVA arts.15(10),17-A(d)',source:source2022,conditions:['Lições ministradas a título pessoal','Matérias de ensino escolar ou superior']},
{id:'export_goods',label:'Exportação de bens pelo vendedor',field:'05',rate:0,article:'CIVA arts.13(1)(a),19(1)(b)(i)',source:source2016,conditions:['Bens expedidos/transportados para o estrangeiro pelo vendedor ou terceiro por sua conta','Saída documentada, ou pressuposto expresso da projecção; não mera venda a cliente estrangeiro']},
{id:'housing_rent',label:'Locação de imóvel para habitação',field:'07',rate:0,article:'CIVA art.9(5), redacção Lei22/2022; art.19(1)',source:source2022,conditions:['Locação de imóvel para fins de habitação','Não é hospedagem nem locação comercial/industrial ou serviço autónomo']},
{id:'public_health',label:'Serviços médicos e sanitários públicos',field:'07',rate:0,article:'CIVA arts.9(1)(a),10(1),19(1)',source:source2022,conditions:['Serviço médico/sanitário ou operação estreitamente conexa','Estabelecimento hospitalar público, dispensário ou similar; natureza pública confirmada']},
{id:'public_education',label:'Ensino público reconhecido',field:'07',rate:0,article:'CIVA arts.9(3)(a),10(1),19(1)',source:source2022,conditions:['Ensino ou fornecimentos conexos pelo estabelecimento','Estabelecimento público integrado no Sistema Nacional de Ensino e reconhecido pelo Ministério competente']},
{id:'public_training',label:'Formação profissional pública',field:'07',rate:0,article:'CIVA arts.9(3)(b),10(1),19(1)',source:source2022,conditions:['Formação profissional ou fornecimentos conexos pelo prestador','Prestador público']},
{id:'financial_stamp',label:'Operação bancária/financeira sujeita a Selo',field:'07',rate:0,article:'CIVA art.9(4), redacção Lei22/2022; art.19(1)',source:`${source2022}; ${source2016}`,conditions:['A operação é bancária ou financeira, não um serviço acessório autónomo','Sujeição a Imposto do Selo identificada para esta operação; não depende de calcular o Selo neste bloco']},
{id:'insurance_stamp',label:'Seguro/resseguro ou mediação conexa sujeitos a Selo',field:'07',rate:0,article:'CIVA art.9(6), redacção Lei22/2022; art.19(1)',source:`${source2022}; ${source2016}`,conditions:['Seguro/resseguro ou serviço conexo efectuado por corrector ou outro mediador de seguros','Sujeição a Imposto do Selo identificada para esta operação']},
{id:'public_waste',label:'Remoção de lixo pública ou por entidade contratada',field:'07',rate:0,article:'CIVA art.9(12)(b), redacção Lei22/2022; art.19(1)',source:`${source2022}; ${source2016}`,conditions:['Prestação de serviço de remoção de lixo, não qualquer serviço de limpeza','Efectuada por entidade pública ou por entidade por ela contratada, com relação identificada']},
{id:'public_funeral',label:'Serviços funerários/cremação públicos e bens acessórios',field:'07',rate:0,article:'CIVA art.9(12)(c), redacção Lei22/2022; art.19(1)',source:`${source2022}; ${source2016}`,conditions:['Serviço funerário/cremação ou transmissão de bem acessório a esse serviço','Efectuado por entidade pública; não aplicar automaticamente a funerária privada']},
{id:'health_assistive',label:'Bens de compensação da deficiência, próteses e braille',field:'07',rate:0,article:'CIVA arts.9(1)(b),19(1)',source:healthGoodsSource,conditions:[internalOperation,'Bem identificado na enumeração: cadeira de rodas/veículo semelhante, aparelho/máquina/impressora braille, prótese ou material de compensação','Destino documentado conforme a categoria: deficiência, substituição de membro/órgão, fractura, pessoa invisual ou correcção da audição; não qualquer equipamento médico']},
{id:'human_materials',label:'Órgãos, sangue e leite humanos',field:'07',rate:0,article:'CIVA arts.9(1)(c),19(1)',source:healthGoodsSource,conditions:[internalOperation,'Transmissão de órgãos, sangue ou leite de origem humana, identificada; não produto de origem animal nem serviço autónomo']},
{id:'patient_transport',label:'Transporte de doentes/feridos por organismo autorizado',field:'07',rate:0,article:'CIVA arts.9(1)(d),19(1)',source:healthGoodsSource,conditions:[internalOperation,'Transporte de doente ou ferido em ambulância ou outro veículo apropriado','Organismo que efectua o transporte devidamente autorizado, com autorização identificada; não basta o destino hospitalar']},
{id:'mosquito_nets',label:'Transmissão de redes mosquiteiras',field:'07',rate:0,article:'CIVA arts.9(1)(e),19(1)',source:healthGoodsSource,conditions:[internalOperation,'Bem identificado como rede mosquiteira; não extensão automática a outros produtos de prevenção']},
{id:'medicines',label:'Medicamentos e artigos terapêuticos/profilácticos elegíveis',field:'07',rate:0,article:'CIVA arts.9(1)(f),19(1)',source:healthGoodsSource,conditions:[internalOperation,'Medicamento/especialidade farmacêutica ou produto farmacêutico exclusivamente terapêutico/profiláctico; ou pasta, gaze, algodão hidrófilo, tira/penso adesivo ou análogo','Finalidade elegível identificada: terapêutica/profiláctica nos produtos farmacêuticos; higiénica, medicinal ou cirúrgica nos artigos enumerados, mesmo impregnados/revestidos; não qualquer produto vendido por farmácia']},
...([false,true] as const).flatMap(nonprofit=>{
const suffix=nonprofit?'nonprofit':'public',entity=nonprofit?'organismo sem finalidade lucrativa':'entidade pública';
return [
socialTreatment(`social_assistance_${suffix}`,`Assistência social — ${entity}`,'a',['Prestação de assistência social ou transmissão de bens estreitamente conexa, identificada','Fins e objecto da entidade reconhecidos pelas autoridades competentes, com fundamento identificado'],nonprofit),
socialTreatment(`social_care_${suffix}`,`Equipamentos sociais/creches/lares — ${entity}`,'c',['Prestação ou bem estreitamente conexo no exercício da actividade habitual de creche, jardim de infância, centro de tempos livres, lar ou outro equipamento social enumerado no art.9(2)(c)','Equipamento pertencente à entidade e fins/objecto reconhecidos pelas autoridades competentes; não qualquer alojamento ou empresa de cuidados'],nonprofit),
socialTreatment(`activity_facilities_${suffix}`,`Prática artística/desportiva/recreativa — ${entity}`,'d',['Serviço efectuado pela própria entidade que explora o estabelecimento ou instalação','Instalação destinada à prática artística, desportiva, recreativa ou de educação física e serviço prestado a quem a pratica; não isenção automática de bilhetes para espectadores'],nonprofit),
];
}),
{id:'foreign_operation',label:'Operação no estrangeiro — analisar territorialidade',field:null,rate:null,article:'CIVA art.6: localização por natureza da operação; art.19(1)(b)(ii) não determina sozinho a caixa06 do formulário',source:source2016,conditions:[]},
{id:'other',label:'Outra operação / enquadramento ainda desconhecido',field:null,rate:null,article:'Fundamento específico ainda necessário; não presumir taxa ou isenção',source:'Sem fonte operacional determinada para esta linha',conditions:[]},
];
export type SalesOperation = {id:string;period:string;description:string;establishment:string;amount:string;basis:''|'net'|'included';treatment:string;confirmed:number[];evidence:string;sourceAmount:string|null;sourcePeriod:string;sourceCurrency:string;source:string;taxOption?:ProductionTaxOption;fundraiser?:FundraisingContext;pharmaAnnexItem?:string;annexIItem?:string;annexIOnly?:boolean;temporaryBenefitOrigin?:string;relatedExport?:{id:string;description:string;treatment:string};supplyCategory?:SupplyCategory;specialRegime?:SpecialRegime; splitSource?:{id:string;amount:string|null;period:string;currency:string;basis:string}};
export type SalesBook = {currency:string;rows:SalesOperation[];periods:Array<{period:string;complete:boolean}>; result?:SalesResult; history?:SalesResult[]};
export type SalesLineResult = {id:string;field:string|null;net:string|null;vat:string|null;gross:string|null;rate:number|null;status:'calculated'|'exempt'|'indeterminate';reason:string;article:string;source:string;exact?:{net:FiscalFraction;vat:FiscalFraction;gross:FiscalFraction}};
export type SalesResult = {version:string;revision:number;calculatedAt:string;opportunity:string;location:string;currency:string;key:string;inputs:SalesOperation[];rows:SalesLineResult[];periods:Array<{period:string;fields:Record<string,string|null>;exactFields?:Record<string,FiscalFraction|null>;reasons:string[]}>;rounding:string};
type Store = ReturnType<typeof readAcquisitionStore> & {salesOperations?:Record<string,SalesBook>};
export function newSalesOperation(id:string,period:string,currency:string):SalesOperation {return {id,period,description:'',establishment:'',amount:'',basis:'',treatment:'other',confirmed:[],evidence:'',sourceAmount:null,sourcePeriod:period,sourceCurrency:currency,source:'Introdução directa; projecção, não declaração submetida'};}
export function continueAnnexIOperation(row:SalesOperation,targetId:string):SalesOperation {
const entry=annexIEntry(row.annexIItem),target=operationTreatments.find(t=>t.id===targetId);
if(row.treatment!=='annexI_goods'||!entry?.relatedTreatments?.includes(targetId)||!target)throw new Error('O tratamento de continuidade não corresponde à posição escolhida; dados conservados.');
return {...row,treatment:targetId,confirmed:[],annexIOnly:false,source:`${row.source}; continuidade expressamente escolhida a partir de ${annexIReference(entry)} para ${target.label}; rever condições do tratamento, sem alterar montante/moeda/contexto`};
}
export function continueTemporaryOperation(row:SalesOperation,targetId:string):SalesOperation {
const benefit=temporaryBenefit(row.treatment),target=operationTreatments.find(item=>item.id===targetId);
if(!benefit||!target||temporaryBenefit(targetId))throw new Error('Escolha um enquadramento actual distinto do benefício terminado; dados conservados.');
return {...row,treatment:targetId,confirmed:[],temporaryBenefitOrigin:benefit.id,source:`${row.source}; continuidade expressamente escolhida de ${benefit.id}/${benefit.branch}, CIVA art.${benefit.article}, termo31/12/2025, ${temporaryBenefitVersion}, para ${target.label}; ${benefit.source}; montante/moeda/período conservados; rever condições, sem cálculo automático`};
}
export function referenceExportOperation(row:SalesOperation,related:SalesOperation):SalesOperation {
if(!isExportService(row.treatment)||row.id===related.id)throw new Error('Escolha outra operação para referenciar neste serviço; dados conservados.');
return {...row,relatedExport:{id:related.id,description:related.description,treatment:related.treatment},confirmed:[]};
}
export function salesBook(draft:Record<string,unknown>):SalesBook {
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.salesOperations!==undefined&&(!store.salesOperations||typeof store.salesOperations!=='object'||Array.isArray(store.salesOperations)))throw new Error('Formato das operações IVA não recuperável; dados preservados, sem substituição.');
const book=store.salesOperations?.[acquisitionScope(draft)];
if(!book)return {currency:String(draft.currency??''),rows:[],periods:[]};
if(typeof book.currency!=='string'||!Array.isArray(book.rows)||!Array.isArray(book.periods)||book.rows.some(r=>!r||Object.keys(newSalesOperation('','','')).some(k=>k==='confirmed'?!Array.isArray(r.confirmed)||r.confirmed.some(c=>!Number.isInteger(c)):k==='sourceAmount'?!(r.sourceAmount===null||typeof r.sourceAmount==='string'):typeof r[k as keyof SalesOperation]!=='string'))||book.periods.some(p=>!p||!/^\d{4}-\d{2}$/.test(p.period)||typeof p.complete!=='boolean'))throw new Error('Operações IVA não recuperáveis; os dados originais foram preservados.');
return book;
}
export function saveSalesBook(draft:Record<string,unknown>,book:SalesBook):string {const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;return JSON.stringify({...store,salesOperations:{...store.salesOperations,[acquisitionScope(draft)]:book}});}
export function reuseSales(draft:Record<string,unknown>,book:SalesBook):SalesBook {
const source=monthlySalesFromDraft(draft),settings=readMonthlyIvaSettings(String(draft.monthly_iva_settings??''));
if(!/^2026-(0[1-9]|1[0-2])$/.test(settings.start)||Number(settings.start.slice(5))+source.amounts.length>13)throw new Error('Defina o período da projecção dentro de2026 antes de reutilizar vendas.');
if(book.currency!==draft.currency)throw new Error('Moeda da origem divergente; valores preservados, sem conversão.');
const rows=[...book.rows],periods=[...book.periods];
source.amounts.forEach((value,index)=>{const period=`2026-${String(Number(settings.start.slice(5))+index).padStart(2,'0')}`;
if(!periods.some(p=>p.period===period))periods.push({period,complete:false});
if(!rows.some(r=>r.sourcePeriod===period&&r.source!=='Introdução directa; projecção, não declaração submetida'))rows.push({...newSalesOperation(`sales-${period}`,period,book.currency),description:`Vendas do plano — ${period}`,amount:value??'',basis:settings.basis==='unknown'?'':settings.basis,sourceAmount:value,source:source.source,evidence:source.source});
});return {...book,rows,periods};
}
export function splitSales(book:SalesBook,id:string,newId:string):SalesBook {
const row=book.rows.find(r=>r.id===id);if(!row)throw new Error('Operação de origem não encontrada.');
if(row.sourceAmount===null&&!row.splitSource)throw new Error('Reparta uma venda reutilizada com valor de origem determinado; para entradas directas acrescente as operações em falta.');
const source=row.splitSource??{id:row.id,amount:row.sourceAmount??row.amount,period:row.period,currency:row.sourceCurrency,basis:row.basis};
if(!source.basis||source.amount===null||amount(source.amount)===null)throw new Error('Determine o valor e a representação do preço antes de repartir a origem.');
const first={...row,amount:'',sourceAmount:null,splitSource:source,source:`Repartição explícita de ${source.id}: ${source.amount} ${source.currency}; ${row.source}`};
return {...book,rows:[...book.rows.map(r=>r.id===id?first:r),{...first,id:newId,description:'Parcela adicional da mesma venda',treatment:'other',confirmed:[],evidence:''}],periods:book.periods.map(p=>p.period===row.period?{...p,complete:false}:p)};
}
export function recordSales(draft:Record<string,unknown>,book:SalesBook):SalesBook {return {...book,history:book.result?[...(book.history??[]),book.result]:book.history,result:calculateSales(draft,book)};}
function amount(raw:unknown):bigint|null {if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const [n,d='']=raw.trim().split('.');return BigInt(n)*1000000n+BigInt(d.padEnd(6,'0'));}
function money(n:bigint):string {return `${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function sum(values:Array<string|null>):string|null {const parsed=values.map(amount);return parsed.some(v=>v===null)?null:money((parsed as bigint[]).reduce((a,b)=>a+b,0n));}
export function evaluateSalesOperation(row:SalesOperation,currency:string):SalesLineResult {
const rule=operationTreatments.find(r=>r.id===row.treatment),n=amount(row.amount);
const annex=row.treatment==='pharma_manufacturing_inputs'?pharmaAnnexEntry(row.pharmaAnnexItem):undefined;
const annexI=row.treatment==='annexI_goods'?annexIEntry(row.annexIItem):undefined;
const result:SalesLineResult={id:row.id,field:rule?.field??null,net:null,vat:null,gross:null,rate:rule?.rate??null,status:'indeterminate',reason:'',article:rule?.article??'Tratamento desconhecido',source:(rule?.source??'Fonte em falta')+(annex?`; ${pharmaAnnexReference(annex)}`:'')+(annexI?`; ${annexIReference(annexI)}`:'')};
const stop=(reason:string)=>({...result,reason});
if(currency!=='MZN'||row.sourceCurrency!==currency)return stop('Moeda fora de MZN ou divergente da origem; sem conversão silenciosa.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period))return stop('Período fora da cobertura de2026; sem cálculo histórico presumido.');
if(temporaryBenefit(row.treatment))return stop(temporaryBenefitNotice(row.treatment,row.period));
const regimeIssue=specialRegimeIssue(row.treatment,row.specialRegime);
if(regimeIssue)return {...stop(regimeIssue),field:null,rate:null};
const supplyIssue=onboardSupplyIssue(row.treatment,row.supplyCategory);
if(supplyIssue)return {...stop(supplyIssue),field:null,rate:null};
if(!rule||rule.rate===null||!rule.field)return stop('Operação não calculada: delimite incidência, territorialidade e fundamento desta linha. A remissão do campo06 não constitui uma regra de classificação de todas as operações no estrangeiro.');
if(n===null||!['net','included'].includes(row.basis))return stop('Montante ou indicação de IVA incluído/sem IVA em falta; vazio não significa zero.');
if(!row.description.trim()||!row.establishment.trim())return stop('Indique a operação e o estabelecimento a que pertence; não inferidos da localização do investimento.');
if(rule.conditions.some((_,i)=>!row.confirmed.includes(i))||!row.evidence.trim())return stop('Condições da operação ou fundamento/pressuposto em falta; o sector não prova o tratamento fiscal.');
if(row.sourceAmount!==null&&amount(row.sourceAmount)!==n)return stop('Divergência com o valor reutilizado: conserve a origem e prepare a repartição explicitamente; não substituir silenciosamente.');
if(row.treatment==='pharma_manufacturing_inputs'&&!annex)return stop('Escolha a linha aplicável do Anexo III/2022, com código e designação; um código livre, desconhecido ou de outro anexo não comprova a isenção.');
if(row.treatment==='annexI_goods'){
if(!annexI)return stop('Escolha a posição aplicável do Anexo I/2022, com código, designação e qualificadores; não presumir isenção por sector ou código livre.');
if(annexI.relatedRequired)return stop('Esta designação tem tratamento específico já disponível no artigo9(10), com direito à dedução nas condições do19(1)(b)(v). Escolha a continuidade indicada e confirme as suas condições; não atribuir07 apenas pela presença no Anexo I.');
if(annexI.relatedTreatments?.length&&row.annexIOnly!==true)return stop('A natureza ou o destino deste bem pode corresponder a outro tratamento já disponível. Escolha a continuidade aplicável ou fundamente expressamente por que a operação pertence apenas a9(12)(h); desconhecido não significa ausência desse enquadramento.');
}
if(row.treatment==='fundraising_public'||row.treatment==='fundraising_nonprofit'){const error=fundraisingError(row.fundraiser,row.treatment==='fundraising_nonprofit');if(error)return stop(error);}
const option=row.treatment.startsWith('production_')&&row.treatment.endsWith('_opted')?productionOptionCheck(row.taxOption,row.period):{};
if(option.error)return stop(option.error);
if(row.basis==='included'&&rule.rate===5){
const exact={net:fraction(n*20n,21000000n),vat:fraction(n,21000000n),gross:fraction(n,1000000n)};
return {...result,net:fractionPresentation(exact.net).decimal,vat:fractionPresentation(exact.vat).decimal,gross:money(n),exact,status:'calculated',reason:'Base e IVA conservados como fracções exactas (preço×20/21 e preço/21). Decimal a6casas é apresentação técnica, metade para cima; não é regra de arredondamento da declaração nem imposto final a pagar.'};
}
let net=n,vat=0n;
if(rule.rate===16&&row.basis==='included') {net=((n*100n+58000000n)/116000000n)*1000000n;vat=n-net;if(vat<0n)return stop('Arredondamento à unidade produz IVA negativo para este montante; reveja a linha e a documentação.');}
else vat=(n*BigInt(rule.rate)+50n)/100n;
return {...result,net:money(net),vat:money(vat),gross:money(row.basis==='included'?n:net+vat),status:rule.rate===0?'exempt':'calculated',reason:(rule.rate===0?(rule.field==='05'?'Isenção com direito à dedução nas condições legais; não é taxa zero nem dedução automática de compras.':'Isenção sem direito à dedução para esta operação; não é isenção geral da entidade.'):'IVA da operação projectada; não é imposto final a pagar nem declaração submetida.')+(option.summary?' '+option.summary:'')};
}
function key(draft:Record<string,unknown>,book:SalesBook,catalog=operationTreatments.filter(t=>book.rows.some(r=>r.treatment===t.id))):string {return JSON.stringify([operationVersion,catalog,acquisitionScope(draft),draft.currency,draft.province_id,draft.district_id,draft.business_plan_snapshot,draft.cashflow_snapshot,draft.monthly_iva_settings,book.currency,book.rows,book.periods]);}
export function salesCurrent(draft:Record<string,unknown>,book:SalesBook):boolean {return !!book.result&&book.result.version===operationVersion&&book.result.opportunity===acquisitionScope(draft)&&(book.result.key===key(draft,book)||book.result.key===key(draft,book,operationTreatments.filter(t=>legacyV2TreatmentIds.includes(t.id))));}
export function calculateSales(draft:Record<string,unknown>,book:SalesBook,now=new Date().toISOString()):SalesResult {
if(book.currency!=='MZN'||draft.currency!==book.currency)throw new Error('Confirme a moeda original MZN; sem conversão ou reinterpretação.');
if(new Set(book.rows.map(r=>r.id)).size!==book.rows.length||new Set(book.periods.map(p=>p.period)).size!==book.periods.length)throw new Error('Identificadores/períodos duplicados; corrija sem somar em duplicado.');
if(!book.periods.length||book.rows.some(r=>!book.periods.some(p=>p.period===r.period))||book.periods.some(p=>!/^2026-(0[1-9]|1[0-2])$/.test(p.period)))throw new Error('Cada operação deve pertencer a um período válido de2026 incluído na cobertura.');
let live:ReturnType<typeof monthlySalesFromDraft>|null=null;try {live=monthlySalesFromDraft(draft);}catch{ /* Explicitly block stale imported values below. */ }
const start=readMonthlyIvaSettings(String(draft.monthly_iva_settings??'')).start;
const rows=book.rows.map(r=>{
const result=evaluateSalesOperation(r,book.currency);
if(isExportService(r.treatment)&&r.relatedExport!==undefined){
const ref=r.relatedExport,target=ref&&typeof ref==='object'?book.rows.find(item=>item.id===ref.id&&item.id!==r.id):undefined;
if(!target||ref.description!==target.description||ref.treatment!==target.treatment)return {...result,net:null,vat:null,gross:null,status:'indeterminate' as const,reason:'A operação relacionada foi removida ou alterada. Actualize a referência e reveja as condições; preço do serviço e resultado anterior conservados.'};
}
const fundraiser=r.fundraiser;
if(r.treatment.startsWith('fundraising_')&&fundraiser&&book.rows.some(v=>v.id!==r.id&&v.treatment.startsWith('fundraising_')&&v.period.slice(0,4)===r.period.slice(0,4)&&String(v.fundraiser?.entityReference??'').trim()===String(fundraiser.entityReference??'').trim()&&v.fundraiser?.annualEvents!==fundraiser.annualEvents))return {...result,net:null,vat:null,gross:null,status:'indeterminate' as const,reason:'Totais anuais divergentes para a mesma entidade; resolva a divergência sem substituir dados de outra linha.'};
if(r.splitSource) {
const source=r.splitSource,group=book.rows.filter(v=>v.splitSource?.id===source.id),index=Number(source.period.slice(5))-Number(start.slice(5));
if(group.some(v=>v.period!==source.period||v.basis!==source.basis||v.sourceCurrency!==source.currency||JSON.stringify(v.splitSource)!==JSON.stringify(source))||sum(group.map(v=>v.amount))!==(amount(source.amount)===null?null:money(amount(source.amount)!))||!live||live.amounts[index]!==source.amount)return {...result,exact:undefined,net:null,vat:null,gross:null,status:'indeterminate' as const,reason:'Repartição não reconciliada com o total, período, moeda e representação do preço da origem; nenhuma parcela foi presumida.'};
}
if(r.sourceAmount!==null||r.source.startsWith('Vendas por produto')||r.source.startsWith('Receita mensal')) {
const index=Number(r.sourcePeriod.slice(5))-Number(start.slice(5));
if(!live||!/^2026-/.test(start)||r.sourcePeriod!==r.period||live.amounts[index]!==r.sourceAmount)return {...result,exact:undefined,net:null,vat:null,gross:null,status:'indeterminate' as const,reason:'A origem/período das vendas mudou. Reveja e confirme a nova origem; o resultado anterior foi conservado.'};
}
return result;
});
const periods=book.periods.map(p=>{
const matching=book.rows.map((r,i)=>({input:r,result:rows[i]})).filter(r=>r.input.period===p.period),fields:Record<string,string|null>={},exactFields:Record<string,FiscalFraction|null>={},reasons=matching.filter(r=>r.result.status==='indeterminate').map(r=>`${r.input.description||r.input.id}: ${r.result.reason}`);
const known=p.complete&&!matching.some(r=>r.result.status==='indeterminate');
for(const f of ['01','03','05','07'])fields[f]=known?sum(matching.filter(r=>r.result.field===f).map(r=>r.result.net)):null;
for(const [f,base] of [['02','01'],['04','03']])fields[f]=known?sum(matching.filter(r=>r.result.field===base).map(r=>r.result.vat)):null;
fields['06']=known?'0.00':null;
if(matching.some(r=>r.result.exact)) {
for(const [f,base,part] of [['01','01','net'],['02','01','vat'],['03','03','net'],['04','03','vat'],['05','05','net'],['06','06','net'],['07','07','net']] as const) {
exactFields[f]=known?addFractions(matching.filter(r=>r.result.field===base).map(r=>r.result.exact?.[part]??decimalFraction(r.result[part]!))):null;
fields[f]=exactFields[f]?fractionPresentation(exactFields[f]!).decimal:null;
}
}
if(!p.complete)reasons.push('Confirme que todas as operações do período foram incluídas; uma lista vazia só é zero após essa confirmação.');
return {period:p.period,fields,...(Object.keys(exactFields).length?{exactFields}:{}),reasons};
});
const labels=draft.selection_labels as Record<string,unknown>|undefined;
return {version:operationVersion,revision:(book.result?.revision??0)+1,calculatedAt:now,opportunity:acquisitionScope(draft),location:['province_id','district_id'].filter(k=>draft[k]).map(k=>String(labels?.[k]??draft[k])).join(' / '),currency:book.currency,key:key(draft,book),inputs:structuredClone(book.rows),rows,periods,rounding:'Base líquida: precisão técnica6decimais, metade para cima, sem arredondamento final da declaração. Preço geral com IVA: base=preço×100/116, arredondada à unidade mais próxima (metade para cima), IVA=preço−base, CIVA art.34 redacção Lei10/2025. Preço incluído5%: fracções exactas preço×20/21 e preço/21 conservadas; decimal a6casas/metade para cima apenas na apresentação. A regra declarativa não é presumida.'};
}
export function salesReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]> {
try {const book=salesBook(draft),r=book.result;if(!r)return [];
const context=`${r.currency}; oportunidade ${r.opportunity}; ${r.location||'localização não indicada'}; ${r.version}; revisão ${r.revision}; ${r.calculatedAt}`;
const out:Array<[string,string,string,string]>=[['IVA mensal','Operações IVA L1',salesCurrent(draft,book)?'Resultado correspondente às entradas':'Histórico desactualizado; não aplicar à projecção actual',context],['IVA mensal','Método e limites L1',r.rounding,'Sem apuramento integral, dedução automática ou submissão AT']];
for(const row of r.inputs){const value=r.rows.find(v=>v.id===row.id)!;out.push(['IVA mensal',`${row.period} — ${row.description} — ${row.establishment}`,`Declarado ${row.amount||'em falta'} ${row.sourceCurrency}; ${row.basis==='included'?'IVA incluído':row.basis==='net'?'sem IVA':'base desconhecida'}; líquido ${value.net??'Indeterminado'}; IVA ${value.vat??'Indeterminado'}; bruto ${value.gross??'Indeterminado'}; campo ${value.field??'não determinado'}; ${value.reason}`,`${context}; ${value.article}; ${value.source}; origem: ${row.source}; pressuposto/documento: ${row.evidence||'em falta'}; condições confirmadas: ${row.confirmed.join(',')||'nenhuma'}`]);}
for(const row of r.inputs.filter(v=>v.fundraiser))out.push(['IVA mensal',`Manifestação ocasional — ${row.description}`,`Entidade ${row.fundraiser!.entityReference}; ano ${row.period.slice(0,4)}; total anual declarado ${row.fundraiser!.annualEvents}; manifestação ${row.fundraiser!.eventNumber}; actividade ${row.fundraiser!.activity}`,`${context}; dados declarados para a entidade, incluindo manifestações fora deste dossier; não é contagem automática das vendas.`]);
for(const row of r.inputs.filter(v=>isExportService(v.treatment)&&v.relatedExport))out.push(['IVA mensal',`Operação relacionada — ${row.description}`,`${row.relatedExport!.description}; ID ${row.relatedExport!.id}; tratamento ${row.relatedExport!.treatment}`,`${context}; referência escolhida expressamente nesta oportunidade,sem copiar valor para preço do serviço nem provar automaticamente o enquadramento subjacente`]);
for(const row of r.inputs.filter(v=>isOnboardSupply(v.treatment)))out.push(['IVA mensal',`Natureza do abastecimento — ${row.description}`,supplyCategories.find(([value])=>value===row.supplyCategory)?.[1]??'Por identificar',`${context}; CIVA13(2–3); natureza conservada no cálculo/relatório, sem aplicar dedução ou restituição automaticamente`]);
for(const row of r.inputs.filter(v=>isSpecialRegime(v.treatment)))out.push(['IVA mensal',`Regime especial — ${row.description}`,specialRegimeOptions.find(([value])=>value===row.specialRegime)?.[1]??'Por identificar',`${context}; CIVA14(1)(b/c/d),19(1)(b)(iv); regime declarado/documentado ou pressuposto expresso da projecção; não certifica admissão ou permanência, nem liquida importação ou saída do regime`]);
for(const value of r.rows.filter(v=>v.exact))out.push(['IVA mensal',`Precisão exacta — ${value.id}`,`Líquido ${fractionLabel(value.exact!.net)} MZN; IVA ${fractionLabel(value.exact!.vat)} MZN; bruto ${fractionLabel(value.exact!.gross)} MZN`,`${context}; apresentação decimal a6casas, aproximação quando a fracção não termina; não aplicar à declaração sem a sua regra própria.`]);
for(const p of r.periods){out.push(['IVA mensal',`Operações L1 — ${p.period}`,Object.entries(p.fields).map(([f,v])=>`${f}: ${v??'Indeterminado'}`).join('; '),`${context}; ${p.reasons.join(' ')}`]);
if(p.exactFields)out.push(['IVA mensal',`Precisão exacta do período — ${p.period}`,Object.entries(p.exactFields).map(([f,v])=>`${f}: ${v?fractionLabel(v):'Indeterminado'}`).join('; '),`${context}; totais em fracções MZN, calculados antes da apresentação decimal, sem regra declarativa presumida.`]);
}return out;
}catch{return [['IVA mensal','Operações IVA L1','Não foi possível recuperar as operações guardadas','Originais preservados; sem substituição por zero']];}
}
+55
View File
@@ -0,0 +1,55 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const ownNameVersion='own-name-chains/1';
export const ownNameSource='CIVA3(3)c,Lei13/2016PDF6/p1426(264):transferências em execução de contrato de comissão,incluindo consignação;comissário considerado comprador na comissão de venda,comitente na de compra. Art4(3),PDF7/p1426(265):mandatário emnome próprio é adquirente eprestador do serviço sucessivamente. Lei10/2025PDF12mantém3(3)c e não altera4. Base de bens15(2)e/P091já entregue,não recalculada ou somada neste percurso. Recorte2026:circuito/contraprestações originais separados,sem localização,isenção,taxa,IVA,dedução/campo11 ou totaisModeloA presumidos.';
export const ownNameTreatments=[{id:'goods_sale_commission',branch:'P122',label:'P122 — Comissão de venda de bens',kind:'goods',direction:'sale'},{id:'goods_purchase_commission',branch:'P122',label:'P122 — Comissão de compra de bens',kind:'goods',direction:'purchase'},{id:'service_sale_mandate',branch:'P128',label:'P128 — Mandato de venda/prestação de serviços',kind:'services',direction:'sale'},{id:'service_purchase_mandate',branch:'P128',label:'P128 — Mandato de aquisição de serviços',kind:'services',direction:'purchase'}] as const;
export const ownNameConditions=[['ownName','O comissário/mandatário actua emnome próprio,não apenas emnome do mandante'],['forAnother','Actua por conta de outrem identificado ecom relação documentada ou pressuposto expresso'],['factsCorrespond','Objecto,partes,referências eperíodo correspondem à operação identificada']] as const;
const goodsConditions=[['goodsNature','São transferências de bens,não serviço autónomo de intermediação'],['commissionContract','As transferências executam contrato de comissão identificado,conforme3(3)c,incluindo consignação quando aplicável'],['directionConfirmed','Papéis e duas relações correspondem ao sentido de venda ou compra escolhido']] as const;
const serviceConditions=[['serviceNature','Está identificada uma prestação de serviços,não transferência de bens'],['mandateContract','A prestação é efectuada por intervenção de mandatário emnome próprio,com mandato identificado4(3)'],['successiveService','Mandatário é adquirente eprestador do serviço sucessivamente;referências distinguem as duas prestações'],['directionConfirmed','Papéis e duas relações correspondem ao sentido de venda/prestação ou aquisição escolhido']] as const;
export function ownNameSpecificConditions(treatment:string):ReadonlyArray<readonly[string,string]>{const rule=ownNameTreatments.find(t=>t.id===treatment);return rule?.kind==='goods'?goodsConditions:rule?.kind==='services'?serviceConditions:[];}
type Choice=''|'yes'|'no';type Condition=typeof ownNameConditions[number][0];
export type OwnNameRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';operationDate:string;operationRef:string;documentRef:string;documentDate:string;principalRef:string;agentRef:string;thirdPartyRef:string;contractRef:string;subjectRef:string;currency:string;firstAmount:string;secondAmount:string;firstLegRef:string;secondLegRef:string;existingBaseRef:string;scope:string;evidence:string;conditions:Partial<Record<string,Choice>>};
type Leg={supplier:string;acquirer:string;consideration:string;currency:string;reference:string};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';legs:Leg[];baseAmount:null;vat:null;rate:null;reason:string};
export type OwnNameCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:OwnNameRow[];rows:LineResult[]};
export type OwnNameBook={rows:OwnNameRow[];result?:OwnNameCalculation;history?:OwnNameCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{ownNames?:Record<string,OwnNameBook>};
export function newOwnName(id:string,currency=''):OwnNameRow{return{id,treatment:'',description:'',period:'',origin:'projected',operationDate:'',operationRef:'',documentRef:'',documentDate:'',principalRef:'',agentRef:'',thirdPartyRef:'',contractRef:'',subjectRef:'',currency,firstAmount:'',secondAmount:'',firstLegRef:'',secondLegRef:'',existingBaseRef:'',scope:'',evidence:'',conditions:{}};}
export function switchOwnNameTreatment(row:OwnNameRow,treatment:string):OwnNameRow{return{...row,treatment,conditions:Object.fromEntries(ownNameConditions.map(([key])=>[key,row.conditions[key]??'']))};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.ownNames!==undefined&&(!store.ownNames||typeof store.ownNames!=='object'||Array.isArray(store.ownNames)))throw new Error('Circuitos emnome próprio não recuperáveis;originais preservados.');
const fields=Object.keys(newOwnName('')).filter(key=>key!=='conditions');
for(const book of Object.values(store.ownNames??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof OwnNameRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de circuitos emnome próprio não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function ownNameBook(draft:Record<string,unknown>):OwnNameBook{return readStore(draft).ownNames?.[acquisitionScope(draft)]??{rows:[]};}
export function saveOwnNameBook(draft:Record<string,unknown>,book:OwnNameBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,ownNames:{...current.ownNames,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateOwnName(row:OwnNameRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',legs:[],baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
const rule=ownNameTreatments.find(t=>t.id===row.treatment);if(!rule)return stop('Identifique bens/serviços e o sentido da comissão/mandato;sem inferir pelo pagamento de uma comissão.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||!validDate(row.operationDate)||row.operationDate.slice(0,7)!==row.period)return stop('Identifique mês2026,data correspondente e dados efectivos ou pressupostos expressos.');
const required=[...ownNameConditions,...ownNameSpecificConditions(row.treatment)];if(required.some(([key])=>row.conditions[key]==='no'))return stop('Este circuito emnome próprio não se aplica aos factos declarados;rever mandato/comissão/natureza/papéis,sem classificar mera intermediação como duas operações ou presumir isenção/IVAzero.','not_applicable');
if(required.some(([key])=>row.conditions[key]!=='yes'))return stop('Natureza,actuação emnome próprio ou papéis por esclarecer;desconhecido não é não aplicável ou zero.');
if(!row.description.trim()||!row.operationRef.trim()||!row.documentRef.trim()||!validDate(row.documentDate)||!row.scope.trim()||!row.evidence.trim()||!row.subjectRef.trim()||!row.contractRef.trim()||![row.principalRef,row.agentRef,row.thirdPartyRef,row.firstLegRef,row.secondLegRef].every(v=>!!v.trim()))return stop('Identifique objecto,mandante/comitente,comissário/mandatário,terceiro,contrato,duas relações,operação/documento/data eâmbito;reutilize referências ou pressupostos expressos,sem certificado/aprovador novo.');
if(typeof currency!=='string'||!/^[A-Z]{3}$/.test(currency)||row.currency!==currency)return stop('Identifique moeda original coerente com o contexto;sem converter ou reinterpretarUSDcomoMZN.');
const amount=(v:string):string|null=>/^\d{1,15}(\.\d{1,6})?$/.test(v.trim())?v.trim():null;const first=amount(row.firstAmount),second=amount(row.secondAmount);
if(first===null||second===null)return stop('Identifique separadamente as contraprestações originais das duas relações;desconhecido não é zero. Não inferir uma delas da comissão ou somá-las como uma única base.');
const before=rule.direction==='sale'?row.principalRef:row.thirdPartyRef,after=rule.direction==='sale'?row.thirdPartyRef:row.principalRef;
const legs=[{supplier:before,acquirer:row.agentRef,consideration:first,currency:row.currency,reference:row.firstLegRef},{supplier:row.agentRef,acquirer:after,consideration:second,currency:row.currency,reference:row.secondLegRef}];
return{...result,status:'determined',legs,reason:`${rule.branch}:${rule.kind==='goods'?`art3(3)c,comissão de${rule.direction==='sale'?'venda:comissário considerado comprador':'compra:comitente considerado comprador'}`:'art4(3),mandatário emnome próprio considerado adquirente eprestador do serviço sucessivamente'}. ${row.origin==='projected'?'Circuito sob pressupostos expressos.':'Circuito segundo dados efectivos declarados.'} Duas relações com objecto/partes/contraprestações originais separadas,sem soma ou compensação automática. ${rule.kind==='goods'?'BaseP091/15(2)e já entregue permanece separada e não é recalculada.':'Não transformar este circuito emcomissão autónoma ou aplicar15(2)e de bens aos serviços.'} Sem determinar localização,isenção,base,taxa,IVA,dedução/campo11 ou totaisModeloA.`};
}
function key(draft:Record<string,unknown>,book:OwnNameBook):string{return JSON.stringify({version:ownNameVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function ownNameCurrent(draft:Record<string,unknown>,book:OwnNameBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordOwnNames(draft:Record<string,unknown>,book:OwnNameBook):OwnNameBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:OwnNameCalculation={version:ownNameVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:ownNameSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateOwnName(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveOwnNameBook(draft,next);return next;
}
export function ownNameReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=ownNameBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>{const line=result.rows[index],rule=ownNameTreatments.find(t=>t.id===row.treatment);return['IVA mensal',`Circuito ${rule?.branch??'emnome próprio'} — ${row.period} — ${row.id}`,`${row.description};${line.status==='determined'?'Circuito identificado':line.status==='not_applicable'?'Circuito não aplicável':'Circuito indeterminado'};IVA: Indeterminado;${line.reason};${line.legs.map((leg,i)=>`Relação${i+1}:${leg.supplier} → ${leg.acquirer},contraprestação original ${leg.consideration} ${leg.currency},referência ${leg.reference}`).join('; ')};sem soma das duas relações`,`${result.opportunity};${result.location};${ownNameCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${rule?.label??'Percurso por indicar'};operação ${row.operationRef},${row.operationDate};objecto ${row.subjectRef};contrato ${row.contractRef};mandante/comitente ${row.principalRef};agente ${row.agentRef};terceiro ${row.thirdPartyRef};relações ${row.firstLegRef}/${row.secondLegRef};${rule?.kind==='goods'?`referênciaP091existente ${row.existingBaseRef||'não indicada;sem nova base calculada'};`:''}âmbito ${row.scope};documento ${row.documentRef},${row.documentDate};condições ${[...ownNameConditions,...ownNameSpecificConditions(row.treatment)].map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};sem IVA/dedução/campo11/totaisModeloA.`];});}
catch{return[['IVA mensal','Circuito emnome próprio','Dados não recuperáveis','Originais preservados;sem circuito ou valor por defeito.']];}
}
+180
View File
@@ -0,0 +1,180 @@
// Transcription of the accepted official exemplar, not a tariff classification service.
// Keep duplicated codes and printed incomplete positions distinct; never infer missing digits.
export const pharmaAnnexVersion='annexIII-lei22-2022/1';
export const pharmaAnnexSource='Lei22/2022, art.3(1), AnexoIII, PDF12–16, p.2252(36)–(40); efeitos01/01/2023';
export const pharmaAnnexPdfSha256='ea1b0dc6f5cf6e595f6d9a19e7042f398999e0087caef1785f6e8fac571b5f53';
export type PharmaAnnexEntry={id:string;code:string;label:string;pdfPage:number;lastPdfPage:number};
export const pharmaAnnexEntries:PharmaAnnexEntry[]=[
{"id":"annexIII-2022-001","code":"1108.11.00","label":"- Amido de trigo","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-002","code":"1108.12.00","label":"- Amido de milho","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-003","code":"1108.19.00","label":"- Outros amidos e féculas","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-004","code":"1301.20.00","label":"- Goma – arábica","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-005","code":"1301.90.00","label":"- Goma – laca; Gomas, resinas, gomas – resinas e oleorresinas (bálsamo, por exemplo), naturais - Outras","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-006","code":"1505.00.00","label":"- Lanolina","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-007","code":"1521.90.00","label":"- Ceras; cera de abelhas; cera de carnaúba; espermacete; ozocerite","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-008","code":"1701.99.00","label":"- Sacarose","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-009","code":"1702.11.00","label":"- Lactose","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-010","code":"1702.19.00","label":"- Lactose mono-hidratada (500 mg)","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-011","code":"1702.30.00","label":"- Glucose","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-012","code":"1702.50.00","label":"- Futose padrão","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-013","code":"2207.10.10","label":"- Álcool etílico para uso hospitalares","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-014","code":"2507.00.00","label":"- Caulino","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-015","code":"2709.00.00","label":"- Óleo Mineral betuminoso","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-016","code":"2806.10.00","label":"- Ácido Clorídrico","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-017","code":"2807.00.00","label":"- Ácido Sulfúrico","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-018","code":"2808.00.00","label":"- Ácido Nítrico","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-019","code":"2809.10.00","label":"- Pentóxido de difósforo","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-020","code":"2809.20.00","label":"- Ácido forfórico","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-021","code":"2810.00.00","label":"- Ácido Bórico","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-022","code":"2811.22.00","label":"- Dióxido de silício","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-023","code":"2811.29.00","label":"- Ácidos inorgânicos e outros componentes oxigenados inorgânicos dos elementos não metálicos - Outros","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-024","code":"2812.90.00","label":"- Halogenetos e oxialogenetos dos elementos não – metálicos - Outros","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-025","code":"2813.90.00","label":"- Sulfuretos dos elementos não-metalicos; trissulfureto de fósforo comercial - Outros","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-026","code":"2815.20.00","label":"- Hidróxido de Potássio","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-027","code":"2815.30.00","label":"- Peróxidos de Sódio ou de Potássio","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-028","code":"2819.90.00","label":"- Óxidos e hidróxidos de crónico - Outros","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-029","code":"2823.00.00","label":"- Óxido de Titânio","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-030","code":"2825.90.00","label":"- Hidrazina e hidroxilamina, e seus sais orgânicos - Outros","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-031","code":"2827.20.00","label":"- Cloreto de cálcio","pdfPage":12,"lastPdfPage":12},
{"id":"annexIII-2022-032","code":"2827.39.00","label":"- Cloretos, oxicloretos e hidroxicloretos, brometos e oxibrometos iodetos e oxiodetos - Outros","pdfPage":12,"lastPdfPage":13},
{"id":"annexIII-2022-033","code":"2827.60.00","label":"- Iodetos e oxidetos","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-034","code":"2829.19.00","label":"- Cloratos e precloratos; bromatos e perbromatos; iodatos e periodatos --Outros","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-035","code":"2829.90.00","label":"- Cloratos e precloratos; bromatos e perbromatos; iodatos e peridatos - Outros","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-036","code":"2832.30.00","label":"- Tiossulfatos","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-037","code":"2833.29.00","label":"- Sulfatos de sódio - Outros","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-038","code":"2834.29.00","label":"- Nitritos, nitratos - Outros","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-039","code":"2835.22.00","label":"- Fosfato sódico monobásico, fosfato sódico dibásico","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-040","code":"2835.24.00","label":"- Fosfato de Potássio Monobásico, fosfato de potássio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-041","code":"2835.25.00","label":"- Hidrogeno-ortofosfato de cálcio (fosfato dicalcico)","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-042","code":"2835.29.00","label":"- Outros fosfatos","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-043","code":"2836.40.00","label":"- Carbonato de Potássio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-044","code":"2836.50.00","label":"-Carbonato de Cálcio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-045","code":"2836.99.00","label":"- Carbonatos; Peroxocarbonatos (percarbonatos); carbonato de amónio comercial que contenha carbonato de amónio - Outros","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-046","code":"2837.19.00","label":"- Solução de Cianeto de Potássio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-047","code":"2839.90.00","label":"- Trissilicato de magnésio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-048","code":"2841.50.00","label":"- Cromato de Potássio AR","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-049","code":"2841.61.00","label":"- Permanganato de Potássio; Permanganato de Potássio AR","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-050","code":"2841.70.00","label":"- Solução de Mobibdato de Amónio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-051","code":"2841.80.00","label":"- Tungstato de sódio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-052","code":"2841.90.00","label":"- Piroantimoniato de Potássio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-053","code":"2842.90.00","label":"- Outros sais dos ácidos ou peróxidos inorgânicos","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-054","code":"2843.21.00","label":"- Nitrato de Prata","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-055","code":"2843.29.00","label":"- Cianeto de Potássio; Citrato Cúprico Alcalino TS","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-056","code":"2847.00.00","label":"- Peróxido de Hidrogénio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-057","code":"2901.29.00","label":"- Hidrocarbonetos acíclicos - Outros","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-058","code":"2902.11.00","label":"- Ciclohexano","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-059","code":"2902.20.00","label":"- Benzeno","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-060","code":"2902.30.00","label":"- Tolueno","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-061","code":"2902.90.00","label":"- Cloreto de Mitileno; Diclorometano;","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-062","code":"2903.13.00","label":"- Clorofórmio","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-063","code":"2903.14.00","label":"- Tetracloreto de Carbono","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-064","code":"2903.22.00","label":"- Tricloetileno","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-065","code":"2904.91.00","label":"- Hidrocarbonetos cíclicos - Outros","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-066","code":"2905.11.00","label":"- Metanol; Metanol HPLC; Metanol P.A","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-067","code":"2905.12.00","label":"- Álcool Isopropílico; Álcool n-Propílico","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-068","code":"2905.13.00","label":"- Etanol; clorobutanol","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-069","code":"2905.14.00","label":"- Álcool estearílico; álcool cetílico; álcool palmítico","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-070","code":"2905.19.00","label":"- Propranolol Cloridrato (200mg)","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-071","code":"2905.31.00","label":"- Etinoglicol","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-072","code":"2905.32.00","label":"- Propilenoglicol","pdfPage":13,"lastPdfPage":13},
{"id":"annexIII-2022-073","code":"2905.43.00","label":"- Manita ou manitol","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-074","code":"2905.44.00","label":"- D-glucitol (sorbitol)","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-075","code":"2905.45.00","label":"- Glicerina","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-076","code":"2905.49.00","label":"- Alcoois acíclicos e seus derivados halogenados, sulfonados, nitrados ou nitrosados - Outros","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-077","code":"2906.13.00","label":"- Esteróis e inositois","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-078","code":"2906.21.00","label":"- Álcool benzílico","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-079","code":"2907.15.00","label":"- 1 – Naftol Ts; 2 -naftol","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-080","code":"2907.19.00","label":"Fénois; fenóis-alcoois - Outros","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-081","code":"2907.29.00","label":"Pelifenois; fénois-alcoois - Outros","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-082","code":"2909.19.00","label":"- Etér Etílico","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-083","code":"2909.49.00","label":"- Outros Eteres","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-084","code":"2912.19.00","label":"- Solução de Formaldeido","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-085","code":"2912.19.00","label":"- Acetaldeíco; Anisaldeído;p-dimetilaminobenzaldeído","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-086","code":"2914.11.00","label":"- Acetona","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-087","code":"2914.13.00","label":"- 4-metilpentan-2-ol","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-088","code":"2915.21.00","label":"- Ácido Acético glacial","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-089","code":"2915.24.00","label":"- Anidrido Acético","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-090","code":"2915.39.00","label":"- Acidos monocarboxilicos acíclicos saturados e seus anidridos, halogenetos, peróxidos e peroxiácidos, seus derivados halogenados, sulfanados, nitrados ou nitrosados - Outros","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-091","code":"2915.50.00","label":"- Ácido propionico, seus sais e seus ésteres","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-092","code":"2915.70.00","label":"- Ácidos palmíticos, ácido esteárico, seus sais e seus ésteres","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-093","code":"2915.90.00","label":"- Ácidos monocarboxilicos acíclicos saturados e seus anidridos, halogenetos, peróxidos e perxiácidos; seus derivados halogenados, sulfanados, nitrados ou nitrosados - Outros","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-094","code":"2916.15.00","label":"- Ácido oleico, linoléico, seus sais e seus ésteres","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-095","code":"2916.31.00","label":"- Ácido benzóico sais e seus ésteres","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-096","code":"2916.32.00","label":"- Cloreto de benzoílo","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-097","code":"2916.39.00","label":"- Benzoato de sódio","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-098","code":"2917.11.00","label":"- Ácido oxálico; Oxalato de amónia AR","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-099","code":"2917.12.00","label":"- Ácido adípico","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-100","code":"2918.11.00","label":"- Ácido láctico, seus sais e seus ésteres","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-101","code":"2918.12.00","label":"- Ácido Tartárico","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-102","code":"2918.14.00","label":"- Ácido Cítrico","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-103","code":"2918.15.00","label":"- Sais e éstres do ácido cítrico: Citrato de sódio","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-104","code":"2918.16.00","label":"- Ácido Glucónico","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-105","code":"2918.19.00","label":"- Tartarato de sódio, ésteres propílico, octílico e dodecílico do ácido gálico","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-106","code":"2918.99.00","label":"- Captopril (200 mg); Captopril","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-107","code":"2921.59.00","label":"- Dietilamina","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-108","code":"2922.12.00","label":"- Dietilamina","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-109","code":"2922.15.00","label":"- Trietanolamina e seus sais","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-110","code":"2922.29.00","label":"- Cloridrato de procaína","pdfPage":14,"lastPdfPage":14},
{"id":"annexIII-2022-111","code":"2922.49.00","label":"- Compostos aminados de funções oxigenadas - Outros","pdfPage":14,"lastPdfPage":15},
{"id":"annexIII-2022-112","code":"2923.90.00","label":"- Sais e Hidróxido de Amónio quatenários - Outros","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-113","code":"2924.29.00","label":"- Compostos de função carboxiamida; compostos de funçãoamida do ácido carbónico - Outros","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-114","code":"2925.11.00","label":"- Sacarina sódica e seus sais","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-115","code":"2925.19.00","label":"- o – Tolina","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-116","code":"2926.10.00","label":"- Acrilonitrila","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-117","code":"2930.90.00","label":"- Tiocompostos orgânicos - Outros","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-118","code":"2932.11.00","label":"- Tetrahidrofurano","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-119","code":"2932.99.00","label":"- Compostos heterocíclicos exclusivamente de heteroátomos de oxigénio - Outros","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-120","code":"2933.31.00","label":"- Piridina e seus sais","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-121","code":"2933.39.00","label":"Compostos hetrocíclicos exclusivamente de heteroatomos de azoto - Outros","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-122","code":"2933.91.00","label":"- Diazepam; Diazepam padrão; Composto Relacionado A de Diazepam; Composto relacionado B de Diazepam; Nordazepam padrão; Haloperidol (200 mg); Haloperido Composto Relacionado A (10 mg); Haloperidol Composto Relacionado B (10mg)","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-123","code":"2935.","label":"- Sulfonamidas","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-124","code":"2936.24.00","label":"- Ácido Fólico (500 mg) (Vitamina M ou Vitamina Bc); Ácido Fólico (500 mg) Composto relacionado A","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-125","code":"2936.27.00","label":"- Ácido ascórbico, ésteres de ácido ascórbico","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-126","code":"2936.28.00","label":"- Tocoferóis","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-127","code":"2936.29.00","label":"- Niacinamida","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-128","code":"2937.21.00","label":"- Prednison padrão","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-129","code":"2937.23.00","label":"- Progesterona 20 mg","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-130","code":"2939.30.00","label":"- Cafeina e seus sais","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-131","code":"2940.00.00","label":"- Açúcares quimicamente puros","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-132","code":"2941.10.00","label":"- Penicilinas e seus derivados","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-133","code":"2941.30.00","label":"- Tetraclinas e seus derivados","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-134","code":"2941.90.00","label":"- Antibióticos - Outros","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-135","code":"2942.00.00","label":"- Compostos orgânicos","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-136","code":"3204.11.00","label":"- Corantes dispersos e preparações à base desses corantes","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-137","code":"3206.19.00","label":"- Outras matérias corantes - Outros","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-138","code":"3404.90.00","label":"- Cera microcristalina","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-139","code":"3503.00.00","label":"- Gelatina","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-140","code":"3505.10.00","label":"- Amidoglicolato de sódio (glicolato de amido sódico); Goma de amido TS; derivados de amido","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-141","code":"3701.99.00","label":"- Filmes, folhas e laminados: filmes de plástico; filmes de celulose regenerada; folhas ou lâminas de alumínio; folhas ou lâminas de alumínio (laminas ou revestidas com uma camada plástica)","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-142","code":"3901.90.00","label":"- Polietileno ( de baixa, média e alta densidade)","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-143","code":"3904.90.00","label":"- Cloresto de polivinilo (PVP) (com ou sem plastificante)","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-144","code":"3906.90.00","label":"- Polímero acrílico em forma primária - Outros","pdfPage":15,"lastPdfPage":15},
{"id":"annexIII-2022-145","code":"3911.90.00","label":"- Resinas sintéticas","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-146","code":"3912.31.00","label":"- Carboximetilcelulose e seus sais","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-147","code":"3912.90.00","label":"- Celulose e seus derivados - Outros","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-148","code":"3923.30.20","label":"- Embalagens para acondicionamento de medicamentos e produtos","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-149","code":"3926.90.90","label":"- Barricas plásticas, paletes de plástico","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-150","code":"4014.90.00","label":"- Artigos de higiene ou farmácia de borracha vulcanizada não endurecida - Outras","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-151","code":"4821.10.00","label":"- Etiquetas impressas (aprovação, reprovado, quarentena)","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-152","code":"5906.10.00","label":"- Fita gomada","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-153","code":"7010.10.00","label":"- Frascos de vidro, ampolas","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-154","code":"7017.90.00","label":"- Artefactos de vidro para laboratório, higiene e farmácia, mesmo graduados ou calibrados - Outros","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-155","code":"7310.10.00","label":"- Barricas metálicas","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-156","code":"7313.00.00","label":"- Arame farpado de ferro ou aço; Arames ou tiras retorcidos, mesmoi farpado de ferro ou aço, do tipo utinlizado em cercas","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-157","code":"7604.29.00","label":"- Placas de alumínio, ou ligas de alumínio","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-158","code":"7607.19.00","label":"- Placas de alumínio; filmes para fabrico de envelopes, blisters e strips","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-159","code":"7612.90.00","label":"- Recipientes para armazenamento e transporte de líquido","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-160","code":"7616.91.00","label":"- Paletes de alumínio","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-161","code":"8311.90.00","label":"- Outros fios, varetas, tubos, chapas e artefactos semelhantes de metais comuns","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-162","code":"8414.59.00","label":"- Câmaras de fluxo laminar","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-163","code":"8418.50.10","label":"-Refrigeradores, congeladores para usos nos laboratórios para fins medicinais","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-164","code":"8419.89.00","label":"- Estufa de leito fluidizado","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-165","code":"8456.90.00","label":"- Máquina para moldagem de supositórios","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-166","code":"8480.20.00","label":"- Placas de fundo para moldes","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-167","code":"9016.00.00","label":"- Balanças sensíveis e pesos iguais ou inferiores a 5 cg","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-168","code":"9018.39.00","label":"- Sistemas para bolsas de Injectáveis","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-169","code":"9025.19.00","label":"- Outros Termómetros","pdfPage":16,"lastPdfPage":16},
{"id":"annexIII-2022-170","code":"9025.90.00","label":"- Partes e acessórios de instrumentos de medição","pdfPage":16,"lastPdfPage":16}
];
export function pharmaAnnexEntry(id:unknown):PharmaAnnexEntry|undefined {return typeof id==='string'?pharmaAnnexEntries.find(entry=>entry.id===id):undefined;}
export function pharmaAnnexReference(entry:PharmaAnnexEntry):string {return `AnexoIII/2022: ${entry.id}; código ${entry.code}; ${entry.label}; PDF${entry.pdfPage}${entry.lastPdfPage===entry.pdfPage?'':`–${entry.lastPdfPage}`}; ${pharmaAnnexVersion}`;}
+36
View File
@@ -0,0 +1,36 @@
export type ProductionTaxOption = {mode:''|'annual'|'startup';declarationDate:string;startupDate:string;returnStatus:''|'none'|'declared';returnDeclarationDate:string;operationDate:string;origin?:{rowId:string;description:string;establishment:string}};
export const productionOptionVersion='production-option/2';
// Civil Code 279(c), read with 296: the term ends at 24:00 on this date.
// A missing anniversary day is clamped within the same month, never rolled to March.
export function productionMinimumTermEnd(effective:string):string {
const year=Number(effective.slice(0,4))+5,month=Number(effective.slice(5,7)),day=Number(effective.slice(8,10));
const leap=year%4===0&&(year%100!==0||year%400===0);
const lastDay=[31,leap?29:28,31,30,31,30,31,31,30,31,30,31][month-1];
return `${String(year).padStart(4,'0')}-${String(month).padStart(2,'0')}-${String(Math.min(day,lastDay)).padStart(2,'0')}`;
}
export const productionReturnEffective=(declarationDate:string):string=>String(Number(declarationDate.slice(0,4))+1).padStart(4,'0')+'-01-01';
export const emptyProductionTaxOption = ():ProductionTaxOption=>({mode:'',declarationDate:'',startupDate:'',returnStatus:'',returnDeclarationDate:'',operationDate:''});
export function productionOptionCheck(option:ProductionTaxOption|undefined,period:string):{error?:string;summary?:string} {
const valid=(value:unknown):value is string=>typeof value==='string'&&/^\d{4}-\d{2}-\d{2}$/.test(value)&&Number(value.slice(0,4))>=1&&Number.isFinite(new Date(value+'T00:00:00Z').valueOf())&&new Date(value+'T00:00:00Z').toISOString().slice(0,10)===value;
if(!option||!['annual','startup'].includes(option.mode)||!valid(option.declarationDate)||!valid(option.operationDate))return {error:'Indique o tipo/data da declaração de opção e a data da operação; não se presume renúncia eficaz.'};
if(option.operationDate.slice(0,7)!==period)return {error:'A data da operação deve pertencer ao período desta linha; não repartir montantes automaticamente.'};
let effective=String(Number(option.declarationDate.slice(0,4))+1).padStart(4,'0')+'-01-01';
if(option.mode==='startup'){
if(!valid(option.startupDate)||option.declarationDate>option.startupDate)return {error:'Na opção constante da declaração de início, indique a data de início e uma declaração que não lhe seja posterior.'};
effective=option.startupDate;
}
if(option.operationDate<effective)return {error:`Opção ainda sem efeitos nesta operação; início de efeitos ${effective}.`};
if(!['none','declared'].includes(option.returnStatus))return {error:'Indique expressamente se existe declaração de regresso à isenção; informação desconhecida não significa ausência de declaração.'};
if(option.returnStatus==='none'&&option.returnDeclarationDate)return {error:'Foi indicada ausência de declaração de regresso, mas existe uma data guardada; resolva a divergência explicitamente.'};
let end='';
if(option.returnStatus==='declared'){
if(!valid(option.returnDeclarationDate))return {error:'Data da declaração de regresso à isenção em falta ou inválida; não presumir uma data.'};
const anniversary=productionMinimumTermEnd(effective);
if(option.returnDeclarationDate<option.declarationDate)return {error:'A declaração de regresso antecede a declaração de opção; resolva a divergência do histórico.'};
if(option.returnDeclarationDate>anniversary)return {error:`A declaração de regresso indicada é posterior ao termo às 24 horas de ${anniversary}; o CIVA, art.11(3), exige entrega antes de expirar o prazo. Não presumir efeitos para esta declaração tardia.`};
end=productionReturnEffective(option.returnDeclarationDate);
if(end<=anniversary)return {error:`O regresso não pode produzir efeitos antes de terminado o prazo mínimo, às 24 horas de ${anniversary}.`};
if(option.operationDate>=end)return {error:`Opção já cessou na data desta operação; regresso à isenção com efeitos ${end}. Reveja o tratamento.`};
}
return {summary:`Art.11 (${productionOptionVersion}): declaração ${option.declarationDate} (${option.mode==='startup'?'opção no início da actividade':'opção anual'}); efeitos ${effective}; termo mínimo às 24 horas de ${productionMinimumTermEnd(effective)} (Código Civil, arts.279.º,c), e296.º); operação ${option.operationDate}; ${end?`declaração de regresso ${option.returnDeclarationDate}, efeitos ${end} (CIVA, art.11(3)); o termo do prazo não antecipa estes efeitos`:'ausência de declaração de regresso expressamente indicada; tributação continua, sem caducidade automática ao fim de cinco anos'}.${option.origin?` Opção reutilizada de ${option.origin.description} (${option.origin.rowId}), estabelecimento ${option.origin.establishment}; escolha confirmada nesta linha.`:''}`};
}
@@ -0,0 +1,57 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const propertyTransferVersion='property-transfers/1';
export const propertyTransferSource='CIVA Lei13/2016:3(3)a,PDF6/p1426(264),entrega material em locação com cláusula vinculante de transferência da propriedade;3(5),PDF7/p1426(265),cessão onerosa/gratuita de estabelecimento,totalidade ou parte de património que constitua ramo independente,adquirente2(1)a que pratique operações com direito à dedução;15(1),PDF13/p1426(271),contraprestação obtida/a obter.Lei22/2022PDF3 mantém15(1);Lei10/2025PDF12 mantém3(3)a/3(5),não altera15.P087não usa15(2)a,referente a consignação3(3)d.';
export const propertyTransferTreatments=[{id:'binding_lease',branch:'P087',label:'Locação com transferência vinculativa da propriedade'},{id:'business_onerous',branch:'P127',label:'Cessão onerosa de estabelecimento/património autónomo'},{id:'business_free',branch:'P127',label:'Cessão gratuita de estabelecimento/património autónomo'}] as const;
export const propertyTransferConditions={binding_lease:[['materialDelivery','Entrega material dos bens em execução do contrato de locação'],['bindingProperty','Contrato contém cláusula vinculante para ambas as partes de transferência da propriedade']],business_onerous:[['onerous','Cessão a título oneroso identificada'],['autonomousBusiness','Estabelecimento,totalidade ou parte de património susceptível de constituir ramo de actividade independente'],['acquirer2a','Adquirente é ou passa,pela aquisição,a sujeito passivo2(1)a'],['deductionActivities','Adquirente pratica operações que concedem direito à dedução']],business_free:[['gratuitous','Cessão a título gratuito identificada'],['autonomousBusiness','Estabelecimento,totalidade ou parte de património susceptível de constituir ramo de actividade independente'],['acquirer2a','Adquirente é ou passa,pela aquisição,a sujeito passivo2(1)a'],['deductionActivities','Adquirente pratica operações que concedem direito à dedução']]} as const;
export function transferConditions(t:string):ReadonlyArray<readonly[string,string]>{return propertyTransferConditions[t as keyof typeof propertyTransferConditions]??[];}
type Choice=''|'yes'|'no';
export type PropertyTransferRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';operationDate:string;operationRef:string;documentRef:string;documentDate:string;goodsRef:string;scope:string;evidence:string;contractRef:string;propertyClauseRef:string;acquirerRef:string;autonomousRef:string;activitiesRef:string;consideration:string;considerationRef:string;currency:string;compositionConfirmed:Choice;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';classification:'goods_transmission'|'tax_not_exigible_3_5'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type PropertyTransferCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:PropertyTransferRow[];rows:LineResult[]};
export type PropertyTransferBook={rows:PropertyTransferRow[];result?:PropertyTransferCalculation;history?:PropertyTransferCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{propertyTransfers?:Record<string,PropertyTransferBook>};
export function newPropertyTransfer(id:string,currency:string):PropertyTransferRow{return{id,treatment:'',description:'',period:'',origin:'projected',operationDate:'',operationRef:'',documentRef:'',documentDate:'',goodsRef:'',scope:'',evidence:'',contractRef:'',propertyClauseRef:'',acquirerRef:'',autonomousRef:'',activitiesRef:'',consideration:'',considerationRef:'',currency,compositionConfirmed:'',conditions:{}};}
export function switchPropertyTreatment(row:PropertyTransferRow,treatment:string):PropertyTransferRow{return{...row,treatment,conditions:{},compositionConfirmed:''};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.propertyTransfers!==undefined&&(!store.propertyTransfers||typeof store.propertyTransfers!=='object'||Array.isArray(store.propertyTransfers)))throw new Error('Transmissões de propriedade não recuperáveis;originais preservados.');
const fields=Object.keys(newPropertyTransfer('','')).filter(k=>k!=='conditions');
for(const book of Object.values(store.propertyTransfers??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(k=>typeof row[k as keyof PropertyTransferRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas não recuperáveis;originais conservados,sem lista vazia por defeito.');
return store;
}
export function propertyTransferBook(draft:Record<string,unknown>):PropertyTransferBook{return readStore(draft).propertyTransfers?.[acquisitionScope(draft)]??{rows:[]};}
export function savePropertyTransferBook(draft:Record<string,unknown>,book:PropertyTransferBook):string{const store=readStore(draft),encoded=JSON.stringify({...store,propertyTransfers:{...store.propertyTransfers,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function validDate(s:string):boolean{const n=Date.parse(s+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(n)&&new Date(n).toISOString().slice(0,10)===s;}
function decimal(raw:string):bigint|null{if(!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[w,f='']=raw.trim().split('.');return BigInt(w)*1000000n+BigInt(f.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
export function evaluatePropertyTransfer(row:PropertyTransferRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',classification:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};
const stop=(reason:string,status:LineResult['status']='indeterminate',classification:LineResult['classification']=status==='not_applicable'?'not_applicable':result.classification)=>({...result,status,classification,reason});
if(!propertyTransferTreatments.some(t=>t.id===row.treatment))return stop('Identifique locação vinculativa ou cessão onerosa/gratuita de estabelecimento.');
if(!validDate(row.operationDate)||!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||row.period!==row.operationDate.slice(0,7)||!['projected','effective'].includes(row.origin))return stop('Identifique data/mês2026 e dados efectivos ou pressupostos expressos.');
if(![row.description,row.operationRef,row.documentRef,row.goodsRef,row.scope,row.evidence,row.contractRef].every(v=>!!v.trim())||!validDate(row.documentDate))return stop('Identifique objecto,operação,contrato/documento/data e âmbito factual ou pressupostos;reutilize referências,sem certificado/aprovador novo.');
const conditions=transferConditions(row.treatment);
if(conditions.some(([k])=>row.conditions[k]==='no'))return stop(row.treatment==='binding_lease'?'Não estão reunidos os factos de3(3)a;não converter automaticamente opção de compra em transferência vinculativa.':'Não estão reunidos os requisitos de não exigibilidade3(5);classificar a transmissão pelos restantes percursos aplicáveis,sem isenção/IVA zero.','not_applicable');
if(conditions.some(([k])=>row.conditions[k]!=='yes'))return stop('Factos próprios por esclarecer;desconhecido não é não aplicável.');
if(row.treatment==='binding_lease'){
if(!row.propertyClauseRef.trim())return stop('Identifique cláusula vinculante para ambas as partes;mera opção de compra não a demonstra.');
result.classification='goods_transmission';
if(currency!=='MZN'||row.currency!==currency)return stop('Transmissão3(3)a identificada;base em moeda fora do recorteMZN ou divergente,sem conversão silenciosa.');
const value=decimal(row.consideration);
if(value===null||!row.considerationRef.trim()||row.compositionConfirmed!=='yes')return stop('Transmissão3(3)a identificada;base15(1) por esclarecer. Identifique contraprestação obtida/a obter e composição correspondente,sem próprioIVA e sem voltar a subtrair componentes já excluídas;não somar rendas/valor residual automaticamente.');
return{...result,status:'determined',baseAmount:money(value),reason:`P087:entrega material em locação com cláusula vinculativa3(3)a;base15(1)=${money(value)}MZN,contraprestação obtida/a obter segundo composição e âmbito identificados.Não é consignação3(3)d/15(2)a,nem mera opção de compra.Não calcula IVA,exigibilidade,nova dedução/campo11 ou totaisModeloA.`};
}
if(![row.acquirerRef,row.autonomousRef,row.activitiesRef].every(v=>!!v.trim()))return stop('Identifique adquirente2(1)a,conjunto susceptível de ramo independente e operações que conferem direito à dedução;simples venda de activos não basta.');
return stop('P127:cessão '+(row.treatment==='business_onerous'?'onerosa':'gratuita')+'3(5) identificada como transmissão de bens cujo imposto não é devido nem exigível,segundo conjunto/adquirente/operações e âmbito demonstrados.Não é isenção genérica,nem taxa/base zero.Não concede dedução ao adquirente;qualidade e operações são factos do enquadramento.Sem condição adicional de continuidade,certificado ou aprovador inventados.','determined','tax_not_exigible_3_5');
}
function key(draft:Record<string,unknown>,book:PropertyTransferBook):string{return JSON.stringify({version:propertyTransferVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function propertyTransferCurrent(draft:Record<string,unknown>,book:PropertyTransferBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordPropertyTransfers(draft:Record<string,unknown>,book:PropertyTransferBook):PropertyTransferBook{
if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:PropertyTransferCalculation={version:propertyTransferVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:propertyTransferSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluatePropertyTransfer(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};savePropertyTransferBook(draft,next);return next;
}
export function propertyTransferReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=propertyTransferBook(draft),r=book.result;if(!r)return[];return r.inputs.map((row,i)=>['IVA mensal',`${propertyTransferTreatments.find(t=>t.id===row.treatment)?.branch??'Transmissão'} — ${row.period} — ${row.id}`,`${row.description};${r.rows[i].reason};base:${r.rows[i].baseAmount??'Indeterminada'} ${row.currency};IVA:Indeterminado`,`${r.opportunity};${r.location};${propertyTransferCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${r.revision};${r.calculatedAt};${r.source};${row.origin};operação ${row.operationRef},${row.operationDate};documento ${row.documentRef},${row.documentDate};bens ${row.goodsRef};âmbito ${row.scope};contrato ${row.contractRef};${row.treatment==='binding_lease'?`cláusula ${row.propertyClauseRef};contraprestação ${row.consideration},${row.considerationRef};composição ${row.compositionConfirmed}`:`adquirente ${row.acquirerRef};conjunto autónomo ${row.autonomousRef};operações adquirente ${row.activitiesRef}`};condições${JSON.stringify(row.conditions)};fundamento ${row.evidence};sem nova dedução/campo11/IVA/margem automática.`]);}
catch{return[['IVA mensal','Transmissões de propriedade','Dados não recuperáveis','Originais conservados;sem classificação por defeito.']];}
}
@@ -0,0 +1,70 @@
import { acquisitionScope, readAcquisitionStore } from './iva-acquisitions.ts';
export const publicBaseVersion='public-authority-base/1';
export const publicBaseSource='CIVA republicado Lei13/2016,15(2)(d),PDF13/p1426(271): base das transmissões de bens e prestações de serviços resultantes de actos de autoridades públicas é a indemnização ou qualquer outra compensação. Art15(3)/(4),PDF14/p1426(272): componente não monetária pelo valor normal;15(5)/(6),composição/exclusões,incluindo exclusão do próprio IVA e indemnização judicial por incumprimento de contratos. Lei22/2022PDF3 mantém15(2)(d)/(3–6)por remissão;Lei10/2025não altera15. Recorte2026/MZN,determinação da base;sem inferir incidência,taxa,isenção,IVA,dedução/campo11 ou totaisModeloA.';
export const publicBaseTreatments=[
{id:'public_authority_indemnity',label:'Indemnização por acto de autoridade pública'},
{id:'public_authority_compensation',label:'Outra compensação por acto de autoridade pública'},
] as const;
export const publicBaseConditions=[
['taxableDomesticSupply','Está identificada uma transmissão de bens ou prestação de serviços sujeita a IVA no território nacional; não basta existir um pagamento ou uma entidade pública'],
['authorityAct','A transmissão ou prestação resulta do acto da autoridade pública identificado'],
['compensationLink','O montante e as componentes indicadas correspondem à indemnização ou compensação desta operação'],
['notJudicialContractBreach','Não se trata de quantia recebida a título de indemnização declarada judicialmente por incumprimento total ou parcial de contrato, excluída pelo artigo15(6)(a)'],
['netComposition','Os valores indicados excluem o próprio IVA e reflectem a composição aplicável dos números5/6 do artigo15, sem omissões nem duplicações; a referência explica a composição'],
] as const;
type Condition=typeof publicBaseConditions[number][0];
type Choice=''|'yes'|'no';
export type PublicBaseRow={id:string;treatment:string;description:string;operationNature:''|'goods'|'services';period:string;origin:'projected'|'effective';currency:string;authority:string;actRef:string;documentRef:string;documentDate:string;compensationForm:''|'money'|'non_money'|'mixed';moneyAmount:string;nonMoneyValue:string;valuationRef:string;compositionRef:string;evidence:string;conditions:Partial<Record<Condition,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type PublicBaseCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:PublicBaseRow[];rows:LineResult[]};
export type PublicBaseBook={rows:PublicBaseRow[];result?:PublicBaseCalculation;history?:PublicBaseCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{publicAuthorityBases?:Record<string,PublicBaseBook>};
export function newPublicBase(id:string,currency:string):PublicBaseRow{return{id,treatment:'',description:'',operationNature:'',period:'',origin:'projected',currency,authority:'',actRef:'',documentRef:'',documentDate:'',compensationForm:'',moneyAmount:'',nonMoneyValue:'',valuationRef:'',compositionRef:'',evidence:'',conditions:{}};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.publicAuthorityBases!==undefined&&(!store.publicAuthorityBases||typeof store.publicAuthorityBases!=='object'||Array.isArray(store.publicAuthorityBases)))throw new Error('Bases de actos públicos não recuperáveis; originais preservados.');
const fields=Object.keys(newPublicBase('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.publicAuthorityBases??{})){
if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof PublicBaseRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de base tributável não recuperáveis; originais preservados,sem substituição por lista vazia.');
}
return store;
}
export function publicBaseBook(draft:Record<string,unknown>):PublicBaseBook{return readStore(draft).publicAuthorityBases?.[acquisitionScope(draft)]??{rows:[]};}
export function savePublicBaseBook(draft:Record<string,unknown>,book:PublicBaseBook):string{
const current=readStore(draft),encoded=JSON.stringify({...current,publicAuthorityBases:{...current.publicAuthorityBases,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;
}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluatePublicBase(row:PublicBaseRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};
const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
if(!publicBaseTreatments.some(item=>item.id===row.treatment))return stop('Escolha indemnização ou outra compensação por acto de autoridade pública; um pagamento genérico não determina esta base.');
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto; originais conservados,sem conversão.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique o período em2026 e dados efectivos declarados ou pressupostos de projecção; não são inferidos do orçamento.');
const failed=publicBaseConditions.filter(([key])=>row.conditions[key]==='no');
if(failed.length)return stop('Não se aplica esta determinação de base: '+failed.map(([,label])=>label).join('; ')+'. Não é isenção nem IVA zero; conserve o enquadramento próprio da operação.','not_applicable');
const missing=publicBaseConditions.filter(([key])=>row.conditions[key]!=='yes');
if(missing.length)return stop('Condições por indicar: '+missing.map(([,label])=>label).join('; ')+'. Desconhecido não significa não aplicável ou zero.');
if(!['goods','services'].includes(row.operationNature)||!row.description.trim()||!row.authority.trim()||!row.actRef.trim()||!row.documentRef.trim()||!row.compositionRef.trim()||!row.evidence.trim()||!validDate(row.documentDate))return stop('Identifique a operação,natureza,autoridade,acto,documento/data e fundamento da composição,ou pressupostos expressos; reutilize referências existentes,sem novo certificado.');
if(!['money','non_money','mixed'].includes(row.compensationForm))return stop('Indique se a compensação é em dinheiro,em espécie ou mista; ausência de resposta não elimina uma componente.');
const cash=row.compensationForm==='non_money'?0n:decimal(row.moneyAmount),kind=row.compensationForm==='money'?0n:decimal(row.nonMoneyValue);
if(cash===null||kind===null)return stop('Indique os valores sem IVA das componentes aplicáveis; montante em falta ou inválido não é zero.');
if(row.compensationForm!=='money'&&!row.valuationRef.trim())return stop('Identifique o fundamento do valor normal da componente não monetária,conforme15(3)/(4),ou o pressuposto expresso; não é avaliado pelo portal.');
const base=money(cash+kind);
return{...result,status:'determined',baseAmount:base,reason:`Base15(2)(d): componente monetária ${money(cash)} + valor normal não monetário ${money(kind)} = ${base}MZN,${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. Componentes sem IVA,não duplicadas,composição15(5)/(6) identificada. Base não é imposto; incidência/taxa/IVA/dedução/campo11 não são determinados por este cálculo.`};
}
function key(draft:Record<string,unknown>,book:PublicBaseBook):string{return JSON.stringify({version:publicBaseVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
function natureLabel(value:string):string{return value==='goods'?'Transmissão de bens':value==='services'?'Prestação de serviços':'Por indicar';}
function formLabel(value:string):string{return value==='money'?'Em dinheiro':value==='non_money'?'Em espécie':value==='mixed'?'Mista — dinheiro e espécie':'Por indicar';}
export function publicBaseCurrent(draft:Record<string,unknown>,book:PublicBaseBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordPublicBases(draft:Record<string,unknown>,book:PublicBaseBook):PublicBaseBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos; originais conservados.');
const result:PublicBaseCalculation={version:publicBaseVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:publicBaseSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluatePublicBase(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};savePublicBaseBook(draft,next);return next;
}
export function publicBaseReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=publicBaseBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base P090 — ${row.period} — ${row.id}`,`${row.description}; base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency}; IVA: Indeterminado; ${result.rows[index].reason}`,`${result.opportunity}; ${result.location}; ${publicBaseCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'}; versão${result.revision}; ${result.calculatedAt}; ${result.source}; ${row.origin==='projected'?'Projecção':'Dados efectivos declarados'}; ${publicBaseTreatments.find(item=>item.id===row.treatment)?.label??row.treatment}; natureza ${natureLabel(row.operationNature)}; autoridade ${row.authority}; acto ${row.actRef}; documento ${row.documentRef},${row.documentDate}; forma ${formLabel(row.compensationForm)}; ${row.compensationForm!=='non_money'?`dinheiro ${row.moneyAmount} ${row.currency}; `:''}${row.compensationForm!=='money'?`valor normal não monetário ${row.nonMoneyValue} ${row.currency},fundamento ${row.valuationRef}; `:''}composição ${row.compositionRef}; condições ${publicBaseConditions.map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')}; fundamento ${row.evidence}; não preenche totaisModeloA ou campo11.`]);}
catch{return[['IVA mensal','Base de actos públicos','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
+63
View File
@@ -0,0 +1,63 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const reducedBaseVersion='proportional-bases/1';
export const reducedBaseSource='CIVA15(2)j/k/l/m,15(1)/(5)/(6)/(9),Lei13/2016PDF13–14/p1426(271–272);Lei22/2022PDF3mantém15(2)j–m;Lei10/2025não altera15 eadita18(6),PDF13:dedução do imposto suportado relativo a estas operações na mesma proporção da base reduzida. Recorte2026/MZN;base apenas,sem taxaIVA/IVA/dedução/campo11 ou totaisModeloA. Energia62%,taxas aeronáuticas85%,obras redução60%(base40%),água75%. Percentagem de base não é taxaIVA.';
export const reducedBaseTreatments=[{id:'regulated_energy',branch:'P096',clause:'j',label:'P096 — Energia com preço fixado por Autoridade Pública',percent:62},{id:'aeronautical_fees',branch:'P097',clause:'k',label:'P097 — Serviços com preço fixado por taxas aeronáuticas',percent:85},{id:'public_works',branch:'P098',clause:'l',label:'P098 — Obras públicas abrangidas',percent:40},{id:'public_water',branch:'P099',clause:'m',label:'P099 — Água potável por rede pública e preço fixado',percent:75}] as const;
export const reducedBaseConditions=[['taxableOperation','Está identificada a operação sujeita a IVA e a correspondência com este tratamento'],['fullNetInvoice','O montante é a contraprestação total da operação/factura antes desta redução,sem o próprioIVA ecom composição15(1)/(5)/(6)conferida'],['scopeMatches','Documentos/referências ou pressupostos expressos correspondem ao objecto,local,operação eperíodo']] as const;
export const reducedOwnConditions={
regulated_energy:[['energySupply','Transmissão de energia identificada'],['publicFixedPrice','Preço fixado pela Autoridade Pública identificada na referência aplicável']],
aeronautical_fees:[['aeronauticalPrice','Preço do serviço fixado através de taxas aeronáuticas;uma descrição de comunicações,saneamento ou telecomunicações não basta']],
public_works:[['publicWorks','Construção ou reabilitação de obras públicas abrangidas15(2)l/15(9)'],['workCategoryMatches','A categoria eâmbito da obra correspondem ao projecto público identificado']],
public_water:[['potableWater','Fornecimento de água potável'],['publicNetwork','Fornecimento através de rede pública'],['publicFixedPrice','Preço fixado pela Autoridade Pública identificada na referência aplicável']],
} as const;
export const publicWorkCategories=[{id:'roads',label:'Estradas'},{id:'bridges',label:'Pontes'},{id:'water_infrastructure',label:'Infra-estruturas de abastecimento de água/saneamento15(9)a'},{id:'rural_electricity',label:'Electrificação rural em projectos públicos15(9)b'},{id:'agricultural_hydraulics',label:'Hidráulica agrícola no âmbito definido15(9)c'}] as const;
export function ownReducedConditions(treatment:string):ReadonlyArray<readonly[string,string]>{return reducedOwnConditions[treatment as keyof typeof reducedOwnConditions]??[];}
type Choice=''|'yes'|'no';type Condition=typeof reducedBaseConditions[number][0];
export type ReducedBaseRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';currency:string;operationDate:string;priceRef:string;priceScope:string;priceFrom:string;priceTo:string;documentRef:string;documentDate:string;consideration:string;projectRef:string;workCategory:string;compositionRef:string;evidence:string;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;deductionProportion:string|null;vat:null;rate:null;reason:string};
export type ReducedBaseCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:ReducedBaseRow[];rows:LineResult[]};
export type ReducedBaseBook={rows:ReducedBaseRow[];result?:ReducedBaseCalculation;history?:ReducedBaseCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{regulatedReducedBases?:Record<string,ReducedBaseBook>};
export function newReducedBase(id:string,currency:string):ReducedBaseRow{return{id,treatment:'',description:'',period:'',origin:'projected',currency,operationDate:'',priceRef:'',priceScope:'',priceFrom:'',priceTo:'',documentRef:'',documentDate:'',consideration:'',projectRef:'',workCategory:'',compositionRef:'',evidence:'',conditions:{}};}
export function switchReducedTreatment(row:ReducedBaseRow,treatment:string):ReducedBaseRow{return{...row,treatment,conditions:Object.fromEntries(reducedBaseConditions.map(([key])=>[key,row.conditions[key]??'']))};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.regulatedReducedBases!==undefined&&(!store.regulatedReducedBases||typeof store.regulatedReducedBases!=='object'||Array.isArray(store.regulatedReducedBases)))throw new Error('Bases reduzidas não recuperáveis;originais preservados.');
const fields=Object.keys(newReducedBase('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.regulatedReducedBases??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof ReducedBaseRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de bases reduzidas não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function reducedBaseBook(draft:Record<string,unknown>):ReducedBaseBook{return readStore(draft).regulatedReducedBases?.[acquisitionScope(draft)]??{rows:[]};}
export function saveReducedBaseBook(draft:Record<string,unknown>,book:ReducedBaseBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,regulatedReducedBases:{...current.regulatedReducedBases,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/100000000n}.${(n%100000000n).toString().padStart(8,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateReducedBase(row:ReducedBaseRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,deductionProportion:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
const rule=reducedBaseTreatments.find(t=>t.id===row.treatment);if(!rule)return stop('Identifique energia,taxas aeronáuticas,obras públicas ou água;sem percentagem por defeito.');
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbitoMZN ou divergente do projecto;sem conversão silenciosa.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique mês2026 e dados efectivos ou pressupostos expressos de projecção.');
const conditions=[...reducedBaseConditions,...ownReducedConditions(row.treatment)];if(conditions.some(([key])=>row.conditions[key]==='no'))return stop('Este tratamento de base reduzida não se aplica aos factos declarados;rever natureza/composição/âmbito,sem isenção ou IVAzero presumido.','not_applicable');
if(conditions.some(([key])=>row.conditions[key]!=='yes'))return stop('Condições por esclarecer;desconhecido não é não aplicável ou zero. Confirme o montante total antes da redução,sem próprioIVA.');
if(!row.description.trim()||!row.documentRef.trim()||!row.compositionRef.trim()||!row.evidence.trim()||!row.priceScope.trim()||!validDate(row.documentDate)||!validDate(row.operationDate)||row.operationDate.slice(0,7)!==row.period)return stop('Identifique operação,data/mês,documento/data,âmbito e composição ou pressupostos expressos;reutilize referências sem certificado/aprovador novo.');
if(row.treatment==='public_works'){
if(!row.projectRef.trim()||!publicWorkCategories.some(c=>c.id===row.workCategory))return stop('Identifique projecto/contrato público,categoria eâmbito da obra15(2)l/15(9);não aplicar a qualquer obra privada.');
}else if(!row.priceRef.trim()||!validDate(row.priceFrom)||row.operationDate<row.priceFrom||(row.priceTo!==''&&(!validDate(row.priceTo)||row.priceFrom>row.priceTo||row.operationDate>row.priceTo)))return stop('Identifique referência aplicável do preço/taxa e intervalo que abrange a operação;fim pode ficar vazio sem termo fixado,com correspondência temporal confirmada. Sem preço actual presumido para outro período.');
const amount=decimal(row.consideration);if(amount===null)return stop('Indique contraprestação total antes da redução,sem próprioIVA;desconhecido/inválido não é zero. Se só existe total comIVA,separe a composição no percurso aplicável antes de usar este campo.');
const base=money(amount*BigInt(rule.percent));
return{...result,status:'determined',baseAmount:base,deductionProportion:String(rule.percent)+'%',reason:`${rule.branch}:15(2)${rule.clause},base=${row.consideration}×${rule.percent}%=${base}MZN,${row.origin==='projected'?'sob pressupostos expressos':'nos dados efectivos declarados'}. ${row.treatment==='public_works'?'Redução de60% significa base40%,não base60%.':'Percentagem aplicada uma única vez ao montante total antes da redução,sem próprioIVA.'} Art18(6),Lei10/2025:dedução relativa a estas operações na mesma proporção(${rule.percent}%),sujeita às condições próprias;isto não calcula nem concede dedução/campo11. Base não é imposto;sem taxaIVA,IVA ou totaisModeloA. Decimal exacto,sem arredondamento fiscal presumido.`};
}
function key(draft:Record<string,unknown>,book:ReducedBaseBook):string{return JSON.stringify({version:reducedBaseVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function reducedBaseCurrent(draft:Record<string,unknown>,book:ReducedBaseBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordReducedBases(draft:Record<string,unknown>,book:ReducedBaseBook):ReducedBaseBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:ReducedBaseCalculation={version:reducedBaseVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:reducedBaseSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateReducedBase(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveReducedBaseBook(draft,next);return next;
}
export function reducedBaseReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=reducedBaseBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base ${reducedBaseTreatments.find(t=>t.id===row.treatment)?.branch??'reduzida'} — ${row.period} — ${row.id}`,`${row.description};base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;proporção18(6):${result.rows[index].deductionProportion??'Indeterminada'}(sem dedução calculada);${result.rows[index].reason}`,`${result.opportunity};${result.location};${reducedBaseCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};operação ${row.operationDate};âmbito ${row.priceScope};${row.treatment==='public_works'?`projecto/contrato ${row.projectRef};categoria ${row.workCategory}`:`preço/taxa ${row.priceRef};intervalo ${row.priceFrom} a ${row.priceTo||'sem termo fixado,correspondência confirmada'}`};contraprestação total antes redução ${row.consideration} ${row.currency};composição ${row.compositionRef};documento ${row.documentRef},${row.documentDate};condições ${[...reducedBaseConditions,...ownReducedConditions(row.treatment)].map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};sem dedução/campo11/totaisModeloA.`]);}
catch{return[['IVA mensal','Bases reduzidas','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
+56
View File
@@ -0,0 +1,56 @@
import {assessFiscalClaim} from './fiscal-claim-events.ts';
import {closureBook,closureCurrent,closureFingerprint} from './iva-closure.ts';
import {subtractFractions,fraction,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
export const refundSource='L3-D:CIVA21(5/6/7),Lei13/2016 PDF15–16,p1426(273–274);Lei22/2022 PDF3–4;Lei10/2025 PDF13/p2180(13),21(7a/8revogado/10/13/15). ModeloA/VAT Return9c0b99a8,p2/quadro11:26+27=25. Pedido,decisão e recebimento separados. Formalidades doRegulamento78/2017/30/2022/52/2025 não automatizadas;sem concessão automática.';
type Choice=''|'yes'|'no';
export type RefundSource={closureId:string;period:string;entityRef:string;origin:'projected'|'effective';allocationKey:string;calculatedAt:string;credit:FiscalFraction;carry:FiscalFraction;requested:FiscalFraction};
export type RefundReceipt={id:string;reference:string;date:string;amount:string};
export type RefundInput={id:string;source:RefundSource|null;ground:''|'four_months'|'high_credit'|'cessation';originPeriod:string;entitlementDate:string;cessationDate:string;groundRef:string;factsConfirmed:Choice;oldestFirst:Choice;stage:'preparation'|'submitted';requestReference:string;requestDate:string;decision:'pending'|'approved'|'partial'|'rejected';decisionReference:string;decisionDate:string;decisionIssuer:string;approvedAmount:string;receipts:RefundReceipt[]};
export type RefundResult={id:string;status:'determined'|'indeterminate';reason:string;inputKey:string;eligibility:'compatible'|'not_demonstrated'|'incompatible';requested:FiscalFraction|null;reported:FiscalFraction|null;approved:FiscalFraction|null;received:FiscalFraction|null;awaitingReceipt:FiscalFraction|null;notGranted:FiscalFraction|null;source:string};
export type RefundCalculation={calculatedAt:string;key:string;inputs:RefundInput[];rows:RefundResult[]};
export type RefundBook={version:1;rows:RefundInput[];result?:RefundCalculation;history?:RefundCalculation[]};
const scope=(d:Record<string,unknown>)=>String(d.context_opportunity||'general'),norm=(s:string)=>s.trim().toLocaleLowerCase();
const date=(s:string)=>/^20\d{2}-(0[1-9]|1[0-2])-\d{2}$/.test(s)&&!Number.isNaN(Date.parse(s))&&new Date(s).toISOString().slice(0,10)===s;
const period=(s:string)=>/^20\d{2}-(0[1-9]|1[0-2])$/.test(s);
const months=(a:string,b:string)=>(Number(b.slice(0,4))-Number(a.slice(0,4)))*12+Number(b.slice(5))-Number(a.slice(5));
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,RefundBook>{const m=store(d).ivaRefunds;if(m===undefined)return{};if(!m||typeof m!=='object'||Array.isArray(m))throw Error('Mapa de reembolsos não recuperável;sem o substituir.');return m as Record<string,RefundBook>;}
function validate(b:RefundBook):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('Livro de reembolsos não recuperável;originais preservados.');for(const r of b.rows)if(!r||!['id','originPeriod','entitlementDate','cessationDate','groundRef','requestReference','requestDate','decisionReference','decisionDate','decisionIssuer','approvedAmount'].every(k=>typeof r[k as keyof RefundInput]==='string')||!['','four_months','high_credit','cessation'].includes(r.ground)||!['','yes','no'].includes(r.factsConfirmed)||!['','yes','no'].includes(r.oldestFirst)||!['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 RefundReceipt]==='string')))throw Error('EntradasD não recuperáveis;sem montantes presumidos.');}
export function refundBook(d:Record<string,unknown>):RefundBook{const b=maps(d)[scope(d)]??{version:1,rows:[]};validate(b);return b;}
export function saveRefundBook(d:Record<string,unknown>,b:RefundBook):string{validate(b);const s=store(d);return JSON.stringify({...s,ivaRefunds:{...maps(d),[scope(d)]:b}});}
export function refundSources(d:Record<string,unknown>):RefundSource[]{const b=closureBook(d);if(!closureCurrent(d,b))return[];return(b.result?.rows??[]).flatMap(r=>{const p=r.fields['27'],c=r.fields['25'],carry=r.fields['26'];if(r.status!=='determined'||!p||!c||!carry||BigInt(p.numerator)<=0n)return[];const dependentUnreconciled=b.rows.some(input=>input.credits.some(credit=>credit.kind==='previous'&&credit.previousId===r.id)&&!b.result!.rows.some(result=>result.id===input.id&&result.status==='determined'));if(dependentUnreconciled)return[];return[{closureId:r.id,period:r.period,entityRef:r.entityRef,origin:r.origin,allocationKey:closureFingerprint([r.id,r.entityRef,r.origin,r.period,c,carry,p]),calculatedAt:b.result!.calculatedAt,credit:c,carry,requested:p}];});}
export function newRefund(id:string,source:RefundSource|null):RefundInput{return{id,source:source?structuredClone(source):null,ground:'',originPeriod:'',entitlementDate:'',cessationDate:'',groundRef:'',factsConfirmed:'',oldestFirst:'',stage:'preparation',requestReference:'',requestDate:'',decision:'pending',decisionReference:'',decisionDate:'',decisionIssuer:'',approvedAmount:'',receipts:[]};}
// A new calculation timestamp alone does not change an identical allocation.
function available(d:Record<string,unknown>,r:RefundInput):boolean{return !!r.source&&refundSources(d).some(s=>s.allocationKey===r.source!.allocationKey&&s.closureId===r.source!.closureId&&s.entityRef===r.source!.entityRef&&s.origin===r.source!.origin&&s.period===r.source!.period&&JSON.stringify([s.credit,s.carry,s.requested])===JSON.stringify([r.source!.credit,r.source!.carry,r.source!.requested]));}
function identity(r:RefundInput):string{return JSON.stringify([norm(r.source?.entityRef??''),r.source?.origin,r.source?.period,r.source?.closureId]);}
function uses(d:Record<string,unknown>,b:RefundBook):RefundInput[]{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 receiptIdentity(r:RefundInput,p:RefundReceipt):string{return JSON.stringify([norm(r.source?.entityRef??''),r.source?.origin,norm(p.reference)]);}
function past(d:Record<string,unknown>,b:RefundBook):RefundInput[]{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 key(d:Record<string,unknown>,b:RefundBook):string{const all=uses(d,b),old=past(d,b);return closureFingerprint([b.rows,b.rows.map(r=>available(d,r)),all.map(r=>[r.id,identity(r),r.receipts.map(p=>receiptIdentity(r,p))]),b.rows.map(r=>old.filter(v=>v.id!==r.id&&(v.stage==='submitted'||v.decision!=='pending'||v.receipts.length)).some(v=>identity(v)===identity(r)||r.receipts.some(p=>v.receipts.some(q=>receiptIdentity(v,q)===receiptIdentity(r,p)))))]);}
export function refundCurrent(d:Record<string,unknown>,b:RefundBook):boolean{return!!b.result&&b.result.key===key(d,b)&&b.result.rows.length===b.rows.length&&b.rows.every(r=>b.result!.rows.some(v=>v.id===r.id&&v.inputKey===closureFingerprint(r)));}
export function recordRefund(d:Record<string,unknown>,b:RefundBook,now=new Date().toISOString()):RefundBook{
validate(b);if(new Set(b.rows.map(r=>r.id)).size!==b.rows.length)throw Error('Identidade de pedido repetida.');const all=uses(d,b),old=past(d,b);
const rows=b.rows.map(row=>{
const r:RefundResult={id:row.id,status:'indeterminate',reason:'',inputKey:closureFingerprint(row),eligibility:'not_demonstrated',requested:null,reported:null,approved:null,received:null,awaitingReceipt:null,notGranted:null,source:refundSource};const stop=(reason:string)=>({...r,reason});const s=row.source;
if(!s||!available(d,row)||d.currency!=='MZN'||!/^2026-(0[1-9]|1[0-2])$/.test(s.period))return stop('Escolha afectação26/27 actual e recuperável do mesmo período2026/MZN;crédito já reportado não é pedido disponível.');
if(all.filter(v=>identity(v)===identity(row)).length>1||old.some(v=>v.id!==row.id&&identity(v)===identity(row)&&(v.stage==='submitted'||v.decision!=='pending'||v.receipts.length)))return stop('Parcela já ligada a outro pedido no âmbito recuperado;sem pedir ou consumir duas vezes o mesmo crédito.');
r.requested=s.requested;r.reported=s.carry;
let eligibilityReason='';
if(!row.ground||!period(row.originPeriod)||row.originPeriod>s.period||!date(row.entitlementDate)||row.entitlementDate.slice(0,7)!==row.originPeriod||!row.groundRef.trim()||row.factsConfirmed!=='yes'||row.oldestFirst!=='yes')eligibilityReason='Fundamento/origem/nascimento do crédito,suporte ou consideração dos créditos mais antigos ainda não demonstrados;sem direito presumido.';
if(!date(row.requestDate)||row.requestDate.slice(0,7)<s.period||!row.requestReference.trim())return stop('Identifique referência e data do pedido ou preparação;separar da decisão.');
if(!eligibilityReason){
const lastYear=Number(row.entitlementDate.slice(0,4))+10,lastMonth=Number(row.entitlementDate.slice(5,7)),lastDay=Math.min(Number(row.entitlementDate.slice(8)),new Date(Date.UTC(lastYear,lastMonth,0)).getUTCDate());const anniversary=`${lastYear}-${String(lastMonth).padStart(2,'0')}-${String(lastDay).padStart(2,'0')}`;
const above=(n:bigint)=>BigInt(subtractFractions(s.credit,fraction(n)).numerator)>0n;
if(row.requestDate<row.entitlementDate||row.requestDate>anniversary){r.eligibility='incompatible';eligibilityReason='Datas declaradas incompatíveis com nascimento do direito/limite10anos de21(15),Lei10/2025;conservar documentos e identificar eventual excepção.';}
else if(row.ground==='four_months'&&(months(row.originPeriod,s.period)<4||!above(100000n))||row.ground==='high_credit'&&!above(500000n)||row.ground==='cessation'&&(!date(row.cessationDate)||row.cessationDate>row.requestDate)){r.eligibility='incompatible';eligibilityReason='Factos declarados não demonstram21(6),quatro meses/crédito superior100000;21(7a),superior500000;ou21(7b),cessação identificada.';}
else r.eligibility='compatible';
}
const events=assessFiscalClaim(row,s.requested,p=>{const id=receiptIdentity(row,p);return all.flatMap(v=>v.receipts.filter(q=>receiptIdentity(v,q)===id)).length>1||old.some(v=>v.id!==row.id&&v.receipts.some(q=>receiptIdentity(v,q)===id));});Object.assign(r,events);
if(events.status==='indeterminate')return r;
if(row.decision==='pending'){if(eligibilityReason){r.status='indeterminate';return stop(eligibilityReason+' Pedido/estado conservados;formalidades regulamentares não automatizadas.');}r.reason=row.stage==='preparation'?'Pedido em preparação;parcela separada do reporte,sem submissão,decisão ou recebimento.':'Pedido apresentado fora doInvesteMoz;decisão e recebimento ainda não identificados.';return r;}
r.reason=(eligibilityReason?'Decisão externa documentada registada independentemente da avaliação automática do fundamento: '+eligibilityReason+' ':'')+'Pedido,decisão e recebimento separados;parcela27 não é reutilizada em26. Parte não deferida/indeferimento não libertam crédito automaticamente;eventual retorno exige procedimento documentado e reconciliação,sem duplicar20. Recebimento é registo declarado,sem execução bancária ou alteração silenciosa de caixa. Formalidades e suspensões não automatizadas;150dias não são promessa de recebimento.';return r;
});
const result={calculatedAt:now,key:key(d,b),inputs:structuredClone(b.rows),rows};return{...b,...(b.result?{history:[...(b.history??[]),structuredClone(b.result)]}:{}),result};
}
export function refundReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=refundBook(d);if(!b.rows.length)return[];const out:Array<[string,string,string,string]>=[['IVA mensal','L3-D — reembolso geral',refundCurrent(d,b)?'Resultado correspondente às entradas':'Histórico preservado;rever entradas/afectação',refundSource]],fmt=(v:FiscalFraction|null|undefined)=>v?fractionPresentation(v).decimal:'Indeterminado';for(const r of b.result?.rows??[]){const input=b.result!.inputs.find(v=>v.id===r.id),s=input?.source;out.push(['IVA mensal',`Reembolso — ${s?.period??'por identificar'}`,`Fundamento:${r.eligibility==='compatible'?'Compatível com factos declarados':r.eligibility==='incompatible'?'Divergência nos factos — ver suporte':'Não demonstrado automaticamente'};Pedido27:${fmt(r.requested)};reporte26 separado:${fmt(r.reported)};reconhecido:${fmt(r.approved)};recebido:${fmt(r.received)};aguarda recebimento:${fmt(r.awaitingReceipt)};não deferido:${fmt(r.notGranted)}`,`${s?.entityRef??''};${scope(d)};MZN;${s?.origin==='effective'?'Dados efectivos declarados':'Pressuposto de simulação'};${input?.stage==='submitted'?'Apresentado fora doInvesteMoz':'Em preparação'};pedido ${input?.requestReference??''},${input?.requestDate??''};origem${input?.originPeriod??''},nascimento${input?.entitlementDate??''};${input?.groundRef??''};${r.reason}`]);out.push(['IVA mensal',`Decisão e recebimento — ${s?.period??''}`,`Decisão:${input?.decision==='approved'?'Deferido':input?.decision==='partial'?'Deferimento parcial':input?.decision==='rejected'?'Indeferido':'Pendente'};documento${input?.decisionReference??''};${input?.decisionDate??''};${input?.decisionIssuer??''};recebimentos:${input?.receipts.map(p=>`${p.reference};${p.date};${p.amount}MZN`).join(' | ')||'nenhum registado'}`,`Afectação do fecho${s?.closureId??''},versão${s?.calculatedAt??''};25:${fmt(s?.credit)}=26:${fmt(s?.carry)}+27:${fmt(s?.requested)};âmbito apenas desta parcela;versão guardada${b.result!.calculatedAt};${refundSource}`]);}return out;}catch{return[['IVA mensal','L3-D','Pedido não recuperável','Originais preservados;sem concessão/recebimento presumidos.']];}}
+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;}
+122
View File
@@ -0,0 +1,122 @@
export const ippItems=[
{
"id": "1",
"label": "Bens destinados ao uso oficial das missões diplomáticas, postos consulares, organismos internacionais e suas agências acreditados em Moçambique, nos termos da legislação específica sobre a matéria."
},
{
"id": "2",
"label": "Os objectos destinados aos agentes diplomáticos ou consulares de carreira e funcionários internacionais, nos termos da legislação específica sobre a matéria."
},
{
"id": "3",
"label": "Amostras, isoladas ou em colecções, devidamente rotuladas, que de qualquer maneira apresentem as características que lhes são peculiares, sem valor comercial."
},
{
"id": "4",
"label": "Prémios ganhos em concursos públicos ou competições desportivas e Culturais."
},
{
"id": "5",
"label": "Bagagens, nos termos definidos por lei."
},
{
"id": "6",
"label": "Artigos de espólios que possam ser importados sob regime de bagagem, bem como féretros, coroas e emblemas funerários que os acompanhem."
},
{
"id": "7",
"label": "Objectos destinados aos mostruários dos museus de utilidade pública."
},
{
"id": "8",
"label": "Objectos considerados pelo Ministério da Cultura como obras de arte ou com valor histórico."
},
{
"id": "9",
"label": "Dádivas destinadas a prisioneiros de guerra nos termos do artigo 3 da Convenção de Genebra, assinada em 22 de Julho de 1929, relativa ao tratamento de prisioneiros de guerra."
},
{
"id": "10",
"label": "Filmes didácticos ou científicos, destinados aos Ministérios interessados."
},
{
"id": "11",
"label": "Material de guerra e de aquartelamento, fardamentos, destinados à utilização oficial das Forças de Defesa e Segurança."
},
{
"id": "12",
"label": "Mercadorias cujas isenções estejam previstas em Acordos e Tratados assinados ou reconhecidos pelo Governo da República de Moçambique."
},
{
"id": "13",
"label": "Produtos trazidos em pequenas quantidades dos países vizinhos pelas populações fronteiriças, para consumo pessoal ou familiar."
},
{
"id": "14",
"label": "Material e equipamento científico e didáctico ou de laboratório destinados à educação, ensino e investigação científico-técnica, devidamente confirmado pelo sector de tutela."
},
{
"id": "15",
"label": "Notas e moedas estrangeiras quando importadas por instituições bancárias devidamente autorizadas, para o efeito."
},
{
"id": "16",
"label": "Notas e moedas com curso legal no País quando importadas pelo Banco de Moçambique."
},
{
"id": "17",
"label": "Documentos de tráfego importados por companhias aéreas, empresas ferroviárias, companhias marítimas tais como carta de porte, documentos de embarque, bilhetes de passagem, etiqueta de bagagem."
},
{
"id": "18",
"label": "Documentos de trabalho, relatórios, proposta para concurso, planta e desenhos."
},
{
"id": "19",
"label": "Catálogos em papel ou em suporte magnético."
},
{
"id": "20",
"label": "Bens destinados a determinado uso industrial especificamente aprovado, regulado em legislação própria."
},
{
"id": "21",
"label": "Helicópteros, aviões e outros veículos aéreos, destinados a serviços comerciais de transporte público e à formação e capacitação de pessoal, em aeroclubes, embarcações para transporte público de passageiros, embarcações para investigação marinha, suas partes, acessórios e outros componentes para reposição, mediante confirmação do sector de tutela."
},
{
"id": "22",
"label": "Embarcações que se destinem ao exercício da actividade de transporte de cabotagem."
},
{
"id": "23",
"label": "Embarcações de pesca; equipamento de construção e reparação naval; motores para desenvolvimento de pesca de pequena escala; equipamento, sementes, reprodutores, rações e larvas de camarão para desenvolvimento de aquacultura; carrinhas frigoríficas para transporte de pescado; equipamento de laboratórios e reagentes."
},
{
"id": "24",
"label": "Artigos médicos, próteses e correlatos, importadas através do Serviço Nacional de Saúde."
},
{
"id": "25",
"label": "Produtos e micronutrientes de administração nos veículos alimentares de fortificação obrigatória, definidos e regulados em legislação própria, quando confirmados pelo Sector de tutela."
},
{
"id": "26",
"label": "Animais bravios, no âmbito do Programa de Repovoamento dos Parques Nacionais, devidamente confirmados pelo sector de tutela."
},
{
"id": "27",
"label": "Sistema de irrigação e seus acessórios, bem como produtos que se destinam à vedação com vista à protecção de animais no âmbito da actividade agro-pecuária, confirmados pelo sector de tutela."
},
{
"id": "28",
"label": "Equipamentos e materiais importados ao abrigo de Acordos celebrados pelo Governo, para implementação de projectos públicos, nos quais se prevê que a despesa relativa aos direitos e outros encargos aduaneiros é suportada pelo Estado Moçambicano."
},
{
"id": "29",
"label": "Bens, equipamentos e materiais importados pelo Estado, no âmbito da saúde, devidamente confirmado pelo Sector de tutela."
},
{
"id": "30",
"label": "Veículos automóveis 87.02/87.04 destinados a instituições do Estado ou acordos/tratados para projectos do Estado, com direitos e encargos suportados pelo Estado Moçambicano."
}
] as const;
+77
View File
@@ -0,0 +1,77 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
import {ippItems} from './iva-remission-catalog.ts';
export {ippItems};
export const remissionVersion='remission-imports/1';
export const remissionSource='P047 — CIVA12(1)b, redacção Lei22/2022 PDF2/p2252(26), mantida Lei10/2025 PDF13. Lei7/91 art15(1)a/2, exemplar Assembleia/IFES PDF11/p9; Lei14/92 BR42 suplemento PDF23–24 não altera15. Lei4/94 art7 PDF2 e Decreto29/98 BR22-I 5.º suplemento PDF7–9 arts1–7,10–12. Decreto22/2021 BR70-I PDF1–2/p425–426 arts2–9,11–14, revoga3/83. IPP Lei17/2022 BR250 PDF4–5/p2238–2239 art22; Lei8/2025 BR248 suplemento PDF2–3 acrescenta30; Decreto37/2023 arts12(3),27/28 e QuadroV; Decreto27/2026 altera competências desde31/07/2026,30dias após publicação01/07,art3/PDF4/p1012(4). Classificação IVA2026/MZN baseada em isenção de direitos demonstrada; não concede benefício aduaneiro, não calcula direitos, ICE, base ou dedução/campo11.';
export const remissionFamilies=[['party','Partido político — equipamento para funcionamento próprio'],['patronage','Mecenato — livros/insumos ou fundamento específico'],['diplomatic','Veículos diplomáticos/consulares — regime próprio'],['ipp','Instruções Preliminares da Pauta — fundamento e âmbito próprios']] as const;
export const diplomaticRoles=[['mission','Missão diplomática ou consular'],['head','Chefe de missão'],['agent','Agente diplomático/cônsul de carreira ou equiparado'],['honorary','Cônsul honorário acreditado'],['technical','Pessoal administrativo ou técnico'],['agency','Agência especializada das Nações Unidas'],['organisation','Organização equiparada ao nível de privilégios']] as const;
type Choice=''|'yes'|'no';
export type RemissionRow={id:string;family:string;description:string;importer:string;period:string;currency:string;origin:'projected'|'effective';importDate:string;scope:string;evidence:string;documentRef:string;rights:''|'exempt'|'reduced'|'zero'|'none';rightsRef:string;decision:''|'not_required'|'planned'|'requested'|'approved'|'denied';decisionRef:string;decisionDate:string;requestRef:string;specialRef:string;ippItem:string;ippArticle:string;patronagePath:''|'book'|'donation'|'specific';role:string;quantity:string;existingQuantity:string;limit:string;limitRef:string;history:''|'none'|'known';previousDate:string;historyRef:string;agreementRef:string;conditions:Record<string,Choice>};
export type RemissionLine={id:string;status:'exempt'|'not_applicable'|'indeterminate';importVat:string|null;deduction:null;source:string;reason:string};
type Result={version:string;revision:number;calculatedAt:string;sourceKey:string;inputs:RemissionRow[];rows:RemissionLine[]};
export type RemissionBook={rows:RemissionRow[];result?:Result;history?:Result[]};
export function newRemission(id:string,currency:string):RemissionRow{return{id,currency,family:'',description:'',importer:'',period:'',origin:'projected',importDate:'',scope:'',evidence:'',documentRef:'',rights:'',rightsRef:'',decision:'',decisionRef:'',decisionDate:'',requestRef:'',specialRef:'',ippItem:'',ippArticle:'',patronagePath:'',role:'',quantity:'',existingQuantity:'',limit:'',limitRef:'',history:'',previousDate:'',historyRef:'',agreementRef:'',conditions:{}};}
function store(draft:Record<string,unknown>){const s=readAcquisitionStore(draft.modelo_a_snapshot) as ReturnType<typeof readAcquisitionStore>&{remissionImports?:Record<string,RemissionBook>};const fields=Object.keys(newRemission('','')).filter(k=>k!=='conditions');if(s.remissionImports!==undefined&&(!s.remissionImports||typeof s.remissionImports!=='object'||Array.isArray(s.remissionImports)))throw Error('Importações por remissão não recuperáveis; originais preservados.');for(const b of Object.values(s.remissionImports??{}))if(!b||!Array.isArray(b.rows)||(b.history!==undefined&&!Array.isArray(b.history))||b.rows.some(r=>!r||fields.some(k=>typeof r[k as keyof RemissionRow]!=='string')||!r.conditions||typeof r.conditions!=='object'||Array.isArray(r.conditions)||Object.values(r.conditions).some(v=>!['','yes','no'].includes(v))))throw Error('Linhas por remissão não recuperáveis; originais preservados.');return s;}
export function remissionBook(draft:Record<string,unknown>):RemissionBook{return store(draft).remissionImports?.[acquisitionScope(draft)]??{rows:[]};}
export function saveRemissionBook(draft:Record<string,unknown>,book:RemissionBook):string{const s=store(draft),value=JSON.stringify({...s,remissionImports:{...s.remissionImports,[acquisitionScope(draft)]:book}});store({...draft,modelo_a_snapshot:value});return value;}
type Condition=readonly[string,string];
export function remissionConditions(r:RemissionRow):Condition[]{
const common:Condition[]=[['goods','Importação de bens abrangidos pelo fundamento identificado'],['scope','Beneficiário, bens, operação, período e condições coincidem com o âmbito da isenção de direitos']];
if(r.family==='party')return [...common,['party','Importador é o partido político identificado e legalmente constituído'],['equipment','Bens de equipamento necessários ao funcionamento próprio do partido — art15(1)a'],['nonBusiness','Não se destinam a actividades económicas de natureza empresarial — art15(2)']];
if(r.family==='patronage')return [...common,...(r.patronagePath==='specific'?[['specific','A disposição expressa identificada concede isenção de direitos a estes bens; não basta doação ou dedução ao rendimento'] as Condition]:[['books','Livros culturais, científicos ou escolares, ou insumos para a sua produção nacional — Lei4/94 art7'] as Condition]),...(r.patronagePath==='donation'?[['eligible','Acção/liberalidade elegível no art4 do Regulamento e destinatário nos termos da Lei4/94 art2'],['nonProselytism','Sem proselitismo confessional ou partidário nem proveito pecuniário/patrimonial directo'],['exclusive','Bens exclusivamente afectos à finalidade elegível — Lei4/94 art4'],['valuation','Apoio não monetário avaliado pela factura ou preço normal — Lei4/94 art5'],['communications','Comunicações aos beneficiários, tutela e Finanças nos termos do art5 do Regulamento'],['handover','Termo de entrega rubricado pelo representante da tutela, nos termos do art6; ou pressuposto expresso'],['unrelated','Sem pessoas vinculadas nos termos do art7, incluindo janela de12meses'],['irreversible','Liberalidade expressamente irreversível — art10(3)'],['confirmation','Confirmação de Finanças e entidade da área abrangida — art11; ou pressuposto expresso da projecção']] as Condition[]:[])];
if(r.family==='diplomatic')return [...common,['accredited','Beneficiário acreditado e abrangido pelos arts2/3 do Decreto22/2021'],['vehicle','Veículo automóvel para uso abrangido pelo regime diplomático identificado'],...(['agency','organisation'].includes(r.role)?[['agreement','Acordo de Sede/específico cobre a isenção e as condições desta importação — arts11/12'] as Condition]:[['reciprocity','Reciprocidade e razoabilidade verificadas, incluindo restrições do Estado acreditante — arts4/7'],['register','Registo no MINEC e na AT para controlo quantitativo — art5, ou pressuposto expresso'],['caseRequest','Isenção requerida caso a caso através do MINEC — art7(2), ou pressuposto expresso'],...(['agent','technical'].includes(r.role)?[['foreignNonResident','Não é nacional nem residente permanente em Moçambique — art3(3)'] as Condition]:[])] as Condition[])];
if(r.family==='ipp')return [...common,['ippGoods',ippItems.find(i=>i.id===r.ippItem)?.label??'Disposição IPP específica identificada e aplicável'],['ownConditions','Condições, limites e legislação específica referida neste item demonstrados; não basta seleccionar a categoria'],['priorRequest','Requerimento prévio à entidade competente — Decreto37/2023 art27(2)'],['use','Uso exclusivo para o fim/beneficiário; compromisso de uso art28(1–3) identificado ou previsto']];
return [];
}
export function ippAuthority(item:string,date:string){const n=Number(item),current=date>='2026-07-31';if(n===30&&!current)return 'Competência específica anterior a31/07/2026 por identificar; não retroagir Decreto27/2026';const groups=current?[[[9,11,15,16,21,22,28,29],'Ministro das Finanças'],[[2,8,12,14,20,23,24,25,27,30],'Presidente da Autoridade Tributária'],[[1,3,4,7,10,26],'Director-Geral das Alfândegas'],[[5,6,13,17,18,19],'Chefes das Estâncias Aduaneiras']]:[[[8,9,11,15,16,21,22,23,28,29],'Ministro das Finanças'],[[2,4,12,14,20,24,25,27],'Presidente da Autoridade Tributária'],[[1,7,26],'Director-Geral das Alfândegas'],[[3,10],'Director Regional'],[[5,6,13,17,18,19],'Chefes das Estâncias Aduaneiras']];return groups.find(([ids])=>(ids as number[]).includes(n))?.[1] as string||'Competência segundo disposição específica identificada';}
function date(v:string){const d=new Date(v+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(v)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===v;}
function years(v:string,n:number){const d=new Date(v+'T00:00:00Z'),m=d.getUTCMonth();d.setUTCFullYear(d.getUTCFullYear()+n);if(d.getUTCMonth()!==m)d.setUTCDate(0);return d.toISOString().slice(0,10);}
const positive=(v:string)=>/^[1-9]\d{0,5}$/.test(v),nonnegative=(v:string)=>/^(0|[1-9]\d{0,5})$/.test(v);
export function evaluateRemission(r:RemissionRow,currency:unknown):RemissionLine{
const result:RemissionLine={id:r.id,status:'indeterminate',importVat:null,deduction:null,source:remissionSource,reason:''};const stop=(reason:string,status:RemissionLine['status']='indeterminate')=>({...result,status,reason});
if(!remissionFamilies.some(([k])=>k===r.family))return stop('Escolha uma das quatro famílias documentadas.');
if(currency!=='MZN'||r.currency!==currency||!/^2026-(0[1-9]|1[0-2])$/.test(r.period)||!date(r.importDate)||r.importDate.slice(0,7)!==r.period)return stop('Indique moedaMZN e data/período2026 coerentes; não se presume conversão.');
if(!['projected','effective'].includes(r.origin)||![r.description,r.importer,r.scope,r.evidence,r.documentRef,r.rightsRef].every(v=>v.trim()))return stop('Identifique bens, importador, âmbito, documentos e fundamento da isenção de direitos ou pressupostos expressos.');
if(['reduced','zero','none'].includes(r.rights))return stop('Não demonstrada isenção integral de direitos nesta remissão. Redução, taxa pautal0% e não incidência são distintas de isenção — Decreto37/2023 art12(3). Outros fundamentos e eventual regime proporcional permanecem separados.','not_applicable');
if(r.rights!=='exempt')return stop('Situação dos direitos indeterminada; não equivale a IVAzero.');
const conditions=remissionConditions(r);if(conditions.some(([k])=>r.conditions[k]==='no'))return stop('Condição própria desta família não satisfeita; outros fundamentos não são excluídos.','not_applicable');if(conditions.some(([k])=>r.conditions[k]!=='yes'))return stop('Condições próprias por esclarecer; nenhuma confirmação é inferida de outra família.');
if(r.family==='patronage'&&!['book','donation','specific'].includes(r.patronagePath))return stop('Escolha livro/insumo, liberalidade ou disposição específica; doação genérica não concede isenção de importação.');
if(r.family==='patronage'&&['donation','specific'].includes(r.patronagePath)&&!r.specialRef.trim())return stop('Identifique acção/liberalidade e confirmação regulamentar ou disposição específica e âmbito.');
if(r.family==='ipp'){
if(!ippItems.some(i=>i.id===r.ippItem)&&!(r.ippItem==='specific'&&r.ippArticle.trim()))return stop('Escolha itemIPP ou identifique artigo específico; lista não classifica automaticamente os bens.');
if(!date(r.decisionDate))return stop('Indique data da decisão ou previsão para aplicar a competência vigente nesse acto; a data de importação não a substitui.');
if(r.ippItem==='30'&&r.decisionDate<'2026-07-31'&&!r.ippArticle.trim())return stop('Item30 antes de31/07/2026:identifique a disposição de competência aplicável; não retroagir Decreto27/2026.');
if(!r.requestRef.trim()||!r.specialRef.trim())return stop('Identifique requerimento prévio, condições/remissões e compromisso de uso. Confirmação de tutela apenas quando prevista no item.');
result.source+=';IPP22/item'+r.ippItem+';'+r.ippArticle+';entidade segundo data:'+ippAuthority(r.ippItem,r.decisionDate);
}
if(r.family==='diplomatic'){
if(!diplomaticRoles.some(([k])=>k===r.role))return stop('Identifique categoria diplomática; os limites não são iguais.');
if(['agency','organisation'].includes(r.role)){if(!r.agreementRef.trim()||!r.specialRef.trim())return stop('Identifique o Acordo de Sede/específico, cláusula e condições; não aplicar automaticamente quotas de pessoas às organizações.');}
else{
if(!r.requestRef.trim()||!r.historyRef.trim()||!r.limitRef.trim()||!positive(r.quantity)||!nonnegative(r.existingQuantity))return stop('Identifique pedido viaMINEC, histórico externo e reciprocidade/limite; informe quantidades inteiras.');
const statutory=({head:3,agent:2,honorary:1,technical:1} as Record<string,number>)[r.role];const limit=positive(r.limit)?(r.role==='mission'?Number(r.limit):Math.min(Number(r.limit),statutory)):null;
if(limit===null||limit===undefined)return stop('Limite da missão fixado caso a caso pelo MINEC; sem limite numérico presumido.');
if(Number(r.quantity)+Number(r.existingQuantity)>limit)return stop('Quantidade excede o limite desta categoria/reciprocidade — art9; separar bens abrangidos e excedentes, sem isentar toda a linha.','not_applicable');
if(r.history==='known'&&(!date(r.previousDate)||r.importDate<years(r.previousDate,5)))return stop('Nova importação antes de decorridos cinco anos ou data anterior por esclarecer — art9(3).');
if(!['none','known'].includes(r.history))return stop('Histórico por esclarecer; dossier vazio não demonstra ausência de importação anterior.');
}
}
const required=r.family==='ipp'||r.family==='diplomatic'||(r.family==='patronage'&&r.patronagePath==='donation');
if(r.decision==='denied')return stop('Pedido indeferido neste âmbito; não há isenção concedida.','not_applicable');
if(r.decision==='requested')return stop('Pedido apresentado conserva benefício solicitado; não é concessão.');
if(required&&!((r.decision==='approved'&&r.decisionRef.trim())||(r.origin==='projected'&&r.decision==='planned'&&r.decisionRef.trim())))return stop('Indique decisão/confirmação abrangente ou pressuposto expresso de deferimento na projecção; efectivo não usa deferimento previsto.');
if(!required&&!['not_required','approved','planned'].includes(r.decision))return stop('Registe aplicação legal directa ou a decisão/pressuposto identificado; não é criada nova aprovação.');
if(!required&&['approved','planned'].includes(r.decision)&&(!r.decisionRef.trim()||(r.origin==='effective'&&r.decision==='planned')))return stop('Decisão/pressuposto deve ter referência e natureza coerentes.');
return {...result,status:'exempt',importVat:'0.00',reason:'Isenção de IVA12(1)b: '+(remissionFamilies.find(([k])=>k===r.family)?.[1]??r.family)+', apenas no âmbito da isenção de direitos demonstrada. '+(r.origin==='projected'?'Cenário condicionado aos pressupostos expressos; não benefício concedido.':'Factos efectivos e âmbito declarados; o portal não emite concessão.')+' Sem direitos, ICE, dedução/campo11, soma aos livros internos ou cálculo de alienação; restrições de uso e alterações de destino mantêm o seu regime próprio.'};
}
function key(draft:Record<string,unknown>,book:RemissionBook){return JSON.stringify({version:remissionVersion,scope:acquisitionScope(draft),currency:draft.currency,location:draft.selection_labels??{},rows:book.rows});}
export function remissionCurrent(draft:Record<string,unknown>,book:RemissionBook){return !!book.result&&book.result.sourceKey===key(draft,book);}
export function recordRemissions(draft:Record<string,unknown>,book:RemissionBook):RemissionBook{if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw Error('Identifique linhas distintas; originais preservados.');const result:Result={version:remissionVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),sourceKey:key(draft,book),inputs:structuredClone(book.rows),rows:book.rows.map(r=>evaluateRemission(r,draft.currency))};for(let i=0;i<book.rows.length;i++){const r=book.rows[i];if(r.family!=='diplomatic'||['agency','organisation'].includes(r.role)||result.rows[i].status!=='exempt')continue;const peers=book.rows.filter((p,j)=>j!==i&&p.family==='diplomatic'&&p.role===r.role&&p.importer===r.importer&&p.origin===r.origin&&evaluateRemission(p,draft.currency).status==='exempt');const statutory=({head:3,agent:2,honorary:1,technical:1} as Record<string,number>)[r.role]??Number(r.limit);const limit=Math.min(statutory,Number(r.limit),...peers.map(p=>Number(p.limit)));const quantity=Number(r.quantity)+peers.reduce((sum,p)=>sum+Number(p.quantity),0)+Math.max(Number(r.existingQuantity),...peers.map(p=>Number(p.existingQuantity)));if(quantity>limit||peers.some(p=>p.importDate!==r.importDate&&Math.max(Date.parse(p.importDate),Date.parse(r.importDate))<Date.parse(years(p.importDate<r.importDate?p.importDate:r.importDate,5))))result.rows[i]={...result.rows[i],status:'indeterminate',importVat:null,reason:'Linhas do mesmo beneficiário/categoria excedem o limite conjunto ou repetem importação em cinco anos; conferir histórico e bens abrangidos, sem dupla utilização.'};}const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveRemissionBook(draft,next);return next;}
export function remissionReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=remissionBook(draft),v=b.result;if(!v)return[];return v.inputs.map((r,i)=>{
const context=[`Importador:${r.importer}`,`natureza:${r.origin==='projected'?'projecção condicionada':'factos efectivos'}`,`data:${r.importDate}`,`documentos:${r.documentRef}`,`âmbito:${r.scope}`,`factos:${r.evidence}`,`direitos:${r.rights};fundamento:${r.rightsRef}`,`decisão:${r.decision};data:${r.decisionDate};referência:${r.decisionRef}`];
if(r.family==='ipp')context.push(`IPP:${r.ippItem};artigo:${r.ippArticle};condições e uso:${r.specialRef};requerimento:${r.requestRef}`);
if(r.family==='patronage')context.push(`Mecenato:${r.patronagePath};referência:${r.specialRef}`);
if(r.family==='diplomatic')context.push(`Categoria:${diplomaticRoles.find(([k])=>k===r.role)?.[1]??r.role}`,`acordo:${r.agreementRef}`,`pedido:${r.requestRef}`,`condições:${r.specialRef}`,`quantidade:${r.quantity};já abrangidos:${r.existingQuantity};limite:${r.limit};referência:${r.limitRef}`,`histórico:${r.historyRef};anterior:${r.previousDate||r.history}`);
context.push(...remissionConditions(r).map(([k,label])=>`${label}:${r.conditions[k]==='yes'?'Sim':r.conditions[k]==='no'?'Não':'Por esclarecer'}`));
return ['IVA mensal',`P047 — ${r.period} — ${r.id}`,`${r.description};${v.rows[i].reason};IVA:${v.rows[i].importVat??'Indeterminado'};dedução:Não apurada`,`${v.rows[i].source};${remissionCurrent(draft,b)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${v.revision};${v.calculatedAt};${context.join(';')}`];
});}catch(e){return[['IVA mensal','P047 — recuperação',String(e),'Originais preservados']];}}
+42
View File
@@ -0,0 +1,42 @@
import type {ReturneeRow,Line} from './iva-returnees.ts';
export const baggageSource='P058 — CIVA12(2)a;Decreto37/2023,57(2)c/d e57(3),PDF10/p1474;61 e63(1),PDF11/p1475. Decreto27/2026 altera14/58/QuadrosV/VI,sem alterar57/61/63. Fonte oficial arquivada porhash;sem condições de veículos ou de mineiros transplantadas à bagagem.';
export const baggageTreatments=[
{id:'civil_baggage',label:'Bagagem — funcionário civil em missão pública superior a um ano',article:'57(2)c/57(3)',remaining:0},
{id:'military_baggage',label:'Bagagem — militar em missão pública superior a um ano',article:'57(2)c/57(3)',remaining:0},
{id:'student_baggage',label:'Bagagem — estudante/bolseiro em missão de estudo superior a um ano',article:'57(2)c/57(3)',remaining:0},
{id:'early_state_baggage',label:'Bagagem — regresso antecipado por serviço do Estado',article:'57(2)d/57(3)',remaining:0},
] as const;
export const baggageConditions=[
['definitive','Regresso definitivo no âmbito desta operação'],
['mission','Categoria e missão pública ou de estudo identificadas,conforme o percurso escolhido'],
['reasonable','Bagagem em quantidades e qualidades razoáveis'],
['nonCommercial','Sem finalidade comercial'],
['baggageGoods','Bens desta linha abrangidos por57(3);não inclui veículos,armas ou munições'],
] as const;
export function isReturneeBaggage(treatment:string):boolean{return baggageTreatments.some(t=>t.id===treatment);}
function date(s:string):Date|null{const d=new Date(s+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===s?d:null;}
function anniversary(s:string){const d=date(s)!;const month=d.getUTCMonth();d.setUTCFullYear(d.getUTCFullYear()+1);if(d.getUTCMonth()!==month)d.setUTCDate(0);return d.toISOString().slice(0,10);}
export function evaluateBaggage(row:ReturneeRow,currency:unknown):Line{
const rule=baggageTreatments.find(t=>t.id===row.treatment),base:Line={id:row.id,status:'indeterminate',importVat:null,deduction:null,reason:'',source:baggageSource+(rule?';'+rule.article:'')};const stop=(reason:string,status:Line['status']='indeterminate')=>({...base,status,reason});
if(!rule)return stop('Percurso de bagagem não identificado;sem estender57(2)c/d à fixação de domicílio57(2)b.');
if(currency!=='MZN'||row.currency!==currency||!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!date(row.importDate)||row.importDate.slice(0,7)!==row.period)return stop('Indique importação2026 emMZN e data/período coerentes;sem conversão presumida.');
if(!['projected','effective'].includes(row.origin)||![row.description,row.beneficiary,row.scope,row.evidence,row.documentRef,row.missionRef??''].every(v=>v.trim()))return stop('Identifique beneficiário,bens,âmbito,documentos disponíveis e missão pública/estudo ou pressupostos expressos;reutilize referências,sem certificado adicional criado pelo portal.');
if(baggageConditions.some(([key])=>row.conditions[key]==='no'))return stop('Condição deste percurso de bagagem não satisfeita;outros regimes permanecem por enquadrar.','not_applicable');
if(baggageConditions.some(([key])=>row.conditions[key]!=='yes'))return stop('Condições da bagagem por esclarecer;desconhecido não equivale a isenção.');
if(!['personal','household'].includes(row.baggageKind??''))return stop('Distinga objectos de uso pessoal com sinais de uso57(3)a de móveis,roupas e objectos domésticos57(3)b;separe bens fora do conceito de bagagem.');
if(![row.stayStart,row.stayEnd,row.arrival].every(v=>date(v))||row.stayEnd<row.stayStart||row.stayEnd>row.arrival)return stop('Indique estadia no estrangeiro e chegada coerentes com a missão e o regresso.');
if(row.treatment==='early_state_baggage'){
if(!date(row.missionPlannedEnd??'')||row.missionPlannedEnd!<=anniversary(row.stayStart)||row.stayEnd>=row.missionPlannedEnd!)return stop('57(2)d exige missão inicialmente prevista para mais de um ano e regresso anterior ao termo previsto;sem impor uma duração efectiva mínima de um ano.');
if(row.conditions.earlyService==='no')return stop('Regresso antecipado não decorre de serviço doEstado;este57(2)d não se aplica.','not_applicable');
if(row.conditions.earlyService!=='yes'||!row.earlyReturnRef?.trim())return stop('Identifique motivo/referência do regresso antecipado por serviço doEstado,ou pressuposto expresso;sem inventar novo aprovador.');
}else if(row.stayEnd<=anniversary(row.stayStart))return stop('57(2)c exige permanência superior a um ano em missão pública ou de estudo;um ano exacto não satisfaz este percurso.','not_applicable');
if(!['accompanied','unaccompanied'].includes(row.baggageRoute??''))return stop('Indique bagagem acompanhada ou não acompanhada;os prazos da via não acompanhada são próprios doart61.');
if(row.baggageRoute==='unaccompanied'){
const elapsed=(date(row.importDate)!.getTime()-date(row.arrival)!.getTime())/86400000;
if(elapsed>180)return stop('Entrada da bagagem não acompanhada além de180dias da chegada;61(1) não demonstra isenção nesta hipótese. Não aplicar a prorrogação de veículos63.');
if(elapsed<0&&(row.conditions.advanceClearance!=='yes'||!row.earlyBaggageRef?.trim()))return stop('Desembaraço antes da chegada exige a excepção61(2),com motivo justificado e autorização do chefe da estância aduaneira da jurisdição ou pressuposto expresso;não presumida.');
}else if(row.importDate<row.arrival)return stop('Bagagem declarada acompanhada não pode entrar antes da chegada do viajante;conferir a via e as datas.');
const kind=row.baggageKind==='personal'?'objectos de uso pessoal com sinais de uso57(3)a':'móveis,roupas e objectos de uso doméstico57(3)b';
return{...base,status:'exempt',importVat:'0.00',reason:`Bagagem abrangida por${rule.article}:${kind};${row.baggageRoute==='unaccompanied'?'via não acompanhada61':'via acompanhada'}. ${row.origin==='projected'?'Cenário condicionado aos pressupostos expressos':'Factos efectivos declarados no âmbito identificado'};IVA de importação isento no benefício integral indicado.Sem concessão administrativa automática,direitos,ICE,dedução ou campo11.Sem exigir nacionalidade/idade mínima,quota5anos ou requerimento60+30dias de veículos.Oart57(4) não dispensa formalidades nestas alíneas c/d.`};
}
+51
View File
@@ -0,0 +1,51 @@
import {baggageTreatments,isReturneeBaggage,evaluateBaggage} from './iva-returnee-baggage.ts';
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const returneeSource='P058 — CIVA12(2)a:IVA proporcional à redução de direitos;Decreto37/2023,art63(3)–(5),PDF11/p1475;art28,PDF5/p1469. Decreto27/2026,BR123-I,1.ºsuplemento01/07,PDF1–3/p1012(1–3):altera14/58 eQuadrosV/VI,não63. Veículos no regresso;sem extensão das condições dos mineirosP059.';
export const returneeTreatments=[{id:'owned',label:'Veículo próprio há mais de 180 dias — isenção',article:'63(3)a,primeira parte',remaining:0},{id:'recent',label:'Veículo próprio há menos de 180 dias — redução de 80%',article:'63(3)a,segunda parte',remaining:20},{id:'separate',label:'Substituição por veículo separado da bagagem — redução de 50%',article:'63(3)b/e',remaining:50},...baggageTreatments] as const;
export const returneeConditions=[['national','Cidadão nacional maior de 18 anos'],['definitive','Regresso definitivo ao País'],['single','Um único veículo abrangido;outros veículos pagam a totalidade'],['ownership','Documentos disponíveis comprovam titularidade e residência no país de procedência'],['use','Uso exclusivo pelo beneficiário ou cônjuge e fim declarado;art28'],['undertaking','Declaração em modelo próprio de não alteração de uso,art28(3),identificada ou prevista'],['history','Histórico identificado inclui benefícios fora deste dossier']] as const;
type Choice=''|'yes'|'no';
export type ReturneeRow={baggageKind?:''|'personal'|'household';baggageRoute?:''|'accompanied'|'unaccompanied';missionRef?:string;missionPlannedEnd?:string;earlyReturnRef?:string;earlyBaggageRef?:string;id:string;treatment:string;description:string;beneficiary:string;period:string;currency:string;origin:'projected'|'effective';scope:string;evidence:string;documentRef:string;arrival:string;request:string;stayStart:string;stayEnd:string;ownedSince:string;ownershipAssessment?:string;importDate:string;previous:''|'none'|'known';previousDate:string;historyRef:string;extensionRef:string;exceptionRef:string;decisionRef:string;normalVat:string;normalVatRef:string;conditions:Partial<Record<typeof returneeConditions[number][0]|'extension'|'exception'|'substitution'|'mission'|'reasonable'|'nonCommercial'|'baggageGoods'|'earlyService'|'advanceClearance',Choice>>};
export type Line={id:string;status:'exempt'|'reduced'|'not_applicable'|'indeterminate';importVat:string|null;deduction:null;reason:string;source:string};
type Result={revision:number;calculatedAt:string;sourceKey:string;inputs:ReturneeRow[];rows:Line[]};
export type ReturneeBook={rows:ReturneeRow[];result?:Result;history?:Result[]};
export function newReturnee(id:string,currency:string):ReturneeRow{return{id,currency,treatment:'',description:'',beneficiary:'',period:'',origin:'projected',scope:'',evidence:'',documentRef:'',arrival:'',request:'',stayStart:'',stayEnd:'',ownedSince:'',importDate:'',previous:'',previousDate:'',historyRef:'',extensionRef:'',exceptionRef:'',decisionRef:'',normalVat:'',normalVatRef:'',conditions:{}};}
function store(draft:Record<string,unknown>){const s=readAcquisitionStore(draft.modelo_a_snapshot) as ReturnType<typeof readAcquisitionStore>&{returneeImports?:Record<string,ReturneeBook>};const fields=Object.keys(newReturnee('','')).filter(k=>k!=='conditions');if(s.returneeImports!==undefined&&(!s.returneeImports||typeof s.returneeImports!=='object'||Array.isArray(s.returneeImports)))throw Error('Rascunhos do regresso não recuperáveis;originais preservados.');for(const b of Object.values(s.returneeImports??{}))if(!b||!Array.isArray(b.rows)||(b.history!==undefined&&!Array.isArray(b.history))||b.rows.some(r=>!r||fields.some(k=>typeof r[k as keyof ReturneeRow]!=='string')||['baggageKind','baggageRoute','missionRef','missionPlannedEnd','earlyReturnRef','earlyBaggageRef'].some(k=>r[k as keyof ReturneeRow]!==undefined&&typeof r[k as keyof ReturneeRow]!=='string')||!r.conditions||typeof r.conditions!=='object'||Array.isArray(r.conditions)))throw Error('Linhas do regresso não recuperáveis;sem substituição por lista vazia.');return s;}
export function returneeBook(draft:Record<string,unknown>):ReturneeBook{return store(draft).returneeImports?.[acquisitionScope(draft)]??{rows:[]};}
export function saveReturneeBook(draft:Record<string,unknown>,book:ReturneeBook):string{const s=store(draft),value=JSON.stringify({...s,returneeImports:{...s.returneeImports,[acquisitionScope(draft)]:book}});store({...draft,modelo_a_snapshot:value});return value;}
function date(v:string):Date|null{const d=new Date(v+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(v)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===v?d:null;}
function years(v:string,n:number){const d=date(v)!;const month=d.getUTCMonth();d.setUTCFullYear(d.getUTCFullYear()+n);if(d.getUTCMonth()!==month)d.setUTCDate(0);return d.toISOString().slice(0,10);}
function days(a:string,b:string):number{return(date(b)!.getTime()-date(a)!.getTime())/86400000;}
export function evaluateReturnee(r:ReturneeRow,currency:unknown):Line{
if(isReturneeBaggage(r.treatment))return evaluateBaggage(r,currency);
const rule=returneeTreatments.find(t=>t.id===r.treatment),base:Line={id:r.id,status:'indeterminate',importVat:null,deduction:null,reason:'',source:returneeSource+(rule?';'+rule.article:'')};const stop=(reason:string,status:Line['status']='indeterminate')=>({...base,status,reason});
if(!rule)return stop('Escolha percurso de veículo documentado;bagagem e outros bens permanecem por enquadrar separadamente.');
if(currency!=='MZN'||r.currency!==currency||!/^2026-(0[1-9]|1[0-2])$/.test(r.period)||!date(r.importDate)||r.importDate.slice(0,7)!==r.period)return stop('Indique importação2026 emMZN,com data/período coerentes;sem conversão presumida.');
if(!['projected','effective'].includes(r.origin)||![r.description,r.beneficiary,r.scope,r.evidence,r.documentRef,r.historyRef].every(v=>v.trim()))return stop('Identifique bens,beneficiário,documentos,âmbito,factos/pressupostos e histórico completo;sem exigir novo certificado.');
if(returneeConditions.some(([k])=>r.conditions[k]==='no'))return stop('Condição deste percurso não satisfeita;outros regimes não são excluídos.','not_applicable');
if(returneeConditions.some(([k])=>r.conditions[k]!=='yes'))return stop('Condições por esclarecer;desconhecido não equivale a isenção.');
if(![r.arrival,r.request,r.stayStart,r.stayEnd].every(v=>date(v))||r.stayEnd<r.stayStart||r.stayEnd>r.arrival||r.request<r.arrival||r.importDate<r.arrival)return stop('Indique estadia,chegada,requerimento e importação coerentes.');
if(r.stayEnd<=years(r.stayStart,1)&&!(r.treatment==='separate'&&r.conditions.exception==='yes'&&r.exceptionRef.trim()))return stop('Exigida estadia superior a um ano;excepção63(3)e apenas no separado,com autorização do Ministro das Finanças e âmbito ou pressuposto expresso.');
const elapsed=days(r.arrival,r.request);if(elapsed>60&&!(elapsed<=90&&r.conditions.extension==='yes'&&r.extensionRef.trim()))return stop('Pedido além de60dias:prorrogação excepcional pelo Director-Geral das Alfândegas até30dias deve estar identificada;sem extensão automática.');
if(!['none','known'].includes(r.previous))return stop('Identifique existência ou ausência de benefício anterior pelo histórico,sem inferir do dossier vazio.');
if(r.previous==='known'&&(!date(r.previousDate)||r.importDate<years(r.previousDate,5)))return stop('Não demonstrado intervalo de cinco anos desde a numeração do despacho do benefício anterior.');
if(r.treatment==='separate'){
if(r.conditions.substitution!=='yes'||!r.decisionRef.trim())return stop('Tratamento excepcional de substituição63(3)b deve ter referência e âmbito ou pressuposto expresso;pedido não equivale a concessão.');
}else{
if(!date(r.ownedSince)||!date(r.ownershipAssessment??'')||r.ownedSince>r.ownershipAssessment!||r.ownershipAssessment!>r.arrival)return stop('Indique início da propriedade e data à qual o documento confere a sua duração no país de procedência,coerentes com o regresso;sem escolher automaticamente o marco de contagem.');
const ownershipDays=days(r.ownedSince,r.ownershipAssessment!);if(ownershipDays===180)return stop('A fonte distingue mais/menos de180dias;exactamente180 não recebe benefício presumido.');
if((r.treatment==='owned'&&ownershipDays<180)||(r.treatment==='recent'&&ownershipDays>180))return stop('Tempo de propriedade não corresponde ao percurso seleccionado.','not_applicable');
}
const context=`${rule.article};${r.origin==='projected'?'cenário condicionado aos pressupostos expressos':'factos declarados no âmbito identificado'};não constitui concessão administrativa. Restrições de uso/alienação e eventual alteração de destino seguem art28;sem cálculo de direitos,ICE,dedução/campo11 ou IVA de aquisição interna.`;
if(rule.remaining===0)return{...base,status:'exempt',importVat:'0.00',reason:'Isenção integral no âmbito demonstrado do veículo.'+context};
if(!/^\d{1,15}(\.\d{1,6})?$/.test(r.normalVat)||!r.normalVatRef.trim())return stop('Indique IVA normal da importação e respectiva referência/pressuposto;sem presumir base ou taxa.');
const [w,f='']=r.normalVat.split('.');const amount=(BigInt(w)*1000000n+BigInt(f.padEnd(6,'0')))*BigInt(rule.remaining);const value=`${amount/100000000n}.${(amount%100000000n).toString().padStart(8,'0').replace(/0+$/,'').padEnd(2,'0')}`;
return{...base,status:'reduced',importVat:value,reason:`Redução${100-rule.remaining}% das imposições;IVA normal informado×${rule.remaining}%=${value}MZN,sem arredondamento fiscal presumido.Não é taxa deIVA.`+context};
}
function key(draft:Record<string,unknown>,b:ReturneeBook){return JSON.stringify({version:1,scope:acquisitionScope(draft),currency:draft.currency,location:draft.selection_labels??{},rows:b.rows});}
export function returneeCurrent(draft:Record<string,unknown>,b:ReturneeBook){return !!b.result&&b.result.sourceKey===key(draft,b);}
export function recordReturnees(draft:Record<string,unknown>,b:ReturneeBook):ReturneeBook{
if(!b.rows.length||new Set(b.rows.map(r=>r.id)).size!==b.rows.length)throw Error('Identifique linhas distintas;originais preservados.');
const rows=b.rows.map(r=>evaluateReturnee(r,draft.currency));for(let i=0;i<b.rows.length;i++){const r=b.rows[i];if(isReturneeBaggage(r.treatment))continue;if(!['exempt','reduced'].includes(rows[i].status))continue;if(b.rows.some((peer,j)=>j!==i&&!isReturneeBaggage(peer.treatment)&&peer.beneficiary===r.beneficiary&&peer.origin===r.origin&&date(peer.importDate)&&evaluateReturnee(peer,draft.currency).status!=='not_applicable'&&(peer.importDate<=r.importDate?r.importDate<years(peer.importDate,5):peer.importDate<years(r.importDate,5))))rows[i]={...rows[i],status:'indeterminate',importVat:null,reason:'Mais de uma linha usa o mesmo direito de veículo em cinco anos;conferir o conjunto e histórico externo,sem dupla utilização.'};}
const result:Result={revision:(b.result?.revision??0)+1,calculatedAt:new Date().toISOString(),sourceKey:key(draft,b),inputs:structuredClone(b.rows),rows};const next={...b,result,history:[...(b.history??[]),...(b.result?[b.result]:[])]};saveReturneeBook(draft,next);return next;
}
export function returneeReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=returneeBook(draft),result=b.result;if(!result)return[];return result.inputs.map((r,i)=>['IVA mensal',`P058 — ${r.period} — ${r.id}`,`${r.description};${result.rows[i].reason};IVA:${result.rows[i].importVat??'Indeterminado'};dedução:Não apurada`,`${result.rows[i].source};${returneeCurrent(draft,b)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${r.documentRef};${r.scope};${r.evidence};${r.historyRef};${r.extensionRef};${r.exceptionRef};${r.decisionRef};${r.normalVatRef};${isReturneeBaggage(r.treatment)?`missão:${r.missionRef};tipo:${r.baggageKind};via:${r.baggageRoute};estadia:${r.stayStart} a ${r.stayEnd};chegada:${r.arrival};entrada:${r.importDate};termo previsto:${r.missionPlannedEnd??''};regresso antecipado:${r.earlyReturnRef??''};entrada antecipada:${r.earlyBaggageRef??''}`:''}`]);}catch(e){return[['IVA mensal','P058 — recuperação',String(e),'Originais preservados']];}}
+84
View File
@@ -0,0 +1,84 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const secondhandVersion='secondhand-individual-margin/1';
export const secondhandSource='CIVA3(3)g/3(6),15(2)f/g,Lei13/2016PDF7/13;Lei22/2022PDF3mantém15f/g efixa17(1)16%;Lei10/2025não altera15/17,revoga regimes35/42. RIVADecreto7/2008arts47–49,BR16-I16/04/2008PDF8–9/p106–107:revenda porbem,margem positiva dividida por1.16 ebase arredondada à unidade;sem compensar perdas entrebens. Leilão:facturado−líquidocomitente−IVApróprio identificado,líquido=adjudicação−comissão. ClassificaçãoP125 separada da baseP092/P093. Sem nova dedução/campo11,isenção automática,IVA calculado ou totaisModeloA.';
export const secondhandTreatments=[{id:'reseller_margin',branch:'P092',label:'Revendedor — margem individual'},{id:'auction_margin',branch:'P093',label:'Organizador emnome próprio — venda em leilão'}] as const;
export const secondhandCategories=[{id:'used_goods',label:'Bem móvel usado3(6)a'},{id:'art',label:'Objecto de arte3(6)b'},{id:'collection',label:'Objecto de colecção3(6)c'},{id:'antique',label:'Antiguidade3(6)d'}] as const;
export const secondhandConditions=[['goodsIdentity','Bem individual identificado,com aquisição,transmissão e referências correspondentes'],['operatorRole','Sujeito passivo revendedor ou organizador de leilão identificado,no exercício da actividade epercurso escolhido']] as const;
export const categoryConditions={
used_goods:[['reusableUsed','Bem móvel usado susceptível de reutilização no estado ou após reparação'],['notRenewedTransformed','Não é renovado nem transformado:renovado se materiais de reparação excedem aquisição+mão-de-obra;transformado se reparação modifica características essenciais'],['notPreciousExcluded','Não são pedras/metais preciosos excluídos3(6)a;moedas/artefactos desses materiais não são excluídos só por esse motivo']],
art:[['artistOriginal','Obra da autoria do artista,no âmbito3(6)b;sem desenho industrial,ourivesaria ou joalharia']],
collection:[['collectionNature','Objecto de colecção no âmbito3(6)c,com natureza e características identificadas']],
antique:[['notArtCollection','Não é objecto de arte ou de colecção já classificado nessas categorias']],
} as const;
export function secondhandCategoryConditions(category:string):ReadonlyArray<readonly[string,string]>{return categoryConditions[category as keyof typeof categoryConditions]??[];}
type Choice=''|'yes'|'no';type Condition=typeof secondhandConditions[number][0];
export type SecondhandRow={id:string;treatment:string;category:string;description:string;period:string;origin:'projected'|'effective';currency:string;operationDate:string;operationRef:string;documentRef:string;documentDate:string;goodsRef:string;operatorRef:string;categoryRef:string;artSubtype:string;editionCount:string;ceramicUniqueSigned:string;collectionSubtype:string;postalNotCirculating:string;ageYears:string;sourceType:string;sourceRef:string;domesticPurchase:string;regimeChoice:string;domesticTaxable:string;grossSale:string;purchasePrice:string;purchaseRef:string;grossInvoice:string;hammerPrice:string;principalCommission:string;auctionRef:string;principalRef:string;ownVat:string;ownVatRef:string;scope:string;evidence:string;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';classification:'qualified_goods'|'not_applicable'|'indeterminate';baseAmount:string|null;grossMargin:string|null;principalNet:string|null;baseDivisorRate:string|null;vat:null;rate:null;reason:string};
export type SecondhandCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:SecondhandRow[];rows:LineResult[]};
export type SecondhandBook={rows:SecondhandRow[];result?:SecondhandCalculation;history?:SecondhandCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{regulatedSecondhands?:Record<string,SecondhandBook>};
export function newSecondhand(id:string,currency:string):SecondhandRow{return{id,treatment:'',category:'',description:'',period:'',origin:'projected',currency,operationDate:'',operationRef:'',documentRef:'',documentDate:'',goodsRef:'',operatorRef:'',categoryRef:'',artSubtype:'',editionCount:'',ceramicUniqueSigned:'',collectionSubtype:'',postalNotCirculating:'',ageYears:'',sourceType:'',sourceRef:'',domesticPurchase:'',regimeChoice:'',domesticTaxable:'',grossSale:'',purchasePrice:'',purchaseRef:'',grossInvoice:'',hammerPrice:'',principalCommission:'',auctionRef:'',principalRef:'',ownVat:'',ownVatRef:'',scope:'',evidence:'',conditions:{}};}
export function switchSecondhandTreatment(row:SecondhandRow,treatment:string):SecondhandRow{return{...row,treatment,conditions:{...row.conditions,regimeConfirmed:'',compositionConfirmed:''}};}
export function switchSecondhandCategory(row:SecondhandRow,category:string):SecondhandRow{return{...row,category,conditions:Object.fromEntries(secondhandConditions.map(([key])=>[key,row.conditions[key]??'']))};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.regulatedSecondhands!==undefined&&(!store.regulatedSecondhands||typeof store.regulatedSecondhands!=='object'||Array.isArray(store.regulatedSecondhands)))throw new Error('Afectações de bens não recuperáveis;originais preservados.');
const fields=Object.keys(newSecondhand('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.regulatedSecondhands??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof SecondhandRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de afectações de bens não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function secondhandBook(draft:Record<string,unknown>):SecondhandBook{return readStore(draft).regulatedSecondhands?.[acquisitionScope(draft)]??{rows:[]};}
export function saveSecondhandBook(draft:Record<string,unknown>,book:SecondhandBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,regulatedSecondhands:{...current.regulatedSecondhands,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateSecondhand(row:SecondhandRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',classification:'indeterminate',baseAmount:null,grossMargin:null,principalNet:null,baseDivisorRate:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
if(!secondhandTreatments.some(t=>t.id===row.treatment)||!secondhandCategories.some(c=>c.id===row.category))return stop('Identifique revendedor/leilão e categoria do bem;sem regime ou base por defeito.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||!validDate(row.operationDate)||row.operationDate.slice(0,7)!==row.period)return stop('Identifique mês2026,data correspondente e natureza efectiva/projectada dos dados.');
const required=[...secondhandConditions,...secondhandCategoryConditions(row.category)];if(required.some(([k])=>row.conditions[k]==='no'))return{...stop('Definição/estatuto deste percurso não correspondem aos factos;rever classificação3(6),sem basezero ou isenção presumida.','not_applicable'),classification:'not_applicable'};
if(required.some(([k])=>row.conditions[k]!=='yes'))return stop('Natureza do bem ou estatuto do operador por esclarecer;desconhecido não é zero.');
if(![row.description,row.operationRef,row.documentRef,row.goodsRef,row.operatorRef,row.categoryRef,row.scope,row.evidence].every(v=>!!v.trim())||!validDate(row.documentDate))return stop('Identifique bem individual,operador,categoria,operação,documento/data,âmbito e factos ou pressupostos expressos;sem certificado/aprovador novo.');
if(row.category==='art'){
if(!['original','print','sculpture','ceramic'].includes(row.artSubtype))return stop('Identifique pintura/desenho original,gravura/estampa/litografia,escultura/estatuária ou cerâmica.');
if(row.artSubtype==='print'&&(!/^\d+$/.test(row.editionCount)||BigInt(row.editionCount)<1n))return stop('Identifique tiragem da gravura/estampa/litografia.');
if(row.artSubtype==='print'&&BigInt(row.editionCount)>200n)return{...stop('Tiragem superior a200 não corresponde a esta definição de arte3(6)b.','not_applicable'),classification:'not_applicable'};
if(row.artSubtype==='ceramic'&&row.ceramicUniqueSigned!=='yes')return stop('Esclareça se a cerâmica é exemplar único executado eassinado pelo artista3(6)b.');
}
if(row.category==='collection'&&(!['postal','scientific','historical'].includes(row.collectionSubtype)||(row.collectionSubtype==='postal'&&row.postalNotCirculating!=='yes')))return stop('Identifique colecção postal não emcirculação/nem destinada acircular,colecções/espécimes científicos ou interesse histórico/arqueológico/paleontológico/etnográfico/numismático3(6)c.');
if(row.category==='antique'){
const age=decimal(row.ageYears);if(age===null)return stop('Identifique idade emanos do bem.');if(age<=100000000n)return{...stop('A definição de antiguidade3(6)d exige mais de100anos.','not_applicable'),classification:'not_applicable'};
}
result.classification='qualified_goods';
if(row.domesticPurchase!=='yes'||!row.sourceRef.trim())return stop('P125identificado;P092/P093 por esclarecer:origem nacional equalidade do fornecedor/comitente comreferência48(1)/49(1).');
if(row.sourceType==='legacy_35_42')return stop('P125identificado;referência histórica aos regimes35/42 não activa margem em2026:Lei10/2025revogou essas subsecções. Conferir situação aplicável sem reactivar regime revogado.');
if(!['private','margin_reseller','exempt_9_12_e'].includes(row.sourceType))return stop('P125identificado;origem elegível particular,revendedor na margem ou transmissão9(12)e não demonstrada. Outro regime permanece por esclarecer.');
if(row.treatment==='reseller_margin'&&row.regimeChoice==='general')return stop('P125identificado;opção pelo regime geral47(1)não aplica esta fórmula de margem.','not_applicable');
if(row.treatment==='reseller_margin'&&row.regimeChoice!=='margin')return stop('P125identificado;esclareça opção margem/regime geral do revendedor47(1).');
if(row.domesticTaxable!=='yes'||row.conditions.regimeConfirmed!=='yes'||row.conditions.compositionConfirmed!=='yes')return stop('P125identificado;base por esclarecer:transmissão interna tributável,natureza/regime elegível ecomposição confirmados;exportação13/48(7)tem percurso próprio.');
if(currency!=='MZN'||row.currency!==currency)return stop('P125identificado;base fora do recorteMZN ou moeda divergente,sem conversão silenciosa.');
if(row.treatment==='reseller_margin'){
const sale=decimal(row.grossSale),purchase=decimal(row.purchasePrice);if(sale===null||purchase===null||!row.purchaseRef.trim())return stop('Identifique contraprestação total devida pelocliente comIVA incluído epreço compra justificado do mesmo bem;desconhecido não é zero.');
const diff=sale-purchase,positive=diff>0n?diff:0n,denominator=116000000n;const whole=(positive*100n+denominator/2n)/denominator;
return{...result,status:'determined',baseAmount:money(whole*1000000n),grossMargin:diff<0n?'-'+money(-diff):money(diff),baseDivisorRate:'16%',reason:`P092:48(2)/(3)/(6),margem individual=${money(sale)}−${money(purchase)}=${diff<0n?'-'+money(-diff):money(diff)}MZN;parcela positiva÷1.16,base arredondada à unidade=${money(whole*1000000n)}MZN. ${diff<0n?'Excesso do preço compra registado neste bem,sem compensar outras transmissões;sem margem positiva tributável.':''} Taxa16% utilizada só no divisor da base17(1)/48(6)b;não há IVA ou dedução calculados. Factura com menção IVA-Bens emSegundaMão,sem discriminarIVA48(8)/(9);registos separados48(10)/(11).`};
}
const invoice=decimal(row.grossInvoice),hammer=decimal(row.hammerPrice),commission=decimal(row.principalCommission),tax=decimal(row.ownVat);
if(invoice===null||hammer===null||commission===null||tax===null||![row.auctionRef,row.principalRef,row.ownVatRef].every(v=>!!v.trim()))return stop('Identifique montante facturado,adjudicação,comissão do comitente eIVApróprio relativo à transmissão,comreferências;IVA desconhecido não é zero.');
if(commission>hammer)return stop('Comissão excede adjudicação;conferir componentes antes de determinar líquido comitente49(3).');
const net=hammer-commission;if(invoice<net+tax)return stop('Facturado inferior ao líquido comitente+IVAindicado;conferir composição,sem base negativa ou zero substituto.');
return{...result,status:'determined',baseAmount:money(invoice-net-tax),principalNet:money(net),reason:`P093:15(2)g/49(2)/(3),líquido comitente=${money(hammer)}−${money(commission)}=${money(net)}MZN;base=${money(invoice)}facturado−${money(net)}líquido−${money(tax)}IVApróprio identificado=${money(invoice-net-tax)}MZN. IVAindicado é componente referenciada,não calculada aqui. Factura IVA-Regime específico devendas emleilão,sem discriminarIVA49(5);relatório ao comitente em5dias úteis49(6)/(7),sem calendário de feriados presumido;contas deterceiros49(8). Sem nova dedução/campo11 ou totaisModeloA.`};
}
function key(draft:Record<string,unknown>,book:SecondhandBook):string{return JSON.stringify({version:secondhandVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function secondhandCurrent(draft:Record<string,unknown>,book:SecondhandBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordSecondhands(draft:Record<string,unknown>,book:SecondhandBook):SecondhandBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:SecondhandCalculation={version:secondhandVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:secondhandSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateSecondhand(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveSecondhandBook(draft,next);return next;
}
export function secondhandReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=secondhandBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,i)=>{const line=result.rows[i],rule=secondhandTreatments.find(t=>t.id===row.treatment);return['IVA mensal',`Bem P125/base${rule?.branch??'margem'} — ${row.period} — ${row.id}`,`${row.description};P125:${line.classification==='qualified_goods'?'Categoria/estatuto identificados':line.classification==='not_applicable'?'Percurso não aplicável':'Indeterminado'};base:${line.baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${line.reason}`,`${result.opportunity};${result.location};${secondhandCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${rule?.label};categoria ${row.category},${row.categoryRef};critérios ${row.category==='art'?`${row.artSubtype},tiragem ${row.editionCount},cerâmica única/assinada ${row.ceramicUniqueSigned}`:row.category==='collection'?`${row.collectionSubtype},postal fora de circulação ${row.postalNotCirculating}`:row.category==='antique'?`idade ${row.ageYears} anos`:JSON.stringify(row.conditions)};bem ${row.goodsRef};operador ${row.operatorRef};origem ${row.sourceType},${row.sourceRef};operação ${row.operationRef},${row.operationDate};documento ${row.documentRef},${row.documentDate};${row.treatment==='reseller_margin'?`venda comIVA ${row.grossSale};compra ${row.purchasePrice},${row.purchaseRef};margem ${line.grossMargin??'indeterminada'};divisor ${line.baseDivisorRate??'indeterminado'}`:`facturado ${row.grossInvoice};adjudicação ${row.hammerPrice};comissão comitente ${row.principalCommission};líquido ${line.principalNet??'indeterminado'},${row.principalRef};IVAcomponente ${row.ownVat},${row.ownVatRef};leilão ${row.auctionRef}`};âmbito ${row.scope};fundamento ${row.evidence};sem nova dedução/campo11/totaisModeloA.`];});}
catch{return[['IVA mensal','Bens usados/margem','Dados não recuperáveis','Originais preservados;sem base por defeito.']];}
}
+66
View File
@@ -0,0 +1,66 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const serviceLocationVersion='service-territoriality/1';
export const serviceLocationSource='CIVA6(3),6(4)/(5)(a–d),6(6),Lei13/2016PDF7–8/p1426(265–266);AvisoBR89-I,08/06/2017,PDF1 rectifica6(5)c/d:actividades materialmente nacionais e transporte pela distância nacional;Lei10/2025PDF12mantém6(3–6),altera7–9digitais. Recorte2026:regra geral sem regras especiais aplicáveis;imóveis,trabalhos/peritagens em móveis e actividades presenciais pelos factos próprios. Sem taxa/IVA/isenção/dedução/campo11/totaisModeloA;digital e outros6(7)/(8)não classificados por estes percursos.';
export const serviceLocationTreatments=[{id:'general_service',label:'P106 — Regra geral dos serviços',branch:'P106'},{id:'immovable_service',label:'P107 — Serviços relacionados com imóveis',branch:'P107'},{id:'movable_work',label:'P108 — Trabalhos/peritagens em bens móveis',branch:'P108'},{id:'activity_service',label:'P109 — Actividades presenciais e serviços acessórios',branch:'P109'},{id:'transport_service',label:'P110 — Transporte por distância e percurso',branch:'P110'}] as const;
export const serviceLocationConditions=[['serviceSupply','Está identificada uma prestação de serviços e a operação/período correspondentes'],['otherSpecialRulesExcluded','Foi conferida a natureza da operação: não está abrangida neste caso por regime digital ou regras6(7)/(8)que exijam outro percurso']] as const;
export const serviceOwnConditions={
general_service:[['noPlaceException','Não se aplica nenhuma excepção de localização6(4)/(5):imóveis,trabalhos/peritagens em móveis,actividades materiais ou transporte'],['providerEstablishment','Identificada a sede,estabelecimento estável ou domicílio do prestador a partir do qual este serviço é prestado']],
immovable_service:[['propertyRelation','O serviço relaciona-se com o imóvel identificado,incluindo preparação/coordenação de trabalhos imobiliários,peritos ou agentes imobiliários']],
movable_work:[['corporealMovable','São trabalhos em bens móveis corpóreos ou peritagens a eles referentes'],['totalEssential','O local indicado corresponde à execução total ou essencial dos trabalhos/peritagens']],
activity_service:[['activityNature','Serviço artístico,científico,desportivo,recreativo,de ensino ou similar,incluindo organizadores e serviços acessórios dessa actividade'],['materialActivity','A actividade ou serviço acessório tem materialmente lugar no local indicado']],
transport_service:[['transportNature','Prestação de transporte com percurso e distâncias identificados'],['routeCorresponds','Distâncias e pontos de partida/chegada correspondem a este trajecto;ida e volta são trajectos distintos6(6)']],
} as const;
export function ownServiceConditions(treatment:string):ReadonlyArray<readonly[string,string]>{return serviceOwnConditions[treatment as keyof typeof serviceOwnConditions]??[];}
type Choice=''|'yes'|'no';type Condition=typeof serviceLocationConditions[number][0];
export type ServiceLocationRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';operationDate:string;operationRef:string;documentRef:string;documentDate:string;servicePlace:string;placeCountry:string;placeRef:string;totalDistance:string;nationalDistance:string;departure:string;arrival:string;routeRef:string;providerRef:string;providerPlace:string;providerCountry:string;subjectRef:string;scope:string;evidence:string;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';territory:'national'|'outside'|'partial'|null;baseAmount:null;vat:null;rate:null;reason:string};
export type ServiceLocationCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:ServiceLocationRow[];rows:LineResult[]};
export type ServiceLocationBook={rows:ServiceLocationRow[];result?:ServiceLocationCalculation;history?:ServiceLocationCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{serviceLocations?:Record<string,ServiceLocationBook>};
export function newServiceLocation(id:string):ServiceLocationRow{return{id,treatment:'',description:'',period:'',origin:'projected',operationDate:'',operationRef:'',documentRef:'',documentDate:'',servicePlace:'',placeCountry:'',placeRef:'',totalDistance:'',nationalDistance:'',departure:'',arrival:'',routeRef:'',providerRef:'',providerPlace:'',providerCountry:'',subjectRef:'',scope:'',evidence:'',conditions:{}};}
export function switchServiceTreatment(row:ServiceLocationRow,treatment:string):ServiceLocationRow{return{...row,treatment,conditions:Object.fromEntries(serviceLocationConditions.map(([key])=>[key,row.conditions[key]??'']))};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.serviceLocations!==undefined&&(!store.serviceLocations||typeof store.serviceLocations!=='object'||Array.isArray(store.serviceLocations)))throw new Error('Localizações de serviços não recuperáveis;originais preservados.');
const fields=Object.keys(newServiceLocation('')).filter(key=>key!=='conditions');
for(const book of Object.values(store.serviceLocations??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof ServiceLocationRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de localização de serviços não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function serviceLocationBook(draft:Record<string,unknown>):ServiceLocationBook{return readStore(draft).serviceLocations?.[acquisitionScope(draft)]??{rows:[]};}
export function saveServiceLocationBook(draft:Record<string,unknown>,book:ServiceLocationBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,serviceLocations:{...current.serviceLocations,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateServiceLocation(row:ServiceLocationRow):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',territory:null,baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
const rule=serviceLocationTreatments.find(t=>t.id===row.treatment);if(!rule)return stop('Identifique o percurso do serviço;desconhecido não determina território.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||!validDate(row.operationDate)||row.operationDate.slice(0,7)!==row.period)return stop('Identifique mês2026,data correspondente e natureza efectiva/projectada dos dados.');
const conditions=[...serviceLocationConditions,...ownServiceConditions(row.treatment)];
if(conditions.some(([key])=>row.conditions[key]==='no'))return stop('Este percurso não se aplica aos factos declarados;rever a regra própria,sem presumir fora do território,isenção ou IVAzero.','not_applicable');
if(conditions.some(([key])=>row.conditions[key]!=='yes'))return stop('Factos ou regra própria por esclarecer;localização indeterminada,não isenção ou IVAzero.');
if(!row.description.trim()||!row.operationRef.trim()||!row.documentRef.trim()||!validDate(row.documentDate)||!row.scope.trim()||!row.evidence.trim())return stop('Identifique serviço/operação,documento/data,âmbito e fundamento factual ou pressupostos expressos;reutilize dados sem certificado/aprovador novo.');
if(row.treatment==='transport_service'){
const parse=(v:string):bigint|null=>/^\d{1,18}(\.\d{1,6})?$/.test(v)?BigInt(v.split('.')[0])*1000000n+BigInt((v.split('.')[1]??'').padEnd(6,'0')):null;
const total=parse(row.totalDistance),national=parse(row.nationalDistance);
if(total===null||total===0n||national===null||national>total||!['MZ','foreign'].includes(row.departure)||!['MZ','foreign'].includes(row.arrival)||!row.routeRef.trim())return stop('Identifique percurso,pontos de partida/chegada e distâncias na mesma unidade,total positiva e nacional entre zero e total;desconhecido não é zero.');
const deemed=row.departure==='MZ'&&row.arrival==='MZ';const covered=deemed?total:national;const territory=covered===0n?'outside':covered===total?'national':'partial';
return{...result,status:'determined',territory,reason:`P110:artigo6(4)d/6(5)d rectificado pelo AvisoBR89-I,08/06/2017,PDF1,e6(6). ${deemed?'Partida e chegada no território nacional:inclui o percurso efectuado fora dos mesmos.':`Parcela nacional:distância ${row.nationalDistance} de ${row.totalDistance},na mesma unidade,sem arredondamento ou apuramento monetário.`} Ida e volta são trajectos distintos:recolher uma linha por trajecto. ${row.origin==='projected'?'Pressupostos expressos.':'Dados efectivos declarados.'} Fora do território não equivale a isenção/IVAzero;sem base,taxa,IVA,dedução/campo11 ou totaisModeloA.`};
}
const general=row.treatment==='general_service';const country=general?row.providerCountry:row.placeCountry;
if(!['MZ','foreign'].includes(country)||!(general?row.providerPlace:row.servicePlace).trim()||!(general?row.providerRef:row.placeRef).trim()||(!general&&!row.subjectRef.trim()))return stop(general?'Identifique sede/EP/domicílio do prestador a partir do qual o serviço é prestado,país e referência;endereço do cliente não substitui esse estabelecimento.':'Identifique local,país,referência e imóvel/bens/actividade a que respeita;endereço do cliente ou sede do prestador não substituem esses factos.');
const territory=country==='MZ'?'national':'outside';const clause=general?'6(3)':`6(${territory==='national'?'5':'4'})(${row.treatment==='immovable_service'?'a':row.treatment==='movable_work'?'b':'c'})`;
const fact=general?'estabelecimento do prestador a partir do qual o serviço é prestado':row.treatment==='immovable_service'?'local do imóvel':row.treatment==='movable_work'?'local de execução total ou essencial dos trabalhos/peritagens':'local material da actividade ou serviço acessório';
return{...result,status:'determined',territory,reason:`${rule.branch}:artigo${clause},${fact} ${territory==='national'?'emMoçambique':'fora deMoçambique'},${row.origin==='projected'?'sob pressupostos expressos':'segundo dados efectivos declarados'}. ${general?'Regras especiais conferidas como não aplicáveis.':'Regra territorial própria,independente da sede nacional ou estrangeira do prestador.'} Fora deste âmbito não equivale a isenção/IVAzero;não calcula base,taxa,IVA,dedução/campo11 ou totaisModeloA.`};
}
function key(draft:Record<string,unknown>,book:ServiceLocationBook):string{return JSON.stringify({version:serviceLocationVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},rows:book.rows});}
export function serviceLocationCurrent(draft:Record<string,unknown>,book:ServiceLocationBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordServiceLocations(draft:Record<string,unknown>,book:ServiceLocationBook):ServiceLocationBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:ServiceLocationCalculation={version:serviceLocationVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:serviceLocationSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateServiceLocation(row))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveServiceLocationBook(draft,next);return next;
}
export function serviceLocationReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=serviceLocationBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Localização ${serviceLocationTreatments.find(t=>t.id===row.treatment)?.branch??'serviço'} — ${row.period} — ${row.id}`,`${row.description};classificação territorial: ${result.rows[index].territory==='national'?'Moçambique':result.rows[index].territory==='outside'?'Fora do território nacional':result.rows[index].territory==='partial'?'Parcela nacional do transporte':'Indeterminada'};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${serviceLocationCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${serviceLocationTreatments.find(t=>t.id===row.treatment)?.label??'Percurso por indicar'};operação ${row.operationRef},${row.operationDate};${row.treatment==='transport_service'?`trajecto ${row.routeRef};partida ${row.departure};chegada ${row.arrival};distâncias nacional/total ${row.nationalDistance}/${row.totalDistance}`:row.treatment==='general_service'?`estabelecimento prestador ${row.providerPlace},${row.providerCountry};referência ${row.providerRef}`:`local ${row.servicePlace},${row.placeCountry};referência ${row.placeRef};imóvel/bens/actividade ${row.subjectRef}`};âmbito ${row.scope};documento ${row.documentRef},${row.documentDate};condições ${[...serviceLocationConditions,...ownServiceConditions(row.treatment)].map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};não determina isenção/IVA/campo11/totaisModeloA.`]);}
catch{return[['IVA mensal','Localização de serviços','Dados não recuperáveis','Originais preservados;sem classificar por defeito.']];}
}
+61
View File
@@ -0,0 +1,61 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const serviceNormalVersion='assimilated-service-normal/1';
export const serviceNormalSource='CIVA republicado Lei13/2016,15(2)(c),PDF13/p1426(271):operações4(2),base=valor normal do serviço definido15(4),PDF14/p1426(272).4(2)(a),PDF7/p1426(265):serviços gratuitos pela própria empresa para necessidades particulares do titular/pessoal ou fins alheios;4(2)(b):utilização de bens da empresa para uso próprio/titular/pessoal/fins alheios ou sectores isentos,quando houve dedução total/parcial nesses bens ou elementos constitutivos. A condição de dedução anterior é de4(2)(b),não de4(2)(a). Composição15(4)/(5)/(6),sem próprioIVA. Lei22/2022mantém15c/4por remissão,não altera4;Lei10/2025não altera4/15. Recorte2026/MZN;base apenas,sem calcularIVA/dedução/campo11/regularizações/totaisModeloA,nem confundir uso com transmissão permanenteP088.';
export const serviceNormalTreatments=[{id:'free_company_service',label:'Serviço gratuito pela própria empresa para necessidades particulares ou fins alheios'},{id:'private_company_asset_use',label:'Utilização de bens da empresa para uso próprio,particular ou fins alheios'},{id:'exempt_sector_asset_use',label:'Utilização de bens da empresa em sector de actividade isento'}] as const;
export const serviceNormalConditions=[
['domesticOperation','A operação e o âmbito territorial aplicável estão identificados para esta base'],
['normalValueBasis','O valor normal do serviço corresponde15(4):concorrência normal,fornecedor independente,estádio de comercialização,tempo/lugar da operação ou mais próximos,com fundamento e âmbito identificados'],
['netComposition','O montante exclui o próprio IVA e reflecte15(4)/(5)/(6),sem omissões ou dupla contagem'],
] as const;
export const serviceOwnConditions={
free_company_service:[['freeByCompany','A prestação é gratuita e efectuada pela própria empresa'],['nonBusinessPurpose','Destina-se a necessidades particulares do titular/pessoal ou,em geral,a fins alheios à empresa']],
private_company_asset_use:[['companyAssetUse','É utilização de bens da empresa,não afectação/transmissão permanente de bens'],['privatePurpose','Destina-se a uso próprio do titular/pessoal ou,em geral,a fins alheios à empresa'],['priorDeduction','Houve dedução total ou parcial relativamente aos bens ou aos elementos que os constituem']],
exempt_sector_asset_use:[['companyAssetUse','É utilização de bens da empresa,não afectação/transmissão permanente de bens'],['exemptSector','A utilização corresponde a sector de actividade isento identificado'],['priorDeduction','Houve dedução total ou parcial relativamente aos bens ou aos elementos que os constituem']],
} as const;
export function ownServiceConditions(treatment:string):ReadonlyArray<readonly[string,string]>{return serviceOwnConditions[treatment as keyof typeof serviceOwnConditions]??[];}
type Choice=''|'yes'|'no';type Condition=typeof serviceNormalConditions[number][0];
export type ServiceNormalRow={id:string;treatment:string;description:string;period:string;origin:'projected'|'effective';currency:string;operationRef:string;purposeRef:string;assetRef:string;deductionRef:string;documentRef:string;documentDate:string;normalValue:string;valuationRef:string;valuationScope:string;compositionRef:string;evidence:string;conditions:Partial<Record<string,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;reason:string};
export type ServiceNormalCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:ServiceNormalRow[];rows:LineResult[]};
export type ServiceNormalBook={rows:ServiceNormalRow[];result?:ServiceNormalCalculation;history?:ServiceNormalCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{serviceNormals?:Record<string,ServiceNormalBook>};
export function newServiceNormal(id:string,currency:string):ServiceNormalRow{return{id,treatment:'',description:'',period:'',origin:'projected',currency,operationRef:'',purposeRef:'',assetRef:'',deductionRef:'',documentRef:'',documentDate:'',normalValue:'',valuationRef:'',valuationScope:'',compositionRef:'',evidence:'',conditions:{}};}
export function switchServiceTreatment(row:ServiceNormalRow,treatment:string):ServiceNormalRow{return{...row,treatment,conditions:Object.fromEntries(serviceNormalConditions.map(([key])=>[key,row.conditions[key]??'']))};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.serviceNormals!==undefined&&(!store.serviceNormals||typeof store.serviceNormals!=='object'||Array.isArray(store.serviceNormals)))throw new Error('Bases de contraprestação não recuperáveis;originais preservados.');
const fields=Object.keys(newServiceNormal('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.serviceNormals??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof ServiceNormalRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de contraprestação não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function serviceNormalBook(draft:Record<string,unknown>):ServiceNormalBook{return readStore(draft).serviceNormals?.[acquisitionScope(draft)]??{rows:[]};}
export function saveServiceNormalBook(draft:Record<string,unknown>,book:ServiceNormalBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,serviceNormals:{...current.serviceNormals,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateServiceNormal(row:ServiceNormalRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,vat:null,rate:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
const rule=serviceNormalTreatments.find(t=>t.id===row.treatment);if(!rule)return stop('Identifique serviço gratuito,utilização particular/alheia ou em sector isento;desconhecido não permite presumir aplicação.');
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto;sem conversão silenciosa.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique mês em2026 e dados efectivos declarados ou pressupostos expressos de projecção.');
const required=[...serviceNormalConditions,...ownServiceConditions(row.treatment)];const failed=required.filter(([key])=>row.conditions[key]==='no');if(failed.length)return stop('Não se aplica esta base4(2)/15(2)(c): '+failed.map(([,label])=>label).join('; ')+'. Não é isenção nem IVA zero.','not_applicable');
if(required.some(([key])=>row.conditions[key]!=='yes'))return stop('Confirme as condições próprias deste percurso;desconhecido não é zero,não aplicável ou dedução presumida.');
if(!row.description.trim()||!row.operationRef.trim()||!row.purposeRef.trim()||!row.documentRef.trim()||!validDate(row.documentDate)||!row.valuationRef.trim()||!row.valuationScope.trim()||!row.compositionRef.trim()||!row.evidence.trim())return stop('Identifique serviço/operação,finalidade,documento/data,fundamento e âmbito do valor normal e composição,ou pressupostos expressos;reutilize dados existentes,sem certificado/avaliador/aprovador novo.');
if(row.treatment!=='free_company_service'&&(!row.assetRef.trim()||!row.deductionRef.trim()))return stop('Identifique os bens/elementos e a referência da dedução anterior total/parcial,ou pressupostos expressos;esta referência não calcula nem concede dedução/campo11.');
const normal=decimal(row.normalValue);if(normal===null)return stop('Indique o valor normal do serviço;desconhecido não é zero nem custo/preço de aquisição dos bens presumido.');
return{...result,status:'determined',baseAmount:money(normal),reason:`Base15(2)(c),${rule.label}:valor normal do serviço ${money(normal)}MZN,${row.origin==='projected'?'nas condições expressamente assumidas na projecção':'nos dados efectivos declarados'}. ${row.treatment==='free_company_service'?'4(2)(a),sem impor a condição de dedução anterior da alínea b).':'4(2)(b),bens/elementos e dedução anterior total/parcial referenciados;uso não é transmissão permanente.'} Valor normal com fundamento/âmbito,sem avaliação automática. Base não é imposto;IVA/taxa,dedução/campo11,regularizações e totaisModeloA não determinados por este cálculo.`};
}
function key(draft:Record<string,unknown>,book:ServiceNormalBook):string{return JSON.stringify({version:serviceNormalVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function serviceNormalCurrent(draft:Record<string,unknown>,book:ServiceNormalBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordServiceNormals(draft:Record<string,unknown>,book:ServiceNormalBook):ServiceNormalBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:ServiceNormalCalculation={version:serviceNormalVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:serviceNormalSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateServiceNormal(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveServiceNormalBook(draft,next);return next;
}
export function serviceNormalReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=serviceNormalBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base P089 — ${row.period} — ${row.id}`,`${row.description};base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${serviceNormalCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${serviceNormalTreatments.find(t=>t.id===row.treatment)?.label??'Percurso por indicar'};operação ${row.operationRef};finalidade ${row.purposeRef};${row.treatment==='free_company_service'?'Dedução anterior não é condição de4(2)(a)':`bens/elementos ${row.assetRef},dedução anterior ${row.deductionRef}`};valor normal ${row.normalValue} ${row.currency};fundamento ${row.valuationRef};âmbito ${row.valuationScope};composição ${row.compositionRef};documento ${row.documentRef},${row.documentDate};condições ${[...serviceNormalConditions,...ownServiceConditions(row.treatment)].map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento factual ${row.evidence};não preenche totaisModeloA ou campo11.`]);}
catch{return[['IVA mensal','Valor normal de serviços assimilados','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
+58
View File
@@ -0,0 +1,58 @@
import type { OperationTreatment } from './iva-operations.ts';
export const specialRegimeOptions = [
['economic_zone', 'Zona económica especial'],
['free_zone', 'Zona franca'],
['free_warehouse', 'Depósito franco'],
['general_free_warehouse', 'Depósito geral franco'],
['customs_warehouse', 'Depósito de regime aduaneiro'],
['duty_free_shop', 'Loja franca'],
['transit', 'Trânsito'],
['drawback', 'Draubaque'],
['temporary_import', 'Importação temporária'],
] as const;
export type SpecialRegime = '' | typeof specialRegimeOptions[number][0];
const zoneRegimes: readonly string[] = specialRegimeOptions.slice(0,6).map(([id])=>id);
const transitRegimes: readonly string[] = ['transit','drawback','temporary_import'];
const source = 'CIVA republicado Lei13/2016, BR156/10.º suplemento,14(1)(b/c/d) e condição inicial de14(1),PDF13/p.1426(271);19(1)(b)(iv),PDF15/p.1426(273). Lei22/2022art.1,PDF1, e Lei10/2025art.1,PDF12–13/p.2180(12)–(13),não alteram14 nem19(1)(b)(iv). Âmbito2026/MZN; não calcula importação14(1)(a), aquisição14(2), saída de regime, direitos aduaneiros ou dedução automática de compras.';
const make = (id:string,label:string,letter:string,conditions:string[]):OperationTreatment => ({id,label,field:'05',rate:0,article:`CIVA arts.14(1)(${letter}),19(1)(b)(iv)`,source,logicVersion:'special-regimes/1',conditions:[
'Transmissão de bens ou prestação de serviços abrangida pelo CIVA em Moçambique, com territorialidade identificada; não o próprio acto de importação nem aquisição pelo beneficiário',
'Os bens a que a operação se refere não têm utilização nem consumo finais nas áreas mencionadas em14(1); destino efectivo ou pressuposto expresso da projecção identificado, sem o presumir pela localização no mapa',
...conditions,
]});
export const specialRegimeTreatments:OperationTreatment[] = [
make('regime_dispatch_goods','Bens expedidos para zona ou depósito elegível','b',[
'Transmissão de bens expedidos ou transportados para zona ou depósito mencionado em14(1)(a); bens, destino e regime identificados no documento ou pressuposto expresso. A indicação de loja franca por si não comprova esse destino: identifique a zona ou depósito aplicável a esta expedição',
'A colocação/introdução dos bens corresponde ao regime escolhido, sob controlo alfandegário e disposições especificamente aplicáveis de14(1)(a); não basta o endereço do destinatário ou o cadastro da zona',
]),
make('regime_dispatch_transport','Transporte directamente conexo à expedição para zona ou depósito','b',[
'Prestação de serviço de transporte directamente conexa à transmissão de bens expedidos ou transportados para zona ou depósito de14(1)(a); transmissão, bens, destino e ligação concreta identificados. A indicação de loja franca por si não comprova esse destino: identifique a zona ou depósito aplicável a esta expedição',
'Regime de destino e disposições especificamente aplicáveis de14(1)(a) identificados; preço desta linha é apenas o transporte, sem duplicar o valor dos bens; não qualquer serviço ao destinatário',
]),
make('regime_internal_goods','Transmissão de bens dentro de regime de zona ou depósito','c',[
'Transmissão de bens efectuada num regime de14(1)(a),com bens, regime e controlo/disposições aplicáveis identificados no documento ou pressuposto expresso',
'Os bens permanecem nessa situação no momento/período da operação; não saída do regime nem venda para consumo final na área',
]),
make('regime_internal_services','Serviço directamente conexo à transmissão de bens em regime','c',[
'Prestação de serviços directamente conexa a transmissão de bens efectuada em regime de14(1)(a); bens, transmissão, regime e ligação concreta identificados, não qualquer serviço executado na zona',
'Os bens permanecem nessa situação no momento/período da operação; preço desta linha é apenas o serviço, sem duplicar o valor dos bens; não saída do regime nem consumo final',
]),
make('regime_transit_goods','Bens em trânsito, draubaque ou importação temporária','d',[
'Transmissão de bens que se encontram no regime escolhido de trânsito, draubaque ou importação temporária; bens e enquadramento identificados no documento ou pressuposto expresso, não o próprio acto de importação',
'A operação continua considerada abrangida pelo regime no momento/período indicado; não regime terminado nem mera passagem geográfica dos bens',
]),
make('regime_transit_transport','Transporte directamente conexo a bens em trânsito, draubaque ou importação temporária','d',[
'Prestação de serviço de transporte directamente conexa à transmissão de bens em trânsito, draubaque ou importação temporária; bens, operação e ligação concreta identificados',
'A operação continua abrangida pelo regime no momento/período indicado; preço desta linha é apenas o transporte, sem duplicar o valor dos bens; não transporte genérico nem regime terminado',
]),
];
export function isSpecialRegime(id:string):boolean { return specialRegimeTreatments.some(rule=>rule.id===id); }
export function specialRegimesFor(id:string):Array<typeof specialRegimeOptions[number]> {
const allowed=id.startsWith('regime_transit_')?transitRegimes:zoneRegimes;
return isSpecialRegime(id)?specialRegimeOptions.filter(([value])=>allowed.includes(value)):[];
}
export function specialRegimeIssue(id:string,regime:unknown):string|null {
if(!isSpecialRegime(id))return null;
if(!specialRegimesFor(id).some(([value])=>value===regime))return 'Identifique o regime aplicável a esta operação do artigo14(1). Regime desconhecido ou de outra alínea não comprova isenção; a localização não o substitui. Conserve preço, moeda e período; apuramento indeterminado.';
return null;
}
+56
View File
@@ -0,0 +1,56 @@
import {closureBook,closureSources,closureFingerprint,type ClosureSource,type ClosurePayment} from './iva-closure.ts';
import {addFractions,subtractFractions,positiveFraction,decimalFraction,fraction,fractionPresentation,type FiscalFraction} from './fiscal-rational.ts';
export const substitutionSource='L3-C: VAT Return.pdf SHA2569c0b99a8,p2/quadro9;RCIVA15,Decreto7/2008 PDF3/p101.21=(17actual−18actual)−(17anterior−18anterior);devedor→22;credor só utilizável em declaração posterior em prazo após comunicação20. Sem repetir19/20 ou pagamentos anteriores. Exemplar recebido assinala substituiçãoModeloA;RCIVA15 refereModeloB:correspondência de formulário/submissão não automatizada.';
export type PriorDeclaration={kind:'AB'|'C';id:string;period:string;entityRef:string;origin:'projected'|'effective';calculatedAt:string;declarationDate:string;declarationReference:string;fingerprint:string;debit:FiscalFraction;credit:FiscalFraction;paid:FiscalFraction;outstanding:FiscalFraction;carry:FiscalFraction;paymentRefs:string[]};
export type SubstitutionInput={id:string;prior:PriorDeclaration|null;source:ClosureSource|null;priorReference:string;priorDate:string;date:string;reference:string;reason:string;stage:'preparation'|'presented';interest:''|'none'|'documented';interestAmount:string;interestRef:string;payments:ClosurePayment[]};
export type SubstitutionResult={id:string;status:'determined'|'indeterminate';reason:string;inputKey:string;fields:Record<string,FiscalFraction|null>;pendingCredit:FiscalFraction|null;paid:FiscalFraction|null;outstanding:FiscalFraction|null;overpayment:FiscalFraction|null;totalPaid:FiscalFraction|null;totalOutstanding:FiscalFraction|null;source:string};
export type SubstitutionCalculation={calculatedAt:string;key:string;inputs:SubstitutionInput[];rows:SubstitutionResult[]};
export type SubstitutionBook={version:1;rows:SubstitutionInput[];result?:SubstitutionCalculation;history?:SubstitutionCalculation[]};
const zero=()=>fraction(0n),scope=(d:Record<string,unknown>)=>String(d.context_opportunity||'general'),norm=(s:string)=>s.trim().toLocaleLowerCase();
const date=(v:string)=>/^20\d{2}-(0[1-9]|1[0-2])-\d{2}$/.test(v)&&!Number.isNaN(Date.parse(v))&&new Date(v).toISOString().slice(0,10)===v;
function 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,SubstitutionBook>{const s=store(d).ivaSubstitutions;if(s===undefined)return{};if(!s||typeof s!=='object'||Array.isArray(s))throw Error('Substituições não recuperáveis;originais preservados.');return s as Record<string,SubstitutionBook>;}
function validate(b:SubstitutionBook):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('Livro de substituições não recuperável;sem o substituir.');for(const r of b.rows)if(!r||!['id','priorReference','priorDate','date','reference','reason','interestAmount','interestRef'].every(k=>typeof r[k as keyof SubstitutionInput]==='string')||!['preparation','presented'].includes(r.stage)||!['','none','documented'].includes(r.interest)||!Array.isArray(r.payments)||r.payments.some(p=>!p||!['id','reference','date','amount'].every(k=>typeof p[k as keyof ClosurePayment]==='string')))throw Error('Entradas da substituição não recuperáveis;originais preservados.');}
export function substitutionBook(d:Record<string,unknown>):SubstitutionBook{const b=maps(d)[scope(d)]??{version:1,rows:[]};validate(b);return b;}
export function saveSubstitutionBook(d:Record<string,unknown>,b:SubstitutionBook):string{validate(b);const s=store(d);return JSON.stringify({...s,ivaSubstitutions:{...maps(d),[scope(d)]:b}});}
export function newSubstitution(id:string):SubstitutionInput{return{id,prior:null,source:null,priorReference:'',priorDate:'',date:'',reference:'',reason:'',stage:'preparation',interest:'',interestAmount:'',interestRef:'',payments:[]};}
export function previousDeclarations(d:Record<string,unknown>,b=substitutionBook(d)):PriorDeclaration[]{
const ab=closureBook(d),out:PriorDeclaration[]=[];
for(const calc of [...(ab.history??[]),...(ab.result?[ab.result]:[])])for(const r of calc.rows){const input=calc.inputs.find(i=>i.id===r.id);if(r.status!=='determined'||!input||!r.fields['17']||!r.fields['18']||!r.fields['26']||!r.paid||!r.outstanding)continue;out.push({kind:'AB',id:r.id,period:r.period,entityRef:r.entityRef,origin:r.origin,calculatedAt:calc.calculatedAt,declarationDate:input.submissionDate,declarationReference:'',fingerprint:closureFingerprint([input,r]),debit:r.fields['17'],credit:r.fields['18'],paid:r.paid,outstanding:r.outstanding,carry:r.fields['26'],paymentRefs:input.payments.map(p=>p.reference)});}
for(const calc of [...(b.history??[]),...(b.result?[b.result]:[])])for(const r of calc.rows){const input=calc.inputs.find(i=>i.id===r.id);if(r.status!=='determined'||!input?.prior||!input.source||!r.totalPaid||!r.totalOutstanding)continue;out.push({kind:'C',id:r.id,period:input.prior.period,entityRef:input.prior.entityRef,origin:input.prior.origin,calculatedAt:calc.calculatedAt,declarationDate:input.date,declarationReference:input.reference,fingerprint:closureFingerprint([input,r]),debit:input.source.debit!,credit:input.source.credit!,paid:r.totalPaid,outstanding:r.totalOutstanding,carry:input.prior.carry,paymentRefs:[...input.prior.paymentRefs,...input.payments.map(p=>p.reference)]});}
return out.filter((r,i,a)=>a.findIndex(s=>s.kind===r.kind&&s.id===r.id&&s.fingerprint===r.fingerprint)===i);
}
function available(d:Record<string,unknown>,b:SubstitutionBook,r:SubstitutionInput){return[previousDeclarations(d,b).some(p=>JSON.stringify(p)===JSON.stringify(r.prior)),closureSources(d).some(s=>JSON.stringify(s)===JSON.stringify(r.source))];}
function pastPaymentUses(d:Record<string,unknown>,b:SubstitutionBook):Array<{id:string;entity:string;origin:string;reference:string}>{return Object.entries({...maps(d),[scope(d)]:b}).flatMap(([context,book])=>[...(book.history??[]),...(book.result?[book.result]:[])].flatMap(calc=>calc.inputs.filter(r=>r.prior&&(context===scope(d)||r.prior.origin==='effective')&&calc.rows.some(v=>v.id===r.id&&v.status==='determined'&&v.paid)).flatMap(r=>r.payments.map(p=>({id:r.id,entity:norm(r.prior!.entityRef),origin:r.prior!.origin,reference:norm(p.reference)})))));}
function abPaymentKeys(d:Record<string,unknown>):string[]{const ab=store(d).ivaClosures as Record<string,ReturnType<typeof closureBook>>|undefined;return Object.entries(ab??{}).flatMap(([id,v])=>[...v.rows,...[...(v.history??[]),...(v.result?[v.result]:[])].flatMap(c=>c.inputs)].filter(r=>id===scope(d)||r.origin==='effective').flatMap(r=>r.payments.map(p=>JSON.stringify([norm(r.entityRef),r.origin,norm(p.reference)]))));}
function key(d:Record<string,unknown>,b:SubstitutionBook){const ab=abPaymentKeys(d),past=pastPaymentUses(d,b);return closureFingerprint([b.rows,b.rows.map(r=>available(d,b,r)),uses(d,b).map(r=>[r.prior?.entityRef,r.prior?.origin,r.prior?.kind,r.prior?.id,r.payments.map(p=>norm(p.reference))]),b.rows.map(r=>r.payments.map(p=>!!r.prior&&(ab.includes(JSON.stringify([norm(r.prior.entityRef),r.prior.origin,norm(p.reference)]))||past.some(v=>v.id!==r.id&&v.entity===norm(r.prior!.entityRef)&&v.origin===r.prior!.origin&&v.reference===norm(p.reference)))))]);}
export function substitutionCurrent(d:Record<string,unknown>,b:SubstitutionBook):boolean{return!!b.result&&b.result.key===key(d,b)&&b.result.rows.length===b.rows.length&&b.rows.every(r=>b.result!.rows.some(s=>s.id===r.id&&s.inputKey===closureFingerprint(r)));}
function uses(d:Record<string,unknown>,b:SubstitutionBook):SubstitutionInput[]{return[...b.rows,...Object.entries(maps(d)).filter(([id])=>id!==scope(d)).flatMap(([,v])=>{validate(v);return v.rows.filter(r=>r.prior?.origin==='effective');})];}
export function recordSubstitution(d:Record<string,unknown>,b:SubstitutionBook,now=new Date().toISOString()):SubstitutionBook{
validate(b);if(new Set(b.rows.map(r=>r.id)).size!==b.rows.length)throw Error('Identidade de substituição repetida.');
const all=uses(d,b),paymentsAB=abPaymentKeys(d);
const rows:SubstitutionResult[]=b.rows.map(row=>{
const fields:Record<string,FiscalFraction|null>=Object.fromEntries(['17','18','19','20','21','22','23','24','25','26','27'].map(k=>[k,null]));
const result:SubstitutionResult={id:row.id,status:'indeterminate',reason:'',inputKey:closureFingerprint(row),fields,pendingCredit:null,paid:null,outstanding:null,overpayment:null,totalPaid:null,totalOutstanding:null,source:substitutionSource};
const stop=(reason:string)=>({...result,reason});const prior=row.prior,source=row.source;
if(!prior||!source||!available(d,b,row).every(Boolean))return stop('Escolha declaração anterior e resultadoL2 congelados recuperáveis;sem fabricar ou recalcular origens.');
if(d.currency!=='MZN'||source.currency!=='MZN'||source.opportunity!==scope(d)||source.period!==prior.period||!/^2026-(0[1-9]|1[0-2])$/.test(prior.period)||!source.debit||!source.credit)return stop('A substituição exige mesmo âmbito e período2026/MZN,com17/18 determinados.');
if(!prior.entityRef.trim()||prior.origin==='effective'&&source.projected)return stop('Origem projectada não serve como declaração efectiva;conservar pressupostos identificados.');
const seen=new Set([row.id]);let ancestor:PriorDeclaration|null=prior;while(ancestor?.kind==='C'){if(seen.has(ancestor.id))break;seen.add(ancestor.id);ancestor=b.rows.find(r=>r.id===ancestor!.id)?.prior??null;}if(ancestor?.kind==='C'&&seen.has(ancestor.id))return stop('Sequência circular de substituições;ligue cada versão à anterior sem ciclos.');
if(all.filter(r=>r.prior&&norm(r.prior.entityRef)===norm(prior.entityRef)&&r.prior.origin===prior.origin&&r.prior.kind===prior.kind&&r.prior.id===prior.id).length>1)return stop('Declaração anterior já ligada a outra substituição;reconcilie a sequência sem duplicar o diferencial.');
if(!row.priorReference.trim()||row.priorDate!==prior.declarationDate||prior.declarationReference&&row.priorReference!==prior.declarationReference||!date(row.priorDate)||row.priorDate.slice(0,7)<prior.period||!date(row.date)||row.date<row.priorDate||!row.reference.trim()||!row.reason.trim())return stop('Reutilize a data/referência disponível da versão anterior;identifique referência/data da declaração anterior e da substituição,com motivo;preparação não equivale a submissão.');
if(BigInt(source.debit.numerator)<0n||BigInt(source.credit.numerator)<0n||BigInt(source.debit.numerator)>0n&&BigInt(source.credit.numerator)>0n)return stop('Sinais17/18 incompatíveis na origemL2.');
fields['17']=source.debit;fields['18']=source.credit;
fields['21']=subtractFractions(subtractFractions(source.debit,source.credit),subtractFractions(prior.debit,prior.credit));fields['22']=positiveFraction(fields['21']);result.pendingCredit=positiveFraction(subtractFractions(zero(),fields['21']));
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{/* unknown preserved */}
if(!fields['23'])return stop('Juros adicionais por identificar;sem copiar juros anteriores ou presumir taxa/prazo.');
fields['24']=addFractions([fields['22'],fields['23']]);
const paid:FiscalFraction[]=[];
for(const p of row.payments){const ident=JSON.stringify([norm(prior.entityRef),prior.origin,norm(p.reference)]);if(!p.reference.trim()||!date(p.date)||p.date<row.date||prior.paymentRefs.some(ref=>norm(ref)===norm(p.reference))||pastPaymentUses(d,b).some(v=>v.id!==row.id&&v.entity===norm(prior.entityRef)&&v.origin===prior.origin&&v.reference===norm(p.reference))||paymentsAB.includes(ident)||all.flatMap(r=>r.payments.filter(p2=>r.prior&&JSON.stringify([norm(r.prior.entityRef),r.prior.origin,norm(p2.reference)])===ident)).length>1)return stop('Pagamento já registado na anterior/outra declaração,sem referência/data aplicável;registe só pagamentos adicionais.');try{paid.push(decimalFraction(p.amount));}catch{return stop('Montante adicional não identificado;sem baixa presumida.');}}
result.paid=addFractions(paid);result.outstanding=positiveFraction(subtractFractions(fields['24'],result.paid));result.overpayment=positiveFraction(subtractFractions(result.paid,fields['24']));result.totalPaid=addFractions([prior.paid,result.paid]);result.totalOutstanding=addFractions([prior.outstanding,result.outstanding]);result.status='determined';result.reason='Diferencial21 separado da declaração anterior;19/20 não reutilizados,25/26/27 não atribuídos por esta substituição. Crédito credor aguarda comunicação20;sem compensar dívida anterior automaticamente. Pagamentos adicionais e saldo anterior separados;sem submissãoAT ou certificação de cobrança. '+(row.stage==='preparation'?'Preparação/simulação;referências e datas declaradas não comprovam entrega.':'Apresentação registada pelo utilizador fora do InvesteMoz.');return result;
});
const result={calculatedAt:now,key:key(d,b),inputs:structuredClone(b.rows),rows};return{...b,...(b.result?{history:[...(b.history??[]),structuredClone(b.result)]}:{}),result};
}
export function substitutionReportRows(d:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=substitutionBook(d);if(!b.rows.length)return[];const out:Array<[string,string,string,string]>=[['IVA mensal','L3-C — substituições',substitutionCurrent(d,b)?'Resultado correspondente às entradas':'Histórico preservado;rever entradas/origens',substitutionSource]];const fmt=(v:FiscalFraction|null|undefined)=>v?fractionPresentation(v).decimal:'Indeterminado';for(const r of b.result?.rows??[]){const input=b.result!.inputs.find(i=>i.id===r.id),p=input?.prior;out.push(['IVA mensal',`Substituição — ${p?.period??'por identificar'}`,`21:${fmt(r.fields['21'])};22 adicional:${fmt(r.fields['22'])};23 adicional:${fmt(r.fields['23'])};24 adicional:${fmt(r.fields['24'])};crédito aguardando comunicação:${fmt(r.pendingCredit)}`,`${p?.entityRef??''};${scope(d)};MZN;${p?.origin==='effective'?'Dados efectivos declarados':'Pressuposto de simulação'};anterior ${input?.priorReference??''},${input?.priorDate??''};substituição ${input?.reference??''},${input?.date??''};${input?.reason??''};${r.reason}`]);out.push(['IVA mensal',`Reconciliação da substituição — ${p?.period??''}`,`Anterior:pago${fmt(p?.paid)},por liquidar${fmt(p?.outstanding)},reporte histórico26:${fmt(p?.carry)};adicional:pago${fmt(r.paid)},por liquidar${fmt(r.outstanding)},excedente${fmt(r.overpayment)};total registado${fmt(r.totalPaid)},total por liquidar sem compensação${fmt(r.totalOutstanding)}`,`Origem anterior${p?.kind}/${p?.id},versão${p?.calculatedAt};origemL2 revisão${input?.source?.revision},${input?.source?.calculatedAt};pagamentos adicionais:${input?.payments.map(p=>`${p.reference};${p.date};${p.amount}MZN`).join(' | ')||'nenhum'};juros adicionais:${input?.interestRef??''};histórico${b.result!.calculatedAt};${substitutionSource}`]);}return out;}catch{return[['IVA mensal','L3-C','Substituição não recuperável','Originais preservados;sem diferencial/crédito presumidos.']];}}
@@ -0,0 +1,26 @@
export const temporaryBenefitVersion = 'temporary-benefit-cessation/1';
export const temporaryBenefitEnd = '2025-12-31';
const amendments = 'Lei10/2025, BR248/suplemento1, art.1, PDF12/p.2180(12): altera3,6,12,18,19,21,23,25,26,27,31,32,33,34, sem prorrogar9(13)/9(16); art.5, PDF15/p.2180(15), efeitos01/01/2026. Art.12(1)(a) retira as remissões a9(13)/9(16) nas importações; este bloco trata operações internas, não calcula importações.';
const sugarOilSource = `Lei3/2025, BR95/suplemento, art.1, PDF1–2/p.478(1)–(2):9(13)(a–f), termo31/12/2025; art.2, PDF2, entrada na publicação21/05/2025. ${amendments}`;
export const temporaryBenefits = [
{ id: 'temporary_sugar', branch: 'P038', label: 'Transmissão do açúcar', article: '9(13)(a)', historicalScope: 'Transmissão do açúcar.', source: sugarOilSource },
{ id: 'temporary_sugar_industry_goods', branch: 'P039', label: 'Bens transmitidos pela indústria nacional do açúcar', article: '9(13)(b);9(14)', historicalScope: 'Matérias-primas, produtos intermediários, peças, equipamentos e componentes: a redacção de2025 diz efectuadas pela indústria nacional do açúcar. Art.9(14): documentos aduaneiros apropriados ou declaração do adquirente, consoante o caso, sobre incorporação no processo de produção.', source: sugarOilSource },
{ id: 'temporary_oils_soap', branch: 'P040', label: 'Óleos alimentares e sabões', article: '9(13)(c)', historicalScope: 'Transmissões de óleos alimentares e de sabões.', source: sugarOilSource },
{ id: 'temporary_oils_soap_factory', branch: 'P041', label: 'Produção industrial de óleo alimentar e sabões', article: '9(13)(d)', historicalScope: 'Bens resultantes da actividade industrial de produção de óleo alimentar e de sabões, transmitidos pelas respectivas fábricas.', source: sugarOilSource },
{ id: 'temporary_oils_soap_inputs', branch: 'P042', label: 'Matérias-primas para óleo/sabões — Anexo II', article: '9(13)(e)', historicalScope: 'Bens para utilização como matéria-prima na indústria de óleo e sabões, constantes da Pauta e discriminados noAnexoII daLei3/2025,PDF2. A lista não prorroga o prazo nem determina por si outra isenção.', source: sugarOilSource },
{ id: 'temporary_sugar_cane', branch: 'P043', label: 'Actividade agrícola de cana-de-açúcar para a indústria', article: '9(13)(f);9(14)', historicalScope: 'Bens e serviços no âmbito da actividade agrícola de produção de cana-de-açúcar destinados à indústria. Art.9(14): documentos aduaneiros apropriados ou declaração do adquirente, consoante o caso, sobre incorporação no processo de produção. A produção agrícola própria do9(7)(a) exige análise distinta.', source: sugarOilSource },
{ id: 'temporary_solar_inputs', branch: 'P045', label: 'Factores de produção de painéis solares para electrificação rural', article: '9(16)', historicalScope: 'Factores de produção de painéis solares para electrificação rural, constantes da Pauta e discriminados noAnexoIV. Não é uma isenção genérica de painéis ou de projectos de energia.', source: `Lei22/2022, art.1, PDF2/p.2252(26),9(16), termo31/12/2025;art.3(2),PDF4/p.2252(28),aditaAnexoIV;art.6,PDF4,efeitos01/01/2023. ${amendments}` },
] as const;
export function temporaryBenefit(id: string | undefined) {
return temporaryBenefits.find(item => item.id === id);
}
export function temporaryBenefitNotice(id: string, period: string): string {
const benefit = temporaryBenefit(id);
if (!benefit) throw new Error('Benefício temporário não identificado; dados conservados.');
if (!/^2026-(0[1-9]|1[0-2])$/.test(period)) return 'Período fora da cobertura de2026; não se calcula nem se certifica a isenção histórica.';
return `O benefício temporário do art.${benefit.article} terminou em31/12/2025 e não é aplicável a${period}. A cessação não determina, por si, a taxa ou outra isenção desta operação. Escolha expressamente o enquadramento actual e confirme as respectivas condições; montantes e imposto ficam por determinar até essa escolha.`;
}
+100
View File
@@ -0,0 +1,100 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
import {newCurrencyEvent,evaluateCurrencyEvent,type CurrencyEventRow} from './iva-currency-events.ts';
import {travelBook,travelCurrent,travelDecimal,travelMoney,type TravelLine,type TravelRow} from './iva-travel.ts';
export const travelEventVersion='travel-suspensive-events/1';
export const travelEventSource='CIVA7(8)/(9),8,5(2),14(1),Lei13/2016PDF7/9/13/p1426(265/267/271); RIVA38/40,PDF6–7/p104–105.7(8) defere facto gerador/exigibilidade até cessar regime; mudança de local sem cessação não é saída fiscal.7(9)/40: primeiro entre pagamento integral e imediatamente antes do início/primeiro serviço. Facto gerador separado de factura/recebimento8; reutiliza motor entregue. Sem base/IVA/dedução, desembaraço ou pagamento automáticos.';
export type TravelEventRow=CurrencyEventRow&{travelRowId:string;fullPaymentState:string;fullPaymentDate:string;fullPaymentRef:string;startState:string;startDate:string;startRef:string;regimeClause:string;entryDate:string;entryRef:string;regimeStatus:string;exitDate:string;exitRef:string;cessationConfirmed:string};
type TravelOrigin={id:string;period:string;operatorRef:string;operationRef:string;description:string;scope:string;revision:number;current:boolean;input:TravelRow;classification:TravelLine};
type DueEvent={date:string;amount:string|null;reason:string};
export type TravelEventLine={id:string;status:'determined'|'not_applicable'|'indeterminate'|'deferred';eventDate:string|null;eventTiming:string|null;dueEvents:DueEvent[];remainingPending:boolean;source:TravelOrigin|null;baseAmount:null;vat:null;deduction:null;reason:string};
export type TravelEventCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;sourceKey:string;source:string;inputs:TravelEventRow[];rows:TravelEventLine[]};
export type TravelEventBook={rows:TravelEventRow[];result?:TravelEventCalculation;history?:TravelEventCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{travelSpecialEvents?:Record<string,TravelEventBook>};
export function newTravelEvent(id:string,currency:string):TravelEventRow{return{...newCurrencyEvent(id,currency),travelRowId:'',fullPaymentState:'',fullPaymentDate:'',fullPaymentRef:'',startState:'',startDate:'',startRef:'',regimeClause:'',entryDate:'',entryRef:'',regimeStatus:'',exitDate:'',exitRef:'',cessationConfirmed:''};}
export function switchTravelEvent(row:TravelEventRow,treatment:string):TravelEventRow{return{...row,treatment,factsConfirmed:'',invoiceRequired:''};}
export function travelEventSources(draft:Record<string,unknown>):TravelOrigin[]{const b=travelBook(draft),r=b.result;return r?r.inputs.map((input,i)=>({id:input.id,period:input.period,operatorRef:input.operatorRef,operationRef:input.operationRef,description:input.description,scope:input.scope,revision:r.revision,current:travelCurrent(draft,b),input,classification:r.rows[i]})):[];}
function readStore(draft:Record<string,unknown>):Store{
const s=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(s.travelSpecialEvents!==undefined&&(!s.travelSpecialEvents||typeof s.travelSpecialEvents!=='object'||Array.isArray(s.travelSpecialEvents)))throw new Error('Eventos especiais não recuperáveis; originais conservados.');
const fields=Object.keys(newTravelEvent('',''));
for(const b of Object.values(s.travelSpecialEvents??{}))if(!b||!Array.isArray(b.rows)||(b.history!==undefined&&!Array.isArray(b.history))||b.rows.some(r=>!r||fields.some(k=>typeof r[k as keyof TravelEventRow]!=='string')))throw new Error('Linhas de eventos especiais não recuperáveis; sem lista vazia por defeito.');return s;
}
export function travelEventBook(draft:Record<string,unknown>):TravelEventBook{return readStore(draft).travelSpecialEvents?.[acquisitionScope(draft)]??{rows:[]};}
export function saveTravelEventBook(draft:Record<string,unknown>,book:TravelEventBook):string{const s=readStore(draft),encoded=JSON.stringify({...s,travelSpecialEvents:{...s.travelSpecialEvents,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function date(s:string):number|null{const n=Date.parse(s+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(n)&&new Date(n).toISOString().slice(0,10)===s?n:null;}
export function evaluateTravelEvent(draft:Record<string,unknown>,row:TravelEventRow):TravelEventLine{
const result:TravelEventLine={id:row.id,status:'indeterminate',eventDate:null,eventTiming:null,dueEvents:[],remainingPending:false,source:null,baseAmount:null,vat:null,deduction:null,reason:''};const stop=(reason:string,status:TravelEventLine['status']='indeterminate')=>({...result,status,reason});
if(!['travel_special','suspensive_exit'].includes(row.treatment)||!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||date(row.documentDate)===null||date(row.reviewDate)===null||![row.description,row.operationRef,row.documentRef,row.scope,row.evidence].every(v=>!!v.trim()))return stop('Identifique percurso, período2026, operação, âmbito, documentos/pressupostos e data de conferência.');
if(row.factsConfirmed==='no')return stop('Factos não correspondem ao percurso especial; manter enquadramento aplicável, sem isenção ou IVAzero presumidos.','not_applicable');
if(row.factsConfirmed!=='yes')return stop('Factos próprios do evento por esclarecer; não inferir pela factura, licenciamento ou viagem anunciada.');
const review=date(row.reviewDate)!;
if(row.treatment==='suspensive_exit'){
const entry=date(row.entryDate);
if(!['a','b','c','d'].includes(row.regimeClause)||entry===null||entry>review||!row.entryRef.trim())return stop('Identifique bens/operação e regime ou procedimento14(1)/5(2), sua colocação/data e referência; uma localização em armazém não demonstra regime suspensivo.');
if(row.regimeStatus==='still')return stop('CIVA7(8): bens/operação continuam abrangidos pelo regime; facto gerador e exigibilidade diferidos. Factura ou recebimento não são tratados como saída fiscal por este percurso.','deferred');
if(row.regimeStatus!=='ceased')return stop('Situação actual do regime por esclarecer; ausência de documento não prova permanência nem saída.');
const exit=date(row.exitDate);if(exit===null||exit<entry||!row.exitRef.trim()||row.cessationConfirmed!=='yes')return stop('Identifique cessação efectiva do regime/procedimento e sua data/âmbito; transferência entre regimes ou mudança física de armazém não demonstram por si cessação.');
result.eventDate=row.exitDate;result.eventTiming='cessação efectiva do regime/procedimento';
if(exit>review)return stop('Cessação futura na conferência; não declarar facto gerador/exigibilidade já ocorridos.');
result.dueEvents=[{date:row.exitDate,amount:null,reason:'7(8): cessação do regime/procedimento identificado; montante não apurado'}];return stop('P133: facto gerador e exigibilidade pelo momento de cessação efectiva7(8). Não concede isenção14, liquida importação, determina valor aduaneiro, direito, ICE ou dedução.','determined');
}
let source:TravelOrigin|undefined;try{source=travelEventSources(draft).find(s=>s.id===row.travelRowId);}catch{return stop('Origem de viagens não recuperável; conservar originais e histórico.');}
if(!source)return stop('Associe uma operação de viagens já classificada nesta oportunidade; não copiar de outro projecto.');result.source=source;
if(!source.current||source.classification.regime==='indeterminate')return stop('Origem alterada ou natureza do regime indeterminada; rever apenas a associação/versão afectada.');
if(!['special','mixed'].includes(source.classification.regime)||source.classification.territory!=='national')return stop('Origem segue regime geral ou outro âmbito; evento específico da parte especial não se aplica. Reutilizar eventos gerais próprios sem os substituir.','not_applicable');
if(source.input.domesticTaxable!=='yes'||!source.input.taxRef.trim())return stop('Enquadramento tributável da parcela especial por esclarecer. Montantes da margem não são pré-condição do evento, mas o âmbito fiscal deve estar identificado.');
if(row.operationRef!==source.operationRef||row.currency!==source.input.currency)return stop('Referência da operação ou moeda diverge da origem; conservar dados e conferir a associação. O período deste evento pode diferir do período do registo da margem.');
if(!['full','partial','none'].includes(row.fullPaymentState)||!['started','not_started'].includes(row.startState))return stop('Distinga pagamento integral, parcial ou inexistente e início/primeiro serviço ocorrido ou ainda não iniciado. Desconhecido não é ausência de pagamento.');
const full=row.fullPaymentState==='full'?date(row.fullPaymentDate):null,start=row.startState==='started'?date(row.startDate):null;
if(row.fullPaymentState==='full'&&(full===null||!row.fullPaymentRef.trim()||full>review))return stop('Identifique pagamento integral efectivamente ocorrido ou no cenário de conferência declarado, sem o inferir de sinal/adiantamento.');
if(row.startState==='started'&&(start===null||!row.startRef.trim()||start>review))return stop('Identifique o primeiro serviço ao cliente/início da viagem ou alojamento, até à conferência. Não subtrair um dia à data: a regra é imediatamente antes desse momento.');
if(full!==null&&(start===null||full<start)){result.eventDate=row.fullPaymentDate;result.eventTiming='acto do pagamento integral';}
else if(start!==null){result.eventDate=row.startDate;result.eventTiming=full===start?'pagamento integral e início na mesma data; ordem intradiária não apurada':'imediatamente antes do início/primeiro serviço';}
if(row.fullPaymentState==='partial'&&row.paymentState!=='received')return stop('Pagamento parcial declarado exige identificar a parcela recebida; não o transformar em pagamento integral.');
if(row.fullPaymentState==='none'&&row.paymentState!=='none')return stop('Estado sem pagamentos diverge da parcela recebida/por esclarecer; reconciliar factos sem sobrescrever referências.');
if(row.fullPaymentState==='full'&&row.paymentState==='none')return stop('Pagamento integral diverge de ausência de recebimento; conferir estados.');
if(row.fullPaymentState==='partial'){
const amount=travelDecimal(row.amount),part=travelDecimal(row.paymentAmount);
if(amount===null||part===null||part<=0n||part>=amount)return stop('Parcial exige parcela positiva inferior à contraprestação total identificada; igualdade não pode ser tratada como simples sinal.');
}
if(row.fullPaymentState==='full'&&row.invoiceRequired==='yes'){
const amount=travelDecimal(row.amount),part=travelDecimal(row.paymentAmount),payment=date(row.paymentDate);
if(amount===null||part===null||payment===null||payment>full!||part<=0n||part>amount||(payment===full&&part!==amount)||(payment<full!&&part>=amount))return stop('Reconcilie parcela anterior e liquidação integral: data/valor do recebimento deve corresponder ao total na data integral ou a parcela anterior inferior ao total.');
}
if(result.eventDate===null){
if(row.invoiceRequired==='no')return stop('Sem pagamento integral e sem início: facto gerador7(9) ainda não ocorrido no âmbito declarado; sem antecipação automática por adiantamento.','deferred');
if(row.invoiceRequired==='yes'&&row.paymentState==='none'){
const deadline=date(row.legalDeadline),invoice=row.invoiceState==='issued'?date(row.invoiceDate):null;
if(deadline===null||!row.deadlineRef.trim()||!['issued','not_issued'].includes(row.invoiceState)||(row.invoiceState==='issued'&&(invoice===null||invoice>review||!row.invoiceRef.trim())))return stop('Facto gerador7(9) ainda não ocorrido; identificar factura e prazo/disposição aplicáveis antes de avaliar8a/b, sem inventar data de viagem.');
const due=invoice!==null&&invoice<=deadline?row.invoiceDate:row.legalDeadline;
if(date(due)!>review){result.remainingPending=true;return stop('Facto gerador7(9) não ocorrido e nenhuma parcela8a/b exigível até à conferência declarada.','deferred');}
const amount=travelDecimal(row.amount);result.dueEvents=[{date:due,amount:amount===null?null:travelMoney(amount),reason:invoice!==null&&invoice<=deadline?'8a: factura antecipada emitida no prazo; facto gerador especial ainda não ocorrido':'8b: termo do prazo expressamente identificado; facto gerador especial ainda não ocorrido'}];
return stop('Exigibilidade8a/b por factura/prazo identificados, sem usar essa data como pagamento integral ou início7(9).','determined');
}
if(row.invoiceRequired!=='yes'||row.paymentState!=='received')return stop('Facto gerador especial ainda não ocorrido; conferir eventual factura ou recebimento8 sem inventar data do início.');
const early=evaluateCurrencyEvent({...row,treatment:'advance_payment',eventDate:'',eventRef:'CIVA7(9)/RIVA40 — sem evento integral/início ocorrido'});
result.dueEvents=early.dueEvents;result.remainingPending=early.remainingPending;
return stop('Facto gerador7(9) ainda não ocorrido. Parcela8 avaliada pelo motor existente: '+early.reason,early.status==='determined'?'determined':early.status==='not_applicable'?'not_applicable':'indeterminate');
}
const existing=evaluateCurrencyEvent({...row,treatment:'service_completed',eventDate:result.eventDate!,eventRef:'CIVA7(9)/RIVA40: '+result.eventTiming});
result.dueEvents=existing.dueEvents;result.remainingPending=existing.remainingPending;
if(existing.status==='determined'&&row.fullPaymentState==='full'&&row.invoiceRequired==='yes'){
const total=travelDecimal(row.amount)!;const before=result.dueEvents.filter(e=>date(e.date)!<full!);let already=0n;
for(const e of before){const value=e.amount===null?null:travelDecimal(e.amount);if(value===null)return stop('Parcela anterior com montante indeterminado; conservar evento e esclarecer total antes de reconciliar pagamento integral.');already+=value;}
if(already>total)return stop('Parcelas anteriores excedem total; sem dupla contagem.');
result.dueEvents=[...before,...(total>already?[{date:row.fullPaymentDate,amount:travelMoney(total-already),reason:'8c: saldo recebido na liquidação integral, descontando parcelas já exigíveis'}]:[])];result.remainingPending=false;
}
return stop('P133:7(9)/RIVA40, '+result.eventTiming+' em '+result.eventDate+'. Exigibilidade8 separada por factura/recebimento, sem duplicação de parcela e restante. '+existing.reason,existing.status==='determined'?'determined':existing.status==='not_applicable'?'not_applicable':'indeterminate');
}
function key(draft:Record<string,unknown>,book:TravelEventBook):string{return JSON.stringify({version:travelEventVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},rows:book.rows,dependencies:book.rows.map(row=>row.treatment==='travel_special'?travelEventSources(draft).find(s=>s.id===row.travelRowId):null)});}
export function travelEventCurrent(draft:Record<string,unknown>,book:TravelEventBook):boolean{try{return!!book.result&&book.result.sourceKey===key(draft,book);}catch{return false;}}
export function recordTravelEvents(draft:Record<string,unknown>,book:TravelEventBook):TravelEventBook{
if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length)throw new Error('Identifique eventos distintos; originais conservados.');
const result:TravelEventCalculation={version:travelEventVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),sourceKey:key(draft,book),source:travelEventSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateTravelEvent(draft,row))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveTravelEventBook(draft,next);return next;
}
function eventFacts(row:TravelEventRow,line:TravelEventLine):string{
if(row.treatment==='suspensive_exit')return`regime14(1)${row.regimeClause};entrada${row.entryDate},${row.entryRef};situação${row.regimeStatus};${row.regimeStatus==='ceased'?`cessação${row.exitDate},${row.exitRef},confirmada${row.cessationConfirmed}`:'dados de cessação sem aplicação conservados no rascunho/histórico, não usados neste resultado'}`;
return`origem viagem${row.travelRowId},versão${line.source?.revision??'Indeterminada'},${line.source?.scope??''};pagamento${row.fullPaymentState}${row.fullPaymentState==='full'?','+row.fullPaymentDate+','+row.fullPaymentRef:''};início${row.startState}${row.startState==='started'?','+row.startDate+','+row.startRef:''};factura${row.invoiceRequired};${row.invoiceRequired==='yes'?`emissão${row.invoiceState}${row.invoiceState==='issued'?','+row.invoiceDate+','+row.invoiceRef:''};prazo${row.legalDeadline},${row.deadlineRef};`:''}recebimento${row.paymentState}${row.paymentState==='received'?','+row.paymentDate+','+row.paymentAmount+','+row.paymentRef:''};total${row.amount}${row.currency};referências sem aplicação conservadas no rascunho/histórico`;
}
export function travelEventReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=travelEventBook(draft),r=b.result;if(!r)return[];return r.inputs.map((row,i)=>{const line=r.rows[i];return['IVA mensal',`P133 — ${row.period} — ${row.id}`,`${row.description};${line.reason};facto gerador:${line.eventDate??'Não apurado/ainda não ocorrido'};momento:${line.eventTiming??'Indeterminado'};parcelas:${line.dueEvents.map(p=>p.date+':'+(p.amount??'Montante indeterminado')+' '+row.currency+' ('+p.reason+')').join('; ')||'Nenhuma apurada'};restante:${line.status==='indeterminate'?'Indeterminado':line.remainingPending?'Pendente':'Sem restante apurado'};base/IVA/dedução:Indeterminados`,`${r.opportunity};${travelEventCurrent(draft,b)?'Resultado actual':'Origem/entradas alteradas; resultado histórico conservado'};versão${r.revision};${r.calculatedAt};${r.source};${row.origin};operação${row.operationRef};âmbito${row.scope};documento${row.documentRef},${row.documentDate};conferência${row.reviewDate};${eventFacts(row,line)};factos${row.evidence};sem lançamento fiscal, nova dedução/campo11 ou totaisModeloA.`];});}catch{return[['IVA mensal','P133','Dados não recuperáveis','Originais conservados; nenhum evento por defeito.']];}}
+96
View File
@@ -0,0 +1,96 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const travelVersion='travel-period-margin/1';
export const travelSource='CIVA4(5),Lei13/2016PDF7/p1426(265); RIVA Decreto7/2008,38–46,PDF6–8/p104–106: âmbito, prestação única, margem global por período, custos directos de terceiros, excesso negativo e facturação IVA incluído. CIVA17(1),Lei22/2022PDF3:16% usado apenas no divisor da base em2026;Lei10/2025 não altera4/7/8/17. Sem IVA devido, dedução/campo11, regularização ou totaisModeloA calculados. O cálculo fica limitado ao registo e âmbito declarados, não fecha apuramento de toda a organização.';
type Choice=''|'yes'|'no';
export const travelConditions=[['operator','Agência de viagens ou organizador de circuitos turísticos identificado, actuando nessa qualidade'],['singlePrice','Conjunto combinado de serviços por preço único, sem discriminar preços finais por componente'],['ownName','Actua em nome próprio perante o cliente']] as const;
export const travelCostKinds=[['direct','Bem/serviço de terceiro para benefício directo do cliente'],['exchange','Compra/venda/troca de divisas'],['advertising','Publicidade/promoção'],['communications','Comunicações e correspondência da agência'],['sales_commission','Comissão paga à agência vendedora'],['other','Outro custo com natureza a esclarecer']] as const;
export type TravelCost={id:string;kind:string;description:string;amount:string;ref:string;thirdParty:Choice;directBenefit:Choice};
export type TravelRow={id:string;description:string;period:string;origin:'projected'|'effective';currency:string;operatorRef:string;operationRef:string;documentRef:string;documentDate:string;scope:string;evidence:string;agencyCountry:string;agencyRef:string;resources:string;retailer:Choice;newPackage:Choice;packageRef:string;grossPrice:string;thirdPartyGross:string;allocationRef:string;domesticTaxable:Choice;taxRef:string;conditions:Partial<Record<string,Choice>>;costs:TravelCost[]};
export type TravelPeriod={id:string;period:string;operatorRef:string;scope:string;complete:Choice;registerRef:string;priorMode:string;priorAmount:string;priorRef:string;priorOverride:Choice};
export type TravelLine={id:string;status:'determined'|'not_applicable'|'indeterminate';regime:'special'|'mixed'|'general'|'outside'|'indeterminate';territory:'national'|'outside'|null;specialGross:string|null;generalGross:string|null;eligibleCosts:string|null;excludedCosts:string|null;reason:string};
export type TravelPeriodResult={id:string;period:string;operatorRef:string;status:'determined'|'indeterminate';grossReceipts:string|null;directCosts:string|null;excludedCosts:string|null;priorExcess:string|null;grossDifference:string|null;carryForward:string|null;baseAmount:string|null;baseDivisorRate:string|null;vat:null;deduction:null;reason:string};
export type TravelCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;sourceKey:string;source:string;inputs:TravelRow[];periodInputs:TravelPeriod[];rows:TravelLine[];periods:TravelPeriodResult[]};
export type TravelBook={rows:TravelRow[];periods:TravelPeriod[];result?:TravelCalculation;history?:TravelCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{travelOperations?:Record<string,TravelBook>};
export function newTravelCost(id:string):TravelCost{return{id,kind:'',description:'',amount:'',ref:'',thirdParty:'',directBenefit:''};}
export function newTravel(id:string,currency:string):TravelRow{return{id,description:'',period:'',origin:'projected',currency,operatorRef:'',operationRef:'',documentRef:'',documentDate:'',scope:'',evidence:'',agencyCountry:'',agencyRef:'',resources:'',retailer:'',newPackage:'',packageRef:'',grossPrice:'',thirdPartyGross:'',allocationRef:'',domesticTaxable:'',taxRef:'',conditions:{},costs:[]};}
export function newTravelPeriod(id:string):TravelPeriod{return{id,period:'',operatorRef:'',scope:'',complete:'',registerRef:'',priorMode:'',priorAmount:'',priorRef:'',priorOverride:''};}
export function switchTravelResources(row:TravelRow,resources:string):TravelRow{return{...row,resources,conditions:{...row.conditions,singlePrice:'',ownName:''}};}
function readStore(draft:Record<string,unknown>):Store{
const s=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(s.travelOperations!==undefined&&(!s.travelOperations||typeof s.travelOperations!=='object'||Array.isArray(s.travelOperations)))throw new Error('Viagens não recuperáveis; originais conservados.');
const rf=Object.keys(newTravel('','')).filter(k=>!['conditions','costs'].includes(k)),pf=Object.keys(newTravelPeriod('')),cf=Object.keys(newTravelCost(''));
for(const b of Object.values(s.travelOperations??{}))if(!b||!Array.isArray(b.rows)||!Array.isArray(b.periods)||(b.history!==undefined&&!Array.isArray(b.history))||b.rows.some(r=>!r||rf.some(k=>typeof r[k as keyof TravelRow]!=='string')||!r.conditions||typeof r.conditions!=='object'||Array.isArray(r.conditions)||!Array.isArray(r.costs)||r.costs.some(c=>!c||cf.some(k=>typeof c[k as keyof TravelCost]!=='string')))||b.periods.some(p=>!p||pf.some(k=>typeof p[k as keyof TravelPeriod]!=='string')))throw new Error('Registo de viagens não recuperável; sem substituição por lista vazia.');return s;
}
export function travelBook(draft:Record<string,unknown>):TravelBook{return readStore(draft).travelOperations?.[acquisitionScope(draft)]??{rows:[],periods:[]};}
export function saveTravelBook(draft:Record<string,unknown>,book:TravelBook):string{const s=readStore(draft),encoded=JSON.stringify({...s,travelOperations:{...s.travelOperations,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
export function travelDecimal(s:string):bigint|null{if(!/^\d{1,15}(\.\d{1,6})?$/.test(s.trim()))return null;const[w,f='']=s.trim().split('.');return BigInt(w)*1000000n+BigInt(f.padEnd(6,'0'));}
function money(n:bigint):string{if(n<0n)return'-'+money(-n);return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
export {money as travelMoney};
function validDate(s:string):boolean{const d=new Date(s+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(s)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===s;}
export function evaluateTravel(row:TravelRow,currency:unknown):TravelLine{
const result:TravelLine={id:row.id,status:'indeterminate',regime:'indeterminate',territory:null,specialGross:null,generalGross:null,eligibleCosts:null,excludedCosts:null,reason:''};const stop=(reason:string,status:TravelLine['status']='indeterminate')=>({...result,status,reason});
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin)||![row.description,row.operatorRef,row.operationRef,row.documentRef,row.scope,row.evidence,row.agencyRef].every(v=>!!v.trim())||!validDate(row.documentDate))return stop('Identifique operador, operação, período do registo2026, documento ou previsão, estabelecimento, âmbito e factos. O período do registo não é inferido da data da viagem.');
if(row.conditions.operator==='no')return stop('Qualidade de agência/organizador não demonstrada; aplicar enquadramento próprio, sem benefício presumido.','not_applicable');
if(row.conditions.operator!=='yes')return stop('Qualidade em que o operador actua por esclarecer.');
if(row.conditions.singlePrice==='no'||row.conditions.ownName==='no'||row.resources==='own')return{...stop('RIVA38(2)/(3): operação avulsa/em nome de outrem ou meios próprios segue regime geral, sem margem especial. Reutilize o percurso de serviço/localização aplicável.','not_applicable'),regime:'general'};
if(!['third_party','mixed'].includes(row.resources)||row.conditions.singlePrice!=='yes'||row.conditions.ownName!=='yes'||!['yes','no'].includes(row.retailer))return stop('Esclareça pacote a preço único, nome próprio, meios próprios/terceiros e venda retalhista.');
if(row.retailer==='yes'){
if(row.newPackage==='no')return{...stop('RIVA38(4): revenda retalhista sem novo conjunto com serviços não meramente acessórios/complementares segue regime geral.','not_applicable'),regime:'general'};
if(row.newPackage!=='yes'||!row.packageRef.trim())return stop('Na revenda retalhista, identifique novo conjunto em nome próprio e serviços acrescidos não meramente acessórios/complementares.');
}
if(!['MZ','foreign'].includes(row.agencyCountry))return stop('Identifique sede/estabelecimento a partir do qual a agência presta o serviço.');
if(row.agencyCountry==='foreign')return{...stop('RIVA39(2): sede/estabelecimento prestador fora do território; esta margem nacional não se aplica. Conferir localização/regime próprio, sem isenção ou IVA estrangeiro presumido.','not_applicable'),regime:'outside',territory:'outside'};
result.regime=row.resources==='mixed'?'mixed':'special';result.territory='national';
if(currency!=='MZN'||row.currency!==currency)return stop('Natureza especial identificada; cálculo em moeda estrangeira ou divergente não apurado, sem conversão fiscal presumida. P104 mantém âmbito próprio.');
if(row.domesticTaxable!=='yes'||!row.taxRef.trim())return stop('Localização39(2) identificada; enquadramento tributável desta parcela/período por esclarecer antes do divisor17(1). Não presumir isenção, taxa ou benefício pela categoria turística.');
const gross=travelDecimal(row.grossPrice);if(gross===null)return stop('Identifique contraprestação com IVA incluído registada neste período; desconhecido não é zero.');
const special=row.resources==='mixed'?travelDecimal(row.thirdPartyGross):gross;
if(special===null||special>gross||(row.resources==='mixed'&&!row.allocationRef.trim()))return stop('Meios mistos: delimite contraprestação da parte de terceiros e fundamento de repartição; não aplicar margem ao conjunto nem repartir por percentagem inventada.');
let eligible=0n,excluded=0n;
if(new Set(row.costs.map(c=>c.id)).size!==row.costs.length)return stop('Identifique custos sem duplicar identidades.');
for(const cost of row.costs){
const value=travelDecimal(cost.amount);if(value===null||!cost.ref.trim()||!cost.description.trim()||!travelCostKinds.some(([k])=>k===cost.kind))return stop('Identifique natureza, montante com IVA e referência de cada custo registado no período. Lista vazia corresponde apenas à ausência declarada de custos no âmbito completo.');
if(['exchange','advertising','communications','sales_commission'].includes(cost.kind)){excluded+=value;continue;}
if(cost.thirdParty==='no'||cost.directBenefit==='no'){excluded+=value;continue;}
if(cost.thirdParty!=='yes'||cost.directBenefit!=='yes')return stop('Benefício directo e fornecimento por terceiro por esclarecer neste custo; não o excluir ou incluir por defeito.');
eligible+=value;
}
return{...result,status:'determined',specialGross:money(special),generalGross:money(gross-special),eligibleCosts:money(eligible),excludedCosts:money(excluded),reason:'RIVA38/39: prestação única no âmbito da parte de terceiros; registo43 de contraprestações e custos directos com IVA incluído. Custos41(3) excluídos da margem, não transformados em dedução. A base é apurada globalmente por operador/período, não por pacote. Meios próprios/parte geral conservados fora da margem; factura45 sem discriminar IVA, menção IVA incluído; registo especial46. Sem factura oficial emitida, dedução ou regularização automática.'};
}
function previousMonth(period:string):string{const[y,m]=period.split('-').map(Number);return new Date(Date.UTC(y,m-2,1)).toISOString().slice(0,7);}
export function evaluateTravelPeriods(book:TravelBook,lines:TravelLine[]):TravelPeriodResult[]{
const results:TravelPeriodResult[]=[];
for(const input of [...book.periods].sort((a,b)=>a.period.localeCompare(b.period))){
const r:TravelPeriodResult={id:input.id,period:input.period,operatorRef:input.operatorRef,status:'indeterminate',grossReceipts:null,directCosts:null,excludedCosts:null,priorExcess:null,grossDifference:null,carryForward:null,baseAmount:null,baseDivisorRate:null,vat:null,deduction:null,reason:''};const stop=(reason:string)=>{r.reason=reason;results.push(r);};
if(!/^2026-(0[1-9]|1[0-2])$/.test(input.period)||!input.operatorRef.trim()||!input.scope.trim()||!input.registerRef.trim()||input.complete!=='yes'){stop('Identifique período, operador e âmbito completo do registo simulado, incluindo contraprestações/custos e referência. Não apresentar soma parcial como apuramento global da organização.');continue;}
const rows=book.rows.map((row,i)=>({row,line:lines[i]})).filter(({row})=>row.operatorRef===input.operatorRef&&row.period===input.period);
if(book.rows.some(row=>!row.operatorRef.trim()||!row.period.trim())||!rows.length||rows.some(({line})=>line.status==='indeterminate')){stop('Linhas por esclarecer ou âmbito sem registo: período indeterminado; não omitir silenciosamente operação/custo da margem global.');continue;}
const selected=rows.filter(({line})=>line.status==='determined'&&['special','mixed'].includes(line.regime));
if(new Set(selected.map(({row})=>row.origin)).size>1){stop('Não somar dados efectivos e pressupostos projectados no mesmo registo global sem distinguir o cenário. Conservar as linhas e delimitar o âmbito.');continue;}
let prior:bigint|null=null;
if(input.priorMode==='none')prior=0n;
else if(input.priorMode==='manual'&&input.priorRef.trim())prior=travelDecimal(input.priorAmount);
else if(input.priorMode==='previous'){
const prev=results.find(x=>x.period===previousMonth(input.period)&&x.operatorRef===input.operatorRef&&x.status==='determined');if(prev?.carryForward!==null&&prev?.carryForward!==undefined)prior=travelDecimal(prev.carryForward);
}
if(prior===null){stop('Excesso negativo anterior por esclarecer: indicar inexistência, montante/referência ou reutilizar período imediatamente anterior determinado do mesmo operador.');continue;}
const existingPrevious=results.find(x=>x.period===previousMonth(input.period)&&x.operatorRef===input.operatorRef&&x.status==='determined');
if(input.priorMode!=='previous'&&existingPrevious?.carryForward!==null&&existingPrevious?.carryForward!==undefined&&travelDecimal(existingPrevious.carryForward)!==prior&&(input.priorMode!=='manual'||!input.priorRef.trim()||input.priorOverride!=='yes')){
stop('Excesso indicado '+money(prior)+' diverge do período anterior calculado '+existingPrevious.carryForward+'. A alteração muda os custos/base e o excesso seguinte; indique montante manual e referência da correcção e confirme a utilização, ou reutilize o anterior. Nada foi sobrescrito.');continue;
}
let gross=0n,costs=0n,excluded=0n;for(const{line}of selected){gross+=travelDecimal(line.specialGross!)!;costs+=travelDecimal(line.eligibleCosts!)!;excluded+=travelDecimal(line.excludedCosts!)!;}
const difference=gross-costs-prior,positive=difference>0n?difference:0n,baseWhole=(positive*100n+58000000n)/116000000n;
Object.assign(r,{status:'determined',grossReceipts:money(gross),directCosts:money(costs),excludedCosts:money(excluded),priorExcess:money(prior),grossDifference:money(difference),carryForward:money(difference<0n?-difference:0n),baseAmount:money(baseWhole*1000000n),baseDivisorRate:'16%',reason:'RIVA41(4)/(5),43a/b: soma global das parcelas especiais registadas no âmbito declarado, custos directos de terceiros e excesso anterior. Diferença positiva dividida por1.16, base arredondada à unidade; diferença negativa transportada como custo para o período seguinte, não dedução nem imposto a reembolsar. Taxa16% apenas no divisor da base; IVA devido e dedução43d não calculados. Alteração de custos/contraprestação44 exige versão referenciada, sem reescrever histórico ou gerar regularização automática.'});results.push(r);
}
return results;
}
function key(draft:Record<string,unknown>,book:TravelBook):string{return JSON.stringify({version:travelVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows,periods:book.periods});}
export function travelCurrent(draft:Record<string,unknown>,book:TravelBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordTravel(draft:Record<string,unknown>,book:TravelBook):TravelBook{
const costIds=book.rows.flatMap(r=>r.costs.map(c=>c.id));
if(!book.rows.length||new Set(book.rows.map(r=>r.id)).size!==book.rows.length||new Set(book.rows.map(r=>r.operatorRef+'|'+r.period+'|'+r.operationRef)).size!==book.rows.length||new Set(costIds).size!==costIds.length||new Set(book.periods.map(p=>p.id)).size!==book.periods.length||new Set(book.periods.map(p=>p.operatorRef+'|'+p.period)).size!==book.periods.length)throw new Error('Identidades de operações/custos/períodos devem ser distintas; evite dupla soma, originais conservados.');
const rows=book.rows.map(row=>evaluateTravel(row,draft.currency));const result:TravelCalculation={version:travelVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),sourceKey:key(draft,book),source:travelSource,inputs:structuredClone(book.rows),periodInputs:structuredClone(book.periods),rows,periods:evaluateTravelPeriods(book,rows)};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveTravelBook(draft,next);return next;
}
export function travelReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{try{const b=travelBook(draft),r=b.result;if(!r)return[];const state=`${r.opportunity};${travelCurrent(draft,b)?'Resultado actual':'Entradas alteradas; resultado histórico conservado'};versão${r.revision};${r.calculatedAt};${r.source}`;return[...r.inputs.map((row,i):[string,string,string,string]=>['IVA mensal',`P129 — ${row.period} — ${row.id}`,`${row.description};regime:${r.rows[i].regime};${r.rows[i].reason};contraprestação parte terceiros:${r.rows[i].specialGross??'Indeterminada'};parte geral:${r.rows[i].generalGross??'Indeterminada'};custos elegíveis:${r.rows[i].eligibleCosts??'Indeterminados'};custos excluídos:${r.rows[i].excludedCosts??'Indeterminados'};base apenas no período global`,`${state};${row.origin};operação${row.operationRef};operador${row.operatorRef};sede/estabelecimento${row.agencyCountry},${row.agencyRef};âmbito${row.scope};documento${row.documentRef},${row.documentDate};meios${row.resources};retalhista${row.retailer};novo conjunto${row.newPackage},${row.packageRef};preço comIVA${row.grossPrice}${row.currency};parte terceiros${row.thirdPartyGross},repartição${row.allocationRef};enquadramento${row.domesticTaxable},${row.taxRef};condições${JSON.stringify(row.conditions)};custos${JSON.stringify(row.costs)};factos${row.evidence}`]),...r.periods.map((p,i):[string,string,string,string]=>['IVA mensal',`P129 — margem global ${p.period} — ${p.operatorRef}`,`contraprestações:${p.grossReceipts??'Indeterminadas'};custos directos:${p.directCosts??'Indeterminados'};excesso anterior:${p.priorExcess??'Indeterminado'};diferença:${p.grossDifference??'Indeterminada'};base:${p.baseAmount??'Indeterminada'}MZN;excesso seguinte:${p.carryForward??'Indeterminado'};${p.reason};IVA/dedução:Indeterminados`,`${state};registo${JSON.stringify(r.periodInputs.find(x=>x.id===p.id)??r.periodInputs[i])};sem total organizacional presumido, nova dedução/campo11, regularização ou totaisModeloA.`])];}catch{return[['IVA mensal','P129','Dados não recuperáveis','Originais preservados; sem margem por defeito.']];}}
+64
View File
@@ -0,0 +1,64 @@
import {acquisitionScope,readAcquisitionStore} from './iva-acquisitions.ts';
export const valueReviewVersion='value-review-base/1';
export const valueReviewSource='CIVA republicado Lei13/2016,15(7),PDF14/p1426(272):para efeitos15(1),quando a contraprestação é inferior à resultante dos preços correntes ou normais de venda à porta da fábrica,por grosso ou a retalho,ou aos preços correntes/normais do serviço,tendo em conta a natureza das transmissões,a Administração Tributária pode proceder à correcção. Lei22/2022PDF3mantém15(7);Lei10/2025não altera15. Recorte2026/MZN;comparação não exerce o poder da AT,nem substitui automaticamente a contraprestação pelo valor de referência. Sem incidência,taxa,IVA,dedução/campo11,regularizações ou totaisModeloA.';
export const valueReviewTreatments=[{id:'price_comparison',label:'Comparar sem correcção automática'},{id:'referenced_correction',label:'Registar correcção referenciada / cenário condicionado'}] as const;
export const priceContexts=[{id:'factory',label:'Venda à porta da fábrica'},{id:'wholesale',label:'Venda por grosso'},{id:'retail',label:'Venda a retalho'},{id:'service',label:'Preço corrente ou normal do serviço'}] as const;
export const valueReviewConditions=[
['taxableOperation','A operação e a contraprestação para efeitos15(1)estão identificadas'],
['referenceCorresponds','O preço corrente ou normal e o contexto escolhido correspondem à natureza desta transmissão ou serviço,no período e âmbito identificados'],
['netComposition','Os montantes comparados têm composição equivalente,sem próprioIVA,com inclusões/exclusões aplicáveis15(5)/(6)consideradas'],
] as const;
type Choice=''|'yes'|'no';type Condition=typeof valueReviewConditions[number][0];
export type ValueReviewRow={id:string;treatment:string;priceContext:string;description:string;period:string;origin:'projected'|'effective';currency:string;operationRef:string;documentRef:string;documentDate:string;declaredAmount:string;referenceAmount:string;referenceRef:string;referenceScope:string;compositionRef:string;evidence:string;correctedAmount:string;correctionRef:string;correctionScope:string;correctionDate:string;correctionApplies:Choice;conditions:Partial<Record<Condition,Choice>>};
type LineResult={id:string;status:'determined'|'not_applicable'|'indeterminate';baseAmount:string|null;vat:null;rate:null;comparison:'below'|'not_below'|null;reason:string};
export type ValueReviewCalculation={version:string;revision:number;calculatedAt:string;opportunity:string;location:string;sourceKey:string;source:string;inputs:ValueReviewRow[];rows:LineResult[]};
export type ValueReviewBook={rows:ValueReviewRow[];result?:ValueReviewCalculation;history?:ValueReviewCalculation[]};
type Store=ReturnType<typeof readAcquisitionStore>&{valueReviews?:Record<string,ValueReviewBook>};
export function newValueReview(id:string,currency:string):ValueReviewRow{return{id,treatment:'',priceContext:'',description:'',period:'',origin:'projected',currency,operationRef:'',documentRef:'',documentDate:'',declaredAmount:'',referenceAmount:'',referenceRef:'',referenceScope:'',compositionRef:'',evidence:'',correctedAmount:'',correctionRef:'',correctionScope:'',correctionDate:'',correctionApplies:'',conditions:{}};}
export function switchValueReview(row:ValueReviewRow,treatment:string):ValueReviewRow{return{...row,treatment,correctionApplies:''};}
export function switchPriceContext(row:ValueReviewRow,priceContext:string):ValueReviewRow{return{...row,priceContext,conditions:{...row.conditions,referenceCorresponds:''},correctionApplies:''};}
export function switchValueOrigin(row:ValueReviewRow,origin:ValueReviewRow['origin']):ValueReviewRow{return{...row,origin,correctionApplies:''};}
function readStore(draft:Record<string,unknown>):Store{
const store=readAcquisitionStore(draft.modelo_a_snapshot) as Store;
if(store.valueReviews!==undefined&&(!store.valueReviews||typeof store.valueReviews!=='object'||Array.isArray(store.valueReviews)))throw new Error('Bases de contraprestação não recuperáveis;originais preservados.');
const fields=Object.keys(newValueReview('','')).filter(key=>key!=='conditions');
for(const book of Object.values(store.valueReviews??{}))if(!book||!Array.isArray(book.rows)||(book.history!==undefined&&!Array.isArray(book.history))||book.rows.some(row=>!row||fields.some(key=>typeof row[key as keyof ValueReviewRow]!=='string')||!row.conditions||typeof row.conditions!=='object'||Array.isArray(row.conditions)))throw new Error('Linhas de contraprestação não recuperáveis;originais preservados,sem substituição por lista vazia.');
return store;
}
export function valueReviewBook(draft:Record<string,unknown>):ValueReviewBook{return readStore(draft).valueReviews?.[acquisitionScope(draft)]??{rows:[]};}
export function saveValueReviewBook(draft:Record<string,unknown>,book:ValueReviewBook):string{const current=readStore(draft),encoded=JSON.stringify({...current,valueReviews:{...current.valueReviews,[acquisitionScope(draft)]:book}});readStore({...draft,modelo_a_snapshot:encoded});return encoded;}
function decimal(raw:unknown):bigint|null{if(typeof raw!=='string'||!/^\d{1,15}(\.\d{1,6})?$/.test(raw.trim()))return null;const[whole,fraction='']=raw.trim().split('.');return BigInt(whole)*1000000n+BigInt(fraction.padEnd(6,'0'));}
function money(n:bigint):string{return`${n/1000000n}.${(n%1000000n).toString().padStart(6,'0').replace(/0+$/,'').padEnd(2,'0')}`;}
function validDate(value:string):boolean{const d=new Date(value+'T00:00:00Z');return /^\d{4}-\d{2}-\d{2}$/.test(value)&&Number.isFinite(d.getTime())&&d.toISOString().slice(0,10)===value;}
export function evaluateValueReview(row:ValueReviewRow,currency:unknown):LineResult{
const result:LineResult={id:row.id,status:'indeterminate',baseAmount:null,vat:null,rate:null,comparison:null,reason:''};const stop=(reason:string,status:LineResult['status']='indeterminate')=>({...result,status,reason});
if(!valueReviewTreatments.some(item=>item.id===row.treatment)||!priceContexts.some(item=>item.id===row.priceContext))return stop('Identifique o percurso e o contexto do preço de referência;desconhecido não permite presumir correcção.');
if(currency!=='MZN'||row.currency!==currency)return stop('Moeda fora do âmbito MZN ou divergente do projecto;sem conversão silenciosa.');
if(!/^2026-(0[1-9]|1[0-2])$/.test(row.period)||!['projected','effective'].includes(row.origin))return stop('Indique mês em2026 e dados efectivos declarados ou pressupostos expressos de projecção.');
const failed=valueReviewConditions.filter(([key])=>row.conditions[key]==='no');if(failed.length)return stop('Não se aplica esta comparação: '+failed.map(([,label])=>label).join('; ')+'. Não é isenção nem IVA zero.','not_applicable');
if(valueReviewConditions.some(([key])=>row.conditions[key]!=='yes'))return stop('Confirme as condições próprias da comparação;desconhecido não é zero,não aplicável ou correcção.');
if(!row.description.trim()||!row.operationRef.trim()||!row.documentRef.trim()||!validDate(row.documentDate)||!row.referenceRef.trim()||!row.referenceScope.trim()||!row.compositionRef.trim()||!row.evidence.trim())return stop('Identifique operação,documento/data,preço corrente/normal,referência/âmbito e composição,ou pressupostos expressos;sem avaliação automática/certificado/aprovador novo.');
const declared=decimal(row.declaredAmount),reference=decimal(row.referenceAmount);if(declared===null||reference===null)return stop('Indique contraprestação e preço de referência comparáveis;valor desconhecido ou inválido não é zero.');
result.comparison=declared<reference?'below':'not_below';
const comparison=declared<reference?`Contraprestação ${money(declared)} inferior à referência ${money(reference)} por ${money(reference-declared)}MZN;AT pode proceder à correcção,sem automatismo.`:`Contraprestação ${money(declared)} não inferior à referência ${money(reference)}MZN;não se demonstra este pressuposto15(7).`;
if(row.treatment==='price_comparison')return{...result,status:'determined',baseAmount:money(declared),reason:comparison+' Contraprestação declarada conservada como base neste recorte,sem correcção pelo portal;IVA/taxa,dedução/campo11,regularizações e totaisModeloA não determinados.'};
if(declared>=reference)return stop(comparison+' A correcção deste percurso15(7)não é aplicada. Registo e referências conservados.','not_applicable');
if(row.correctionApplies==='no')return stop(comparison+' A correcção referenciada não abrange esta operação/período/condições;sem aplicação automática.','not_applicable');
if(row.correctionApplies!=='yes'||!row.correctionRef.trim()||!row.correctionScope.trim()||!validDate(row.correctionDate))return stop(comparison+' Identifique referência,data e âmbito da correcção AT aplicável ou pressuposto expresso do cenário condicionado;comparar não substitui uma correcção.');
const corrected=decimal(row.correctedAmount);if(corrected===null)return stop(comparison+' Indique o montante da correcção referenciada ou pressuposto condicionado;sem usar automaticamente o maior valor ou a referência.');
return{...result,status:'determined',baseAmount:money(corrected),reason:comparison+` ${row.origin==='projected'?'Cenário condicionado à correcção expressamente assumida,não decisão AT concedida':'Correcção AT nos dados efectivos declarados,com referência/data/âmbito identificados'}:base ${money(corrected)}MZN. Montante da referência não substituído automaticamente. Sem IVA/taxa,dedução/campo11,regularizações ou totaisModeloA.`};
}
function key(draft:Record<string,unknown>,book:ValueReviewBook):string{return JSON.stringify({version:valueReviewVersion,scope:acquisitionScope(draft),location:draft.selection_labels??{},currency:draft.currency,rows:book.rows});}
export function valueReviewCurrent(draft:Record<string,unknown>,book:ValueReviewBook):boolean{return!!book.result&&book.result.sourceKey===key(draft,book);}
export function recordValueReviews(draft:Record<string,unknown>,book:ValueReviewBook):ValueReviewBook{
if(!book.rows.length||new Set(book.rows.map(row=>row.id)).size!==book.rows.length)throw new Error('Indique operações com identificadores distintos;originais conservados.');
const result:ValueReviewCalculation={version:valueReviewVersion,revision:(book.result?.revision??0)+1,calculatedAt:new Date().toISOString(),opportunity:acquisitionScope(draft),location:JSON.stringify(draft.selection_labels??{}),sourceKey:key(draft,book),source:valueReviewSource,inputs:structuredClone(book.rows),rows:book.rows.map(row=>evaluateValueReview(row,draft.currency))};
const next={...book,result,history:[...(book.history??[]),...(book.result?[book.result]:[])]};saveValueReviewBook(draft,next);return next;
}
export function valueReviewReportRows(draft:Record<string,unknown>):Array<[string,string,string,string]>{
try{const book=valueReviewBook(draft),result=book.result;if(!result)return[];return result.inputs.map((row,index)=>['IVA mensal',`Base P103 — ${row.period} — ${row.id}`,`${row.description};base tributável: ${result.rows[index].baseAmount??'Indeterminada'} ${row.currency};IVA: Indeterminado;${result.rows[index].reason}`,`${result.opportunity};${result.location};${valueReviewCurrent(draft,book)?'Resultado actual':'Entradas alteradas;resultado histórico conservado'};versão${result.revision};${result.calculatedAt};${result.source};${row.origin==='projected'?'Projecção':'Dados efectivos declarados'};${valueReviewTreatments.find(t=>t.id===row.treatment)?.label??'Percurso por indicar'};contexto ${priceContexts.find(t=>t.id===row.priceContext)?.label??'Por indicar'};operação ${row.operationRef};contraprestação ${row.declaredAmount};preço referência ${row.referenceAmount},${row.referenceRef};âmbito ${row.referenceScope};${row.treatment==='referenced_correction'?`correcção ${row.correctedAmount},referência ${row.correctionRef},data ${row.correctionDate},âmbito ${row.correctionScope},aplica:${row.correctionApplies==='yes'?'Sim':row.correctionApplies==='no'?'Não':'Por indicar'}`:'Sem correcção automática'};composição ${row.compositionRef};documento ${row.documentRef},${row.documentDate};condições ${valueReviewConditions.map(([key,label])=>label+': '+(row.conditions[key]==='yes'?'Sim':row.conditions[key]==='no'?'Não':'Por indicar')).join('; ')};fundamento ${row.evidence};não preenche totaisModeloA ou campo11.`]);}
catch{return[['IVA mensal','Comparação/correcção da contraprestação','Dados não recuperáveis','Originais preservados;sem substituir por zero.']];}
}
+27
View File
@@ -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=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[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)]];}}
+15 -4
View File
@@ -17,7 +17,9 @@ export function defaultCashflowDraftInputs() {
}
export type CashflowDraftSnapshot = {
version: 1;
version: 1 | 2;
/** Missing in legacy v1: never infer it from the current project. */
currency?: string | null;
taxMode: 'fixed' | 'schedule';
inputs: ReturnType<typeof defaultCashflowDraftInputs>;
};
@@ -31,7 +33,8 @@ export function restoreCashflowDraftSnapshot(
const parsed = JSON.parse(snapshot);
if (
!parsed ||
parsed.version !== 1 ||
![1, 2].includes(parsed.version) ||
(parsed.version === 2 && parsed.currency !== null && (typeof parsed.currency !== 'string' || !/^[A-Z]{3}$/.test(parsed.currency))) ||
!['fixed', 'schedule'].includes(parsed.taxMode) ||
!parsed.inputs ||
typeof parsed.inputs !== 'object' ||
@@ -55,7 +58,7 @@ export function restoreCashflowDraftSnapshot(
} else if (typeof value !== 'string' || value.length > 160)
return null;
}
return { version: 1, taxMode: parsed.taxMode, inputs: parsed.inputs };
return { version: parsed.version, ...(parsed.version === 2 ? {currency: parsed.currency} : {}), taxMode: parsed.taxMode, inputs: parsed.inputs };
} catch {
return null;
}
@@ -64,8 +67,16 @@ export function restoreCashflowDraftSnapshot(
export function serializeCashflowDraftSnapshot(
taxMode: CashflowDraftSnapshot['taxMode'],
inputs: CashflowDraftSnapshot['inputs'],
currency?: string | null,
): string {
return JSON.stringify({ version: 1, taxMode, inputs });
return JSON.stringify({ version: currency === undefined ? 1 : 2, ...(currency !== undefined ? {currency} : {}), taxMode, inputs });
}
export function cashflowCurrency(saved: CashflowDraftSnapshot, projectCurrency: string): {currency: string; matchesProject: boolean; notice: string} {
const currency = saved.version === 2 ? saved.currency : null;
if (!currency) throw new Error('A moeda de origem da tesouraria guardada está por confirmar. Os montantes foram preservados; confirme a moeda na ferramenta de tesouraria antes de calcular ou reutilizar as vendas.');
const matchesProject = currency === projectCurrency;
return {currency, matchesProject, notice: matchesProject ? '' : `A tesouraria foi guardada em ${currency}, mas o projecto está em ${projectCurrency || 'moeda por indicar'}. Os montantes continuam em ${currency}; não foram convertidos nem reinterpretados. Para os reutilizar no projecto, restaure explicitamente a moeda de origem. Uma projecção noutra moeda exige pressupostos próprios.`};
}
export type MonthlyCashflowInput = {
+10 -1
View File
@@ -1,5 +1,5 @@
import { monthlyProjectedSales, restoreBusinessPlanSnapshot } from './business-financial-plan.ts';
import { restoreCashflowDraftSnapshot } from './monthly-cashflow.ts';
import { cashflowCurrency, restoreCashflowDraftSnapshot } from './monthly-cashflow.ts';
import { isApiSimulationReadResponseV1, type ApiSimulationExecutionV1 } from './simulation-contract.ts';
export type MonthlyIvaInput = {
@@ -27,6 +27,8 @@ export function monthlySalesFromDraft(draft: Record<string, unknown>): { amounts
if (draft.cashflow_snapshot) {
const saved = restoreCashflowDraftSnapshot(String(draft.cashflow_snapshot));
if (!saved) throw new Error('Não foi possível recuperar a receita projectada.');
const origin = cashflowCurrency(saved, String(draft.currency ?? ''));
if (!origin.matchesProject) throw new Error(origin.notice);
return {amounts: Array.from({length: 12}, () => saved.inputs.monthlyRevenue.trim() === '' ? null : saved.inputs.monthlyRevenue), source: 'Receita mensal constante já declarada na projecção de tesouraria; confirme que corresponde a vendas tributáveis.'};
}
return {amounts: Array.from({length: 12}, () => null), source: 'Sem projecção de vendas guardada. Prepare as vendas no plano empresarial; não é necessário voltar a introduzi-las aqui.'};
@@ -48,4 +50,11 @@ export function readMonthlyIvaRecord(raw?: string): MonthlyIvaRecord | null {
} catch { /* Keep the stored value intact; no fallback fiscal result. */ }
return null;
}
/** Read an admitted execution through the existing ownership-protected endpoint; never create one. */
export async function recoverMonthlyIvaRecord(record: MonthlyIvaRecord, request: typeof fetch = fetch): Promise<MonthlyIvaRecord> {
const response = await request(`/api/v1/simulations/${encodeURIComponent(record.execution.id)}`, {credentials:'same-origin', headers:{Accept:'application/json'}});
const value: unknown = await response.json();
if (!response.ok || !isApiSimulationReadResponseV1(value) || value.data.id !== record.execution.id) throw new Error('Não foi possível recuperar a execução mensal guardada. Os dados foram preservados e não foi criada uma execução alternativa.');
return {input: record.input, execution: value.data};
}
export const monthlyIvaCashTreatment = 'IVA apresentado separadamente: não é somado novamente aos recebimentos declarados nem deduzido como custo ou imposto final a pagar. A tesouraria conserva os recebimentos e pagamentos introduzidos, antes de uma liquidação fiscal não apurada; não se presume cobrança integral das vendas no mesmo mês.';
@@ -1,5 +1,6 @@
import { displayValue } from './display-value.ts';
import { fiscalQaRows } from './fiscal-qa-preview.ts';
import { pathStates } from './investor-path.ts';
import {
buildProjectDossierRows,
type ProjectDossierRow,
@@ -174,6 +175,9 @@ const rowSection: Record<string, DossierReportSectionId> = {
Orçamento: 'finance',
Tesouraria: 'finance',
'IVA mensal': 'finance',
ISPC: 'finance',
'IRPC — retenções': 'finance',
'IRPC normal — L6': 'finance',
Equipa: 'team',
'Necessidade de negócio': 'resources',
Financiamento: 'resources',
@@ -284,6 +288,18 @@ function makeSections(
);
if (context.version === 1) {
const section = sections.get('sources');
if (context.portfolio_origin) section?.rows.push({field:'Projecto ou carteira de origem', value:context.portfolio_origin.title, origin:`${context.portfolio_origin.key}; versão ${context.portfolio_origin.version}; ${context.portfolio_origin.href}`, classification:'Origem documental; localização e oferta não presumidas'});
if (context.consumer_opportunity) section?.rows.push({field:'Oportunidade em tratamento', value:context.consumer_opportunity, origin:context.opportunity_choices?.[0]?.opportunity?.title ?? 'Escolha guardada no dossier', classification:'Âmbito desta análise'});
for (const step of context.path?.steps ?? []) {
if (step.applicability === 'not_needed_for_preparation') section?.paragraphs.push(`${step.code} — preparação não necessária neste âmbito: ${step.reason || 'Decisão guardada do promotor'}. Histórico conservado; não constitui dispensa legal.`);
else section?.rows.push({field:`Etapa ${step.code}: ${step.title}`,value:step.applicability === 'undetermined' ? 'Aplicabilidade por determinar' : pathStates[step.state] ?? 'Estado por determinar',origin:context.consumer_opportunity ?? 'Contexto comum do dossier',classification:'Preparação no âmbito seleccionado'});
}
const dispensed = new Set((context.path?.steps ?? []).filter((step: {applicability:string})=>step.applicability === 'not_needed_for_preparation').map((step: {code:string})=>step.code));
const requirementStates: Record<string,string> = {selected:'Localização escolhida; direito não inferido',missing:'Informação em falta',conditional:'Conforme as condições do projecto',declared:'Actividades declaradas; enquadrar modalidade',undetermined:'Procedimento por determinar'};
for (const requirement of context.requirements_assessment?.requirements ?? []) {
if (requirement.opportunity_key !== context.consumer_opportunity || dispensed.has(requirement.step)) continue;
section?.rows.push({field:`Requisito: ${requirement.title}`,value:`${requirementStates[requirement.state] ?? 'Por determinar'}. ${(requirement.documents ?? []).join('; ')}`,origin:`${requirement.opportunity_title}; ${requirement.opportunity_key}; ${requirement.basis ?? ''} ${requirement.source_url ?? ''}`,classification:'Preparação específica; não constitui licença ou aprovação'});
}
const zone = context.zone;
section?.rows.push({
field: 'Contexto do investimento',
+98 -2
View File
@@ -1,12 +1,56 @@
import {normalReportRows} from './irpc-normal.ts';
import {irpcReportRows} from './irpc-withholdings.ts';
import {ispcResidualReportRows} from './ispc-residuals.ts';
import {ispcWithholdingReportRows} from './ispc-withholding.ts';
import {ispcQuarterReportRows} from './ispc-quarter.ts';
import {ispcEligibilityReportRows} from './ispc-eligibility.ts';
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';
import { minerReportRows } from './iva-miners.ts';
import { returneeReportRows } from './iva-returnees.ts';
import { travelReportRows } from './iva-travel.ts';
import { travelEventReportRows } from './iva-travel-events.ts';
import { foreignOperationReportRows } from './iva-foreign-operations.ts';
import { currencyEventReportRows } from './iva-currency-events.ts';
import { propertyTransferReportRows } from './iva-property-transfers.ts';
import { goodsPresumptionReportRows } from './iva-goods-presumptions.ts';
import { displayValue } from './display-value.ts';
import { investmentFieldOrigin } from './context-inheritance.ts';
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 {substitutionReportRows} from './iva-substitution.ts';
import {refundReportRows} from './iva-refund.ts';
import {beverageRestitutionReportRows} from './iva-beverage-restitution.ts';
import { importExemptionReportRows } from './iva-import-exemptions.ts';
import { publicBaseReportRows } from './iva-public-authority-base.ts';
import { commissionBaseReportRows } from './iva-commission-base.ts';
import { actSaleReportRows } from './iva-act-sale-base.ts';
import { fuelBaseReportRows } from './iva-fuel-base.ts';
import { noncashBaseReportRows } from './iva-noncash-base.ts';
import { compositionReportRows } from './iva-composition-base.ts';
import { exclusionReportRows } from './iva-exclusion-base.ts';
import { valueReviewReportRows } from './iva-value-review.ts';
import { serviceNormalReportRows } from './iva-service-normal.ts';
import { goodsLocationReportRows } from './iva-goods-location.ts';
import { serviceLocationReportRows } from './iva-service-location.ts';
import { listedServiceReportRows } from './iva-listed-services.ts';
import { reducedBaseReportRows } from './iva-reduced-bases.ts';
import { ownNameReportRows } from './iva-own-name.ts';
import { goodsAllocationReportRows } from './iva-goods-allocation.ts';
import { secondhandReportRows } from './iva-secondhand.ts';
import { offerPreparationReportRows } from './iva-offer-preparations.ts';
import { salesReportRows } from './iva-operations.ts';
import { fiscalQaRows } from './fiscal-qa-preview.ts';
import { csvCellWithDelimiter } from './csv.js';
import {
restoreCashflowDraftSnapshot,
cashflowCurrency,
projectMonthlyCashflow,
} from './monthly-cashflow.ts';
import {
@@ -613,12 +657,56 @@ export function buildProjectDossierRows(
'Planeado/realizado declarado pelo utilizador',
]);
}
rows.push(...acquisitionReportRows(draft));
rows.push(...closureReportRows(draft));
rows.push(...substitutionReportRows(draft));
rows.push(...refundReportRows(draft));
rows.push(...beverageRestitutionReportRows(draft));
rows.push(...importExemptionReportRows(draft));
rows.push(...publicBaseReportRows(draft));
rows.push(...commissionBaseReportRows(draft));
rows.push(...actSaleReportRows(draft));
rows.push(...fuelBaseReportRows(draft));
rows.push(...noncashBaseReportRows(draft));
rows.push(...compositionReportRows(draft));
rows.push(...exclusionReportRows(draft));
rows.push(...valueReviewReportRows(draft));
rows.push(...serviceNormalReportRows(draft));
rows.push(...goodsLocationReportRows(draft));
rows.push(...serviceLocationReportRows(draft));
rows.push(...listedServiceReportRows(draft));
rows.push(...reducedBaseReportRows(draft));
rows.push(...ownNameReportRows(draft));
rows.push(...goodsAllocationReportRows(draft));
rows.push(...secondhandReportRows(draft));
rows.push(...goodsPresumptionReportRows(draft));
rows.push(...propertyTransferReportRows(draft));
rows.push(...currencyEventReportRows(draft));
rows.push(...foreignOperationReportRows(draft));
rows.push(...digitalReportRows(draft));
rows.push(...objectiveImportReportRows(draft));
rows.push(...minerReportRows(draft));
rows.push(...remissionReportRows(draft));
rows.push(...returneeReportRows(draft));
rows.push(...travelReportRows(draft));
rows.push(...travelEventReportRows(draft));
rows.push(...offerPreparationReportRows(draft));
rows.push(...ispcEligibilityReportRows(draft));
rows.push(...ispcQuarterReportRows(draft));
rows.push(...ispcWithholdingReportRows(draft));
rows.push(...ispcResidualReportRows(draft));
rows.push(...irpcReportRows(draft));
rows.push(...normalReportRows(draft));
rows.push(...fiscalCalculationGapReportRows(draft));
rows.push(...l3FormPreparationReportRows(draft));
const operationRows = salesReportRows(draft);
rows.push(...operationRows);
if (draft.monthly_iva_snapshot) {
const saved = readMonthlyIvaRecord(String(draft.monthly_iva_snapshot));
let current = false;
try { current = !!saved && monthlyIvaKey(monthlyIvaInput(draft, readMonthlyIvaSettings(String(draft.monthly_iva_settings ?? '')))) === monthlyIvaKey(saved.input); } catch { /* An old fiscal version is never silently made current. */ }
rows.push(['IVA mensal', 'Estado da versão', current ? 'Entradas correspondentes à projecção guardada' : 'Histórico desactualizado face às vendas ou pressupostos actuais; não aplicar como resultado actual', 'Execução versionada no servidor; sem apuramento final']);
if (saved?.execution.result_snapshot) for (const [label,value] of fiscalQaRows(saved.execution.result_snapshot)) rows.push(['IVA mensal', label, value, 'Snapshot fiscal preservado; sem recálculo na exportação']);
if (saved?.execution.result_snapshot) for (const [label,value] of fiscalQaRows(saved.execution.result_snapshot)) rows.push(['IVA mensal', operationRows.length ? `Execução geral separada — ${label}` : label, value, operationRows.length ? 'Snapshot geral conservado como execução separada; não somar nem substituir a classificação por operação L1. Sem recálculo na exportação.' : 'Snapshot fiscal preservado; sem recálculo na exportação']);
else rows.push(['IVA mensal', 'Resultado', 'Indeterminado ou execução ainda não concluída', 'Sem substituição por zero']);
try {
for (const purchase of modeloAPurchaseReferences(draft)) rows.push(['IVA mensal', `Compras/encomendas — mês ${purchase.month}`, purchase.declared ?? 'Sem informação', 'Pressuposto actual do plano, não resultado fiscal histórico; base/IVA incluído por classificar; IVA suportado e dedutível indeterminados; não é data de factura ou pagamento']);
@@ -637,7 +725,9 @@ export function buildProjectDossierRows(
throw new Error(
'Pressupostos de tesouraria não recuperáveis; não foram substituídos por valores alternativos.',
);
const currency = String(draft.currency ?? '');
const originCurrency = cashflowCurrency(saved, String(draft.currency ?? ''));
const currency = originCurrency.currency;
if (originCurrency.notice) rows.push(['Tesouraria', 'Divergência de moeda', originCurrency.notice, 'Moeda original preservada; sem conversão']);
if (!currency)
throw new Error(
'Indique uma moeda para interpretar os montantes de tesouraria.',
@@ -691,10 +781,16 @@ export function buildProjectDossierRows(
if (draft.context_applicability_snapshot) {
try {
const context = JSON.parse(String(draft.context_applicability_snapshot));
if (context.version === 1 && Array.isArray(context.complements)) for (const item of context.complements) {
if (typeof item?.title !== 'string' || typeof item?.origin?.title !== 'string') continue;
rows.push(['Localização', 'Complemento escolhido', item.title, `Origem: ${item.origin.title}; ${item.kind === 'need' ? 'necessidade complementar em preparação' : item.kind === 'service' ? 'serviço/instrumento' : 'oportunidade cadastrada'}`]);
if (typeof item.target?.title === 'string') rows.push(['Localização', 'Ficha complementar', item.target.title, item.target.href ?? 'Referência guardada']);
}
if (context.version === 1 && Array.isArray(context.opportunity_choices)) for (const choice of context.opportunity_choices) {
if (typeof choice?.opportunity?.title !== 'string') continue;
rows.push(['Localização', 'Oportunidade escolhida', choice.opportunity.title, 'Referência escolhida no mesmo dossier']);
rows.push(['Localização', 'Localização da oportunidade', typeof choice.territory?.title === 'string' ? choice.territory.title : 'Por definir', choice.opportunity.title]);
rows.push(['Localização', 'Zona/parque da oportunidade', typeof choice.park?.title === 'string' ? choice.park.title : 'Sem selecção', choice.opportunity.title+'; '+choice.opportunity.key]);
if (Array.isArray(choice.portfolio_origins)) for (const origin of choice.portfolio_origins) {
if (typeof origin?.title !== 'string') continue;
rows.push(['Localização', 'Associação escolhida na carteira', origin.title, choice.opportunity.title+'; referência documental consultada, sem inferir implantação ou benefícios']);
+21
View File
@@ -1,8 +1,29 @@
const levels = ['province_id', 'district_id', 'admin_post_id', 'locality_id'];
const searchRoutes = ['/carteira', '/oportunidades', '/zonas', '/educacao'];
/** Keep search geography explicit; a documentary origin is never an invented offer. */
export function portfolioPreparationHref(id: string, pageUrl: string): string {
const source = new URL(pageUrl, 'https://portal.invalid');
const inherited = source.searchParams.has('catalogue_query') ? new URLSearchParams(source.searchParams.get('catalogue_query')!) : source.searchParams;
const query = new URLSearchParams({source: `portfolio:${id}`});
for (const field of levels) if (inherited.get(field)) query.set(field, inherited.get(field)!);
return '/investimentos/iniciar?' + query.toString();
}
/** Preserve an explicit complementary selection while consulting its canonical public fiche. */
export function complementPreparationHref(pageUrl: string, target?: string): string | null {
const params = new URL(pageUrl, 'https://portal.invalid').searchParams;
if (!params.get('complement_origin') || !params.get('complement_code') || (target && params.get('complement_target') !== target)) return null;
const query = new URLSearchParams();
for (const field of ['complement_origin', 'complement_code', 'complement_target', 'complement_territory', 'selection_key']) if(params.get(field)) query.set(field,params.get(field)!);
const dossier = params.get('investment_dossier');
return (dossier && /^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i.test(dossier) ? `/investimentos/${dossier}/contexto/editar` : '/investimentos/iniciar')+'?'+query;
}
/** Carry the explicitly consulted portfolio origin and search geography into the existing preparation entry. */
export function investmentPreparationHref(opportunity: number, pageUrl: string, origin?: string | null): string {
const complementary = complementPreparationHref(pageUrl, `opportunity:${opportunity}`);
if (complementary) return complementary;
const source = new URL(pageUrl, 'https://portal.invalid');
const inherited = source.searchParams.has('catalogue_query') ? new URLSearchParams(source.searchParams.get('catalogue_query')!) : source.searchParams;
const query = new URLSearchParams({source: `opportunity:${opportunity}`});