CoreTax Assist

The common sense update that 1.2 Trillion Rupiah couldn't buy.

⚠️ Disclaimer

CoreTax Assist is an open-source project created by an independent developer.

• NOT A GOVERNMENT TOOL: This software is an independent, open-source project. It is NOT affiliated with, endorsed by, or connected to the Directorate General of Taxes (DJP), the Ministry of Finance, or any state entity.
• CLIENT-SIDE ONLY: This extension functions strictly as a local browser overlay. It does not intercept, decrypt, or transmit data to any third-party server. It simply reads what is already visible on your screen and organizes it.
• NO AUTOMATED SUBMISSIONS: This tool does not automate the submission of tax returns. It is a file management and calculation utility only.

📖 About This Project

CoreTax is a triumph of Compliance-First Design, featuring a Zero-Automation Architecture that empowers users to manually verify every single transaction.

Representing a 1.2 Trillion Rupiah masterclass in fiscal allocation, the system studiously avoids the pitfalls of "modern usability" and "automated workflows." It ensures that every cent of that budget was dedicated to preserving the traditional, meditative art of clicking one button at a time, completely unburdened by the chaos of efficiency.

This extension serves as a supplementary High-Velocity Module. It re-introduces "legacy" concepts such as efficiency, speed, and usability for organizations that still cling to the outdated notion that tax compliance should be quick. While the official platform encourages a meditative, single-entry workflow, CoreTax Assist provides a bridge for those who prefer to face the practical realities of business deadlines.

🚀 Features (The Missing Billions)

We implemented the features the budget missed:

• Tax Calculator & Export Defines a new standard for "calculator" by actually letting you export data to Excel. No more manual transcription.

• Renaming Studio Automatically renames your tax files based on intelligent pattern matching. Because renaming files manually one-by-one is a task reserved for people with too much free time.

• PDF Merger Combine multiple invoice PDFs into a single file directly in your browser. Perfect for when you need to submit one document instead of fifty.

• Mock Mode Fully functional offline testing with mock data generation. Unlike the real system, this environment is stable and predictable.

🛠️ User Guide

For those who just want to get work done without worrying about the "tech" stuff.

1. The Magic "Tax Calculator" Widget

Injects directly into the CoreTax interface.

When you open a page with a tax table (like Pajak Masukan/Keluaran) in CoreTax, look for the floating widget in the bottom right corner.

1. Select Rows: Tick the checkboxes next to the invoices you want to process in the CoreTax table.
2. Watch it Count: The widget automatically sums up the DPP (Tax Base) and PPN (VAT) for you. No more manual calculator punching.
3. To Excel: Click this button to instantly download a clean Excel summary of the selected invoices.
4. Get PDFs: Click this to download the actual PDF files for the selected invoices automatically.

2. Renaming Studio

Fixes the messy filenames CoreTax gives you.

1. Click the extension icon (the puzzle piece or C logo) in your browser toolbar.
2. Select Renaming Studio.
3. Drag and Drop your messy tax PDF files into the drop zone.
4. The system will scan your currently open CoreTax page, match the Invoice Numbers, and determine the correct filename context.
5. Click Rename All to save them with sane names (e.g., Period_InvoiceNumber.pdf).

3. PDF Merger

Combines reports for easy archiving.

1. Open the extension and click PDF Merger.
2. Drag and Drop all the PDFs you want to combine.
3. Click Merge PDFs.
4. Download a single, neat PDF file containing everything.

💻 Installation & Development

Local Build

1. Install Dependencies & Build:

   npm install
   npm run build

2. Load into Chrome / Edge:

   • Open chrome://extensions or edge://extensions
   • Enable Developer mode (toggle in the top right/left)
   • Click Load unpacked
   • Select the dist folder generated by the build command.

Development Mode

To report bugs (about this extension, not CoreTax—that list is too long), or to contribute:

npm run dev

This runs the Vite dev server with Hot Module Replacement (HMR). Changes to the popup and content scripts will update automatically.

⚠️ Liability Limitation

Use at your own risk. This software is provided "as is," without warranty of any kind. The authors are not responsible for any errors in your tax reporting. Always verify the calculations produced by this tool against your official records.

By using this tool, you acknowledge that you are simply using a glorified calculator and file renamer, and not "hacking" anything.