# Peningkatan Integrasi Akun & Role Setup Accurate Online \[28 April 2026]

Halo, Kawan Simpli! 👋

Ada kabar gembira untukmu

Kami telah melakukan beberapa pembaruan penting untuk membuat pengalaman menggunakan SimpliDOTS semakin lancar dan nyaman. Berikut ringkasannya:

## **✨&#x20;**<mark style="color:red;">**What’s New**</mark>

Pembaruan ini meningkatkan keamanan, transparansi, dan keandalan integrasi antara SimpliDOTS dan Accurate Online (AOL).

Admin kini dapat melihat status koneksi secara real-time, serta mendapatkan pesan error yang lebih jelas saat terjadi kendala integrasi.

Perubahan utama mencakup:

* Validasi yang lebih ketat saat proses integrasi maupun re-integrasi (database, branch, dan akun).
* Pengelolaan token otomatis melalui auto session refresh.
* Tampilan informasi akun dan status koneksi yang lebih informatif di halaman Setting Integrasi pada SMH.
* Pesan error yang lebih spesifik untuk mempermudah identifikasi dan troubleshooting kendala integrasi.

### <mark style="color:red;">**Kenapa Perubahan Ini Dilakukan?**</mark>

Selama ini, integrasi SimpliDOTS dengan Accurate Online masih cukup sering mengalami kendala yang berdampak ke operasional user maupun proses support. Beberapa kendala yang paling sering terjadi antara lain:

* Error *“Invalid Token”* atau *“Invalid Refresh Token”* berulang karena satu akun Accurate digunakan di beberapa tenant SimpliDOTS secara bersamaan, sehingga memicu konflik sesi dan menyebabkan akun logout otomatis.
* User dan tim support belum memiliki visibilitas yang jelas terkait akun Accurate yang sedang terhubung, database dan branch yang digunakan, role akun, maupun status koneksi integrasi apakah masih aktif atau sudah expired.
* Proses troubleshooting menjadi lebih lama karena pengecekan token, session, dan status integrasi masih perlu dilakukan manual atau melalui eskalasi ke tim development.
* Masih ada risiko kesalahan saat proses integrasi maupun re-integrasi, seperti salah memilih database atau branch, yang dapat menyebabkan data transaksi masuk ke entitas yang tidak sesuai.
* Belum adanya validasi penggunaan akun ganda, sehingga satu akun Accurate masih bisa digunakan di beberapa tenant sekaligus dan terus memicu konflik token.

Karena itu, pembaruan ini dilakukan untuk meningkatkan keamanan, transparansi, serta kestabilan integrasi Accurate Online agar proses operasional dan troubleshooting bisa berjalan lebih aman dan efisien.

### <mark style="color:red;">**Contoh Kasus**</mark>

Sebuah perusahaan menggunakan 1 akun Accurate Online untuk 3 tenant SimpliDOTS sekaligus. Akibatnya, setiap kali salah satu tenant melakukan sinkronisasi, tenant lain otomatis logout karena token saling tertimpa.

Dengan pembaruan ini, sistem akan memblokir penggunaan 1 akun Accurate di lebih dari 1 tenant SimpliDOTS dan menampilkan pesan error yang lebih jelas agar kendala lebih mudah diidentifikasi.

### <mark style="color:red;">**Apa yang Baru?**</mark>

#### <mark style="background-color:blue;">1. Validasi Ketat Saat Integrasi & Re-integrasi</mark>

Sebelumnya:

* User bisa memilih database dan branch mana saja saat re-integrasi.
* Satu akun Accurate bisa dipakai di banyak tenant tanpa peringatan.
* Tidak ada pengecekan apakah database Accurate masih aktif atau sudah expired.
* Tidak ada validasi tambahan yang mencegah konflik data maupun konflik session.

Sekarang, sistem akan melakukan validasi bertahap sebelum integrasi berhasil, dimulai dari validasi akun, lalu database dan branch setelah dipilih user.

