@ekwo-ai/core 0.14.0 → 0.15.0

package/dist/books/matching.js

@@ -0,0 +1,95 @@
+/**
+ * Matching open items of one counterparty: what settles what, several lines in
+ * one gesture, a small difference booked, and a line left unnamed on purpose.
+ *
+ * `suggest_item_combinations()` proposes, `reconcile_many()` and
+ * `reconcile_with_difference()` match, `leave_line_unnamed()` and its undo
+ * record a decision about a line (decisions 0071 and 0072). The search, the
+ * accounts a difference is booked on, the tolerance and every refusal are the
+ * schema's; this file asks for them and shapes the answer.
+ */
+import { money, moneyFields } from './format.js';
+import { only } from './shared.js';
+/**
+ * What lines of one counterparty and one account could settle each other, line
+ * by line: an exact pair, several lines to the cent, or — when nothing is
+ * exact — a pair or several lines within the company's difference tolerance.
+ */
+export async function suggestItemCombinations(backend, args) {
+    const found = await backend.rpc('suggest_item_combinations', {
+        p_company_id: args.company_id,
+        ...(args.contact_id === undefined ? {} : { p_contact_id: args.contact_id }),
+    });
+    const proposals = found.map((row) => ({
+        proposal_id: String(row['proposal_id']),
+        ordinal: Number(row['ordinal']),
+        contact_id: String(row['contact_id']),
+        account_id: String(row['account_id']),
+        line_id: String(row['line_id']),
+        side: String(row['side']),
+        amount: money(row['amount']),
+        kind: String(row['kind']),
+        line_ids: (row['line_ids'] ?? []).map(String),
+        total: money(row['total']),
+        difference: money(row['difference']),
+        because: String(row['because']),
+        alternatives: Number(row['alternatives']),
+    }));
+    return {
+        proposals,
+        count: proposals.length,
+        note: 'Nothing is matched by a proposal. A difference other than 0.00 is closed only by reconcile_with_difference, with a reason, once the user has seen the difference and said so; reconcile_many matches a proposal whose difference is 0.00.',
+    };
+}
+/** The reasons a difference may be booked for, with their accounts, and the largest difference the company books. */
+export async function matchingDifferenceOptions(backend, args) {
+    const [tolerance] = await backend.rpc('matching_difference_tolerance', { p_company_id: args.company_id });
+    const reasons = await backend.rpc('matching_difference_reasons', { p_company_id: args.company_id });
+    return {
+        tolerance: tolerance === undefined
+            ? null
+            : {
+                units: Number(tolerance['tolerance_units']),
+                amount: money(tolerance['tolerance']),
+                currency_code: tolerance['currency_code'] ?? null,
+            },
+        reasons,
+        note: 'side says which difference a reason answers: charge when the lines carry more debit than credit, income the other way, either for both. A reason that is not available has no account to be booked on, and is refused.',
+    };
+}
+function matched(rows, what) {
+    return only(moneyFields(rows, ['amount', 'difference']), what);
+}
+/** Matches several lines together, their open debits and credits equal to the cent. */
+export async function reconcileMany(backend, args) {
+    const done = matched(await backend.rpc('reconcile_many', { p_line_ids: args.line_ids }), 'the lines were not matched');
+    return {
+        matching: done,
+        note: 'The lines are matched under one letter, pair by pair through reconcile(). unreconcile undoes one matching at a time.',
+    };
+}
+/** Books the difference on the account of the reason and matches everything. */
+export async function reconcileWithDifference(backend, args) {
+    const done = matched(await backend.rpc('reconcile_with_difference', { p_line_ids: args.line_ids, p_reason: args.reason }), 'the lines were not matched');
+    return {
+        matching: done,
+        note: 'The difference is booked in a posted entry (adjustment_entry_id) on the same account and counterparty, against the account the pack gives for the reason, and every line is matched under one letter. unreconcile of the matching of the difference line takes the entry back with its mirror.',
+    };
+}
+/** Records that a line names nobody on purpose: it is no longer proposed a contact. */
+export async function leaveLineUnnamed(backend, args) {
+    const left = only(await backend.rpc('leave_line_unnamed', { p_line_id: args.line_id, p_reason: args.reason }), `line ${args.line_id} was not left unnamed`);
+    return {
+        left_unnamed: left,
+        note: 'The line is no longer proposed a contact. It is still an open item, it can still be matched or named, and undo_leave_line_unnamed takes the decision back.',
+    };
+}
+/** Takes back `leave_line_unnamed()`: the line is proposed a contact again. */
+export async function undoLeaveLineUnnamed(backend, args) {
+    const removed = only(await backend.rpc('undo_leave_line_unnamed', { p_line_id: args.line_id }), `line ${args.line_id} was not left unnamed`);
+    return {
+        removed,
+        note: 'The line is proposed a contact again.',
+    };
+}
+//# sourceMappingURL=matching.js.map

