Entwickler-Dokumentation

API-Dokumentation

Integrieren Sie Bali-Steuer-Compliance in Ihre Anwendungen

Authentifizierung

Alle API-Anfragen erfordern einen Bearer-Token-API-Schlüssel. Holen Sie Ihren Schlüssel aus Dashboard > Einstellungen > API-Schlüssel.

Basis-URL
https://api.villa-tax.operium.store

Quick Start

// Authenticate
const headers = {
  'Authorization': 'Bearer YOUR_API_KEY',
  'Content-Type': 'application/json'
};

// Calculate taxes
const res = await fetch(
  'https://api.villa-tax.operium.store/v1/calculate',
  {
    method: 'POST',
    headers,
    body: JSON.stringify({
      regency: 'badung',
      annual_revenue_idr: 500000000,
      occupancy_rate: 0.75
    })
  }
);

const { pbjt, pph, total } = await res.json();
// { pbjt: 37500000, pph: 18750000, total: 56250000 }

Endpunkte

GET/v1/properties
POST/v1/properties
GET/v1/bookings
POST/v1/bookings
POST/v1/calculate
GET/v1/compliance/{propertyId}
GET/v1/reports/monthly
POST/v1/webhooks

Webhooks

Konfigurieren Sie Ihre Webhooks in Dashboard > Integrationen > Webhooks

booking.created

New booking received

tax.calculated

Tax calculation completed

compliance.alert

Compliance issue detected

document.expiring

Document expiry in 30 days

FAQ