Clarify L1 residual closure criteria and add partial returnee baggage QA
This commit is contained in:
@@ -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.`};
|
||||
}
|
||||
@@ -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']];}}
|
||||
|
||||
Reference in New Issue
Block a user