gobl 0.24.1 → 0.24.3

data/data/addons/br-nfse-v1.json

@@ -0,0 +1,235 @@
+{
+  "$schema": "https://gobl.org/draft-0/tax/addon-def",
+  "key": "br-nfse-v1",
+  "name": {
+    "en": "Brazil NFS-e 1.X"
+  },
+  "extensions": [
+    {
+      "key": "br-nfse-cnae",
+      "name": {
+        "en": "CNAE code",
+        "pt": "Código CNAE"
+      },
+      "desc": {
+        "en": "The CNAE (National Classification of Economic Activities) code for a service.\n\nList of codes from the IBGE (Brazilian Institute of Geography and Statistics):\n\n* https://www.ibge.gov.br/en/statistics/technical-documents/statistical-lists-and-classifications/17245-national-classification-of-economic-activities.html"
+      },
+      "pattern": "^\\d{2}[\\s\\.\\-\\/]?\\d{2}[\\s\\.\\-\\/]?\\d[\\s\\.\\-\\/]?\\d{2}$"
+    },
+    {
+      "key": "br-nfse-fiscal-incentive",
+      "name": {
+        "en": "Fiscal Incentive",
+        "pt": "Incentivo Fiscal"
+      },
+      "desc": {
+        "en": "Indicates whether a party benefits from a fiscal incentive."
+      },
+      "sources": [
+        {
+          "title": {
+            "en": "NFS-e ABRASF Taxpayer Guidance Manual (v2.04)",
+            "pt": "NFS-e ABRASF Manual de Orientação do Contribuinte (v2.04)"
+          },
+          "url": "https://abrasf.org.br/biblioteca/arquivos-publicos/nfs-e-manual-de-orientacao-do-contribuinte-2-04/download"
+        }
+      ],
+      "values": [
+        {
+          "code": "1",
+          "name": {
+            "en": "Has incentive",
+            "pt": "Possui incentivo"
+          }
+        },
+        {
+          "code": "2",
+          "name": {
+            "en": "Does not have incentive",
+            "pt": "Não possui incentivo"
+          }
+        }
+      ]
+    },
+    {
+      "key": "br-nfse-iss-liability",
+      "name": {
+        "en": "ISS Liability",
+        "pt": "Exigibilidade ISS"
+      },
+      "desc": {
+        "en": "Indicates the ISS liability status, i.e., whether the ISS tax is due or not and why.\n\nList of codes from the national NFSe ABRASF (v2.04) model:\n\n* https://abrasf.org.br/biblioteca/arquivos-publicos/nfs-e-manual-de-orientacao-do-contribuinte-2-04/download\n(Section 10.2, Field B-38)"
+      },
+      "values": [
+        {
+          "code": "1",
+          "name": {
+            "en": "Liable",
+            "pt": "Exigível"
+          }
+        },
+        {
+          "code": "2",
+          "name": {
+            "en": "Not subject",
+            "pt": "Não incidência"
+          }
+        },
+        {
+          "code": "3",
+          "name": {
+            "en": "Exempt",
+            "pt": "Isenção"
+          }
+        },
+        {
+          "code": "4",
+          "name": {
+            "en": "Export",
+            "pt": "Exportação"
+          }
+        },
+        {
+          "code": "5",
+          "name": {
+            "en": "Immune",
+            "pt": "Imunidade"
+          }
+        },
+        {
+          "code": "6",
+          "name": {
+            "en": "Suspended Judicially",
+            "pt": "Suspensa por Decisão Judicial"
+          }
+        },
+        {
+          "code": "7",
+          "name": {
+            "en": "Suspended Administratively",
+            "pt": "Suspensa por Processo Administrativo"
+          }
+        }
+      ]
+    },
+    {
+      "key": "br-nfse-service",
+      "name": {
+        "en": "Service Code",
+        "pt": "Código Item Lista Serviço"
+      },
+      "desc": {
+        "en": "The service code as defined by the municipality. Typically, one of the codes listed\nin the Lei Complementar 116/2003, but municipalities can make their own changes.\n\nFor further details on the list of possible codes, see:\n\n* https://www.planalto.gov.br/ccivil_03/leis/lcp/lcp116.htm"
+      }
+    },
+    {
+      "key": "br-nfse-simples",
+      "name": {
+        "en": "Opting for \"Simples Nacional\" regime",
+        "pt": "Optante pelo Simples Nacional"
+      },
+      "desc": {
+        "en": "Indicates whether a party is opting for the \"Simples Nacional\" (Regime Especial\nUnificado de Arrecadação de Tributos e Contribuições devidos pelas Microempresas e\nEmpresas de Pequeno Porte) tax regime"
+      },
+      "sources": [
+        {
+          "title": {
+            "en": "NFS-e ABRASF Taxpayer Guidance Manual (v2.04)",
+            "pt": "NFS-e ABRASF Manual de Orientação do Contribuinte (v2.04)"
+          },
+          "url": "https://abrasf.org.br/biblioteca/arquivos-publicos/nfs-e-manual-de-orientacao-do-contribuinte-2-04/download"
+        }
+      ],
+      "values": [
+        {
+          "code": "1",
+          "name": {
+            "en": "Opt-in",
+            "pt": "Optante"
+          }
+        },
+        {
+          "code": "2",
+          "name": {
+            "en": "Opt-out",
+            "pt": "Não optante"
+          }
+        }
+      ]
+    },
+    {
+      "key": "br-nfse-special-regime",
+      "name": {
+        "en": "Special Tax Regime",
+        "pt": "Regime Especial de Tributação"
+      },
+      "desc": {
+        "en": "Indicates a special tax regime that a party is subject to."
+      },
+      "sources": [
+        {
+          "title": {
+            "en": "NFS-e ABRASF Taxpayer Guidance Manual (v2.04)",
+            "pt": "NFS-e ABRASF Manual de Orientação do Contribuinte (v2.04)"
+          },
+          "url": "https://abrasf.org.br/biblioteca/arquivos-publicos/nfs-e-manual-de-orientacao-do-contribuinte-2-04/download"
+        }
+      ],
+      "values": [
+        {
+          "code": "1",
+          "name": {
+            "en": "Municipal micro-enterprise",
+            "pt": "Microempresa municipal"
+          }
+        },
+        {
+          "code": "2",
+          "name": {
+            "en": "Estimated",
+            "pt": "Estimativa"
+          }
+        },
+        {
+          "code": "3",
+          "name": {
+            "en": "Professional Society",
+            "pt": "Sociedade de profissionais"
+          }
+        },
+        {
+          "code": "4",
+          "name": {
+            "en": "Cooperative",
+            "pt": "Cooperativa"
+          }
+        },
+        {
+          "code": "5",
+          "name": {
+            "en": "Single micro-entrepreneur (MEI)",
+            "pt": "Microempreendedor individual (MEI)"
+          }
+        },
+        {
+          "code": "6",
+          "name": {
+            "en": "Micro-enterprise or Small Business (ME EPP)",
+            "pt": "Microempresa ou Empresa de Pequeno Porte (ME EPP)."
+          }
+        }
+      ]
+    }
+  ],
+  "scenarios": null,
+  "identities": [
+    {
+      "key": "br-nfse-municipal-reg",
+      "name": {
+        "en": "Company Municipal Registration",
+        "pt": "Inscrição Municipal da Empresa"
+      }
+    }
+  ],
+  "corrections": null
+}

