@ekwo-ai/core 0.13.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

@@ -0,0 +1,296 @@
+/**
+ * Fiscalisation: the chained record a country requires the invoicing
+ * software to leave for every invoice it issues.
+ *
+ * A capability of the `einvoicing` module, and the same shape as issuing an
+ * electronic invoice: a posted sale, an artefact a brick writes, a state the
+ * database records. Here the artefact is a fiscal record, and what the
+ * database keeps is a chain — each record carries the hash of the one before
+ * it, in one company and one invoicing system.
+ *
+ * **The core knows no country.** Whether a company has such a regime, and
+ * every rule of it, is the `einvoicing.fiscalisation` block of its country
+ * pack, which the socle compiles into `country_defaults.einvoice_fiscalisation`
+ * and `einvoicing.fiscal_regime()` reads back. Which brick writes the record
+ * is the pack's `format`, looked up in `FISCALISATION_FORMATS` — the same
+ * pattern as `EINVOICE_FORMATS` — and a format no brick of this release writes
+ * is refused by name, `format_without_brick`.
+ *
+ * **The gesture is explicit.** Nothing here runs on posting. A posted sale of
+ * a company whose pack declares a regime and that has no record is named by
+ * `fiscalisationStatus()`, and `fiscaliseDocument()` is called by somebody who
+ * decided to chain it — `ekwo einvoice fiscalise`, `einvoicing_fiscalise`.
+ *
+ * What only a program can do is here: run the brick, read the tail of the
+ * chain, read the hashed fields back out of the text the brick hashed. What
+ * 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';
+/** 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"];
+/** What a record says of its invoice: issued, or its record cancelled. */
+export type FiscalRecordKind = 'alta' | 'anulacion';
+export declare const FISCAL_RECORD_KINDS: readonly ["alta", "anulacion"];
+/**
+ * The invoicing system that generates the record. Every field is a fact of
+ * the product or of its installation that the operator states, and none is
+ * invented here. The three booleans are facts a regime may ask of the
+ * product — whether it can only send, whether it can keep the books of
+ * several taxpayers, whether it does now; a brick whose regime does not ask
+ * ignores them.
+ */
+export interface FiscalSystem {
+    name: string;
+    id: string;
+    version: string;
+    installation: string;
+    producerName: string;
+    producerTaxId: string;
+    verifactuOnly?: boolean;
+    multipleTaxpayers?: boolean;
+    multipleTaxpayersNow?: boolean;
+}
+/** One record to write: the document as the books publish it, and what only the system knows. */
+export interface FiscalRecordInput {
+    header: Row;
+    lines: Row[];
+    taxes: Row[];
+    kind: FiscalRecordKind;
+    /** ISO 8601 with its offset: `2027-01-04T10:15:00+01:00`. */
+    generatedAt: string;
+    system: FiscalSystem;
+    /** The record before it in this system, or null for the first. */
+    previous: {
+        taxId: string;
+        series: string;
+        number: string;
+        issuedOn: string;
+        hash: string;
+    } | null;
+}
+/** What a brick of `packages/formats/` provides for one fiscalisation format. */
+export interface FiscalisationFormat {
+    /** The name a pack declares in `einvoicing.fiscalisation.format`. */
+    format: string;
+    /** The package that writes it, by its published name. */
+    brick: string;
+    /** What the record declares it follows. */
+    specification: string;
+    /** The exact text the regime hashes. */
+    hashInput(input: FiscalRecordInput): string;
+    /** Its digest, as the record carries it. */
+    hash(input: FiscalRecordInput): string;
+    write(input: FiscalRecordInput): {
+        content: string;
+        filename: string;
+        mediaType: string;
+        violations: EinvoiceViolation[];
+    };
+    /** What the QR code of the invoice encodes, for a mode of submission. */
+    verificationUrl(input: FiscalRecordInput, mode: FiscalSubmissionMode, environment?: 'production' | 'test'): string;
+}
+/** Every fiscalisation format a brick of this release writes, by the name a pack declares it under. */
+export declare const FISCALISATION_FORMATS: Readonly<Record<string, FiscalisationFormat>>;
+/**
+ * The format of a pack's regime, or the refusal that names the missing brick.
+ * Nothing is written in the nearest format that exists: a record in another
+ * 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. `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' | 'clearance' | 'reporting';
+    format: string;
+    /** 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;
+    announced_on: string | null;
+    hash: {
+        algorithm: string;
+        separator: string | null;
+        fields: Partial<Record<FiscalRecordKind | '*', string[]>>;
+    } | null;
+    qr: {
+        size_mm: {
+            min: number;
+            max: number;
+        };
+        error_correction: string;
+        label: string | null;
+    } | null;
+    mention: {
+        text: string;
+        alternatives: string[];
+        modes: FiscalSubmissionMode[];
+    }[];
+    submission: {
+        mode: FiscalSubmissionMode;
+        modes: FiscalSubmissionMode[];
+        channel: string | null;
+        cadence: Row[];
+    };
+    events: {
+        summary_every_hours: number;
+        modes: FiscalSubmissionMode[];
+    } | null;
+    reported: {
+        what: string;
+        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;
+}
+/** The fiscalisation regime of a company's fiscal country, or null. */
+export declare function fiscalRegime(backend: Backend, companyId: string): Promise<FiscalRegime | null>;
+/**
+ * The fields a hash covers, read back out of the text the brick hashed, in
+ * the order the pack names them: `name=value` joined by the pack's separator.
+ * Null where the text does not hold them in that order — the pack and the
+ * brick then disagree about what is hashed, and nothing is chained.
+ */
+export declare function hashedFields(text: string, fields: readonly string[], separator: string): Record<string, string> | null;
+/** Now, as ISO 8601 with the offset of this machine: what a record says it was generated at. */
+export declare function generatedNow(at?: Date): string;
+/** The chain a system keeps for a company: its identifier and its installation. */
+export declare const fiscalSystemId: (system: FiscalSystem) => string;
+export interface FiscaliseOptions {
+    system: FiscalSystem;
+    /** `alta` (the default) when the invoice is issued, `anulacion` when its record is cancelled. */
+    kind?: FiscalRecordKind;
+    /** One of the modes the pack allows; the pack's default when left out. */
+    mode?: FiscalSubmissionMode;
+    /** When the record is generated, ISO 8601 with its offset. Now, on this machine, when left out. */
+    generatedAt?: string;
+    /** Which service of the authority the verification URL points at. */
+    environment?: 'production' | 'test';
+    /** Why a credit note rectifies, in the regime's own code, where it asks and the books do not say. */
+    rectification?: string;
+    /** Write the record and say what is wrong with it; chain nothing. */
+    dryRun?: boolean;
+    /** Hand the file back too. */
+    includeFile?: boolean;
+}
+/**
+ * Writes the fiscal record of a posted sale with the brick its pack's regime
+ * names, and — unless it breaks a rule or `dryRun` is asked — chains it after
+ * the tail of the system's chain and keeps its file. A document whose record
+ * 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,
+ * and the latest events. A posted sale without a record is named here and
+ * never fiscalised on the way.
+ */
+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";
+/**
+ * The invoicing system, from the JSON an operator wrote: every text field
+ * present and not blank, the three booleans booleans where given. Nothing is
+ * filled in — a producer's tax number guessed is a record the authority
+ * attributes to somebody else.
+ */
+export declare function parseFiscalSystem(value: unknown, where?: string): FiscalSystem;
+//# sourceMappingURL=fiscalisation.d.ts.map

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

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