<table><thead><tr><th width="299.01995849609375">Validasi</th><th>Perilaku Sistem</th></tr></thead><tbody><tr><td>Akun Accurate berbeda dari sebelumnya</td><td><p>❌ Integrasi ditolak karena akun Accurate yang digunakan harus sama dengan akun sebelumnya.<br></p><p><img src="/files/1HLomF5IFWZF80ziI3Lh" alt="" data-size="original"></p></td></tr><tr><td>Akun Accurate sudah digunakan tenant lain</td><td><p>❌ Integrasi ditolak karena 1 akun Accurate tidak dapat digunakan di lebih dari 1 tenant SimpliDOTS untuk menghindari auto logout dan konflik session.<br></p><p><img src="/files/3uKxjHIMz5dZ86ChTFfe" alt="" data-size="original"></p></td></tr><tr><td>Aplikasi SimpliDOTS belum di-install di Accurate</td><td>❌ Integrasi ditolak dengan pesan:<br><em>"Anda memerlukan akses Administrator di Accurate untuk install aplikasi SimpliDOTS."</em></td></tr><tr><td>Database berbeda dari sebelumnya</td><td><p>❌ Integrasi ditolak karena database wajib sama dengan sebelumnya. Pergantian database dapat menyebabkan seluruh partner ID menjadi tidak valid.<br></p><p><img src="/files/BqzRCEv9eFmjmHQrfrus" alt="" data-size="original"></p></td></tr><tr><td>Database sudah dipakai tenant lain</td><td><p>❌ <strong>Ditolak</strong> — Muncul pesan:</p><blockquote><p><em>"Database and branch already connected to another tenant"</em></p></blockquote><p>Pesan error juga akan disertai informasi <strong>Username Accurate</strong> dan <strong>Database ID Accurate</strong> untuk memudahkan proses pengecekan oleh tim support.</p><p></p><p><strong>Catatan:</strong><br>1 database Accurate dapat digunakan di beberapa tenant SimpliDOTS selama masing-masing tenant menggunakan <strong>branch yang berbeda</strong>.<br>Yang tidak diperbolehkan adalah penggunaan <strong>database dan branch yang sama</strong> pada lebih dari 1 tenant, karena dapat menyebabkan konflik data transaksi.</p></td></tr><tr><td>Database expired</td><td><p>❌ <strong>Ditolak</strong> — Muncul error:</p><blockquote><p><em>401 Unauthorized</em></p></blockquote><p>Hal ini menandakan bahwa akses database Accurate sudah tidak aktif atau masa akses integrasinya telah berakhir.</p></td></tr><tr><td>Branch berbeda dari sebelumnya</td><td><p>❌ <strong>Ditolak</strong> karena branch yang dipilih wajib sama dengan branch yang sebelumnya sudah terhubung.</p><p></p><p>Aturan ini diterapkan untuk mencegah perubahan branch yang dapat menyebabkan data transaksi masuk ke cabang yang tidak sesuai dan menimbulkan ketidaksesuaian data pada Accurate.</p><p><br></p><p><img src="/files/zKArMQIdI2B9HXKJofoN" alt="" data-size="original"></p></td></tr><tr><td>Branch sudah dipakai branch/tenant lain</td><td><p>❌ <strong>Ditolak</strong> karena branch yang dipilih sudah digunakan oleh branch atau tenant lain.</p><p></p><p><strong>Catatan:</strong><br>Setiap branch wajib bersifat unik dalam satu database Accurate untuk menghindari konflik serta ketidaksesuaian data transaksi antar tenant maupun cabang.</p></td></tr></tbody></table>

**Catatan**

* Jika user ingin mengganti **database** atau **branch**, maka perlu menghubungi tim **Customer Success (CS)** untuk dibantu proses **reset data** terlebih dahulu. Hal ini dilakukan untuk menjaga konsistensi integrasi serta mencegah ketidaksesuaian data transaksi pada Accurate.
* Pada halaman **Generate Model Template**, pilihan **branch** kini sudah dihilangkan.\
  Sistem akan otomatis menggunakan **branch yang sama dengan integrasi sebelumnya**, sehingga user tidak perlu memilih branch kembali secara manual.\
  \
  Perubahan ini bertujuan untuk:
  * Mengurangi risiko salah pilih branch.
  * Menjaga konsistensi data integrasi.
  * Meminimalkan potensi transaksi masuk ke cabang yang tidak sesuai di Accurate

