@promptpartner/bexio-mcp-server 2.0.0

package/dist/types/schemas/banking.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Banking-related Zod schemas and types.
+ * Domain: Banking (Bank Accounts, Currencies, IBAN Payments, QR Payments)
+ *
+ * Swiss Standards:
+ * - IBAN payments: Swiss ISO 20022 payment standards
+ * - QR payments: SIX Group QR-bill specification v2.3
+ * - Addresses: Structured format only (type S) - required from Nov 2025
+ */
+import { z } from "zod";
+export declare const ListBankAccountsParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListBankAccountsParams = z.infer<typeof ListBankAccountsParamsSchema>;
+export declare const GetBankAccountParamsSchema: z.ZodObject<{
+    account_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    account_id: number;
+}, {
+    account_id: number;
+}>;
+export type GetBankAccountParams = z.infer<typeof GetBankAccountParamsSchema>;
+export declare const ListCurrenciesParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListCurrenciesParams = z.infer<typeof ListCurrenciesParamsSchema>;
+export declare const GetCurrencyParamsSchema: z.ZodObject<{
+    currency_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    currency_id: number;
+}, {
+    currency_id: number;
+}>;
+export type GetCurrencyParams = z.infer<typeof GetCurrencyParamsSchema>;
+export declare const CreateCurrencyParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    round_factor: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    round_factor: number;
+}, {
+    name: string;
+    round_factor?: number | undefined;
+}>;
+export type CreateCurrencyParams = z.infer<typeof CreateCurrencyParamsSchema>;
+export declare const UpdateCurrencyParamsSchema: z.ZodObject<{
+    currency_id: z.ZodNumber;
+    currency_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    currency_id: number;
+    currency_data: Record<string, unknown>;
+}, {
+    currency_id: number;
+    currency_data: Record<string, unknown>;
+}>;
+export type UpdateCurrencyParams = z.infer<typeof UpdateCurrencyParamsSchema>;
+export declare const DeleteCurrencyParamsSchema: z.ZodObject<{
+    currency_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    currency_id: number;
+}, {
+    currency_id: number;
+}>;
+export type DeleteCurrencyParams = z.infer<typeof DeleteCurrencyParamsSchema>;
+export declare const CreateIbanPaymentParamsSchema: z.ZodObject<{
+    bank_account_id: z.ZodNumber;
+    iban: z.ZodString;
+    currency: z.ZodEnum<["CHF", "EUR"]>;
+    amount: z.ZodNumber;
+    recipient_name: z.ZodString;
+    recipient_street: z.ZodOptional<z.ZodString>;
+    recipient_house_number: z.ZodOptional<z.ZodString>;
+    recipient_zip: z.ZodString;
+    recipient_city: z.ZodString;
+    recipient_country_code: z.ZodDefault<z.ZodString>;
+    execution_date: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+    is_salary_payment: z.ZodDefault<z.ZodBoolean>;
+    allowance_type: z.ZodDefault<z.ZodEnum<["no_fee", "our", "ben", "sha"]>>;
+}, "strip", z.ZodTypeAny, {
+    amount: number;
+    bank_account_id: number;
+    iban: string;
+    currency: "CHF" | "EUR";
+    recipient_name: string;
+    recipient_zip: string;
+    recipient_city: string;
+    recipient_country_code: string;
+    execution_date: string;
+    is_salary_payment: boolean;
+    allowance_type: "no_fee" | "our" | "ben" | "sha";
+    message?: string | undefined;
+    recipient_street?: string | undefined;
+    recipient_house_number?: string | undefined;
+}, {
+    amount: number;
+    bank_account_id: number;
+    iban: string;
+    currency: "CHF" | "EUR";
+    recipient_name: string;
+    recipient_zip: string;
+    recipient_city: string;
+    execution_date: string;
+    message?: string | undefined;
+    recipient_street?: string | undefined;
+    recipient_house_number?: string | undefined;
+    recipient_country_code?: string | undefined;
+    is_salary_payment?: boolean | undefined;
+    allowance_type?: "no_fee" | "our" | "ben" | "sha" | undefined;
+}>;
+export type CreateIbanPaymentParams = z.infer<typeof CreateIbanPaymentParamsSchema>;
+export declare const GetIbanPaymentParamsSchema: z.ZodObject<{
+    payment_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    payment_id: number;
+}, {
+    payment_id: number;
+}>;
+export type GetIbanPaymentParams = z.infer<typeof GetIbanPaymentParamsSchema>;
+export declare const UpdateIbanPaymentParamsSchema: z.ZodObject<{
+    payment_id: z.ZodNumber;
+    payment_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    payment_id: number;
+    payment_data: Record<string, unknown>;
+}, {
+    payment_id: number;
+    payment_data: Record<string, unknown>;
+}>;
+export type UpdateIbanPaymentParams = z.infer<typeof UpdateIbanPaymentParamsSchema>;
+export declare const CreateQrPaymentParamsSchema: z.ZodObject<{
+    bank_account_id: z.ZodNumber;
+    iban: z.ZodString;
+    currency: z.ZodEnum<["CHF", "EUR"]>;
+    amount: z.ZodNumber;
+    recipient_name: z.ZodString;
+    recipient_street: z.ZodOptional<z.ZodString>;
+    recipient_house_number: z.ZodOptional<z.ZodString>;
+    recipient_zip: z.ZodString;
+    recipient_city: z.ZodString;
+    recipient_country_code: z.ZodDefault<z.ZodString>;
+    execution_date: z.ZodString;
+    qr_reference_nr: z.ZodOptional<z.ZodString>;
+    additional_information: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: number;
+    bank_account_id: number;
+    iban: string;
+    currency: "CHF" | "EUR";
+    recipient_name: string;
+    recipient_zip: string;
+    recipient_city: string;
+    recipient_country_code: string;
+    execution_date: string;
+    recipient_street?: string | undefined;
+    recipient_house_number?: string | undefined;
+    qr_reference_nr?: string | undefined;
+    additional_information?: string | undefined;
+}, {
+    amount: number;
+    bank_account_id: number;
+    iban: string;
+    currency: "CHF" | "EUR";
+    recipient_name: string;
+    recipient_zip: string;
+    recipient_city: string;
+    execution_date: string;
+    recipient_street?: string | undefined;
+    recipient_house_number?: string | undefined;
+    recipient_country_code?: string | undefined;
+    qr_reference_nr?: string | undefined;
+    additional_information?: string | undefined;
+}>;
+export type CreateQrPaymentParams = z.infer<typeof CreateQrPaymentParamsSchema>;
+export declare const GetQrPaymentParamsSchema: z.ZodObject<{
+    payment_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    payment_id: number;
+}, {
+    payment_id: number;
+}>;
+export type GetQrPaymentParams = z.infer<typeof GetQrPaymentParamsSchema>;
+export declare const UpdateQrPaymentParamsSchema: z.ZodObject<{
+    payment_id: z.ZodNumber;
+    payment_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    payment_id: number;
+    payment_data: Record<string, unknown>;
+}, {
+    payment_id: number;
+    payment_data: Record<string, unknown>;
+}>;
+export type UpdateQrPaymentParams = z.infer<typeof UpdateQrPaymentParamsSchema>;

