> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Model Data Bisnis: Skema KYB Didit

> Model entitas bisnis Didit: data registri, UBO, pengurus, status AML, dokumen, agregat sesi KYB, dan transaksi terkait. KYB loop tertutup.

Halaman ini mendokumentasikan setiap kolom pada entitas Bisnis dan cara Didit mengisi masing-masing kolom.

## Kolom identitas

| Kolom | Tipe | Deskripsi |
| - | - | - |
| `uuid` | UUID | Primary key yang ditetapkan Didit. Stabil dan unik. |
| `didit_internal_id` | string | Pengenal internal yang mudah dibaca. |
| `vendor_data` | string | Pengenal Anda untuk bisnis. Unik per aplikasi. [Baca selengkapnya](https://docs.didit.me/id/entities/vendor-data-linking.md). |
| `display_name` | string | Nama pengganti yang ditampilkan di konsol. Defaultnya adalah `legal_name` atau `vendor_data`. |
| `legal_name` | string | Nama legal perusahaan sebagaimana terdaftar, diteruskan dari pencarian registri pada sesi Verifikasi Bisnis (KYB) terbaru yang disetujui. |
| `registration_number` | string | Nomor registrasi perusahaan resmi, diteruskan dari registri. |
| `country_code` | string (ISO 3166-1 alpha-3) | Negara tempat perusahaan didirikan. |

> [!NOTE]
>
> `legal_name`, `registration_number`, dan `country_code` hanya dapat dibaca ketika diturunkan dari pencarian registri yang terverifikasi. Nilai tersebut dapat ditimpa secara manual di konsol atau melalui `PATCH /v3/businesses/{vendor_data}/`, tetapi penimpaan akan ditandai di log audit.

## Status

| Kolom | Tipe | Nilai | Deskripsi |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | Mengatur penegakan untuk sesi dan transaksi mendatang. Lihat [siklus hidup](https://docs.didit.me/id/entities/lifecycle.md). |

## Kolom agregat sesi

| Kolom | Tipe | Deskripsi |
| - | - | - |
| `session_count` | int | Total sesi Verifikasi Bisnis (KYB) yang pernah dibuat untuk bisnis ini |
| `approved_count` | int | Sesi yang selesai dengan `Approved` |
| `declined_count` | int | Sesi yang selesai dengan `Declined` |
| `in_review_count` | int | Sesi yang saat ini `In Review` |
| `features` | object | Status verifikasi perusahaan terbaru, di bawah kunci `KYB` |

### Peta `features`

```json theme={null}
{
  "KYB": "Approved"
}
```

Peta ini berisi satu kunci, `KYB`, dengan status verifikasi terbaru perusahaan: `"Not Finished"`, `"Approved"`, `"Declined"`, `"In Review"`, atau `"Resub Requested"`.
Untuk status setiap fitur KYB, lihat keputusan sesi.

Gunakan peta `features` sebagai jalur cepat untuk memeriksa apakah sebuah bisnis sudah terverifikasi penuh saat ini tanpa menelusuri semua sesi.

## Stempel waktu aktivitas

| Kolom | Tipe | Diperbarui saat |
| - | - | - |
| `first_session_at` | ISO timestamp | Sesi Verifikasi Bisnis (KYB) pertama dibuat |
| `last_session_at` | ISO timestamp | Sesi terbaru dibuat atau diperbarui |
| `last_activity_at` | ISO timestamp | Setiap perubahan: sesi, transaksi, status, profil, catatan |
| `created_at` | ISO timestamp | Baris entitas dibuat |
| `updated_at` | ISO timestamp | Baris entitas terakhir diperbarui |

## Metadata

| Kolom | Tipe | Deskripsi |
| - | - | - |
| `metadata` | object (JSON) | JSON bebas yang Anda kendalikan |
| `tags[]` | array | Tag yang dikelola di konsol/API |

## Relasi (tidak disimpan di baris entitas bisnis)

| Relasi | Cara mengakses |
| - | - |
| Sesi Verifikasi Bisnis (KYB) | `GET /v3/sessions?vendor_data=<value>` |
| Pengguna terkait (pejabat, UBO, direktur) | Ditampilkan di halaman detail bisnis di konsol; diturunkan dari sesi Verifikasi Bisnis (KYB) terbaru yang disetujui |
| Transaksi (sebagai pemohon atau pihak lawan) | Filter transaksi berdasarkan `vendor_data` bisnis |
| Dokumen | Melalui keputusan sesi Verifikasi Bisnis (KYB) |
| Temuan AML | Melalui keputusan sesi Verifikasi Bisnis (KYB) |

## Contoh respons

```json theme={null}
{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}
```

## Langkah selanjutnya

> [card] [Operasi](https://docs.didit.me/id/entities/businesses/operations.md)
>
> Buat, perbarui, ubah status, hapus.

> [card] [Riwayat KYB](https://docs.didit.me/id/entities/businesses/kyb-history.md)
>
> Ambil setiap sesi yang terkait dengan bisnis.

> [card] [Referensi API](https://docs.didit.me/id/management-api/businesses/get.md)
>
> Skema GET /v3/businesses/{vendor_data}/.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.