--- judul: SFA — Revisi Self Registration MoM 22-10-2026 (checklist) proyek: SFA API · SFA CMS terkait: Mito · SFA Mobile kategori: Fitur status: Label CMS (ae16617) & API (87ebd72) ter-deploy dev 29-10-2026; NIK/NPWP mandatory & lampiran NPWP wajib untuk Company belum; label mobile di tim mobile tipe: dokumen-internal tags: - sfa - self-registration - mom diperbarui: 2026-11-03 --- > Index: [[SFA — Index]] · Kategori: **Fitur** · Sumber: [[Fix sfa aftrer meet with mito]] (MoM 22-10-2026, HO Mito) > Fitur induk: [[SFA — Self Registration]] · Revisi reward: [[SFA — Revisi Reward MoM 22-10-2026]] # SFA — Revisi Self Registration MoM 22-10-2026 ## Checklist | # | Poin MoM | CMS | SFA API | Mobile | Status | |---|---|---|---|---|---| | 1 | NIK / NPWP mandatory | — | ⬜ `npwpRule` & `nikRule` masih `optional: true, nullable: true` (`routes/helpers/identityNumberRules.js`) | ⬜ field wajib di form | ⬜ Belum | | 2 | "Kode Referal Karyawan" → "Kode Referral Sales" | ✅ label **Kode Referral Sales** | ✅ pesan error + Swagger | ⬜ label form mobile | ⚠️ Sisa mobile | | 3 | CMS hanya diakses Internal | ✅ sudah berjalan | — | — | ✅ Selesai | | 4a | Lampiran KTP → Lampiran NPWP | ✅ judul bagian **Lampiran NPWP** | ✅ contoh Swagger `doc_type: NPWP` | ⬜ label + nilai `doc_type` yang dikirim | ⚠️ Sisa mobile | | 4b | Lampiran NPWP mandatory ketika type Company (Individual tidak wajib — dipertegas Oliver 03-11-2026) | — | ✅ submit & resubmit: `COMPANY` wajib minimal 1 attachment `doc_type = NPWP` → 400 `Lampiran NPWP wajib untuk customer type Company (attachment doc_type = NPWP)`; `INDIVIDUAL` tanpa lampiran boleh (aturan lama resubmit "minimal 1 dokumen" dihapus). Commit `05d6083`, ter-deploy dev 03-11-2026 (git bundle + `sudo pm2 restart sfa-api-dev`; smoke test Company tanpa lampiran → 400) | ⬜ wajib upload kalau pilih Company; 1 file, pilihan `doc_type` **NPWP** / **KTP** (Company dikunci NPWP) | ⚠️ API ter-deploy dev · sisa mobile | **Progress: 1 / 5 selesai penuh, 2 / 5 tinggal mobile.** ## Kenapa sebagian tidak ada di CMS | Poin | Alasan | |---|---| | Label "Kode Referal Karyawan" | Tulisan itu **hanya ada di form aplikasi mobile**. CMS tidak pernah memakai kata "Karyawan" untuk referral — sebelumnya sudah "Referral Sales", sekarang jadi "Kode Referral Sales". API hanya menerima field `referral_empl_code` (nama teknis, tidak tampil ke user) dan pesan error-nya sudah diganti. Jadi yang mengganti label form = **tim mobile**. | | Label "Lampiran KTP" | CMS menampilkan jenis dokumen **apa adanya** dari kolom `doc_type` yang dikirim mobile (teks bebas, mis. `KTP`). Tidak ada tulisan "Lampiran KTP" di kode CMS / API. Judul bagian di CMS sudah diganti jadi **Lampiran NPWP**; tapi isi `doc_type` per file tetap tergantung mobile → mobile perlu mengirim `NPWP`. Dokumen lama yang sudah terkirim tetap tampil `KTP`. | | CMS hanya diakses Internal | Ini **hak akses**, bukan label — tidak ada teks yang perlu diubah. Sudah berjalan: `User::canAccessPanel()` menolak user `user_type = EXTERNAL` (dealer, customer, staff dealer hasil self / staff registration), jadi mereka hanya bisa login lewat SFA Mobile. `user_type` mengikuti flag role (`roles.user_type`). | | NIK / NPWP mandatory | Ini **validasi di API** (input datang dari mobile), bukan label CMS. CMS hanya menampilkan "NPWP / NIK" hasil registrasi. | | Lampiran NPWP mandatory (Company) | Sama — **validasi di API** saat submit / resubmit registrasi, plus tanda wajib di form mobile. | > [!warning] Catatan "CMS hanya Internal" > Semua user INTERNAL tetap bisa masuk panel — yang membatasi menu = role / permission Shield. Masalah lama > **±140 user punya role `super_admin`** (termasuk sales lapangan) masih terbuka, lihat To-Do di [[SFA — Index]]. > MoM versi sebelumnya menyebut "Admin & Kacab"; poin ini sekarang disebut "Internal". ## Perubahan Label — ter-deploy dev 29-10-2026 (cms `ae16617` via Jenkins, api `87ebd72` via git bundle + `sudo pm2 restart sfa-api-dev`) **CMS** | Halaman | Sebelum | Sesudah | |---|---|---| | Customer Registrations — detail & tabel | Referral Sales | Kode Referral Sales | | Customer Registrations — detail | Supporting Documents | Lampiran NPWP | | Employee External — form & detail | Referral Sales | Kode Referral Sales | | Employee External — form & detail | Supporting Documents | Lampiran NPWP | **SFA API** | Tempat | Sebelum | Sesudah | |---|---|---| | `POST /registration/submit` — referral kosong | `Referral sales wajib diisi` | `Kode Referral Sales wajib diisi` | | `POST /registration/submit` — kode tidak ada | `Referral sales not found !` | `Kode Referral Sales tidak ditemukan` | | Swagger contoh `doc_type` | `KTP` | `NPWP` | | Swagger contoh alasan revisi | `Foto KTP tidak terbaca` | `Foto NPWP tidak terbaca` | | Swagger `referral_empl_code` | — | dijelaskan sebagai Kode Referral Sales | > [!note] Info ke tim mobile > - Ganti label "Kode Referal Karyawan" → **Kode Referral Sales**. > - Ganti "Lampiran KTP" → **Lampiran NPWP**, dan kirim `attachment[].doc_type = "NPWP"`. > - Kalau mobile menampilkan pesan error dari API apa adanya, teks referral berubah (lihat tabel di atas). ## Sisa Pekerjaan 1. **NIK / NPWP mandatory** — ubah `npwpRule` / `nikRule` jadi wajib di submit Self Registration (dan Staff / Customer Registration kalau ikut). Perlu dipastikan dulu: wajib **salah satu** (NIK *atau* NPWP) atau **dua-duanya**. 2. **Lampiran NPWP wajib untuk Company** — validasi di `POST /registration/submit` & resubmit: `cust_type = COMPANY` → minimal satu attachment `doc_type = NPWP`.