{"id":18948418,"url":"https://github.com/oxid-esales/country-vat-module","last_synced_at":"2025-04-15T23:30:53.809Z","repository":{"id":47584357,"uuid":"377510822","full_name":"OXID-eSales/country-vat-module","owner":"OXID-eSales","description":null,"archived":false,"fork":false,"pushed_at":"2024-04-24T06:36:54.000Z","size":788,"stargazers_count":16,"open_issues_count":0,"forks_count":2,"subscribers_count":13,"default_branch":"b-7.1.x","last_synced_at":"2024-04-24T18:30:19.459Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OXID-eSales.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-16T13:45:33.000Z","updated_at":"2024-06-25T12:51:07.161Z","dependencies_parsed_at":"2024-03-25T10:26:14.854Z","dependency_job_id":"04393555-060e-406e-9790-d017a943a382","html_url":"https://github.com/OXID-eSales/country-vat-module","commit_stats":{"total_commits":30,"total_committers":6,"mean_commits":5.0,"dds":0.4666666666666667,"last_synced_commit":"5d58dbcb1756cb583372ca6b9bb5e974d97b2360"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXID-eSales%2Fcountry-vat-module","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXID-eSales%2Fcountry-vat-module/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXID-eSales%2Fcountry-vat-module/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXID-eSales%2Fcountry-vat-module/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OXID-eSales","download_url":"https://codeload.github.com/OXID-eSales/country-vat-module/tar.gz/refs/heads/b-7.1.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223688674,"owners_count":17186298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T13:13:29.708Z","updated_at":"2024-11-08T13:13:34.567Z","avatar_url":"https://github.com/OXID-eSales.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Country VAT Administration\n\nThe provided module offers convenient functionality that allows administrators to configure country-specific VAT values\nfor countries, categories, and products.\n\nWhen determining the applicable VAT rate, the module follows a specific priority order. The priority is as follows:\n* Product-Specific VAT Value: If a product has a country-specific VAT value assigned to it, that VAT rate takes\nthe highest priority. It means that the assigned VAT rate for the product will override any other VAT rates set for categories or countries.\n* Category-Specific VAT Value: In the absence of a product-specific VAT value, the module will check if the category\nto which the product belongs has a country-specific VAT value assigned. If a category has a VAT rate assigned for\na particular country, that VAT rate will be used for all products within that category.\n* Country-Specific VAT Value: If neither the product nor the category has a country-specific VAT value assigned,\nthe module will default to the VAT rate assigned specifically for the country.\n\n\n## Branch Compatibility\n\n* b-7.1.x - compatible with OXID eShop b-7.1.x branch, works with `Twig engine` only\n* b-7.0.x branch is compatible with OXID eShop compilation b-7.0.x and allows `Legacy Smarty engine` version support\n* b-6.x branch / v1.x is compatible with\n  * OXID eShop compilation 6.1, 6.2 and 6.3 (6.0 with higher php versions may work as well, but module is not tested with it, so we cannot guarantee)\n  * OXID eShop b-6.4.x branch with PHP 7.4 and 8.0\n  * OXID eShop b-6.5.x branch with PHP 7.4, 8.0 and 8.1\n\n\n## Installation \n\n```\ncomposer require oxid-professional-services/countryvatadministration\n```\n\nAfter requiring the module, you need to activate it, e.g. via OXID eShop admin.\n\nThis module requires news tables in the database which will be created on module activation.\n\n## How to use\n\nTo add a special VAT to product or category go to shop admin and navigate to the section where\nyou can manage your products or categories. Choose the specific product or category\nto which you wish to assign a special VAT. Within the 'Main' tab, you will find a button labeled 'Country Specific VAT'.\nClicking the button opens a popup - this popup window allows you to assign VAT rates\nfor the chosen product or category based on specific countries.\nYou can specify the desired VAT rate for each of the assigned countries individually\nin the field that will show up on the right. Click the 'Save' button within the popup window to save the configuration.\n\n![Image alt](./assign-vat.png)\n\nWithin the shop admin panel, locate and navigate to the `Master Settings -\u003e Countries`, where you will be presented\nwith a list of available countries.Locate and select the country for which you wish to configure the VAT settings.\nWithin the 'Main' tab,you will find an input field specifically designated for the country-specific VAT rate. \nEnter the desired VAT rate for this country in the provided input field, then click the \"Save\" button to save the configuration.\n\n![Image alt](./assign-country-vat.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxid-esales%2Fcountry-vat-module","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foxid-esales%2Fcountry-vat-module","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxid-esales%2Fcountry-vat-module/lists"}