Beranda
Shadow by Shora & Unduhan
Shadow by Shora (RPA) Panduan Teknis Shadow v26.12.0 Pusat Unduhan
Tax Tools & Referensi
Pusat Tax Tools (Gratis) Try Out UKP 2026 Referensi Perpajakan Kontak & Bantuan
Klaim Free Trial 1 Bulan
BUKU PANDUAN TEKNIS RESMI β€’ VERSI 26.12.0 (WINDOWS x64)

Panduan Teknis Penggunaan Shadow by Shora

Dokumentasi lengkap yang dapat diakses sebelum maupun sesudah instalasi: mulai dari persyaratan sistem Windows, autentikasi Akun Google & Kunci Lisensi Tim Multi-PC, struktur Excel bulk 6 kolom, cara kerja 8 modul Coretax DJP, pengaturan Bot Telegram jarak jauh, hingga troubleshooting.

1

Prasyarat Sistem & Instalasi Windows

Shadow by Shora (v26.12.0) adalah aplikasi desktop mandiri berbasis Windows (bukan ekstensi browser) yang mengendalikan jendela Google Chrome secara otomatis menggunakan Selenium WebDriver.

Spesifikasi Perangkat

  • Sistem Operasi: Windows 10 atau Windows 11 (64-bit).
  • RAM & Layar: Minimal 4 GB RAM (disarankan 8 GB+ untuk ribuan baris PDF).
  • Browser Wajib: Google Chrome versi terbaru terinstal di lokasi standar Windows.
  • Internet Aktif: Diperlukan untuk sinkronisasi otomatis ChromeDriver, validasi lisensi/kuota ke Shora Server, dan koneksi portal Coretax DJP.

Langkah Instalasi Aman

  1. Unduh installer resmi Setup_Shadow_by_Shora_v26.12.1.exe dari Pusat Unduhan.
  2. Klik dua kali installer dan izinkan dialog User Account Control (UAC) karena instalasi ke Program Files membutuhkan hak Administrator.
  3. Jika muncul jendela Windows protected your PC (SmartScreen), klik More info lalu pilih Run anyway.
  4. Centang opsi ikon desktop bila perlu, selesaikan wizard, lalu klik Finish.
Catatan Hak Akses Peluncuran (Error 740): Paket installer v26.12.0 telah memakai mode peluncuran shellexec setelah instalasi agar terhindar dari galat CreateProcess failed; code 740. Apabila Anda memaksa Run as administrator di properti aplikasi, buka aplikasi melalui shortcut Desktop/Start Menu.
2

Login Aplikasi & Validasi Sesi Coretax DJP

Saat aplikasi dibuka, Anda akan melihat dua metode masuk di layar Login:

Tab Login Diperuntukkan Bagi Cara Masuk & Hak Akses
🌐 Akun Google
MASUK DENGAN AKUN GOOGLE
Pemilik Lisensi (Owner) atau Staf yang Gmail-nya telah diundang di menu Tim. Klik tombol lalu selesaikan login OAuth Google di browser. Akun Owner memiliki akses penuh atas Upgrade QRIS, Manajemen Tim, dan pencabutan PC.
πŸ”‘ Kunci Lisensi
MASUK DENGAN KUNCI LISENSI
Operator PC Kantor / Staf tanpa meminjam akun Gmail pribadi pemilik. Masukkan kode SHORA-XXXX-XXXX-XXXX dari email aktivasi atau menu Tim pemilik + isi Nama Operator/PC opsional. Staf langsung memakai kuota bersama perusahaan.

Siklus Sesi Login Desktop (24 Jam)

  • Setiap sesi login desktop berlaku maksimal 24 jam (sisa waktu tampil pada kartu profil sidebar kiri: Sesi: 24j).
  • Ketika sesi 24 jam berakhir, aplikasi otomatis keluar dan meminta login ulang demi menjaga keamanan otorisasi server.
  • File sesi lokal disimpan terenkripsi menggunakan Windows DPAPI + HMAC Seal di %APPDATA%\Shadow_by_Shora_Data\session.json.

