Skip to content

Commit

Permalink
Refactoring Extension presentation
Browse files Browse the repository at this point in the history
  • Loading branch information
samlown committed Jan 30, 2025
1 parent c9741ac commit 1791fc4
Show file tree
Hide file tree
Showing 35 changed files with 657 additions and 163 deletions.
40 changes: 26 additions & 14 deletions addons/br-nfse-v1.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,19 +5,19 @@ title: Brazil NFS-e 1.X
Key: <code>br-nfse-v1</code>

## Extensions

<AccordionGroup>
<Accordion description="Key: br-nfse-cnae" title="CNAE code">

Pattern: <code>^\d{2}[\s\.\-\/]?\d{2}[\s\.\-\/]?\d[\s\.\-\/]?\d{2}$</code>
### CNAE code

The CNAE (National Classification of Economic Activities) code for a service.

List of codes from the IBGE (Brazilian Institute of Geography and Statistics):

* https://www.ibge.gov.br/en/statistics/technical-documents/statistical-lists-and-classifications/17245-national-classification-of-economic-activities.html

<Accordion title="br-nfse-cnae">

Pattern: <code>^\d{2}[\s\.\-\/]?\d{2}[\s\.\-\/]?\d[\s\.\-\/]?\d{2}$</code>
</Accordion>
<Accordion description="Key: br-nfse-fiscal-incentive" title="Fiscal Incentive">
### Fiscal Incentive

Indicates whether a party benefits from a fiscal incentive.

Expand All @@ -26,12 +26,14 @@ List of codes from the national NFSe ABRASF (v2.04) model:
* https://abrasf.org.br/biblioteca/arquivos-publicos/nfs-e-manual-de-orientacao-do-contribuinte-2-04/download
(Section 10.2, Field B-68)

<Accordion title="br-nfse-fiscal-incentive">

| Code | Name |
| ---- | ---- |
| <code>1</code> | Has incentive |
| <code>2</code> | Does not have incentive |
</Accordion>
<Accordion description="Key: br-nfse-iss-liability" title="ISS Liability">
### ISS Liability

Indicates the ISS liability status, i.e., whether the ISS tax is due or not and why.

Expand All @@ -40,6 +42,8 @@ List of codes from the national NFSe ABRASF (v2.04) model:
* https://abrasf.org.br/biblioteca/arquivos-publicos/nfs-e-manual-de-orientacao-do-contribuinte-2-04/download
(Section 10.2, Field B-38)

<Accordion title="br-nfse-iss-liability">

| Code | Name |
| ---- | ---- |
| <code>1</code> | Liable |
Expand All @@ -50,27 +54,31 @@ List of codes from the national NFSe ABRASF (v2.04) model:
| <code>6</code> | Suspended Judicially |
| <code>7</code> | Suspended Administratively |
</Accordion>
<Accordion description="Key: br-nfse-municipality" title="IGBE Municipality Code">

Pattern: <code>^\d{7}$</code>
### IGBE Municipality Code

The municipality code as defined by the IGBE (Brazilian Institute of Geography and
Statistics).

List of codes from the IGBE:

* https://www.ibge.gov.br/explica/codigos-dos-municipios.php

<Accordion title="br-nfse-municipality">

Pattern: <code>^\d{7}$</code>
</Accordion>
<Accordion description="Key: br-nfse-service" title="Service Code">
### Service Code

The service code as defined by the municipality. Typically, one of the codes listed
in the Lei Complementar 116/2003, but municipalities can make their own changes.

For further details on the list of possible codes, see:

* https://www.planalto.gov.br/ccivil_03/leis/lcp/lcp116.htm

<Accordion title="br-nfse-service">
</Accordion>
<Accordion description="Key: br-nfse-simples" title="Opting for “Simples Nacional” regime">
### Opting for “Simples Nacional” regime

