Gambaran Pelanggan

Modul Customers menyimpan semua informasi pelanggan. Setiap work order, penawaran, dan faktur harus ditautkan ke pelanggan.

Mengakses Pelanggan

Di sidebar kiri, buka Customers → Customers.

Daftar Pelanggan

Kolom	Keterangan
Code	Kode pelanggan (monospace)
Name	Nama pelanggan, dengan email di bawahnya jika ada
Phone	Nomor telepon utama (atau nama kontak pertama jika tidak ada telepon langsung)
Address	Alamat lengkap (jalan, kota, provinsi, kode pos, negara)
Balance	Jumlah tagihan belum dibayar (ditampilkan dengan warna oranye jika > 0)

Gunakan search bar untuk mencari pelanggan berdasarkan nama, kode, atau email. Gunakan tombol status (All / Active / Inactive) untuk filter berdasarkan status aktif. Filter grup mempersempit daftar ke satu grup pelanggan.

Impor dan ekspor

Di Pelanggan → Pelanggan, buka Aksi di pojok kanan atas.

Aksi	Siapa yang bisa memakai	Hasil
Impor Excel	Pengguna yang boleh menambah pelanggan	Membuka Impor pelanggan
Ekspor Excel	Siapa pun yang bisa membuka daftar	Mengunduh `customers.xlsx`

Ekspor Excel

File berisi pelanggan yang cocok dengan pencarian, grup, dan status di daftar, bukan hanya halaman yang sedang terbuka. Jika yang cocok lebih dari 5.000 pelanggan, persempit filter lalu ekspor lagi.

Lembar bernama Customers. Kolomnya code, name, groups, email, phone, address, city, province, country, postal_code, tax_id, notes, is_active, contact_name, contact_phone, contact_email, dan contact_position. Satu baris adalah satu pelanggan. Kolom kontak adalah kontak utama.

Impor Excel

Impor pelanggan membuat satu pelanggan dari setiap baris data. Kode pelanggan dibuat otomatis. Kolom code di file diabaikan.

Klik Unduh contoh. Filenya customers-import-sample.xlsx. Lembar Customers berisi judul kolom dan dua baris contoh.
Ganti baris contoh itu dengan pelanggan Anda. Nama kolom harus tetap sama. Lembar Guide menjelaskan tiap kolom.
Letakkan file .xlsx di modal, atau pilih file itu. File harus .xlsx, paling besar 5 MB, dan paling banyak 1.000 baris pelanggan.
Klik Impor.

Kolom	Wajib	Isi
`name`	Ya	Nama pelanggan, 2–255 karakter. Harus unik di file dan di daftar pelanggan.
`groups`	Tidak	Nama grup dipisah koma, misalnya `Importer, Shipper`.
`email`	Tidak	Email pelanggan.
`phone`	Tidak	Telepon, misalnya `+628115550101`.
`address`	Tidak	Alamat jalan, paling panjang 500 karakter.
`city`, `province`, `country`	Tidak	Paling panjang 100 karakter masing-masing.
`postal_code`	Tidak	Paling panjang 20 karakter.
`tax_id`	Tidak	NPWP, paling panjang 30 karakter.
`notes`	Tidak	Catatan internal, paling panjang 5.000 karakter.
`contact_name`	Jika ada kolom kontak yang diisi	Nama kontak, 2–255 karakter.
`contact_phone`	Tidak	Telepon kontak.
`contact_email`	Tidak	Email kontak.
`contact_position`	Tidak	Jabatan, paling panjang 100 karakter.

Baris yang berhasil diimpor tetap tersimpan meskipun baris lain gagal. Hapus baris yang sudah tersimpan dari file sebelum mengunggah baris yang diperbaiki. Modal menampilkan setiap baris yang gagal beserta nomor baris di lembar dan alasannya, misalnya nama yang sama atau nama kontak yang kosong.

Halaman Detail Pelanggan

Klik baris pelanggan manapun untuk membuka halaman detailnya.

Bar statistik

Tiga kartu ringkasan ditampilkan di bagian atas setiap halaman detail pelanggan:

Kartu	Keterangan
Outstanding	Total jumlah faktur belum dibayar dan jumlah faktur yang belum lunas
Overdue	Total jumlah faktur jatuh tempo dan jumlah faktur yang overdue
Total Payments	Total pembayaran yang diterima dan jumlah pembayaran

Tab

Halaman detail memiliki empat tab:

Tab	Isi
Overview	Informasi pelanggan, kontak, catatan, dan sidebar info cepat
Quotations	Semua penawaran untuk pelanggan ini, dengan link ke Customer PO yang ditautkan per baris penawaran
Work Orders	Semua work order untuk pelanggan ini
Transactions	Buku besar transaksi — faktur (debit) dan pembayaran (kredit) dengan saldo berjalan

Tab Overview

Tab Overview menampilkan:

Identity — Kode, Nama, Groups, Email, Telepon, Tax ID
Address — Jalan, Kota, Provinsi, Negara, Kode Pos (hanya ditampilkan jika minimal satu field alamat terisi)
Contacts — Daftar kontak (lihat detail lengkap di bawah)
Notes — Catatan internal (hanya ditampilkan jika terisi)
Quick Info sidebar — Nama perusahaan, kota/negara, email, telepon, Tax ID, dan tanggal dibuat

Kartu Contacts

Kartu Contacts menampilkan jumlah kontak di header-nya. Setiap kartu kontak menampilkan: Nama, Jabatan / Posisi, Telepon, dan Email. Kontak utama (primary) selalu muncul di atas dengan latar biru dan badge Primary hijau.

Menambah kontak

Klik Add di header kartu Contacts untuk membuka modal Add Contact. Isi:

Field	Wajib	Keterangan
Name	✅	Nama lengkap kontak
Position / Title	—	Jabatan atau peran
Phone	—	Nomor telepon
Email	—	Alamat email
Set as primary contact	—	Toggle untuk menjadikan kontak ini sebagai primary

Klik Add Contact untuk menyimpan.

Mengedit kontak

Klik ikon pensil pada kontak manapun untuk membuka modal Edit Contact. Field yang tersedia sama. Toggle Set as primary contact hanya ditampilkan jika pelanggan memiliki lebih dari satu kontak. Menyimpan dengan toggle ini aktif akan otomatis menurunkan status primary dari kontak sebelumnya.

Klik Save Changes untuk menyimpan perubahan.

Menghapus kontak

Klik ikon tempat sampah untuk menghapus kontak. Dialog konfirmasi akan muncul sebelum penghapusan.

Tab Quotations

Kolom: Number, Sub Total, Valid Until, Date, Customer PO (nomor PO yang ditautkan jika ada), Status.

Tab Work Orders

Kolom: WO Number, Service, Date, Status.

Tab Transactions

Menampilkan buku besar gabungan faktur dan pembayaran, diurutkan terbaru di atas.

Kolom: Date, Reference, Description (dengan badge INV atau PAY), Debit, Credit, Balance.

Baris dapat diklik — mengklik baris manapun membuka faktur terkait.

Tindakan di Halaman Detail

Tombol	Keterangan
Statement	Unduh laporan akun pelanggan dalam format PDF untuk rentang tanggal tertentu
Edit	Buka form edit untuk semua field pelanggan
Delete	Hapus pelanggan secara permanen