@codemill-solutions/yuki-mcp 1.0.0 → 1.1.0

package/dist/tools/invoices.js

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { XmlValue, escapeXml } from "../yuki-client.js";
+import { z } from 'zod';
+import { XmlValue, escapeXml } from '../yuki-client.js';
 /**
  * Register tools for retrieving outstanding invoices from Yuki.
  *
@@ -28,51 +28,44 @@ export function registerInvoiceTools(server, client) {
      *
      * 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.",
+    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."),
+                .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",
-            ])
+                .enum(['ContactAsc', 'ContactDesc', 'AmountAsc', 'AmountDesc', 'DateAsc', 'DateDesc'])
                 .optional()
-                .default("DateDesc")
-                .describe("Sort order for results."),
+                .default('DateDesc')
+                .describe('Sort order for results.'),
             includeBankTransactions: z
                 .boolean()
                 .optional()
                 .default(false)
-                .describe("Include bank transaction data alongside invoice items."),
+                .describe('Include bank transaction data alongside invoice items.'),
             administrationId: z
                 .string()
                 .optional()
-                .describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+                .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)");
+                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",
+                    service: 'Accounting.asmx',
+                    method: 'OutstandingDebtorItemsByDateOutstanding',
                     params: {
                         sessionID,
                         administrationID: adminId,
@@ -82,13 +75,13 @@ export function registerInvoiceTools(server, client) {
             }
             else {
                 result = await client.callSoap({
-                    service: "Accounting.asmx",
-                    method: "OutstandingDebtorItems",
+                    service: 'Accounting.asmx',
+                    method: 'OutstandingDebtorItems',
                     params: {
                         sessionID,
                         administrationID: adminId,
                         includeBankTransactions: includeBankTransactions ?? false,
-                        sortOrder: sortOrder ?? "DateDesc",
+                        sortOrder: sortOrder ?? 'DateDesc',
                     },
                 });
             }
@@ -96,11 +89,11 @@ export function registerInvoiceTools(server, client) {
             return {
                 content: [
                     {
-                        type: "text",
+                        type: 'text',
                         text: JSON.stringify({
                             success: true,
                             count: invoices.length,
-                            note: "Only outstanding (unpaid) items are returned.",
+                            note: 'Only outstanding (unpaid) items are returned.',
                             invoices,
                         }, null, 2),
                     },
@@ -112,7 +105,7 @@ export function registerInvoiceTools(server, client) {
             return {
                 content: [
                     {
-                        type: "text",
+                        type: 'text',
                         text: JSON.stringify({ success: false, error: message }, null, 2),
                     },
                 ],
@@ -133,50 +126,43 @@ export function registerInvoiceTools(server, client) {
      *
      * 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.",
+    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."),
+                .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",
-            ])
+                .enum(['ContactAsc', 'ContactDesc', 'AmountAsc', 'AmountDesc', 'DateAsc', 'DateDesc'])
                 .optional()
-                .default("DateDesc")
-                .describe("Sort order for results."),
+                .default('DateDesc')
+                .describe('Sort order for results.'),
             includeBankTransactions: z
                 .boolean()
                 .optional()
                 .default(false)
-                .describe("Include bank transaction data alongside invoice items."),
+                .describe('Include bank transaction data alongside invoice items.'),
             administrationId: z
                 .string()
                 .optional()
-                .describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+                .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)");
+                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",
+                    service: 'Accounting.asmx',
+                    method: 'OutstandingCreditorItemsByDateOutstanding',
                     params: {
                         sessionID,
                         administrationID: adminId,
@@ -186,13 +172,13 @@ export function registerInvoiceTools(server, client) {
             }
             else {
                 result = await client.callSoap({
-                    service: "Accounting.asmx",
-                    method: "OutstandingCreditorItems",
+                    service: 'Accounting.asmx',
+                    method: 'OutstandingCreditorItems',
                     params: {
                         sessionID,
                         administrationID: adminId,
                         includeBankTransactions: includeBankTransactions ?? false,
-                        sortOrder: sortOrder ?? "DateDesc",
+                        sortOrder: sortOrder ?? 'DateDesc',
                     },
                 });
             }
@@ -200,11 +186,11 @@ export function registerInvoiceTools(server, client) {
             return {
                 content: [
                     {
-                        type: "text",
+                        type: 'text',
                         text: JSON.stringify({
                             success: true,
                             count: invoices.length,
-                            note: "Only outstanding (unpaid) items are returned.",
+                            note: 'Only outstanding (unpaid) items are returned.',
                             invoices,
                         }, null, 2),
                     },
@@ -216,7 +202,7 @@ export function registerInvoiceTools(server, client) {
             return {
                 content: [
                     {
-                        type: "text",
+                        type: 'text',
                         text: JSON.stringify({ success: false, error: message }, null, 2),
                     },
                 ],
@@ -228,22 +214,25 @@ export function registerInvoiceTools(server, client) {
 // ── 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"),
+    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'"),
+    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"),
+    bankAccount: z.string().optional().describe('IBAN bank account number'),
     bic: z.string().optional(),
-    contactType: z.enum(["Debtor", "Creditor", "Both", "Person"]).optional(),
+    contactType: z.enum(['Debtor', 'Creditor', 'Both', 'Person']).optional(),
 });
 // ── process_sales_invoice ─────────────────────────────────────────────────────
 /**
@@ -265,48 +254,74 @@ export function registerInvoiceWriteTools(server, client) {
      * 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.",
+    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."),
+            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 }) => {
+    }, 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)");
+                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 });
+            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",
+                service: 'Sales.asmx',
+                method: 'ProcessSalesInvoices',
                 params: {
                     sessionId,
                     administrationId: adminId,
@@ -314,15 +329,13 @@ export function registerInvoiceWriteTools(server, client) {
                 },
             });
             return {
-                content: [{ type: "text",
-                        text: JSON.stringify({ success: true, reference, result }, null, 2) }],
+                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) }],
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: message }, null, 2) }],
                 isError: true,
             };
         }
@@ -342,67 +355,97 @@ export function registerInvoiceWriteTools(server, client) {
      * 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.",
+    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"),
+            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"),
+            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."),
+            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 }) => {
+    }, 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)");
+                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 });
+            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",
+                service: 'Purchase.asmx',
+                method: 'ProcessPurchaseInvoices',
                 params: {
                     sessionId,
                     administrationId: adminId,
-                    disableAutoCorrect: "",
+                    disableAutoCorrect: '',
                     xmlDoc: new XmlValue(xmlDoc),
                 },
             });
             return {
-                content: [{ type: "text",
-                        text: JSON.stringify({ success: true, reference, result }, null, 2) }],
+                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) }],
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: message }, null, 2) }],
                 isError: true,
             };
         }
@@ -413,7 +456,8 @@ export function registerInvoiceWriteTools(server, client) {
 function buildSalesInvoiceXml(args) {
     const x = escapeXml;
     const { contact } = args;
-    const linesXml = args.lines.map(line => `
+    const linesXml = args.lines
+        .map((line) => `
       <InvoiceLine>
         <Description>${x(line.description)}</Description>
         <ProductQuantity>${line.quantity ?? 1}</ProductQuantity>
@@ -421,11 +465,12 @@ function buildSalesInvoiceXml(args) {
           <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>` : ""}
+          <VATType>${x(line.vatType ?? 'NL_Normal')}</VATType>
+          ${line.glAccountCode ? `<GLAccountCode>${x(line.glAccountCode)}</GLAccountCode>` : ''}
+          ${line.productReference ? `<Reference>${x(line.productReference)}</Reference>` : ''}
         </Product>
-      </InvoiceLine>`).join("");
+      </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">
@@ -434,25 +479,25 @@ function buildSalesInvoiceXml(args) {
     <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>
+    <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>` : ""}
+    ${args.remarks ? `<Remarks>${x(args.remarks)}</Remarks>` : ''}
     <Contact>
-      ${contact.contactCode ? `<ContactCode>${x(contact.contactCode)}</ContactCode>` : ""}
+      ${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.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>
@@ -463,45 +508,47 @@ function buildSalesInvoiceXml(args) {
 function buildPurchaseInvoiceXml(args) {
     const x = escapeXml;
     const { contact } = args;
-    const linesXml = args.lines.map(line => `
+    const linesXml = args.lines
+        .map((line) => `
       <InvoiceLine>
-        ${line.description ? `<Description>${x(line.description)}</Description>` : ""}
+        ${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("");
+        ${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>` : ""}
+    ${args.reference ? `<Reference>${x(args.reference)}</Reference>` : ''}
     <Date>${x(args.date)}</Date>
-    ${args.dueDate ? `<DueDate>${x(args.dueDate)}</DueDate>` : ""}
+    ${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>` : ""}
+    <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>` : ""}
+      ${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.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>
@@ -516,14 +563,8 @@ function normalizeItems(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",
-    ];
+    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)