Transaktionen API

curl -X GET "https://buchhaltgenie.at/api/v1/transactions?type=income&from_date=2026-01-01" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json"

const listTransactions = async (options = {}) => {
  const params = new URLSearchParams();
 
  if (options.type) params.append('type', options.type);
  if (options.category) params.append('category', options.category);
  if (options.accountId) params.append('account_id', options.accountId);
  if (options.fromDate) params.append('from_date', options.fromDate);
  if (options.toDate) params.append('to_date', options.toDate);
  if (options.minAmount) params.append('min_amount', options.minAmount.toString());
  if (options.maxAmount) params.append('max_amount', options.maxAmount.toString());
  if (options.reconciled !== undefined) params.append('reconciled', options.reconciled.toString());
  if (options.page) params.append('page', options.page.toString());
  if (options.perPage) params.append('per_page', options.perPage.toString());
 
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/transactions?${params}`,
    {
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
        'Content-Type': 'application/json',
      },
    }
  );
 
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
  }
 
  return response.json();
};
 
// Verwendung
const { data: transactions, pagination } = await listTransactions({
  type: 'income',
  fromDate: '2026-01-01',
  reconciled: true,
});
 
console.log(`${pagination.total_count} Transaktionen gefunden`);

curl -X GET "https://buchhaltgenie.at/api/v1/transactions/txn_abc123" \
  -H "Authorization: Bearer sk_live_xxxx"

const getTransaction = async (transactionId) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/transactions/${transactionId}`,
    {
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
      },
    }
  );
 
  if (response.status === 404) {
    throw new Error('Transaktion nicht gefunden');
  }
 
  return response.json();
};
 
// Verwendung
const { data: transaction } = await getTransaction('txn_abc123');
console.log(`Transaktion: ${transaction.description}, ${transaction.amount} EUR`);
console.log(`Journaleinträge: ${transaction.journal_entries.length}`);

curl -X POST "https://buchhaltgenie.at/api/v1/transactions" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "income",
    "amount": 900.00,
    "description": "Zahlungseingang Kunde Musterfirma",
    "category": "revenue",
    "account_id": "acc_bank01",
    "date": "2026-01-09",
    "reference": {
      "type": "invoice",
      "id": "inv_def456"
    },
    "payment_method": "bank_transfer"
  }'

const createTransaction = async (transactionData) => {
  const response = await fetch(
    'https://buchhaltgenie.at/api/v1/transactions',
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(transactionData),
    }
  );
 
  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error.message);
  }
 
  return response.json();
};
 
// Zahlungseingang erstellen
const { data: income } = await createTransaction({
  type: 'income',
  amount: 900.00,
  description: 'Zahlungseingang Kunde Musterfirma',
  category: 'revenue',
  account_id: 'acc_bank01',
  date: '2026-01-09',
  reference: {
    type: 'invoice',
    id: 'inv_def456',
  },
  payment_method: 'bank_transfer',
});
 
console.log(`Einnahme verbucht: ${income.id}`);

curl -X POST "https://buchhaltgenie.at/api/v1/transactions" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "expense",
    "amount": 250.00,
    "description": "Büromaterial",
    "category": "office_supplies",
    "account_id": "acc_bank01",
    "date": "2026-01-08",
    "vat_rate": 20,
    "vat_deductible": true,
    "receipt_id": "rec_xyz789"
  }'

// Ausgabe erstellen
const { data: expense } = await createTransaction({
  type: 'expense',
  amount: 250.00,
  description: 'Büromaterial',
  category: 'office_supplies',
  account_id: 'acc_bank01',
  date: '2026-01-08',
  vat_rate: 20,
  vat_deductible: true,
  receipt_id: 'rec_xyz789',
});
 
console.log(`Ausgabe verbucht: ${expense.id}`);
console.log(`Vorsteuer: ${expense.vat_amount} EUR`);

curl -X POST "https://buchhaltgenie.at/api/v1/transactions" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "transfer",
    "amount": 5000.00,
    "description": "Umbuchung auf Sparkonto",
    "from_account_id": "acc_bank01",
    "to_account_id": "acc_savings01",
    "date": "2026-01-09"
  }'

// Umbuchung erstellen
const { data: transfer } = await createTransaction({
  type: 'transfer',
  amount: 5000.00,
  description: 'Umbuchung auf Sparkonto',
  from_account_id: 'acc_bank01',
  to_account_id: 'acc_savings01',
  date: '2026-01-09',
});
 
console.log(`Umbuchung: ${transfer.id}`);

curl -X POST "https://buchhaltgenie.at/api/v1/transactions/txn_abc123/reverse" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Doppelte Buchung korrigiert"
  }'

const reverseTransaction = async (transactionId, reason) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/transactions/${transactionId}/reverse`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ reason }),
    }
  );
 
  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error.message);
  }
 
  return response.json();
};
 
// Verwendung
const { data } = await reverseTransaction('txn_abc123', 'Doppelte Buchung korrigiert');
console.log(`Storniert: ${data.original_transaction.id}`);
console.log(`Stornobuchung: ${data.reversal_transaction.id}`);

curl -X GET "https://buchhaltgenie.at/api/v1/transactions/summary?period=month&from_date=2026-01-01" \
  -H "Authorization: Bearer sk_live_xxxx"

const getTransactionSummary = async (options = {}) => {
  const params = new URLSearchParams();
  if (options.period) params.append('period', options.period);
  if (options.fromDate) params.append('from_date', options.fromDate);
  if (options.toDate) params.append('to_date', options.toDate);
 
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/transactions/summary?${params}`,
    {
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
      },
    }
  );
 
  return response.json();
};
 
// Verwendung
const { data: summary } = await getTransactionSummary({
  period: 'month',
  fromDate: '2026-01-01',
});
 
console.log(`Einnahmen: ${summary.income.total} EUR`);
console.log(`Ausgaben: ${summary.expenses.total} EUR`);
console.log(`Saldo: ${summary.balance} EUR`);
console.log(`USt-Zahllast: ${summary.vat.due} EUR`);