Files
cross-financial-management/client/src/api/arCreditNotes.api.ts
T
Joshua OosthuizenandClaude Sonnet 5 4acbc03b35 Initial commit: multi-company financial management system
Root company app (src/, client/) — GL foundation, AR, and AP:
- Segmented Chart of Accounts (Sage 300-style), double-entry PostingService with
  three-layer balance enforcement (app validation, CHECK constraints, deferred
  DB trigger), gap-free document numbering, RBAC with branch restrictions.
- Accounts Receivable: Customers, Invoices, Credit Notes, Receipts with
  allocation, all posting through PostingService.
- Accounts Payable: Suppliers, Supplier Invoices, Debit Notes, Payments with
  allocation, mirroring AR's posting pattern.
- Tax Codes shared between AR and AP.
- Company-app login is a token handoff from the Account Manager (RS256,
  single-use, company-scoped) rather than a local password.
- Frontend reskinned to the approved mockup: navy sidebar, dashboard, tree-view
  Chart of Accounts, Customer/Supplier 360 pages.

Account Manager (manager/, manager/client/) — central login gateway:
- Password + TOTP 2FA + Google/Microsoft OAuth, company picker, and the RS256
  handoff token issuance that the company app verifies.

Covered by unit + integration tests against a real Postgres database (GL
balance invariants, AR/AP posting correctness and allocation limits, the full
handoff exchange including replay/cross-company/expiry/forgery rejection).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Tq2DbEvzHzs13jDFhLaX44
2026-09-03 13:27:19 +02:00

52 lines
1.8 KiB
TypeScript

import { apiClient } from './client';
import type { ARAllocation, ARCreditNote } from '../types/api';
import type { BranchSelection } from '../store/branchStore';
export async function fetchCreditNotes(branchScope: BranchSelection, customerId?: number): Promise<ARCreditNote[]> {
const response = await apiClient.get<ARCreditNote[]>('/ar/credit-notes', {
params: { branchScope: branchScope === 'MAIN' ? 'MAIN' : String(branchScope), customerId },
});
return response.data;
}
export async function fetchCreditNote(id: number): Promise<ARCreditNote> {
const response = await apiClient.get<ARCreditNote>(`/ar/credit-notes/${id}`);
return response.data;
}
export interface CreditNoteLineInput {
description: string;
quantity: number;
unitPrice: number;
revenueGLAccountId: number;
taxCodeId?: number;
}
export interface CreateCreditNoteInput {
customerId: number;
creditNoteDate: string;
reference?: string;
reason?: string;
lines: CreditNoteLineInput[];
}
export async function createCreditNote(input: CreateCreditNoteInput): Promise<ARCreditNote> {
const response = await apiClient.post<ARCreditNote>('/ar/credit-notes', input);
return response.data;
}
export async function postCreditNote(id: number): Promise<ARCreditNote> {
const response = await apiClient.post<ARCreditNote>(`/ar/credit-notes/${id}/post`);
return response.data;
}
export async function voidCreditNote(id: number): Promise<ARCreditNote> {
const response = await apiClient.post<ARCreditNote>(`/ar/credit-notes/${id}/void`);
return response.data;
}
export async function allocateCreditNote(id: number, allocations: { invoiceId: number; amount: number }[]): Promise<ARAllocation[]> {
const response = await apiClient.post<ARAllocation[]>(`/ar/credit-notes/${id}/allocations`, { allocations });
return response.data;
}