#### <mark style="background-color:blue;">2. Informasi Identitas Akun & Status Koneksi Real-time</mark>

**Sebelumnya**

* Tidak ada informasi akun Accurate yang sedang terhubung.
* Tidak ada indikator status koneksi integrasi.
* User tidak mengetahui apakah token integrasi masih valid atau sudah expired.

**Sekarang**

* Halaman **Setting > Integrasi** di SMH kini menampilkan informasi akun Accurate yang terhubung secara lebih lengkap dan real-time.

<table><thead><tr><th width="262.259521484375">Informasi</th><th>Detail</th></tr></thead><tbody><tr><td>Username (Name)</td><td>Nama akun Accurate yang terhubung</td></tr><tr><td>Email</td><td>Email akun Accurate yang terhubung</td></tr><tr><td>Role</td><td>Administrator atau Operator</td></tr><tr><td>Database</td><td>Nama database Accurate yang terhubung</td></tr><tr><td>Branch</td><td>Nama branch Accurate yang terhubung</td></tr><tr><td>Last Connected</td><td>“Terakhir terhubung: [email] pada [timestamp]”</td></tr><tr><td>Last Sync</td><td>Waktu sinkronisasi terakhir</td></tr><tr><td>Status Koneksi</td><td>Badge status koneksi secara real-time</td></tr></tbody></table>

![](/files/6nbQocRJBArZpFjJSrfM)

![](/files/oaUhgS94HzBdeaRNrbBt)

**Catatan**

* Jika tenant belum menampilkan informasi identitas akun, kemungkinan token atau session Accurate masih menggunakan versi lama.
* Agar informasi akun dapat tampil, silakan lakukan **Re-integrasi** atau **Reconnect** pada menu integrasi.

#### <mark style="background-color:blue;">3. Manual Refresh untuk Session Integrasi</mark>

Sebelumnya, sistem sudah mendukung **automatic session refresh**, di mana ketika token atau sesi Accurate expired, sistem akan mencoba memperbarui token secara otomatis di belakang layar.

Pada pembaruan kali ini, tersedia tombol **Refresh Status** pada halaman **Setting > Integrasi** untuk melakukan pengecekan dan penyegaran sesi secara manual.

Fitur ini berguna apabila user ingin memastikan kondisi integrasi tanpa perlu menunggu proses otomatis dari sistem.

Jika seluruh proses refresh (otomatis maupun manual) gagal, maka status integrasi akan berubah menjadi:

> 🔴 Koneksi Terputus

Dan sistem akan menampilkan notifikasi:

> “Sesi integrasi telah habis. Silakan hubungkan ulang akun Anda melalui menu integrasi.”

#### <mark style="background-color:blue;">4. Integration Monitoring & Maintenance</mark>

**Sebelumnya**

* Tidak ada cara untuk mengecek kondisi integrasi tanpa melakukan sinkronisasi data.

**Sekarang**

* Tersedia dua aksi maintenance baru pada halaman **Setting > Integrasi**:

<table><thead><tr><th width="199.0477294921875">Aksi</th><th>Fungsi</th></tr></thead><tbody><tr><td>Refresh Status</td><td>Mengecek apakah koneksi Accurate masih aktif tanpa memproses data apa pun.</td></tr><tr><td>Reconnect</td><td>Menghubungkan ulang akun Accurate apabila koneksi sudah terputus.</td></tr></tbody></table>

#### <mark style="background-color:blue;">5. Penanganan Error yang Lebih Baik saat Sinkronisasi</mark>

**Sebelumnya**

* Sync gagal tanpa pesan error yang jelas.
* Token expired tidak terdeteksi otomatis.
* Banyak error terjadi ketika role atau permission Accurate tidak lengkap.

**Sekarang**

