README

本模块增加了对税则的导入和导出功能

/!\ 税则导出过滤器将在Thelia 2.1.4和2.2.0-alpha2版本中可用

安装

手动

• 将模块复制到<thelia_root>/local/modules/目录，并确保模块的名称为TaxRuleImport。
• 在Thelia管理面板中激活它

Composer

将其添加到您的主thelia composer.json文件中

composer require thelia/tax-rule-import-module:~1.0

使用方法

与Thelia一起使用

首先，使用Thelia创建您的税则。

然后，转到导出（或导入）页面，并使用“税则”导出（或导入）

手动

如果您想创建自己的税则文件，您需要编写一个XML文件。

根标签名为tax-rules，然后每个税则进入一个tax-rule。

示例

<?xml version="1.0" encoding="UTF-8"?>
<tax-rules>
    <tax-rule>
        ...
    </tax-rule>
    <tax-rule>
        ...
    </tax-rule>
    <!-- You can add as many tax rules as you want -->
</tax-rules>

然后，每个税则必须有两个标签

• countries
• descriptives

它还可以有一个taxes标签。

<countries>标签

此标签必须包含至少一个country标签。这是税则必须应用的国家。

国家的值可以是国家的isoalpha2、isoalpha3或isocode。

示例

...
<countries>
    <country>FRA</country>
    <country>USA</country>
</countries>
...

<descriptives>标签

此标签必须包含至少一个descriptive标签，它有一个必填属性locale。然后，descriptive标签可以有两个孩子

• <title> 税则标题
• <description> 税则描述

示例

<descriptives>
  <descriptive locale="en_US">
    <title>French 20% VAT</title>
  </descriptive>
  <descriptive locale="fr_FR">
    <title>TVA française à 20%</title>
  </descriptive>
</descriptives>

<taxes>标签

此标签包含至少一个tax标签，它有一个必填属性type。

类型属性可以是

• percent : 这是Thelia\TaxEngine\TaxType\PricePercentTaxType的快捷方式
• amount : 这是Thelia\TaxEngine\TaxType\FixAmountTaxType的快捷方式
• feature_percent : 这是Thelia\TaxEngine\TaxType\FeatureFixAmountTaxType的快捷方式
• 您自己的税类

tax标签可以有两个孩子

• <descriptives> 此标签与tax-rule中的标签工作方式相同
• <requirement> 此标签有一个必填属性key，它是类的需求名称，值是需求。您可以添加任意多的需求标签。

示例

<?xml version="1.0" encoding="UTF-8"?>
<tax-rules>
  <tax-rule>
    <countries>
      <country>FRA</country>
    </countries>
    <descriptives>
      <descriptive locale="en_US">
        <title>French 20% VAT</title>
      </descriptive>
      <descriptive locale="es_ES">
        <title/>
      </descriptive>
      <descriptive locale="fr_FR">
        <title>TVA française à 20%</title>
      </descriptive>
    </descriptives>
    <taxes>
      <tax type="percent">
        <descriptives>
          <descriptive locale="en_US">
            <title>French 20% VAT</title>
          </descriptive>
          <descriptive locale="es_ES">
            <title/>
          </descriptive>
          <descriptive locale="fr_FR">
            <title>TVA française à 20%</title>
          </descriptive>
        </descriptives>
        <requirement key="percent">20</requirement>
      </tax>
    </taxes>
  </tax-rule>
  <tax-rule>
    <countries>
      <country>FRA</country>
    </countries>
    <descriptives>
      <descriptive locale="en_US">
        <title>French 10% VAT</title>
      </descriptive>
      <descriptive locale="es_ES">
        <title/>
      </descriptive>
      <descriptive locale="fr_FR">
        <title>TVA française à 10%</title>
      </descriptive>
    </descriptives>
    <taxes>
      <tax type="percent">
        <descriptives>
          <descriptive locale="en_US">
            <title>French 10% VAT</title>
          </descriptive>
          <descriptive locale="es_ES">
            <title/>
          </descriptive>
          <descriptive locale="fr_FR">
            <title>TVA française à 10%</title>
          </descriptive>
        </descriptives>
        <requirement key="percent">10</requirement>
      </tax>
    </taxes>
  </tax-rule>
</tax-rules>