@promptpartner/bexio-mcp-server 2.0.0

package/dist/types/schemas/invoices.js

@@ -0,0 +1,109 @@
+/**
+ * Invoice-related Zod schemas and types.
+ * Domain: Invoices (kb_invoice)
+ */
+import { z } from "zod";
+// Invoice position (line item)
+export const InvoicePositionSchema = z
+    .object({
+    type: z.string().min(1, "Position type is required"),
+    text: z.string().min(1, "Description is required"),
+    amount: z.number().positive("Amount must be positive"),
+    unit_price: z.number().positive("Unit price must be positive"),
+    discount_in_percent: z.number().min(0).max(100).optional(),
+    position_total: z.number().optional(),
+    unit_id: z.number().int().positive().optional(),
+    account_id: z.number().int().positive().optional(),
+    tax_id: z.number().int().positive().optional(),
+    tax_value: z.number().optional(),
+    mwst_type: z.number().int().optional(),
+    mwst_is_net: z.boolean().optional(),
+    map_all: z.boolean().optional(),
+})
+    .passthrough();
+// Invoice creation payload
+export const InvoiceCreateSchema = z
+    .object({
+    title: z.string().min(1, "Invoice title is required"),
+    contact_id: z.number().int().positive("Contact ID must be positive"),
+    currency_id: z.number().int().positive().optional(),
+    language_id: z.number().int().positive().optional(),
+    user_id: z.number().int().positive().optional(),
+    bank_account_id: z.number().int().positive().optional(),
+    payment_type_id: z.number().int().positive().optional(),
+    mwst_type: z.number().int().optional(),
+    mwst_is_net: z.boolean().optional(),
+    show_position_taxes: z.boolean().optional(),
+    is_valid_from: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .optional(),
+    is_valid_until: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .optional(),
+    positions: z
+        .array(InvoicePositionSchema)
+        .min(1, "At least one position is required"),
+})
+    .passthrough();
+// List invoices
+export const ListInvoicesParamsSchema = z.object({
+    limit: z.number().int().positive().default(50),
+    offset: z.number().int().min(0).default(0),
+});
+// List all invoices (auto-pagination)
+export const ListAllInvoicesParamsSchema = z.object({
+    chunk_size: z.number().int().positive().default(100),
+});
+// Get single invoice
+export const GetInvoiceParamsSchema = z.object({
+    invoice_id: z.number().int().positive(),
+});
+// Search invoices
+export const SearchInvoicesParamsSchema = z.object({
+    query: z.string().optional(),
+    field: z.string().default("title"),
+    operator: z.string().default("LIKE"),
+    filters: z
+        .array(z.object({
+        field: z.string(),
+        operator: z.string(),
+        value: z.unknown(),
+    }))
+        .optional(),
+    limit: z.number().int().positive().optional(),
+});
+// Search by customer name
+export const SearchInvoicesByCustomerParamsSchema = z.object({
+    customer_name: z.string().min(1),
+    limit: z.number().int().positive().default(50),
+});
+// Create invoice
+export const CreateInvoiceParamsSchema = z.object({
+    invoice_data: InvoiceCreateSchema,
+});
+// List invoice statuses
+export const ListInvoiceStatusesParamsSchema = z.object({});
+// List all document statuses
+export const ListAllStatusesParamsSchema = z.object({
+    document_type: z
+        .enum(["all", "invoices", "quotes", "orders"])
+        .default("all"),
+});
+// Invoice actions
+export const IssueInvoiceParamsSchema = z.object({
+    invoice_id: z.number().int().positive(),
+});
+export const CancelInvoiceParamsSchema = z.object({
+    invoice_id: z.number().int().positive(),
+});
+export const MarkInvoiceAsSentParamsSchema = z.object({
+    invoice_id: z.number().int().positive(),
+});
+export const SendInvoiceParamsSchema = z.object({
+    invoice_id: z.number().int().positive(),
+});
+export const CopyInvoiceParamsSchema = z.object({
+    invoice_id: z.number().int().positive(),
+});

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

