# Cara Integrasi dengan DMS, SAP, atau External

Fitur Integrasi secara garis besar merupakan aplikasi-aplikasi yang terhubung dengan portal distributor. Aplikasi/Integrasi ini terbagi
 menjadi 3 jenis yaitu: **DMS, SAP, External (Cloud).**

\
Untuk membuat integrasi, dapat mengikuti langkah berikut.

**Step 1.** Buka tab **Integrations & Connections**.

**Step 2.** Pilih “**Add new**” pada sudut kanan atas, kemudian memilih menu “**Integration**”.

<figure><img src="https://3837174706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ML6LhsHx5TJpV4GOuvJ%2Fuploads%2FZ6IxNSJGLSYDGkJ9s18n%2Fimage.png?alt=media&#x26;token=33437828-0675-49f4-bc60-e40a46c04fde" alt=""><figcaption></figcaption></figure>

**Step 3.** Pilih jenis aplikasi yang diinginkan pada *popup* yang muncul.

<figure><img src="https://3837174706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ML6LhsHx5TJpV4GOuvJ%2Fuploads%2F5IYXPIJMyfobIARvGHIv%2Fimage.png?alt=media&#x26;token=c2e05f5e-d0c4-47a9-b196-9b4b94d90038" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Hal yang harus diperhatikan!**

Sebelum membuat integrasi, ada beberapa hal yang perlu diperhatikan:

* 1 akun Distributor portal hanya dapat melakukan/memiliki maksimal 1 integrasi DMS.
* 1 akun Distributor portal dapat melakukan/memiliki banyak integrasi Cloud.
  {% endhint %}

1. **External**

Untuk membuat integrasi **External**, klik tombol “**Connect**” pada bagian External, maka Integrasi akan langsung terbuat. Integrasi
&#x20;kemudian dapat digunakan saat membuat **Connection** atau saat melakukan Import/Export data.

2. **DMS**

Untuk memulai integrasi dengan DMS, klik tombol **“Connect”** pada bagian **SimpliDOTS: DMS**. Setelah tombol diklik, sistem akan secara otomatis membuat koneksi integrasi tersebut.

Namun, untuk saat ini, pembuatan integrasi memerlukan bantuan dari tim developer guna menetapkan **AccessKey**, karena fitur ini belum tersedia langsung di portal.

**AccessKey** merupakan kombinasi dari **TenantId DMS** yang akan diintegrasikan dan nilai dari konfigurasi default setting berikut:

* Name: `PRINCIPAL_ACCESS_KEY`
* Nilai: ditentukan secara bebas oleh pengguna di DMS

Format penulisan AccessKey adalah:

`{TenantId}-{PRINCIPAL_ACCESS_KEY}`

Contoh:

`446-bebaspakaivalueapapun`\\

\
Setelah proses integrasi berhasil, sistem akan secara otomatis menghasilkan **Model Template** yang diperlukan untuk pemetaan data dari DMS ke dalam format yang dapat dikenali dan digunakan oleh portal (proses konsolidasi data). Dengan demikian, pengguna tidak perlu membuat model mapper secara manual.

<figure><img src="https://3837174706-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ML6LhsHx5TJpV4GOuvJ%2Fuploads%2FQ0vO1PLW5T7UqZLH89tK%2Fimage.png?alt=media&#x26;token=218bbd9b-1f23-4fb3-9c65-969348e574b6" alt=""><figcaption></figcaption></figure>