Merge pull request #239 from assoft-portugal/a-de-317-20

merge new features

README.md

@@ -4,9 +4,9 @@
 [![GitHub issues](https://img.shields.io/github/issues-raw/assoft-portugal/SAF-T-AO)](https://github.com/assoft-portugal/SAF-T-AO/issues)
 [![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/assoft-portugal/SAF-T-AO)](https://github.com/assoft-portugal/SAF-T-AO/releases)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/assoft-portugal/SAF-T-AO/blob/master/LICENSE)
-[![Discussion](https://img.shields.io/badge/discussion-yammer-blue.svg)](https://www.yammer.com/assoft-members/#/threads/inGroup?type=in_group&feedId=17835940&view=all)
+[![Discussion](https://img.shields.io/badge/discusion-telegram-blue)](https://t.me/saftao)
 
-Official XSD from the Government of Angola for use in SAF-T AO.
+Official XSD from the Government of Angola for use in SAF-T AO. The purpose of this schema is to standardize the format of tax-related data, facilitating auditing and compliance with Angolan tax regulations.
 
 > The Standard Audit File for Tax Purposes (SAF-T) is a standardized XML file used for exporting the accounting information of a company to the tax authorities. The file contains accounting data that can be exported from an original accounting system for a specific time period.
 >
@@ -16,13 +16,23 @@ Official XSD from the Government of Angola for use in SAF-T AO.
 
 ## VAT implementation in Angola
 
-The VAT legislation will take effect starting in October 2019. This deadline applies to software billing solutions, SAF-T file, and invoicing rules:
+The VAT [legislation](Resources/Legislation/README.md) will take effect starting in October 2019. The deadline applies to software billing solutions, SAF-T file, and invoicing rules:
 
 - Software solutions must follow the requirements of the new legal system in order to process sales documents, invoices, and other financial documents in accordance with the legal framework. This rule applies to all the subjects of the VAT scheme.
 - Software creators must apply to a software certification program by the government which is mandatory.
 - Starting from 1 January 2020 it will be mandatory to produce a monthly SAF-T file and send it to the government tax authorities.
 - From 1 January 2020, all taxpayers with an annual turnover of more than AKZ 50,000,000 will be required to produce the above referred SAF-T files and use certified software.
 
+## Schema Structure
+
+The XML schema is organized into the following main elements:
+
+- **AuditFile**: The root element containing all audit file data.
+- **Header**: Metadata about the audit file.
+- **MasterFiles**: Master data files such as general ledger accounts, customers, suppliers, products, and tax tables.
+- **GeneralLedgerEntries**: General ledger entries.
+- **SourceDocuments**: Source documents such as sales invoices, purchase invoices, and movement of goods.
+
 ## XML Validation
 
 ### Unix
@@ -45,3 +55,11 @@ sudo apt install libxml2-utils
 ```bash
 xmllint -schema schema.xsd file.xml --noout
 ```
+
+## Contributors
+
+This project exists thanks to all the people who contribute. [[Contribute]](CONTRIBUTING.md).
+
+<a href="https://github.com/assoft-portugal/SAF-T-AO/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=assoft-portugal/SAF-T-AO" />
+</a>

Resources/TaxExemptions.xml → Resources/Examples/TaxExemptions.xml

@@ -5,7 +5,7 @@
 	<TaxExemptions>
 		<TaxExemption>
 			<TaxExemptionCode>M00</TaxExemptionCode>
-			<TaxExemptionReason>IVA - Regime Simplificado</TaxExemptionReason>
+			<TaxExemptionReason>IVA &#x2013; Regime Simplificado</TaxExemptionReason>
 			<Law>Lei n.º 42/20</Law>
 			<Description>Foi utilizado até 31-12-2020 como IVA - Regime transitório</Description>
 		</TaxExemption>
@@ -19,7 +19,7 @@
 	<TaxExemptions>
 		<TaxExemption>
 			<TaxExemptionCode>M04</TaxExemptionCode>
-			<TaxExemptionReason>IVA - Regime de Exclusão</TaxExemptionReason>
+			<TaxExemptionReason>IVA &#x2013; Regime de Exclusão</TaxExemptionReason>
 			<Law>Lei n.º 42/20</Law>
 			<Description>Foi utilizado até 31-12-2020 como IVA - Regime de não sujeição</Description>
 		</TaxExemption>

Resources/Legislation/README.md

@@ -0,0 +1,6 @@
+# Legislation
+
+- 🆕 [Decreto Executivo 317/20 de 14 de Dezembro](decreto-317-20.pdf)
+- [Decreto Presidencial 312/18 de 21 de Dezembro](decreto-312-18.pdf)
+
+You can find more legal related information in the AGT (Tax Authority) [website](https://portaldocontribuinte.minfin.gov.ao/legislacao).