VillaTaxVillaTax
Audit Gratuit
Charlotte IATarifs
ConnexionCommencer
Audit Gratuit
AccueilFonctionnalités — Fonctionnalités VillaTax pour gérer la fiscalité d'une villa à BaliAudit GratuitTarifs
REST API · OpenAPI 3.0 · HMAC Webhooks

Documentation API

Intégrez la conformité fiscale Bali dans vos applications

12 Endpoints100 req/minHMAC-SHA256OpenAPI 3.0
Obtenir une clé API Voir la doc interactive

Bearer Auth

Clés API dans Paramètres → API. vt_live_* pour la production, vt_test_* pour le sandbox.

Limites de taux

100 requêtes/minute par clé API. Headers : X-RateLimit-Limit, X-RateLimit-Remaining.

Webhooks signés

Signature HMAC-SHA256 sur chaque payload. Retry automatique avec backoff exponentiel en cas d'échec.

OpenAPI 3.0

Spécification complète à /openapi.yaml. Utilisez openapi-generator pour créer des SDK dans n'importe quel langage.

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.

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)

Limité à 100 requêtes/minute par clé API. Headers : X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Démarrage rapide

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 }

Endpoints

Explorer les docs interactives→
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

SDK Node.js et Python, Disponibles au T3 2026

Webhooks

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

booking.created

New booking received

booking.updated

Booking modified

tax.calculated

Tax calculation completed

report.generated

Fiscal report generated

HMAC-SHA256

Tous les payloads webhook sont signés avec HMAC-SHA256. Vérifiez le header X-VillaTax-Signature avec le secret de votre endpoint.

Conçu pour les développeurs qui ont besoin de données fiscales réelles

01

Intégration Channel Manager

Poussez les réservations depuis votre PMS ou channel manager. Les calculs fiscaux se déclenchent automatiquement. Construisez votre propre couche de reporting par-dessus.

02

Logiciel de gestion immobilière

Intégrez la conformité fiscale directement dans votre logiciel de gestion immobilière. Vos clients bénéficient de la conformité fiscale indonésienne sans quitter votre app.

03

Reporting fiscal automatisé

Récupérez les résumés fiscaux via API pour générer automatiquement des rapports mensuels PBJT, PPh et PPN. Exportez vers votre système comptable avec du JSON propre.

FAQ

Prêt à intégrer VillaTax ?

Obtenir une clé API Contacter l’équipe Enterprise
PT ASIAH LEGAL JAYA
Usaha Besar • Benoa Square Lt.3 Suite 4.3 • Badung, Bali
+62-813-8798-3316
VillaTaxVillaTax

Tableau de bord de conformité fiscale pour propriétaires de villas à Bali.

Powered by OPERIUM →

Produit

Architecture produitCharlotte IAFonctionnalitésIntégrationsTarifsServicesBlogAudit GratuitDocumentation API

Fonctionnalités

RéservationsMoteur fiscalTâchesAnalytiquePersonnel & PaieComptabilitéCoretax 2026Documents

Solutions

VillasRéservation directePour les PropriétairesPour les AgencesPour les InvestisseursPour les DéveloppeursSafe HarborProgramme PartenairesCarrièresFAQContact

Légal

Politique de confidentialitéConditions généralesRGPDPolitique de remboursementÀ propos d’OPERIUM
© 2026 PT. Asiah Legal Jaya — Usaha Besar — Benoa Square Lt.3 Suite 4.3, Badung, BaliLes calculs fiscaux sont indicatifs. Consultez un consultant fiscal agréé.