@@ -0,0 +1,153 @@
+/**
+ * Item-related Zod schemas and types.
+ * Domain: Items (Articles) and Taxes
+ */
+import { z } from "zod";
+export declare const ItemCreateSchema: z.ZodObject<{
+    name_1: z.ZodString;
+    name_2: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    internal_pos: z.ZodOptional<z.ZodString>;
+    unit_id: z.ZodOptional<z.ZodNumber>;
+    purchase_price: z.ZodOptional<z.ZodNumber>;
+    sale_price: z.ZodOptional<z.ZodNumber>;
+    article_type_id: z.ZodOptional<z.ZodNumber>;
+    tax_income_id: z.ZodOptional<z.ZodNumber>;
+    tax_id: z.ZodOptional<z.ZodNumber>;
+    account_id: z.ZodOptional<z.ZodNumber>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    name_1: z.ZodString;
+    name_2: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    internal_pos: z.ZodOptional<z.ZodString>;
+    unit_id: z.ZodOptional<z.ZodNumber>;
+    purchase_price: z.ZodOptional<z.ZodNumber>;
+    sale_price: z.ZodOptional<z.ZodNumber>;
+    article_type_id: z.ZodOptional<z.ZodNumber>;
+    tax_income_id: z.ZodOptional<z.ZodNumber>;
+    tax_id: z.ZodOptional<z.ZodNumber>;
+    account_id: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    name_1: z.ZodString;
+    name_2: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    internal_pos: z.ZodOptional<z.ZodString>;
+    unit_id: z.ZodOptional<z.ZodNumber>;
+    purchase_price: z.ZodOptional<z.ZodNumber>;
+    sale_price: z.ZodOptional<z.ZodNumber>;
+    article_type_id: z.ZodOptional<z.ZodNumber>;
+    tax_income_id: z.ZodOptional<z.ZodNumber>;
+    tax_id: z.ZodOptional<z.ZodNumber>;
+    account_id: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ItemCreate = z.infer<typeof ItemCreateSchema>;
+export declare const ListItemsParamsSchema: 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 ListItemsParams = z.infer<typeof ListItemsParamsSchema>;
+export declare const GetItemParamsSchema: z.ZodObject<{
+    item_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    item_id: number;
+}, {
+    item_id: number;
+}>;
+export type GetItemParams = z.infer<typeof GetItemParamsSchema>;
+export declare const CreateItemParamsSchema: z.ZodObject<{
+    item_data: z.ZodObject<{
+        name_1: z.ZodString;
+        name_2: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        internal_pos: z.ZodOptional<z.ZodString>;
+        unit_id: z.ZodOptional<z.ZodNumber>;
+        purchase_price: z.ZodOptional<z.ZodNumber>;
+        sale_price: z.ZodOptional<z.ZodNumber>;
+        article_type_id: z.ZodOptional<z.ZodNumber>;
+        tax_income_id: z.ZodOptional<z.ZodNumber>;
+        tax_id: z.ZodOptional<z.ZodNumber>;
+        account_id: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        name_1: z.ZodString;
+        name_2: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        internal_pos: z.ZodOptional<z.ZodString>;
+        unit_id: z.ZodOptional<z.ZodNumber>;
+        purchase_price: z.ZodOptional<z.ZodNumber>;
+        sale_price: z.ZodOptional<z.ZodNumber>;
+        article_type_id: z.ZodOptional<z.ZodNumber>;
+        tax_income_id: z.ZodOptional<z.ZodNumber>;
+        tax_id: z.ZodOptional<z.ZodNumber>;
+        account_id: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        name_1: z.ZodString;
+        name_2: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        internal_pos: z.ZodOptional<z.ZodString>;
+        unit_id: z.ZodOptional<z.ZodNumber>;
+        purchase_price: z.ZodOptional<z.ZodNumber>;
+        sale_price: z.ZodOptional<z.ZodNumber>;
+        article_type_id: z.ZodOptional<z.ZodNumber>;
+        tax_income_id: z.ZodOptional<z.ZodNumber>;
+        tax_id: z.ZodOptional<z.ZodNumber>;
+        account_id: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "strip", z.ZodTypeAny, {
+    item_data: {
+        name_1: string;
+        unit_id?: number | undefined;
+        account_id?: number | undefined;
+        tax_id?: number | undefined;
+        name_2?: string | undefined;
+        description?: string | undefined;
+        internal_pos?: string | undefined;
+        purchase_price?: number | undefined;
+        sale_price?: number | undefined;
+        article_type_id?: number | undefined;
+        tax_income_id?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    item_data: {
+        name_1: string;
+        unit_id?: number | undefined;
+        account_id?: number | undefined;
+        tax_id?: number | undefined;
+        name_2?: string | undefined;
+        description?: string | undefined;
+        internal_pos?: string | undefined;
+        purchase_price?: number | undefined;
+        sale_price?: number | undefined;
+        article_type_id?: number | undefined;
+        tax_income_id?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}>;
+export type CreateItemParams = z.infer<typeof CreateItemParamsSchema>;
+export declare const ListTaxesParamsSchema: 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 ListTaxesParams = z.infer<typeof ListTaxesParamsSchema>;
+export declare const GetTaxParamsSchema: z.ZodObject<{
+    tax_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    tax_id: number;
+}, {
+    tax_id: number;
+}>;
+export type GetTaxParams = z.infer<typeof GetTaxParamsSchema>;

package/dist/types/schemas/items.js

@@ -0,0 +1,43 @@
+/**
+ * Item-related Zod schemas and types.
+ * Domain: Items (Articles) and Taxes
+ */
+import { z } from "zod";
+// Item creation payload
+export const ItemCreateSchema = z
+    .object({
+    name_1: z.string().min(1, "Item name is required"),
+    name_2: z.string().optional(),
+    description: z.string().optional(),
+    internal_pos: z.string().optional(),
+    unit_id: z.number().int().positive().optional(),
+    purchase_price: z.number().optional(),
+    sale_price: z.number().optional(),
+    article_type_id: z.number().int().positive().optional(),
+    tax_income_id: z.number().int().positive().optional(),
+    tax_id: z.number().int().positive().optional(),
+    account_id: z.number().int().positive().optional(),
+})
+    .passthrough();
+// List items
+export const ListItemsParamsSchema = z.object({
+    limit: z.number().int().positive().default(50),
+    offset: z.number().int().min(0).default(0),
+});
+// Get single item
+export const GetItemParamsSchema = z.object({
+    item_id: z.number().int().positive(),
+});
+// Create item
+export const CreateItemParamsSchema = z.object({
+    item_data: ItemCreateSchema,
+});
+// List taxes
+export const ListTaxesParamsSchema = z.object({
+    limit: z.number().int().positive().default(50),
+    offset: z.number().int().min(0).default(0),
+});
+// Get single tax
+export const GetTaxParamsSchema = z.object({
+    tax_id: z.number().int().positive(),
+});

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

@@ -0,0 +1,64 @@
+/**
+ * Misc-related Zod schemas and types.
+ * Domain: Comments and Contact Relations
+ */
+import { z } from "zod";
+export declare const GetCommentParamsSchema: z.ZodObject<{
+    comment_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    comment_id: number;
+}, {
+    comment_id: number;
+}>;
+export type GetCommentParams = z.infer<typeof GetCommentParamsSchema>;
+export declare const CreateCommentParamsSchema: z.ZodObject<{
+    comment_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    comment_data: Record<string, unknown>;
+}, {
+    comment_data: Record<string, unknown>;
+}>;
+export type CreateCommentParams = z.infer<typeof CreateCommentParamsSchema>;
+export declare const GetContactRelationParamsSchema: z.ZodObject<{
+    relation_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    relation_id: number;
+}, {
+    relation_id: number;
+}>;
+export type GetContactRelationParams = z.infer<typeof GetContactRelationParamsSchema>;
+export declare const CreateContactRelationParamsSchema: z.ZodObject<{
+    relation_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    relation_data: Record<string, unknown>;
+}, {
+    relation_data: Record<string, unknown>;
+}>;
+export type CreateContactRelationParams = z.infer<typeof CreateContactRelationParamsSchema>;
+export declare const UpdateContactRelationParamsSchema: z.ZodObject<{
+    relation_id: z.ZodNumber;
+    relation_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    relation_id: number;
+    relation_data: Record<string, unknown>;
+}, {
+    relation_id: number;
+    relation_data: Record<string, unknown>;
+}>;
+export type UpdateContactRelationParams = z.infer<typeof UpdateContactRelationParamsSchema>;
+export declare const DeleteContactRelationParamsSchema: z.ZodObject<{
+    relation_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    relation_id: number;
+}, {
+    relation_id: number;
+}>;
+export type DeleteContactRelationParams = z.infer<typeof DeleteContactRelationParamsSchema>;
+export declare const SearchContactRelationsParamsSchema: 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 SearchContactRelationsParams = z.infer<typeof SearchContactRelationsParamsSchema>;

package/dist/types/schemas/misc.js

@@ -0,0 +1,36 @@
+/**
+ * Misc-related Zod schemas and types.
+ * Domain: Comments and Contact Relations
+ */
+import { z } from "zod";
+// ===== COMMENTS =====
+// Get comment
+export const GetCommentParamsSchema = z.object({
+    comment_id: z.number().int().positive(),
+});
+// Create comment
+export const CreateCommentParamsSchema = z.object({
+    comment_data: z.record(z.unknown()),
+});
+// ===== CONTACT RELATIONS =====
+// Get contact relation
+export const GetContactRelationParamsSchema = z.object({
+    relation_id: z.number().int().positive(),
+});
+// Create contact relation
+export const CreateContactRelationParamsSchema = z.object({
+    relation_data: z.record(z.unknown()),
+});
+// Update contact relation
+export const UpdateContactRelationParamsSchema = z.object({
+    relation_id: z.number().int().positive(),
+    relation_data: z.record(z.unknown()),
+});
+// Delete contact relation
+export const DeleteContactRelationParamsSchema = z.object({
+    relation_id: z.number().int().positive(),
+});
+// Search contact relations
+export const SearchContactRelationsParamsSchema = z.object({
+    search_params: z.record(z.unknown()),
+});