Rechnungen API

curl -X GET "https://buchhaltgenie.at/api/v1/invoices?status=sent&per_page=10" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json"

const listInvoices = async (status = 'sent', perPage = 10) => {
  const params = new URLSearchParams({
    status,
    per_page: perPage.toString(),
  });
 
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/invoices?${params}`,
    {
      method: 'GET',
      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, pagination } = await listInvoices('sent', 10);
console.log(`${pagination.total_count} Rechnungen gefunden`);

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

const getInvoice = async (invoiceId) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/invoices/${invoiceId}`,
    {
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
      },
    }
  );
 
  if (response.status === 404) {
    throw new Error('Rechnung nicht gefunden');
  }
 
  return response.json();
};
 
// Verwendung
const { data: invoice } = await getInvoice('inv_abc123');
console.log(`Rechnung ${invoice.number}: ${invoice.total} EUR`);

curl -X POST "https://buchhaltgenie.at/api/v1/invoices" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_xyz789",
    "items": [
      {
        "description": "Steuerberatung Q1 2026",
        "quantity": 1,
        "unit_price": 500.00,
        "vat_rate": 20
      },
      {
        "description": "Buchhaltung Jänner 2026",
        "quantity": 10,
        "unit_price": 80.00,
        "vat_rate": 20
      }
    ],
    "due_days": 14,
    "notes": "Vielen Dank für Ihr Vertrauen!",
    "payment_terms": "Zahlbar innerhalb von 14 Tagen ohne Abzug."
  }'

const createInvoice = async (invoiceData) => {
  const response = await fetch(
    'https://buchhaltgenie.at/api/v1/invoices',
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(invoiceData),
    }
  );
 
  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error.message);
  }
 
  return response.json();
};
 
// Verwendung
const { data: newInvoice } = await createInvoice({
  customer_id: 'cus_xyz789',
  items: [
    {
      description: 'Steuerberatung Q1 2026',
      quantity: 1,
      unit_price: 500.00,
      vat_rate: 20,
    },
    {
      description: 'Buchhaltung Jänner 2026',
      quantity: 10,
      unit_price: 80.00,
      vat_rate: 20,
    },
  ],
  due_days: 14,
  notes: 'Vielen Dank für Ihr Vertrauen!',
  payment_terms: 'Zahlbar innerhalb von 14 Tagen ohne Abzug.',
});
 
console.log(`Rechnung ${newInvoice.number} erstellt: ${newInvoice.total} EUR`);

curl -X PATCH "https://buchhaltgenie.at/api/v1/invoices/inv_def456" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "notes": "Aktualisierte Anmerkung",
    "due_days": 21
  }'

const updateInvoice = async (invoiceId, updates) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/invoices/${invoiceId}`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(updates),
    }
  );
 
  if (response.status === 400) {
    throw new Error('Rechnung kann nicht mehr bearbeitet werden');
  }
 
  return response.json();
};
 
// Verwendung
const { data: updated } = await updateInvoice('inv_def456', {
  notes: 'Aktualisierte Anmerkung',
  due_days: 21,
});

curl -X POST "https://buchhaltgenie.at/api/v1/invoices/inv_def456/send" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["rechnung@musterfirma.at"],
    "cc": ["buchhaltung@musterfirma.at"],
    "message": "Guten Tag,\n\nanbei erhältst Sie unsere Rechnung.\n\nMit freundlichen Grüßen"
  }'

const sendInvoice = async (invoiceId, options = {}) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/invoices/${invoiceId}/send`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(options),
    }
  );
 
  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error.message);
  }
 
  return response.json();
};
 
// Verwendung
await sendInvoice('inv_def456', {
  to: ['rechnung@musterfirma.at'],
  cc: ['buchhaltung@musterfirma.at'],
  message: 'Guten Tag,\n\nanbei erhältst Sie unsere Rechnung.\n\nMit freundlichen Grüßen',
});
 
console.log('Rechnung erfolgreich versendet!');

curl -X GET "https://buchhaltgenie.at/api/v1/invoices/inv_def456/pdf" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -o rechnung.pdf

const downloadInvoicePdf = async (invoiceId, filename) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/invoices/${invoiceId}/pdf`,
    {
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
      },
    }
  );
 
  if (!response.ok) {
    throw new Error('PDF konnte nicht heruntergeladen werden');
  }
 
  // Im Browser
  const blob = await response.blob();
  const url = window.URL.createObjectURL(blob);
  const a = document.createElement('a');
  a.href = url;
  a.download = filename || 'rechnung.pdf';
  a.click();
 
  // In Node.js
  // const fs = require('fs');
  // const buffer = await response.arrayBuffer();
  // fs.writeFileSync(filename, Buffer.from(buffer));
};
 
// Verwendung
await downloadInvoicePdf('inv_def456', 'RE-2026-0002.pdf');

curl -X DELETE "https://buchhaltgenie.at/api/v1/invoices/inv_def456" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Fehlerhafte Rechnungsstellung"}'

const cancelInvoice = async (invoiceId, reason) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/invoices/${invoiceId}`,
    {
      method: 'DELETE',
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ reason }),
    }
  );
 
  return response.json();
};
 
// Verwendung
const { data } = await cancelInvoice('inv_def456', 'Fehlerhafte Rechnungsstellung');
console.log(`Rechnung ${data.number} storniert`);