data/data/addons/co-dian-v2.json

@@ -0,0 +1,311 @@
+{
+  "$schema": "https://gobl.org/draft-0/tax/addon-def",
+  "key": "co-dian-v2",
+  "name": {
+    "en": "Colombia DIAN UBL 2.X"
+  },
+  "description": {
+    "en": "Extensions to support the Colombian DIAN (Dirección de Impuestos y Aduanas Nacionales)\nspecifications for electronic invoicing based on UBL 2.1."
+  },
+  "extensions": [
+    {
+      "key": "co-dian-municipality",
+      "name": {
+        "en": "DIAN Municipality Code",
+        "es": "Código de municipio DIAN"
+      },
+      "desc": {
+        "en": "The municipality code as defined by the DIAN.\n\nSet the 5-digit code for the municipality where the issuer is located in both\nthe supplier and customer:\n\n```js\n\"supplier\": {\n\t\"name\": \"EXAMPLE SUPPLIER S.A.S.\",\n\t\"tax_id\": {\n\t\t\"country\": \"CO\",\n\t\t\"code\": \"9014514812\"\n\t},\n\t\"ext\": {\n\t\t\"co-dian-municipality\": \"11001\" // Bogotá, D.C.\n\t},\n\t// [...]\n},\n\"customer\": {\n\t\"name\": \"EXAMPLE CUSTOMER S.A.S.\",\n\t\"tax_id\": {\n\t\t\"country\": \"CO\",\n\t\t\"code\": \"9014514805\"\n\t},\n\t\"ext\": {\n\t\t\"co-dian-municipality\": \"05001\" // Medellín\n\t},\n\t// [...]\n},\n```"
+      },
+      "sources": [
+        {
+          "title": {
+            "en": "DIAN Municipality Codes"
+          },
+          "url": "https://www.dian.gov.co/atencionciudadano/formulariosinstructivos/Formularios/2007/Codigos_municipios_2007.pdf",
+          "content_type": "application/pdf"
+        },
+        {
+          "title": {
+            "en": "Municipalities of Colombia - Github"
+          },
+          "url": "https://github.com/ALAxHxC/MunicipiosDane"
+        }
+      ],
+      "pattern": "^\\d{5}$"
+    },
+    {
+      "key": "co-dian-credit-code",
+      "name": {
+        "en": "Credit Code",
+        "es": "Código de Crédito"
+      },
+      "desc": {
+        "en": "The DIAN correction code is required when issuing credit notes in Colombia\nand is not automatically assigned by GOBL. It must be be included inside the\n`preceding` document references.\n\nThe extension will be offered as an option in the invoice correction process.\n\nUsage example:\n\n```js\n\"preceding\": [\n\t{\n\t\t\"uuid\": \"0190e063-7676-7000-8c58-2db7172a4e58\",\n\t\t\"type\": \"standard\",\n\t\t\"series\": \"SETT\",\n\t\t\"code\": \"1010006\",\n\t\t\"issue_date\": \"2024-07-23\",\n\t\t\"reason\": \"Reason\",\n\t\t\"stamps\": [\n\t\t\t{\n\t\t\t\t\"prv\": \"dian-cude\",\n\t\t\t\t\"val\": \"57601dd1ab69213ccf8cfd5894f2e9fbfe23643f3a24e2f2526a5bb88d058a0842fffcb339694b6704dc105a9d813327\"\n\t\t\t}\n\t\t],\n\t\t\"ext\": {\n\t\t\t\"co-dian-credit-code\": \"3\"\n\t\t}\n\t}\n],\n```"
+      },
+      "values": [
+        {
+          "code": "1",
+          "name": {
+            "en": "Partial refund",
+            "es": "Devolución parcial"
+          },
+          "desc": {
+            "en": "Partial refund of part of the goods or services.",
+            "es": "Devolución de parte de los bienes; no aceptación de partes del servicio."
+          }
+        },
+        {
+          "code": "2",
+          "name": {
+            "en": "Revoked",
+            "es": "Anulación"
+          },
+          "desc": {
+            "en": "Previous document has been completely cancelled.",
+            "es": "Anulación de la factura anterior."
+          }
+        },
+        {
+          "code": "3",
+          "name": {
+            "en": "Discount",
+            "es": "Descuento"
+          },
+          "desc": {
+            "en": "Partial or total discount.",
+            "es": "Rebaja o descuento parcial o total."
+          }
+        },
+        {
+          "code": "4",
+          "name": {
+            "en": "Adjustment",
+            "es": "Ajuste"
+          },
+          "desc": {
+            "en": "Price adjustment.",
+            "es": "Ajuste de precio."
+          }
+        },
+        {
+          "code": "5",
+          "name": {
+            "en": "Other",
+            "es": "Otros"
+          }
+        }
+      ]
+    },
+    {
+      "key": "co-dian-debit-code",
+      "name": {
+        "en": "Debit Code",
+        "es": "Código de Débito"
+      },
+      "desc": {
+        "en": "The DIAN correction code is required when issuing debit notes in Colombia\nand is not automatically assigned by GOBL.\n\nThe extension will be offered as an option in the invoice correction process."
+      },
+      "values": [
+        {
+          "code": "1",
+          "name": {
+            "en": "Interest",
+            "es": "Intereses"
+          }
+        },
+        {
+          "code": "2",
+          "name": {
+            "en": "Pending charges",
+            "es": "Gastos por cobrar"
+          }
+        },
+        {
+          "code": "3",
+          "name": {
+            "en": "Change in value",
+            "es": "Cambio del valor"
+          }
+        },
+        {
+          "code": "4",
+          "name": {
+            "en": "Other",
+            "es": "Otros"
+          }
+        }
+      ]
+    },
+    {
+      "key": "co-dian-fiscal-responsibility",
+      "name": {
+        "en": "Fiscal Responsibility Code",
+        "es": "Código de Responsabilidad Fiscal"
+      },
+      "desc": {
+        "en": "The fiscal responsibility code as defined by the DIAN for Colombian electronic invoicing.\nMaps to the UBL's `TaxLevelCode` field.\n\nThe DIAN requires that Colombian invoices specify the fiscal responsibilities of the\nsupplier or customer using specific codes. If no value is provided, GOBL will\nautomatically set `R-99-PN` as the default.\n\n| Code    | Description                   |\n| ------- | ----------------------------- |\n| O-13    | Gran contribuyente            |\n| O-15    | Autorretenedor                |\n| O-23    | Agente de retención IVA       |\n| O-47    | Régimen simple de tributación |\n| R-99-PN | No aplica - Otros             |\n\nFor example:\n\n```js\n\"customer\": {\n\t\"name\": \"EXAMPLE CUSTOMER S.A.S.\",\n\t\"tax_id\": {\n\t\t\"country\": \"CO\",\n\t\t\"code\": \"9014514812\"\n\t},\n\t\"ext\": {\n\t\t\"co-dian-fiscal-responsibility\": \"O-13\"\n\t}\n}\n```"
+      },
+      "sources": [
+        {
+          "title": {
+            "en": "DIAN Fiscal Responsibility Codes, see Anexo Tecnico/Tablas Referenciadas, table 13.2.6.1"
+          },
+          "url": "https://www.dian.gov.co/impuestos/factura-electronica/Documents/Caja-de-herramientas-FE-V1-9.zip",
+          "content_type": "application/zip"
+        }
+      ],
+      "values": [
+        {
+          "code": "O-13",
+          "name": {
+            "en": "Major taxpayer",
+            "es": "Gran contribuyente"
+          }
+        },
+        {
+          "code": "O-15",
+          "name": {
+            "en": "Self-withholder",
+            "es": "Autorretenedor"
+          }
+        },
+        {
+          "code": "O-23",
+          "name": {
+            "en": "VAT withholding agent",
+            "es": "Agente de retención IVA"
+          }
+        },
+        {
+          "code": "O-47",
+          "name": {
+            "en": "Simple tax regime",
+            "es": "Régimen simple de tributación"
+          }
+        },
+        {
+          "code": "R-99-PN",
+          "name": {
+            "en": "Not applicable – Others",
+            "es": "No aplica – Otros"
+          },
+          "desc": {
+            "en": "Used when the issuer/acquirer does not have any of the first 4 responsibilities. Applies to legal entities, individuals, or final consumers.",
+            "es": "Se utiliza cuando el emisor/adquiriente no cuenta con las primeras 4 responsabilidades. Aplica para personas jurídicas, personas naturales o consumidor final."
+          }
+        }
+      ]
+    }
+  ],
+  "scenarios": null,
+  "identities": [
+    {
+      "key": "co-civil-register",
+      "name": {
+        "en": "Civil Registry",
+        "es": "Registro Civil"
+      },
+      "map": {
+        "dian-company-id": "11"
+      }
+    },
+    {
+      "key": "co-id-card",
+      "name": {
+        "en": "Identity Card",
+        "es": "Tarjeta de Identidad"
+      },
+      "map": {
+        "dian-company-id": "12"
+      }
+    },
+    {
+      "key": "co-citizen-id",
+      "name": {
+        "en": "Citizen Identity Card",
+        "es": "Cédula de ciudadanía"
+      },
+      "map": {
+        "dian-company-id": "13"
+      }
+    },
+    {
+      "key": "co-foreigner-id-card",
+      "name": {
+        "en": "Foreigner Identity Card",
+        "es": "Tarjeta de Extranjería"
+      },
+      "map": {
+        "dian-company-id": "21"
+      }
+    },
+    {
+      "key": "co-foreigner-id",
+      "name": {
+        "en": "Foreigner Citizen Identity",
+        "es": "Cédula de extranjería"
+      },
+      "map": {
+        "dian-company-id": "22"
+      }
+    },
+    {
+      "key": "co-passport",
+      "name": {
+        "en": "Passport",
+        "es": "Pasaporte"
+      },
+      "map": {
+        "dian-company-id": "41"
+      }
+    },
+    {
+      "key": "co-foreign-id",
+      "name": {
+        "en": "Foreign Document",
+        "es": "Documento de identificación extranjero"
+      },
+      "map": {
+        "dian-company-id": "42"
+      }
+    },
+    {
+      "key": "co-pep",
+      "name": {
+        "en": "PEP - Special Permit to Stay",
+        "es": "PEP - Permiso Especial de Permanencia"
+      },
+      "map": {
+        "dian-company-id": "47"
+      }
+    },
+    {
+      "key": "co-nuip",
+      "name": {
+        "en": "NUIP - National Unique Personal Identification Number",
+        "es": "NUIP - Número Único de Identificación Personal"
+      },
+      "map": {
+        "dian-company-id": "91"
+      }
+    }
+  ],
+  "corrections": [
+    {
+      "schema": "bill/invoice",
+      "types": [
+        "credit-note",
+        "debit-note"
+      ],
+      "extensions": [
+        "co-dian-credit-code",
+        "co-dian-debit-code"
+      ],
+      "reason_required": true,
+      "stamps": [
+        "dian-cude"
+      ]
+    }
+  ]
+}

