Top

Wapi documentation

## Tax Management

#### Welcome to WAPI!

Get an AI summary of this page
ChatGPT Gemini Grok Perplexity

#### Overview

The **Tax Management** module is the fiscal cornerstone of the WAPI billing system. It allows administrators to define, configure, and regulate tax rates (such as VAT, GST, or Sales Tax) applied across the platform’s products, services, and subscription plans. Accurate tax configuration is essential for maintaining regional compliance and ensuring transparent invoicing for global customers.

By leveraging this module, administrators can automate the application of taxes during the checkout and renewal process. The system dynamically calculates tax values based on the percentage-based rules defined here, ensuring that the final prices reflect both the base cost and the applicable statutory levies.

#### Tax Rule Portfolio

The master list facilitates real-time auditing of your active tax regulations:

Tax Field | Resource Description
--- | ---
Tax Name | Official designation (e.g., "VAT - UK", "IGST - India").
Tax Type | The calculation method (currently supports **Percentage (%)**).
Tax Value | The percentage amount to be levied (e.g., `20%`, `18%`).
Status | Indicates if the tax rule is currently applied to new orders.
Actions | Options to Edit the rate/description or Delete inactive rules.

#### Tax Configuration Protocol

Navigate to System Settings → Taxes and click Add New Tax.
Define a descriptive Tax Name (e.g., GST 18%).
Select the Tax Type (Standardized as Percentage (%)).
Enter the precise Tax Percentage value to be applied.
Provide an optional Description for internal auditing.
Toggle Active Status and click Create Tax.

#### Automated Tax Application

##### The Calculation Logic

Taxes are dynamically added to the base price during the checkout or plan subscription sequence:

Example Scenerio:

- Base Plan Price: $100.00
- Active Tax (VAT 10%): + $10.00
- Final Billed Amount: $110.00

##### Checkout Integration

- Active Only: Only tax rules toggled to 'Active' are included in calculations.
- Invoice Transparency: Tax breakdowns are automatically rendered on user invoices.
- Real-time Update: Changing a tax rule updates all future checkout sessions instantly.

##### Fiscal Best Practices

- Granular Naming: Use specific names (e.g., "State VAT 5%") instead of generic labels to ensure historical clarity.
- Regulation Monitoring: Proactively update tax percentages in alignment with regional fiscal law changes.
- Redundancy Prevention: Avoid duplicate tax entries for the same region to prevent 'double-taxation' bugs at checkout.
- Deactivation Preference: Always Deactivate instead of Delete for taxes that were once live, to maintain invoice lookup integrity.

###### COMPLIANCE NOTICE

Inaccurate tax configuration can lead to legal discrepancies and financial audits. Always verify tax calculations in a staging environment before pushing new fiscal rules to production.