@agnocon/piece-bexio 0.1.7

package/src/lib/common/props.ts

@@ -0,0 +1,127 @@
+import { Property, OAuth2PropertyValue } from '@agnocon/pieces-framework';
+import { BexioClient } from './client';
+import { BexioAccount, BexioTax, BexioCurrency } from './types';
+import { bexioAuth } from '../auth';
+
+export const bexioCommonProps = {
+  account: (options: {
+    displayName: string;
+    description?: string;
+    required: boolean;
+  }) => {
+    return Property.Dropdown({
+      auth: bexioAuth,
+      displayName: options.displayName,
+      description: options.description,
+      required: options.required,
+      refreshers: [],
+      options: async ({ auth }) => {
+        if (!auth) {
+          return {
+            disabled: true,
+            placeholder: 'Connect your Bexio account first',
+            options: [],
+          };
+        }
+
+        try {
+          const client = new BexioClient(auth);
+          const accounts = await client.get<BexioAccount[]>('/accounts');
+
+          return {
+            disabled: false,
+            options: accounts.map((account) => ({
+              label: `${account.account_no} - ${account.name}`,
+              value: account.id,
+            })),
+          };
+        } catch (error) {
+          return {
+            disabled: true,
+            placeholder: 'Failed to load accounts',
+            options: [],
+          };
+        }
+      },
+    });
+  },
+
+  tax: Property.Dropdown({
+    auth: bexioAuth,
+    displayName: 'Tax',
+    description: 'Select a tax rate',
+    required: false,
+    refreshers: [],
+    options: async ({ auth }) => {
+      if (!auth) {
+        return {
+          disabled: true,
+          placeholder: 'Connect your Bexio account first',
+          options: [],
+        };
+      }
+
+      try {
+        const client = new BexioClient(auth);
+        const taxes = await client.get<BexioTax[]>('/taxes');
+
+        return {
+          disabled: false,
+          options: taxes.map((tax) => ({
+            label: `${tax.name} (${tax.percentage}%)`,
+            value: tax.id,
+          })),
+        };
+      } catch (error) {
+        return {
+          disabled: true,
+          placeholder: 'Failed to load taxes',
+          options: [],
+        };
+      }
+    },
+  }),
+
+  currency: (options: {
+    displayName: string;
+    description?: string;
+    required: boolean;
+  }) => {
+    return Property.Dropdown({
+      auth: bexioAuth,
+      displayName: options.displayName,
+      description: options.description,
+      required: options.required,
+      refreshers: [],
+      options: async ({ auth }) => {
+        if (!auth) {
+          return {
+            disabled: true,
+            placeholder: 'Connect your Bexio account first',
+            options: [],
+          };
+        }
+
+        try {
+          const client = new BexioClient(auth);
+          const currencies = await client.get<BexioCurrency[]>('/3.0/currencies');
+
+          return {
+            disabled: false,
+            options: currencies.map((currency) => ({
+              label: currency.name,
+              value: currency.id,
+            })),
+          };
+        } catch (error) {
+          return {
+            disabled: true,
+            placeholder: 'Failed to load currencies',
+            options: [],
+          };
+        }
+      },
+    });
+  },
+};
+

package/src/lib/common/types.ts

@@ -0,0 +1,99 @@
+// Common types for Bexio API
+
+export interface BexioContact {
+  id: number;
+  nr: string;
+  contact_type_id: number;
+  name_1: string;
+  name_2?: string;
+  salutation_id?: number;
+  salutation_form?: number;
+  title_id?: number;
+  birthday?: string;
+  address?: string;
+  postcode?: string;
+  city?: string;
+  country_id?: number;
+  mail?: string;
+  mail_second?: string;
+  phone_fixed?: string;
+  phone_fixed_second?: string;
+  phone_mobile?: string;
+  fax?: string;
+  url?: string;
+  skype_name?: string;
+  remarks?: string;
+  language_id?: number;
+  contact_group_ids?: string;
+  contact_branch_ids?: string;
+  user_id?: number;
+  owner_id?: number;
+}
+
+export interface BexioCompany {
+  id: number;
+  name: string;
+  address?: string;
+  address_nr?: string;
+  postcode?: string;
+  city?: string;
+  country_id?: number;
+  legal_form?: string;
+}
+
+export interface BexioAccount {
+  id: number;
+  account_no: string;
+  name: string;
+  account_type: number;
+}
+
+export interface BexioTax {
+  id: number;
+  name: string;
+  percentage: string;
+}
+
+export interface BexioCurrency {
+  id: number;
+  name: string;
+}
+
+export interface BexioManualEntry {
+  debit_account_id?: number;
+  credit_account_id?: number;
+  tax_id?: number;
+  tax_account_id?: number;
+  description?: string;
+  amount?: number;
+  currency_id?: number;
+  currency_factor?: number;
+}
+
+export interface BexioManualEntryResponse {
+  id: number;
+  type: 'manual_single_entry' | 'manual_compound_entry' | 'manual_group_entry';
+  date: string;
+  reference_nr?: string;
+  created_by_user_id?: number;
+  edited_by_user_id?: number;
+  entries: BexioManualEntry[];
+  is_locked?: boolean;
+  locked_info?: string;
+}
+
+export interface BexioError {
+  error_code: number;
+  message: string;
+}
+
+export interface BexioListResponse<T> {
+  data: T[];
+  paging?: {
+    page: number;
+    page_size: number;
+    page_count: number;
+    item_count: number;
+  };
+}
+

