@muni-sanfer/types-gestor-documental 0.0.1-beta.24 → 0.0.1-beta.26

package/dist/base/entities.d.ts

@@ -33,7 +33,7 @@ export declare const DocumentParticipantStatus: {
     Resolved: "Resolved";
     Rejected: "Rejected";
 };
-export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened' | 'DispositionRecorded';
+export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'DispatchedByContingency' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened' | 'DispositionRecorded';
 export declare const DocumentTrackingAction: {
     Created: "Created";
     Updated: "Updated";
@@ -51,15 +51,24 @@ export declare const DocumentTrackingAction: {
     Reassigned: "Reassigned";
     Dispatched: "Dispatched";
     DispatchReturned: "DispatchReturned";
+    DispatchedByContingency: "DispatchedByContingency";
     Received: "Received";
     EmailCopySent: "EmailCopySent";
     EmailCopyOpened: "EmailCopyOpened";
     DispositionRecorded: "DispositionRecorded";
 };
-export type DocumentOrigin = 'Internal' | 'DocDigital';
+export type DocumentOrigin = 'Internal' | 'DocDigital' | 'Manual';
 export declare const DocumentOrigin: {
     Internal: "Internal";
     DocDigital: "DocDigital";
+    Manual: "Manual";
+};
+export type CommunicationMeans = 'Paper' | 'Email' | 'Courier' | 'Other';
+export declare const CommunicationMeans: {
+    Paper: "Paper";
+    Email: "Email";
+    Courier: "Courier";
+    Other: "Other";
 };
 export type DocumentDispatchStatus = 'Pending' | 'Dispatched' | 'Returned';
 export declare const DocumentDispatchStatus: {
@@ -239,6 +248,42 @@ export declare const DispositionKind: {
     Transfer: "Transfer";
     Elimination: "Elimination";
 };
+export type AccessRequestChannel = 'Portal' | 'Email' | 'InPerson' | 'Letter';
+export declare const AccessRequestChannel: {
+    Portal: "Portal";
+    Email: "Email";
+    InPerson: "InPerson";
+    Letter: "Letter";
+};
+export type AccessRequestStatus = 'Received' | 'InCorrection' | 'InProgress' | 'Resolved';
+export declare const AccessRequestStatus: {
+    Received: "Received";
+    InCorrection: "InCorrection";
+    InProgress: "InProgress";
+    Resolved: "Resolved";
+};
+export type AccessRequestResolution = 'Delivered' | 'PartiallyDelivered' | 'Denied' | 'Derived' | 'NonExistent' | 'Withdrawn';
+export declare const AccessRequestResolution: {
+    Delivered: "Delivered";
+    PartiallyDelivered: "PartiallyDelivered";
+    Denied: "Denied";
+    Derived: "Derived";
+    NonExistent: "NonExistent";
+    Withdrawn: "Withdrawn";
+};
+export type AccessRequestEventAction = 'Received' | 'Updated' | 'CorrectionRequested' | 'Corrected' | 'Assigned' | 'ThirdPartyNotified' | 'OppositionRegistered' | 'Extended' | 'Resolved' | 'AppealRegistered';
+export declare const AccessRequestEventAction: {
+    Received: "Received";
+    Updated: "Updated";
+    CorrectionRequested: "CorrectionRequested";
+    Corrected: "Corrected";
+    Assigned: "Assigned";
+    ThirdPartyNotified: "ThirdPartyNotified";
+    OppositionRegistered: "OppositionRegistered";
+    Extended: "Extended";
+    Resolved: "Resolved";
+    AppealRegistered: "AppealRegistered";
+};
 export interface DocumentTypeEntity {
     id: string;
     name: string;
@@ -288,6 +333,7 @@ export interface DocumentEntity {
     externalFolio?: string | null;
     externalSender?: string | null;
     externalDate?: string | null;
+    intakeMeans?: CommunicationMeans | null;
     composition?: JsonValue | null;
     contentText?: string | null;
     textExtractedAt?: string | null;
@@ -321,6 +367,8 @@ export interface DocumentEntity {
     accesses?: DocumentAccessEntity[];
     disposition?: DispositionRecordEntity | null;
     dispositionId?: string | null;
+    accessRequestResponses?: AccessRequestEntity[];
+    accessRequestDeliveries?: AccessRequestDocumentEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
     deleted: boolean;
@@ -653,6 +701,11 @@ export interface DocumentDispatchEntity {
     returnedByEmployeeId?: string | null;
     returnedByFullName?: string | null;
     returnReason?: string | null;
+    contingencyMeans?: CommunicationMeans | null;
+    contingencySentTo?: string | null;
+    contingencyReason?: string | null;
+    contingencyReceiptFileId?: string | null;
+    contingencyReceiptName?: string | null;
     document?: DocumentEntity;
     documentId: string;
     createdAt: string;
@@ -851,6 +904,62 @@ export interface DispositionRecordEntity {
     createdByFullName: string;
     createdAt: string;
 }
+export interface AccessRequestEntity {
+    id: string;
+    number: number;
+    year: number;
+    externalFolio?: string | null;
+    channel: AccessRequestChannel;
+    receivedAt: string;
+    requesterName: string;
+    requesterEmail?: string | null;
+    requesterAddress?: string | null;
+    requestText: string;
+    deliveryFormat?: string | null;
+    status: AccessRequestStatus;
+    correctionRequestedAt?: string | null;
+    correctionDueAt?: string | null;
+    correctedAt?: string | null;
+    dueAt: string;
+    extendedAt?: string | null;
+    extensionNote?: string | null;
+    assigneeEmployeeId?: string | null;
+    assigneeFullName?: string | null;
+    thirdPartyNotifiedAt?: string | null;
+    oppositionDueAt?: string | null;
+    thirdPartyOpposed?: boolean | null;
+    resolution?: AccessRequestResolution | null;
+    resolvedAt?: string | null;
+    denialGrounds: string[];
+    derivedTo?: string | null;
+    resolutionNote?: string | null;
+    responseDocument?: DocumentEntity | null;
+    responseDocumentId?: string | null;
+    appealedAt?: string | null;
+    appealNote?: string | null;
+    createdByEmployeeId: string;
+    createdByFullName: string;
+    documents?: AccessRequestDocumentEntity[];
+    events?: AccessRequestEventEntity[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AccessRequestDocumentEntity {
+    accessRequest?: AccessRequestEntity;
+    accessRequestId: string;
+    document?: DocumentEntity;
+    documentId: string;
+}
+export interface AccessRequestEventEntity {
+    id: string;
+    action: AccessRequestEventAction;
+    note?: string | null;
+    employeeId?: string | null;
+    employeeFullName: string;
+    accessRequest?: AccessRequestEntity;
+    accessRequestId: string;
+    createdAt: string;
+}
 type JsonValue = string | number | boolean | {
     [key in string]?: JsonValue;
 } | Array<JsonValue> | null;

package/dist/base/entities.js

@@ -1,7 +1,7 @@
 "use strict";
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.CommunicationMeans = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -49,6 +49,7 @@ exports.DocumentTrackingAction = {
     Reassigned: 'Reassigned',
     Dispatched: 'Dispatched',
     DispatchReturned: 'DispatchReturned',
+    DispatchedByContingency: 'DispatchedByContingency',
     Received: 'Received',
     EmailCopySent: 'EmailCopySent',
     EmailCopyOpened: 'EmailCopyOpened',
@@ -57,6 +58,13 @@ exports.DocumentTrackingAction = {
 exports.DocumentOrigin = {
     Internal: 'Internal',
     DocDigital: 'DocDigital',
+    Manual: 'Manual',
+};
+exports.CommunicationMeans = {
+    Paper: 'Paper',
+    Email: 'Email',
+    Courier: 'Courier',
+    Other: 'Other',
 };
 exports.DocumentDispatchStatus = {
     Pending: 'Pending',
@@ -211,3 +219,35 @@ exports.DispositionKind = {
     Transfer: 'Transfer',
     Elimination: 'Elimination',
 };
+exports.AccessRequestChannel = {
+    Portal: 'Portal',
+    Email: 'Email',
+    InPerson: 'InPerson',
+    Letter: 'Letter',
+};
+exports.AccessRequestStatus = {
+    Received: 'Received',
+    InCorrection: 'InCorrection',
+    InProgress: 'InProgress',
+    Resolved: 'Resolved',
+};
+exports.AccessRequestResolution = {
+    Delivered: 'Delivered',
+    PartiallyDelivered: 'PartiallyDelivered',
+    Denied: 'Denied',
+    Derived: 'Derived',
+    NonExistent: 'NonExistent',
+    Withdrawn: 'Withdrawn',
+};
+exports.AccessRequestEventAction = {
+    Received: 'Received',
+    Updated: 'Updated',
+    CorrectionRequested: 'CorrectionRequested',
+    Corrected: 'Corrected',
+    Assigned: 'Assigned',
+    ThirdPartyNotified: 'ThirdPartyNotified',
+    OppositionRegistered: 'OppositionRegistered',
+    Extended: 'Extended',
+    Resolved: 'Resolved',
+    AppealRegistered: 'AppealRegistered',
+};

package/dist/contracts/accessRequest.contract.d.ts

@@ -0,0 +1,109 @@
+import { type AccessRequestChannel, type AccessRequestResolution } from '../base/entities';
+import { type AccessRequestDetailEntity, type AccessRequestListItemEntity, type AccessRequestSummaryEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `accessRequest`: solicitudes de acceso a la información pública (Ley 20.285). */
+export declare const AccessRequestPatterns: {
+    readonly getAll: "gestorDocumental.accessRequest.getAll";
+    readonly getById: "gestorDocumental.accessRequest.getById";
+    readonly getSummary: "gestorDocumental.accessRequest.getSummary";
+    readonly create: "gestorDocumental.accessRequest.create";
+    readonly update: "gestorDocumental.accessRequest.update";
+    readonly act: "gestorDocumental.accessRequest.act";
+};
+export interface AccessRequestWritePayload {
+    externalFolio?: string | null;
+    channel: AccessRequestChannel;
+    /** Fecha y hora de ingreso (ISO): desde ahí corren los 20 días hábiles. */
+    receivedAt: string;
+    requesterName: string;
+    requesterEmail?: string | null;
+    requesterAddress?: string | null;
+    requestText: string;
+    deliveryFormat?: string | null;
+}
+/** Lo que se hace con una solicitud, un paso a la vez. */
+export type AccessRequestAction = {
+    type: 'requestCorrection';
+    note: string;
+} | {
+    type: 'registerCorrection';
+    correctedAt?: string | null;
+    note?: string | null;
+} | {
+    type: 'assign';
+    employeeId: string;
+    fullName: string;
+    note?: string | null;
+} | {
+    type: 'notifyThirdParty';
+    note: string;
+} | {
+    type: 'registerOpposition';
+    opposed: boolean;
+    note?: string | null;
+} | {
+    type: 'extend';
+    note: string;
+} | {
+    type: 'resolve';
+    resolution: AccessRequestResolution;
+    grounds?: string[];
+    derivedTo?: string | null;
+    note?: string | null;
+    responseDocumentId?: string | null;
+    documentIds?: string[];
+} | {
+    type: 'registerAppeal';
+    appealedAt?: string | null;
+    note: string;
+};
+export interface AccessRequestActor {
+    employeeId: string;
+    fullName: string;
+}
+export interface AccessRequestContract {
+    [AccessRequestPatterns.getAll]: {
+        payload: {
+            status?: 'open' | 'resolved' | 'all';
+            year?: number | null;
+            search?: string;
+            page?: number;
+            limit?: number;
+        };
+        response: RpcPage<AccessRequestListItemEntity[]>;
+    };
+    [AccessRequestPatterns.getById]: {
+        payload: {
+            id: string;
+        };
+        response: AccessRequestDetailEntity;
+    };
+    [AccessRequestPatterns.getSummary]: {
+        payload: {
+            year: number;
+        };
+        response: AccessRequestSummaryEntity;
+    };
+    [AccessRequestPatterns.create]: {
+        payload: AccessRequestWritePayload & {
+            actor: AccessRequestActor;
+        };
+        response: AccessRequestDetailEntity;
+    };
+    /** Corrige los datos mientras no está resuelta. */
+    [AccessRequestPatterns.update]: {
+        payload: AccessRequestWritePayload & {
+            id: string;
+            actor: AccessRequestActor;
+        };
+        response: AccessRequestDetailEntity;
+    };
+    [AccessRequestPatterns.act]: {
+        payload: {
+            id: string;
+            action: AccessRequestAction;
+            actor: AccessRequestActor;
+        };
+        response: AccessRequestDetailEntity;
+    };
+}

package/dist/contracts/accessRequest.contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessRequestPatterns = void 0;
+/** Patrones NATS de `accessRequest`: solicitudes de acceso a la información pública (Ley 20.285). */
+exports.AccessRequestPatterns = {
+    getAll: 'gestorDocumental.accessRequest.getAll',
+    getById: 'gestorDocumental.accessRequest.getById',
+    getSummary: 'gestorDocumental.accessRequest.getSummary',
+    create: 'gestorDocumental.accessRequest.create',
+    update: 'gestorDocumental.accessRequest.update',
+    act: 'gestorDocumental.accessRequest.act',
+};

package/dist/contracts/index.d.ts

@@ -10,6 +10,7 @@ import { type AuditContract } from './audit.contract';
 import { type SignatureCheckContract } from './signatureCheck.contract';
 import { type RepositoryExportContract } from './repositoryExport.contract';
 import { type RetentionContract } from './retention.contract';
+import { type AccessRequestContract } from './accessRequest.contract';
 import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -35,6 +36,7 @@ export * from './audit.contract';
 export * from './signatureCheck.contract';
 export * from './repositoryExport.contract';
 export * from './retention.contract';
+export * from './accessRequest.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -124,6 +126,8 @@ export declare const GestorDocumentalPatterns: {
         readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
         readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
         readonly checkEnablement: "gestorDocumental.partsOffice.checkEnablement";
+        readonly dispatchByContingency: "gestorDocumental.partsOffice.dispatchByContingency";
+        readonly registerManualIntake: "gestorDocumental.partsOffice.registerManualIntake";
     };
     readonly registerBook: {
         readonly get: "gestorDocumental.registerBook.get";
@@ -207,6 +211,14 @@ export declare const GestorDocumentalPatterns: {
         readonly getRecords: "gestorDocumental.retention.getRecords";
         readonly getRecordPdf: "gestorDocumental.retention.getRecordPdf";
     };
+    readonly accessRequest: {
+        readonly getAll: "gestorDocumental.accessRequest.getAll";
+        readonly getById: "gestorDocumental.accessRequest.getById";
+        readonly getSummary: "gestorDocumental.accessRequest.getSummary";
+        readonly create: "gestorDocumental.accessRequest.create";
+        readonly update: "gestorDocumental.accessRequest.update";
+        readonly act: "gestorDocumental.accessRequest.act";
+    };
 };
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
-export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract;

package/dist/contracts/index.js

@@ -27,6 +27,7 @@ const audit_contract_1 = require("./audit.contract");
 const signatureCheck_contract_1 = require("./signatureCheck.contract");
 const repositoryExport_contract_1 = require("./repositoryExport.contract");
 const retention_contract_1 = require("./retention.contract");
+const accessRequest_contract_1 = require("./accessRequest.contract");
 const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -52,6 +53,7 @@ __exportStar(require("./audit.contract"), exports);
 __exportStar(require("./signatureCheck.contract"), exports);
 __exportStar(require("./repositoryExport.contract"), exports);
 __exportStar(require("./retention.contract"), exports);
+__exportStar(require("./accessRequest.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -72,4 +74,5 @@ exports.GestorDocumentalPatterns = {
     signatureCheck: signatureCheck_contract_1.SignatureCheckPatterns,
     repositoryExport: repositoryExport_contract_1.RepositoryExportPatterns,
     retention: retention_contract_1.RetentionPatterns,
+    accessRequest: accessRequest_contract_1.AccessRequestPatterns,
 };

package/dist/contracts/partsOffice.contract.d.ts

@@ -1,4 +1,4 @@
-import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
+import { type CommunicationMeans, type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
 import { type DocDigitalDocumentTypeEntity, type DocDigitalEntityEntity, type PartsOfficeInboundEntity, type DocDigitalUserEntity, type EnablementPersonInput, type PartsOfficeEnablementEntity, type PartsOfficeDispatchEntity, type PartsOfficeFileEntity, type PartsOfficeOkResponseEntity, type PartsOfficeRegisterResponseEntity, type PartsOfficeStatusEntity, type PartsOfficeSummaryEntity, type PartsOfficeSyncResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor, type DocumentExternalRecipientInput } from './document.contract';
@@ -22,6 +22,8 @@ export declare const PartsOfficePatterns: {
     readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
     readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
     readonly checkEnablement: "gestorDocumental.partsOffice.checkEnablement";
+    readonly dispatchByContingency: "gestorDocumental.partsOffice.dispatchByContingency";
+    readonly registerManualIntake: "gestorDocumental.partsOffice.registerManualIntake";
 };
 /** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
 export type PartsOfficeRecipientInput = {
@@ -48,6 +50,35 @@ interface IListPayload<S> {
         status?: S;
     };
 }
+/** Lo que llegó fuera de DocDigital y Oficina de Partes ingresa a mano. */
+export interface ManualIntakePayload {
+    file: {
+        fileId: string;
+        name: string;
+    };
+    attachments?: {
+        fileId: string;
+        name: string;
+    }[];
+    means: CommunicationMeans;
+    /** Cuándo llegó (ISO); sin él, ahora. */
+    receivedAt?: string | null;
+    senderEntityName: string;
+    senderName?: string | null;
+    externalFolio?: string | null;
+    externalDate?: string | null;
+    subject: string;
+    documentTypeId: string;
+    keywords: string[];
+    accessLevel?: DocumentAccessLevel;
+    hasSensitiveData?: boolean;
+    recipients: unknown[];
+    instruction: DocumentInstruction;
+    note?: string | null;
+    dueAt?: string | null;
+    dueBusinessDays?: number | null;
+    actor: DocumentActor;
+}
 export interface PartsOfficeContract {
     [PartsOfficePatterns.getStatus]: {
         payload: Record<string, never>;
@@ -118,6 +149,7 @@ export interface PartsOfficeContract {
     [PartsOfficePatterns.getDispatchFile]: {
         payload: {
             id: string;
+            receipt?: boolean;
         };
         response: PartsOfficeFileEntity;
     };
@@ -184,5 +216,33 @@ export interface PartsOfficeContract {
         };
         response: PartsOfficeEnablementEntity;
     };
+    /**
+     * Registro por contingencia: el documento no se pudo despachar por DocDigital y salió por otro medio. Queda
+     * despachado, con el medio, a quién, el motivo y el comprobante; si después se registra en DocDigital, su número.
+     */
+    [PartsOfficePatterns.dispatchByContingency]: {
+        payload: {
+            id: string;
+            means: CommunicationMeans;
+            sentAt: string;
+            sentTo: string;
+            reason: string;
+            receipt?: {
+                fileId: string;
+                name: string;
+            } | null;
+            docDigitalDocumentId?: string | null;
+            actor: DocumentActor;
+        };
+        response: PartsOfficeOkResponseEntity;
+    };
+    /**
+     * Ingreso manual: lo que llegó fuera de DocDigital (papel, correo) entra con folio de ingreso, como lo recibido
+     * por DocDigital, y se deriva.
+     */
+    [PartsOfficePatterns.registerManualIntake]: {
+        payload: ManualIntakePayload;
+        response: PartsOfficeRegisterResponseEntity;
+    };
 }
 export {};

package/dist/contracts/partsOffice.contract.js

@@ -21,4 +21,6 @@ exports.PartsOfficePatterns = {
     returnInbound: 'gestorDocumental.partsOffice.returnInbound',
     getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
     checkEnablement: 'gestorDocumental.partsOffice.checkEnablement',
+    dispatchByContingency: 'gestorDocumental.partsOffice.dispatchByContingency',
+    registerManualIntake: 'gestorDocumental.partsOffice.registerManualIntake',
 };

package/dist/entities/accessRequest/accessRequest.entity.d.ts

@@ -0,0 +1,73 @@
+import { type AccessRequestChannel, type AccessRequestEventAction, type AccessRequestResolution, type AccessRequestStatus } from '../../base/entities';
+/** Semáforo del plazo de respuesta: a tiempo, por vencer (2 días hábiles o menos) o vencido. */
+export type AccessRequestDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+export interface AccessRequestListItemEntity {
+    id: string;
+    /** «N° 15/2026». */
+    label: string;
+    externalFolio: string | null;
+    channel: AccessRequestChannel;
+    requesterName: string;
+    requestText: string;
+    receivedAt: string;
+    dueAt: string;
+    status: AccessRequestStatus;
+    resolution: AccessRequestResolution | null;
+    assigneeFullName: string | null;
+    /** Solo mientras está abierta. */
+    dueStatus: AccessRequestDueStatus | null;
+    businessDaysLeft: number | null;
+    /** Ya resuelta: si se respondió dentro del plazo. */
+    resolvedOnTime: boolean | null;
+}
+export interface AccessRequestDocumentLinkEntity {
+    id: string;
+    folio: string | null;
+    subject: string;
+}
+export interface AccessRequestDetailEntity extends AccessRequestListItemEntity {
+    year: number;
+    number: number;
+    requesterEmail: string | null;
+    requesterAddress: string | null;
+    deliveryFormat: string | null;
+    correctionRequestedAt: string | null;
+    correctionDueAt: string | null;
+    correctedAt: string | null;
+    extendedAt: string | null;
+    extensionNote: string | null;
+    assigneeEmployeeId: string | null;
+    thirdPartyNotifiedAt: string | null;
+    oppositionDueAt: string | null;
+    thirdPartyOpposed: boolean | null;
+    resolvedAt: string | null;
+    denialGrounds: string[];
+    derivedTo: string | null;
+    resolutionNote: string | null;
+    responseDocument: AccessRequestDocumentLinkEntity | null;
+    documents: AccessRequestDocumentLinkEntity[];
+    appealedAt: string | null;
+    appealNote: string | null;
+    createdByFullName: string;
+    /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+    canExtend: boolean;
+    events: {
+        action: AccessRequestEventAction;
+        note: string | null;
+        employeeFullName: string;
+        createdAt: string;
+    }[];
+}
+export interface AccessRequestSummaryEntity {
+    year: number;
+    total: number;
+    open: number;
+    overdue: number;
+    dueSoon: number;
+    resolved: Record<AccessRequestResolution, number>;
+    /** Respondidas dentro del plazo sobre las respondidas, en %. */
+    onTimeRate: number | null;
+    /** Días hábiles promedio entre el ingreso (o la subsanación) y la respuesta. */
+    averageBusinessDays: number | null;
+    appealed: number;
+}

package/dist/entities/accessRequest/accessRequest.entity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/entities/accessRequest/index.d.ts

@@ -0,0 +1 @@
+export * from './accessRequest.entity';

package/dist/entities/accessRequest/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./accessRequest.entity"), exports);

package/dist/entities/document/document.entity.d.ts

@@ -1,4 +1,4 @@
-import { DocumentAnnulledNumberEntity, DocumentAttachmentEntity, DocumentDeliveryEntity, DocumentEntity, DocumentParticipantEntity, DocumentRecipientEntity, DocumentTrackingEntity, DocumentTypeEntity } from '../../base/entities';
+import { type CommunicationMeans, DocumentAnnulledNumberEntity, DocumentAttachmentEntity, DocumentDeliveryEntity, DocumentEntity, DocumentParticipantEntity, DocumentRecipientEntity, DocumentTrackingEntity, DocumentTypeEntity } from '../../base/entities';
 /** Tipo documental de un documento, con lo necesario para citarlo. */
 export interface DocumentTypeSummaryEntity {
     id: DocumentTypeEntity['id'];
@@ -82,6 +82,14 @@ export interface DocumentDispatchResponseEntity {
     returnedAt: string | null;
     returnedByFullName: string | null;
     returnReason: string | null;
+    /** Registro por contingencia: salió por otro medio porque no se pudo por DocDigital. */
+    contingency: {
+        means: CommunicationMeans;
+        sentTo: string | null;
+        reason: string | null;
+        /** Nombre del comprobante, si se adjuntó. */
+        receiptName: string | null;
+    } | null;
 }
 export interface DocumentGetAllResponseEntity {
     id: DocumentEntity['id'];

package/dist/entities/index.d.ts

@@ -16,3 +16,4 @@ export * from './audit';
 export * from './signatureCheck';
 export * from './repositoryExport';
 export * from './retention';
+export * from './accessRequest';

package/dist/entities/index.js

@@ -32,3 +32,4 @@ __exportStar(require("./audit"), exports);
 __exportStar(require("./signatureCheck"), exports);
 __exportStar(require("./repositoryExport"), exports);
 __exportStar(require("./retention"), exports);
+__exportStar(require("./accessRequest"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.24",
+  "version": "0.0.1-beta.26",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -63,6 +63,7 @@ export type DocumentTrackingAction =
   | 'Reassigned'
   | 'Dispatched'
   | 'DispatchReturned'
+  | 'DispatchedByContingency'
   | 'Received'
   | 'EmailCopySent'
   | 'EmailCopyOpened'
@@ -85,19 +86,30 @@ export const DocumentTrackingAction = {
   Reassigned: 'Reassigned',
   Dispatched: 'Dispatched',
   DispatchReturned: 'DispatchReturned',
+  DispatchedByContingency: 'DispatchedByContingency',
   Received: 'Received',
   EmailCopySent: 'EmailCopySent',
   EmailCopyOpened: 'EmailCopyOpened',
   DispositionRecorded: 'DispositionRecorded',
 } satisfies Record<string, DocumentTrackingAction>;
 
-export type DocumentOrigin = 'Internal' | 'DocDigital';
+export type DocumentOrigin = 'Internal' | 'DocDigital' | 'Manual';
 
 export const DocumentOrigin = {
   Internal: 'Internal',
   DocDigital: 'DocDigital',
+  Manual: 'Manual',
 } satisfies Record<string, DocumentOrigin>;
 
+export type CommunicationMeans = 'Paper' | 'Email' | 'Courier' | 'Other';
+
+export const CommunicationMeans = {
+  Paper: 'Paper',
+  Email: 'Email',
+  Courier: 'Courier',
+  Other: 'Other',
+} satisfies Record<string, CommunicationMeans>;
+
 export type DocumentDispatchStatus = 'Pending' | 'Dispatched' | 'Returned';
 
 export const DocumentDispatchStatus = {
@@ -363,6 +375,61 @@ export const DispositionKind = {
   Elimination: 'Elimination',
 } satisfies Record<string, DispositionKind>;
 
+export type AccessRequestChannel = 'Portal' | 'Email' | 'InPerson' | 'Letter';
+
+export const AccessRequestChannel = {
+  Portal: 'Portal',
+  Email: 'Email',
+  InPerson: 'InPerson',
+  Letter: 'Letter',
+} satisfies Record<string, AccessRequestChannel>;
+
+export type AccessRequestStatus = 'Received' | 'InCorrection' | 'InProgress' | 'Resolved';
+
+export const AccessRequestStatus = {
+  Received: 'Received',
+  InCorrection: 'InCorrection',
+  InProgress: 'InProgress',
+  Resolved: 'Resolved',
+} satisfies Record<string, AccessRequestStatus>;
+
+export type AccessRequestResolution =
+  'Delivered' | 'PartiallyDelivered' | 'Denied' | 'Derived' | 'NonExistent' | 'Withdrawn';
+
+export const AccessRequestResolution = {
+  Delivered: 'Delivered',
+  PartiallyDelivered: 'PartiallyDelivered',
+  Denied: 'Denied',
+  Derived: 'Derived',
+  NonExistent: 'NonExistent',
+  Withdrawn: 'Withdrawn',
+} satisfies Record<string, AccessRequestResolution>;
+
+export type AccessRequestEventAction =
+  | 'Received'
+  | 'Updated'
+  | 'CorrectionRequested'
+  | 'Corrected'
+  | 'Assigned'
+  | 'ThirdPartyNotified'
+  | 'OppositionRegistered'
+  | 'Extended'
+  | 'Resolved'
+  | 'AppealRegistered';
+
+export const AccessRequestEventAction = {
+  Received: 'Received',
+  Updated: 'Updated',
+  CorrectionRequested: 'CorrectionRequested',
+  Corrected: 'Corrected',
+  Assigned: 'Assigned',
+  ThirdPartyNotified: 'ThirdPartyNotified',
+  OppositionRegistered: 'OppositionRegistered',
+  Extended: 'Extended',
+  Resolved: 'Resolved',
+  AppealRegistered: 'AppealRegistered',
+} satisfies Record<string, AccessRequestEventAction>;
+
 export interface DocumentTypeEntity {
   id: string;
   name: string;
@@ -413,6 +480,7 @@ export interface DocumentEntity {
   externalFolio?: string | null;
   externalSender?: string | null;
   externalDate?: string | null;
+  intakeMeans?: CommunicationMeans | null;
   composition?: JsonValue | null;
   contentText?: string | null;
   textExtractedAt?: string | null;
@@ -446,6 +514,8 @@ export interface DocumentEntity {
   accesses?: DocumentAccessEntity[];
   disposition?: DispositionRecordEntity | null;
   dispositionId?: string | null;
+  accessRequestResponses?: AccessRequestEntity[];
+  accessRequestDeliveries?: AccessRequestDocumentEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
@@ -800,6 +870,11 @@ export interface DocumentDispatchEntity {
   returnedByEmployeeId?: string | null;
   returnedByFullName?: string | null;
   returnReason?: string | null;
+  contingencyMeans?: CommunicationMeans | null;
+  contingencySentTo?: string | null;
+  contingencyReason?: string | null;
+  contingencyReceiptFileId?: string | null;
+  contingencyReceiptName?: string | null;
   document?: DocumentEntity;
   documentId: string;
   createdAt: string;
@@ -1014,4 +1089,63 @@ export interface DispositionRecordEntity {
   createdAt: string;
 }
 
+export interface AccessRequestEntity {
+  id: string;
+  number: number;
+  year: number;
+  externalFolio?: string | null;
+  channel: AccessRequestChannel;
+  receivedAt: string;
+  requesterName: string;
+  requesterEmail?: string | null;
+  requesterAddress?: string | null;
+  requestText: string;
+  deliveryFormat?: string | null;
+  status: AccessRequestStatus;
+  correctionRequestedAt?: string | null;
+  correctionDueAt?: string | null;
+  correctedAt?: string | null;
+  dueAt: string;
+  extendedAt?: string | null;
+  extensionNote?: string | null;
+  assigneeEmployeeId?: string | null;
+  assigneeFullName?: string | null;
+  thirdPartyNotifiedAt?: string | null;
+  oppositionDueAt?: string | null;
+  thirdPartyOpposed?: boolean | null;
+  resolution?: AccessRequestResolution | null;
+  resolvedAt?: string | null;
+  denialGrounds: string[];
+  derivedTo?: string | null;
+  resolutionNote?: string | null;
+  responseDocument?: DocumentEntity | null;
+  responseDocumentId?: string | null;
+  appealedAt?: string | null;
+  appealNote?: string | null;
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  documents?: AccessRequestDocumentEntity[];
+  events?: AccessRequestEventEntity[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface AccessRequestDocumentEntity {
+  accessRequest?: AccessRequestEntity;
+  accessRequestId: string;
+  document?: DocumentEntity;
+  documentId: string;
+}
+
+export interface AccessRequestEventEntity {
+  id: string;
+  action: AccessRequestEventAction;
+  note?: string | null;
+  employeeId?: string | null;
+  employeeFullName: string;
+  accessRequest?: AccessRequestEntity;
+  accessRequestId: string;
+  createdAt: string;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/accessRequest.contract.ts

@@ -0,0 +1,81 @@
+import { type AccessRequestChannel, type AccessRequestResolution } from '../base/entities';
+import {
+  type AccessRequestDetailEntity,
+  type AccessRequestListItemEntity,
+  type AccessRequestSummaryEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `accessRequest`: solicitudes de acceso a la información pública (Ley 20.285). */
+export const AccessRequestPatterns = {
+  getAll: 'gestorDocumental.accessRequest.getAll',
+  getById: 'gestorDocumental.accessRequest.getById',
+  getSummary: 'gestorDocumental.accessRequest.getSummary',
+  create: 'gestorDocumental.accessRequest.create',
+  update: 'gestorDocumental.accessRequest.update',
+  act: 'gestorDocumental.accessRequest.act',
+} as const;
+
+export interface AccessRequestWritePayload {
+  externalFolio?: string | null;
+  channel: AccessRequestChannel;
+  /** Fecha y hora de ingreso (ISO): desde ahí corren los 20 días hábiles. */
+  receivedAt: string;
+  requesterName: string;
+  requesterEmail?: string | null;
+  requesterAddress?: string | null;
+  requestText: string;
+  deliveryFormat?: string | null;
+}
+
+/** Lo que se hace con una solicitud, un paso a la vez. */
+export type AccessRequestAction =
+  | { type: 'requestCorrection'; note: string }
+  | { type: 'registerCorrection'; correctedAt?: string | null; note?: string | null }
+  | { type: 'assign'; employeeId: string; fullName: string; note?: string | null }
+  | { type: 'notifyThirdParty'; note: string }
+  | { type: 'registerOpposition'; opposed: boolean; note?: string | null }
+  | { type: 'extend'; note: string }
+  | {
+      type: 'resolve';
+      resolution: AccessRequestResolution;
+      grounds?: string[];
+      derivedTo?: string | null;
+      note?: string | null;
+      responseDocumentId?: string | null;
+      documentIds?: string[];
+    }
+  | { type: 'registerAppeal'; appealedAt?: string | null; note: string };
+
+export interface AccessRequestActor {
+  employeeId: string;
+  fullName: string;
+}
+
+export interface AccessRequestContract {
+  [AccessRequestPatterns.getAll]: {
+    payload: {
+      status?: 'open' | 'resolved' | 'all';
+      year?: number | null;
+      search?: string;
+      page?: number;
+      limit?: number;
+    };
+    response: RpcPage<AccessRequestListItemEntity[]>;
+  };
+  [AccessRequestPatterns.getById]: { payload: { id: string }; response: AccessRequestDetailEntity };
+  [AccessRequestPatterns.getSummary]: { payload: { year: number }; response: AccessRequestSummaryEntity };
+  [AccessRequestPatterns.create]: {
+    payload: AccessRequestWritePayload & { actor: AccessRequestActor };
+    response: AccessRequestDetailEntity;
+  };
+  /** Corrige los datos mientras no está resuelta. */
+  [AccessRequestPatterns.update]: {
+    payload: AccessRequestWritePayload & { id: string; actor: AccessRequestActor };
+    response: AccessRequestDetailEntity;
+  };
+  [AccessRequestPatterns.act]: {
+    payload: { id: string; action: AccessRequestAction; actor: AccessRequestActor };
+    response: AccessRequestDetailEntity;
+  };
+}

package/src/contracts/index.ts

@@ -10,6 +10,7 @@ import { AuditPatterns, type AuditContract } from './audit.contract';
 import { SignatureCheckPatterns, type SignatureCheckContract } from './signatureCheck.contract';
 import { RepositoryExportPatterns, type RepositoryExportContract } from './repositoryExport.contract';
 import { RetentionPatterns, type RetentionContract } from './retention.contract';
+import { AccessRequestPatterns, type AccessRequestContract } from './accessRequest.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -36,6 +37,7 @@ export * from './audit.contract';
 export * from './signatureCheck.contract';
 export * from './repositoryExport.contract';
 export * from './retention.contract';
+export * from './accessRequest.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -57,6 +59,7 @@ export const GestorDocumentalPatterns = {
   signatureCheck: SignatureCheckPatterns,
   repositoryExport: RepositoryExportPatterns,
   retention: RetentionPatterns,
+  accessRequest: AccessRequestPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -77,4 +80,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   AuditContract &
   SignatureCheckContract &
   RepositoryExportContract &
-  RetentionContract;
+  RetentionContract &
+  AccessRequestContract;

package/src/contracts/partsOffice.contract.ts

@@ -1,4 +1,4 @@
-import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
+import { type CommunicationMeans, type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
 import {
   type DocDigitalDocumentTypeEntity,
   type DocDigitalEntityEntity,
@@ -37,6 +37,8 @@ export const PartsOfficePatterns = {
   returnInbound: 'gestorDocumental.partsOffice.returnInbound',
   getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
   checkEnablement: 'gestorDocumental.partsOffice.checkEnablement',
+  dispatchByContingency: 'gestorDocumental.partsOffice.dispatchByContingency',
+  registerManualIntake: 'gestorDocumental.partsOffice.registerManualIntake',
 } as const;
 
 /** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
@@ -50,6 +52,30 @@ interface IListPayload<S> {
   filters?: { search?: string; status?: S };
 }
 
+/** Lo que llegó fuera de DocDigital y Oficina de Partes ingresa a mano. */
+export interface ManualIntakePayload {
+  file: { fileId: string; name: string };
+  attachments?: { fileId: string; name: string }[];
+  means: CommunicationMeans;
+  /** Cuándo llegó (ISO); sin él, ahora. */
+  receivedAt?: string | null;
+  senderEntityName: string;
+  senderName?: string | null;
+  externalFolio?: string | null;
+  externalDate?: string | null;
+  subject: string;
+  documentTypeId: string;
+  keywords: string[];
+  accessLevel?: DocumentAccessLevel;
+  hasSensitiveData?: boolean;
+  recipients: unknown[];
+  instruction: DocumentInstruction;
+  note?: string | null;
+  dueAt?: string | null;
+  dueBusinessDays?: number | null;
+  actor: DocumentActor;
+}
+
 export interface PartsOfficeContract {
   [PartsOfficePatterns.getStatus]: { payload: Record<string, never>; response: PartsOfficeStatusEntity };
   [PartsOfficePatterns.getSummary]: { payload: Record<string, never>; response: PartsOfficeSummaryEntity };
@@ -82,7 +108,11 @@ export interface PartsOfficeContract {
     response: PartsOfficeOkResponseEntity;
   };
   /** PDF firmado de un documento por despachar, para que Oficina de Partes lo revise. */
-  [PartsOfficePatterns.getDispatchFile]: { payload: { id: string }; response: PartsOfficeFileEntity };
+  [PartsOfficePatterns.getDispatchFile]: {
+    // con `receipt`, el comprobante del despacho por contingencia
+    payload: { id: string; receipt?: boolean };
+    response: PartsOfficeFileEntity;
+  };
   [PartsOfficePatterns.getInbound]: {
     payload: IListPayload<'Pending' | 'Registered' | 'Returned'>;
     response: RpcPage<PartsOfficeInboundEntity[]>;
@@ -131,4 +161,29 @@ export interface PartsOfficeContract {
     payload: { people: EnablementPersonInput[] };
     response: PartsOfficeEnablementEntity;
   };
+  /**
+   * Registro por contingencia: el documento no se pudo despachar por DocDigital y salió por otro medio. Queda
+   * despachado, con el medio, a quién, el motivo y el comprobante; si después se registra en DocDigital, su número.
+   */
+  [PartsOfficePatterns.dispatchByContingency]: {
+    payload: {
+      id: string;
+      means: CommunicationMeans;
+      sentAt: string;
+      sentTo: string;
+      reason: string;
+      receipt?: { fileId: string; name: string } | null;
+      docDigitalDocumentId?: string | null;
+      actor: DocumentActor;
+    };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /**
+   * Ingreso manual: lo que llegó fuera de DocDigital (papel, correo) entra con folio de ingreso, como lo recibido
+   * por DocDigital, y se deriva.
+   */
+  [PartsOfficePatterns.registerManualIntake]: {
+    payload: ManualIntakePayload;
+    response: PartsOfficeRegisterResponseEntity;
+  };
 }

package/src/entities/accessRequest/accessRequest.entity.ts

@@ -0,0 +1,78 @@
+import {
+  type AccessRequestChannel,
+  type AccessRequestEventAction,
+  type AccessRequestResolution,
+  type AccessRequestStatus,
+} from '../../base/entities';
+
+/** Semáforo del plazo de respuesta: a tiempo, por vencer (2 días hábiles o menos) o vencido. */
+export type AccessRequestDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+
+export interface AccessRequestListItemEntity {
+  id: string;
+  /** «N° 15/2026». */
+  label: string;
+  externalFolio: string | null;
+  channel: AccessRequestChannel;
+  requesterName: string;
+  requestText: string;
+  receivedAt: string;
+  dueAt: string;
+  status: AccessRequestStatus;
+  resolution: AccessRequestResolution | null;
+  assigneeFullName: string | null;
+  /** Solo mientras está abierta. */
+  dueStatus: AccessRequestDueStatus | null;
+  businessDaysLeft: number | null;
+  /** Ya resuelta: si se respondió dentro del plazo. */
+  resolvedOnTime: boolean | null;
+}
+
+export interface AccessRequestDocumentLinkEntity {
+  id: string;
+  folio: string | null;
+  subject: string;
+}
+
+export interface AccessRequestDetailEntity extends AccessRequestListItemEntity {
+  year: number;
+  number: number;
+  requesterEmail: string | null;
+  requesterAddress: string | null;
+  deliveryFormat: string | null;
+  correctionRequestedAt: string | null;
+  correctionDueAt: string | null;
+  correctedAt: string | null;
+  extendedAt: string | null;
+  extensionNote: string | null;
+  assigneeEmployeeId: string | null;
+  thirdPartyNotifiedAt: string | null;
+  oppositionDueAt: string | null;
+  thirdPartyOpposed: boolean | null;
+  resolvedAt: string | null;
+  denialGrounds: string[];
+  derivedTo: string | null;
+  resolutionNote: string | null;
+  responseDocument: AccessRequestDocumentLinkEntity | null;
+  documents: AccessRequestDocumentLinkEntity[];
+  appealedAt: string | null;
+  appealNote: string | null;
+  createdByFullName: string;
+  /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+  canExtend: boolean;
+  events: { action: AccessRequestEventAction; note: string | null; employeeFullName: string; createdAt: string }[];
+}
+
+export interface AccessRequestSummaryEntity {
+  year: number;
+  total: number;
+  open: number;
+  overdue: number;
+  dueSoon: number;
+  resolved: Record<AccessRequestResolution, number>;
+  /** Respondidas dentro del plazo sobre las respondidas, en %. */
+  onTimeRate: number | null;
+  /** Días hábiles promedio entre el ingreso (o la subsanación) y la respuesta. */
+  averageBusinessDays: number | null;
+  appealed: number;
+}

package/src/entities/accessRequest/index.ts

@@ -0,0 +1 @@
+export * from './accessRequest.entity';

package/src/entities/document/document.entity.ts

@@ -1,4 +1,5 @@
 import {
+  type CommunicationMeans,
   DocumentAnnulledNumberEntity,
   DocumentAttachmentEntity,
   DocumentDeliveryEntity,
@@ -101,6 +102,14 @@ export interface DocumentDispatchResponseEntity {
   returnedAt: string | null;
   returnedByFullName: string | null;
   returnReason: string | null;
+  /** Registro por contingencia: salió por otro medio porque no se pudo por DocDigital. */
+  contingency: {
+    means: CommunicationMeans;
+    sentTo: string | null;
+    reason: string | null;
+    /** Nombre del comprobante, si se adjuntó. */
+    receiptName: string | null;
+  } | null;
 }
 
 export interface DocumentGetAllResponseEntity {

package/src/entities/index.ts

@@ -16,3 +16,4 @@ export * from './audit';
 export * from './signatureCheck';
 export * from './repositoryExport';
 export * from './retention';
+export * from './accessRequest';