Alur Login Semi-Otomatis ke Portal Coretax DJP

  1. Setelah Anda menekan RUN πŸš€ pada salah satu dari 8 kartu misi, robot membuka Google Chrome langsung ke portal https://coretaxdjp.pajak.go.id.
  2. Ketik kredensial Coretax DJP Anda secara manual langsung di browser Chrome (NPWP/NIK, password, dan captcha/OTP bila ada). Password Coretax tidak pernah dibaca atau dikirim ke server Shora.
  3. Setelah masuk dashboard Coretax, pastikan profil Impersonate / Wajib Pajak Aktif sudah sesuai perusahaan/cabang yang ingin diproses.
  4. Klik tombol Lanjutkan pada kotak dialog Konfirmasi Profil Coretax yang muncul di layar.
  5. Robot otomatis membaca NPWP 15/16 digit yang sedang aktif pada Coretax lalu memverifikasi kuota Slot NPWP Anda ke Shora Server sebelum mengeksekusi halaman target.
3

Manajemen Tim Multi-PC & Kunci Lisensi

Melalui tombol πŸ‘₯ Tim & Kunci Lisensi di sidebar kiri aplikasi, Pemilik Paket (Owner) dapat membagikan kuota paket kepada rekan satu kantor secara aman tanpa perlu berbagi password Gmail utama:

  • Salin Kunci Lisensi: Klik πŸ“‹ Salin Kunci (SHORA-...) untuk dibagikan kepada operator komputer kantor.
  • Undang Anggota via Gmail: Masukkan alamat Gmail staf dan nama staf lalu klik βž• Tambah Anggota agar staf dapat login menggunakan akun Google masing-masing.
  • Manajemen Perangkat (HWID Binding): Setiap komputer didaftarkan otomatis berdasarkan identitas perangkat keras Windows (MachineGuid). Jika kuota PC penuh saat staf berpindah laptop/PC, akun Pemilik cukup mencabut perangkat lama pada daftar Perangkat PC Terdaftar.
  • Batasan Peran Anggota/Operator: Anggota tim maupun login Kunci Lisensi dapat menjalankan seluruh misi RPA sesuai paket, tetapi tidak dapat melakukan transaksi upgrade QRIS, menambah anggota, atau mencabut perangkat lain.
4

Memahami Bento Quota Monitor, Add-On & QRIS

Di bagian atas dashboard utama, terdapat 4 kartu indikator kuota real-time plus 1 banner kuota tambahan:

⚑ Kuota Kredit (Modul 3 & 4)

Menghitung pemakaian baris pengkreditan/uncredit Faktur Masukan dan Dokumen Lain.

πŸ“„ Maks e-Bupot (Modul 5)

Menghitung jumlah PDF Bukti Potong e-Bupot Unifikasi yang diunduh pada Modul #5.

πŸ’» Perangkat Terdaftar (HWID)

Menampilkan jumlah PC aktif dibanding kapasitas maksimum paket (1–3 PC atau +Add-On).

πŸ›οΈ Kuota Slot NPWP

Setiap NPWP unik Coretax yang diproses otomatis di-whitelist sesuai kuota paket (atau Unlimited pada Enterprise).

Kuota Bersama Add-On (Modul 3, 4 & 5): Bila kuota utama Kredit Faktur atau Download e-Bupot Anda habis di tengah jalan, sistem secara otomatis mengonsumsi saldo Kuota Bersama Add-On (+2.500/paket). Modul #1, #2, #6, #7, dan #8 bersifat Gratis / Bebas Kuota (selama fitur aktif pada paket Anda).