package/dist/types/schemas/banking.js

@@ -0,0 +1,86 @@
+/**
+ * Banking-related Zod schemas and types.
+ * Domain: Banking (Bank Accounts, Currencies, IBAN Payments, QR Payments)
+ *
+ * Swiss Standards:
+ * - IBAN payments: Swiss ISO 20022 payment standards
+ * - QR payments: SIX Group QR-bill specification v2.3
+ * - Addresses: Structured format only (type S) - required from Nov 2025
+ */
+import { z } from "zod";
+// ===== BANK ACCOUNTS (BANK-01) - Read Only =====
+export const ListBankAccountsParamsSchema = z.object({
+    limit: z.number().int().positive().default(100),
+    offset: z.number().int().min(0).default(0),
+});
+export const GetBankAccountParamsSchema = z.object({
+    account_id: z.number().int().positive(),
+});
+// ===== CURRENCIES (BANK-02) - Full CRUD =====
+export const ListCurrenciesParamsSchema = z.object({
+    limit: z.number().int().positive().default(100),
+    offset: z.number().int().min(0).default(0),
+});
+export const GetCurrencyParamsSchema = z.object({
+    currency_id: z.number().int().positive(),
+});
+export const CreateCurrencyParamsSchema = z.object({
+    name: z.string().min(1).max(10),
+    round_factor: z.number().positive().default(0.05), // Swiss 5 rappen default
+});
+export const UpdateCurrencyParamsSchema = z.object({
+    currency_id: z.number().int().positive(),
+    currency_data: z.record(z.unknown()),
+});
+export const DeleteCurrencyParamsSchema = z.object({
+    currency_id: z.number().int().positive(),
+});
+// ===== IBAN PAYMENTS (BANK-03) - Swiss ISO 20022 =====
+// Flat params schema for MCP tool interface
+// Structured recipient address (required from Nov 2025)
+export const CreateIbanPaymentParamsSchema = z.object({
+    bank_account_id: z.number().int().positive(),
+    iban: z.string().min(15).max(34),
+    currency: z.enum(["CHF", "EUR"]),
+    amount: z.number().positive(),
+    recipient_name: z.string().max(70),
+    recipient_street: z.string().max(70).optional(),
+    recipient_house_number: z.string().max(16).optional(),
+    recipient_zip: z.string().max(10),
+    recipient_city: z.string().max(35),
+    recipient_country_code: z.string().length(2).default("CH"),
+    execution_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD format"),
+    message: z.string().max(140).optional(),
+    is_salary_payment: z.boolean().default(false),
+    allowance_type: z.enum(["no_fee", "our", "ben", "sha"]).default("no_fee"),
+});
+export const GetIbanPaymentParamsSchema = z.object({
+    payment_id: z.number().int().positive(),
+});
+export const UpdateIbanPaymentParamsSchema = z.object({
+    payment_id: z.number().int().positive(),
+    payment_data: z.record(z.unknown()),
+});
+// ===== QR PAYMENTS (BANK-04) - Swiss QR-invoice standard =====
+export const CreateQrPaymentParamsSchema = z.object({
+    bank_account_id: z.number().int().positive(),
+    iban: z.string().min(15).max(34),
+    currency: z.enum(["CHF", "EUR"]),
+    amount: z.number().positive().max(999999999.99),
+    recipient_name: z.string().max(70),
+    recipient_street: z.string().max(70).optional(),
+    recipient_house_number: z.string().max(16).optional(),
+    recipient_zip: z.string().max(10),
+    recipient_city: z.string().max(35),
+    recipient_country_code: z.string().length(2).default("CH"),
+    execution_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be YYYY-MM-DD format"),
+    qr_reference_nr: z.string().length(27).regex(/^\d+$/, "QR reference must be 27 digits").optional(),
+    additional_information: z.string().max(140).optional(),
+});
+export const GetQrPaymentParamsSchema = z.object({
+    payment_id: z.number().int().positive(),
+});
+export const UpdateQrPaymentParamsSchema = z.object({
+    payment_id: z.number().int().positive(),
+    payment_data: z.record(z.unknown()),
+});

