Documentation Développeur

Documentation API

Intégrez la conformité fiscale Bali dans vos applications

Obtenir une clé API Contacter l’équipe Enterprise

Authentification

Toutes les requêtes API nécessitent un Bearer token API key. Obtenez votre clé depuis le tableau de bord → Paramètres → API Keys.

URL de Base
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 }

Endpoints

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

Configurez vos webhooks depuis le tableau de bord → Intégrations → Webhooks

booking.created

New booking received

tax.calculated

Tax calculation completed

compliance.alert

Compliance issue detected

document.expiring

Document expiry in 30 days

Prêt à intégrer VillaTax ?

Obtenir une clé API Contacter l’équipe Enterprise

FAQ