package/dist/books/matching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.js","sourceRoot":"","sources":["../../src/books/matching.ts"],"names":[],"mappings":"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"}

package/dist/einvoicing/fiscalisation.d.ts

@@ -26,9 +26,16 @@
  * can be checked without trusting this code is checked again by
  * `einvoicing.append_fiscal_record()`: the regime, the digest, the fields, the
  * tail, a record made once.
+ *
+ * **A clearance regime chains nothing.** There the authority validates every
+ * invoice before it is issued, and what the books keep is the submission and
+ * the answer: `recordClearanceSubmission()` and `recordClearanceAnswer()`
+ * write them through `einvoicing.record_clearance_submission()` and
+ * `einvoicing.record_clearance_answer()`, which check every transition. The
+ * call to the authority is the host's; nothing here dials anybody.
  */
 import { type Backend, type Row } from '../books/backend.js';
-import type { EinvoiceViolation } from './formats.js';
+import { type EinvoiceViolation } from './formats.js';
 /** How the records of an invoicing system reach the authority. */
 export type FiscalSubmissionMode = 'realtime' | 'batch' | 'none';
 export declare const FISCAL_SUBMISSION_MODES: readonly ["realtime", "batch", "none"];
@@ -101,20 +108,42 @@ export declare const FISCALISATION_FORMATS: Readonly<Record<string, Fiscalisatio
  * format is a record the authority refuses.
  */
 export declare function fiscalisationFormat(format: string, formats?: Readonly<Record<string, FiscalisationFormat>>): FiscalisationFormat;
+/** An annual turnover or revenue, as the law states it. */
+export interface FiscalTurnover {
+    amount: number;
+    currency: string;
+}
 /**
  * The regime of a company as the socle compiled it from its pack, or null
  * where it has none. `chained`: a record for every invoice, chained by a
- * hash. `reporting`: the documents' data reported to the authority, no hash,
- * nothing chained — the core keeps no chain for it.
+ * hash. `clearance`: every invoice validated by the authority before it is
+ * issued, nothing chained. `reporting`: the documents' data reported to the
+ * authority, no hash, nothing chained — the core keeps no chain for it.
  */
 export interface FiscalRegime {
-    kind: 'chained' | 'reporting';
+    kind: 'chained' | 'clearance' | 'reporting';
     format: string;
-    /** Empty while the obligation is only announced. */
+    /** Empty while the obligation is only announced. `turnover_above` where the law phases it by size. */
     mandatory_from: {
         who: string | null;
         from: string;
+        turnover_above?: FiscalTurnover;
+    }[];
+    /** The thresholds of exemption, oldest first; absent where the pack declares none. */
+    exemption?: {
+        turnover_below: FiscalTurnover;
+        valid_from: string;
+        legal_reference: string;
+        source: string | null;
     }[];
+    /** What a clearance regime says of the authority's answer; absent for the other two. */
+    clearance?: {
+        verification: 'returned' | 'computed' | 'none';
+        cancellation_window: string | null;
+        rejection_window: string | null;
+        legal_reference: string | null;
+        source: string | null;
+    };
     /** A day only announced, no text in force: it binds nobody. */
     announced_from: string | null;
     announced_by: string | null;
@@ -152,6 +181,8 @@ export interface FiscalRegime {
         by: ('supplier' | 'customer')[];
     }[];
     tax_attributes: Record<string, Record<string, string>>;
+    /** What the brick needs on every line that the books do not record; absent where the pack declares none. */
+    line_attributes?: Record<string, string>;
     legal_reference: string;
     source: string;
 }
