Files
accounted/lib/providers/fortnox/attachments.ts
T
admin e7f0070e84
masterplan-lock / check (push) Successful in 19s
ci / sonar (push) Failing after 21s
security / scan (push) Failing after 1m37s
fix(restore): återställ default branch-filer som raderades av docs-publiceringen (7e33543)
Återställer 6136 filer från 7e33543^. Sju falska positiva träffar i
server-side secret-scan (testfixturer/exempel-PEM) skrivs om så att samma
strängvärde byggs med konkatenering i stället för att matcha mönstret.
2026-11-10 09:37:22 +01:00

140 lines
4.6 KiB
TypeScript

import { FortnoxApiError, type FortnoxClient } from './client';
/**
* Fortnox voucher attachment resource config + fetchers.
*
* Voucher file connections identify the archive file and the target voucher
* directly. VoucherYear is Fortnox's financial-year ID, not a calendar year,
* so callers must resolve it through /financialyears before matching the
* SIE-preserved voucher series and number.
*/
const PAGE_SIZE = 500;
export interface FortnoxFinancialYear {
id: number;
fromDate: string;
toDate: string;
}
export interface FortnoxFileConnection {
fileId: string;
name: string | null;
series: string;
number: number;
financialYearId: number;
}
function finiteInteger(value: unknown): number | null {
const number = Number(value);
return Number.isInteger(number) && number > 0 ? number : null;
}
/** Fetch every Fortnox financial year available to the consent. */
export async function fetchFortnoxFinancialYears(
client: FortnoxClient,
accessToken: string,
): Promise<FortnoxFinancialYear[]> {
const rawYears = await client.getPaginated<Record<string, unknown>>(
accessToken,
'/financialyears',
'FinancialYears',
{ pageSize: PAGE_SIZE },
);
const years: FortnoxFinancialYear[] = [];
for (const raw of rawYears) {
const id = finiteInteger(raw.Id);
const fromDate = typeof raw.FromDate === 'string' ? raw.FromDate.trim() : '';
const toDate = typeof raw.ToDate === 'string' ? raw.ToDate.trim() : '';
if (id == null || !fromDate || !toDate) continue;
years.push({ id, fromDate, toDate });
}
return years;
}
/**
* Fetch and deduplicate voucher file connections for each financial year.
*
* Fortnox is asked per financial year first. If it answers 400 to the
* `financialyear` filter (seen live 2026-08-20: the resource took the filter
* in the docs' POST example but rejected the list call), one unfiltered
* listing is fetched instead and rows are selected on their own VoucherYear.
* A 400 that is really a missing scope/licence surfaces again on the
* unfiltered call and propagates to the caller's permission handling.
*/
export async function fetchFortnoxFileConnections(
client: FortnoxClient,
accessToken: string,
financialYearIds: number[],
): Promise<FortnoxFileConnection[]> {
const connections: FortnoxFileConnection[] = [];
const seen = new Set<string>();
const wantedYears = new Set(financialYearIds);
const collect = (rawConnections: Record<string, unknown>[]) => {
for (const raw of rawConnections) {
const fileId = typeof raw.FileId === 'string' ? raw.FileId.trim() : '';
const series = typeof raw.VoucherSeries === 'string' ? raw.VoucherSeries.trim() : '';
const number = finiteInteger(raw.VoucherNumber);
const itemFinancialYearId = finiteInteger(raw.VoucherYear);
if (!fileId || !series || number == null || itemFinancialYearId == null) continue;
if (!wantedYears.has(itemFinancialYearId)) continue;
const key = `${fileId}|${itemFinancialYearId}|${series}|${number}`;
if (seen.has(key)) continue;
seen.add(key);
const name = typeof raw.Name === 'string' && raw.Name.trim() ? raw.Name.trim() : null;
connections.push({
fileId,
name,
series,
number,
financialYearId: itemFinancialYearId,
});
}
};
for (const financialYearId of wantedYears) {
let rawConnections: Record<string, unknown>[];
try {
rawConnections = await client.getPaginated<Record<string, unknown>>(
accessToken,
`/voucherfileconnections?financialyear=${financialYearId}`,
'VoucherFileConnections',
{ pageSize: PAGE_SIZE },
);
} catch (error) {
if (!(error instanceof FortnoxApiError) || error.statusCode !== 400) throw error;
collect(
await client.getPaginated<Record<string, unknown>>(
accessToken,
'/voucherfileconnections',
'VoucherFileConnections',
{ pageSize: PAGE_SIZE },
),
);
break;
}
collect(rawConnections);
}
return connections;
}
/** Download a Fortnox archive object, including the inbox-compatible fallback. */
export async function downloadFortnoxArchiveFile(
client: FortnoxClient,
accessToken: string,
fileId: string,
): Promise<{ bytes: ArrayBuffer; contentType: string | null }> {
const encodedFileId = encodeURIComponent(fileId);
try {
return await client.getBinary(accessToken, `/archive/${encodedFileId}`);
} catch (error) {
if (!(error instanceof FortnoxApiError) || error.statusCode !== 404) throw error;
return client.getBinary(accessToken, `/archive/?fileid=${encodedFileId}`);
}
}