> ## 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.

# Peringatan Verifikasi Bisnis & Kode Error KYB

> Kode peringatan Verifikasi Bisnis Didit per fitur: registri KYB, dokumen KYB, pihak kunci KYB, AML, telepon, email, kuesioner, dan Analisis Perangkat & IP.

Verifikasi Bisnis (KYB) menampilkan peringatan pada item fitur yang menghasilkannya. Setiap peringatan memiliki bentuk terstruktur standar yang dipakai di seluruh platform, yaitu `feature`, `risk`, `log_type`, `short_description`, `long_description`, `additional_data` (opsional), dan `node_id`, sehingga Anda dapat mengarahkan pekerjaan peninjauan ke tim operasional yang tepat.

## Ikhtisar

Sesi KYB menghasilkan peringatan di bawah tiga tag fitur inti yang dipetakan ke array fitur khusus dalam respons keputusan V3:

| Tag fitur | Kunci respons keputusan | Cakupan |
| - | - | - |
| `KYB_REGISTRY` | `registry_checks[].warnings[]` | Pencarian di registri perusahaan resmi. Status aktif, pembatasan negara, kepemilikan yang dapat diturunkan, serta data pejabat/UBO yang tidak ada. |
| `KYB_DOCUMENTS` | `document_verifications[].warnings[]` | Dokumen pendirian, kepemilikan, alamat, dan pemegang saham yang diunggah pengguna. Konsistensi antardokumen, OCR, metadata, manipulasi, usia, dan aturan subtipe. |
| `KYB_KEY_PEOPLE` | `key_people_checks[].warnings[]` | Sinyal tingkat orang pada direktur, pejabat, UBO, atau pihak yang diajukan oleh pengguna, termasuk temuan PEP/sanksi yang diteruskan dari AML dan penggunaan ulang penolakan sebelumnya. |

Alur kerja KYB yang sama juga dapat menyertakan fitur bersama berikut. Fitur-fitur ini menghasilkan peringatan pada array mereka sendiri:

| Tag fitur | Kunci respons keputusan |
| - | - |
| `AML` | `aml_screenings[].warnings[]` |
| `PHONE` | `phone_verifications[].warnings[]` |
| `EMAIL` | `email_verifications[].warnings[]` |
| `QUESTIONNAIRE` | `questionnaire_responses` (peringatan berada di log sesi) |
| `LOCATION` | `ip_analyses[].warnings[]` |

## Peringatan Registri KYB

Peringatan registri menggunakan `feature: "KYB_REGISTRY"` dan muncul pada `registry_checks[].warnings[]`.

| Tag | Deskripsi |
| - | - |
| `KYB_COUNTRY_RESTRICTED` | Negara perusahaan berada di luar negara yang diizinkan dan dikonfigurasi untuk alur kerja. |
| `KYB_OFFICERS_DATA_NOT_FOUND` | Data pejabat tidak tersedia dari registri. |
| `KYB_OWNERSHIP_DATA_NOT_FOUND` | Data kepemilikan tidak tersedia dari registri. |
| `KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE` | Kepemilikan manfaat akhir tidak dapat ditetapkan dari data registri. |
| `KYB_COMPANY_NOT_ACTIVE` | Perusahaan tidak aktif menurut registri. |
| `KYB_COMPANY_NOT_FROM_REGISTRY` | Perusahaan dimasukkan secara manual dan tidak dapat diverifikasi terhadap registri perusahaan. |
| `KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED` | Nomor registrasi perusahaan yang ditemukan dari registri tidak cocok dengan `expected_details.registration_number` yang Anda kirim saat membuat sesi. |
| `KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED` | Nomor registrasi yang ditemukan dari registri hanya sebagian cocok dengan nomor yang diharapkan, misalnya sufiks cabang atau anak perusahaan. |
| `KYB_COMPANY_VAT_INVALID` | Registri pajak resmi tidak memiliki registrasi aktif untuk nomor VAT atau ID pajak perusahaan, atau nomor VAT tidak memenuhi aturan format dan digit pemeriksa negaranya. Tindakan yang dikonfigurasi dalam `kyb_vat_invalid_action` diterapkan (default: dalam peninjauan). |
| `KYB_COMPANY_VAT_COULD_NOT_VALIDATE` | Nomor VAT atau ID pajak tidak dapat divalidasi karena registri resmi sementara tidak tersedia. Tindakan yang dikonfigurasi dalam `kyb_vat_unverified_action` diterapkan (default: tidak ada efek). |
| `KYB_COMPANY_VAT_NAME_MISMATCH` | Nama yang terdaftar di registri resmi untuk nomor ini berbeda dengan nama perusahaan yang dikirim. Bersifat informasional. `registry_name`, `registry_source`, dan `submitted_name` disertakan dalam `additional_data`, serta `vies_name` jika registrinya adalah VIES. |

