> For the complete documentation index, see [llms.txt](https://panduan-sap.simplidots.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://panduan-sap.simplidots.id/smart-portal/smart-portal-distributor/cara-integrasi-dengan-dms-sap-atau-external.md).

# 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="/files/4sAcCUL3y8VgLFbbTAnL" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/4O6k40M3Rvx12pjoKDdL" 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="/files/7Xur1kyOby5wrw4PgTAD" alt=""><figcaption></figcaption></figure>