data/data/addons/de-xrechnung-v3.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://gobl.org/draft-0/tax/addon-def",
+  "key": "de-xrechnung-v3",
+  "requires": [
+    "eu-en16931-v2017"
+  ],
+  "name": {
+    "en": "German XRechnung 3.X"
+  },
+  "description": {
+    "en": "Support for the German XRechnung version 3.X standard for electronic invoicing.\nXRechnung is based on the European Norm (EN) 16931 and is mandatory for business-to-government\n(B2G) invoices in Germany. This addon provides the necessary structures and validations to\nensure compliance with the XRechnung specifications.\n\nFor more information on XRechnung, visit [www.xrechnung.de](https://www.xrechnung.de/)."
+  },
+  "extensions": null,
+  "scenarios": null,
+  "corrections": null
+}

data/data/addons/de-zugferd-v2.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://gobl.org/draft-0/tax/addon-def",
+  "key": "de-zugferd-v2",
+  "requires": [
+    "eu-en16931-v2017"
+  ],
+  "name": {
+    "en": "German ZUGFeRD 2.X"
+  },
+  "description": {
+    "en": "Support for the German ZUGFeRD version 2.2 and upwards standard for electronic\ninvoicing. ZUGFeRD 2.2 and Factur-X 1.0 are fully compatible and technically\nidentical formats the use the Factur-X identifier.\n\nCurrently this is just a placeholder addon as the EN16931 addon will provide\nall validation requirements.\n\nFor more information, visit [www.ferd-net.de](https://www.ferd-net.de/)."
+  },
+  "extensions": null,
+  "scenarios": null,
+  "corrections": null
+}