# Integrasi Open API

Dengan integrasi ini, Anda tidak perlu lagi menginput data-data produk, daftar customer, stok, harga secara manual di SalesMania. Bila ada orderan yang diinput oleh team lewat aplikasi SalesMania, data order tersebut juga bisa langsung masuk ke sistem Anda.

## <mark style="color:orange;">Manfaat Integrasi Open API</mark>

* Tidak perlu input data pelanggan atau produk dua kali di dua sistem berbeda.
* Order dari Salesmania otomatis masuk ke sistem internal Anda.
* Data stok, harga, dan produk bisa selalu sinkron.
* Proses order lebih cepat, akurat, dan minim kesalahan.
* Cocok jika Anda sudah punya sistem sendiri, baik online maupun offline.

Dengan demikian, operasional bisnis menjadi lebih efisien, akurat, dan minim kesalahan input manual. Data order yang masuk dari SalesMania bisa langsung otomatis masuk ke sistem internal Anda.

{% hint style="warning" %}
Integrasi Open API akan **membutuhkan ressource tenaga IT** dari sisi Anda, untuk support implementasi dan pengujian API. Dokumentasi Open API bisa dilihat di [sini](https://apidoc.salesmania.id).
{% endhint %}

Berikut daftar data-data yang tersinkronisasi antara SalesMania dan sistem Internal Anda:

<table><thead><tr><th width="219.484375">Jenis Data</th><th width="131.98567708333331">Arah Data</th><th>Keterangan</th></tr></thead><tbody><tr><td>Customer, Product, Stok, Team</td><td>Internal -> SM</td><td>Tim IT Anda bisa menggunakan Open API untuk otomatis mengisi data dari sistem internal ke SalesMania. Demikian juga bila ada update di sistem internal bisa langsung disinkronkan ke SM.</td></tr><tr><td>Sales Order</td><td>SM -> Internal</td><td>Setiap ada orderan, SalesMania akan otomatis submit data orderan tersebut ke URL yang sudah disiapkan tim IT Anda, sehingga bisa langsung masuk ke sistem Anda.</td></tr><tr><td>Sales Order</td><td>Internal -> SM</td><td>Opsional, digunakan untuk memasukkan history order pelanggan, dari sistem internal Anda ke SM. </td></tr><tr><td>Customer</td><td>SM -> Internal</td><td>Saat ada penambahan customer baru dari App, SalesMania akan otomatis submit data customer baru tersebut ke URL yang sudah disiapkan tim IT Anda, sehingga bisa langsung masuk ke sistem Anda. (Opsional)</td></tr></tbody></table>

## <mark style="color:orange;">Alur Open API</mark>

<figure><img src="https://309432527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAIUbSvnaF8M7UqbRPQ5n%2Fuploads%2Fxpk7JGEQxoRVgPzsokmF%2Fimage.png?alt=media&#x26;token=d8c89cdb-6be6-4272-a3a2-d6886d929412" alt=""><figcaption><p>CRUD: Create Read Update Delete</p></figcaption></figure>

## <mark style="color:orange;">Sinkronisasi dari SM ke Sistem Internal</mark>

Menggunakan **webhook** sebagai mekanisme push dari SalesMania ke sistem internal Ada saat terjadi event tertentu seperti ada order baru dan penambahan customer baru dari app SalesMania. Sistem Internal Anda harus menyediakan **endpoint (URL)** yang dapat menerima data dengan format **JSON** dari SM.

## <mark style="color:orange;">Cara Aktivasi Open API</mark>

Untuk mengaktifkan integrasi Open API, sebaiknya dimulai dengan database SalesMania yang masih kosong. Cara membuat database baru bisa ditemukan di[ <mark style="color:orange;">sini</mark>](https://docs.salesmania.id/getting-started-in-5-minutes).

Selanjutnya kita lakukan proses integrasi sebagai berikut:

* Tekan tombol :gear: kemudian pilih `Settings` -> `Integration` -> `Open API`
* Masukkan URL webhook Anda untuk menerima data orderan/customer baru (Opsional)\
  \- Pilih methode authentication untuk webhook Anda (default: None atau tanpa autentifikasi)
* Pilih event webhook yang ingin Anda dapatkan (Order dan/atau Customer)
* Klik Simpan.

Arahkan tim IT Anda ke [link ini ](https://apidoc.salesmania.id)untuk mencoba akses OpenApi menggunakan username/password SalesMania di database SM Anda.

{% hint style="info" %}
Aktivasi OpenAPI akan menambahkan biaya open API sebesar Rp 10,000 per team ke dalam billing SalesMania Anda.
{% endhint %}

## <mark style="color:orange;">Dokumentasi Teknis Open API</mark>

Untuk informasi endpoint, parameter, format data, contoh penggunaan, dan panduan untuk developer / tim IT Anda, silakan akses dokumentasi lengkap di [<mark style="color:orange;">apidoc.salesmania.id</mark>](https://apidoc.salesmania.id/)

## <mark style="color:orange;">Cara Menonaktifkan Open API</mark>

Kapan pun bisa dinonaktifkan lewat `Settings` -> `Integration` -> `Open API -> Delete Open API`. Setelah dinonaktifkan, sistem Anda tidak bisa lagi mengakses data dari SalesMania.

{% hint style="info" %}
Menghapus integrasi tidak menghapus data apapun di SalesMania. Tapi koneksi dengan sistem internal Anda akan terputus, jadi tidak akan ada lagi update data dari sistem internal Anda, dan orderan yang masuk di SalesMania tidak akan diteruskan ke sistem internal Anda.&#x20;

\
Bila ingin kembali melanjutkan integrasi, silahkan menjalankan langkah-langkah di [<mark style="color:orange;">atas</mark>](#cara-setting-open-api).
{% endhint %}