| Kondisi                                                                           | Perilaku Sistem                                                                                                                                                                                                    |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Token expired — “Invalid refresh token”                                           | <p>Sinkronisasi dihentikan, status berubah menjadi <strong>Koneksi Terputus</strong>, dan user wajib melakukan re-integrasi.<br><br></p><p><img src="/files/2GOSgMEupKIV3zRh9Np8" alt="" data-size="original"></p> |
| Tidak memiliki akses — misalnya: “Anda tidak memiliki hak Buat Pesanan Penjualan” | <p>Sinkronisasi item terkait dilewati dan pesan error akan ditampilkan.<br></p><p><img src="/files/h33YOIScMMwhmAehl04Z" alt="" data-size="original"></p>                                                          |
| Accurate tidak dapat diakses — “Connection timed out”                             | Sinkronisasi dijeda sementara dan sistem akan melakukan retry otomatis.                                                                                                                                            |
| Accurate sedang maintenance (503)                                                 | Sistem menampilkan informasi: “Accurate sedang maintenance, sinkronisasi akan retry dalam 10 menit”.                                                                                                               |
| Rate limit (429) — “Jumlah request API melebihi toleransi”                        | Sistem menunggu selama 60 detik dan melakukan retry otomatis hingga 3 kali. Jika masih gagal, notifikasi akan ditampilkan ke user.                                                                                 |

#### <mark style="background-color:blue;">6. Pengaturan Delivery Order, SI/CP, dan CoA Kini Terpusat di Detail Integrasi</mark>

**Sebelum**

Sebelumnya, pengaturan:

* Delivery Order
* Integrasi SI/CP
* CoA Pembayaran Default

sudah tersedia, namun lokasinya tersebar di beberapa halaman berbeda.

**Sekarang**

Seluruh pengaturan tersebut dipusatkan pada satu halaman:

> **Setting > Integrasi > Detail**

Perubahan ini bertujuan agar proses setup integrasi Accurate menjadi lebih mudah, terstruktur, dan konsisten dalam satu alur konfigurasi.

### <mark style="color:red;">**Aturan / Ketentuan & Batasan**</mark>

| Kondisi                                 | Perilaku Sistem                                                                                         |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| 1 akun SimpliDOTS = 1 Database Accurate | Tidak dapat memilih database berbeda dari sebelumnya.                                                   |
| 1 akun SimpliDOTS = 1 Branch Accurate   | Tidak dapat memilih branch berbeda dari sebelumnya.                                                     |
| 1 akun Accurate = 1 Tenant SimpliDOTS   | Akun Accurate yang sudah digunakan tenant lain akan ditolak.                                            |
| 1 Branch = 1 Tenant                     | Branch yang sudah digunakan tenant lain akan ditolak.                                                   |
| Setelah integrasi aktif                 | Database & Branch tidak dapat diganti tanpa bantuan tim Customer Success atau tim Developer SimpliDOTS. |
| Token expired > 30 hari                 | User wajib melakukan re-integrasi manual.                                                               |

### <mark style="color:red;">**Cara Menggunakan**</mark>

| Judul                                    | Panduan                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Melihat Status Integrasi                 | <p></p><ul><li>Login ke SMH menggunakan akun Admin.</li><li>Buka menu <strong>Setting</strong>.</li><li>Klik tab <strong>Integrasi</strong>.</li><li>Lihat badge status koneksi dan informasi akun Accurate yang terhubung.</li></ul>                                                                                                                                                                    |
| Melakukan Refresh Status                 | <p></p><ul><li>Buka <strong>Setting > Integrasi</strong> di SMH.</li><li>Klik tombol <strong>Refresh Status</strong>.</li><li>Sistem akan mengecek validitas token dan ketersediaan API Accurate.</li><li>Hasil pengecekan akan ditampilkan dalam bentuk badge status terbaru.</li></ul>                                                                                                                 |
| Melakukan Reconnect (Jika Token Expired) | <p></p><ul><li>Buka <strong>Setting > Integrasi</strong> di SMH.</li><li>Jika status menunjukkan 🔴 <strong>Koneksi Terputus</strong>, klik tombol <strong>Reconnect</strong>.</li><li>Sistem akan mengarahkan ke halaman OAuth Accurate.</li><li>Berikan persetujuan ulang untuk integrasi.</li><li>Setelah berhasil, status berubah menjadi 🟢 <strong>Terhubung & Aktif</strong>.</li></ul>           |
| Melakukan Re-integrasi Akun              | <p></p><ul><li>Login ke Accurate menggunakan akun yang sama seperti sebelumnya.</li><li>Login ke SMH.</li><li>Buka menu <strong>Setting > Integrasi</strong>.</li><li>Pilih kembali partner Accurate.</li><li>Pilih database yang sama seperti sebelumnya.</li><li>Pilih branch yang sama seperti sebelumnya.</li><li>Klik <strong>Lanjutkan</strong> untuk menyelesaikan proses re-integrasi.</li></ul> |

