@ekwo-ai/document-reading 0.0.0-stage → 0.19.0

package/dist/model.js

@@ -0,0 +1,434 @@
+/**
+ * The model path: a photograph or a plain PDF, read by a vision model.
+ *
+ * This package calls no model. It publishes what a caller sends to one — the
+ * JSON schema the answer is held to (`readingSchema()`) and the words that go
+ * with it (`readingPrompt()`) — and checks what comes back (`readingOf()`)
+ * into the `ReceivedInvoice` the exact readers return, so that whatever turns
+ * an invoice into a purchase does it once for a Factur-X file and for a
+ * photograph of a till receipt. The call, its key, its timeout and what it
+ * costs stay with the product that makes it.
+ *
+ * The model copies; it never computes. Every figure is the text the page
+ * prints, every code one the page prints or that names, in a published list,
+ * a word the page prints. A field the page does not print is left empty, and
+ * `readingOf()` keeps it empty: `null` where `ReceivedInvoice` allows it,
+ * `''` where EN 16931 requires a value, named then in `missing`. Nothing is
+ * defaulted — not the currency, not the date, not a quantity of one.
+ *
+ * A caller may ask for more than an invoice: an energy layer asks for the
+ * meter, the bands and the contract type. It hands an `extension` — its own
+ * properties, in JSON schema — and gets them back, untouched, beside the
+ * invoice. The same call reads both.
+ */
+import { checkReceived, isValidIban, toUnitCode, } from '@ekwo-ai/factur-x';
+/** Changed with every change of the schema or of the words below; a product writes it in the log of every reading. */
+export const READING_VERSION = '2026-10-22';
+export const CONFIDENCES = ['high', 'medium', 'low'];
+/**
+ * The fields of the document the model rates its confidence in, one by one.
+ * A line rates itself (`lines[n]`).
+ */
+export const CONFIDENCE_FIELDS = [
+    'document',
+    'number',
+    'issue_date',
+    'due_date',
+    'currency',
+    'seller',
+    'seller_vat_id',
+    'seller_legal_id',
+    'buyer',
+    'invoicing_period',
+    'taxes',
+    'totals',
+    'payment',
+];
+/**
+ * The categories of VAT EN 16931 names (UNTDID 5305, the subset of BT-118):
+ * standard, zero, exempt, reverse charge, intra-Community, export, outside the
+ * scope, and the two of the Canary Islands, Ceuta and Melilla.
+ */
+export const VAT_CATEGORIES = ['S', 'Z', 'E', 'AE', 'K', 'G', 'O', 'L', 'M'];
+// ---------------------------------------------------------------------------
+// The schema
+// ---------------------------------------------------------------------------
+const TEXT = (description) => ({ type: 'string', description });
+const DECIMAL = (description) => TEXT(`${description} Digits, a dot for the decimals, a leading minus where printed; no grouping, no currency sign. Empty if not printed.`);
+const DAY = (description) => TEXT(`${description} YYYY-MM-DD, or empty if not printed.`);
+function object(properties, description) {
+    return {
+        type: 'object',
+        ...(description === undefined ? {} : { description }),
+        additionalProperties: false,
+        required: Object.keys(properties),
+        properties,
+    };
+}
+const CONFIDENCE = { type: 'string', enum: CONFIDENCES };
+const PERIOD = (what) => object({ start: DAY(`First day of ${what}.`), end: DAY(`Last day of ${what}.`) }, `${what[0]?.toUpperCase()}${what.slice(1)}, as printed; both empty when none is printed.`);
+const ADDRESS = object({
+    lines: { type: 'array', items: { type: 'string' }, description: 'The street lines, as printed, in order.' },
+    city: TEXT('As printed, or empty.'),
+    postal_code: TEXT('As printed, or empty.'),
+    country: TEXT('ISO 3166-1 alpha-2 code of the country printed in the address, or empty.'),
+}, 'The postal address, as printed.');
+const PARTY = (who) => object({
+    name: TEXT(`The legal name of ${who}, as printed.`),
+    trade_name: TEXT(`The name ${who} trades under, where printed beside the legal name; otherwise empty.`),
+    vat_id: TEXT(`The VAT identifier of ${who}, as printed, its country prefix included; empty if none is printed.`),
+    legal_id: TEXT(`The company registration number of ${who}, as printed; empty if none is printed.`),
+    tax_registration_id: TEXT(`A tax registration number of ${who} other than the VAT identifier, as printed; otherwise empty.`),
+    address: ADDRESS,
+}, `${who[0]?.toUpperCase()}${who.slice(1)}.`);
+const LINE = object({
+    name: TEXT('What the line bills, as printed.'),
+    description: TEXT('A further description printed on the line, or empty.'),
+    quantity: DECIMAL('The quantity, as printed.'),
+    unit: TEXT('The unit of the quantity, as printed (kWh, h, pcs…), or empty.'),
+    unit_code: TEXT('The UN/ECE Recommendation 20 code of that unit (KWH, HUR, C62…) where the printed unit names exactly one; otherwise empty.'),
+    net_price: DECIMAL('The price of one unit before VAT, as printed.'),
+    net_amount: DECIMAL('The amount of the line before VAT, as printed.'),
+    vat_category: TEXT('The VAT category of the line, an UNTDID 5305 code (S, Z, E, AE, K, G, O, L, M), where the page prints it or prints the words that name it; otherwise empty.'),
+    vat_rate: DECIMAL('The VAT rate of the line in percent, as printed.'),
+    period: PERIOD('the period this line bills'),
+    confidence: { ...CONFIDENCE, description: 'How sure you are of what you copied on this line.' },
+});
+const TAX = object({
+    category: TEXT('The VAT category of the group, an UNTDID 5305 code, where printed or named; otherwise empty.'),
+    rate: DECIMAL('The rate in percent.'),
+    base: DECIMAL('The amount the tax is computed on, at that rate.'),
+    tax: DECIMAL('The tax at that rate.'),
+    amount_including_tax: DECIMAL('The amount including tax at that rate, where the page prints it.'),
+    exemption_reason: TEXT('The reason printed for a rate of zero or an exemption, or empty.'),
+});
+/**
+ * The JSON schema of the answer, as a structured output takes it: every
+ * object closed, every property required and answered — with an empty text,
+ * an empty list — where the page does not print it.
+ */
+export function readingSchema(extension) {
+    const properties = {
+        document: {
+            type: 'string',
+            enum: ['invoice', 'credit_note', 'receipt', 'other'],
+            description: 'invoice: a supplier asks to be paid. credit_note: it gives money back. receipt: what was bought and already paid, a till receipt. other: anything else.',
+        },
+        number: TEXT('The number of the invoice, credit note or receipt, as printed; empty if none is printed.'),
+        issue_date: DAY('The date the document was issued.'),
+        due_date: DAY('The date payment is due, where printed.'),
+        tax_point_date: DAY('The date the tax falls due, where printed apart from the issue date.'),
+        currency: TEXT('The ISO 4217 code of the currency the amounts are in, where the page prints the code, the symbol or the name of one currency only; empty otherwise. Never the currency of a country the page is from.'),
+        seller: PARTY('the supplier who issued the document'),
+        buyer: PARTY('the customer the document is addressed to'),
+        buyer_reference: TEXT('A reference of the customer printed for its own use (customer number, account number), or empty.'),
+        order_reference: TEXT('The purchase order the document refers to, as printed, or empty.'),
+        contract_reference: TEXT('The contract the document refers to, as printed, or empty.'),
+        preceding_invoice: TEXT('On a credit note, the number of the invoice it corrects, as printed; otherwise empty.'),
+        invoicing_period: PERIOD('the period the whole document bills'),
+        payment: object({
+            iban: TEXT('The account to pay to, as printed, spaces removed, or empty.'),
+            bic: TEXT('The BIC of that account, as printed, or empty.'),
+            reference: TEXT('The reference to quote when paying, as printed, or empty.'),
+            terms: TEXT('The terms of payment, as printed, or empty.'),
+        }, 'How the supplier asks to be paid.'),
+        lines: {
+            type: 'array',
+            description: 'One entry per line the page prints, in order; empty when it prints none.',
+            items: LINE,
+        },
+        taxes: {
+            type: 'array',
+            description: 'One entry per VAT rate the page prints in its tax summary, in order; empty when it prints none.',
+            items: TAX,
+        },
+        totals: object({
+            line_total: DECIMAL('The sum of the lines, where printed.'),
+            tax_exclusive: DECIMAL('The total without VAT.'),
+            tax_total: DECIMAL('The total VAT.'),
+            tax_inclusive: DECIMAL('The total with VAT.'),
+            prepaid: DECIMAL('What was already paid, where printed.'),
+            payable: DECIMAL('The amount still to pay.'),
+        }, 'The totals the page prints.'),
+        confidence: object(Object.fromEntries(CONFIDENCE_FIELDS.map((field) => [field, CONFIDENCE])), 'How sure you are of what you copied into each field: high, medium, low.'),
+    };
+    if (extension !== undefined) {
+        properties['extension'] = {
+            type: 'object',
+            additionalProperties: false,
+            required: extension.required ?? Object.keys(extension.properties),
+            properties: extension.properties,
+        };
+    }
+    return object(properties);
+}
+/** The words that go with the schema. Nothing in them names a country, a currency or a language. */
+export const READING_PROMPT = `You read one purchase document for a company's books: an invoice, a credit note or a receipt, as a photograph or a PDF. Answer with what is printed on it, in the JSON format required.
+
+Copy, never compute. Every amount, quantity, price and rate is the one printed, with a dot as the decimal separator, no grouping and no currency sign. Never add, multiply, convert or round a figure, and never fill a total from its parts: a total that is not printed stays empty.
+
+Leave empty rather than guess. A field the page does not print is an empty text or an empty list. The currency is the one the page prints by code, symbol or name; when it prints none, or a symbol several currencies share, leave it empty. A code (a country, a unit, a VAT category) is given only where the page prints it or prints words that name exactly one.
+
+Dates are YYYY-MM-DD. Give one entry in lines per line printed, with its own period where it prints one, and one entry in taxes per rate of the tax summary. For each field of confidence, say how sure you are of what you copied there.
+
+If the page is not a purchase document, answer document "other" and leave every other field empty.`;
+/** The words, with the caller's own instructions for its extension after them. */
+export function readingPrompt(extension) {
+    const more = extension?.instructions?.trim();
+    return more === undefined || more.length === 0
+        ? READING_PROMPT
+        : `${READING_PROMPT}\n\nThe field extension is asked for by the caller:\n${more}`;
+}
+const MAX_LINES = 500;
+const MAX_TAXES = 20;
+const bag = (value) => (value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {});
+const list = (value, max) => (Array.isArray(value) ? value.slice(0, max).map(bag) : []);
+/** The checker of one answer: what it rejects is remembered by path. */
+class Checker {
+    rejected = [];
+    text(value, max = 300) {
+        if (typeof value !== 'string')
+            return null;
+        const kept = value.replace(/\s+/g, ' ').trim().slice(0, max);
+        return kept.length === 0 ? null : kept;
+    }
+    /** A decimal as printed: blanks removed, a lone comma read as the decimal separator; anything else rejected. */
+    decimal(value, path) {
+        const raw = this.text(value, 40);
+        if (raw === null)
+            return null;
+        const compact = raw.replace(/[\s  ]/g, '').replace(/^(-?\d+),(\d+)$/, '$1.$2');
+        if (/^-?\d{1,15}(\.\d{1,8})?$/.test(compact))
+            return compact;
+        this.rejected.push(path);
+        return null;
+    }
+    day(value, path) {
+        const raw = this.text(value, 40);
+        if (raw === null)
+            return null;
+        if (/^\d{4}-\d{2}-\d{2}$/.test(raw) && new Date(`${raw}T00:00:00Z`).toISOString().startsWith(raw))
+            return raw;
+        this.rejected.push(path);
+        return null;
+    }
+    code(value, path, shape) {
+        const raw = this.text(value, 40);
+        if (raw === null)
+            return null;
+        const upper = raw.toUpperCase();
+        if (shape.test(upper))
+            return upper;
+        this.rejected.push(path);
+        return null;
+    }
+    category(value, path) {
+        const code = this.code(value, path, /^[A-Z]{1,2}$/);
+        if (code === null || VAT_CATEGORIES.includes(code))
+            return code;
+        this.rejected.push(path);
+        return null;
+    }
+    period(value, path) {
+        const read = bag(value);
+        const start = this.day(read['start'], `${path}.start`);
+        const end = this.day(read['end'], `${path}.end`);
+        return start === null && end === null ? null : { start, end };
+    }
+}
+function addressOf(check, value, path) {
+    const read = bag(value);
+    const lines = (Array.isArray(read['lines']) ? read['lines'] : [])
+        .slice(0, 5)
+        .map((line) => check.text(line))
+        .filter((line) => line !== null);
+    const address = {
+        lines,
+        city: check.text(read['city'], 100),
+        postalCode: check.text(read['postal_code'], 20),
+        region: null,
+        country: check.code(read['country'], `${path}.country`, /^[A-Z]{2}$/),
+    };
+    return lines.length === 0 && address.city === null && address.postalCode === null && address.country === null ? null : address;
+}
+function partyOf(check, value, path) {
+    const read = bag(value);
+    const legal = check.text(read['legal_id'], 60);
+    return {
+        name: check.text(read['name'], 200),
+        tradeName: check.text(read['trade_name'], 200),
+        identifiers: [],
+        legalId: legal === null ? null : { value: legal, scheme: null },
+        vatId: check.text(read['vat_id'], 40)?.replace(/[\s.]/g, '') ?? null,
+        taxRegistrationId: check.text(read['tax_registration_id'], 60),
+        legalForm: null,
+        electronicAddress: null,
+        address: addressOf(check, read['address'], `${path}.address`),
+        contact: null,
+    };
+}
+function confidenceOf(value) {
+    return typeof value === 'string' && CONFIDENCES.includes(value) ? value : null;
+}
+/**
+ * The model's answer, parsed from its JSON, checked into a `ReceivedInvoice`.
+ *
+ * Anything not of the shape the schema asks for is left empty and named in
+ * `rejected`; anything EN 16931 requires and the answer leaves empty is `''`
+ * and named in `missing`. Nothing is computed, defaulted or corrected.
+ * `undefined` where the answer is not an object, or says the page is not a
+ * purchase document.
+ */
+export function readingOf(answer) {
+    if (answer === null || typeof answer !== 'object' || Array.isArray(answer))
+        return undefined;
+    const read = answer;
+    const document = read['document'];
+    if (document !== 'invoice' && document !== 'credit_note' && document !== 'receipt')
+        return undefined;
+    const check = new Checker();
+    const missing = [];
+    const required = (value, path) => {
+        if (value !== null)
+            return value;
+        missing.push(path);
+        return '';
+    };
+    const lines = list(read['lines'], MAX_LINES).map((line, index) => {
+        const path = `lines[${index}]`;
+        const printedUnit = check.text(line['unit'], 20);
+        const unitCode = check.code(line['unit_code'], `${path}.unit_code`, /^[A-Z0-9]{2,3}$/) ??
+            (printedUnit === null ? null : knownUnit(printedUnit));
+        return {
+            id: String(index + 1),
+            note: null,
+            quantity: check.decimal(line['quantity'], `${path}.quantity`),
+            unitCode,
+            netAmount: required(check.decimal(line['net_amount'], `${path}.net_amount`), `${path}.net_amount`),
+            orderLineReference: null,
+            period: check.period(line['period'], `${path}.period`),
+            allowances: [],
+            netPrice: check.decimal(line['net_price'], `${path}.net_price`),
+            priceDiscount: null,
+            grossPrice: null,
+            priceBaseQuantity: null,
+            priceBaseUnitCode: null,
+            vatCategory: check.category(line['vat_category'], `${path}.vat_category`),
+            vatRate: check.decimal(line['vat_rate'], `${path}.vat_rate`),
+            name: check.text(line['name']),
+            description: check.text(line['description'], 1000),
+            sellerItemId: null,
+            buyerItemId: null,
+            standardItemId: null,
+        };
+    });
+    const printedTaxes = list(read['taxes'], MAX_TAXES);
+    const taxes = printedTaxes.map((tax, index) => {
+        const path = `taxes[${index}]`;
+        return {
+            category: check.category(tax['category'], `${path}.category`),
+            rate: check.decimal(tax['rate'], `${path}.rate`),
+            base: required(check.decimal(tax['base'], `${path}.base`), `${path}.base`),
+            tax: required(check.decimal(tax['tax'], `${path}.tax`), `${path}.tax`),
+            exemptionReasonCode: null,
+            exemptionReason: check.text(tax['exemption_reason']),
+        };
+    });
+    const taxInclusiveByGroup = printedTaxes.map((tax, index) => check.decimal(tax['amount_including_tax'], `taxes[${index}].amount_including_tax`));
+    const totals = bag(read['totals']);
+    const payment = bag(read['payment']);
+    const iban = check.text(payment['iban'], 40)?.replace(/\s/g, '').toUpperCase() ?? null;
+    const bic = check.code(payment['bic'], 'payment.bic', /^[A-Z0-9]{8}([A-Z0-9]{3})?$/);
+    const paymentReference = check.text(payment['reference'], 140);
+    const paymentMeans = iban === null && bic === null && paymentReference === null
+        ? []
+        : [
+            {
+                code: null,
+                text: null,
+                reference: paymentReference,
+                account: iban === null ? null : isValidIban(iban) ? { kind: 'iban', value: iban } : { kind: 'other', value: iban },
+                accountName: null,
+                bic,
+                cardNumber: null,
+                mandateReference: null,
+                debitedAccount: null,
+            },
+        ];
+    const preceding = check.text(read['preceding_invoice'], 60);
+    const invoice = {
+        syntax: 'model',
+        customizationId: null,
+        profileId: null,
+        kind: document === 'credit_note' ? 'credit_note' : 'invoice',
+        typeCode: null,
+        number: required(check.text(read['number'], 60), 'number'),
+        issueDate: required(check.day(read['issue_date'], 'issue_date'), 'issue_date'),
+        dueDate: check.day(read['due_date'], 'due_date'),
+        taxPointDate: check.day(read['tax_point_date'], 'tax_point_date'),
+        currency: required(check.code(read['currency'], 'currency', /^[A-Z]{3}$/), 'currency'),
+        taxCurrency: null,
+        buyerReference: check.text(read['buyer_reference'], 100),
+        orderReference: check.text(read['order_reference'], 100),
+        salesOrderReference: null,
+        contractReference: check.text(read['contract_reference'], 100),
+        projectReference: null,
+        accountingCost: null,
+        precedingInvoices: preceding === null ? [] : [{ number: preceding, issueDate: null }],
+        notes: [],
+        seller: partyOf(check, read['seller'], 'seller'),
+        buyer: partyOf(check, read['buyer'], 'buyer'),
+        deliveryDate: null,
+        deliveryAddress: null,
+        invoicingPeriod: check.period(read['invoicing_period'], 'invoicing_period'),
+        paymentTerms: check.text(payment['terms'], 500),
+        paymentMeans,
+        allowances: [],
+        taxes,
+        totals: {
+            lineTotal: check.decimal(totals['line_total'], 'totals.line_total'),
+            allowanceTotal: null,
+            chargeTotal: null,
+            taxExclusive: required(check.decimal(totals['tax_exclusive'], 'totals.tax_exclusive'), 'totals.tax_exclusive'),
+            taxTotal: check.decimal(totals['tax_total'], 'totals.tax_total'),
+            taxTotalInTaxCurrency: null,
+            taxInclusive: required(check.decimal(totals['tax_inclusive'], 'totals.tax_inclusive'), 'totals.tax_inclusive'),
+            prepaid: check.decimal(totals['prepaid'], 'totals.prepaid'),
+            rounding: null,
+            payable: required(check.decimal(totals['payable'], 'totals.payable'), 'totals.payable'),
+        },
+        lines,
+        attachments: [],
+    };
+    if (invoice.seller.name === null && invoice.seller.tradeName === null)
+        missing.push('seller.name');
+    const figures = ['totals.tax_exclusive', 'totals.tax_inclusive', 'totals.payable', 'lines[', 'taxes['];
+    const complete = !missing.some((path) => figures.some((figure) => path.startsWith(figure)));
+    const said = bag(read['confidence']);
+    const confidence = Object.fromEntries(CONFIDENCE_FIELDS.map((field) => [field, confidenceOf(said[field])]));
+    list(read['lines'], MAX_LINES).forEach((line, index) => {
+        confidence[`lines[${index}]`] = confidenceOf(line['confidence']);
+    });
+    const extension = read['extension'];
+    return {
+        document,
+        invoice,
+        violations: complete ? checkReceived(invoice) : [],
+        missing,
+        rejected: check.rejected,
+        confidence,
+        taxInclusiveByGroup,
+        extension: extension !== null && typeof extension === 'object' ? extension : null,
+    };
+}
+/**
+ * The UN/ECE code of a printed unit, where the list of words of
+ * `@ekwo-ai/factur-x` knows it; null where it does not, rather than the
+ * `C62` that list falls back to — and so null for a printed "unit" too,
+ * which the model is asked to code itself.
+ */
+function knownUnit(printed) {
+    const code = toUnitCode(printed);
+    return code === 'C62' ? null : code;
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

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

package/dist/purchase.d.ts

@@ -0,0 +1,123 @@
+/**
+ * The purchase a received invoice becomes, before anybody's books are read.
+ *
+ * Whichever way the invoice was read — a Factur-X file, a UBL message, a
+ * photograph read by a model — it is one `ReceivedInvoice`, and this file
+ * turns it into the draft of a purchase document in the columns of Ekwo OS
+ * (`documents`, `document_lines`): the fields a caller passes to
+ * `create_document` once it has chosen, in its own books, the supplier, the
+ * account and the tax. Those three choices need the books and the country
+ * pack, so they are not made here; the draft carries what they are made
+ * from — the supplier as the invoice names it, and each line's VAT category
+ * and rate.
+ *
+ * What the core has a column for goes in that column: the unit code of a
+ * line, the supplier's invoice number, the references, the due date, the
+ * tax point. What it has none for and EN 16931 carries on a line — the period
+ * a line bills (BG-26) — goes in the line's `attributes`, which hold "what an
+ * electronic invoice format asks of this line that no other column says".
+ * The period of the whole invoice (BG-14) has no column on a document: each
+ * line that states no period of its own takes it, which is what EN 16931
+ * means by it, and the draft returns it as well for whoever keeps it beside
+ * the document.
+ *
+ * Nothing is defaulted: no currency, no date, no name. Where the invoice is
+ * silent the draft is silent, and the caller asks, or fills in its own.
+ */
+import type { DecimalText, ReceivedInvoice } from '@ekwo-ai/factur-x';
+/** A period as EN 16931 carries it: either end may be unknown. */
+export interface Period {
+    start: string | null;
+    end: string | null;
+}
+/**
+ * The names under which a line's `attributes` carry what no column of
+ * `document_lines` holds. The period is BT-134 and BT-135; the three
+ * `invoiced_*` keep the invoice's own quantity, unit and price where the
+ * line had to be written as one unit at its amount (see `PurchaseDraftLine`).
+ */
+export declare const LINE_ATTRIBUTES: {
+    readonly periodStart: "period_start";
+    readonly periodEnd: "period_end";
+    readonly invoicedQuantity: "invoiced_quantity";
+    readonly invoicedUnitCode: "invoiced_unit_code";
+    readonly invoicedNetPrice: "invoiced_net_price";
+};
+/** One line of the draft, in the fields of `document_lines` (`LineArgs` of `@ekwo-ai/core`). */
+export interface PurchaseDraftLine {
+    /** BT-153, else BT-154, else BT-127; null where the invoice names nothing, for the caller to name. */
+    name: string | null;
+    /** BT-154, where it is beside a name. */
+    description: string | null;
+    /**
+     * The invoice's quantity, unit code and net price where they make the
+     * line's amount at the decimals of its currency, as `document_lines`
+     * computes `amount_untaxed`; otherwise one unit (`C62`) at the line's
+     * amount, the invoice's own figures kept in `attributes`.
+     */
+    quantity: DecimalText;
+    unit_code: string;
+    unit_price: DecimalText;
+    /** BT-151 and BT-152, from which the caller chooses the tax of its own pack. */
+    vat_category: string | null;
+    vat_rate: DecimalText | null;
+    /** What `document_lines.attributes` keeps that no column holds; see `LINE_ATTRIBUTES`. */
+    attributes: Record<string, string>;
+}
+/** The draft of a purchase document, in the fields of `documents`. */
+export interface PurchaseDraft {
+    doc_type: 'purchase_invoice' | 'purchase_credit_note';
+    /** BT-2; null where it was not read. */
+    document_date: string | null;
+    /** BT-9. */
+    due_date: string | null;
+    /** BT-7. */
+    tax_point_date: string | null;
+    /** BT-1: the supplier's own number. */
+    supplier_reference: string | null;
+    /** BT-5, as the invoice says it; null where it was not read, never the company's. */
+    currency_code: string | null;
+    buyer_reference: string | null;
+    order_reference: string | null;
+    contract_reference: string | null;
+    project_reference: string | null;
+    delivery_date: string | null;
+    payment_terms: string | null;
+    payment_reference: string | null;
+    /** BT-84 where it is an IBAN. */
+    payee_iban: string | null;
+    /** BG-14. No column of `documents` holds it: it is on each line without a period of its own, and here. */
+    invoicing_period: Period | null;
+    /** The supplier as the invoice names it, for the caller to find among its contacts or to add. */
+    supplier: {
+        name: string | null;
+        trade_name: string | null;
+        vat_id: string | null;
+        legal_id: string | null;
+        country: string | null;
+    };
+    /** BT-112 and BT-115, as the invoice says them. */
+    total: DecimalText | null;
+    payable: DecimalText | null;
+    /** One per line of the invoice, then one per allowance or charge of the whole document. */
+    lines: PurchaseDraftLine[];
+}
+/** The decimals a currency is written with, as the platform's `Intl` knows it; null for a code it does not know. */
+export declare function currencyDigits(currency: string): number | null;
+/**
+ * Whether `quantity × price`, rounded half up on its absolute value at
+ * `digits` decimals — the rounding of `document_lines.amount_untaxed` — is
+ * `amount`.
+ */
+export declare function makesAmount(quantity: string, price: string, amount: string, digits: number): boolean;
+/**
+ * The draft of the purchase a received invoice becomes.
+ *
+ * One line per line of the invoice, its amount net of the line's own
+ * allowances; then one line per allowance (negative) or charge of the whole
+ * document. A credit note is a purchase credit note, its figures positive as
+ * the invoice writes them. Where the currency was not read, amounts are
+ * compared at the decimals the invoice wrote them with.
+ */
+export declare function purchaseDraftOf(invoice: ReceivedInvoice): PurchaseDraft;
+//# sourceMappingURL=purchase.d.ts.map

package/dist/purchase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchase.d.ts","sourceRoot":"","sources":["../src/purchase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA2B,eAAe,EAAgB,MAAM,mBAAmB,CAAC;AAE7G,kEAAkE;AAClE,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,sGAAsG;IACtG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,yCAAyC;IACzC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,WAAW,CAAC;IACxB,gFAAgF;IAChF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,kBAAkB,GAAG,sBAAsB,CAAC;IACtD,wCAAwC;IACxC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY;IACZ,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uCAAuC;IACvC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,qFAAqF;IACrF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iCAAiC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0GAA0G;IAC1G,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iGAAiG;IACjG,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IACF,mDAAmD;IACnD,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,2FAA2F;IAC3F,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAKD,oHAAoH;AACpH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D;AAWD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAmBpG;AAiDD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAyCvE"}