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.
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.
// 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 }/v1/organizations/v1/organizations/{id}/v1/properties/v1/properties/v1/properties/{id}/v1/bookings/v1/bookings/v1/bookings/{id}/v1/tax-summary/v1/webhooks/endpoints/v1/webhooks/endpoints/v1/webhooks/endpoints/{id}SDKs für Node.js und Python, Verfügbar im Q3 2026
Konfigurieren Sie Ihre Webhooks in Dashboard > Integrationen > Webhooks
booking.createdNew booking received
booking.updatedBooking modified
tax.calculatedTax calculation completed
report.generatedFiscal report generated
HMAC-SHA256
Alle Webhook-Payloads werden mit HMAC-SHA256 signiert. Überprüfen Sie den X-VillaTax-Signature-Header mit dem Endpunkt-Secret.
Channel-Manager-Integration
Schieben Sie Buchungen aus Ihrem PMS oder Channel-Manager. Steuerberechnungen werden automatisch ausgelöst. Bauen Sie Ihre eigene Berichtsschicht darüber.
Immobilienverwaltungssoftware
Integrieren Sie steuerliche Compliance direkt in Ihre Immobilienverwaltungssoftware. Ihre Kunden erhalten indonesische Steuer-Compliance, ohne Ihre App zu verlassen.
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.