### <mark style="color:red;">**FAQ**</mark>

| Question                                                                         | Answer                                                                                                                                                                                                                                                                        |
| -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Apakah user yang sudah terintegrasi perlu melakukan sesuatu setelah release ini? | Tidak selalu. Re-integrasi hanya diperlukan apabila sistem menampilkan informasi bahwa token atau kredensial integrasi sudah tidak valid.                                                                                                                                     |
| Bagaimana jika saya ingin mengganti database atau branch Accurate?               | Saat ini perubahan database atau branch tidak dapat dilakukan langsung oleh user. Silakan hubungi tim CS untuk proses reset data dan konfigurasi ulang.                                                                                                                       |
| Kenapa muncul pesan “Akun Accurate sudah digunakan oleh tenant lain”?            | Akun Accurate yang digunakan sudah aktif pada tenant SimpliDOTS lain. Setiap tenant wajib menggunakan akun Accurate yang berbeda (dedicated account).                                                                                                                         |
| Apa yang terjadi jika Accurate sedang maintenance saat proses sync?              | Sistem akan menampilkan notifikasi bahwa Accurate sedang maintenance dan sinkronisasi akan otomatis dicoba kembali dalam 10 menit.                                                                                                                                            |
| Apakah data aman jika token expired?                                             | Ya, data tetap aman. Tidak ada data yang hilang ataupun corrupt. Hanya proses sinkronisasi yang akan berhenti sementara sampai token diperbarui.                                                                                                                              |
| Saya ingin re-integrasi ke database baru yang belum pernah dipakai. Apakah bisa? | Tidak bisa. Database yang dipilih saat re-integrasi wajib sama dengan database sebelumnya. Jika ingin mengganti database, silakan hubungi tim CS untuk proses reset data.                                                                                                     |
| Apa perbedaan Refresh Status dan Reconnect?                                      | <p></p><ul><li><strong>Refresh Status</strong> hanya melakukan pengecekan kondisi koneksi tanpa mengubah apa pun.</li><li><strong>Reconnect</strong> melakukan proses OAuth ulang untuk mendapatkan token baru dan digunakan saat status sudah 🔴 Koneksi Terputus.</li></ul> |

Selamat mencoba, Kawan Simpli!

> *Jangan ragu untuk menghubungi tim Customer Success Kami jika ada pertanyaan atau memerlukan bantuan. Kami siap membantu, Kawan Simpli! Terima kasih telah memilih SimpliDOTS. Kami berkomitmen untuk terus meningkatkan experience Kawan Simpli dalam menggunakan SimpliDOTS.*

<figure><img src="https://fitur-sap.simplidots.id/~gitbook/image?url=https%3A%2F%2F2844923736-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FOSQCfcS0Gg4MdBScldLm%252Fuploads%252FAHNjMu0M4DDPnzUEnKFM%252Fimage.png%3Falt%3Dmedia%26token%3D1af343c9-4d06-4dd3-9f37-7d0fb85d2d9a&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=745c4c48&#x26;sv=2" alt="" width="188"><figcaption><p>Salam Hangat<br>- Androsim -</p></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://fitur-sap.simplidots.id/smh/fitur-pada-smh-sales-management-hub/2026/peningkatan-integrasi-akun-and-role-setup-accurate-online-28-april-2026.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.