Class BaseAccountingActionAbstract

Protected AbstractaccountingProvider

Protected AbstractintegrationName

ProtectedbuildAccountingErrorMessage

• buildAccountingErrorMessage(
      operation: string,
      details: string,
      systemError?: any,
  ): string

  Helper to build consistent error messages for accounting operations

  Parameters

  • operation: string
  • details: string
  • OptionalsystemError: any

  Returns string

ProtectedformatAccountingDate

• formatAccountingDate(date: Date): string

  Standard date format for accounting systems (ISO 8601)

  Parameters

  • date: Date

  Returns string

ProtectedformatCurrency

• formatCurrency(amount: number, currencyCode?: string): string

  Formats currency values consistently

  Parameters

  • amount: number
  • currencyCode: string = 'USD'

  Returns string

ProtectedgetAPIBaseURL

• getAPIBaseURL(
      contextUser: UserInfo,
      provider?: IMetadataProvider,
  ): Promise<string>

  Gets the base URL for API calls from the integration

  Parameters

  • contextUser: UserInfo
  • Optionalprovider: IMetadataProvider

  Returns Promise<string>

ProtectedgetCommonAccountingParams

• getCommonAccountingParams(): ActionParam[]

  Common accounting parameters that many actions will need

  Returns ActionParam[]

ProtectedgetCompanyIntegration

• getCompanyIntegration(
      companyId: string,
      contextUser: UserInfo,
  ): Promise<MJCompanyIntegrationEntity>

  Gets the company integration record for the specified company and accounting system

  Parameters

  • companyId: string
  • contextUser: UserInfo

  Returns Promise<MJCompanyIntegrationEntity>

ProtectedgetCredentialFromEnv

• getCredentialFromEnv(companyId: string, credentialType: string): string

  Gets credentials from environment variables Format: BIZAPPS_{PROVIDER}{COMPANY_ID}{CREDENTIAL_TYPE} Example: BIZAPPS_QUICKBOOKS_12345_ACCESS_TOKEN

  Parameters

  • companyId: string
  • credentialType: string

  Returns string

ProtectedgetOAuthTokens

• getOAuthTokens(
      integration: MJCompanyIntegrationEntity,
  ): Promise<{ accessToken: string; refreshToken?: string }>

  Gets OAuth tokens - first tries environment variables, then falls back to database

  Parameters

  • integration: MJCompanyIntegrationEntity

  Returns Promise<{ accessToken: string; refreshToken?: string }>

ProtectedgetParamValue

• getParamValue(params: ActionParam[], name: string): any

  Helper to get a parameter value from the params array

  Parameters

  • params: ActionParam[]
  • name: string

  Returns any

Protected AbstractInternalRunAction

• InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>

  Override of the required abstract method from BaseAction

  Parameters

  • params: RunActionParams

  Returns Promise<ActionResultSimple>

ProtectedvalidateAccountNumber

• validateAccountNumber(accountNumber: string): boolean

  Validates common accounting data formats

  Parameters

  • accountNumber: string

  Returns boolean

ProtectedvalidateJournalEntryBalance

• validateJournalEntryBalance(
      lines: { credit?: number; debit?: number }[],
  ): boolean

  Validates journal entry balance (debits must equal credits)

  Parameters

  • lines: { credit?: number; debit?: number }[]

  Returns boolean