Clarify L1 residual closure criteria and add partial returnee baggage QA

This commit is contained in:
2026-10-25 11:24:02 +02:00
parent 9019f766f2
commit 4f28fac5d0
13 changed files with 364 additions and 26 deletions
@@ -0,0 +1,14 @@
import type {ReturneeRow} from '@/lib/iva-returnees';
import {baggageConditions} from '@/lib/iva-returnee-baggage';
export function SimulationReturneeBaggageFields({row,change}:{row:ReturneeRow;change:(patch:Partial<ReturneeRow>)=>void}){
const text=(key:'missionRef'|'missionPlannedEnd'|'earlyReturnRef'|'earlyBaggageRef',label:string,type='text')=><label className="block" key={key}>{label}<input type={type} value={row[key]??''} onChange={e=>change({[key]:e.target.value})}/></label>;
const choice=(key:keyof ReturneeRow['conditions'],label:string)=><label className="block" key={key}>{label}<select value={row.conditions[key]??''} onChange={e=>change({conditions:{...row.conditions,[key]:e.target.value}})}><option value="">Por esclarecer</option><option value="yes">Sim,segundo factos ou pressupostos identificados</option><option value="no">Não</option></select></label>;
return<fieldset><legend>Condições próprias da bagagem no regresso</legend>{baggageConditions.map(([key,label])=>choice(key,label))}
{text('missionRef',row.treatment==='student_baggage'?'Referência da missão de estudo/condição de estudante ou bolseiro':'Referência da missão de serviço público e categoria do funcionário')}
<label>Bens desta linha<select value={row.baggageKind??''} onChange={e=>change({baggageKind:e.target.value as ReturneeRow['baggageKind']})}><option value="">Por indicar</option><option value="personal">Objectos de uso pessoal com sinais de uso — artigo57(3)a</option><option value="household">Móveis,roupas e objectos de uso doméstico — artigo57(3)b</option></select></label>
<label>Via da bagagem<select value={row.baggageRoute??''} onChange={e=>change({baggageRoute:e.target.value as ReturneeRow['baggageRoute']})}><option value="">Por indicar</option><option value="accompanied">Acompanhada pelo viajante</option><option value="unaccompanied">Não acompanhada — artigo61</option></select></label>
{row.treatment==='early_state_baggage'&&<>{text('missionPlannedEnd','Termo inicialmente previsto para a missão superior a um ano','date')}{choice('earlyService','Regresso antecipado por motivos de serviço do Estado')}{text('earlyReturnRef','Motivo/referência do regresso antecipado ou pressuposto expresso')}</>}
{row.baggageRoute==='unaccompanied'&&<><p>Artigo61:entrada até180dias após a chegada;desembaraço anterior à chegada apenas na excepção justificada,com autorização do chefe da estância aduaneira da jurisdição.</p>{choice('advanceClearance','Invoca desembaraço excepcional antes da chegada do viajante?')}{row.conditions.advanceClearance==='yes'&&text('earlyBaggageRef','Motivo justificado,autorização/âmbito do desembaraço antecipado ou pressuposto expresso')}</>}
<p>Não se aplicam aqui a idade/nacionalidade,quota de veículo em cinco anos ou requerimento60+30dias do artigo63.Oartigo57(4) não dispensa formalidades nas alíneas c/d;reutilize os documentos disponíveis.Sem novo certificado criado pelo portal.Veículos,armas e munições não pertencem a esta linha de bagagem.</p>
</fieldset>;
}
@@ -1,26 +1,29 @@
import {baggageSource,isReturneeBaggage} from '@/lib/iva-returnee-baggage';
import {SimulationReturneeBaggageFields} from './simulation-returnee-baggage-fields';
import {useState} from 'react';
import {returneeBook,saveReturneeBook,newReturnee,returneeTreatments,returneeConditions,recordReturnees,returneeReportRows,returneeCurrent,returneeSource,type ReturneeBook,type ReturneeRow} from '@/lib/iva-returnees';
export function SimulationReturnees({draft,onChange}:{draft:Record<string,unknown>;onChange:(field:string,value:string)=>void}){
const[error,setError]=useState('');let book:ReturneeBook;try{book=returneeBook(draft);}catch(e){return<p role="alert">{String(e)}</p>;}
const save=(b:ReturneeBook)=>{try{onChange('modelo_a_snapshot',saveReturneeBook(draft,b));setError('');}catch(e){setError(String(e));}};
const change=(id:string,patch:Partial<ReturneeRow>)=>save({...book,rows:book.rows.map(r=>r.id===id?{...r,...patch}:r)});
return<details className="rounded border p-3"><summary>Regresso definitivo — veículos (P058, cobertura parcial)</summary>
<p>Prepare o veículo e simule o enquadramento do artigo63.º do Decreto37/2023. Isenção, redução de80% e redução excepcional de50% têm condições distintas. Estas percentagens são benefícios sobre as imposições; não são taxas deIVA. Não se aplicam aqui as condições dos mineirosP059.</p>
<p>Bagagem e outros bens continuam por concluir emP058. A remissão do artigo57(2)b ao próprio n.º2 está incoerente no exemplar e não foi corrigida por presunção. O caso de exactamente180dias de propriedade fica indeterminado. O marco da conferência do tempo de propriedade deve vir do enquadramento/documento indicado;sem escolher a chegada ou o despacho automaticamente. Aquisição interna, direitos,ICE,dedução e alteração de destino não são calculados neste incremento.</p>
{error&&<p role="alert">{error}</p>}<button type="button" onClick={()=>{const next=newReturnee(crypto.randomUUID(),String(draft.currency??''));const candidates=book.rows.filter(r=>r.beneficiary);if(new Set(candidates.map(r=>r.beneficiary)).size===1)next.beneficiary=candidates[0].beneficiary;save({...book,rows:[...book.rows,next]});}}>Acrescentar veículo no regresso</button>
{book.rows.map(row=>{const text=(field:Exclude<keyof ReturneeRow,'conditions'>,label:string,type='text')=><label key={field} className="block">{label}<input type={type} value={row[field]} onChange={e=>change(row.id,{[field]:e.target.value})}/></label>;const choice=(key:keyof ReturneeRow['conditions'],label:string)=><label key={key} className="block">{label}<select value={row.conditions[key]??''} onChange={e=>change(row.id,{conditions:{...row.conditions,[key]:e.target.value}})}><option value="">Por esclarecer</option><option value="yes">Sim,segundo factos ou pressupostos identificados</option><option value="no">Não</option></select></label>;
return<details key={row.id}><summary>{row.description||'Veículo por preparar'}</summary><label>Percurso do veículo<select value={row.treatment} onChange={e=>change(row.id,{treatment:e.target.value,conditions:Object.fromEntries(returneeConditions.map(([k])=>[k,row.conditions[k]]))})}><option value="">Escolher percurso</option>{returneeTreatments.map(t=><option key={t.id} value={t.id}>{t.label}</option>)}</select></label>
{text('description','Veículo identificado')}{text('beneficiary','Beneficiário')}{text('period','Período da importação','month')}{text('importDate','Data da importação ou previsão','date')}
return<details className="rounded border p-3"><summary>Regresso definitivo — veículos e bagagem (P058, cobertura parcial)</summary>
<p>Prepare os bens e escolha o percurso próprio:veículos no artigo63.º ou bagagem de funcionários e estudantes nos artigos57.º/61.º do Decreto37/2023. Isenção, redução de80% e redução excepcional de50% têm condições distintas. Estas percentagens são benefícios sobre as imposições; não são taxas deIVA. Não se aplicam aqui as condições dos mineirosP059.</p>
<p>Bagagem de funcionários e estudantes tem percurso próprio57(2)c/d;fixação de domicílio57(2)b e outros bens permanecem por enquadrar. A remissão do artigo57(2)b ao próprio n.º2 está incoerente no exemplar e não foi corrigida por presunção. O caso de exactamente180dias de propriedade fica indeterminado. O marco da conferência do tempo de propriedade deve vir do enquadramento/documento indicado;sem escolher a chegada ou o despacho automaticamente. Aquisição interna, direitos,ICE,dedução e alteração de destino não são calculados neste incremento.</p>
{error&&<p role="alert">{error}</p>}<button type="button" onClick={()=>{const next=newReturnee(crypto.randomUUID(),String(draft.currency??''));const candidates=book.rows.filter(r=>r.beneficiary);if(new Set(candidates.map(r=>r.beneficiary)).size===1)next.beneficiary=candidates[0].beneficiary;save({...book,rows:[...book.rows,next]});}}>Acrescentar bens no regresso</button>
{book.rows.map(row=>{const baggage=isReturneeBaggage(row.treatment),vehicle=['owned','recent','separate'].includes(row.treatment);const text=(field:Exclude<keyof ReturneeRow,'conditions'>,label:string,type='text')=><label key={field} className="block">{label}<input type={type} value={row[field]} onChange={e=>change(row.id,{[field]:e.target.value})}/></label>;const choice=(key:keyof ReturneeRow['conditions'],label:string)=><label key={key} className="block">{label}<select value={row.conditions[key]??''} onChange={e=>change(row.id,{conditions:{...row.conditions,[key]:e.target.value}})}><option value="">Por esclarecer</option><option value="yes">Sim,segundo factos ou pressupostos identificados</option><option value="no">Não</option></select></label>;
return<details key={row.id}><summary>{row.description||'Bens por preparar'}</summary><label>Percurso dos bens<select value={row.treatment} onChange={e=>change(row.id,{treatment:e.target.value,conditions:Object.fromEntries(returneeConditions.map(([k])=>[k,row.conditions[k]]))})}><option value="">Escolher percurso</option>{returneeTreatments.map(t=><option key={t.id} value={t.id}>{t.label}</option>)}</select></label>
{text('description',vehicle?'Veículo identificado':'Bens identificados')}{text('beneficiary','Beneficiário')}{text('period','Período da importação','month')}{text('importDate','Data da importação ou previsão','date')}
<label>Natureza dos dados<select value={row.origin} onChange={e=>change(row.id,{origin:e.target.value as ReturneeRow['origin']})}><option value="projected">Pressupostos de projecção</option><option value="effective">Factos efectivos declarados</option></select></label>
{text('documentRef','Documentos disponíveis ou previsão')}{text('scope','Âmbito:bens,operação,período e condições')}{text('evidence','Factos ou pressupostos expressos')}{returneeConditions.map(([k,l])=>choice(k,l))}
{text('stayStart','Início da estadia no estrangeiro','date')}{text('stayEnd','Fim da estadia no estrangeiro','date')}{text('arrival','Chegada no regresso definitivo','date')}{text('request','Requerimento do benefício','date')}
{row.treatment!=='separate'&&<>{text('ownedSince','Início da propriedade no país de procedência','date')}{text('ownershipAssessment','Data à qual o documento confere o tempo de propriedade no país de procedência','date')}</>}
{choice('extension','Invoca prorrogação excepcional do prazo de60dias,até30dias adicionais?')}{row.conditions.extension==='yes'&&text('extensionRef','Prorrogação pelo Director-Geral das Alfândegas:referência,âmbito e prazo ou pressuposto expresso')}
{text('documentRef','Documentos disponíveis ou previsão')}{text('scope','Âmbito:bens,operação,período e condições')}{text('evidence','Factos ou pressupostos expressos')}{baggage?<SimulationReturneeBaggageFields row={row} change={patch=>change(row.id,patch)}/>:vehicle?returneeConditions.map(([k,l])=>choice(k,l)):null}
{text('stayStart','Início da estadia no estrangeiro','date')}{text('stayEnd','Fim da estadia no estrangeiro','date')}{text('arrival','Chegada no regresso definitivo','date')}{vehicle&&text('request','Requerimento do benefício','date')}
{vehicle&&row.treatment!=='separate'&&<>{text('ownedSince','Início da propriedade no país de procedência','date')}{text('ownershipAssessment','Data à qual o documento confere o tempo de propriedade no país de procedência','date')}</>}
{vehicle&&<>{choice('extension','Invoca prorrogação excepcional do prazo de60dias,até30dias adicionais?')}{row.conditions.extension==='yes'&&text('extensionRef','Prorrogação pelo Director-Geral das Alfândegas:referência,âmbito e prazo ou pressuposto expresso')}
{row.treatment==='separate'&&<>{choice('substitution','Substituição excepcional do benefício por veículo separado da bagagem?')}{text('decisionRef','Referência e âmbito da substituição ou pressuposto expresso;pedido não equivale a concessão')}{choice('exception','Invoca excepção por estadia insuficiente no estrangeiro?')}{row.conditions.exception==='yes'&&text('exceptionRef','Autorização do Ministro das Finanças:motivos e âmbito ou pressuposto expresso')}</>}
<label>Benefício anterior de veículo<select value={row.previous} onChange={e=>change(row.id,{previous:e.target.value as ReturneeRow['previous']})}><option value="">Por esclarecer</option><option value="none">Nenhum,segundo histórico identificado</option><option value="known">Sim,data conhecida</option></select></label>{row.previous==='known'&&text('previousDate','Data da numeração do despacho anterior','date')}{text('historyRef','Histórico de benefícios,incluindo fora deste dossier')}
{['recent','separate'].includes(row.treatment)&&<>{text('normalVat','IVA normal desta importação informado emMZN')}{text('normalVatRef','Referência do IVA normal ou pressuposto expresso')}</>}
<p>Mudar percurso conserva os campos ocultos e limpa confirmações específicas. A fonte exige documentos de titularidade e residência e declaração de uso;reutilize os documentos disponíveis. A aplicação não emite despacho nem concede o benefício.</p></details>;})}
{!!book.rows.length&&<button type="button" onClick={()=>{try{save(recordReturnees(draft,book));}catch(e){setError(String(e));}}}>Conferir veículos no regresso e guardar versão</button>}
</>}
<p>Mudar percurso conserva os campos ocultos e limpa confirmações específicas. {baggage?'Reutilize os documentos da missão,estudo e bagagem;as condições de veículos não se aplicam a esta linha.':'A fonte exige documentos de titularidade e residência e declaração de uso;reutilize os documentos disponíveis.'} A aplicação não emite despacho nem concede o benefício.</p></details>;})}
{!!book.rows.length&&<button type="button" onClick={()=>{try{save(recordReturnees(draft,book));}catch(e){setError(String(e));}}}>Conferir bens no regresso e guardar versão</button>}
{book.result&&<><p role="status">{returneeCurrent(draft,book)?'Resultado corresponde às entradas guardadas.':'Entradas alteradas;resultado histórico conservado.'} {book.history?.length??0} versões anteriores.Cobertura parcialP058.</p><dl>{returneeReportRows(draft).map(([,label,value,source],i)=><div key={i}><dt>{label}</dt><dd>{value}<small className="block">{source}</small></dd></div>)}</dl></>}
<details><summary>Fonte e âmbito documental</summary><p>{returneeSource}</p></details></details>;
<details><summary>Fonte e âmbito documental</summary><p>{returneeSource}</p><p>{baggageSource}</p></details></details>;
}
+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.`};
}
+8 -6
View File
@@ -1,20 +1,22 @@
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}] as const;
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={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};
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')||!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;}
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.');
@@ -43,7 +45,7 @@ function key(draft:Record<string,unknown>,b:ReturneeBook){return JSON.stringify(
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 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}`]);}catch(e){return[['IVA mensal','P058 — recuperação',String(e),'Originais preservados']];}}
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']];}}