package/src/lib/triggers/new-order.ts

@@ -0,0 +1,184 @@
+import { createTrigger, TriggerStrategy, PiecePropValueSchema, Property, AppConnectionValueForAuthProperty } from '@agnocon/pieces-framework';
+import { DedupeStrategy, Polling, pollingHelper } from '@agnocon/pieces-common';
+import { bexioAuth } from '../auth';
+import { BexioClient } from '../common/client';
+import { OAuth2PropertyValue } from '@agnocon/pieces-framework';
+import dayjs from 'dayjs';
+
+const polling: Polling<
+  AppConnectionValueForAuthProperty<typeof bexioAuth>,
+  { status_id?: number }
+> = {
+  strategy: DedupeStrategy.TIMEBASED,
+  items: async ({ auth, lastFetchEpochMS, propsValue }) => {
+    const client = new BexioClient(auth);
+
+    const isTest = lastFetchEpochMS === 0;
+
+    const lastFetchDate = isTest
+      ? dayjs().subtract(1, 'day').format('YYYY-MM-DD HH:mm:ss')
+      : dayjs(lastFetchEpochMS).format('YYYY-MM-DD HH:mm:ss');
+
+    const searchBody: Array<{ field: string; value: string; criteria: string }> = [
+      {
+        field: 'updated_at',
+        value: lastFetchDate,
+        criteria: '>=',
+      },
+    ];
+
+    if (propsValue.status_id !== undefined && propsValue.status_id !== null) {
+      searchBody.push({
+        field: 'kb_item_status_id',
+        value: propsValue.status_id.toString(),
+        criteria: '=',
+      });
+    }
+
+    const queryParams: Record<string, string> = {
+      order_by: 'updated_at_desc',
+      limit: isTest ? '5' : '500',
+    };
+
+    const orders = await client.post<Array<{
+      id: number;
+      document_nr: string;
+      title: string | null;
+      contact_id: number | null;
+      contact_sub_id: number | null;
+      user_id: number;
+      project_id: number | null;
+      language_id: number;
+      bank_account_id: number;
+      currency_id: number;
+      payment_type_id: number;
+      total_gross: string;
+      total_net: string;
+      total_taxes: string;
+      total: string;
+      kb_item_status_id: number;
+      is_valid_from: string;
+      updated_at: string;
+    }>>('/2.0/kb_order/search', searchBody, queryParams);
+
+    return orders.map((order) => {
+      const updatedAt = order.updated_at || new Date().toISOString();
+      const epochMilliSeconds = dayjs(updatedAt).valueOf();
+
+      return {
+        epochMilliSeconds,
+        data: order,
+      };
+    });
+  },
+};
+
+export const newOrderTrigger = createTrigger({
+  auth: bexioAuth,
+  name: 'new_order',
+  displayName: 'New Order',
+  description: 'Triggers when an Order is created or updated with the chosen status',
+  aiMetadata: {
+    description: 'Fires when a sales order is created or its updated timestamp changes in Bexio, optionally filtered to a chosen order status. Emits each matching order with its document number, contact, totals (gross, net, taxes), valid-from date, and status. Use to react to new or modified orders.',
+  },
+  type: TriggerStrategy.POLLING,
+  props: {
+    status_id: Property.Dropdown({
+      auth: bexioAuth,
+      displayName: 'Status',
+      description: 'Filter orders by status (leave empty to trigger for all statuses)',
+      required: false,
+      refreshers: [],
+      options: async ({ auth }) => {
+        if (!auth) {
+          return {
+            disabled: true,
+            placeholder: 'Connect your Bexio account first',
+            options: [],
+          };
+        }
+
+        try {
+          const client = new BexioClient(auth);
+          const statuses = await client.get<Array<{
+            id: number;
+            name: string;
+          }>>('/2.0/kb_order_status').catch(() => []);
+
+          if (statuses.length === 0) {
+            return {
+              disabled: false,
+              placeholder: 'Status filter not available - will trigger for all statuses',
+              options: [],
+            };
+          }
+
+          return {
+            disabled: false,
+            options: statuses.map((status) => ({
+              label: status.name,
+              value: status.id,
+            })),
+          };
+        } catch (error) {
+          return {
+            disabled: false,
+            placeholder: 'Enter status ID manually or leave empty for all statuses',
+            options: [],
+          };
+        }
+      },
+    }),
+  },
+  sampleData: {
+    id: 4,
+    document_nr: 'AU-00001',
+    title: null,
+    contact_id: 14,
+    contact_sub_id: null,
+    user_id: 1,
+    project_id: null,
+    language_id: 1,
+    bank_account_id: 1,
+    currency_id: 1,
+    payment_type_id: 1,
+    total_gross: '17.800000',
+    total_net: '17.800000',
+    total_taxes: '1.3706',
+    total: '19.150000',
+    kb_item_status_id: 5,
+    is_valid_from: '2019-06-24',
+    updated_at: '2019-04-08 13:17:32',
+  },
+  onEnable: async (context) => {
+    await pollingHelper.onEnable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  onDisable: async (context) => {
+    await pollingHelper.onDisable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  test: async (context) => {
+    return await pollingHelper.test(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+      files: context.files,
+    });
+  },
+  run: async (context) => {
+    return await pollingHelper.poll(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+      files: context.files,
+    });
+  },
+});
+