Indicates whether a party is opting for the “Simples Nacional” (Regime Especial
Unificado de Arrecadação de Tributos e Contribuições devidos pelas Microempresas e
Expand All @@ -81,12 +89,14 @@ List of codes from the national NFSe ABRASF (v2.04) model:
* https://abrasf.org.br/biblioteca/arquivos-publicos/nfs-e-manual-de-orientacao-do-contribuinte-2-04/download
(Section 10.2, Field B-67)

<Accordion title="br-nfse-simples">

| Code | Name |
| ---- | ---- |
| <code>1</code> | Opt-in |
| <code>2</code> | Opt-out |
</Accordion>
<Accordion description="Key: br-nfse-special-regime" title="Special Tax Regime">
### Special Tax Regime

Indicates a special tax regime that a party is subject to.

Expand All @@ -95,6 +105,8 @@ List of codes from the national NFSe ABRASF (v2.04) model:
* https://abrasf.org.br/biblioteca/arquivos-publicos/nfs-e-manual-de-orientacao-do-contribuinte-2-04/download
(Section 10.2, Field B-66)

<Accordion title="br-nfse-special-regime">

| Code | Name |
| ---- | ---- |
| <code>1</code> | Municipal micro-enterprise |
Expand All @@ -103,4 +115,4 @@ List of codes from the national NFSe ABRASF (v2.04) model:
| <code>4</code> | Cooperative |
| <code>5</code> | Single micro-entrepreneur (MEI) |
| <code>6</code> | Micro-enterprise or Small Business (ME EPP) |
</Accordion></AccordionGroup>
</Accordion>
20 changes: 12 additions & 8 deletions addons/co-dian-v2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,23 +34,25 @@ options. See the [Extensions](#extensions) section for possible values.
- <code>co-dian-debit-code</code>

## Extensions

<AccordionGroup>
<Accordion description="Key: co-dian-municipality" title="DIAN Municipality Code">

Pattern: <code>^\d{5}$</code>
### DIAN Municipality Code

The municipality code as defined by the DIAN.

For further details on the list of possible codes, see:

* https://www.dian.gov.co/atencionciudadano/formulariosinstructivos/Formularios/2007/Codigos_municipios_2007.pdf
* https://github.com/ALAxHxC/MunicipiosDane

<Accordion title="co-dian-municipality">

Pattern: <code>^\d{5}$</code>
</Accordion>
<Accordion description="Key: co-dian-credit-code" title="Credit Code">
### Credit Code

DIAN correction code for credit notes

<Accordion title="co-dian-credit-code">

| Code | Name |
| ---- | ---- |
| <code>1</code> | Partial refund |
Expand All @@ -59,14 +61,16 @@ DIAN correction code for credit notes
| <code>4</code> | Adjustment |
| <code>5</code> | Other |
</Accordion>
<Accordion description="Key: co-dian-debit-code" title="Debit Code">
### Debit Code

DIAN correction code for debit notes

<Accordion title="co-dian-debit-code">

| Code | Name |
| ---- | ---- |
| <code>1</code> | Interest |
| <code>2</code> | Pending charges |
| <code>3</code> | Change in value |
| <code>4</code> | Other |
</Accordion></AccordionGroup>
</Accordion>
14 changes: 14 additions & 0 deletions addons/de-zugferd-v2.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
title: German ZUGFeRD 2.X
---

Key: <code>de-zugferd-v2</code>

Support for the German ZUGFeRD version 2.2 and upwards standard for electronic
invoicing. ZUGFeRD 2.2 and Factur-X 1.0 are fully compatible and technically
identical formats the use the Factur-X identifier.

Currently this is just a placeholder addon as the EN16931 addon will provide
all validation requirements.

For more information, visit [www.ferd-net.de](https://www.ferd-net.de/).
14 changes: 9 additions & 5 deletions addons/es-facturae-v3.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,17 +16,19 @@ options. See the [Extensions](#extensions) section for possible values.
- <code>es-facturae-correction</code>

## Extensions
### FacturaE: Document Type

<AccordionGroup>
<Accordion description="Key: es-facturae-doc-type" title="FacturaE: Document Type">
<Accordion title="es-facturae-doc-type">

| Code | Name |
| ---- | ---- |
| <code>FC</code> | Commercial Invoice |
| <code>FA</code> | Simplified Invoice |
| <code>AF</code> | Self-billed Invoice |
</Accordion>
<Accordion description="Key: es-facturae-invoice-class" title="FacturaE: Invoice Class">
### FacturaE: Invoice Class

<Accordion title="es-facturae-invoice-class">

| Code | Name |
| ---- | ---- |
Expand All @@ -37,10 +39,12 @@ options. See the [Extensions](#extensions) section for possible values.
| <code>CR</code> | Copy of the Corrective |
| <code>CC</code> | Copy of the Summary |
</Accordion>
<Accordion description="Key: es-facturae-correction" title="FacturaE Change">
### FacturaE Change

FacturaE requires a specific and single code that explains why the previous invoice is being corrected.

<Accordion title="es-facturae-correction">

| Code | Name |
| ---- | ---- |
| <code>01</code> | Invoice code |
Expand All @@ -65,4 +69,4 @@ FacturaE requires a specific and single code that explains why the previous invo
| <code>83</code> | Taxable Base modified due to discounts and rebates |
| <code>84</code> | Taxable Base modified due to firm court ruling or administrative decision |
| <code>85</code> | Taxable Base modified due to unpaid outputs where there is a judgement opening insolvency proceedings |
</Accordion></AccordionGroup>
</Accordion>
20 changes: 13 additions & 7 deletions addons/es-tbai-v1.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,21 +16,21 @@ options. See the [Extensions](#extensions) section for possible values.
- <code>es-tbai-correction</code>

## Extensions

<AccordionGroup>
<Accordion description="Key: es-tbai-region" title="TicketBAI Region Code">
### TicketBAI Region Code

Region codes are used by TicketBAI to differentiate between the different
subdivisions of the Basque Country. This is used to determine the correct
API endpoint to use when submitting documents.

<Accordion title="es-tbai-region">

| Code | Name |
| ---- | ---- |
| <code>VI</code> | Araba |
| <code>BI</code> | Bizkaia |
| <code>SS</code> | Gipuzkoa |
</Accordion>
<Accordion description="Key: es-tbai-product" title="TicketBAI Product Key">
### TicketBAI Product Key

Product keys are used by TicketBAI to differentiate between -exported- goods
and services. It may be useful to classify all products regardless of wether
Expand All @@ -40,19 +40,23 @@ There is an additional exception case for goods that are resold without modifica
when the supplier is in the simplified tax regime. For must purposes this special
case can be ignored.

<Accordion title="es-tbai-product">

| Code | Name |
| ---- | ---- |
| <code>goods</code> | Delivery of goods |
| <code>services</code> | Provision of services |
| <code>resale</code> | Resale of goods without modification by vendor in the simplified regime |
</Accordion>
<Accordion description="Key: es-tbai-exemption" title="TicketBAI Exemption code">
### TicketBAI Exemption code

Codes used by TicketBAI for both "exempt", "not-subject", and reverse
charge transactions. In the TicketBAI format these are separated,
but in order to simplify GOBL and be more closely aligned with
other countries we've combined them into one.

<Accordion title="es-tbai-exemption">

| Code | Name |
| ---- | ---- |
| <code>E1</code> | Exempt: pursuant to Article 20 of the Foral VAT Law |
Expand All @@ -67,17 +71,19 @@ other countries we've combined them into one.
| <code>IE</code> | Not subject in the TAI due to localization rules, but foreign tax, IPS/IGIC or VAT from another EU member state is passed on |
| <code>S2</code> | Subject and not exempt: with reverse charge |
</Accordion>
<Accordion description="Key: es-tbai-correction" title="TicketBAI Rectification Type Code">
### TicketBAI Rectification Type Code

Corrected or rectified invoices that need to be sent in the TicketBAI format
require a specific type code to be defined alongside the preceding invoice
data.

<Accordion title="es-tbai-correction">

| Code | Name |
| ---- | ---- |
| <code>R1</code> | Rectified invoice: error based on law and Article 80 One, Two and Six of the Provincial Tax Law of VAT |
| <code>R2</code> | Rectified invoice: error based on law and Article 80 Three of the Provincial Tax Law of VAT |
| <code>R3</code> | Rectified invoice: error based on law and Article 80 Four of the Provincial Tax Law of VAT |
| <code>R4</code> | Rectified invoice: Other |
| <code>R5</code> | Rectified invoice: simplified invoices |
</Accordion></AccordionGroup>
</Accordion>
24 changes: 16 additions & 8 deletions addons/es-verifactu-v1.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,14 +16,14 @@ options. See the [Extensions](#extensions) section for possible values.
- <code>es-verifactu-doc-type</code>

## Extensions

<AccordionGroup>
<Accordion description="Key: es-verifactu-doc-type" title="Verifactu Invoice Type Code - L2">
### Verifactu Invoice Type Code - L2

Invoice type code used to identify the type of invoice being sent.
Source: VeriFactu Ministerial Order:
* https://www.boe.es/diario_boe/txt.php?id=BOE-A-2024-22138

<Accordion title="es-verifactu-doc-type">

| Code | Name |
| ---- | ---- |
| <code>F1</code> | Invoice (Article 6, 7.2 and 7.3 of RD 1619/2012) |
Expand All @@ -35,18 +35,20 @@ Source: VeriFactu Ministerial Order:
| <code>R4</code> | Rectified invoice: Other |
| <code>R5</code> | Rectified invoice: simplified invoices |
</Accordion>
<Accordion description="Key: es-verifactu-correction-type" title="Verifactu Correction Type Code - L3">
### Verifactu Correction Type Code - L3

Correction type code used to identify the type of correction being made.
This value will be determined automatically according to the invoice type.
Corrective invoices will be marked as "S", while credit and debit notes as "I".

<Accordion title="es-verifactu-correction-type">

| Code | Name |
| ---- | ---- |
| <code>S</code> | Substitution |
| <code>I</code> | Differences |
</Accordion>
<Accordion description="Key: es-verifactu-op-class" title="Verifactu Operation Classification/Exemption Code - L9">
### Verifactu Operation Classification/Exemption Code - L9

Operation classification code used to identify if taxes should be applied to the line.
Source: VeriFactu Ministerial Order:
Expand All @@ -55,17 +57,21 @@ For details on how best to use and apply these and other codes, see the
AEAT FAQ:
* https://sede.agenciatributaria.gob.es/Sede/impuestos-tasas/iva/iva-libros-registro-iva-traves-aeat/preguntas-frecuentes/3-libro-registro-facturas-expedidas.html?faqId=b5556c3d02bc9510VgnVCM100000dc381e0aRCRD

<Accordion title="es-verifactu-op-class">

| Code | Name |
| ---- | ---- |
| <code>S1</code> | Subject and Not Exempt - Without reverse charge |
| <code>S2</code> | Subject and Not Exempt - With reverse charge |
| <code>N1</code> | Not Subject - Articles 7, 14, others |
| <code>N2</code> | Not Subject - Due to location rules |
</Accordion>
<Accordion description="Key: es-verifactu-exempt" title="Verifactu Exemption Code - L10">
### Verifactu Exemption Code - L10

Exemption code used to explain why the operation is exempt from taxes.

<Accordion title="es-verifactu-exempt">

| Code | Name |
| ---- | ---- |
| <code>E1</code> | Exempt: pursuant to Article 20. Exemptions in internal operations. |
Expand All @@ -75,10 +81,12 @@ Exemption code used to explain why the operation is exempt from taxes.
| <code>E5</code> | Exempt: pursuant to Article 25. Exemptions in the delivery of goods destined to another Member State. |
| <code>E6</code> | Exempt: pursuant to other reasons |
</Accordion>
<Accordion description="Key: es-verifactu-regime" title="VAT/IGIC Regime Code - L8A/B">
### VAT/IGIC Regime Code - L8A/B

Identify the type of VAT or IGIC regime applied to the operation. This list combines lists L8A which include values for VAT, and L8B for IGIC.

<Accordion title="es-verifactu-regime">

| Code | Name |
| ---- | ---- |
| <code>01</code> | General regime operation |
Expand All @@ -98,4 +106,4 @@ Identify the type of VAT or IGIC regime applied to the operation. This list comb
| <code>18</code> | Equivalence surcharge (VAT) / Special regime for small traders or retailers (IGIC) |
| <code>19</code> | Operations included in the Special Regime for Agriculture, Livestock and Fisheries |
| <code>20</code> | Simplified regime (VAT only) |
</Accordion></AccordionGroup>
</Accordion>
Loading

0 comments on commit 1791fc4

Please sign in to comment.