Upgrade Paket, Durasi Hemat & Add-On via QRIS

  1. Klik πŸ’Ž Upgrade / Perpanjang Paket di kartu profil (khusus akun Google Pemilik).
  2. Pilih Paket Utama (atau Add-On saja: +1 PC, +1 Slot NPWP, atau Top-Up +2.500 Kuota Bersama) dan pilih durasi 1, 3, 6, atau 12 bulan.
  3. Isi email tujuan invoice resmi lalu klik πŸš€ Buat Kode QRIS Pembayaran.
  4. Scan kode QRIS dinamis menggunakan m-Banking atau e-Wallet apa pun. Bayar persis hingga digit kode unik (jangan dibulatkan). Sistem mengecek status otomatis setiap 4 detik dan langsung mengaktifkan kapasitas baru + mengirim invoice resmi dari [email protected].
  5. Jika kuota belum berubah di layar setelah aktivasi/upgrade, tekan πŸ”„ Refresh Kuota di kanan atas dashboard.
5

Persiapan File Excel untuk Otomatisasi Kredit Faktur Pajak Masukan Massal (Modul #3 & #4)

Untuk menjalankan otomatisasi kredit faktur masukan dan kredit faktur pajak masukan massal pada Modul #3 Kredit Faktur maupun Modul #4 Kredit Dokumen Lain, Anda wajib menyiapkan file .xlsx sesuai template bawaan Shadow.

Cara Membuat & Mengisi Template Excel Resmi

  1. Pada sidebar kiri aplikasi, klik tombol πŸ“₯ Unduh Template Excel. Pilih format Faktur Pajak (Template_Kredit_Faktur_Shadow.xlsx) atau Dokumen Lain (Template_Kredit_DokLain_Shadow.xlsx).
  2. Template otomatis disetel dalam format sel Teks (@) pada 100 baris pertama agar angka nol di awal Nomor Faktur tidak terpotong oleh Microsoft Excel.
  3. Hapus/ganti baris contoh (seperti baris contoh TestMode pada baris ke-2), lalu isi data faktur Anda mulai baris ke-2 ke bawah.
Nama Kolom Wajib (Baris 1) Format & Aturan Contoh Pengisian
NomorFaktur Persis sama persis seperti tertera pada tabel Coretax DJP (tanpa spasi berlebih). Faktur: 04002600239964539
Dok. Lain: 040.000-26.00131533
MasaAsal Nama bulan penuh Bahasa Indonesia sesuai masa terbit faktur di Coretax (untuk filter pencarian). Juni
TahunAsal Tahun pajak terbit faktur (4 digit angka/teks). 2026
MasaTujuan Masa pajak tempat faktur akan dikreditkan atau dibatalkan pengkreditannya. Juli
TahunTujuan Tahun pajak tujuan pengkreditan (4 digit). 2026
Aksi Isi Kredit untuk mengkreditkan (Credit). Kata yang mengandung tidak (misal Tidak / Tidak Dikreditkan) memicu aksi Uncredit. Kredit atau Tidak
Modal Preview Sebelum Eksekusi: Setelah memilih file via πŸ“‚ Pilih File Faktur (.xlsx) / πŸ“‚ Pilih File Dok. Lain (.xlsx) dan menekan RUN πŸš€, Shadow tidak langsung mengeksekusi Coretax. Akan tampil tabel pratinjau berisi jumlah baris, ringkasan Dikreditkan vs Tidak Dikreditkan, fitur kotak pencarian nomor faktur, serta peringatan otomatis apabila jumlah baris melebihi sisa kuota Anda. Klik πŸš€ Setujui & Eksekusi RPA hanya jika data sudah benar.
6

Panduan Lengkap 8 Modul RPA Coretax DJP

Berikut fungsi, parameter input, aturan kuota, dan format hasil untuk masing-masing modul di dashboard Shadow:

# & Nama Modul Status Kuota Input / Parameter Output & Cara Kerja Robot
1. Prepop & PDF Faktur Masukan Gratis (Free) Tahun Pajak + Pilih Bulan (bisa 1 tahun penuh) + Pilih Mode: Excel Saja atau Excel + PDF. Mengunduh data Excel Coretax per masa lalu menggabungkannya otomatis menjadi REKAP_DATA_*.xlsx. Pada mode Excel+PDF, PDF tiap faktur diunduh & di-rename menjadi {Masa} - {Tahun} - {NamaPenjual} - {NomorFaktur}.pdf.
2. Prepop Dokumen Lain Gratis (Free) Tahun Pajak + Pilih Masa Pajak (Jan–Des). Mengunduh daftar Dokumen Lain Pajak Masukan per masa terpilih lalu menggabungkannya ke 1 file Excel REKAP_DATA_*.xlsx.
3. Kredit Faktur (Bulk) Kuota Kredit + Add-On File Excel 6 kolom pada slot Faktur Masukan + Konfirmasi Preview. Mencari nomor faktur pada portal input-tax (memastikan status APPROVED & filter masa asal), membuka detail, mengisi Tahun/Masa Tujuan, lalu menekan Credit / Uncredit. Refresh otomatis berkala mencegah sesi berat.
4. Kredit Dok. Lain (Bulk) Kuota Kredit + Add-On File Excel 6 kolom pada slot Dokumen Lain + Konfirmasi Preview. Bekerja pada menu Special Input Tax Coretax untuk mengkreditkan atau membatalkan kredit Dokumen Lain Pajak Masukan secara massal.
5. PDF e-Bupot Unifikasi Kuota e-Bupot + Add-On Tahun Pajak + Pilih Masa Pajak. Mengunduh PDF bukti potong e-Bupot Unifikasi (rename otomatis ke {Masa} - {Nomor} - {Nama}.pdf), lalu menjalankan ekstraksi PDF ke Excel menjadi REKAP_BUPOT_PDF_*.xlsx (21 kolom A/B/C).
6. PDF Faktur Keluaran Gratis (Free) Tahun Pajak + Pilih Masa Pajak. Mengunduh seluruh PDF Faktur Pajak Keluaran dan langsung me-rename sesuai nama lawan transaksi: {Masa} - {Tahun} - {Nama} - {NomorFaktur}.pdf.
7. PDF Bukti Potong 1721-A1 Gratis (Free) Tahun Pajak + Pilih Masa Pajak. Mengunduh massal PDF 1721-A1 lalu memindai seluruh 23 rincian angka A1 (B1_GAJI_PENSIUN s.d. B23_PPH21_KURANG_LEBIH_POTONG + identitas) menjadi Excel REKAP_1721_A1_*.xlsx.
8. PDF Bupot Pihak Lain Gratis (Free) Tahun Pajak + Pilih Masa Pajak. Mengunduh PDF Bukti Potong Pihak Lain (format {Masa} - {Nomor} - {Status} - {Nama}.pdf) sekaligus menghasilkan file rekap Excel REKAP_BUPOT_PDF_*.xlsx siap rekonsiliasi.

Catatan: Pada paket uji coba / Basic tertentu, modul dengan lencana πŸ”’ Pro/Enterprise dikunci sesuai fitur paket yang Anda pilih.

7

Lokasi Penyimpanan File Hasil & Audit Log

Anda tidak perlu mencari-cari file unduhan Chrome standar yang tercecer, karena Shadow mengarahkan dan menata seluruh hasil kerja ke direktori khusus:

  • Folder Hasil Download & Rekap Excel:
    %USERPROFILE%\Downloads\Shadow_by_Shora_Hasil
    Atau klik tombol πŸ“ Buka Folder Hasil Download pada sidebar kiri dashboard untuk langsung membuka Windows Explorer ke folder ini. File Excel rekap (REKAP_DATA_*.xlsx, REKAP_1721_A1_*.xlsx, REKAP_BUPOT_PDF_*.xlsx) juga otomatis terbuka setelah proses ekstraksi/merge selesai.
  • Folder Konfigurasi Sesi & System Log:
    %APPDATA%\Shadow_by_Shora_Data
    Berisi SystemLog.txt (jejak baris demi baris setiap misi untuk bahan audit/troubleshooting) dan session.json (terenkripsi Windows DPAPI).
8

Pengaturan Remote Bot Telegram & Anti-Sleep PC

Untuk memantau pengerjaan ribuan faktur atau bukti potong dari ponsel saat Anda sedang rapat atau di luar kantor:

  1. Buka aplikasi Telegram Anda, buat bot baru melalui @BotFather untuk menyalin Bot Token, dan cek angka Chat ID Anda melalui @userinfobot.
  2. Di Shadow, klik tombol βš™οΈ Pengaturan Telegram pada bagian bawah sidebar kiri.
  3. Tempelkan Bot Token dan Chat ID Anda, klik Uji Koneksi untuk memastikan bot dapat mengirim pesan ke ponsel Anda, lalu klik Simpan (token otomatis dienkripsi Windows DPAPI).

Perintah Balik dari Ponsel

Hanya Chat ID terdaftar yang diizinkan mengendalikan bot (ID asing otomatis ditolak & dicatat di log):

  • /status (atau /progress, /cek) → Mengambil progres item/halaman misi yang sedang berlangsung.
  • /stop (atau /shutdown, /matikan) → Mematikan aplikasi dan chromedriver.exe secara paksa dari jarak jauh bila perlu darurat.

Fitur Anti-Sleep PC (Caffeine)

Saat misi RPA berjalan, Shadow mengaktifkan API Windows (SetThreadExecutionState) agar komputer tidak tertidur di tengah proses ribuan dokumen, lalu menormalkan status sleep kembali setelah misi selesai atau dihentikan.

9

Arsitektur Keamanan Data & Troubleshooting

Ringkasan Privasi & Keamanan IT: Eksekusi otomatisasi Coretax DJP berjalan 100% lokal (on-device) di perangkat Windows perusahaan Anda. Shora Server hanya menerima validasi lisensi/HWID, pemotongan kuota, dan whitelist NPWP; password Coretax, passphrase sertifikat elektronik, isi faktur Excel, dan PDF pajak tidak pernah diunggah ke server Shora.
Gejala / Pesan Error Penyebab Umum Solusi Teknis
Error 740 saat membuka aplikasi Instalasi lama atau properti Run as administrator aktif sehingga peluncuran non-elevated terblokir. Instal ulang memakai installer terbaru v26.12.0 (shellexec) atau jalankan lewat shortcut Desktop dengan klik kanan → Run as administrator.
Gagal Buka Chrome / Driver Tidak Cocok (SessionNotCreatedException) Google Chrome baru update atau tidak terinstal di lokasi standar, atau koneksi terblokir saat sync driver. Pastikan Google Chrome terbaru terpasang dan internet tidak memblokir unduhan otomatis ChromeDriverManager.
Kolom Wajib Tidak Ditemukan saat pilih Excel Header baris pertama Excel diubah/salah huruf besar-kecil atau bukan format .xlsx. Unduh ulang melalui tombol πŸ“₯ Unduh Template Excel dan pastikan 6 header persis: NomorFaktur, MasaAsal, TahunAsal, MasaTujuan, TahunTujuan, Aksi.
LICENSE ALERT / Slot NPWP Ditolak NPWP yang aktif/di-impersonate pada Coretax melebihi batas kuota Slot NPWP paket. Pastikan profil Impersonate di Coretax benar sebelum menekan Lanjutkan, atau tambah Add-On +1 Slot NPWP / upgrade paket.
Kuota Perangkat Penuh saat ganti PC HWID Windows lama masih terdaftar pada akun lisensi. Minta akun Google Pemilik membuka menu πŸ‘₯ Tim & Kunci Lisensi dan cabut perangkat lama sebelum login di PC baru.
Kredit Faktur melewati baris tertentu Batas sisa kuota paket lebih kecil dari jumlah baris file Excel atau terdapat status selain APPROVED. Cek kartu Kuota Kredit + Add-On di dashboard. Klik πŸ”„ Refresh Kuota jika baru top-up QRIS atau periksa SystemLog.txt untuk baris yang ter-skip.