@opencxh/domain 1.290.0 → 1.292.0

package/dist/entities/bank/types.d.ts

@@ -78,6 +78,11 @@ export type MatchTarget = {
     kind: "scheduled_posting";
     scheduledPostingId: string;
 }
+/** Straight onto a balance item (a current account): its ledger account, with it as sub-account. */
+ | {
+    kind: "financing";
+    financingItemId: string;
+}
 /** The other side of a transfer between two own accounts. */
  | {
     kind: "transfer";
@@ -136,10 +141,12 @@ export interface BankRule {
         descriptionContains?: string;
         direction?: "in" | "out";
     };
+    /** With `financingItemId` the line goes onto that current account; `accountId` is then its account. */
     action: {
         accountId: string;
         taxCode?: string;
         description?: string;
+        financingItemId?: string;
     };
     /** High lands in "Klaar om te bevestigen", medium in "Controleren". */
     confidence: "high" | "medium";

package/dist/entities/company/identifiers.d.ts

@@ -3,6 +3,7 @@
  * normalised on write, compared normalised everywhere: `NL91 abna 0417 1643 00` and
  * `NL91ABNA0417164300` are one account.
  */
+/** Both are letters and digits only: spaces, dots, dashes and the like are layout. */
 export declare function normalizeIban(value: string): string;
 export declare function normalizeVatNumber(value: string): string;
 /** Normalised, blanks dropped, duplicates removed, order kept. */

package/dist/entities/company/index.d.ts

@@ -1,2 +1,2 @@
-export * from './types';
 export * from './identifiers';
+export * from './types';

package/dist/entities/company/types.d.ts

@@ -1,5 +1,5 @@
-import { PostalAddress } from '../organization/types';
 import { LifecycleStage } from '../contact/lifecycle';
+import { PostalAddress } from '../organization/types';
 import { OwnerScope } from '../scope/types';
 /** Same meaning as {@link ContactOrigin}: `shadow` is a lazily cached hit, a landed row is `own`. */
 export type CompanyOrigin = "own" | "shadow";

package/dist/entities/financing/schedule.d.ts

@@ -1,5 +1,5 @@
 import { Cents } from '../money/money';
-import { AccrualTerms, CurrentAccountTerms, FinancingItem, FixedAssetTerms, LoanTerms, ScheduledPosting } from './types';
+import { AccrualTerms, CurrentAccountRelation, CurrentAccountTerms, FinancingItem, FixedAssetTerms, LoanTerms, ScheduledPosting } from './types';
 /** `day` plus `months`, on the same day of the month or the last one when it is shorter. */
 export declare function addMonths(day: string, months: number): string;
 export interface Installment {
@@ -32,6 +32,8 @@ export declare function interestPeriods(openedOn: string, through: string, caden
     to: string;
 }[];
 export declare const EXCESSIVE_LENDING_THRESHOLD_CENTS = 50000000;
+/** Who a current account is with; anything unknown or missing is the director. */
+export declare const currentAccountRelation: (terms?: Partial<Pick<CurrentAccountTerms, "relation">>) => CurrentAccountRelation;
 /** Wet excessief lenen: how far the director's debt to the BV is toward the threshold. */
 export declare function excessiveLending(directorOwesCents: Cents, thresholdCents?: number): {
     over: boolean;

package/dist/entities/financing/types.d.ts

@@ -18,15 +18,18 @@ export interface LoanTerms {
     /** Interest expense (received) or income (given). */
     interestAccountId: string;
 }
+/** Who the current account is with; absent on items made before it existed: the director. */
+export type CurrentAccountRelation = "director" | "group_company" | "participation" | "other_company";
 export interface CurrentAccountTerms {
     kind: "current_account";
+    relation?: CurrentAccountRelation;
     /** A business rate: what the tax authority expects between a BV and its director. */
     ratePercent: string;
     cadence: "quarterly" | "yearly";
     /** Interest income when the director owes, expense when the BV owes. */
     interestIncomeAccountId: string;
     interestExpenseAccountId: string;
-    /** Wet excessief lenen: a signal above this debt of the director. A setting, default € 500.000. */
+    /** Wet excessief lenen: a signal above this debt of the director (director only). Default € 500.000. */
     thresholdCents?: Cents;
 }
 export interface ParticipationTerms {

package/dist/entities/reports/vat.d.ts

@@ -14,6 +14,8 @@ export interface VatLine {
     taxCents: Cents;
     taxPointDate: string;
     counterpartyCompanyId?: string;
+    /** The journal line it came from: the drill-down from a box back to the bookings. */
+    ref?: string;
 }
 export declare const NL_VAT_BOXES: readonly ["1a", "1b", "1c", "1d", "1e", "2a", "3a", "3b", "3c", "4a", "4b", "5a", "5b", "5c", "5g"];
 export type VatBox = (typeof NL_VAT_BOXES)[number];
@@ -35,6 +37,8 @@ export interface VatReturnFigures {
     }[];
     /** Lines whose code is unknown: they are in no box, and the checklist says so. */
     unknownCodes: string[];
+    /** With `trace`: per box, the `ref` of every line that counted in it. */
+    refs?: Partial<Record<VatBox, string[]>>;
 }
 /**
  * The boxes for one period. Reverse charge on purchase (`selfAssessed`) is owed in its own box
@@ -49,6 +53,8 @@ export declare function vatReturn(input: {
     taxonomy?: string;
     /** The code a self-assessed purchase is taxed at: the standard rate. */
     standardKey?: string;
+    /** Also say which lines counted in which box (`refs`). */
+    trace?: boolean;
 }): VatReturnFigures;
 /** The periods a return is filed over, and when it is due: the month after, at its end. */
 export declare function vatPeriods(year: number, cadence?: "quarter" | "month" | "year"): {