Class GetBusinessCentralSalesInvoicesAction

ProtectedaccountingProvider

ProtectedapiVersion

ProtectedintegrationName

Protectedparams

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

ProtectedbuildFilterExpression

• buildFilterExpression(field: string, operator: string, value: any): string

  Helper to build OData filter expressions

  Parameters

  • field: string
  • operator: string
  • value: any

  Returns string

ProtectedformatAccountingDate

• formatAccountingDate(date: Date): string

  Standard date format for accounting systems (ISO 8601)

  Parameters

  • date: Date

  Returns string

ProtectedformatBCDate

• formatBCDate(date: Date): string

  Formats date for Business Central API (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>

ProtectedgetBusinessCentralAPIUrl

• getBusinessCentralAPIUrl(
      integration: MJCompanyIntegrationEntity,
      tenantId: string,
      environment: string,
  ): Promise<string>

  Gets the appropriate Business Central API URL

  Parameters

  • integration: MJCompanyIntegrationEntity
  • tenantId: string
  • environment: string

  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

ProtectedmakeBCRequest

• makeBCRequest<T = any>(
      endpoint: string,
      method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH",
      body?: any,
      contextUser?: UserInfo,
  ): Promise<T>

  Makes an authenticated request to Business Central API

  Type Parameters

  • T = any

  Parameters

  • endpoint: string
  • method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" = 'GET'
  • Optionalbody: any
  • OptionalcontextUser: UserInfo

  Returns Promise<T>

ProtectedmapAccountCategory

• mapAccountCategory(category: string): string

  Maps Business Central account category to standard type

  Parameters

  • category: string

  Returns string

ProtectedmapAccountType

• mapAccountType(bcAccountType: string): string

  Maps Business Central account types to standard categories

  Parameters

  • bcAccountType: string

  Returns string

ProtectedparseBCDate

• parseBCDate(dateString: string): Date

  Parses Business Central date format

  Parameters

  • dateString: string

  Returns Date

ProtectedqueryBC

• queryBC<T = any>(
      resource: string,
      filters?: string[],
      select?: string[],
      expand?: string[],
      orderBy?: string,
      top?: number,
      contextUser?: UserInfo,
  ): Promise<T>

  Handles Business Central OData queries

  Type Parameters

  • T = any

  Parameters

  • resource: string
  • Optionalfilters: string[]
  • Optionalselect: string[]
  • Optionalexpand: string[]
  • OptionalorderBy: string
  • Optionaltop: number
  • OptionalcontextUser: UserInfo

  Returns Promise<T>

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