Appearance
Data Integrasi — Ikhtisar
Menu Data Integrasi adalah fasilitas bulk import data ke DocFast melalui file Excel/ZIP. Setiap tipe integrasi punya template resmi, validasi otomatis, dan log pemrosesan.
Semua Tipe Integrasi
Grup Master Data
| Tipe | Template | Format File | Keterangan |
|---|---|---|---|
| Akun | ✅ Template + Template dari BC | .xlsx | Import/update akun perusahaan + SKEP otomatis |
| Barang | ✅ Template (dari data existing) | .xlsx | Import/update master barang |
| Asset | ✅ Template | .xlsx | Import asset |
| BOM | ✅ Template | .xlsx | Import Bill of Materials; auto-tutup BOM yang overlap |
| Konversi Satuan Barang | ✅ Template (dari data existing) | .xlsx | Update rasio konversi satuan per barang |
| Mapping Satuan ERP | ✅ Template (dari data existing) | .xlsx | Mapping kode satuan ke kode ERP |
| Mapping Kode Eksternal | ✅ Template (dari data existing) | .xlsx | Mapping kode barang ke kode eksternal per akun |
Grup Transaksi
| Tipe | Template | Format File | Keterangan |
|---|---|---|---|
| Penerimaan | ✅ Template | .xlsx | Import transaksi penerimaan; hapus+insert per rentang tanggal |
| Pengeluaran | ✅ Template | .xlsx | Import transaksi pengeluaran; auto-generate BcDokumenMasukKeluar |
| Asset dan BC | ✅ Template | .xlsx | Import data asset beserta referensi BC |
| BC Masuk Lampau | ✅ Template | .xlsx | Import BC Pemasukan masa lalu (multi-sheet per header) |
| Pengisian BU | ✅ Template (BC tanpa BU) | .xlsx | Update Business Unit pada BcBarang yang kosong |
Grup CEISA / Legacy
| Tipe | Template | Format File | Keterangan |
|---|---|---|---|
| CEISA 4.0 | ❌ Tidak ada | .xlsx | Import data dari CEISA 4.0 |
| CEISA TPB | ❌ Tidak ada | .xls, .zip | Import legacy CEISA TPB |
| Portal CEISA | ❌ Tidak ada | .xlsx, .zip | Import dari Portal CEISA |
| PEB MDB | ❌ Tidak ada | .mdb, .bue | Import file PEB format MDB |
Grup Lainnya
| Tipe | Template | Format File | Keterangan |
|---|---|---|---|
| Foto Barang | ❌ Tidak ada | .zip | Upload foto massal; nama file: {KodeBarang}={BusinessUnit}.ext |
Status Integrasi
Tambah baru
│
▼
NEW (antri diproses)
│ Background job (poll tiap 5 detik)
▼
RUNNING (sedang diproses)
│
├─── sukses ──▶ COMPLETED
│
└─── gagal ───▶ FAILEDHalaman Daftar
Kolom yang ditampilkan:
| Kolom | Keterangan |
|---|---|
| Tipe | Jenis integrasi |
| Status | New / Running / Completed / Failed |
| Dibuat Oleh | Nama user + tanggal |
| Selesai Pada | Waktu selesai diproses |
Klik baris → buka halaman detail integrasi.
Cara Membuat Integrasi Baru
- Klik Tambah di toolbar
- Pilih Tipe dari dropdown (17 pilihan)
- Klik Template untuk download template Excel (jika tersedia)
- Isi data di Excel sesuai kolom template
- Upload file di field Attachment
- Klik Simpan — integrasi masuk antrian, status: New
- Tunggu background job memproses — status berubah ke Running → Completed/Failed
Tombol di Halaman Buat Integrasi
| Tombol | Kapan Muncul | Fungsi |
|---|---|---|
| Template | Saat tipe dipilih (kecuali PEB MDB, CEISA TPB, Portal CEISA, Foto Barang) | Download template Excel resmi |
| Template dari BC | Hanya tipe Akun | Download data akun existing dari dokumen BC |
| Simpan | Saat membuat baru (belum punya ID) | Submit integrasi ke antrian |
Halaman Detail (setelah diproses)
Setelah integrasi selesai, halaman detail menampilkan:
| Field | Keterangan |
|---|---|
| Remark | Pesan sukses atau detail error |
| Dibuat Pada | Waktu upload |
| Selesai Pada | Waktu selesai diproses |
| Attachment | Link download file yang diupload |
| Failed Attachment | Link download report baris yang gagal (jika ada) |
| Tab Logs | Log pemrosesan detail (max 5.000 baris terakhir) |
Tab Logs menampilkan log berwarna: [WRN] = kuning, [ERR] = merah. Ada tombol Refresh untuk reload log.
Tips & Best Practices
✅ Lakukan:
- Selalu gunakan template yang didownload dari sistem — formatnya sudah benar
- Test dengan 5–10 baris dulu sebelum upload data besar
- Cek tab Logs jika status Failed — log menampilkan baris mana yang gagal beserta alasannya
❌ Hindari:
- Jangan buat format template sendiri — kolom harus persis sama dengan template resmi
- Jangan upload ulang sebelum cek log/failed attachment — error yang sama akan terulang
FAQ
Q: Berapa lama proses setelah upload? A: Background job berjalan setiap 5 detik. Biasanya selesai dalam hitungan detik untuk file kecil, beberapa menit untuk file besar.
Q: File yang sudah diupload bisa diunduh kembali? A: Ya. Di halaman detail ada link Attachment untuk download file asli yang diupload.
Q: Ada baris yang gagal, baris yang berhasil tetap tersimpan? A: Tergantung tipe. Sebagian besar tipe memproses baris-per-baris, baris yang valid tetap disimpan. Baris yang gagal dicatat di Failed Attachment.
Q: Apakah integrasi bisa dibatalkan setelah disubmit? A: Tidak. Setelah status Running, proses tidak bisa dibatalkan.