@bisondesk/documents-sdk 1.0.317 → 1.0.319

package/lib/utils/associations.d.ts

@@ -0,0 +1,6 @@
+import { BusinessEntityIds } from '@bisondesk/commons-sdk/constants';
+import { GlobalBusinessEntity } from '@bisondesk/core-sdk/utils/search';
+import { Association } from '../types/documents.js';
+export type SupportedAssociationEntity = GlobalBusinessEntity;
+export declare const getAssociationForBusinessEntity: (businessEntityId: BusinessEntityIds, record: SupportedAssociationEntity) => Association;
+//# sourceMappingURL=associations.d.ts.map

package/lib/utils/associations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"associations.d.ts","sourceRoot":"/","sources":["utils/associations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACL,oBAAoB,EAIrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAE9D,eAAO,MAAM,+BAA+B,qBACxB,iBAAiB,UAC3B,0BAA0B,KACjC,WAMD,CAAC"}

package/lib/utils/associations.js

@@ -0,0 +1,9 @@
+import { getDescriptionForBusinessEntity, getTagsForBusinessEntity, getTitleForBusinessEntity, } from '@bisondesk/core-sdk/utils/search';
+export const getAssociationForBusinessEntity = (businessEntityId, record) => ({
+    businessEntityId,
+    recordId: record.id,
+    title: getTitleForBusinessEntity(businessEntityId, record),
+    description: getDescriptionForBusinessEntity(businessEntityId, record),
+    tags: getTagsForBusinessEntity(businessEntityId, record),
+});
+//# sourceMappingURL=associations.js.map

package/lib/utils/associations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"associations.js","sourceRoot":"/","sources":["utils/associations.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,+BAA+B,EAC/B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,kCAAkC,CAAC;AAK1C,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC7C,gBAAmC,EACnC,MAAkC,EACrB,EAAE,CAAC,CAAC;IACjB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC,EAAE;IACnB,KAAK,EAAE,yBAAyB,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC1D,WAAW,EAAE,+BAA+B,CAAC,gBAAgB,EAAE,MAAM,CAAC;IACtE,IAAI,EAAE,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACzD,CAAC,CAAC","sourcesContent":["import { BusinessEntityIds } from '@bisondesk/commons-sdk/constants';\nimport {\n  GlobalBusinessEntity,\n  getDescriptionForBusinessEntity,\n  getTagsForBusinessEntity,\n  getTitleForBusinessEntity,\n} from '@bisondesk/core-sdk/utils/search';\nimport { Association } from '../types/documents.js';\n\nexport type SupportedAssociationEntity = GlobalBusinessEntity;\n\nexport const getAssociationForBusinessEntity = (\n  businessEntityId: BusinessEntityIds,\n  record: SupportedAssociationEntity\n): Association => ({\n  businessEntityId,\n  recordId: record.id,\n  title: getTitleForBusinessEntity(businessEntityId, record),\n  description: getDescriptionForBusinessEntity(businessEntityId, record),\n  tags: getTagsForBusinessEntity(businessEntityId, record),\n});\n"]}

package/lib/{utils.d.ts → utils/previews.d.ts}

@@ -1,2 +1,2 @@
 export declare const getPdfPreviewSrc: (fileUrl: string) => string;
-//# sourceMappingURL=utils.d.ts.map
+//# sourceMappingURL=previews.d.ts.map

package/lib/utils/previews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previews.d.ts","sourceRoot":"/","sources":["utils/previews.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,YAAa,MAAM,WAAsC,CAAC"}

package/lib/{utils.js → utils/previews.js}

@@ -1,2 +1,2 @@
 export const getPdfPreviewSrc = (fileUrl) => fileUrl.replace('.pdf', '/1.jpg');
-//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=previews.js.map

