> 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-koneksi-dengan-principal.md).

# Cara Koneksi dengan Principal

Seperti yang dijelaskan pada bagian *Principal*, **Connection** merupakan fitur yang digunakan untuk menghubungkan antara Principal dan Distributor. Melalui koneksi ini, Principal dapat mengakses data yang telah diizinkan oleh Distributor.

Untuk dapat menggunakan Smart Portal dan melihat laporan, Principal wajib memiliki setidaknya **satu koneksi aktif dengan Distributor**.

Sementara itu, satu Distributor dapat terhubung dengan beberapa Principal sekaligus. Setiap Principal yang telah diberikan akses dapat melihat data milik Distributor melalui fitur laporan (*report*) di portal.

#### Untuk membuat koneksi (dari Distributor), dapat mengikuti langkah berikut:

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

**Step 2.** Pilih “**Add New”** pada sudut kanan atas, kemudian pilih
 “**Connection**”. 

<figure><img src="/files/fUh3hLV2IzixKxwQKrYT" alt=""><figcaption><p>Menu/Page Integrations &#x26; Connections</p></figcaption></figure>

**Step 3.** Kemudian pilih nama **Integration** dan **Principal** **Key** pada *popup* seperti pada gambar.

<figure><img src="/files/tBgbOejL5E34f4i92WYd" alt=""><figcaption><p>Generate Connection Link (Distributor)</p></figcaption></figure>

**Pengaturan Akses Data oleh Distributor**

Setelah pop-up muncul, Distributor akan diminta untuk memilih jenis integrasi (aplikasi) yang datanya akan dibagikan atau diberikan akses kepada Principal yang akan terkoneksi.

Selanjutnya, Distributor juga perlu mengisi **PrincipalKey**. Nilai **PrincipalKey** ini akan bergantung pada tipe integrasi yang dipilih:

* **Jika tipe integrasi adalah&#x20;*****External***:\
  Nilai **PrincipalKey** dapat diisi secara bebas, karena tidak akan digunakan oleh sistem. Ke depannya, kemungkinan field ini akan dihapus agar tidak menimbulkan kebingungan bagi pengguna.
* **Jika tipe integrasi adalah&#x20;*****DMS***:\
  Nilai **PrincipalKey** harus diisi dengan **SupplierId** dari sistem DMS. *Supplier* di sini merujuk pada Principal yang akan melakukan koneksi dengan Distributor.

  **Contoh:** Jika Principal yang akan menggunakan portal adalah *Principal A*, maka cari data *Supplier* atas nama *Principal A* di DMS (perlu diperhatikan bahwa nama bisa saja berbeda), kemudian ambil **Id Supplier** tersebut dan masukkan ke dalam field **PrincipalKey**.

**Step 4.** Tunggu proses pembuatan persetujuan koneksi seperti berikut.

<figure><img src="/files/91tgPmrK2QTvrXynFzzK" alt=""><figcaption><p>Connection Link Generated (Distributor)</p></figcaption></figure>

Setelah semua data diisi dan tombol **Create** diklik, sistem akan secara otomatis menghasilkan sebuah link khusus. Link ini kemudian dapat dibagikan kepada **Principal** yang bersangkutan.

Ketika link tersebut diakses oleh Principal (yang sudah login), akan muncul pop-up di halaman mereka untuk menyetujui permintaan koneksi dari Distributor. Proses ini merupakan lanjutan dari mekanisme yang sudah dijelaskan sebelumnya pada bagian mengenai pihak Principal.

Perlu dicatat: link ini **hanya dapat diakses oleh Principal yang telah melakukan login** ke dalam sistem.

<figure><img src="/files/e1tUsRfh5TXNmbb9awmr" alt=""><figcaption><p>Create Connection by Distributor (link dari Principal)</p></figcaption></figure>

Selain link yang dibuat oleh Principal, sistem juga memungkinkan **Distributor** untuk membuat link koneksi yang kemudian dapat diakses oleh **Principal**.

Sama seperti sebelumnya, link ini **hanya dapat diakses oleh Principal yang telah login** ke dalam sistem. Setelah Principal berhasil login dan mengakses link tersebut, portal akan menampilkan halaman khusus untuk proses persetujuan atau pengelolaan koneksi dengan Distributor.

Proses yang dilakukan oleh Distributor serupa dengan saat melakukan pembuatan link, yaitu memilih jenis **Integrasi** dan mengisi **PrincipalKey**. Harap mengikuti panduan yang telah dijelaskan sebelumnya terkait pengisian data ini.

Setelah koneksi berhasil dibuat (melalui opsi **Allow access**), jika ingin memutuskan koneksi, hal tersebut dapat dilakukan melalui action menu "**Disconnect Connection**" yang terletak di sebelah kanan tabel, seperti yang terlihat pada gambar.

<figure><img src="/files/nGTLOvLCECcWbnFIwXyR" alt=""><figcaption><p>Disconnect Connection</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://panduan-sap.simplidots.id/smart-portal/smart-portal-distributor/cara-koneksi-dengan-principal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.