@codemill-solutions/yuki-mcp 1.0.0

package/dist/tools/invoices.js

@@ -0,0 +1,549 @@
+import { z } from "zod";
+import { XmlValue, escapeXml } from "../yuki-client.js";
+/**
+ * Register tools for retrieving outstanding invoices from Yuki.
+ *
+ * Note: The Yuki SOAP API exposes outstanding (open) invoice items via
+ * the Accounting service. Full invoice history with date-range filtering
+ * is not available via SOAP — use the Yuki web interface or the
+ * ProcessSalesInvoices/ProcessPurchaseInvoices methods for write operations.
+ *
+ * Sales receivables:  OutstandingDebtorItems
+ * Purchase payables:  OutstandingCreditorItems
+ *
+ * Yuki service: Accounting.asmx
+ */
+export function registerInvoiceTools(server, client) {
+    // ──────────────────────────────────────────────────────────────────────────
+    // Sales invoices (debitors / receivables)
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * get_sales_invoices
+     *
+     * Retrieve outstanding (unpaid) sales invoice items for an administration.
+     * Returns debtor name, invoice reference, due date, open amount, and currency.
+     *
+     * Use this to track receivables: which customers still owe money, how much,
+     * and for how long. Optionally filter by due date.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool("get_sales_invoices", {
+        description: "Retrieve outstanding (unpaid) sales invoices from Yuki. " +
+            "Returns debtor name, reference, due date, open amount, and currency for each item. " +
+            "Optionally filter by due date cutoff using dateOutstanding.",
+        inputSchema: {
+            dateOutstanding: z
+                .string()
+                .optional()
+                .describe("ISO date string (YYYY-MM-DD). When provided, returns only items " +
+                "outstanding as of this date. Omit for all outstanding items."),
+            sortOrder: z
+                .enum([
+                "ContactAsc",
+                "ContactDesc",
+                "AmountAsc",
+                "AmountDesc",
+                "DateAsc",
+                "DateDesc",
+            ])
+                .optional()
+                .default("DateDesc")
+                .describe("Sort order for results."),
+            includeBankTransactions: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Include bank transaction data alongside invoice items."),
+            administrationId: z
+                .string()
+                .optional()
+                .describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ dateOutstanding, sortOrder, includeBankTransactions, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId) {
+                throw new Error("administrationId is required (or set YUKI_DOMAIN_ID env var)");
+            }
+            const sessionID = await client.getSessionID();
+            let result;
+            if (dateOutstanding) {
+                // Filter by specific outstanding date
+                result = await client.callSoap({
+                    service: "Accounting.asmx",
+                    method: "OutstandingDebtorItemsByDateOutstanding",
+                    params: {
+                        sessionID,
+                        administrationID: adminId,
+                        DateOutstanding: dateOutstanding,
+                    },
+                });
+            }
+            else {
+                result = await client.callSoap({
+                    service: "Accounting.asmx",
+                    method: "OutstandingDebtorItems",
+                    params: {
+                        sessionID,
+                        administrationID: adminId,
+                        includeBankTransactions: includeBankTransactions ?? false,
+                        sortOrder: sortOrder ?? "DateDesc",
+                    },
+                });
+            }
+            const invoices = normalizeItems(result);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            count: invoices.length,
+                            note: "Only outstanding (unpaid) items are returned.",
+                            invoices,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: false, error: message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ──────────────────────────────────────────────────────────────────────────
+    // Purchase invoices (creditors / payables)
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * get_purchase_invoices
+     *
+     * Retrieve outstanding (unpaid) purchase invoice items for an administration.
+     * Returns creditor name, invoice reference, due date, open amount, and currency.
+     *
+     * Use this to track payables: which suppliers are still owed money.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool("get_purchase_invoices", {
+        description: "Retrieve outstanding (unpaid) purchase invoices from Yuki. " +
+            "Returns creditor name, reference, due date, open amount, and currency for each item. " +
+            "Optionally filter by due date cutoff using dateOutstanding.",
+        inputSchema: {
+            dateOutstanding: z
+                .string()
+                .optional()
+                .describe("ISO date string (YYYY-MM-DD). When provided, returns only items " +
+                "outstanding as of this date. Omit for all outstanding items."),
+            sortOrder: z
+                .enum([
+                "ContactAsc",
+                "ContactDesc",
+                "AmountAsc",
+                "AmountDesc",
+                "DateAsc",
+                "DateDesc",
+            ])
+                .optional()
+                .default("DateDesc")
+                .describe("Sort order for results."),
+            includeBankTransactions: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Include bank transaction data alongside invoice items."),
+            administrationId: z
+                .string()
+                .optional()
+                .describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ dateOutstanding, sortOrder, includeBankTransactions, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId) {
+                throw new Error("administrationId is required (or set YUKI_DOMAIN_ID env var)");
+            }
+            const sessionID = await client.getSessionID();
+            let result;
+            if (dateOutstanding) {
+                result = await client.callSoap({
+                    service: "Accounting.asmx",
+                    method: "OutstandingCreditorItemsByDateOutstanding",
+                    params: {
+                        sessionID,
+                        administrationID: adminId,
+                        DateOutstanding: dateOutstanding,
+                    },
+                });
+            }
+            else {
+                result = await client.callSoap({
+                    service: "Accounting.asmx",
+                    method: "OutstandingCreditorItems",
+                    params: {
+                        sessionID,
+                        administrationID: adminId,
+                        includeBankTransactions: includeBankTransactions ?? false,
+                        sortOrder: sortOrder ?? "DateDesc",
+                    },
+                });
+            }
+            const invoices = normalizeItems(result);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            count: invoices.length,
+                            note: "Only outstanding (unpaid) items are returned.",
+                            invoices,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: false, error: message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// ── Zod schemas shared between write tools ────────────────────────────────────
+/** Contact block used in both sales and purchase invoice XML documents. */
+const ContactSchema = z.object({
+    contactCode: z.string().optional().describe("Existing Yuki contact code (e.g. 'CUST001'). When provided, Yuki will link to the existing contact."),
+    fullName: z.string().describe("Full company or person name"),
+    firstName: z.string().optional(),
+    lastName: z.string().optional(),
+    emailAddress: z.string().optional(),
+    phone: z.string().optional(),
+    countryCode: z.string().optional().default("NL").describe("ISO 3166-1 alpha-2 country code, e.g. 'NL'"),
+    city: z.string().optional(),
+    zipcode: z.string().optional(),
+    addressLine1: z.string().optional(),
+    addressLine2: z.string().optional(),
+    vatNumber: z.string().optional(),
+    cocNumber: z.string().optional(),
+    bankAccount: z.string().optional().describe("IBAN bank account number"),
+    bic: z.string().optional(),
+    contactType: z.enum(["Debtor", "Creditor", "Both", "Person"]).optional(),
+});
+// ── process_sales_invoice ─────────────────────────────────────────────────────
+/**
+ * Register the write tools for sales and purchase invoices.
+ * Called from registerInvoiceTools — same server/client instance.
+ */
+export function registerInvoiceWriteTools(server, client) {
+    /**
+     * process_sales_invoice
+     *
+     * Create and book a sales invoice in Yuki.
+     * Yuki will send the invoice to the customer if emailToCustomer is true.
+     *
+     * Use this when:
+     *   - A new sale needs to be invoiced
+     *   - An order has been fulfilled and must be recorded in the ledger
+     *   - An existing invoice from another system needs to be mirrored in Yuki
+     *
+     * Note: Sales.asmx uses sessionId / administrationId (lowercase d).
+     * Rate cost: 1 request.
+     */
+    server.registerTool("process_sales_invoice", {
+        description: "Create and book a new sales invoice in Yuki. " +
+            "Accepts invoice header, contact, and line items. " +
+            "Optionally sends the invoice to the customer by email. " +
+            "Returns the Yuki response including the assigned document ID.",
+        inputSchema: {
+            reference: z.string().describe("Invoice number / reference (e.g. '2024-0042')"),
+            subject: z.string().describe("Invoice title shown to the customer"),
+            date: z.string().describe("Invoice date in YYYY-MM-DD format"),
+            dueDate: z.string().describe("Payment due date in YYYY-MM-DD format"),
+            contact: ContactSchema.describe("Customer contact details"),
+            lines: z.array(z.object({
+                description: z.string().describe("Line item description"),
+                quantity: z.number().optional().default(1).describe("Quantity (default 1)"),
+                salesPrice: z.number().describe("Unit price excluding VAT"),
+                vatPercentage: z.number().optional().default(21).describe("VAT percentage (default 21)"),
+                vatIncluded: z.boolean().optional().default(false).describe("Whether salesPrice already includes VAT"),
+                vatType: z.string().optional().default("NL_Normal").describe("VAT type code: NL_Normal (21%), NL_Reduced (9%), NL_Zero (0%), NL_None (exempt)"),
+                glAccountCode: z.string().optional().describe("GL account code to post this line to"),
+                productReference: z.string().optional().describe("Product/SKU reference code"),
+            })).min(1).describe("Invoice line items"),
+            paymentMethod: z.enum(["ElectronicTransfer", "DirectCollection", "Cash", "DebitCard", "CreditCard"])
+                .optional().default("ElectronicTransfer"),
+            currency: z.string().optional().default("EUR").describe("ISO 4217 currency code"),
+            process: z.boolean().optional().default(true).describe("Immediately process/finalise the invoice in Yuki"),
+            emailToCustomer: z.boolean().optional().default(false).describe("Send the invoice to the customer's email address"),
+            remarks: z.string().optional().describe("Internal remarks (not visible on invoice)"),
+            administrationId: z.string().optional().describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ reference, subject, date, dueDate, contact, lines, paymentMethod, currency, process: doProcess, emailToCustomer, remarks, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId)
+                throw new Error("administrationId is required (or set YUKI_DOMAIN_ID env var)");
+            const sessionId = await client.getSessionID();
+            const xmlDoc = buildSalesInvoiceXml({ reference, subject, date, dueDate,
+                contact, lines, paymentMethod, currency, process: doProcess,
+                emailToCustomer, remarks });
+            // Sales.asmx uses sessionId / administrationId (lowercase d)
+            const result = await client.callSoap({
+                service: "Sales.asmx",
+                method: "ProcessSalesInvoices",
+                params: {
+                    sessionId,
+                    administrationId: adminId,
+                    xmlDoc: new XmlValue(xmlDoc),
+                },
+            });
+            return {
+                content: [{ type: "text",
+                        text: JSON.stringify({ success: true, reference, result }, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text",
+                        text: JSON.stringify({ success: false, error: message }, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+    // ── process_purchase_invoice ───────────────────────────────────────────────
+    /**
+     * process_purchase_invoice
+     *
+     * Book an incoming purchase invoice in Yuki.
+     * Optionally attach the original PDF as a base64 string.
+     *
+     * Use this when:
+     *   - An incoming invoice from a supplier needs to be booked
+     *   - OCR has extracted invoice data from a PDF and it must be recorded
+     *   - Automating the AP (accounts payable) workflow
+     *
+     * Note: Purchase.asmx uses sessionId / administrationId (lowercase d).
+     * Rate cost: 1 request.
+     */
+    server.registerTool("process_purchase_invoice", {
+        description: "Book an incoming purchase invoice in Yuki. " +
+            "Accepts invoice totals, supplier contact, and line items. " +
+            "Optionally attach the original PDF as a base64 string. " +
+            "Returns the Yuki response including the assigned document ID.",
+        inputSchema: {
+            reference: z.string().optional().describe("Supplier's invoice number"),
+            date: z.string().describe("Invoice date in YYYY-MM-DD format"),
+            dueDate: z.string().optional().describe("Payment due date in YYYY-MM-DD format"),
+            invoiceAmount: z.number().describe("Total invoice amount including VAT"),
+            invoiceVatAmount: z.number().describe("Total VAT amount on the invoice"),
+            contact: ContactSchema.describe("Supplier contact details"),
+            lines: z.array(z.object({
+                description: z.string().optional().describe("Line item description"),
+                lineAmount: z.number().describe("Line amount excluding VAT"),
+                lineVatType: z.number().optional().default(2)
+                    .describe("VAT type code: 1=None, 2=21% NL, 3=9% NL, 4=0% NL, 5=EU (see Yuki docs)"),
+                lineVatPercentage: z.number().optional().describe("VAT percentage (e.g. 21). Derived from lineVatType if omitted."),
+                glAccountCode: z.string().optional().describe("GL account code to post this line to (e.g. '4000' for cost of goods)"),
+                vatDeductibilityPercentage: z.number().optional().default(100)
+                    .describe("Deductible VAT percentage (0-100). Use <100 for partially deductible costs."),
+            })).min(1).describe("Invoice line items"),
+            paymentMethod: z.enum(["Transfer", "DirectCollection", "Cash", "DebitCard", "CreditCard"])
+                .optional().default("Transfer"),
+            currency: z.string().optional().default("EUR"),
+            process: z.boolean().optional().default(true).describe("Immediately process/finalise in Yuki"),
+            documentFileName: z.string().optional().describe("PDF filename (e.g. 'invoice-2024-0042.pdf')"),
+            documentBase64: z.string().optional().describe("PDF content encoded as base64 string"),
+            remarks: z.string().optional(),
+            administrationId: z.string().optional().describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ reference, date, dueDate, invoiceAmount, invoiceVatAmount, contact, lines, paymentMethod, currency, process: doProcess, documentFileName, documentBase64, remarks, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId)
+                throw new Error("administrationId is required (or set YUKI_DOMAIN_ID env var)");
+            const sessionId = await client.getSessionID();
+            const xmlDoc = buildPurchaseInvoiceXml({ reference, date, dueDate,
+                invoiceAmount, invoiceVatAmount, contact, lines, paymentMethod,
+                currency, process: doProcess, documentFileName, documentBase64, remarks });
+            // Purchase.asmx uses sessionId / administrationId (lowercase d)
+            const result = await client.callSoap({
+                service: "Purchase.asmx",
+                method: "ProcessPurchaseInvoices",
+                params: {
+                    sessionId,
+                    administrationId: adminId,
+                    disableAutoCorrect: "",
+                    xmlDoc: new XmlValue(xmlDoc),
+                },
+            });
+            return {
+                content: [{ type: "text",
+                        text: JSON.stringify({ success: true, reference, result }, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text",
+                        text: JSON.stringify({ success: false, error: message }, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+}
+// ── XML document builders ─────────────────────────────────────────────────────
+/** Build the xmlDoc string for ProcessSalesInvoices. */
+function buildSalesInvoiceXml(args) {
+    const x = escapeXml;
+    const { contact } = args;
+    const linesXml = args.lines.map(line => `
+      <InvoiceLine>
+        <Description>${x(line.description)}</Description>
+        <ProductQuantity>${line.quantity ?? 1}</ProductQuantity>
+        <Product>
+          <SalesPrice>${line.salesPrice}</SalesPrice>
+          <VATPercentage>${line.vatPercentage ?? 21}</VATPercentage>
+          <VATIncluded>${line.vatIncluded ?? false}</VATIncluded>
+          <VATType>${x(line.vatType ?? "NL_Normal")}</VATType>
+          ${line.glAccountCode ? `<GLAccountCode>${x(line.glAccountCode)}</GLAccountCode>` : ""}
+          ${line.productReference ? `<Reference>${x(line.productReference)}</Reference>` : ""}
+        </Product>
+      </InvoiceLine>`).join("");
+    return `<?xml version="1.0" encoding="utf-8"?>
+<SalesInvoices xmlns="urn:xmlns:http://www.theyukicompany.com:salesinvoices"
+               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <SalesInvoice>
+    <Reference>${x(args.reference)}</Reference>
+    <Subject>${x(args.subject)}</Subject>
+    <Date>${x(args.date)}</Date>
+    <DueDate>${x(args.dueDate)}</DueDate>
+    <PaymentMethod>${x(args.paymentMethod ?? "ElectronicTransfer")}</PaymentMethod>
+    <Currency>${x(args.currency ?? "EUR")}</Currency>
+    <Process>${args.process ?? true}</Process>
+    <EmailToCustomer>${args.emailToCustomer ?? false}</EmailToCustomer>
+    ${args.remarks ? `<Remarks>${x(args.remarks)}</Remarks>` : ""}
+    <Contact>
+      ${contact.contactCode ? `<ContactCode>${x(contact.contactCode)}</ContactCode>` : ""}
+      <FullName>${x(contact.fullName)}</FullName>
+      ${contact.firstName ? `<FirstName>${x(contact.firstName)}</FirstName>` : ""}
+      ${contact.lastName ? `<LastName>${x(contact.lastName)}</LastName>` : ""}
+      ${contact.emailAddress ? `<EmailAddress>${x(contact.emailAddress)}</EmailAddress>` : ""}
+      ${contact.countryCode ? `<CountryCode>${x(contact.countryCode)}</CountryCode>` : ""}
+      ${contact.city ? `<City>${x(contact.city)}</City>` : ""}
+      ${contact.zipcode ? `<Zipcode>${x(contact.zipcode)}</Zipcode>` : ""}
+      ${contact.addressLine1 ? `<AddressLine_1>${x(contact.addressLine1)}</AddressLine_1>` : ""}
+      ${contact.addressLine2 ? `<AddressLine_2>${x(contact.addressLine2)}</AddressLine_2>` : ""}
+      ${contact.vatNumber ? `<VATNumber>${x(contact.vatNumber)}</VATNumber>` : ""}
+      ${contact.cocNumber ? `<CoCNumber>${x(contact.cocNumber)}</CoCNumber>` : ""}
+      ${contact.contactType ? `<ContactType>${x(contact.contactType)}</ContactType>` : ""}
+    </Contact>
+    <InvoiceLines>${linesXml}
+    </InvoiceLines>
+  </SalesInvoice>
+</SalesInvoices>`;
+}
+/** Build the xmlDoc string for ProcessPurchaseInvoices. */
+function buildPurchaseInvoiceXml(args) {
+    const x = escapeXml;
+    const { contact } = args;
+    const linesXml = args.lines.map(line => `
+      <InvoiceLine>
+        ${line.description ? `<Description>${x(line.description)}</Description>` : ""}
+        <LineAmount>${line.lineAmount}</LineAmount>
+        <LineVATType>${line.lineVatType ?? 2}</LineVATType>
+        ${line.lineVatPercentage !== undefined ? `<LineVATPercentage>${line.lineVatPercentage}</LineVATPercentage>` : ""}
+        ${line.glAccountCode ? `<GLAccountCode>${x(line.glAccountCode)}</GLAccountCode>` : ""}
+        ${line.vatDeductibilityPercentage !== undefined ? `<VATDeductibilityPercentage>${line.vatDeductibilityPercentage}</VATDeductibilityPercentage>` : ""}
+      </InvoiceLine>`).join("");
+    return `<?xml version="1.0" encoding="utf-8"?>
+<PurchaseInvoices xmlns="urn:xmlns:http://www.theyukicompany.com:purchaseinvoices"
+                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <PurchaseInvoice>
+    <Process>${args.process ?? true}</Process>
+    ${args.reference ? `<Reference>${x(args.reference)}</Reference>` : ""}
+    <Date>${x(args.date)}</Date>
+    ${args.dueDate ? `<DueDate>${x(args.dueDate)}</DueDate>` : ""}
+    <InvoiceAmount>${args.invoiceAmount}</InvoiceAmount>
+    <InvoiceVATAmount>${args.invoiceVatAmount}</InvoiceVATAmount>
+    <Currency>${x(args.currency ?? "EUR")}</Currency>
+    <PaymentMethod>${x(args.paymentMethod ?? "Transfer")}</PaymentMethod>
+    ${args.remarks ? `<Remarks>${x(args.remarks)}</Remarks>` : ""}
+    ${args.documentFileName ? `<DocumentFileName>${x(args.documentFileName)}</DocumentFileName>` : ""}
+    ${args.documentBase64 ? `<DocumentBase64>${args.documentBase64}</DocumentBase64>` : ""}
+    <Contact>
+      ${contact.contactCode ? `<ContactCode>${x(contact.contactCode)}</ContactCode>` : ""}
+      <FullName>${x(contact.fullName)}</FullName>
+      ${contact.firstName ? `<FirstName>${x(contact.firstName)}</FirstName>` : ""}
+      ${contact.lastName ? `<LastName>${x(contact.lastName)}</LastName>` : ""}
+      ${contact.emailAddress ? `<EmailAddress>${x(contact.emailAddress)}</EmailAddress>` : ""}
+      ${contact.countryCode ? `<CountryCode>${x(contact.countryCode)}</CountryCode>` : ""}
+      ${contact.city ? `<City>${x(contact.city)}</City>` : ""}
+      ${contact.zipcode ? `<Zipcode>${x(contact.zipcode)}</Zipcode>` : ""}
+      ${contact.addressLine1 ? `<AddressLine_1>${x(contact.addressLine1)}</AddressLine_1>` : ""}
+      ${contact.vatNumber ? `<VATNumber>${x(contact.vatNumber)}</VATNumber>` : ""}
+      ${contact.cocNumber ? `<CoCNumber>${x(contact.cocNumber)}</CoCNumber>` : ""}
+      ${contact.bankAccount ? `<BankAccount>${x(contact.bankAccount)}</BankAccount>` : ""}
+      ${contact.bic ? `<BIC>${x(contact.bic)}</BIC>` : ""}
+      ${contact.contactType ? `<ContactType>${x(contact.contactType)}</ContactType>` : ""}
+    </Contact>
+    <InvoiceLines>${linesXml}
+    </InvoiceLines>
+  </PurchaseInvoice>
+</PurchaseInvoices>`;
+}
+/** Unwrap the parsed SOAP outstanding-items result into a flat array. */
+function normalizeItems(result) {
+    if (!result)
+        return [];
+    if (Array.isArray(result))
+        return result;
+    const rec = result;
+    // Common Yuki wrappers for outstanding items
+    const wrappers = [
+        "DebtorItems", "CreditorItems",
+        "OutstandingItems", "Items", "Rows",
+    ];
+    const itemTags = [
+        "DebtorItem", "CreditorItem",
+        "OutstandingItem", "Item", "Row",
+    ];
+    for (const wrapper of wrappers) {
+        const c = rec[wrapper];
+        if (!c)
+            continue;
+        if (Array.isArray(c))
+            return c;
+        const inner = c;
+        for (const tag of itemTags) {
+            if (Array.isArray(inner[tag]))
+                return inner[tag];
+            if (inner[tag])
+                return [inner[tag]];
+        }
+    }
+    for (const tag of itemTags) {
+        if (Array.isArray(rec[tag]))
+            return rec[tag];
+        if (rec[tag])
+            return [rec[tag]];
+    }
+    return [result];
+}
+//# sourceMappingURL=invoices.js.map

package/dist/tools/invoices.js.map

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

package/dist/tools/relations.d.ts

@@ -0,0 +1,20 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { YukiClient } from "../yuki-client.js";
+/**
+ * Register tools for working with Yuki relations (contacts).
+ *
+ * Relations are debitors (customers) and creditors (suppliers) in Yuki.
+ * The Contact service uses domainID (the same GUID as your administrationID).
+ *
+ * Yuki service: Contact.asmx
+ * Method:       SearchContacts(sessionID, domainID, searchOption, searchValue,
+ *                              sortOrder, modifiedAfter, active, pageNumber)
+ * Max results:  100 per page — use pageNumber for pagination.
+ */
+export declare function registerRelationTools(server: McpServer, client: YukiClient): void;
+/**
+ * Register the upsert_contact write tool.
+ * Call this from registerRelationTools — same server/client instance.
+ */
+export declare function registerContactWriteTools(server: McpServer, client: YukiClient): void;
+//# sourceMappingURL=relations.d.ts.map

package/dist/tools/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../src/tools/relations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAuB,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,GACjB,IAAI,CA+HN;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,GACjB,IAAI,CAwFN"}