package/lib/utils/previews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previews.js","sourceRoot":"/","sources":["utils/previews.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC","sourcesContent":["export const getPdfPreviewSrc = (fileUrl: string) => fileUrl.replace('.pdf', '/1.jpg');\n"]}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@bisondesk/documents-sdk",
-  "version": "1.0.317",
+  "version": "1.0.319",
   "description": "",
   "type": "module",
   "scripts": {
-    "build": "npx tsc --build",
+    "build": "npx tsc --build tsconfig.deploy.json",
     "clean": "rm -rf lib *.tsbuildinfo",
     "unittest": "echo \"No test specified\"",
     "integrationtest": "echo \"No test specified\"",

package/src/apis/document-drafts.ts

@@ -0,0 +1,68 @@
+import {
+  FinanceDocumentCategory,
+  FinanceDocumentLineCategory,
+} from '../types/document-categories.js';
+import { getAdminAuth } from '@bisondesk/commons-sdk/fetch';
+import fetch, { Response } from 'node-fetch';
+import { TENANT_ID_ADMIN_HEADER } from '@bisondesk/commons-sdk/constants';
+import { XError } from '@bisondesk/commons-sdk/errors';
+
+export const getFinanceDocumentCategory = async (
+  tenantId: string,
+  branchId: string,
+  docCategoryId: string
+): Promise<FinanceDocumentCategory | undefined> => {
+  const auth = await getAdminAuth();
+  const response: Response = await fetch(
+    `${process.env.DOCUMENT_DRAFTS_API_ORIGIN}/api/documents/settings/${branchId}/document-categories/${docCategoryId}`,
+    {
+      headers: {
+        Authorization: auth,
+        [TENANT_ID_ADMIN_HEADER]: tenantId,
+      },
+    }
+  );
+
+  if (response.status === 200) {
+    return response.json() as any;
+  }
+
+  const body = await response.text();
+  throw new XError('documents-sdk.drafts.get-doc-category-fail', {
+    tenantId,
+    branchId,
+    docCategoryId,
+    response: body,
+    status: response.status,
+  });
+};
+
+export const listFinanceLineCategories = async (
+  tenantId: string,
+  branchId: string,
+  docCategoryId: string
+): Promise<FinanceDocumentLineCategory[]> => {
+  const auth = await getAdminAuth();
+  const response: Response = await fetch(
+    `${process.env.DOCUMENT_DRAFTS_API_ORIGIN}/api/documents/settings/${branchId}/document-categories/${docCategoryId}/line-categories`,
+    {
+      headers: {
+        Authorization: auth,
+        [TENANT_ID_ADMIN_HEADER]: tenantId,
+      },
+    }
+  );
+
+  if (response.status === 200) {
+    return response.json() as any;
+  }
+
+  const body = await response.text();
+  throw new XError('documents-sdk.drafts.get-doc-lines-categories-fail', {
+    tenantId,
+    branchId,
+    docCategoryId,
+    response: body,
+    status: response.status,
+  });
+};

package/src/apis/documents.ts

@@ -1,10 +1,67 @@
 import { TENANT_ID_ADMIN_HEADER } from '@bisondesk/commons-sdk/constants';
 import { XError } from '@bisondesk/commons-sdk/errors';
 import { getAdminAuth } from '@bisondesk/commons-sdk/fetch';
+import { DataRecord, ReferenceData } from '@bisondesk/core-sdk/types/utils';
 import fetch, { Response } from 'node-fetch';
 import { FinanceBooking } from '../types/booking.js';
 import { AdministrativeDocument, FinanceDocument } from '../types/documents.js';
 
+export const getFinanceDocument = async (
+  tenantId: string,
+  documentId: string
+): Promise<DataRecord<FinanceDocument, ReferenceData> | undefined> => {
+  const auth = await getAdminAuth();
+  const response: Response = await fetch(
+    `${process.env.CORE_API_ORIGIN}/api/documents/finance/${documentId}`,
+    {
+      headers: {
+        Authorization: auth,
+        [TENANT_ID_ADMIN_HEADER]: tenantId,
+      },
+    }
+  );
+
+  if (response.status === 200) {
+    return response.json() as any;
+  }
+
+  const body = await response.text();
+  throw new XError('documents-sdk.get-finance-doc-fail', {
+    tenantId,
+    documentId,
+    response: body,
+    status: response.status,
+  });
+};
+
+export const getFinanceBookingByDocId = async (
+  tenantId: string,
+  documentId: string
+): Promise<FinanceBooking | undefined> => {
+  const auth = await getAdminAuth();
+  const response: Response = await fetch(
+    `${process.env.CORE_API_ORIGIN}/api/documents/finance/${documentId}/booking`,
+    {
+      headers: {
+        Authorization: auth,
+        [TENANT_ID_ADMIN_HEADER]: tenantId,
+      },
+    }
+  );
+
+  if (response.status === 200) {
+    return response.json() as any;
+  }
+
+  const body = await response.text();
+  throw new XError('documents-sdk.get-finance-booking-fail', {
+    tenantId,
+    documentId,
+    response: body,
+    status: response.status,
+  });
+};
+
 export const upsertFinanceDoc = async (
   tenantId: string,
   doc: FinanceDocument
@@ -25,7 +82,7 @@ export const upsertFinanceDoc = async (
   }
 
   const body = await response.text();
-  throw new XError('core-sdk.documents.upsert-finance-doc-fail', {
+  throw new XError('documents-sdk.upsert-finance-doc-fail', {
     tenantId,
     doc,
     response: body,
@@ -56,7 +113,7 @@ export const upsertAdminDoc = async (
   }
 
   const body = await response.text();
-  throw new XError('core-sdk.documents.upsert-admin-doc-fail', {
+  throw new XError('documents-sdk.upsert-admin-doc-fail', {
     tenantId,
     doc,
     response: body,
@@ -87,7 +144,7 @@ export const upsertFinanceBooking = async (
   }
 
   const body = await response.text();
-  throw new XError('core-sdk.documents.upsert-finance-booking-fail', {
+  throw new XError('documents-sdk.upsert-finance-booking-fail', {
     tenantId,
     booking,
     response: body,

package/src/schemas.ts

@@ -0,0 +1,112 @@
+import { BusinessEntityIds } from '@bisondesk/commons-sdk/constants';
+import { attachmentValueSchema, getPhoneSchema } from '@bisondesk/commons/joi-schemas';
+import { FinanceDocType } from '@bisondesk/documents-sdk/types/documents';
+import Joi from 'joi';
+
+const orgSummarySchema = Joi.object({
+  id: Joi.string().required(),
+  code: Joi.number().required(),
+  name: Joi.string().required(),
+  language: Joi.string().required(),
+  vatNumber: Joi.string(),
+  addressLine1: Joi.string(),
+  addressLine2: Joi.string(),
+  postcode: Joi.string(),
+  city: Joi.string(),
+  country: Joi.string().required(),
+  emails: Joi.array().items(Joi.string().email()),
+  phone: getPhoneSchema(),
+  contact: Joi.object({
+    name: Joi.string().required(),
+    username: Joi.string().required(),
+  }),
+});
+
+const associationsSchema = Joi.array().items(
+  Joi.object({
+    businessEntityId: Joi.string()
+      .valid(...Object.values(BusinessEntityIds))
+      .required(),
+    recordId: Joi.string().required(),
+    title: Joi.string().required(),
+    description: Joi.string().required(),
+    tags: Joi.array().items(Joi.string()),
+  })
+);
+
+export const lineSchema = Joi.object({
+  category: Joi.string().required(),
+  amount: Joi.string().required(),
+  amountExcl: Joi.string().required(),
+  description: Joi.string().required(),
+  foreign: Joi.object({
+    amount: Joi.string().required(),
+    amountExcl: Joi.string().required(),
+    unitPriceExcl: Joi.string().required(),
+    vatAmount: Joi.string().required(),
+  }),
+  invoiceLineId: Joi.string(),
+  quantity: Joi.string().required(),
+  associations: associationsSchema,
+  unitPriceExcl: Joi.string().required(),
+  vatAmount: Joi.string().required(),
+  vatCode: Joi.string().required(),
+  vatPercentage: Joi.string().required(),
+  vatReason: Joi.string(),
+});
+
+export const newFinanceDocV2Schema = Joi.object({
+  id: Joi.string(),
+  version: Joi.number().valid(2.0).required(),
+  reference: Joi.string().required(),
+  type: Joi.string()
+    .valid(...Object.values(FinanceDocType))
+    .required(),
+  subtype: Joi.string().required(),
+  attachment: attachmentValueSchema.required(),
+  branchId: Joi.string().required(),
+  category: Joi.string().required(),
+  organizationSummary: orgSummarySchema.required(),
+  dueDate: Joi.string(),
+  transferDescription: Joi.string(),
+  invoiceId: Joi.string(),
+  notes: Joi.string(),
+  salesperson: Joi.object({
+    name: Joi.string().required(),
+    username: Joi.string().required(),
+  }),
+  paidAt: Joi.string(),
+  tags: Joi.array().items(Joi.string()),
+  total: Joi.object({
+    amountExcl: Joi.string().required(),
+    amount: Joi.string().required(),
+    currencyCode: Joi.string().required(),
+    foreign: Joi.object({
+      amount: Joi.string().required(),
+      amountExcl: Joi.string().required(),
+      vatAmount: Joi.string().required(),
+      currencyCode: Joi.string().required(),
+      exchangeRate: Joi.string().required(),
+    }),
+    vatAmount: Joi.string().required(),
+  }),
+  issueDate: Joi.string().isoDate().required(),
+  lines: Joi.array().items(lineSchema).required(),
+});
+
+export const newAdministativedDocumentSchema = Joi.object({
+  id: Joi.string(),
+  displayName: Joi.string(),
+  branchId: Joi.string().required(),
+  attachment: attachmentValueSchema.required(),
+  category: Joi.string().empty(''),
+  tags: Joi.array().items(Joi.string()),
+  associations: associationsSchema,
+  organizationSummary: orgSummarySchema,
+});
+
+export const administativeDocumentSchema = newAdministativedDocumentSchema.keys({
+  id: Joi.string().required(),
+  createdAt: Joi.string().required(),
+  createdBy: Joi.string().required(),
+});

package/src/types/booking.ts

@@ -1,14 +1,15 @@
 import { FinanceDocument } from './documents.js';
 
 export type FinanceBookingEvent = {
-  id: string;
-  branchId: string;
   actionAt: string;
   userId: string;
   tenantId: string;
   type: 'Sale Finance' | 'Purchase Finance';
   version: FinanceDocument['version'];
-};
+} & (
+  | { action: 'create'; booking: FinanceBooking; previousBooking?: undefined }
+  | { action: 'update'; booking: FinanceBooking; previousBooking: FinanceBooking }
+);
 
 export type FinanceBooking = {
   branchId: string; // same tenantId can have different companies

package/src/types/document-categories.ts

@@ -5,29 +5,69 @@ export enum DocumentCategoryVisibility {
   Private = 'private',
 }
 
-export type DocumentCategory = {
+export enum DocumentCategoryType {
+  Administrative = 'administrative',
+  Finance = 'finance',
+}
+
+type BaseDocumentCategory = {
   createdAt: string;
   branchId: string;
   id: string;
-  code: string;
+  type: DocumentCategoryType;
   title: string;
-  journal: string;
+};
+
+export type AdministrativeDocumentCategory = BaseDocumentCategory & {
+  type: DocumentCategoryType.Administrative;
+};
+
+export type FinanceDocumentCategory = BaseDocumentCategory & {
+  type: DocumentCategoryType.Finance;
+  journal?: string;
+  costCenter: string;
   visibility: DocumentCategoryVisibility;
-  transactionTypes: [TransactionType, ...TransactionType[]];
+  transactionType: TransactionType;
   validators?: string[];
 };
 
-export type NewDocumentCategory = Omit<DocumentCategory, 'id' | 'createdAt'>;
+export type DocumentCategory = AdministrativeDocumentCategory | FinanceDocumentCategory;
+
+export type NewDocumentCategory = (
+  | Omit<FinanceDocumentCategory, 'id' | 'createdAt'>
+  | Omit<AdministrativeDocumentCategory, 'id' | 'createdAt'>
+) & {
+  createdAt?: undefined;
+  id?: undefined;
+};
 
-export type DocumentLineCategory = {
+export type FinanceDocumentLineCategory = {
   createdAt: string;
   branchId: string;
   categoryId: string;
   id: string;
-  code: string;
   title: string;
   description: string;
+  associationMandatory: boolean;
   glAccount: string;
 };
 
-export type NewDocumentLineCategory = Omit<DocumentLineCategory, 'id' | 'createdAt'>;
+export type NewFinanceDocumentLineCategory = Omit<FinanceDocumentLineCategory, 'id' | 'createdAt'>;
+
+type BaseCostCenter = {
+  branchId: string;
+  name: string;
+  externalId?: string;
+};
+
+export type CostCenter = BaseCostCenter & {
+  createdAt: string;
+  createdBy: string;
+  id: string;
+};
+
+export type NewCostCenter = BaseCostCenter & {
+  createdAt?: undefined;
+  createdBy?: string;
+  id?: undefined;
+};

package/src/types/documents.ts

@@ -1,20 +1,13 @@
-import type { Block } from '@aws-sdk/client-textract';
 import { BusinessEntityIds } from '@bisondesk/commons-sdk/constants';
 import { AttachmentValue, PhoneNumberValue } from '@bisondesk/commons-sdk/types';
 import { FinanceDocumentV1 } from './legacy.js';
 
-export enum AdministrativeDocType {
-  General = 'General Administrative',
-  Logistics = 'Logistics Administrative',
-  Purchase = 'Purchase Administrative',
-  Sale = 'Sale Administrative',
-}
-
 export type FinanceDocument = FinanceDocumentV1 | FinanceDocumentV2;
 
 export type Association = {
   businessEntityId: BusinessEntityIds;
-  id: string;
+  recordId: string;
+  title: string;
   description: string;
   tags?: string[];
 };
@@ -70,16 +63,10 @@ export enum FinanceDocType {
   Purchase = 'Purchase Finance',
 }
 
-export enum FinanceDocumentGenerateSubtype {
-  Invoice = 'Invoice',
-  CreditNote = 'Credit Note',
-}
-
 type BaseDocument = {
   id: string;
   branchId: string;
   attachment: AttachmentValue;
-  subtype: string;
   createdAt: string;
   createdBy: string;
 };
@@ -87,19 +74,18 @@ type BaseDocument = {
 export type FinanceDocumentV2 = BaseDocument & {
   version: 2.0;
   reference: string;
-
+  subtype: FinanceDocumentSubtype;
   type: FinanceDocType;
-
-  category: string; // abstraction used to map invoices to Journals (e.g., leasing, used trucks)
-
+  category: string;
   organizationSummary: OrgSummary;
 
   dueDate?: string;
   transferDescription?: string; // we ask clients to put this as description of the transfer
   invoiceId?: string; // mandatory in credit notes but forbidden in invoices
   issueDate: string;
-  lines: FinanceDocumentLine[];
   paymentNotes?: string;
+  lines: FinanceDocumentLine[];
+  accountingLines?: FinanceDocumentLine[];
   notes?: string;
   salesperson: {
     name: string;
@@ -131,10 +117,10 @@ export type NewFinanceDocumentV2 = Omit<
 };
 
 export type AdministrativeDocument = BaseDocument & {
-  type: AdministrativeDocType;
   tags?: string[];
+  category: string;
   associations?: Association[];
-  organizationSummary?: OrgSummary;
+  displayName?: string;
 };
 
 export type NewAdministrativeDocument = Omit<
@@ -143,22 +129,21 @@ export type NewAdministrativeDocument = Omit<
 >;
 
 export enum DraftProcessStatus {
-  // Prefill = 'Prefill',
-  // Ready = 'Ready',
-  Error = 'Error',
-  Validated = 'Validated',
+  Prefill = 'Prefill',
   Unprocessed = 'Unprocessed',
-  Unvalidated = 'Unvalidated',
+  Processed = 'Processed',
+  BusinessValid = 'BusinessValid',
+  AccountingValid = 'AccountingValid',
+  Completed = 'Completed',
+  Rejected = 'Rejected',
 }
 
 type DraftProcessing = {
   status: DraftProcessStatus;
-  businessValid: boolean;
-  accountingValid: boolean;
-  rejectedAt?: string;
-  rejectedBy?: string;
-  rejectionReason?: string;
   failedValidationRules?: string[];
+  documentType?: DocumentType;
+  vatTotalCheck?: string;
+  totalCheck?: string;
 };
 
 export enum DocumentType {
@@ -166,17 +151,37 @@ export enum DocumentType {
   Administrative = 'Administrative Document',
 }
 
-type BaseDocumentDraft = BaseDocument &
-  DraftProcessing & {
-    documentType?: DocumentType;
+type DraftStatusLogEntry = {
+  at: string;
+  by: string;
+};
+
+type DraftStatusLog = { [key in DraftProcessStatus]?: DraftStatusLogEntry };
+
+type BaseDocumentDraft = (BaseDocument & DraftProcessing) &
+  (
+    | {
+        status: Exclude<DraftProcessStatus, DraftProcessStatus.Rejected>;
+      }
+    | {
+        status: DraftProcessStatus.Rejected;
+        rejectedAt?: string;
+        rejectedBy?: string;
+        rejectionReason?: string;
+      }
+  ) & {
+    log?: DraftStatusLog;
   };
 
 export type DocumentDraft<T = FinanceDocumentV2 | AdministrativeDocument> = Partial<T> &
   BaseDocumentDraft;
 
+export type DocumentDraftListMeta = { status: DraftProcessStatus; count: number }[];
+
 export enum DraftActions {
   Delete = 'delete',
   Validate = 'validate',
+  Reject = 'reject',
   Submit = 'submit',
   ValidateBusinessRules = 'validate_business_rules',
   ValidateAccountingRules = 'validate_accounting_rules',
@@ -187,7 +192,7 @@ export type RejectDraftRequest = {
 };
 
 export type NewDocumentDraft<T = NewFinanceDocumentV2 | NewAdministrativeDocument> = Partial<T> &
-  Omit<BaseDocument, 'id' | 'createdAt' | 'createdBy' | 'subtype'> & {
+  Omit<BaseDocumentDraft, 'id' | 'createdAt' | 'createdBy' | 'subtype'> & {
     subtype?: string;
     documentType?: DocumentType;
   };
@@ -204,18 +209,20 @@ export const isFinanceDocumentV1 = (
   return (arg as FinanceDocumentV2).version == null;
 };
 
-export const isAdministrativeDocument = (arg: any): arg is AdministrativeDocument => {
-  return Object.values(AdministrativeDocType).includes(arg.type);
+export const isFinanceDocument = (
+  arg: FinanceDocument | AdministrativeDocument | NewAdministrativeDocument | NewFinanceDocumentV2
+): arg is FinanceDocument => {
+  return (arg as FinanceDocument).reference != null;
 };
 
 export const isAdministrativeDocumentDraft = (
-  draft: DocumentDraft
-): draft is DocumentDraft<AdministrativeDocument> =>
+  draft: DocumentDraft | NewDocumentDraft
+): draft is DocumentDraft<AdministrativeDocument> | NewDocumentDraft<AdministrativeDocument> =>
   draft.documentType === DocumentType.Administrative;
 
 export const isFinanceDocumentDraft = (
   arg: DocumentDraft | NewDocumentDraft
-): arg is DocumentDraft<FinanceDocumentV2> => {
+): arg is DocumentDraft<FinanceDocumentV2> | NewDocumentDraft<FinanceDocumentV2> => {
   return arg.documentType === DocumentType.Finance;
 };
 
@@ -223,7 +230,7 @@ export type FinanceDocumentGenerateRequest = Omit<
   FinanceDocumentV2,
   'id' | 'attachment' | 'createdAt' | 'createdBy' | 'version' | 'reference' | 'lines' | 'subtype'
 > & {
-  subtype: FinanceDocumentGenerateSubtype;
+  subtype: FinanceDocumentSubtype;
   lines: Omit<FinanceDocumentLine, 'id'>[];
 };
 
@@ -240,11 +247,11 @@ export type FinanceDocumentSettings<M = {}> = {
 };
 
 export type FinanceDocumentBisondeskSettings = {
-  [FinanceDocumentGenerateSubtype.Invoice]: {
+  [FinanceDocumentSubtype.Invoice]: {
     prefix: string;
     templateId: string;
   };
-  [FinanceDocumentGenerateSubtype.CreditNote]: {
+  [FinanceDocumentSubtype.CreditNote]: {
     prefix: string;
     templateId: string;
   };
@@ -262,13 +269,29 @@ export enum FinanceDocumentSubtype {
   PurchaseOrder = 'Purchase Order',
 }
 
-export type OCRDocument = {
-  Blocks?: Block[];
-  orientation: number;
-  hasCurrency: boolean;
-};
-
 export enum FinanceDocumentActions {
   PAY_FINANCE_DOCUMENT = 'pay_finance_document',
   DELETE_FINANCE_DOCUMENT = 'delete_finance_document',
 }
+
+export enum AdministrativeDocumentActions {
+  DELETE_ADMINISTRATIVE_DOCUMENT = 'delete_finance_document',
+}
+
+export type AdministrativeUpdateOperation =
+  | {
+      doc: AdministrativeDocument;
+      op: 'replace';
+    }
+  | {
+      doc: NewAdministrativeDocument;
+      op: 'add';
+    }
+  | {
+      association: {
+        businessEntityId: BusinessEntityIds;
+        recordId: string;
+        documentId: string;
+      };
+      op: 'remove-association';
+    };