feat(iva): prepare P101 consideration composition without doublecounting in QA

This commit is contained in:
2026-10-24 22:49:56 +02:00
parent 0bef805ede
commit e3caf55361
8 changed files with 204 additions and 0 deletions
@@ -0,0 +1,34 @@
import {useState} from 'react';
import {newCompositionBase,newCompositionPart,switchCompositionPart,compositionBook,compositionConditions,compositionCurrent,compositionReportRows,compositionBaseSource,compositionTreatments,recordCompositions,saveCompositionBook,type CompositionBook,type CompositionRow,type CompositionPart} from '@/lib/iva-composition-base';
export function SimulationCompositionBase({draft,onChange}:{draft:Record<string,unknown>;onChange:(field:string,value:string)=>void}){
const[error,setError]=useState('');let book:CompositionBook;
try{book=compositionBook(draft);}catch(cause){return<p role="alert">{String(cause)}</p>;}
const save=(next:CompositionBook)=>{try{onChange('modelo_a_snapshot',saveCompositionBook(draft,next));setError('');}catch(cause){setError(String(cause));}};
const change=(id:string,patch:Partial<CompositionRow>)=>save({...book,rows:book.rows.map(row=>row.id===id?{...row,...patch}:row)});
return<details className="space-y-3 rounded border p-3">
<summary>Base tributável — impostos e despesas acessórias da contraprestação</summary>
<p>Oportunidade: {String(draft.context_opportunity||'entrada geral')}. Prepare uma composição por operação. Parta do montante sem próprio IVA e com as exclusões aplicáveis já consideradas. Identifique as parcelas e se já estão incluídas;acrescente apenas as que ainda não constam do montante inicial.</p>
<p>Impostos,direitos,taxas e outras imposições excluem o próprio IVA. Nas despesas acessórias,confirme que são debitadas por conta do cliente e relativas a comissões,embalagem,transporte ou seguros. Respeite as regras especiais da operação,incluindo a exclusão da TC nos combustíveis. Base e IVA são resultados distintos.</p>
<p>{compositionBaseSource}</p>{error&&<p role="alert">{error}</p>}
<button type="button" className="underline" onClick={()=>save({...book,rows:[...book.rows,newCompositionBase(crypto.randomUUID(),String(draft.currency??''))]})}>Acrescentar composição de operação</button>
{book.rows.map(row=>{const partChange=(id:string,patch:Partial<CompositionPart>)=>change(row.id,{parts:row.parts.map(p=>p.id===id?{...p,...patch}:p)});return<details key={row.id} className="rounded border p-3"><summary>{row.description||'Operação por identificar'} — {row.period||'mês por indicar'}</summary>
<div className="grid gap-3 md:grid-cols-2">
<label>Natureza dos dados<select className="block rounded border p-2" value={row.origin} onChange={e=>change(row.id,{origin:e.target.value as CompositionRow['origin']})}><option value="projected">Projectados / pressupostos</option><option value="effective">Efectivos declarados</option></select></label>
{([['description','Operação identificada'],['operationRef','Referência da operação / pressuposto'],['initialAmount','Montante inicial sem próprio IVA (moeda indicada)'],['initialRef','Referência do montante inicial e da sua composição'],['documentRef','Documento da operação / referência da previsão'],['documentDate','Data do documento / prevista'],['period','Mês da operação'],['currency','Moeda de origem'],['compositionRef','Referência da composição e exclusões aplicáveis'],['evidence','Fundamento factual / pressupostos']] as const).map(([field,label])=><label key={field}>{label}<input className="block rounded border p-2" type={field==='documentDate'?'date':field==='period'?'month':'text'} value={row[field]} onChange={e=>change(row.id,{[field]:e.target.value})}/></label>)}
</div>
<fieldset><legend>Condições da composição</legend>{compositionConditions.map(([key,label])=><label className="block" key={key}>{label}<select className="block rounded border p-2" value={row.conditions[key]??''} onChange={e=>change(row.id,{conditions:{...row.conditions,[key]:e.target.value}})}><option value="">Por indicar</option><option value="yes">Sim</option><option value="no">Não</option></select></label>)}</fieldset>
<button type="button" className="underline" onClick={()=>change(row.id,{parts:[...row.parts,newCompositionPart(crypto.randomUUID())]})}>Acrescentar parcela desta operação</button>
{row.parts.map(part=><fieldset key={part.id} className="rounded border p-3"><legend>{part.description||'Parcela por identificar'}</legend>
<label>Natureza da parcela<select className="block rounded border p-2" value={part.treatment} onChange={e=>partChange(part.id,switchCompositionPart(part,e.target.value))}><option value="">Por indicar</option>{compositionTreatments.map(t=><option key={t.id} value={t.id}>{t.label}</option>)}</select></label>
{([['description','Descrição da parcela'],['amount','Montante da parcela sem próprio IVA (moeda indicada)'],['reference','Referência da parcela / pressuposto']] as const).map(([field,label])=><label className="block" key={field}>{label}<input className="block rounded border p-2" value={part[field]} onChange={e=>partChange(part.id,{[field]:e.target.value})}/></label>)}
<label>Esta parcela já está incluída no montante inicial?<select className="block rounded border p-2" value={part.included} onChange={e=>partChange(part.id,{included:e.target.value as CompositionPart['included']})}><option value="">Por indicar</option><option value="yes">Sim — conservar sem somar novamente</option><option value="no">Não — acrescentar uma vez</option></select></label>
{part.treatment&&<label>{part.treatment==='tax_component'?'É imposto,direito,taxa ou outra imposição que integra esta contraprestação nos termos15(5)(a)?':'É despesa acessória debitada por conta do cliente,relativa a comissões,embalagem,transporte ou seguros nos termos15(5)(b)?'}<select className="block rounded border p-2" value={part.natureConfirmed} onChange={e=>partChange(part.id,{natureConfirmed:e.target.value as CompositionPart['natureConfirmed']})}><option value="">Por indicar</option><option value="yes">Sim</option><option value="no">Não</option></select></label>}
<label>A parcela exclui o próprio IVA?<select className="block rounded border p-2" value={part.ownVatExcluded} onChange={e=>partChange(part.id,{ownVatExcluded:e.target.value as CompositionPart['ownVatExcluded']})}><option value="">Por indicar</option><option value="yes">Sim</option><option value="no">Não</option></select></label>
<p>Mudar a natureza conserva os montantes e referências,mas exige rever a correspondência da parcela. Cada parcela será considerada uma única vez nesta operação.</p>
</fieldset>)}
</details>;})}
{!!book.rows.length&&<button type="button" className="rounded bg-emerald-800 p-2 text-white" onClick={()=>{try{save(recordCompositions(draft,book));}catch(cause){setError(String(cause));}}}>Compor bases e guardar versão</button>}
{book.result&&<><p role="status">{compositionCurrent(draft,book)?'Composições correspondentes às entradas guardadas.':'Entradas alteradas;composições históricas conservadas. Reveja e determine novamente.'} {book.history?.length??0} versões anteriores. IVA e campo11 não são preenchidos por estas bases.</p><dl>{compositionReportRows(draft).map(([,label,value,origin],index)=><div key={index}><dt className="font-semibold">{label}</dt><dd>{value}<small className="block">{origin}</small></dd></div>)}</dl></>}
</details>;
}
@@ -11,6 +11,7 @@ import { SimulationCommissionBase } from './simulation-commission-base';
import { SimulationActSaleBase } from './simulation-act-sale-base';
import { SimulationFuelBase } from './simulation-fuel-base';
import { SimulationNoncashBase } from './simulation-noncash-base';
import { SimulationCompositionBase } from './simulation-composition-base';
import { SimulationOfferPreparations } from './simulation-offer-preparations';
import { SimulationOperations } from './simulation-operations';
@@ -100,6 +101,7 @@ export function SimulationMonthlyIva({draft, busy, onCalculate, onChange}: {
<SimulationActSaleBase draft={draft} onChange={onChange} />
<SimulationFuelBase draft={draft} onChange={onChange} />
<SimulationNoncashBase draft={draft} onChange={onChange} />
<SimulationCompositionBase draft={draft} onChange={onChange} />
<SimulationOfferPreparations draft={draft} onChange={onChange} />
<SimulationModeloA draft={draft} />
</section>;
+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.']];}
}
+2
View File
@@ -10,6 +10,7 @@ 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 { offerPreparationReportRows } from './iva-offer-preparations.ts';
import { salesReportRows } from './iva-operations.ts';
import { fiscalQaRows } from './fiscal-qa-preview.ts';
@@ -630,6 +631,7 @@ export function buildProjectDossierRows(
rows.push(...actSaleReportRows(draft));
rows.push(...fuelBaseReportRows(draft));
rows.push(...noncashBaseReportRows(draft));
rows.push(...compositionReportRows(draft));
rows.push(...offerPreparationReportRows(draft));
const operationRows = salesReportRows(draft);
rows.push(...operationRows);