Documentación para Desarrolladores

Documentación API

Integre el cumplimiento fiscal de Bali en sus aplicaciones

Obtener una clave API Contactar equipo Enterprise

Autenticación

Todas las solicitudes API requieren un Bearer token API key. Obtenga su clave desde Panel > Configuración > Claves API.

URL 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

Configure sus webhooks desde Panel > Integraciones > Webhooks

booking.created

New booking received

tax.calculated

Tax calculation completed

compliance.alert

Compliance issue detected

document.expiring

Document expiry in 30 days

¿Listo para integrar VillaTax?

Obtener una clave API Contactar equipo Enterprise

FAQ