@deuriib/dgii-ecf 0.5.0 → 0.6.0

package/dist/MANIFEST.json

@@ -0,0 +1,122 @@
+{
+  "version": "1.0",
+  "retrieved": "2026-11-02",
+  "source_base": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/",
+  "schemas": [
+    {
+      "file": "e-cf-32.xsd",
+      "name": "e-CF 32",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2032%20v.1.0.xsd",
+      "sha256": "151676df03c61335b4ac1eca97f99395488d57ea92793b49353602871e651f3c",
+      "bytes": 122998,
+      "status": "compiles"
+    },
+    {
+      "file": "e-cf-33.xsd",
+      "name": "e-CF 33",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2033%20v.1.0.xsd",
+      "sha256": "087cd71beba11c19cf548e22b96363cb4aa210dc6f5c3c8a62122a42c88d2866",
+      "bytes": 124484,
+      "status": "compiles"
+    },
+    {
+      "file": "e-cf-34.xsd",
+      "name": "e-CF 34",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2034%20v.1.0.xsd",
+      "sha256": "6c62ebabdea9a6f6d62ae85d9e1c2eb788f44f3f0b61945fe116700c4eaac2da",
+      "bytes": 122024,
+      "status": "compiles"
+    },
+    {
+      "file": "e-cf-41.xsd",
+      "name": "e-CF 41",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2041%20v.1.0.xsd",
+      "sha256": "eae1993c637375bc1cbe80932411d87f5680cd54e77e4d1b2752d72a6c8b2ab3",
+      "bytes": 111171,
+      "status": "compiles"
+    },
+    {
+      "file": "e-cf-43.xsd",
+      "name": "e-CF 43",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2043%20v.1.0.xsd",
+      "sha256": "776f030980c2c50cf0221e9263c55f367c8631727adff00ab45e2c7c1abafc52",
+      "bytes": 96111,
+      "status": "compiles"
+    },
+    {
+      "file": "e-cf-44.xsd",
+      "name": "e-CF 44",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2044%20v.1.0.xsd",
+      "sha256": "19834f37a9f0e2db40f00c80d07c2bf92f9019f23474480f32cef1ba06af4e67",
+      "bytes": 114302,
+      "status": "compiles"
+    },
+    {
+      "file": "e-cf-45.xsd",
+      "name": "e-CF 45",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2045%20v.1.0.xsd",
+      "sha256": "030492cc8ef7d1a09a89b16b241f8e5c4920dfd09c0b629b1db8e68406ecd6ca",
+      "bytes": 121785,
+      "status": "compiles"
+    },
+    {
+      "file": "e-cf-46.xsd",
+      "name": "e-CF 46",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2046%20v.1.0.xsd",
+      "sha256": "e7f8613ade25c7efb88e84d34d7c0ad330d1b22238ad9ef90c80aed01911d67b",
+      "bytes": 115951,
+      "status": "compiles"
+    },
+    {
+      "file": "e-cf-47.xsd",
+      "name": "e-CF 47",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2047%20v.1.0.xsd",
+      "sha256": "14daf18f52f63dd80e439a18fb60a102d74e71243ee90ee253367f61ce8e1994",
+      "bytes": 101382,
+      "status": "compiles"
+    },
+    {
+      "file": "anecf.xsd",
+      "name": "ANECF",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/ANECF%20v.1.0.xsd",
+      "sha256": "af2e6a16c2900dfa55264d6ebec58ccbbbb25c1eb9821ee18ccc44fc142d0e78",
+      "bytes": 5160,
+      "status": "compiles"
+    },
+    {
+      "file": "arecf.xsd",
+      "name": "ARECF",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/ARECF%20v1.0.xsd",
+      "sha256": "c6d186167159110959eb3f54706ecc7462ad9128fc2c3e03440c8352b1c66f10",
+      "bytes": 2871,
+      "status": "compiles"
+    },
+    {
+      "file": "semilla.xsd",
+      "name": "Semilla",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/Semilla%20v.1.0.xsd",
+      "sha256": "bebef2033c930a30c8cef45b513db00403423125a7f3f48e100a73e3e355f67e",
+      "bytes": 487,
+      "status": "compiles"
+    }
+  ],
+  "excluded": [
+    {
+      "name": "e-CF 31",
+      "reason": "The published schema references `IndicadorServicioTodoIncluidoType`, which does not resolve; lxml refuses to compile it.",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/e-CF%2031%20v.1.0.xsd"
+    },
+    {
+      "name": "RFCE 32",
+      "reason": "The published schema contains an invalid pattern facet: `[$0-9]` and the `\\-` escape are not valid XML Schema regex.",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/RFCE%2032%20v.1.0.xsd"
+    },
+    {
+      "name": "ACECF",
+      "reason": "The published schema contains an invalid pattern facet: the `\\-` escape is not valid XML Schema regex.",
+      "source_url": "https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Documentacin%20sobre%20eCF/Documentaci%C3%B3n%20T%C3%A9cnica%20(XSD)/ACECF%20v.1.0.xsd"
+    }
+  ],
+  "mirror": "examples/fixtures/schemas",
+  "mirror_note": "Identical copies for examples and tests. The package copy is what ships; this mirror is the reference used by the repository fixtures."
+}

