# VAT Profiles

Operations related to VAT Profile entities from the Property Management System (PMS), including retrieval and management of VAT/tax profiles used for complex tax calculations. VAT Profiles define tax rate structures that can vary based on time periods, accommodation types, or regional requirements. For example, serviced apartment accommodations may have high and low VAT rates that change at specific points during a stay, typically transitioning from standard VAT to reduced VAT after a certain number of nights. This API provides endpoints to list and retrieve VAT profile configurations, which is essential for accurate tax calculations on long-term stays, managing seasonal tax rate changes, ensuring compliance with complex tax regulations, and integrating with tax reporting systems. VAT Profiles contain tax seasons with effective date ranges and associated tax codes, allowing the system to automatically apply the correct tax rate based on stay duration and dates. These functionalities support sophisticated tax management and regulatory compliance within the PMS.

## Retrieve a paginated list of all VAT profiles

 - [GET /api/v3/vatProfiles](https://apidocs.resharmonics.com/apis/resharmonics-pms/vat-profiles/listallvatprofiles.md): Fetch a paginated list of all VAT profiles configured in the Property Management System (PMS). VAT Profiles are sophisticated tax configuration structures that define how tax rates are applied based on various factors such as stay duration, dates, accommodation types, and regional requirements. This endpoint is particularly important for properties with complex tax requirements, such as serviced apartments where VAT rates may change from standard (e.g., 20%) to reduced rates (e.g., 5%) after a certain number of nights, or properties operating in jurisdictions with seasonal tax variations. This endpoint is useful for retrieving VAT profile configurations to understand tax rate structures, support tax calculation logic in booking and invoicing systems, ensure compliance with tax regulations, integrate with tax reporting and accounting systems, or configure new properties with appropriate tax profiles. The response includes paginated results with VAT profile details including ID, profile name, description, standard rate indicator, and associated tax seasons. Each tax season contains effective date ranges, high and low tax codes (for accommodations with variable rates), and rate change thresholds. For example, a serviced apartment VAT profile might specify that stays under 28 nights use standard VAT (20%), while longer stays qualify for reduced VAT (5%). The system automatically determines which tax code to apply based on the stay dates and duration by evaluating the active tax season and applicable rate tier. VAT Profiles are returned in the order specified by the pageable parameter. Tax rates within VAT profiles follow the same 2 decimal precision standard as tax codes (e.g., 20.00, 5.00) and use RoundingMode.HALF_UP for calculations to maintain consistency across the system. If no VAT profiles exist in the system, an empty list will be returned. In case of an unexpected system error, a 500 Internal Server Error will be triggered.