package/dist/types/schemas/company.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Company and payments config Zod schemas and types.
+ * Domain: Company Profile, Permissions, Payment Types
+ */
+import { z } from "zod";
+export declare const GetCompanyProfileParamsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetCompanyProfileParams = z.infer<typeof GetCompanyProfileParamsSchema>;
+export declare const UpdateCompanyProfileParamsSchema: z.ZodObject<{
+    profile_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    profile_data: Record<string, unknown>;
+}, {
+    profile_data: Record<string, unknown>;
+}>;
+export type UpdateCompanyProfileParams = z.infer<typeof UpdateCompanyProfileParamsSchema>;
+export declare const ListPermissionsParamsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type ListPermissionsParams = z.infer<typeof ListPermissionsParamsSchema>;
+export declare const ListPaymentTypesParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListPaymentTypesParams = z.infer<typeof ListPaymentTypesParamsSchema>;
+export declare const GetPaymentTypeParamsSchema: z.ZodObject<{
+    payment_type_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    payment_type_id: number;
+}, {
+    payment_type_id: number;
+}>;
+export type GetPaymentTypeParams = z.infer<typeof GetPaymentTypeParamsSchema>;
+export declare const CreatePaymentTypeParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export type CreatePaymentTypeParams = z.infer<typeof CreatePaymentTypeParamsSchema>;