package/src/lib/triggers/new-product.ts

@@ -0,0 +1,154 @@
+import { createTrigger, TriggerStrategy, AppConnectionValueForAuthProperty } from '@agnocon/pieces-framework';
+import { DedupeStrategy, Polling, pollingHelper } from '@agnocon/pieces-common';
+import { bexioAuth } from '../auth';
+import { BexioClient } from '../common/client';
+
+const polling: Polling<
+  AppConnectionValueForAuthProperty<typeof bexioAuth>,
+  Record<string, never>
+> = {
+  strategy: DedupeStrategy.LAST_ITEM,
+  items: async ({ auth, lastItemId }) => {
+    const client = new BexioClient(auth);
+
+    // Use GET endpoint to fetch all articles, then sort by ID descending
+    // This avoids the issue with empty search arrays
+    const queryParams: Record<string, string> = {
+      limit: '500',
+    };
+
+    const products = await client.get<Array<{
+      id: number;
+      user_id: number;
+      article_type_id: number;
+      contact_id: number | null;
+      deliverer_code: string | null;
+      deliverer_name: string | null;
+      deliverer_description: string | null;
+      intern_code: string;
+      intern_name: string;
+      intern_description: string | null;
+      purchase_price: string | null;
+      sale_price: string | null;
+      purchase_total: number | null;
+      sale_total: number | null;
+      currency_id: number | null;
+      tax_income_id: number | null;
+      tax_id: number | null;
+      tax_expense_id: number | null;
+      unit_id: number | null;
+      is_stock: boolean;
+      stock_id: number | null;
+      stock_place_id: number | null;
+      stock_nr: number;
+      stock_min_nr: number;
+      stock_reserved_nr: number;
+      stock_available_nr: number;
+      stock_picked_nr: number;
+      stock_disposed_nr: number;
+      stock_ordered_nr: number;
+      width: number | null;
+      height: number | null;
+      weight: number | null;
+      volume: number | null;
+      html_text: string | null;
+      remarks: string | null;
+      delivery_price: number | null;
+      article_group_id: number | null;
+      account_id: number | null;
+      expense_account_id: number | null;
+    }>>('/2.0/article', queryParams);
+
+    // Sort by ID descending to get newest first (since GET doesn't support order_by)
+    const sortedProducts = products.sort((a, b) => b.id - a.id);
+
+    return sortedProducts.map((product) => ({
+      id: product.id,
+      data: product,
+    }));
+  },
+};
+
+export const newProductTrigger = createTrigger({
+  auth: bexioAuth,
+  name: 'new_product',
+  displayName: 'New Product',
+  description: 'Triggers when a new product is created',
+  aiMetadata: {
+    description: 'Fires when a new product (article) is created in Bexio. Polls the article list and emits each newly added product, including its codes, names, pricing, stock levels, and accounting references. Use to react to additions to the product catalog.',
+  },
+  type: TriggerStrategy.POLLING,
+  props: {},
+  sampleData: {
+    id: 4,
+    user_id: 1,
+    article_type_id: 1,
+    contact_id: 14,
+    deliverer_code: null,
+    deliverer_name: null,
+    deliverer_description: null,
+    intern_code: 'wh-2019',
+    intern_name: 'Webhosting',
+    intern_description: null,
+    purchase_price: null,
+    sale_price: null,
+    purchase_total: null,
+    sale_total: null,
+    currency_id: null,
+    tax_income_id: null,
+    tax_id: null,
+    tax_expense_id: null,
+    unit_id: null,
+    is_stock: false,
+    stock_id: null,
+    stock_place_id: null,
+    stock_nr: 0,
+    stock_min_nr: 0,
+    stock_reserved_nr: 0,
+    stock_available_nr: 0,
+    stock_picked_nr: 0,
+    stock_disposed_nr: 0,
+    stock_ordered_nr: 0,
+    width: null,
+    height: null,
+    weight: null,
+    volume: null,
+    html_text: null,
+    remarks: null,
+    delivery_price: null,
+    article_group_id: null,
+    account_id: null,
+    expense_account_id: null,
+  },
+  onEnable: async (context) => {
+    await pollingHelper.onEnable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  onDisable: async (context) => {
+    await pollingHelper.onDisable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  test: async (context) => {
+    return await pollingHelper.test(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+      files: context.files,
+    });
+  },
+  run: async (context) => {
+    return await pollingHelper.poll(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+      files: context.files,
+    });
+  },
+});
+