package/dist/README.md

@@ -0,0 +1,44 @@
+# DGII XML Schemas
+
+Official XML Schemas published by the DGII, mirrored here so examples and tests
+can validate documents without a network round-trip.
+
+- **Source:** <https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Paginas/documentacionSobreE-CF.aspx>
+  → _Documentación Técnica (XSD)_
+- **Retrieved:** 2026-11-02
+- **Version:** 1.0 for every document type
+- **Integrity:** every file is listed with its `sha256` in `MANIFEST.json`.
+
+## Which schemas compile
+
+These twelve compile and are used by `validate_document`:
+
+`e-cf-32`, `e-cf-33`, `e-cf-34`, `e-cf-41`, `e-cf-43`, `e-cf-44`, `e-cf-45`,
+`e-cf-46`, `e-cf-47`, `anecf`, `arecf`, `semilla`.
+
+## Which do not
+
+Three published schemas are **invalid as published** and are kept under
+`upstream-invalid/` for traceability only. They are not bundled in the package
+and `validate_document` reports them as unavailable rather than passing
+silently.
+
+| Schema              | Why it does not compile                                                             |
+| ------------------- | ----------------------------------------------------------------------------------- |
+| `e-CF 31 v.1.0.xsd` | References `IndicadorServicioTodoIncluidoType`, which does not resolve.             |
+| `RFCE 32 v.1.0.xsd` | Invalid pattern facet: `[$0-9]` and the `\-` escape are not valid XML Schema regex. |
+| `ACECF v.1.0.xsd`   | Invalid pattern facet: the `\-` escape is not valid XML Schema regex.               |
+
+Do not "fix" these files in place — patching an official schema silently would
+make the validator disagree with what DGII publishes. If a patch is ever
+adopted, it must be recorded in `MANIFEST.json` with the original and the
+reason.
+
+## Notes
+
+- The package ships its own copy at `packages/python/src/py_dgii_ecf/schemas/`;
+  this mirror exists for examples and tests. Both are byte-identical.
+- `examples/fixtures/invoice-32.xml` validates against `e-cf-32.xsd` **once
+  signed**. The schema ends with an `xs:any` for the signature, so the unsigned
+  fixture is structurally incomplete by design — the test signs it first and
+  asserts the signed document validates.

package/dist/anecf.xsd

