Infrastructure medium complexity backend
0
Dependencies
0
Dependents
1
Entities
0
Integrations

Description

Infrastructure component that manages outbound connectivity to external accounting system endpoints, including authentication credential management, TLS configuration, and request routing. It provides a secure channel between the platform backend and third-party accounting APIs such as Xledger and Microsoft Dynamics. Rate limiting and timeout policies are enforced at this layer to protect platform stability.

Feature: Accounting API

accounting-api-gateway

Sources & reasoning

Line 72 documents explicit per-org accounting system requirements (Xledger and Dynamics) for HLF and Blindeforbundet. Line 354 places this under Fase 3, mapping to v1.1. The need for a shared API abstraction across two different accounting backends with org-specific credentials directly motivates this feature.

  • docs/source/likeperson.md · line 72
    API-integrasjon mot regnskapssystem (Xledger for Blindeforbundet, Dynamics-portal for HLF).
  • docs/source/likeperson.md · line 354
    Regnskapsintegrasjon (Xledger for Blindeforbundet, Dynamics accounting for HLF)

Responsibilities

  • Manage secure outbound HTTP connections to external accounting system endpoints
  • Handle authentication flows including API keys, OAuth tokens, and basic credentials per backend
  • Enforce configurable request timeouts and retry backoff policies
  • Route requests to the correct endpoint based on organization accounting system type
  • Log outbound request metadata for observability without storing sensitive payloads

Interfaces

sendRequest(endpoint: string, payload: object, authContext: AuthContext): HttpResponse
resolveEndpoint(systemType: AccountingSystemType, orgId: string): string
refreshCredentials(orgId: string, systemType: AccountingSystemType): AuthContext
healthCheck(systemType: AccountingSystemType, orgId: string): GatewayHealthStatus

Related Data Entities (1)

Data entities managed by this component