Peringatan VAT berlaku di mana pun nomor VAT atau ID pajak perusahaan dapat divalidasi. Lihat [Validasi VAT dan ID pajak](https://docs.didit.me/id/business-verification/company-data.md#validasi-vat-dan-id-pajak) untuk negara dan sumber.

## Peringatan dokumen KYB

Peringatan dokumen menggunakan `feature: "KYB_DOCUMENTS"` dan muncul pada `document_verifications[].warnings[]`.

| Tag | Deskripsi |
| - | - |
| `KYB_DOCUMENT_MISSING_REQUIRED_FIELD` | Kolom perusahaan yang wajib diisi, seperti nama perusahaan atau nomor registrasi, tidak ditemukan dalam dokumen. |
| `KYB_DOCUMENT_NAME_MISMATCH` | Nama perusahaan dalam dokumen tidak sesuai dengan registri. |
| `KYB_DOCUMENT_REG_NUMBER_MISMATCH` | Nomor registrasi dalam dokumen tidak sesuai dengan registri. |
| `KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH` | Tanggal pendirian dalam dokumen tidak sesuai dengan registri. |
| `KYB_DOCUMENT_ADDRESS_MISMATCH` | Alamat terdaftar dalam dokumen tidak sesuai dengan registri. |
| `KYB_CROSS_DOCUMENT_MISMATCH` | Data perusahaan berbeda di antara dokumen korporasi yang diunggah. |
| `KYB_DOCUMENT_METADATA_MISMATCH` | Tanda tangan, metadata, atau struktur file dokumen menunjukkan kemungkinan masalah. |
| `KYB_ASSOCIATED_PARTY_MISMATCH` | Direktur atau pemegang saham dalam dokumen tidak sesuai dengan registri. |
| `KYB_DOCUMENT_GRAPHIC_EDITOR` | Dokumen tampaknya telah diproses dengan perangkat lunak pengeditan grafis. |
| `KYB_DOCUMENT_SUSPECTED_MANIPULATION` | Sistem mendeteksi tanda-tanda kemungkinan manipulasi dokumen korporasi. |
| `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` | Sebuah kolom teks pada dokumen korporasi dikosongkan lalu diketik ulang dengan font lain, dan file tidak memuat bukti apakah isinya berubah. Peringatan ini juga muncul untuk file yang tidak dapat diperiksa sepenuhnya, dengan `additional_data.detection_method` diisi `analysis_incomplete`, karena bagian yang tidak diperiksa mungkin memuat kolom semacam itu. Diatur oleh `kyb_document_unproven_text_replacement_action` (default Tinjauan). Alur kerja yang tidak pernah melakukan tinjauan menggunakan `kyb_document_tampering_action`-nya sendiri jika nilainya Tolak; jika tidak, tindakannya adalah Tidak ada tindakan. |
| `KYB_ADDITIONAL_DATA_NOT_FOUND` | Sebuah kolom dokumen tidak dapat diverifikasi karena data registri yang sesuai tidak tersedia. |
| `KYB_DOCUMENT_EXPIRED` | Dokumen korporasi melebihi usia maksimum yang dikonfigurasi. |
| `KYB_DOCUMENT_UNSUPPORTED_SUBTYPE` | Subtipe dokumen yang diunggah dinonaktifkan untuk alur kerja. |
| `KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED` | Jumlah maksimum percobaan unggah dokumen korporasi telah terlampaui. |

Untuk manipulasi teks overlay pada PDF, `KYB_DOCUMENT_SUSPECTED_MANIPULATION` dapat menyertakan `additional_data.manipulated_regions`. Kolom teks yang dikosongkan lalu diketik ulang dengan font lain memunculkan `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` dengan bentuk `manipulated_regions` yang sama, dan tidak pernah `KYB_DOCUMENT_SUSPECTED_MANIPULATION` saja: editor daring juga mengetik ulang teks yang tidak diubah, sehingga peringatan ini tidak menyatakan bahwa isinya berubah. Jika sinyal lain memunculkan `KYB_DOCUMENT_SUSPECTED_MANIPULATION` pada dokumen yang sama, tindakan yang lebih ketat di antara kedua tindakan tersebut yang berlaku. Ini adalah persegi panjang-persegi panjang dengan koordinat halaman yang menandai area yang diduga diedit dan sesuai dengan persegi panjang-persegi panjang yang dikembalikan dalam `document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions`.

## Peringatan pihak kunci KYB

Peringatan pihak kunci menggunakan `feature: "KYB_KEY_PEOPLE"` dan muncul pada `key_people_checks[].warnings[]`. Peringatan ini menunjukkan masalah tingkat individu pada direktur, pejabat, UBO, dan pihak yang diajukan oleh pengguna.

| Tag | Deskripsi |
| - | - |
| `KYB_PREVIOUSLY_DECLINED_INDIVIDUAL` | Seseorang yang terkait dengan perusahaan sebelumnya ditolak dalam verifikasi bisnis lain untuk aplikasi yang sama. |
| `KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS` | Direktur atau pemegang saham yang dinyatakan di layar Pihak Kunci tidak sesuai dengan orang yang disebutkan dalam dokumen korporasi yang diunggah: orang yang disebutkan dalam dokumen tidak pernah dinyatakan, sebuah nama hampir cocok, pemegang saham yang tercantum dalam dokumen dinyatakan tanpa peran kepemilikan, atau persentase kepemilikan yang dinyatakan bertentangan dengan dokumen. `kyb_key_people_document_mismatch_action` yang dikonfigurasi diterapkan (default: Dalam peninjauan). |

> [!NOTE]
>
> **Temuan PEP / sanksi pada pihak kunci** dilaporkan sebagai temuan AML standar pada item `aml_screenings[]` yang sesuai, bukan sebagai peringatan pihak kunci KYB. Pemeriksaan Pihak Kunci meneruskan status `Declined` atau `In Review` yang dihasilkan ke setiap pihak terkait, sehingga keputusan pihak kunci secara keseluruhan mencerminkan hasil AML.

## Peringatan fitur bersama

Fitur-fitur di bawah ini dapat berjalan di dalam alur kerja KYB. Fitur-fitur tersebut menggunakan katalog peringatan yang sama dengan Verifikasi Pengguna. Referensi lengkap untuk setiap fitur ada di halaman peringatan masing-masing.

### AML

`feature: "AML"` pada `aml_screenings[].warnings[]`.

| Tag | Deskripsi |
| - | - |
| `POSSIBLE_MATCH_FOUND` | Skrining AML menemukan kemungkinan kecocokan yang memerlukan peninjauan. |
| `COULD_NOT_PERFORM_AML_SCREENING` | Didit tidak dapat melakukan skrining AML karena data skrining yang diperlukan tidak tersedia atau hilang. |

### Telepon

`feature: "PHONE"` pada `phone_verifications[].warnings[]`.

| Tag | Deskripsi |
| - | - |
| `DISPOSABLE_NUMBER_DETECTED` | Nomor telepon bersifat sekali pakai. |
| `VERIFICATION_CODE_ATTEMPTS_EXCEEDED` | Jumlah maksimum percobaan kode verifikasi telah terlampaui. |
| `VOIP_NUMBER_DETECTED` | Nomor telepon merupakan nomor VoIP. |
| `DUPLICATED_PHONE_NUMBER` | Nomor telepon digunakan dalam proses verifikasi lain. |
| `HIGH_RISK_PHONE_NUMBER` | Nomor telepon memiliki risiko tinggi. |
| `PHONE_NUMBER_IN_BLOCKLIST` | Nomor telepon cocok dengan entri dalam daftar blokir Anda. |

### Email

`feature: "EMAIL"` pada `email_verifications[].warnings[]`.

| Tag | Deskripsi |
| - | - |
| `BREACHED_EMAIL_DETECTED` | Alamat email muncul dalam kebocoran data yang diketahui. |
| `DISPOSABLE_EMAIL_DETECTED` | Alamat email bersifat sekali pakai. |
| `UNDELIVERABLE_EMAIL_DETECTED` | Alamat email tidak dapat menerima email. |
| `DUPLICATED_EMAIL` | Alamat email digunakan dalam proses verifikasi lain. |
| `EMAIL_IN_BLOCKLIST` | Alamat email cocok dengan entri dalam daftar blokir Anda. |
| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | Jumlah maksimum percobaan kode verifikasi email telah terlampaui. |

### Kuesioner

`feature: "QUESTIONNAIRE"`.

| Tag | Deskripsi |
| - | - |
| `CUSTOM_STATUS_RULE_TRIGGERED` | Aturan status alur kerja mengevaluasi jawaban kuesioner dan mengubah status fitur. |

### Analisis Perangkat & IP

`feature: "LOCATION"` pada `ip_analyses[].warnings[]`.

| Tag | Deskripsi |
| - | - |
| `COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP` | Negara dokumen tidak cocok dengan negara dari alamat IP. |
| `PRIVATE_NETWORK_DETECTED` | Terdeteksi sinyal jaringan pribadi, VPN, proxy, atau Tor. |
| `EXPECTED_IP_ADDRESS_MISMATCH` | Alamat IP tidak cocok dengan alamat IP yang diharapkan untuk sesi tersebut. |
| `IP_ADDRESS_IN_BLOCKLIST` | Alamat IP cocok dengan entri dalam daftar blokir Anda. |
| `DEVICE_FINGERPRINT_IN_BLOCKLIST` | Sidik jari perangkat cocok dengan entri dalam daftar blokir Anda. |
| `DUPLICATED_IP_ADDRESS` | Alamat IP yang sama digunakan dalam verifikasi lain dengan `vendor_data` yang berbeda. |
| `DUPLICATED_DEVICE_FINGERPRINT` | Sidik jari perangkat yang sama digunakan dalam verifikasi lain dengan `vendor_data` yang berbeda. |

## Contoh

### Registri perusahaan: perusahaan tidak aktif

```json theme={null}
{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}
```

### Dokumen: dugaan manipulasi lapisan

```json theme={null}
{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}
```

### Pihak kunci: individu yang sebelumnya ditolak

```json theme={null}
{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}
```

## Terkait

> [card] [Skema respons](https://docs.didit.me/id/business-verification/response-schema.md)
>
> Lihat di mana peringatan muncul di setiap array fitur KYB.

> [card] [Status](https://docs.didit.me/id/business-verification/statuses.md)
>
> Pahami bagaimana tingkat keparahan peringatan dipetakan ke status verifikasi.

> [card] [Dokumen](https://docs.didit.me/id/business-verification/documents.md)
>
> Tinjau grup dokumen, OCR, dan perilaku pemeriksaan silang.

> [card] [Pihak kunci](https://docs.didit.me/id/business-verification/key-people.md)
>
> Alur verifikasi petugas, UBO, dan pihak yang diajukan.

> [card] [Laporan AML](https://docs.didit.me/id/core-technology/aml-screening/report-aml-screening.md)
>
> Struktur tingkat temuan untuk skrining AML perusahaan dan individu.

> [card] [Model data referensi](https://docs.didit.me/id/reference/data-models.md)
>
> Bentuk kanonis untuk peringatan dan array fitur.


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