@@ -0,0 +1,134 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
+  <xs:element name="ANECF">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element name="Encabezado" maxOccurs="1">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element name="Version" type="versionType" maxOccurs="1"/>
+              <xs:element name="RncEmisor" type="RNCValidation" maxOccurs="1"/>
+              <xs:element name="CantidadeNCFAnulados" type="Num10Validation" maxOccurs="1"/>
+              <xs:element name="FechaHoraAnulacioneNCF" type="DateAndTimeValidation" maxOccurs="1"/>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <xs:element name="DetalleAnulacion" maxOccurs="1">
+           <xs:complexType>
+            <xs:sequence>              
+              <xs:element name="Anulacion" minOccurs="1" maxOccurs="10">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element name="NoLinea" type="Num2Validation" minOccurs="1" maxOccurs="10"/>
+                    <xs:element name="TipoeCF" type="CFType" maxOccurs="1"/>
+                    <xs:element name="TablaRangoSecuenciasAnuladaseNCF" maxOccurs="1">
+                      <xs:complexType>
+                        <xs:sequence>
+                          <xs:element name="Secuencias" minOccurs="1" maxOccurs="10000">
+                            <xs:complexType>
+                              <xs:sequence>
+                                <xs:element name="SecuenciaeNCFDesde" type="AlfaNum13Validation" maxOccurs="1"/>
+                                <xs:element name="SecuenciaeNCFHasta" type="AlfaNum13Validation" maxOccurs="1"/>
+                              </xs:sequence>
+                            </xs:complexType>
+                          </xs:element>
+                        </xs:sequence>
+                      </xs:complexType>
+                    </xs:element>
+                    <xs:element name="CantidadeNCFAnulados" type="Num10Validation" maxOccurs="1"/>
+                  </xs:sequence>
+                </xs:complexType>
+              </xs:element>
+              
+            </xs:sequence>
+          </xs:complexType>                   
+       </xs:element>
+        <xs:any minOccurs="1" maxOccurs="1" processContents="skip" />
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+
+  <!-- Definiciones de Tipos de datos -->
+  <xs:simpleType name="versionType">
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="1.0"/>
+    </xs:restriction>
+  </xs:simpleType>
+  
+  <xs:simpleType name="CFType">
+    <xs:restriction base="xs:integer" >
+      <xs:enumeration value="31"/>
+      <xs:enumeration value="32"/>
+      <xs:enumeration value="33"/>
+      <xs:enumeration value="34"/>
+      <xs:enumeration value="41"/>
+      <xs:enumeration value="43"/>
+      <xs:enumeration value="44"/>
+      <xs:enumeration value="45"/>
+      <xs:enumeration value="46"/>
+      <xs:enumeration value="47"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="SerieType">
+    <xs:restriction base="xs:string" >
+      <xs:enumeration value="B"/>
+      <xs:enumeration value="C"/>
+      <xs:enumeration value="D"/>
+      <xs:enumeration value="F"/>
+      <xs:enumeration value="G"/>
+      <xs:enumeration value="H"/>
+      <xs:enumeration value="I"/>
+      <xs:enumeration value="J"/>
+      <xs:enumeration value="K"/>
+      <xs:enumeration value="L"/>
+      <xs:enumeration value="M"/>
+      <xs:enumeration value="N"/>
+      <xs:enumeration value="O"/>
+      <xs:enumeration value="P"/>
+      <xs:enumeration value="Q"/>
+      <xs:enumeration value="P"/>
+      <xs:enumeration value="R"/>
+      <xs:enumeration value="S"/>
+      <xs:enumeration value="T"/>
+      <xs:enumeration value="U"/>
+      <xs:enumeration value="V"/>
+      <xs:enumeration value="W"/>
+      <xs:enumeration value="X"/>
+      <xs:enumeration value="Y"/>
+      <xs:enumeration value="Z"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="RNCValidation">
+    <xs:restriction base="xs:integer" >
+      <xs:pattern value="(\d{11,11})|(\d{9,9})"></xs:pattern>
+    </xs:restriction>
+  </xs:simpleType>
+  
+   <xs:simpleType name="AlfaNum13Validation">
+    <xs:restriction base="xs:string" >
+      <xs:minLength value="13"/>
+      <xs:maxLength value="13"/>
+    </xs:restriction>
+  </xs:simpleType>
+  
+  <xs:simpleType name="Num10Validation">
+    <xs:restriction base="xs:integer" >
+      <xs:pattern value="(\d{1,10})"></xs:pattern>
+    </xs:restriction>
+  </xs:simpleType>
+  
+  <xs:simpleType name="Num2Validation">
+    <xs:restriction base="xs:integer" >     
+      <xs:pattern value="\d{1,2}"></xs:pattern>
+    </xs:restriction>
+  </xs:simpleType>
+  
+  <xs:simpleType name="DateAndTimeValidation">
+    <xs:restriction base="xs:string">
+      <xs:pattern value="(3[01]|[12][0-9]|0[1-9])-(1[0-2]|0[1-9])-[0-9]{4} (2[0-3]|[01]?[0-9]):([0-5]?[0-9]):([0-5]?[0-9])"></xs:pattern>
+    </xs:restriction>
+  </xs:simpleType>
+
+</xs:schema> 

