Kunden API

curl -X GET "https://buchhaltgenie.at/api/v1/customers?search=Muster&country=AT" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json"

const listCustomers = async (options = {}) => {
  const params = new URLSearchParams();
 
  if (options.search) params.append('search', options.search);
  if (options.type) params.append('type', options.type);
  if (options.country) params.append('country', options.country);
  if (options.active !== undefined) params.append('active', options.active.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/customers?${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: customers, pagination } = await listCustomers({
  search: 'Muster',
  country: 'AT',
  active: true,
});
 
console.log(`${pagination.total_count} Kunden gefunden`);

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

const getCustomer = async (customerId) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/customers/${customerId}`,
    {
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
      },
    }
  );
 
  if (response.status === 404) {
    throw new Error('Kunde nicht gefunden');
  }
 
  return response.json();
};
 
// Verwendung
const { data: customer } = await getCustomer('cus_xyz789');
console.log(`Kunde: ${customer.name}, UID: ${customer.uid_number}`);

curl -X POST "https://buchhaltgenie.at/api/v1/customers" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "business",
    "name": "Neue Firma GmbH",
    "email": "kontakt@neuefirma.at",
    "phone": "+43 1 987 6543",
    "uid_number": "ATU87654321",
    "address": {
      "street": "Beispielgasse 10",
      "city": "Graz",
      "postal_code": "8010",
      "country": "AT"
    },
    "payment_terms": 30,
    "notes": "Erstkontakt über Messe"
  }'

const createCustomer = async (customerData) => {
  const response = await fetch(
    'https://buchhaltgenie.at/api/v1/customers',
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(customerData),
    }
  );
 
  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error.message);
  }
 
  return response.json();
};
 
// Geschäftskunde anlegen
const { data: businessCustomer } = await createCustomer({
  type: 'business',
  name: 'Neue Firma GmbH',
  email: 'kontakt@neuefirma.at',
  phone: '+43 1 987 6543',
  uid_number: 'ATU87654321',
  address: {
    street: 'Beispielgasse 10',
    city: 'Graz',
    postal_code: '8010',
    country: 'AT',
  },
  payment_terms: 30,
  notes: 'Erstkontakt über Messe',
});
 
console.log(`Kunde ${businessCustomer.name} angelegt (ID: ${businessCustomer.id})`);

curl -X POST "https://buchhaltgenie.at/api/v1/customers" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "private",
    "first_name": "Maria",
    "last_name": "Musterfrau",
    "email": "maria.musterfrau@email.at",
    "phone": "+43 664 123 4567",
    "address": {
      "street": "Privatweg 5",
      "city": "Salzburg",
      "postal_code": "5020",
      "country": "AT"
    }
  }'

// Privatkunde anlegen
const { data: privateCustomer } = await createCustomer({
  type: 'private',
  first_name: 'Maria',
  last_name: 'Musterfrau',
  email: 'maria.musterfrau@email.at',
  phone: '+43 664 123 4567',
  address: {
    street: 'Privatweg 5',
    city: 'Salzburg',
    postal_code: '5020',
    country: 'AT',
  },
});
 
console.log(`Kunde ${privateCustomer.first_name} ${privateCustomer.last_name} angelegt`);

curl -X PATCH "https://buchhaltgenie.at/api/v1/customers/cus_xyz789" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "neue-email@musterfirma.at",
    "payment_terms": 21
  }'

const updateCustomer = async (customerId, updates) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/customers/${customerId}`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(updates),
    }
  );
 
  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error.message);
  }
 
  return response.json();
};
 
// Verwendung
const { data: updated } = await updateCustomer('cus_xyz789', {
  email: 'neue-email@musterfirma.at',
  payment_terms: 21,
});
 
console.log(`Kunde aktualisiert: ${updated.email}`);

curl -X DELETE "https://buchhaltgenie.at/api/v1/customers/cus_xyz789" \
  -H "Authorization: Bearer sk_live_xxxx"

const archiveCustomer = async (customerId) => {
  const response = await fetch(
    `https://buchhaltgenie.at/api/v1/customers/${customerId}`,
    {
      method: 'DELETE',
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
      },
    }
  );
 
  if (response.status === 400) {
    const error = await response.json();
    throw new Error(error.error.message);
  }
 
  return response.json();
};
 
// Verwendung
const { data } = await archiveCustomer('cus_xyz789');
console.log(`Kunde archiviert am: ${data.archived_at}`);

curl -X GET "https://buchhaltgenie.at/api/v1/customers/cus_xyz789/invoices?status=paid" \
  -H "Authorization: Bearer sk_live_xxxx"

const getCustomerInvoices = async (customerId, options = {}) => {
  const params = new URLSearchParams();
  if (options.status) params.append('status', options.status);
  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/customers/${customerId}/invoices?${params}`,
    {
      headers: {
        'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
      },
    }
  );
 
  return response.json();
};
 
// Verwendung
const { data: invoices } = await getCustomerInvoices('cus_xyz789', {
  status: 'paid',
});
 
const totalRevenue = invoices.reduce((sum, inv) => sum + inv.total, 0);
console.log(`Gesamtumsatz: ${totalRevenue} EUR`);