@@ -192,6 +223,8 @@ export interface FiscaliseOptions {
  * is in the chain already is answered with that record, not chained twice.
  */
 export declare function fiscaliseDocument(backend: Backend, documentId: string, options: FiscaliseOptions, formats?: Readonly<Record<string, FiscalisationFormat>>): Promise<Row>;
+/** The threshold of exemption that holds on a day, or null where the pack declares none that does. */
+export declare function exemptionOn(regime: FiscalRegime, day: string): NonNullable<FiscalRegime['exemption']>[number] | null;
 /**
  * Where the fiscal records of a company stand: its regime, each chain
  * verified, the records still to be sent, the posted sales without a record,
@@ -201,6 +234,56 @@ export declare function fiscaliseDocument(backend: Backend, documentId: string,
 export declare function fiscalisationStatus(backend: Backend, companyId: string, options?: {
     limit?: number;
 }): Promise<Row>;
+/** Where one submission of an invoice to the authority stands. */
+export type ClearanceState = 'submitted' | 'validated' | 'rejected' | 'cancelled';
+export declare const CLEARANCE_STATES: readonly ["submitted", "validated", "rejected", "cancelled"];
+/** What the authority, the buyer or the issuer can bring a submission to. */
+export declare const CLEARANCE_ANSWERS: readonly ["validated", "rejected", "cancelled"];
+/** A submission somebody made to the authority, as the host that made it reports it. */
+export interface ClearanceSubmission {
+    /** What the authority named the submission on receipt, where it named it. */
+    reference?: string;
+    /** The electronic invoice submitted, where `einvoicing.issues` keeps it. */
+    issueId?: string;
+    /** When it was submitted, ISO 8601. Now when left out. */
+    submittedAt?: string;
+    /** What the authority said on receipt, as it said it. */
+    answer?: Row;
+}
+/** What came back about the latest submission of a document. */
+export interface ClearanceAnswer {
+    state: (typeof CLEARANCE_ANSWERS)[number];
+    /** The identifier the authority gave the invoice: required on validation. */
+    identifier?: string;
+    /** When the authority validated it, ISO 8601: required on validation. */
+    validatedAt?: string;
+    /** The link to its verification, which the invoice carries, where the regime has one. */
+    verificationUrl?: string;
+    /** Why it was rejected or cancelled, as it was said: required for both. */
+    reason?: string;
+    /** Who rejected it: the authority (the default) or the buyer. */
+    by?: 'authority' | 'buyer';
+    /** When the answer came, ISO 8601. Now when left out; the windows of the regime are read against it. */
+    at?: string;
+    /** The answer itself, as the authority gave it. */
+    answer?: Row;
+}
+/**
+ * Records that a posted sale was submitted to the authority under its
+ * company's clearance regime. Calls nobody: the submission is the host's,
+ * and this keeps what it reports. The database refuses a second submission
+ * while one waits, after a validation or after a cancellation.
+ */
+export declare function recordClearanceSubmission(backend: Backend, documentId: string, submission?: ClearanceSubmission): Promise<Row>;
+/**
+ * Records what came back about the latest submission of a document: its
+ * validation, with the identifier and the moment the authority gave it; a
+ * rejection by the authority or, within the regime's window, by the buyer;
+ * its cancellation by the issuer, within the regime's window. Every
+ * transition is checked by `einvoicing.record_clearance_answer()`, which
+ * raises on one that cannot have happened.
+ */
+export declare function recordClearanceAnswer(backend: Backend, documentId: string, answer: ClearanceAnswer): Promise<Row>;
 /** The variable the command line and the MCP server read the invoicing system from, as JSON. */
 export declare const FISCAL_SYSTEM_ENV = "EKWO_FISCAL_SYSTEM";
 /**

package/dist/einvoicing/fiscalisation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fiscalisation.d.ts","sourceRoot":"","sources":["../../src/einvoicing/fiscalisation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fiscalisation.d.ts","sourceRoot":"","sources":["../../src/einvoicing/fiscalisation.ts"],"names":[],"mappings":"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"}

package/dist/einvoicing/fiscalisation.js

@@ -26,9 +26,17 @@
  * can be checked without trusting this code is checked again by
  * `einvoicing.append_fiscal_record()`: the regime, the digest, the fields, the
  * tail, a record made once.
+ *
+ * **A clearance regime chains nothing.** There the authority validates every
+ * invoice before it is issued, and what the books keep is the submission and
+ * the answer: `recordClearanceSubmission()` and `recordClearanceAnswer()`
+ * write them through `einvoicing.record_clearance_submission()` and
+ * `einvoicing.record_clearance_answer()`, which check every transition. The
+ * call to the authority is the host's; nothing here dials anybody.
  */
 import { VERIFACTU } from '@ekwo-ai/verifactu';
 import { BooksError } from '../books/backend.js';
+import { EINVOICE_FORMATS } from './formats.js';
 import { assertPostedSale, einvoiceChecksum, readEinvoiceSource } from './issue.js';
 const SCHEMA = 'einvoicing';
 export const FISCAL_SUBMISSION_MODES = ['realtime', 'batch', 'none'];
@@ -116,6 +124,9 @@ export async function fiscaliseDocument(backend, documentId, options, formats =
     if (regime === null) {
         throw new BooksError(`no_fiscalisation_regime: the country pack of this company declares no fiscalisation regime, so ${what} has no fiscal record to keep.`, { hint: 'A pack declares one in einvoicing.fiscalisation; describe_pack (ekwo pack describe) shows it.' });
     }
+    if (regime.kind === 'clearance') {
+        throw new BooksError(`fiscal_regime_without_chain: the country pack of this company declares a clearance regime, ${regime.format}: every invoice is validated by the authority before it is issued and nothing is chained, so ${what} has no record to chain. Its submission and the authority's answer are recorded with einvoicing_clearance (ekwo einvoice clearance).`);
+    }
     const format = fiscalisationFormat(regime.format, formats);
     if (regime.hash === null) {
         throw new BooksError(`fiscal_regime_without_chain: the country pack of this company declares a reporting regime, ${regime.format}: the data of its documents are reported to the authority and nothing is chained, so ${what} has no record to chain. The report is written by ${format.brick}, not by fiscaliseDocument().`);
@@ -272,12 +283,26 @@ function earliestObligation(regime) {
     return days[0] ?? null;
 }
 /**
- * Whether the status counts posted sales as missing a record. Only under a
- * chained regime in force: an announced day binds nobody, and a reporting
- * regime keeps no chain — which documents it reports is its brick's to say.
+ * Whether the status counts posted sales as missing a record, or a
+ * validation. Only under a chained or a clearance regime in force: an
+ * announced day binds nobody, and a reporting regime keeps no chain — which
+ * documents it reports is its brick's to say.
  */
 function countsMissing(regime) {
-    return regime !== null && regime.hash !== null && (regime.announced_from ?? null) === null;
+    return regime !== null && (regime.kind === 'clearance' || regime.hash !== null) && (regime.announced_from ?? null) === null;
+}
+/**
+ * The brick that writes what a regime needs written, or null where none of
+ * this release does. Under a clearance regime what is submitted is the
+ * electronic invoice itself, so its brick is looked up with the e-invoicing
+ * profiles; under the other two, with the fiscalisation formats.
+ */
+function brickOf(regime) {
+    return (regime.kind === 'clearance' ? EINVOICE_FORMATS[regime.format] : FISCALISATION_FORMATS[regime.format])?.brick ?? null;
+}
+/** The threshold of exemption that holds on a day, or null where the pack declares none that does. */
+export function exemptionOn(regime, day) {
+    return [...(regime.exemption ?? [])].reverse().find((entry) => entry.valid_from <= day) ?? null;
 }
 /**
  * Where the fiscal records of a company stand: its regime, each chain
@@ -327,7 +352,7 @@ export async function fiscalisationStatus(backend, companyId, options = {}) {
     const fiscalised = new Set(records.filter((r) => r['kind'] === 'alta').map((r) => String(r['document_id'])));
     const posted = await backend.select({
         table: 'documents',
-        columns: ['id', 'doc_type', 'number', 'document_date::text'],
+        columns: ['id', 'doc_type', 'number', 'document_date::text', 'reversed_document_id'],
         where: [
             { column: 'company_id', op: 'eq', value: companyId },
             { column: 'state', op: 'eq', value: 'posted' },
@@ -337,7 +362,12 @@ export async function fiscalisationStatus(backend, companyId, options = {}) {
     });
     const from = regime === null ? null : earliestObligation(regime);
     const counted = countsMissing(regime);
-    const without = counted ? posted.filter((d) => !fiscalised.has(String(d['id']))) : [];
+    const cleared = regime?.kind === 'clearance' ? await clearanceOf(backend, companyId, posted, limit) : null;
+    const without = !counted
+        ? []
+        : cleared !== null
+            ? posted.filter((d) => cleared.unvalidated.has(String(d['id'])))
+            : posted.filter((d) => !fiscalised.has(String(d['id'])));
     const missing = without.filter((d) => from === null || String(d['document_date']) >= from);
     const events = await backend.select({
         schema: SCHEMA,
@@ -355,8 +385,10 @@ export async function fiscalisationStatus(backend, companyId, options = {}) {
             : {
                 kind: regime.kind,
                 format: regime.format,
-                brick: FISCALISATION_FORMATS[regime.format]?.brick ?? null,
+                brick: brickOf(regime),
                 mandatory_from: regime.mandatory_from,
+                ...(regime.clearance === undefined ? {} : { clearance: regime.clearance }),
+                ...(regime.exemption === undefined ? {} : { exemption: exemptionOn(regime, today()) }),
                 announced_from: regime.announced_from,
                 announced_by: regime.announced_by,
                 announced_on: regime.announced_on,
@@ -375,18 +407,186 @@ export async function fiscalisationStatus(backend, companyId, options = {}) {
         missing: missing.slice(0, limit),
         missing_count: missing.length,
         before_obligation_count: without.length - missing.length,
+        ...(cleared === null ? {} : { clearance: cleared.summary }),
         events,
         note: regime === null
             ? 'The country pack of this company declares no fiscalisation regime.'
             : !counted
                 ? uncountedNote(regime)
-                : broken.length > 0
-                    ? `The chain of ${broken.map((s) => String(s['system_id'])).join(', ')} breaks where break says. Nothing more is chained to it; this is for the company's accountant before anything else.`
-                    : missing.length > 0
-                        ? `${missing.length} posted sale(s) dated from ${from ?? 'the start of the obligation'} have no fiscal record. Nothing is fiscalised on its own: einvoicing_fiscalise (ekwo einvoice fiscalise) chains one.`
-                        : 'Every posted sale within the obligation has its record, and every chain is intact.',
+                : cleared !== null
+                    ? clearanceNote(regime, missing.length, from, cleared.summary)
+                    : broken.length > 0
+                        ? `The chain of ${broken.map((s) => String(s['system_id'])).join(', ')} breaks where break says. Nothing more is chained to it; this is for the company's accountant before anything else.`
+                        : missing.length > 0
+                            ? `${missing.length} posted sale(s) dated from ${from ?? 'the start of the obligation'} have no fiscal record. Nothing is fiscalised on its own: einvoicing_fiscalise (ekwo einvoice fiscalise) chains one.`
+                            : 'Every posted sale within the obligation has its record, and every chain is intact.',
+    };
+}
+export const CLEARANCE_STATES = ['submitted', 'validated', 'rejected', 'cancelled'];
+/** What the authority, the buyer or the issuer can bring a submission to. */
+export const CLEARANCE_ANSWERS = ['validated', 'rejected', 'cancelled'];
+/** The arguments of a call, without the ones nobody gave: the function's own default then holds. */
+const given = (args) => Object.fromEntries(Object.entries(args).filter(([, value]) => value !== undefined));
+/**
+ * Records that a posted sale was submitted to the authority under its
+ * company's clearance regime. Calls nobody: the submission is the host's,
+ * and this keeps what it reports. The database refuses a second submission
+ * while one waits, after a validation or after a cancellation.
+ */
+export async function recordClearanceSubmission(backend, documentId, submission = {}) {
+    const [row] = await backend.rpc('record_clearance_submission', given({
+        p_document_id: documentId,
+        p_reference: submission.reference,
+        p_issue_id: submission.issueId,
+        p_submitted_at: submission.submittedAt,
+        p_answer: submission.answer,
+    }), SCHEMA);
+    if (row === undefined)
+        throw new BooksError('einvoicing_no_answer: einvoicing.record_clearance_submission answered nothing');
+    return {
+        document_id: documentId,
+        clearance: row,
+        note: `Recorded as attempt ${String(row['attempt'])} of this document, submitted as ${String(row['format'])} and waiting for the authority's answer, which einvoicing_clearance (ekwo einvoice clearance) records. The invoice is valid once the authority has validated it.`,
+    };
+}
+/**
+ * Records what came back about the latest submission of a document: its
+ * validation, with the identifier and the moment the authority gave it; a
+ * rejection by the authority or, within the regime's window, by the buyer;
+ * its cancellation by the issuer, within the regime's window. Every
+ * transition is checked by `einvoicing.record_clearance_answer()`, which
+ * raises on one that cannot have happened.
+ */
+export async function recordClearanceAnswer(backend, documentId, answer) {
+    const [row] = await backend.rpc('record_clearance_answer', given({
+        p_document_id: documentId,
+        p_state: answer.state,
+        p_identifier: answer.identifier,
+        p_validated_at: answer.validatedAt,
+        p_verification_url: answer.verificationUrl,
+        p_reason: answer.reason,
+        p_by: answer.by,
+        p_at: answer.at,
+        p_answer: answer.answer,
+    }), SCHEMA);
+    if (row === undefined)
+        throw new BooksError('einvoicing_no_answer: einvoicing.record_clearance_answer answered nothing');
+    const state = String(row['state']);
+    return {
+        document_id: documentId,
+        clearance: row,
+        note: state === 'validated'
+            ? `Validated by the authority as ${String(row['identifier'])}: the invoice is valid${row['verification_url'] === null ? '' : ', and carries the link to its verification'}.`
+            : state === 'cancelled'
+                ? 'Cancelled at the authority: the invoice is void there. It is undone in the books with cancel_document.'
+                : row['rejected_by'] === 'buyer'
+                    ? 'Rejected by the buyer: the invoice stays valid at the authority until the issuer cancels it, within the regime\'s window, or settles with the buyer.'
+                    : 'Rejected by the authority, which did not validate it. The books are corrected and the invoice submitted again: that is the next attempt.',
     };
 }
+const CLEARANCE = [
+    'id', 'document_id', 'attempt', 'format', 'state', 'reference', 'submitted_at', 'identifier', 'validated_at',
+    'verification_url', 'rejected_by', 'rejected_at', 'rejection_reason', 'cancelled_at', 'cancellation_reason',
+];
+/**
+ * Where the posted sales of a company stand under a clearance regime, by the
+ * latest submission of each: validated, waiting, rejected by the authority,
+ * rejected by the buyer, or cancelled at the authority while still posted
+ * here. `unvalidated` is the sales never submitted or rejected by the
+ * authority — the ones the status counts as missing. A credit note that
+ * undoes an invoice cancelled at the authority is the books' half of that
+ * cancellation, and is not one of them.
+ */
+async function clearanceOf(backend, companyId, posted, limit) {
+    const all = await backend.select({
+        schema: SCHEMA,
+        table: 'clearances',
+        columns: CLEARANCE,
+        where: [{ column: 'company_id', op: 'eq', value: companyId }],
+        order: [{ column: 'document_id' }, { column: 'attempt' }],
+    });
+    const latest = new Map();
+    for (const clearance of all)
+        latest.set(String(clearance['document_id']), clearance);
+    const voided = new Set([...latest.values()].filter((c) => c['state'] === 'cancelled').map((c) => String(c['document_id'])));
+    const unvalidated = new Set();
+    const awaiting = [];
+    const rejected = [];
+    const buyerRejected = [];
+    const cancelled = [];
+    let validated = 0;
+    for (const document of posted) {
+        const id = String(document['id']);
+        const last = latest.get(id);
+        if (last === undefined) {
+            const undoes = document['reversed_document_id'];
+            if (!(undoes !== null && undoes !== undefined && voided.has(String(undoes))))
+                unvalidated.add(id);
+            continue;
+        }
+        const { id: clearanceId, ...clearance } = last;
+        const entry = { id, doc_type: document['doc_type'], number: document['number'], document_date: document['document_date'], clearance_id: clearanceId, ...clearance };
+        if (last['state'] === 'validated')
+            validated += 1;
+        else if (last['state'] === 'submitted')
+            awaiting.push(entry);
+        else if (last['state'] === 'cancelled')
+            cancelled.push(entry);
+        else if (last['rejected_by'] === 'buyer')
+            buyerRejected.push(entry);
+        else {
+            unvalidated.add(id);
+            rejected.push(entry);
+        }
+    }
+    return {
+        unvalidated,
+        summary: {
+            validated_count: validated,
+            awaiting: awaiting.slice(0, limit),
+            awaiting_count: awaiting.length,
+            rejected: rejected.slice(0, limit),
+            rejected_count: rejected.length,
+            buyer_rejected: buyerRejected.slice(0, limit),
+            buyer_rejected_count: buyerRejected.length,
+            cancelled_still_posted: cancelled.slice(0, limit),
+            cancelled_still_posted_count: cancelled.length,
+        },
+    };
+}
+/** Today, as the calendar day of this machine. */
+const today = () => generatedNow().slice(0, 10);
+/** What the status says of a company under a clearance regime in force. */
+function clearanceNote(regime, missing, from, summary) {
+    const brick = brickOf(regime);
+    const sentences = [
+        `The country pack of this company declares a clearance regime, ${regime.format}: an invoice is valid once the authority has validated it, and nothing is chained.`,
+        brick === null
+            ? `No brick of packages/formats/ writes ${regime.format} yet (format_without_brick): Ekwo writes no file to submit, and records the submissions a host makes and the answers it receives.`
+            : `${brick} writes the file submitted.`,
+    ];
+    if (missing > 0) {
+        sentences.push(`${missing} posted sale(s) dated from ${from ?? 'the start of the obligation'} have no validation and none on its way${summary.rejected_count > 0 ? `, ${summary.rejected_count} of them rejected by the authority` : ''}. Nothing is submitted on its own: a host submits them, and einvoicing_clearance (ekwo einvoice clearance) records the submission and the answer.`);
+    }
+    if (summary.awaiting_count > 0)
+        sentences.push(`${summary.awaiting_count} wait for the authority's answer.`);
+    if (summary.buyer_rejected_count > 0) {
+        sentences.push(`${summary.buyer_rejected_count} were rejected by the buyer after their validation: the issuer cancels them within the regime's window, or settles with the buyer.`);
+    }
+    if (summary.cancelled_still_posted_count > 0) {
+        sentences.push(`${summary.cancelled_still_posted_count} were cancelled at the authority and are still posted here: cancel_document undoes them in the books.`);
+    }
+    if (missing === 0 && summary.awaiting_count + summary.buyer_rejected_count + summary.cancelled_still_posted_count === 0) {
+        sentences.push('Every posted sale within the obligation is validated by the authority.');
+    }
+    const exemption = exemptionOn(regime, today());
+    if (exemption !== null || regime.mandatory_from.some((entry) => entry.turnover_above !== undefined)) {
+        sentences.push(`The obligation depends on the size of the taxpayer${exemption === null
+            ? ''
+            : `, and a taxpayer below ${exemption.turnover_below.amount} ${exemption.turnover_below.currency} of annual turnover is exempted since ${exemption.valid_from}`}; the books do not decide which this company is, so the count starts on the earliest day, ${from ?? 'none declared'}.`);
+    }
+    return sentences.join(' ');
+}
 /** Why the status counts no sale as missing a record under a regime that is announced only, or that reports. */
 function uncountedNote(regime) {
     if (regime.announced_from !== null) {