package/dist/arecf.xsd

@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
+  <xs:element name="ARECF">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element name="DetalleAcusedeRecibo">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element name="Version" type="VersionType" minOccurs = "1" maxOccurs ="1" />
+              <xs:element name="RNCEmisor" type="RNCType"  minOccurs = "1" maxOccurs ="1"/>
+              <xs:element name="RNCComprador" type="RNCType"  minOccurs = "1" maxOccurs ="1"/>              
+              <xs:element name="eNCF" type="eNCFType" minOccurs="1" maxOccurs="1"/>
+              <xs:element name="Estado" type="EstadoType" minOccurs="1" maxOccurs="1"/>
+              <xs:element name="CodigoMotivoNoRecibido" type="CodigoMotivoNoRecibidoType" minOccurs="0"/>
+              <xs:element name="FechaHoraAcuseRecibo" type="DateAndTimeType" minOccurs="1" maxOccurs="1"/>                                                             
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element> 
+        <xs:any minOccurs="0" processContents="skip" />
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+
+  <!-- Definiciones de Tipos de datos -->
+  <xs:simpleType name="VersionType">
+    <xs:restriction base="xs:decimal">
+      <xs:enumeration value="1.0"/>
+      <xs:totalDigits value='2'/>
+      <xs:fractionDigits value="1" />
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="RNCType">
+    <xs:restriction base="xs:integer" >
+      <xs:pattern value='[0-9]{11}|[0-9]{9}'/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="eNCFType">
+    <xs:restriction base="xs:string" >
+      <xs:pattern value="([a-z0-9A-Z]{13,13})|([a-z0-9A-Z]{11,11})|([a-z0-9A-Z]{9,9})*"/>
+      <xs:minLength value="9" />
+      <xs:maxLength value="13" />
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="EstadoType">
+    <xs:restriction base="xs:integer" >
+      <xs:enumeration value="0"/> <!-- e-CF Recibido -->
+      <xs:enumeration value="1"/> <!-- e-CF No Recibido -->
+    </xs:restriction>
+  </xs:simpleType>
+
+   <xs:simpleType name="CodigoMotivoNoRecibidoType">
+    <xs:restriction base="xs:integer" >
+      <xs:enumeration value="1"/> <!-- Error de Especificación -->
+      <xs:enumeration value="2"/> <!-- Error de Firma Digital -->
+      <xs:enumeration value="3"/> <!-- Envío Duplicado -->
+      <xs:enumeration value="4"/> <!-- RNC Comprador no Corresponde -->
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="DateAndTimeType">
+    <xs:restriction base="xs:string">
+      <xs:pattern value="(3[01]|[12][0-9]|0[1-9])-(1[0-2]|0[1-9])-[0-9]{4} (2[0-3]|[01]?[0-9]):([0-5]?[0-9]):([0-5]?[0-9])"/>
+    </xs:restriction>
+  </xs:simpleType>
+  
+</xs:schema>