@muni-sanfer/types-gestor-documental 0.0.1-beta.4 → 0.0.1-beta.5

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';
+export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'Received';
 export declare const DocumentTrackingAction: {
     Created: "Created";
     Updated: "Updated";
@@ -49,6 +49,26 @@ export declare const DocumentTrackingAction: {
     Delivered: "Delivered";
     Derived: "Derived";
     Reassigned: "Reassigned";
+    Dispatched: "Dispatched";
+    DispatchReturned: "DispatchReturned";
+    Received: "Received";
+};
+export type DocumentOrigin = 'Internal' | 'DocDigital';
+export declare const DocumentOrigin: {
+    Internal: "Internal";
+    DocDigital: "DocDigital";
+};
+export type DocumentDispatchStatus = 'Pending' | 'Dispatched' | 'Returned';
+export declare const DocumentDispatchStatus: {
+    Pending: "Pending";
+    Dispatched: "Dispatched";
+    Returned: "Returned";
+};
+export type DocDigitalInboundStatus = 'Pending' | 'Registered' | 'Returned';
+export declare const DocDigitalInboundStatus: {
+    Pending: "Pending";
+    Registered: "Registered";
+    Returned: "Returned";
 };
 export type DocumentFlowStepType = 'Employee' | 'DirectorateHead';
 export declare const DocumentFlowStepType: {
@@ -173,6 +193,12 @@ export interface DocumentEntity {
     annulledAt?: string | null;
     annulmentReason?: string | null;
     responseDueAt?: string | null;
+    origin: DocumentOrigin;
+    intakeNumber?: number | null;
+    intakeYear?: number | null;
+    externalFolio?: string | null;
+    externalSender?: string | null;
+    externalDate?: string | null;
     replyTo?: DocumentEntity | null;
     replyToDocumentId?: string | null;
     replies?: DocumentEntity[];
@@ -195,6 +221,9 @@ export interface DocumentEntity {
     recipients?: DocumentRecipientEntity[];
     deliveries?: DocumentDeliveryEntity[];
     caseFileEntries?: CaseFileEntryEntity[];
+    externalRecipients?: DocumentExternalRecipientEntity[];
+    dispatch?: DocumentDispatchEntity | null;
+    docDigitalInbound?: DocDigitalInboundEntity | null;
     deleted: boolean;
     createdAt: string;
     updatedAt: string;
@@ -425,3 +454,74 @@ export interface CaseFileAccessEntity {
     caseFileId: string;
     createdAt: string;
 }
+export interface DocumentExternalRecipientEntity {
+    id: string;
+    entityId: number;
+    entityName: string;
+    userId?: number | null;
+    userName?: string | null;
+    userPosition?: string | null;
+    document?: DocumentEntity;
+    documentId: string;
+    createdAt: string;
+}
+export interface DocumentDispatchEntity {
+    id: string;
+    status: DocumentDispatchStatus;
+    folio?: string | null;
+    docDigitalTypeId?: number | null;
+    docDigitalTypeName?: string | null;
+    docDigitalDocumentId?: string | null;
+    docDigitalRequestId?: string | null;
+    dispatchedAt?: string | null;
+    dispatchedByEmployeeId?: string | null;
+    dispatchedByFullName?: string | null;
+    returnedAt?: string | null;
+    returnedByEmployeeId?: string | null;
+    returnedByFullName?: string | null;
+    returnReason?: string | null;
+    document?: DocumentEntity;
+    documentId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DocDigitalInboundEntity {
+    id: string;
+    docDigitalDocumentId: string;
+    docDigitalRequestId?: string | null;
+    status: DocDigitalInboundStatus;
+    subject: string;
+    description?: string | null;
+    folio?: string | null;
+    folioDate?: string | null;
+    typeName?: string | null;
+    reserved: boolean;
+    senderEntityId?: number | null;
+    senderEntityName?: string | null;
+    senderName?: string | null;
+    senderPosition?: string | null;
+    fileId?: string | null;
+    fileName?: string | null;
+    attachments: JsonValue;
+    registeredAt?: string | null;
+    registeredByEmployeeId?: string | null;
+    registeredByFullName?: string | null;
+    acknowledgedAt?: string | null;
+    acknowledgeError?: string | null;
+    returnedAt?: string | null;
+    returnedByEmployeeId?: string | null;
+    returnedByFullName?: string | null;
+    returnReason?: string | null;
+    document?: DocumentEntity | null;
+    documentId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface IntakeSequenceEntity {
+    year: number;
+    next: number;
+}
+type JsonValue = string | number | boolean | {
+    [key in string]?: JsonValue;
+} | Array<JsonValue> | null;
+export {};

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.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.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+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.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -47,6 +47,23 @@ exports.DocumentTrackingAction = {
     Delivered: 'Delivered',
     Derived: 'Derived',
     Reassigned: 'Reassigned',
+    Dispatched: 'Dispatched',
+    DispatchReturned: 'DispatchReturned',
+    Received: 'Received',
+};
+exports.DocumentOrigin = {
+    Internal: 'Internal',
+    DocDigital: 'DocDigital',
+};
+exports.DocumentDispatchStatus = {
+    Pending: 'Pending',
+    Dispatched: 'Dispatched',
+    Returned: 'Returned',
+};
+exports.DocDigitalInboundStatus = {
+    Pending: 'Pending',
+    Registered: 'Registered',
+    Returned: 'Returned',
 };
 exports.DocumentFlowStepType = {
     Employee: 'Employee',

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

@@ -73,9 +73,15 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
     recipients?: DocumentRecipientInput[];
     responseDueAt?: string | null;
     replyToDocumentId?: string | null;
+    externalRecipients?: DocumentExternalRecipientInput[];
     action?: 'Submit';
     actor: DocumentActor;
 }
+/** Destinatario externo: una institución de DocDigital y, si se indica, uno de sus usuarios. */
+export interface DocumentExternalRecipientInput {
+    entityId: number;
+    userId?: number | null;
+}
 /**
  * Qué se envía y qué se responde en cada patrón. Generado desde los handlers y los DTO del microservicio.
  */

package/dist/contracts/index.d.ts

@@ -1,12 +1,14 @@
 import { type CaseFileContract } from './caseFile.contract';
 import { type DocumentContract } from './document.contract';
 import { type DocumentTypeContract } from './documentType.contract';
+import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
 export * from './contract';
 export * from './document.contract';
 export * from './documentType.contract';
 export * from './procedure.contract';
 export * from './caseFile.contract';
+export * from './partsOffice.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -53,6 +55,24 @@ export declare const GestorDocumentalPatterns: {
         readonly getEntryFile: "gestorDocumental.caseFile.getEntryFile";
         readonly getExport: "gestorDocumental.caseFile.getExport";
     };
+    readonly partsOffice: {
+        readonly getStatus: "gestorDocumental.partsOffice.getStatus";
+        readonly getSummary: "gestorDocumental.partsOffice.getSummary";
+        readonly getEntities: "gestorDocumental.partsOffice.getEntities";
+        readonly getUsers: "gestorDocumental.partsOffice.getUsers";
+        readonly getDocumentTypes: "gestorDocumental.partsOffice.getDocumentTypes";
+        readonly getDispatches: "gestorDocumental.partsOffice.getDispatches";
+        readonly dispatch: "gestorDocumental.partsOffice.dispatch";
+        readonly returnDispatch: "gestorDocumental.partsOffice.returnDispatch";
+        readonly resendDispatch: "gestorDocumental.partsOffice.resendDispatch";
+        readonly getDispatchFile: "gestorDocumental.partsOffice.getDispatchFile";
+        readonly getInbound: "gestorDocumental.partsOffice.getInbound";
+        readonly syncInbound: "gestorDocumental.partsOffice.syncInbound";
+        readonly registerInbound: "gestorDocumental.partsOffice.registerInbound";
+        readonly acknowledgeInbound: "gestorDocumental.partsOffice.acknowledgeInbound";
+        readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
+        readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
+    };
 };
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
-export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & CaseFileContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & CaseFileContract & PartsOfficeContract;

package/dist/contracts/index.js

@@ -18,16 +18,19 @@ exports.GestorDocumentalPatterns = void 0;
 const caseFile_contract_1 = require("./caseFile.contract");
 const document_contract_1 = require("./document.contract");
 const documentType_contract_1 = require("./documentType.contract");
+const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
 __exportStar(require("./contract"), exports);
 __exportStar(require("./document.contract"), exports);
 __exportStar(require("./documentType.contract"), exports);
 __exportStar(require("./procedure.contract"), exports);
 __exportStar(require("./caseFile.contract"), exports);
+__exportStar(require("./partsOffice.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
     document: document_contract_1.DocumentPatterns,
     procedure: procedure_contract_1.ProcedurePatterns,
     caseFile: caseFile_contract_1.CaseFilePatterns,
+    partsOffice: partsOffice_contract_1.PartsOfficePatterns,
 };

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

@@ -0,0 +1,171 @@
+import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
+import { type DocDigitalDocumentTypeEntity, type DocDigitalEntityEntity, type PartsOfficeInboundEntity, type DocDigitalUserEntity, 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';
+/** Patrones NATS de `partsOffice` (Oficina de Partes y DocDigital): `<servicio>.<recurso>.<acción>`. */
+export declare const PartsOfficePatterns: {
+    readonly getStatus: "gestorDocumental.partsOffice.getStatus";
+    readonly getSummary: "gestorDocumental.partsOffice.getSummary";
+    readonly getEntities: "gestorDocumental.partsOffice.getEntities";
+    readonly getUsers: "gestorDocumental.partsOffice.getUsers";
+    readonly getDocumentTypes: "gestorDocumental.partsOffice.getDocumentTypes";
+    readonly getDispatches: "gestorDocumental.partsOffice.getDispatches";
+    readonly dispatch: "gestorDocumental.partsOffice.dispatch";
+    readonly returnDispatch: "gestorDocumental.partsOffice.returnDispatch";
+    readonly resendDispatch: "gestorDocumental.partsOffice.resendDispatch";
+    readonly getDispatchFile: "gestorDocumental.partsOffice.getDispatchFile";
+    readonly getInbound: "gestorDocumental.partsOffice.getInbound";
+    readonly syncInbound: "gestorDocumental.partsOffice.syncInbound";
+    readonly registerInbound: "gestorDocumental.partsOffice.registerInbound";
+    readonly acknowledgeInbound: "gestorDocumental.partsOffice.acknowledgeInbound";
+    readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
+    readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
+};
+/** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
+export type PartsOfficeRecipientInput = {
+    type: 'Employee';
+    employeeId: string;
+} | {
+    type: 'Directorate';
+    directorateCodeReference: number;
+    name: string;
+    memberEmployeeIds: string[];
+} | {
+    type: 'Department';
+    departmentId: string;
+    name: string;
+    memberEmployeeIds: string[];
+};
+interface IListPayload<S> {
+    pagination?: {
+        page?: number;
+        limit?: number;
+    };
+    filters?: {
+        search?: string;
+        status?: S;
+    };
+}
+export interface PartsOfficeContract {
+    [PartsOfficePatterns.getStatus]: {
+        payload: Record<string, never>;
+        response: PartsOfficeStatusEntity;
+    };
+    [PartsOfficePatterns.getSummary]: {
+        payload: Record<string, never>;
+        response: PartsOfficeSummaryEntity;
+    };
+    /** Directorio de DocDigital: instituciones por nombre. */
+    [PartsOfficePatterns.getEntities]: {
+        payload: {
+            search?: string;
+        };
+        response: DocDigitalEntityEntity[];
+    };
+    [PartsOfficePatterns.getUsers]: {
+        payload: {
+            entityId: number;
+            search?: string;
+        };
+        response: DocDigitalUserEntity[];
+    };
+    [PartsOfficePatterns.getDocumentTypes]: {
+        payload: Record<string, never>;
+        response: DocDigitalDocumentTypeEntity[];
+    };
+    [PartsOfficePatterns.getDispatches]: {
+        payload: IListPayload<'Pending' | 'Dispatched' | 'Returned'>;
+        response: RpcPage<PartsOfficeDispatchEntity[]>;
+    };
+    /** Despacha por DocDigital, con el número del documento como folio. `operatorRun`: RUN de quien despacha. */
+    [PartsOfficePatterns.dispatch]: {
+        payload: {
+            id: string;
+            docDigitalTypeId: number;
+            operatorRun?: string | null;
+            actor: DocumentActor;
+        };
+        response: PartsOfficeOkResponseEntity & {
+            docDigitalDocumentId: string;
+        };
+    };
+    /** Devuelve el despacho al redactor, con el motivo (por ejemplo, un destinatario equivocado). */
+    [PartsOfficePatterns.returnDispatch]: {
+        payload: {
+            id: string;
+            reason: string;
+            actor: DocumentActor;
+        };
+        response: PartsOfficeOkResponseEntity;
+    };
+    /** El redactor corrige las instituciones de destino de un despacho devuelto y lo envía de nuevo a Partes. */
+    [PartsOfficePatterns.resendDispatch]: {
+        payload: {
+            id: string;
+            externalRecipients: DocumentExternalRecipientInput[];
+            actor: DocumentActor;
+        };
+        response: PartsOfficeOkResponseEntity;
+    };
+    /** PDF firmado de un documento por despachar, para que Oficina de Partes lo revise. */
+    [PartsOfficePatterns.getDispatchFile]: {
+        payload: {
+            id: string;
+        };
+        response: PartsOfficeFileEntity;
+    };
+    [PartsOfficePatterns.getInbound]: {
+        payload: IListPayload<'Pending' | 'Registered' | 'Returned'>;
+        response: RpcPage<PartsOfficeInboundEntity[]>;
+    };
+    /** Trae de DocDigital lo recibido que aún no tiene acuse de recibo. */
+    [PartsOfficePatterns.syncInbound]: {
+        payload: Record<string, never>;
+        response: PartsOfficeSyncResponseEntity;
+    };
+    /**
+     * Ingresa un recibido al gestor: le da folio de ingreso, lo deriva a quienes corresponda y da el acuse de recibo
+     * en DocDigital.
+     */
+    [PartsOfficePatterns.registerInbound]: {
+        payload: {
+            id: string;
+            documentTypeId: string;
+            keywords: string[];
+            accessLevel: DocumentAccessLevel;
+            hasSensitiveData: boolean;
+            recipients: PartsOfficeRecipientInput[];
+            instruction: DocumentInstruction;
+            note?: string | null;
+            dueAt?: string | null;
+            actor: DocumentActor;
+        };
+        response: PartsOfficeRegisterResponseEntity;
+    };
+    /** Reintenta el acuse de recibo de un recibido ya ingresado. */
+    [PartsOfficePatterns.acknowledgeInbound]: {
+        payload: {
+            id: string;
+            actor: DocumentActor;
+        };
+        response: PartsOfficeOkResponseEntity;
+    };
+    /** Devuelve el recibido a la institución que lo envió, con el motivo (entre 3 y 255 caracteres). */
+    [PartsOfficePatterns.returnInbound]: {
+        payload: {
+            id: string;
+            reason: string;
+            actor: DocumentActor;
+        };
+        response: PartsOfficeOkResponseEntity;
+    };
+    /** Archivo de un recibido: el principal o, con `attachment`, uno de sus anexos (por su posición). */
+    [PartsOfficePatterns.getInboundFile]: {
+        payload: {
+            id: string;
+            attachment?: number;
+        };
+        response: PartsOfficeFileEntity;
+    };
+}
+export {};

package/dist/contracts/partsOffice.contract.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartsOfficePatterns = void 0;
+/** Patrones NATS de `partsOffice` (Oficina de Partes y DocDigital): `<servicio>.<recurso>.<acción>`. */
+exports.PartsOfficePatterns = {
+    getStatus: 'gestorDocumental.partsOffice.getStatus',
+    getSummary: 'gestorDocumental.partsOffice.getSummary',
+    getEntities: 'gestorDocumental.partsOffice.getEntities',
+    getUsers: 'gestorDocumental.partsOffice.getUsers',
+    getDocumentTypes: 'gestorDocumental.partsOffice.getDocumentTypes',
+    getDispatches: 'gestorDocumental.partsOffice.getDispatches',
+    dispatch: 'gestorDocumental.partsOffice.dispatch',
+    returnDispatch: 'gestorDocumental.partsOffice.returnDispatch',
+    resendDispatch: 'gestorDocumental.partsOffice.resendDispatch',
+    getDispatchFile: 'gestorDocumental.partsOffice.getDispatchFile',
+    getInbound: 'gestorDocumental.partsOffice.getInbound',
+    syncInbound: 'gestorDocumental.partsOffice.syncInbound',
+    registerInbound: 'gestorDocumental.partsOffice.registerInbound',
+    acknowledgeInbound: 'gestorDocumental.partsOffice.acknowledgeInbound',
+    returnInbound: 'gestorDocumental.partsOffice.returnInbound',
+    getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
+};

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

@@ -55,6 +55,31 @@ export interface DocumentLinkEntity {
     createdByFullName: DocumentEntity['createdByFullName'];
     finishedAt: DocumentEntity['finishedAt'];
     documentType: DocumentTypeSummaryEntity;
+    /** Folio de ingreso de Oficina de Partes, si llegó por DocDigital. */
+    intakeNumber: DocumentEntity['intakeNumber'];
+    intakeYear: DocumentEntity['intakeYear'];
+}
+/** Institución (y usuario) de DocDigital a la que va dirigido un documento. */
+export interface DocumentExternalRecipientResponseEntity {
+    id: string;
+    entityId: number;
+    entityName: string;
+    userId: number | null;
+    userName: string | null;
+    userPosition: string | null;
+}
+/** Despacho de un documento por DocDigital. */
+export interface DocumentDispatchResponseEntity {
+    id: string;
+    status: 'Pending' | 'Dispatched' | 'Returned';
+    folio: string | null;
+    docDigitalTypeName: string | null;
+    docDigitalDocumentId: string | null;
+    dispatchedAt: string | null;
+    dispatchedByFullName: string | null;
+    returnedAt: string | null;
+    returnedByFullName: string | null;
+    returnReason: string | null;
 }
 export interface DocumentGetAllResponseEntity {
     id: DocumentEntity['id'];
@@ -69,6 +94,9 @@ export interface DocumentGetAllResponseEntity {
     createdByEmployeeId: DocumentEntity['createdByEmployeeId'];
     createdByFullName: DocumentEntity['createdByFullName'];
     documentType: DocumentTypeSummaryEntity;
+    intakeNumber: DocumentEntity['intakeNumber'];
+    intakeYear: DocumentEntity['intakeYear'];
+    origin: DocumentEntity['origin'];
     currentParticipant: Pick<DocumentParticipantResponseEntity, 'role' | 'employeeId' | 'fullName'> | null;
     distribution: {
         total: number;
@@ -123,6 +151,16 @@ export interface DocumentGetByIdResponseEntity {
         title: string;
         status: 'Open' | 'Closed';
     }[];
+    /** De dónde viene: del gestor o recibido por DocDigital, con su folio de ingreso y los datos de quien lo envió. */
+    origin: DocumentEntity['origin'];
+    intakeNumber: DocumentEntity['intakeNumber'];
+    intakeYear: DocumentEntity['intakeYear'];
+    externalFolio: DocumentEntity['externalFolio'];
+    externalSender: DocumentEntity['externalSender'];
+    externalDate: DocumentEntity['externalDate'];
+    /** Instituciones de DocDigital a quienes va dirigido, y su despacho por Oficina de Partes. */
+    externalRecipients: DocumentExternalRecipientResponseEntity[];
+    dispatch: DocumentDispatchResponseEntity | null;
     documentType: DocumentTypeSummaryEntity;
     participants: DocumentParticipantResponseEntity[];
     attachments: {
@@ -147,6 +185,8 @@ export interface DocumentGetByIdResponseEntity {
         canDerive: boolean;
         canReply: boolean;
         canReassign: boolean;
+        /** Quien consulta redactó el documento (o lo ingresó, si llegó por DocDigital). */
+        isAuthor: boolean;
         inbox: DocumentDeliveryResponseEntity[];
     };
     signatureRequiresOtp: boolean;

package/dist/entities/index.d.ts

@@ -2,3 +2,4 @@ export * from './documentType';
 export * from './document';
 export * from './procedure';
 export * from './caseFile';
+export * from './partsOffice';

package/dist/entities/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./documentType"), exports);
 __exportStar(require("./document"), exports);
 __exportStar(require("./procedure"), exports);
 __exportStar(require("./caseFile"), exports);
+__exportStar(require("./partsOffice"), exports);

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

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

package/dist/entities/partsOffice/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("./partsOffice.entity"), exports);

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

@@ -0,0 +1,98 @@
+import { type DocumentDispatchResponseEntity, type DocumentExternalRecipientResponseEntity, type DocumentLinkEntity } from '../document';
+/** Institución del Estado en DocDigital. */
+export interface DocDigitalEntityEntity {
+    id: number;
+    name: string;
+    /** Organismo al que pertenece (la entidad padre). */
+    organism: string | null;
+}
+/** Usuario habilitado de una institución en DocDigital. */
+export interface DocDigitalUserEntity {
+    id: number;
+    name: string;
+    position: string | null;
+}
+export interface DocDigitalDocumentTypeEntity {
+    id: number;
+    name: string;
+}
+/** Si DocDigital está configurado en el gestor y cada cuánto se revisa lo recibido. */
+export interface PartsOfficeStatusEntity {
+    configured: boolean;
+    syncMinutes: number;
+}
+/** Totales del Panel de Partes. */
+export interface PartsOfficeSummaryEntity {
+    toDispatch: number;
+    received: number;
+}
+/** Documento firmado que va a otras instituciones: lo despacha Oficina de Partes. */
+export interface PartsOfficeDispatchEntity extends DocumentDispatchResponseEntity {
+    document: DocumentLinkEntity & {
+        accessLevel: string;
+    };
+    externalRecipients: DocumentExternalRecipientResponseEntity[];
+    createdAt: string;
+}
+/** Documento que llegó por DocDigital. */
+export interface PartsOfficeInboundEntity {
+    id: string;
+    docDigitalDocumentId: string;
+    status: 'Pending' | 'Registered' | 'Returned';
+    subject: string;
+    description: string | null;
+    folio: string | null;
+    folioDate: string | null;
+    typeName: string | null;
+    reserved: boolean;
+    senderEntityName: string | null;
+    senderName: string | null;
+    senderPosition: string | null;
+    fileName: string | null;
+    hasFile: boolean;
+    attachments: {
+        name: string;
+        url: string | null;
+        hasFile: boolean;
+    }[];
+    createdAt: string;
+    registeredAt: string | null;
+    registeredByFullName: string | null;
+    acknowledgedAt: string | null;
+    acknowledgeError: string | null;
+    returnedAt: string | null;
+    returnedByFullName: string | null;
+    returnReason: string | null;
+    /** El documento con que quedó ingresado al gestor. */
+    document: {
+        id: string;
+        intakeNumber: number | null;
+        intakeYear: number | null;
+    } | null;
+}
+export interface PartsOfficeOkResponseEntity {
+    id: string;
+    ok: boolean;
+    /** Documento al que corresponde el despacho (al despachar o devolver). */
+    documentId?: string;
+}
+export interface PartsOfficeSyncResponseEntity {
+    /** Recibidos nuevos que se trajeron. */
+    created: number;
+    /** Los que no se pudieron traer (se reintentan en la próxima revisión). */
+    failed: number;
+}
+export interface PartsOfficeRegisterResponseEntity {
+    id: string;
+    documentId: string;
+    intakeNumber: number;
+    intakeYear: number;
+    /** `false` si DocDigital no aceptó el acuse de recibo: se puede reintentar. */
+    acknowledged: boolean;
+    ok: boolean;
+}
+/** Archivo de un recibido, ya copiado al gestor. */
+export interface PartsOfficeFileEntity {
+    fileId: string;
+    fileName: string;
+}

package/dist/entities/partsOffice/partsOffice.entity.js

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

package/package.json

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

package/src/base/entities.ts

@@ -60,7 +60,10 @@ export type DocumentTrackingAction =
   | 'Annulled'
   | 'Delivered'
   | 'Derived'
-  | 'Reassigned';
+  | 'Reassigned'
+  | 'Dispatched'
+  | 'DispatchReturned'
+  | 'Received';
 
 export const DocumentTrackingAction = {
   Created: 'Created',
@@ -77,8 +80,34 @@ export const DocumentTrackingAction = {
   Delivered: 'Delivered',
   Derived: 'Derived',
   Reassigned: 'Reassigned',
+  Dispatched: 'Dispatched',
+  DispatchReturned: 'DispatchReturned',
+  Received: 'Received',
 } satisfies Record<string, DocumentTrackingAction>;
 
+export type DocumentOrigin = 'Internal' | 'DocDigital';
+
+export const DocumentOrigin = {
+  Internal: 'Internal',
+  DocDigital: 'DocDigital',
+} satisfies Record<string, DocumentOrigin>;
+
+export type DocumentDispatchStatus = 'Pending' | 'Dispatched' | 'Returned';
+
+export const DocumentDispatchStatus = {
+  Pending: 'Pending',
+  Dispatched: 'Dispatched',
+  Returned: 'Returned',
+} satisfies Record<string, DocumentDispatchStatus>;
+
+export type DocDigitalInboundStatus = 'Pending' | 'Registered' | 'Returned';
+
+export const DocDigitalInboundStatus = {
+  Pending: 'Pending',
+  Registered: 'Registered',
+  Returned: 'Returned',
+} satisfies Record<string, DocDigitalInboundStatus>;
+
 export type DocumentFlowStepType = 'Employee' | 'DirectorateHead';
 
 export const DocumentFlowStepType = {
@@ -246,6 +275,12 @@ export interface DocumentEntity {
   annulledAt?: string | null;
   annulmentReason?: string | null;
   responseDueAt?: string | null;
+  origin: DocumentOrigin;
+  intakeNumber?: number | null;
+  intakeYear?: number | null;
+  externalFolio?: string | null;
+  externalSender?: string | null;
+  externalDate?: string | null;
   replyTo?: DocumentEntity | null;
   replyToDocumentId?: string | null;
   replies?: DocumentEntity[];
@@ -268,6 +303,9 @@ export interface DocumentEntity {
   recipients?: DocumentRecipientEntity[];
   deliveries?: DocumentDeliveryEntity[];
   caseFileEntries?: CaseFileEntryEntity[];
+  externalRecipients?: DocumentExternalRecipientEntity[];
+  dispatch?: DocumentDispatchEntity | null;
+  docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
   createdAt: string;
   updatedAt: string;
@@ -514,3 +552,76 @@ export interface CaseFileAccessEntity {
   caseFileId: string;
   createdAt: string;
 }
+
+export interface DocumentExternalRecipientEntity {
+  id: string;
+  entityId: number;
+  entityName: string;
+  userId?: number | null;
+  userName?: string | null;
+  userPosition?: string | null;
+  document?: DocumentEntity;
+  documentId: string;
+  createdAt: string;
+}
+
+export interface DocumentDispatchEntity {
+  id: string;
+  status: DocumentDispatchStatus;
+  folio?: string | null;
+  docDigitalTypeId?: number | null;
+  docDigitalTypeName?: string | null;
+  docDigitalDocumentId?: string | null;
+  docDigitalRequestId?: string | null;
+  dispatchedAt?: string | null;
+  dispatchedByEmployeeId?: string | null;
+  dispatchedByFullName?: string | null;
+  returnedAt?: string | null;
+  returnedByEmployeeId?: string | null;
+  returnedByFullName?: string | null;
+  returnReason?: string | null;
+  document?: DocumentEntity;
+  documentId: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface DocDigitalInboundEntity {
+  id: string;
+  docDigitalDocumentId: string;
+  docDigitalRequestId?: string | null;
+  status: DocDigitalInboundStatus;
+  subject: string;
+  description?: string | null;
+  folio?: string | null;
+  folioDate?: string | null;
+  typeName?: string | null;
+  reserved: boolean;
+  senderEntityId?: number | null;
+  senderEntityName?: string | null;
+  senderName?: string | null;
+  senderPosition?: string | null;
+  fileId?: string | null;
+  fileName?: string | null;
+  attachments: JsonValue;
+  registeredAt?: string | null;
+  registeredByEmployeeId?: string | null;
+  registeredByFullName?: string | null;
+  acknowledgedAt?: string | null;
+  acknowledgeError?: string | null;
+  returnedAt?: string | null;
+  returnedByEmployeeId?: string | null;
+  returnedByFullName?: string | null;
+  returnReason?: string | null;
+  document?: DocumentEntity | null;
+  documentId?: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface IntakeSequenceEntity {
+  year: number;
+  next: number;
+}
+
+type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/document.contract.ts

@@ -102,10 +102,18 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
   responseDueAt?: string | null;
   // Documento al que este responde.
   replyToDocumentId?: string | null;
+  // Instituciones (y usuarios) de DocDigital a quienes va: al terminar la firma pasa a Oficina de Partes.
+  externalRecipients?: DocumentExternalRecipientInput[];
   action?: 'Submit';
   actor: DocumentActor;
 }
 
+/** Destinatario externo: una institución de DocDigital y, si se indica, uno de sus usuarios. */
+export interface DocumentExternalRecipientInput {
+  entityId: number;
+  userId?: number | null;
+}
+
 /**
  * Qué se envía y qué se responde en cada patrón. Generado desde los handlers y los DTO del microservicio.
  */

package/src/contracts/index.ts

@@ -1,6 +1,7 @@
 import { CaseFilePatterns, type CaseFileContract } from './caseFile.contract';
 import { DocumentPatterns, type DocumentContract } from './document.contract';
 import { DocumentTypePatterns, type DocumentTypeContract } from './documentType.contract';
+import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
 
 export * from './contract';
@@ -8,6 +9,7 @@ export * from './document.contract';
 export * from './documentType.contract';
 export * from './procedure.contract';
 export * from './caseFile.contract';
+export * from './partsOffice.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -15,7 +17,12 @@ export const GestorDocumentalPatterns = {
   document: DocumentPatterns,
   procedure: ProcedurePatterns,
   caseFile: CaseFilePatterns,
+  partsOffice: PartsOfficePatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
-export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & CaseFileContract;
+export type GestorDocumentalContract = DocumentTypeContract &
+  DocumentContract &
+  ProcedureContract &
+  CaseFileContract &
+  PartsOfficeContract;

package/src/contracts/partsOffice.contract.ts

@@ -0,0 +1,120 @@
+import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
+import {
+  type DocDigitalDocumentTypeEntity,
+  type DocDigitalEntityEntity,
+  type PartsOfficeInboundEntity,
+  type DocDigitalUserEntity,
+  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';
+
+/** Patrones NATS de `partsOffice` (Oficina de Partes y DocDigital): `<servicio>.<recurso>.<acción>`. */
+export const PartsOfficePatterns = {
+  getStatus: 'gestorDocumental.partsOffice.getStatus',
+  getSummary: 'gestorDocumental.partsOffice.getSummary',
+  getEntities: 'gestorDocumental.partsOffice.getEntities',
+  getUsers: 'gestorDocumental.partsOffice.getUsers',
+  getDocumentTypes: 'gestorDocumental.partsOffice.getDocumentTypes',
+  getDispatches: 'gestorDocumental.partsOffice.getDispatches',
+  dispatch: 'gestorDocumental.partsOffice.dispatch',
+  returnDispatch: 'gestorDocumental.partsOffice.returnDispatch',
+  resendDispatch: 'gestorDocumental.partsOffice.resendDispatch',
+  getDispatchFile: 'gestorDocumental.partsOffice.getDispatchFile',
+  getInbound: 'gestorDocumental.partsOffice.getInbound',
+  syncInbound: 'gestorDocumental.partsOffice.syncInbound',
+  registerInbound: 'gestorDocumental.partsOffice.registerInbound',
+  acknowledgeInbound: 'gestorDocumental.partsOffice.acknowledgeInbound',
+  returnInbound: 'gestorDocumental.partsOffice.returnInbound',
+  getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
+} as const;
+
+/** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
+export type PartsOfficeRecipientInput =
+  | { type: 'Employee'; employeeId: string }
+  | { type: 'Directorate'; directorateCodeReference: number; name: string; memberEmployeeIds: string[] }
+  | { type: 'Department'; departmentId: string; name: string; memberEmployeeIds: string[] };
+
+interface IListPayload<S> {
+  pagination?: { page?: number; limit?: number };
+  filters?: { search?: string; status?: S };
+}
+
+export interface PartsOfficeContract {
+  [PartsOfficePatterns.getStatus]: { payload: Record<string, never>; response: PartsOfficeStatusEntity };
+  [PartsOfficePatterns.getSummary]: { payload: Record<string, never>; response: PartsOfficeSummaryEntity };
+  /** Directorio de DocDigital: instituciones por nombre. */
+  [PartsOfficePatterns.getEntities]: { payload: { search?: string }; response: DocDigitalEntityEntity[] };
+  [PartsOfficePatterns.getUsers]: {
+    payload: { entityId: number; search?: string };
+    response: DocDigitalUserEntity[];
+  };
+  [PartsOfficePatterns.getDocumentTypes]: { payload: Record<string, never>; response: DocDigitalDocumentTypeEntity[] };
+  [PartsOfficePatterns.getDispatches]: {
+    payload: IListPayload<'Pending' | 'Dispatched' | 'Returned'>;
+    response: RpcPage<PartsOfficeDispatchEntity[]>;
+  };
+  /** Despacha por DocDigital, con el número del documento como folio. `operatorRun`: RUN de quien despacha. */
+  [PartsOfficePatterns.dispatch]: {
+    payload: { id: string; docDigitalTypeId: number; operatorRun?: string | null; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity & { docDigitalDocumentId: string };
+  };
+  /** Devuelve el despacho al redactor, con el motivo (por ejemplo, un destinatario equivocado). */
+  [PartsOfficePatterns.returnDispatch]: {
+    payload: { id: string; reason: string; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /** El redactor corrige las instituciones de destino de un despacho devuelto y lo envía de nuevo a Partes. */
+  [PartsOfficePatterns.resendDispatch]: {
+    payload: { id: string; externalRecipients: DocumentExternalRecipientInput[]; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /** PDF firmado de un documento por despachar, para que Oficina de Partes lo revise. */
+  [PartsOfficePatterns.getDispatchFile]: { payload: { id: string }; response: PartsOfficeFileEntity };
+  [PartsOfficePatterns.getInbound]: {
+    payload: IListPayload<'Pending' | 'Registered' | 'Returned'>;
+    response: RpcPage<PartsOfficeInboundEntity[]>;
+  };
+  /** Trae de DocDigital lo recibido que aún no tiene acuse de recibo. */
+  [PartsOfficePatterns.syncInbound]: { payload: Record<string, never>; response: PartsOfficeSyncResponseEntity };
+  /**
+   * Ingresa un recibido al gestor: le da folio de ingreso, lo deriva a quienes corresponda y da el acuse de recibo
+   * en DocDigital.
+   */
+  [PartsOfficePatterns.registerInbound]: {
+    payload: {
+      id: string;
+      documentTypeId: string;
+      keywords: string[];
+      accessLevel: DocumentAccessLevel;
+      hasSensitiveData: boolean;
+      recipients: PartsOfficeRecipientInput[];
+      instruction: DocumentInstruction;
+      note?: string | null;
+      dueAt?: string | null;
+      actor: DocumentActor;
+    };
+    response: PartsOfficeRegisterResponseEntity;
+  };
+  /** Reintenta el acuse de recibo de un recibido ya ingresado. */
+  [PartsOfficePatterns.acknowledgeInbound]: {
+    payload: { id: string; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /** Devuelve el recibido a la institución que lo envió, con el motivo (entre 3 y 255 caracteres). */
+  [PartsOfficePatterns.returnInbound]: {
+    payload: { id: string; reason: string; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /** Archivo de un recibido: el principal o, con `attachment`, uno de sus anexos (por su posición). */
+  [PartsOfficePatterns.getInboundFile]: {
+    payload: { id: string; attachment?: number };
+    response: PartsOfficeFileEntity;
+  };
+}

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

@@ -72,6 +72,33 @@ export interface DocumentLinkEntity {
   createdByFullName: DocumentEntity['createdByFullName'];
   finishedAt: DocumentEntity['finishedAt'];
   documentType: DocumentTypeSummaryEntity;
+  /** Folio de ingreso de Oficina de Partes, si llegó por DocDigital. */
+  intakeNumber: DocumentEntity['intakeNumber'];
+  intakeYear: DocumentEntity['intakeYear'];
+}
+
+/** Institución (y usuario) de DocDigital a la que va dirigido un documento. */
+export interface DocumentExternalRecipientResponseEntity {
+  id: string;
+  entityId: number;
+  entityName: string;
+  userId: number | null;
+  userName: string | null;
+  userPosition: string | null;
+}
+
+/** Despacho de un documento por DocDigital. */
+export interface DocumentDispatchResponseEntity {
+  id: string;
+  status: 'Pending' | 'Dispatched' | 'Returned';
+  folio: string | null;
+  docDigitalTypeName: string | null;
+  docDigitalDocumentId: string | null;
+  dispatchedAt: string | null;
+  dispatchedByFullName: string | null;
+  returnedAt: string | null;
+  returnedByFullName: string | null;
+  returnReason: string | null;
 }
 
 export interface DocumentGetAllResponseEntity {
@@ -87,6 +114,9 @@ export interface DocumentGetAllResponseEntity {
   createdByEmployeeId: DocumentEntity['createdByEmployeeId'];
   createdByFullName: DocumentEntity['createdByFullName'];
   documentType: DocumentTypeSummaryEntity;
+  intakeNumber: DocumentEntity['intakeNumber'];
+  intakeYear: DocumentEntity['intakeYear'];
+  origin: DocumentEntity['origin'];
   // A quién le toca visar o firmar (null si el documento no está en tramitación).
   currentParticipant: Pick<DocumentParticipantResponseEntity, 'role' | 'employeeId' | 'fullName'> | null;
   // A cuántos funcionarios llegó y cuántos ya lo abrieron (null si aún no se distribuye a nadie).
@@ -147,6 +177,16 @@ export interface DocumentGetByIdResponseEntity {
   replies: DocumentLinkEntity[];
   /** Expedientes en que está incorporado y que quien consulta puede ver. */
   caseFiles: { id: string; code: string; title: string; status: 'Open' | 'Closed' }[];
+  /** De dónde viene: del gestor o recibido por DocDigital, con su folio de ingreso y los datos de quien lo envió. */
+  origin: DocumentEntity['origin'];
+  intakeNumber: DocumentEntity['intakeNumber'];
+  intakeYear: DocumentEntity['intakeYear'];
+  externalFolio: DocumentEntity['externalFolio'];
+  externalSender: DocumentEntity['externalSender'];
+  externalDate: DocumentEntity['externalDate'];
+  /** Instituciones de DocDigital a quienes va dirigido, y su despacho por Oficina de Partes. */
+  externalRecipients: DocumentExternalRecipientResponseEntity[];
+  dispatch: DocumentDispatchResponseEntity | null;
   documentType: DocumentTypeSummaryEntity;
   participants: DocumentParticipantResponseEntity[];
   attachments: {
@@ -175,6 +215,8 @@ export interface DocumentGetByIdResponseEntity {
     canReply: boolean;
     // Es quien redactó un documento en tramitación: puede pasar un turno pendiente a otro funcionario.
     canReassign: boolean;
+    /** Quien consulta redactó el documento (o lo ingresó, si llegó por DocDigital). */
+    isAuthor: boolean;
     // Sus propias entregas de este documento (puede tener más de una si además se lo derivaron).
     inbox: DocumentDeliveryResponseEntity[];
   };

package/src/entities/index.ts

@@ -2,3 +2,4 @@ export * from './documentType';
 export * from './document';
 export * from './procedure';
 export * from './caseFile';
+export * from './partsOffice';

package/src/entities/partsOffice/index.ts

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

package/src/entities/partsOffice/partsOffice.entity.ts

@@ -0,0 +1,103 @@
+import {
+  type DocumentDispatchResponseEntity,
+  type DocumentExternalRecipientResponseEntity,
+  type DocumentLinkEntity,
+} from '../document';
+
+/** Institución del Estado en DocDigital. */
+export interface DocDigitalEntityEntity {
+  id: number;
+  name: string;
+  /** Organismo al que pertenece (la entidad padre). */
+  organism: string | null;
+}
+
+/** Usuario habilitado de una institución en DocDigital. */
+export interface DocDigitalUserEntity {
+  id: number;
+  name: string;
+  position: string | null;
+}
+
+export interface DocDigitalDocumentTypeEntity {
+  id: number;
+  name: string;
+}
+
+/** Si DocDigital está configurado en el gestor y cada cuánto se revisa lo recibido. */
+export interface PartsOfficeStatusEntity {
+  configured: boolean;
+  syncMinutes: number;
+}
+
+/** Totales del Panel de Partes. */
+export interface PartsOfficeSummaryEntity {
+  toDispatch: number;
+  received: number;
+}
+
+/** Documento firmado que va a otras instituciones: lo despacha Oficina de Partes. */
+export interface PartsOfficeDispatchEntity extends DocumentDispatchResponseEntity {
+  document: DocumentLinkEntity & { accessLevel: string };
+  externalRecipients: DocumentExternalRecipientResponseEntity[];
+  createdAt: string;
+}
+
+/** Documento que llegó por DocDigital. */
+export interface PartsOfficeInboundEntity {
+  id: string;
+  docDigitalDocumentId: string;
+  status: 'Pending' | 'Registered' | 'Returned';
+  subject: string;
+  description: string | null;
+  folio: string | null;
+  folioDate: string | null;
+  typeName: string | null;
+  reserved: boolean;
+  senderEntityName: string | null;
+  senderName: string | null;
+  senderPosition: string | null;
+  fileName: string | null;
+  hasFile: boolean;
+  attachments: { name: string; url: string | null; hasFile: boolean }[];
+  createdAt: string;
+  registeredAt: string | null;
+  registeredByFullName: string | null;
+  acknowledgedAt: string | null;
+  acknowledgeError: string | null;
+  returnedAt: string | null;
+  returnedByFullName: string | null;
+  returnReason: string | null;
+  /** El documento con que quedó ingresado al gestor. */
+  document: { id: string; intakeNumber: number | null; intakeYear: number | null } | null;
+}
+
+export interface PartsOfficeOkResponseEntity {
+  id: string;
+  ok: boolean;
+  /** Documento al que corresponde el despacho (al despachar o devolver). */
+  documentId?: string;
+}
+
+export interface PartsOfficeSyncResponseEntity {
+  /** Recibidos nuevos que se trajeron. */
+  created: number;
+  /** Los que no se pudieron traer (se reintentan en la próxima revisión). */
+  failed: number;
+}
+
+export interface PartsOfficeRegisterResponseEntity {
+  id: string;
+  documentId: string;
+  intakeNumber: number;
+  intakeYear: number;
+  /** `false` si DocDigital no aceptó el acuse de recibo: se puede reintentar. */
+  acknowledged: boolean;
+  ok: boolean;
+}
+
+/** Archivo de un recibido, ya copiado al gestor. */
+export interface PartsOfficeFileEntity {
+  fileId: string;
+  fileName: string;
+}