Dokumentasi ini masih dalam pengembangan dan mungkin belum sepenuhnya mencerminkan cara kerja aplikasi. Bergabung di forum untuk bertanya dan berbagi masukan →

REST API

Basis menyediakan REST API berbasis JSON untuk integrasi dengan aplikasi eksternal, otomasi entri data, dan pembuatan laporan kustom.

Autentikasi

API menggunakan autentikasi Bearer token.

Membuat API Key

Buka Pengaturan → API Keys → Baru.
Beri nama key (misal "Integrasi ERP").
Atur tanggal kedaluwarsa (opsional).
Salin key — hanya ditampilkan satu kali.

Menggunakan Token

Sertakan token di setiap header request:

Authorization: Bearer API_KEY_ANDA

Base URL

https://domain-anda.com/api/v1

Untuk edisi Cloud: https://app.basis-apps.net/api/v1

Endpoint Umum

Relasi

Metode	Endpoint	Keterangan
GET	`/parties`	Daftar relasi
GET	`/parties/{id}`	Ambil satu relasi
POST	`/parties`	Buat relasi baru
PUT	`/parties/{id}`	Perbarui relasi

Faktur Penjualan

Metode	Endpoint	Keterangan
GET	`/sales-invoices`	Daftar faktur
GET	`/sales-invoices/{id}`	Ambil satu faktur
POST	`/sales-invoices`	Buat faktur baru
POST	`/sales-invoices/{id}/post`	Posting faktur draft
POST	`/sales-invoices/{id}/void`	Void faktur yang sudah diposting

Penerimaan

Metode	Endpoint	Keterangan
GET	`/receipts`	Daftar penerimaan
POST	`/receipts`	Buat dan posting penerimaan

Item

Metode	Endpoint	Keterangan
GET	`/items`	Daftar item
GET	`/items/{id}`	Ambil satu item
POST	`/items`	Buat item baru

Format Request / Response

Semua request dan response menggunakan application/json.

Contoh — Membuat Faktur Penjualan

Request:

POST /api/v1/sales-invoices
Authorization: Bearer API_KEY_ANDA
Content-Type: application/json

{
  "date": "2026-05-01",
  "customer_id": "party-uuid",
  "due_date": "2026-05-31",
  "lines": [
    {
      "item_id": "item-uuid",
      "qty": 5,
      "unit_price": 100000,
      "tax_category": "VAT11"
    }
  ]
}

Response:

{
  "id": "inv-uuid",
  "invoice_number": "INV-2026-0042",
  "status": "draft",
  "total": 555000,
  "tax": 55000
}

Batas Rate

Paket	Request per menit
Server (per instalasi)	600
Cloud Starter	120
Cloud Professional	600
Cloud Enterprise	Tidak terbatas

Webhook

Konfigurasi webhook untuk menerima notifikasi real-time saat dokumen dibuat atau status berubah:

Buka Pengaturan → Webhook → Baru.
Masukkan URL endpoint Anda.
Pilih event yang ingin dilanggani.
Basis mengirimkan POST dengan payload JSON ke URL Anda.

SDK

SDK TypeScript/JavaScript resmi tersedia:

npm install @basis-apps/sdk

Lihat dokumentasi SDK di GitHub.

Terkait

Verifikasi Unduhan