package/dist/types/schemas/company.js

@@ -0,0 +1,23 @@
+/**
+ * Company and payments config Zod schemas and types.
+ * Domain: Company Profile, Permissions, Payment Types
+ */
+import { z } from "zod";
+// ===== COMPANY PROFILE (REFDATA-09) =====
+export const GetCompanyProfileParamsSchema = z.object({});
+export const UpdateCompanyProfileParamsSchema = z.object({
+    profile_data: z.record(z.unknown()),
+});
+// ===== PERMISSIONS (REFDATA-10) =====
+export const ListPermissionsParamsSchema = z.object({});
+// ===== PAYMENT TYPES (REFDATA-08) =====
+export const ListPaymentTypesParamsSchema = z.object({
+    limit: z.number().int().positive().default(100),
+    offset: z.number().int().min(0).default(0),
+});
+export const GetPaymentTypeParamsSchema = z.object({
+    payment_type_id: z.number().int().positive(),
+});
+export const CreatePaymentTypeParamsSchema = z.object({
+    name: z.string().min(1, "Name is required"),
+});

package/dist/types/schemas/contacts.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Contact-related Zod schemas and types.
+ * Domain: Contacts (CRM)
+ */
+import { z } from "zod";
+import { PaginationParams } from "../common.js";
+export declare const ListContactsParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    search_term: z.ZodOptional<z.ZodString>;
+    contact_type_id: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    search_term?: string | undefined;
+    contact_type_id?: number | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+    search_term?: string | undefined;
+    contact_type_id?: number | undefined;
+}>;
+export type ListContactsParams = z.infer<typeof ListContactsParamsSchema>;
+export declare const GetContactParamsSchema: z.ZodObject<{
+    contact_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    contact_id: number;
+}, {
+    contact_id: number;
+}>;
+export type GetContactParams = z.infer<typeof GetContactParamsSchema>;
+export declare const SearchContactsParamsSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    query: string;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>;
+export type SearchContactsParams = z.infer<typeof SearchContactsParamsSchema>;
+export declare const AdvancedSearchContactsParamsSchema: z.ZodObject<{
+    search_criteria: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        value: z.ZodString;
+        criteria: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        field: string;
+        value: string;
+        criteria: string;
+    }, {
+        field: string;
+        value: string;
+        criteria?: string | undefined;
+    }>, "many">;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    search_criteria: {
+        field: string;
+        value: string;
+        criteria: string;
+    }[];
+}, {
+    search_criteria: {
+        field: string;
+        value: string;
+        criteria?: string | undefined;
+    }[];
+    limit?: number | undefined;
+}>;
+export type AdvancedSearchContactsParams = z.infer<typeof AdvancedSearchContactsParamsSchema>;
+export declare const FindContactByNumberParamsSchema: z.ZodObject<{
+    contact_number: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    contact_number: string;
+}, {
+    contact_number: string;
+}>;
+export type FindContactByNumberParams = z.infer<typeof FindContactByNumberParamsSchema>;
+export declare const FindContactByNameParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export type FindContactByNameParams = z.infer<typeof FindContactByNameParamsSchema>;
+export declare const UpdateContactParamsSchema: z.ZodObject<{
+    contact_id: z.ZodNumber;
+    contact_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    contact_id: number;
+    contact_data: Record<string, unknown>;
+}, {
+    contact_id: number;
+    contact_data: Record<string, unknown>;
+}>;
+export type UpdateContactParams = z.infer<typeof UpdateContactParamsSchema>;
+export interface ContactSearchParams extends PaginationParams {
+    search_term?: string;
+    contact_type_id?: number;
+}

