Sambungkan Erzap ke sistem apa pun yang Anda pakai
Setiap penjualan, perubahan stok, atau pelanggan baru di Erzap dapat dikirim otomatis ke aplikasi Anda lewat webhook bertanda tangan. Sebaliknya, aplikasi Anda dapat membaca produk dan stok serta membuat pesanan lewat REST API, dan asisten AI dapat membaca data bisnis lewat MCP.
POST https://aplikasi-anda.com/erzap-webhookpayload
{
"event_id": "penjualan.lunas:go_123:penjualan_98765",
"event_type": "penjualan.lunas",
"api_version": "v1",
"created_at": "2026-10-28T10:15:30+08:00",
"data": {
"no_faktur": "FJ-2610-0153",
"outlet_own": { "nama": "Cabang Denpasar" },
"total_faktur": 150000,
"penjualan_details": [ { "produk": { "nama": "Kopi Susu 1L" }, "jumlah": 2 } ]
}
}
# header yang dikirim bersama payload
X-Erzap-Event-Type: penjualan.lunas
X-Erzap-Timestamp: 1761617730
X-Erzap-Signature: t=1761617730,v1=<HMAC-SHA256>Data penjualan disalin manual ke sistem gudang atau akuntansi lain setiap sore.
Aplikasi mitra harus menebak kapan stok berubah, sehingga terus-menerus menanyakan data yang sama.
Integrasi buatan sendiri berhenti diam-diam saat server tujuan sempat mati, dan tidak ada yang tahu data mana yang hilang.
Event yang dikirim begitu terjadi di Erzap
Pilih event yang Anda butuhkan. Setiap event dapat diarahkan ke endpoint yang berbeda, misalnya event penjualan ke sistem A dan event pelanggan ke sistem B. Isinya sudah lengkap dengan data produk, pelanggan, outlet, dan gudang, bukan sekadar ID.
Penjualan
penjualan.dibuatpenjualan.lunaspenjualan.dibatalkanretur_penjualan.dibuatStok
stok.berubahstok.menipispemindahan_barang.selesaistok_opnam.selesaiProduk
produk.dibuatproduk.diperbaruiproduk.harga_berubahPesanan Penjualan
pesanan_penjualan.dibuatpesanan_penjualan.dikonfirmasipesanan_penjualan.dibatalkanPenawaran
penawaran_penjualan.status_berubahPengiriman
pengiriman_barang.dibuatpengiriman_barang.status_berubahPelanggan
pelanggan.dibuatpelanggan.diperbaruipelanggan.saldo_berubahPembelian
faktur_pembelian.dibuatfaktur_pembelian.lunaspenerimaan_barang.dibuatretur_pembelian.dibuatGrup berikut sedang disiapkan: KeuanganApprovalServisWork OrderKomisi Agen
Dirancang supaya tidak ada data yang hilang diam-diam
Tanda tangan HMAC-SHA256
Setiap kiriman ditandatangani dengan secret milik endpoint Anda beserta timestamp, sehingga aplikasi Anda dapat memastikan data benar-benar dari Erzap.
Kirim ulang otomatis
Kiriman yang gagal dicoba lagi sampai 6 kali dengan jeda yang makin panjang.
Endpoint bermasalah diistirahatkan
Setelah 10 kegagalan berturut-turut, endpoint dijeda 15 menit supaya server Anda tidak dibanjiri kiriman.
Log kiriman
Lihat 50 kiriman terakhir beserta payload dan header-nya, lalu kirim ulang satu per satu bila diperlukan.
Kirim Test
Uji endpoint dengan event webhook.ping sebelum menyalakannya untuk data sungguhan.
Retensi yang jelas
Isi payload dihapus setelah 30 hari, log yang berhasil setelah 90 hari, dan log yang gagal setelah 180 hari.
Tiga pintu integrasi
Webhook Outbound
- Diatur di General Setting, tab Integration, kartu Webhook Outbound
- Dokumentasi tersedia langsung dari kartu tersebut
- Aplikasi yang menulis langsung ke database dapat memicu ulang event lewat endpoint trigger
REST API
- Token JWT berlaku 1 jam, diminta dengan user, password, dan token perusahaan
- Outlet, stok per gudang, produk dengan cursor dan filter waktu perubahan, serta kategori produk
- Membuat dan membatalkan Pesanan Penjualan
- Dokumentasi Swagger
MCP untuk AI
- Sambungkan Claude atau aplikasi AI lain ke data Erzap
- 70 alat baca untuk stok, penjualan, piutang, laporan keuangan, pelanggan, pembelian, dan lainnya
- Tidak ada alat yang mengubah data, dan akses mengikuti hak user
- Login lewat OAuth 2.1 dengan PKCE atau token MCP per user
Ketersediaan di paket Erzap
- Webhook Outbound adalah layanan tambahan berbayar yang diaktifkan oleh tim Erzap untuk perusahaan Anda, dan tersedia di cloud maupun Private Server.
- MCP untuk AI dan login OAuth-nya hanya tersedia di Paket Enterprise yang dipasang di server Anda sendiri.
- Grup event Keuangan, Approval, Servis, Work Order, dan Komisi Agen masih disiapkan.
- Pengiriman webhook menjamin setiap event sampai paling tidak sekali, tetapi urutan kedatangannya tidak dijamin. Gunakan event_id untuk mencegah data ganda.
Bagian dari satu sistem ERP
Integrasi bekerja di atas data yang sama dengan modul-modul berikut.
Pertanyaan yang sering diajukan
Bagaimana memastikan webhook benar-benar dari Erzap?
Hitung HMAC-SHA256 dari timestamp dan isi payload memakai secret endpoint Anda, lalu bandingkan dengan nilai v1 di header X-Erzap-Signature.
Apa yang terjadi bila server kami sedang mati?
Erzap mencoba mengirim ulang sampai 6 kali dalam rentang 24 jam lebih. Kiriman yang tetap gagal tercatat di log dan dapat dikirim ulang secara manual.
Apakah bisa menerima event dua kali?
Bisa, karena pengiriman menjamin paling tidak sekali. Simpan event_id yang sudah diproses supaya event yang sama tidak diproses ulang.
Apakah AI yang tersambung lewat MCP bisa mengubah data?
Tidak. Semua alat MCP hanya membaca data, dan data yang terlihat mengikuti hak akses user pemilik token.
Biarkan sistem Anda saling bicara
Ceritakan aplikasi yang ingin Anda sambungkan, dan tim kami bantu memilih jalurnya: webhook, REST API, atau MCP.
Erzap sudah melayani UKM Indonesia selama 14+ tahun sejak 2012, dengan lebih dari 5.000 pengguna aktif.
