VillaTaxVillaTax
Gratis Audit
Charlotte KIPreise
AnmeldenStarten
Gratis Audit
StartFunktionen — VillaTax-Funktionen für die Steuerverwaltung von Villen auf BaliGratis AuditPreise
REST API · OpenAPI 3.0 · HMAC Webhooks

API-Dokumentation

Integrieren Sie Bali-Steuer-Compliance in Ihre Anwendungen

12 Endpunkte100 Anf./Min.HMAC-SHA256OpenAPI 3.0
API-Schlüssel erhalten Interaktive Doku anzeigen

Bearer Auth

API-Schlüssel in Einstellungen → API. vt_live_* für Produktion, vt_test_* für Sandbox.

Ratenlimits

100 Anfragen/Minute pro API-Schlüssel. Header: X-RateLimit-Limit, X-RateLimit-Remaining.

Signierte Webhooks

HMAC-SHA256-Signatur auf jeder Payload. Automatische exponentielle Backoff-Wiederholung bei Fehlern.

OpenAPI 3.0

Vollständige Spezifikation unter /openapi.yaml. Verwenden Sie openapi-generator, um SDKs in jeder Sprache zu erstellen.

Authentifizierung

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

Base URL: https://villa-tax.operium.store/api/v1
Auth:     Authorization: Bearer vt_live_YOUR_API_KEY
Sandbox:  Bearer vt_test_YOUR_KEY (returns testMode: true)

Begrenzt auf 100 Anfragen/Minute pro API-Schlüssel. Header: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Schnellstart

JavaScriptnode.js
// Authenticate with Bearer token
const headers = {
  'Authorization': 'Bearer vt_live_YOUR_API_KEY',
  'Content-Type': 'application/json'
};

// List your properties
const res = await fetch(
  'https://villa-tax.operium.store/api/v1/properties?organizationId=YOUR_ORG_ID',
  { headers }
).then(r => r.json());
// { data: [...], testMode: false, meta: { total: 5, page: 1, limit: 20 } }

// Create a booking + auto tax calculation
const booking = await fetch('https://villa-tax.operium.store/api/v1/bookings', {
  method: 'POST', headers,
  body: JSON.stringify({
    propertyId: 'prop-uuid',
    guestName: 'Alice Martin',
    checkIn: '2025-06-15',
    checkOut: '2025-06-22',
    grossAmountIdr: 14000000,
    platform: 'airbnb'
  })
}).then(r => r.json());
// { data: { id: '...', taxBreakdowns: [{ type:'PBJT', rate:0.10, ... }] }, testMode: false }

Endpunkte

Interaktiven Explorer öffnen→
GET/v1/organizationsList all organizations
GET/v1/organizations/{id}Get an organization
GET/v1/propertiesList properties
POST/v1/propertiesCreate a property
GET/v1/properties/{id}Get a property
GET/v1/bookingsList bookings
POST/v1/bookingsCreate a booking
GET/v1/bookings/{id}Get booking + tax breakdowns
GET/v1/tax-summaryTax summary by org & fiscal year
GET/v1/webhooks/endpointsList webhook endpoints
POST/v1/webhooks/endpointsRegister a webhook endpoint
DELETE/v1/webhooks/endpoints/{id}Delete a webhook endpoint

SDKs für Node.js und Python, Verfügbar im Q3 2026

Webhooks

Konfigurieren Sie Ihre Webhooks in Dashboard > Integrationen > Webhooks

booking.created

New booking received

booking.updated

Booking modified

tax.calculated

Tax calculation completed

report.generated

Fiscal report generated

HMAC-SHA256

Alle Webhook-Payloads werden mit HMAC-SHA256 signiert. Überprüfen Sie den X-VillaTax-Signature-Header mit dem Endpunkt-Secret.

Für Entwickler gebaut, die echte Steuerdaten benötigen

01

Channel-Manager-Integration

Schieben Sie Buchungen aus Ihrem PMS oder Channel-Manager. Steuerberechnungen werden automatisch ausgelöst. Bauen Sie Ihre eigene Berichtsschicht darüber.

02

Immobilienverwaltungssoftware

Integrieren Sie steuerliche Compliance direkt in Ihre Immobilienverwaltungssoftware. Ihre Kunden erhalten indonesische Steuer-Compliance, ohne Ihre App zu verlassen.

03

Automatisierte Steuerberichterstattung

Rufen Sie Steuerzusammenfassungen über die API ab, um monatliche PBJT-, PPh- und PPN-Berichte automatisch zu generieren. Exportieren Sie mit sauberem JSON in Ihr Buchhaltungssystem.

FAQ

Bereit VillaTax zu integrieren?

API-Schlüssel erhalten Enterprise-Team kontaktieren
PT ASIAH LEGAL JAYA
Usaha Besar • Benoa Square Lt.3 Suite 4.3 • Badung, Bali
+62-813-8798-3316
VillaTaxVillaTax

Steuer-Compliance-Dashboard für Villa-Besitzer auf Bali, Indonesien.

Powered by OPERIUM →

Produkt

ProduktarchitekturCharlotte KIFunktionenIntegrationenPreiseServicesBlogGratis AuditAPI Docs

Funktionen

BuchungenSteuer-EngineAufgabenAnalytikPersonal & GehaltBuchhaltungCoretax 2026Dokumente

Lösungen

VillenDirektbuchungEigentümerAgenturenInvestorenEntwicklerSafe HarborPartnerprogrammKarriereFAQKontakt

Rechtliches

DatenschutzNutzungsbedingungenDSGVOErstattungsrichtlinieÜber OPERIUM
© 2026 PT. Asiah Legal Jaya — Usaha Besar — Benoa Square Lt.3 Suite 4.3, Badung, BaliSteuerberechnungen sind indikativ. Konsultieren Sie einen Steuerberater.