package/dist/types/schemas/contacts.js

@@ -0,0 +1,42 @@
+/**
+ * Contact-related Zod schemas and types.
+ * Domain: Contacts (CRM)
+ */
+import { z } from "zod";
+import { SearchCriteriaSchema } from "../common.js";
+// List contacts with optional filtering
+export const ListContactsParamsSchema = z.object({
+    limit: z.number().int().positive().default(50),
+    offset: z.number().int().min(0).default(0),
+    search_term: z.string().optional(),
+    contact_type_id: z.number().int().positive().optional(),
+});
+// Get single contact
+export const GetContactParamsSchema = z.object({
+    contact_id: z.number().int().positive(),
+});
+// Simple search
+export const SearchContactsParamsSchema = z.object({
+    query: z.string().min(1, "Query is required"),
+    limit: z.number().int().positive().default(50),
+});
+// Advanced search with multiple criteria
+export const AdvancedSearchContactsParamsSchema = z.object({
+    search_criteria: z
+        .array(SearchCriteriaSchema)
+        .min(1, "At least one search criterion is required"),
+    limit: z.number().int().positive().default(50),
+});
+// Find by contact number (e.g., '001008')
+export const FindContactByNumberParamsSchema = z.object({
+    contact_number: z.string().min(1, "Contact number is required"),
+});
+// Find by name
+export const FindContactByNameParamsSchema = z.object({
+    name: z.string().min(1, "Name is required"),
+});
+// Update contact
+export const UpdateContactParamsSchema = z.object({
+    contact_id: z.number().int().positive(),
+    contact_data: z.record(z.unknown()),
+});

package/dist/types/schemas/deliveries.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Delivery-related Zod schemas and types.
+ * Domain: Deliveries (kb_delivery)
+ */
+import { z } from "zod";
+export declare const ListDeliveriesParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListDeliveriesParams = z.infer<typeof ListDeliveriesParamsSchema>;
+export declare const GetDeliveryParamsSchema: z.ZodObject<{
+    delivery_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    delivery_id: number;
+}, {
+    delivery_id: number;
+}>;
+export type GetDeliveryParams = z.infer<typeof GetDeliveryParamsSchema>;
+export declare const IssueDeliveryParamsSchema: z.ZodObject<{
+    delivery_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    delivery_id: number;
+}, {
+    delivery_id: number;
+}>;
+export type IssueDeliveryParams = z.infer<typeof IssueDeliveryParamsSchema>;
+export declare const SearchDeliveriesParamsSchema: z.ZodObject<{
+    search_params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    search_params: Record<string, unknown>;
+}, {
+    search_params: Record<string, unknown>;
+}>;
+export type SearchDeliveriesParams = z.infer<typeof SearchDeliveriesParamsSchema>;

package/dist/types/schemas/deliveries.js

@@ -0,0 +1,22 @@
+/**
+ * Delivery-related Zod schemas and types.
+ * Domain: Deliveries (kb_delivery)
+ */
+import { z } from "zod";
+// List deliveries
+export const ListDeliveriesParamsSchema = z.object({
+    limit: z.number().int().positive().default(50),
+    offset: z.number().int().min(0).default(0),
+});
+// Get single delivery
+export const GetDeliveryParamsSchema = z.object({
+    delivery_id: z.number().int().positive(),
+});
+// Issue delivery
+export const IssueDeliveryParamsSchema = z.object({
+    delivery_id: z.number().int().positive(),
+});
+// Search deliveries
+export const SearchDeliveriesParamsSchema = z.object({
+    search_params: z.record(z.unknown()),
+});