Implement Tempo FX selection and offer request decision workflow in QA
This commit is contained in:
@@ -1,9 +1,10 @@
|
||||
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:Lei2/2006 obtida,106(5)conferido;regra taxa/data ainda por demonstrar;conversão apenas cenário condicionado,sem base fiscal confirmada.';
|
||||
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 — cenário condicionado'},
|
||||
{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)'},
|
||||
@@ -20,7 +21,7 @@ export const currencyEventTreatments=[
|
||||
{id:'advance_payment',branch:'P132',label:'Pagamento anterior à factura8c'},
|
||||
] as const;
|
||||
type Choice=''|'yes'|'no';
|
||||
export type CurrencyEventRow={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';};
|
||||
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[]};
|
||||
@@ -47,6 +48,14 @@ export function evaluateCurrencyEvent(row:CurrencyEventRow):LineResult{
|
||||
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.');
|
||||
@@ -91,4 +100,4 @@ export function evaluateCurrencyEvent(row:CurrencyEventRow):LineResult{
|
||||
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)=>['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'};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.']];}}
|
||||
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.']];}}
|
||||
|
||||
@@ -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)};
|
||||
}
|
||||
@@ -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'})};
|
||||
}
|
||||
@@ -1,11 +1,12 @@
|
||||
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). Preparação de dados; procedimento regulamentar de aplicação ainda em pesquisa. Não concede isenção nem preenche dedução/campo11.';
|
||||
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 = {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 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:''};}
|
||||
@@ -18,6 +19,7 @@ function read(draft:Record<string,unknown>):Store {
|
||||
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.');
|
||||
}
|
||||
}
|
||||
@@ -49,28 +51,30 @@ export function reuseOfferData(row:OfferPreparation,source:OfferReusable):OfferP
|
||||
}
|
||||
export function emptyOfferRequest():OfferRequest{return {state:'preparation',reference:'',presentedOn:'',decisionRef:'',decisionOn:'',goods:'',operation:'',periodFrom:'',periodTo:'',conditions:''};}
|
||||
export function recordOfferRequest(row:OfferPreparation):OfferPreparation{
|
||||
if(row.branch!=='P084')throw new Error('Os estados deste pedido pertencem ao percurso P084; emergência conservada no percurso próprio.');
|
||||
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:false}{
|
||||
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'}; 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.`]);}
|
||||
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.']];}
|
||||
}
|
||||
|
||||
@@ -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(' | ')}`;}
|
||||
@@ -0,0 +1,49 @@
|
||||
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}] 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={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',Choice>>};
|
||||
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')||!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{
|
||||
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(!['exempt','reduced'].includes(rows[i].status))continue;if(b.rows.some((peer,j)=>j!==i&&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}`]);}catch(e){return[['IVA mensal','P058 — recuperação',String(e),'Originais preservados']];}}
|
||||
@@ -1,6 +1,7 @@
|
||||
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';
|
||||
@@ -668,6 +669,7 @@ export function buildProjectDossierRows(
|
||||
rows.push(...digitalReportRows(draft));
|
||||
rows.push(...objectiveImportReportRows(draft));
|
||||
rows.push(...minerReportRows(draft));
|
||||
rows.push(...returneeReportRows(draft));
|
||||
rows.push(...travelReportRows(draft));
|
||||
rows.push(...travelEventReportRows(draft));
|
||||
rows.push(...offerPreparationReportRows(draft));
|
||||
|
||||
Reference in New Issue
Block a user