digifact-sdk 3.0.0__tar.gz → 3.2.0__tar.gz

{digifact_sdk-3.0.0 → digifact_sdk-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: digifact-sdk
-Version: 3.0.0
+Version: 3.2.0
 Summary: Python SDK for Digifact FEL Guatemala e-invoicing API
 Author-email: AALONZOLU <noreply@github.com>
 License: MIT
@@ -275,6 +275,32 @@ result = client.fuel_invoice(
 | `petroleo_amount` | `float\|Decimal` | — | Impuesto PETROLEO por unidad; omitir para ítems sólo-IVA |
 | `petroleo_code` | `str` | `"1"` | `"1"`=SUPER, `"2"`=REGULAR, `"4"`=DIESEL. Obligatorio cuando se omite `petroleo_amount` y `petroleo_rates` está configurado; lanza `DigifactValidationError` si el código no está en el diccionario de tarifas. |
 
+### Exención temporal (Decreto 22-2026)
+
+Del 1 de octubre al 31 de diciembre de 2026, y después hasta agotar el inventario comprado exento, la
+gasolina superior, la regular y el diésel se facturan sin IVA ni IDP. Se activa por ítem con el código de
+unidad gravable exento: `"18"` superior, `"21"` regular con etanol, `"20"` diésel y `"19"` regular sin
+etanol (sólo importadores). `price` es el precio de bomba, ya sin impuestos, y `qty` va en galones. El SDK
+envía ambos impuestos en cero y agrega las frases `9/23` y `4/38`; no hace falta `petroleo_amount` ni `petroleo_rates`.
+
+```python
+from digifact_sdk import fuel_exemption
+
+items = [
+    {"description": "GASOLINA SUPER",   "qty": 10, "price": 30.00, "petroleo_code": "18", "unit_of_measure": "GAL"},
+    {"description": "GASOLINA REGULAR", "qty": 5,  "price": 28.00, "petroleo_code": "21", "unit_of_measure": "GAL"},
+    {"description": "DIESEL",           "qty": 20, "price": 27.00, "petroleo_code": "20", "unit_of_measure": "GAL"},
+]
+result = client.fuel_invoice("CF", items)
+
+# Montos y leyendas obligatorias para un ticket propio (el PDF de Digifact ya las imprime)
+exencion = fuel_exemption(items)
+print(exencion.idp, exencion.iva)   # 93.70 117.60
+print(exencion.leyendas)
+```
+
+Los detalles y las advertencias están en el [README principal](../README.md#exención-temporal-de-combustibles-decreto-22-2026).
+
 ### Subsidio combustible
 
 El subsidio a la gasolina y al diésel **finalizó el jueves 2 de julio de 2026 a las 24:00**, antes de lo
@@ -315,7 +341,7 @@ configurar nada en el caso común.
 | FPEQ        | PEQ        | `2`       | `1`             | Pequeño contribuyente |
 | RDON        | cualquiera | `4`       | `4`             | Donaciones |
 | RECI        | cualquiera | `4`       | `5`             | Recibos (universidades) |
-| NABN        | cualquiera | `1`       | `1`             | Abonos |
+| NABN        | cualquiera | `9`       | `17`            | Abonos |
 | FACT / FCAM / NCRE / NDEB | **GEN** | `1` | `1` | Por defecto: ISR **régimen sobre utilidades trimestrales** |
 | FACT / FCAM / NCRE / NDEB | PEQ | `2` | `1` | |
 | FACT / FCAM / NCRE / NDEB | EXE | `4` | `1` | Exento |
@@ -368,7 +394,9 @@ del RTU en el portal de SAT.
 
 ## Referencia de métodos
 
-Todos los métodos de emisión devuelven `DteResult` con `result.auth_number`, `series`, `number`, `issue_datetime`, `raw`.
+Todos los métodos de emisión devuelven `DteResult` con `result.auth_number`, `series`, `number`, `issue_datetime`, `enrolled_timestamp`, `additional_info` (acuse de la SAT) y `raw`.
+
+`invoice()`, `cca_invoice()`, `fuel_invoice()`, `credit_note()` y `debit_note()` aceptan además `internal_reference` y `validate_internal_reference` (ver [Emisión sin duplicados](#emisión-sin-duplicados-referencia-interna)).
 
 | Método | Firma | Descripción |
 |--------|-------|-------------|
@@ -383,6 +411,7 @@ Todos los métodos de emisión devuelven `DteResult` con `result.auth_number`, `
 | `lookup_cui()` | `lookup_cui(cui)` | Consulta SAT por CUI (DPI). Devuelve `{"cui","name","status"}`. El nombre viene como `"APELLIDOS, NOMBRES"`, tal como lo registra SAT. |
 | `get_dte()` | `get_dte(auth_number, fmt="JSON")` | Recupera el DTE (`"JSON"`, `"XML"`, `"HTML"`, `"PDF"`). |
 | `get_dte_info()` | `get_dte_info(auth_number)` | Metadatos del DTE. |
+| `find_by_internal_reference()` | `find_by_internal_reference(reference, issued_on)` | DTE certificados con esa referencia interna ese día (`SHARED_GETDTEINFO_BY_INTERNALID`). Devuelve `list[dict]`, vacía si no hay. |
 
 ### Parámetros comunes
 
@@ -390,6 +419,39 @@ Todos los métodos de emisión devuelven `DteResult` con `result.auth_number`, `
 - **`items`**: lista de dicts con `description` (str, req), `price` (float/Decimal, req), `qty` (1), `type` (`"Servicio"`/`"Bien"`), `unit_of_measure` (`"UNI"`), `discount` (opcional).
 - **`origin`** (NCRE/NDEB): `{"auth_number": ..., "date": "YYYY-MM-DD", "series": ..., "number": ...}`.
 
+## Emisión sin duplicados (referencia interna)
+
+Digifact guarda una referencia interna por DTE (el `Code` de la ADENDA). Con `validate_internal_reference=True`
+rechaza un segundo DTE con la misma referencia, así que un envío que se quedó sin respuesta se puede repetir sin
+emitir dos veces:
+
+```python
+import uuid
+from digifact_sdk import DigifactDuplicateReferenceError
+
+referencia = str(uuid.uuid4())  # un GUID; Digifact también acepta referencias más cortas
+try:
+    result = client.invoice("CF", items, internal_reference=referencia, validate_internal_reference=True)
+except DigifactDuplicateReferenceError:
+    # ya se había enviado: el DTE pudo quedar certificado
+    filas = client.find_by_internal_reference(referencia, issued_on="2026-11-03")
+```
+
+* Sin `internal_reference` el payload no cambia: se envía la referencia fija de siempre con `NO_VALIDAR`.
+* NCRE, NDEB, FCAM, FESP y CCA reciben una ADENDA mínima con la referencia, junto a su complemento.
+* `SHARED_GETDTEINFO_BY_INTERNALID` y el error `9022` no están en la documentación de Digifact para
+  Guatemala, pero se verificaron en el ambiente de pruebas el 3 de noviembre de 2026: el duplicado llega con
+  `code` 3000 y `[9022]` en la descripción, y la consulta encuentra el DTE sin prefijo en `DATA2`.
+
+## Token y reintentos
+
+* Si Digifact responde `401` (token vencido) y el cliente tiene `password`, el SDK inicia sesión otra vez y repite la
+  petición una sola vez. Con solo `token`, lanza `DigifactAuthError`.
+* `client.token` devuelve el token vigente, para guardarlo en un caché compartido y pasarlo como `token=` a otros
+  procesos.
+* Los errores HTTP traen `exc.code` (el estado HTTP) y `exc.retryable`: `True` para 5xx, `False` para 4xx (`400`,
+  `406` documento inválido, `415` tipo de contenido).
+
 ## Establecimiento (sucursal)
 
 Cada NIT puede tener varios establecimientos registrados en el RTU. Configúralos al crear el cliente:
@@ -434,7 +496,8 @@ python -m pytest tests/ -v
 from digifact_sdk import (
     DigifactError,          # base
     DigifactAuthError,      # fallo de autenticación
-    DigifactApiError,       # error HTTP / de API
+    DigifactApiError,       # error HTTP / de API (.retryable)
+    DigifactDuplicateReferenceError, # referencia interna ya enviada (9022)
     DigifactValidationError, # rechazo de SAT
     DigifactNitNotFoundError, # NIT no encontrado
 )

{digifact_sdk-3.0.0 → digifact_sdk-3.2.0}/README.md

@@ -251,6 +251,32 @@ result = client.fuel_invoice(
 | `petroleo_amount` | `float\|Decimal` | — | Impuesto PETROLEO por unidad; omitir para ítems sólo-IVA |
 | `petroleo_code` | `str` | `"1"` | `"1"`=SUPER, `"2"`=REGULAR, `"4"`=DIESEL. Obligatorio cuando se omite `petroleo_amount` y `petroleo_rates` está configurado; lanza `DigifactValidationError` si el código no está en el diccionario de tarifas. |
 
+### Exención temporal (Decreto 22-2026)
+
+Del 1 de octubre al 31 de diciembre de 2026, y después hasta agotar el inventario comprado exento, la
+gasolina superior, la regular y el diésel se facturan sin IVA ni IDP. Se activa por ítem con el código de
+unidad gravable exento: `"18"` superior, `"21"` regular con etanol, `"20"` diésel y `"19"` regular sin
+etanol (sólo importadores). `price` es el precio de bomba, ya sin impuestos, y `qty` va en galones. El SDK
+envía ambos impuestos en cero y agrega las frases `9/23` y `4/38`; no hace falta `petroleo_amount` ni `petroleo_rates`.
+
+```python
+from digifact_sdk import fuel_exemption
+
+items = [
+    {"description": "GASOLINA SUPER",   "qty": 10, "price": 30.00, "petroleo_code": "18", "unit_of_measure": "GAL"},
+    {"description": "GASOLINA REGULAR", "qty": 5,  "price": 28.00, "petroleo_code": "21", "unit_of_measure": "GAL"},
+    {"description": "DIESEL",           "qty": 20, "price": 27.00, "petroleo_code": "20", "unit_of_measure": "GAL"},
+]
+result = client.fuel_invoice("CF", items)
+
+# Montos y leyendas obligatorias para un ticket propio (el PDF de Digifact ya las imprime)
+exencion = fuel_exemption(items)
+print(exencion.idp, exencion.iva)   # 93.70 117.60
+print(exencion.leyendas)
+```
+
+Los detalles y las advertencias están en el [README principal](../README.md#exención-temporal-de-combustibles-decreto-22-2026).
+
 ### Subsidio combustible
 
 El subsidio a la gasolina y al diésel **finalizó el jueves 2 de julio de 2026 a las 24:00**, antes de lo
@@ -291,7 +317,7 @@ configurar nada en el caso común.
 | FPEQ        | PEQ        | `2`       | `1`             | Pequeño contribuyente |
 | RDON        | cualquiera | `4`       | `4`             | Donaciones |
 | RECI        | cualquiera | `4`       | `5`             | Recibos (universidades) |
-| NABN        | cualquiera | `1`       | `1`             | Abonos |
+| NABN        | cualquiera | `9`       | `17`            | Abonos |
 | FACT / FCAM / NCRE / NDEB | **GEN** | `1` | `1` | Por defecto: ISR **régimen sobre utilidades trimestrales** |
 | FACT / FCAM / NCRE / NDEB | PEQ | `2` | `1` | |
 | FACT / FCAM / NCRE / NDEB | EXE | `4` | `1` | Exento |
@@ -344,7 +370,9 @@ del RTU en el portal de SAT.
 
 ## Referencia de métodos
 
-Todos los métodos de emisión devuelven `DteResult` con `result.auth_number`, `series`, `number`, `issue_datetime`, `raw`.
+Todos los métodos de emisión devuelven `DteResult` con `result.auth_number`, `series`, `number`, `issue_datetime`, `enrolled_timestamp`, `additional_info` (acuse de la SAT) y `raw`.
+
+`invoice()`, `cca_invoice()`, `fuel_invoice()`, `credit_note()` y `debit_note()` aceptan además `internal_reference` y `validate_internal_reference` (ver [Emisión sin duplicados](#emisión-sin-duplicados-referencia-interna)).
 
 | Método | Firma | Descripción |
 |--------|-------|-------------|
@@ -359,6 +387,7 @@ Todos los métodos de emisión devuelven `DteResult` con `result.auth_number`, `
 | `lookup_cui()` | `lookup_cui(cui)` | Consulta SAT por CUI (DPI). Devuelve `{"cui","name","status"}`. El nombre viene como `"APELLIDOS, NOMBRES"`, tal como lo registra SAT. |
 | `get_dte()` | `get_dte(auth_number, fmt="JSON")` | Recupera el DTE (`"JSON"`, `"XML"`, `"HTML"`, `"PDF"`). |
 | `get_dte_info()` | `get_dte_info(auth_number)` | Metadatos del DTE. |
+| `find_by_internal_reference()` | `find_by_internal_reference(reference, issued_on)` | DTE certificados con esa referencia interna ese día (`SHARED_GETDTEINFO_BY_INTERNALID`). Devuelve `list[dict]`, vacía si no hay. |
 
 ### Parámetros comunes
 
@@ -366,6 +395,39 @@ Todos los métodos de emisión devuelven `DteResult` con `result.auth_number`, `
 - **`items`**: lista de dicts con `description` (str, req), `price` (float/Decimal, req), `qty` (1), `type` (`"Servicio"`/`"Bien"`), `unit_of_measure` (`"UNI"`), `discount` (opcional).
 - **`origin`** (NCRE/NDEB): `{"auth_number": ..., "date": "YYYY-MM-DD", "series": ..., "number": ...}`.
 
+## Emisión sin duplicados (referencia interna)
+
+Digifact guarda una referencia interna por DTE (el `Code` de la ADENDA). Con `validate_internal_reference=True`
+rechaza un segundo DTE con la misma referencia, así que un envío que se quedó sin respuesta se puede repetir sin
+emitir dos veces:
+
+```python
+import uuid
+from digifact_sdk import DigifactDuplicateReferenceError
+
+referencia = str(uuid.uuid4())  # un GUID; Digifact también acepta referencias más cortas
+try:
+    result = client.invoice("CF", items, internal_reference=referencia, validate_internal_reference=True)
+except DigifactDuplicateReferenceError:
+    # ya se había enviado: el DTE pudo quedar certificado
+    filas = client.find_by_internal_reference(referencia, issued_on="2026-11-03")
+```
+
+* Sin `internal_reference` el payload no cambia: se envía la referencia fija de siempre con `NO_VALIDAR`.
+* NCRE, NDEB, FCAM, FESP y CCA reciben una ADENDA mínima con la referencia, junto a su complemento.
+* `SHARED_GETDTEINFO_BY_INTERNALID` y el error `9022` no están en la documentación de Digifact para
+  Guatemala, pero se verificaron en el ambiente de pruebas el 3 de noviembre de 2026: el duplicado llega con
+  `code` 3000 y `[9022]` en la descripción, y la consulta encuentra el DTE sin prefijo en `DATA2`.
+
+## Token y reintentos
+
+* Si Digifact responde `401` (token vencido) y el cliente tiene `password`, el SDK inicia sesión otra vez y repite la
+  petición una sola vez. Con solo `token`, lanza `DigifactAuthError`.
+* `client.token` devuelve el token vigente, para guardarlo en un caché compartido y pasarlo como `token=` a otros
+  procesos.
+* Los errores HTTP traen `exc.code` (el estado HTTP) y `exc.retryable`: `True` para 5xx, `False` para 4xx (`400`,
+  `406` documento inválido, `415` tipo de contenido).
+
 ## Establecimiento (sucursal)
 
 Cada NIT puede tener varios establecimientos registrados en el RTU. Configúralos al crear el cliente:
@@ -410,7 +472,8 @@ python -m pytest tests/ -v
 from digifact_sdk import (
     DigifactError,          # base
     DigifactAuthError,      # fallo de autenticación
-    DigifactApiError,       # error HTTP / de API
+    DigifactApiError,       # error HTTP / de API (.retryable)
+    DigifactDuplicateReferenceError, # referencia interna ya enviada (9022)
     DigifactValidationError, # rechazo de SAT
     DigifactNitNotFoundError, # NIT no encontrado
 )

digifact_sdk-3.2.0/digifact_sdk/__init__.py

@@ -0,0 +1,36 @@
+"""Digifact FEL Guatemala SDK — Python package."""
+from .builder import (
+    FUEL_EXEMPT_DIESEL,
+    FUEL_EXEMPT_REGULAR_ETHANOL,
+    FUEL_EXEMPT_REGULAR_IMPORTER,
+    FUEL_EXEMPT_SUPER,
+    FuelExemption,
+    fuel_exemption,
+)
+from .client import DigifactClient, DteResult
+from .exceptions import (
+    DigifactApiError,
+    DigifactAuthError,
+    DigifactDuplicateReferenceError,
+    DigifactError,
+    DigifactNitNotFoundError,
+    DigifactValidationError,
+)
+
+__version__ = "3.2.0"
+__all__ = [
+    "DigifactClient",
+    "DteResult",
+    "DigifactError",
+    "DigifactAuthError",
+    "DigifactApiError",
+    "DigifactDuplicateReferenceError",
+    "DigifactValidationError",
+    "DigifactNitNotFoundError",
+    "FuelExemption",
+    "fuel_exemption",
+    "FUEL_EXEMPT_SUPER",
+    "FUEL_EXEMPT_REGULAR_IMPORTER",
+    "FUEL_EXEMPT_DIESEL",
+    "FUEL_EXEMPT_REGULAR_ETHANOL",
+]

{digifact_sdk-3.0.0 → digifact_sdk-3.2.0}/digifact_sdk/builder.py

@@ -7,7 +7,8 @@ Key intentional API typos preserved from the SAT/Digifact spec:
 """
 from __future__ import annotations
 
-from decimal import Decimal
+from dataclasses import dataclass
+from decimal import ROUND_HALF_UP, Decimal
 from typing import Any
 
 from .tax import LineCalc, FuelLineCalc, InvoiceTotals, fmt, gt_now
@@ -27,6 +28,93 @@ def _adenda_code(doc_type: str) -> str:
     return ADENDA_CODE_ALT if doc_type in _ALT_ADENDA_TYPES else ADENDA_CODE_STD
 
 
+VALIDATE_REFERENCE = "VALIDAR"
+SKIP_REFERENCE_VALIDATION = "NO_VALIDAR"
+_VALIDATION_FLAG = "VALIDAR_REFERENCIA_INTERNA"
+
+
+def apply_internal_reference(payload: dict, reference: str, *, validate: bool) -> dict:
+    """Set the Digifact internal reference (ADENDA ``Code``) of a built payload.
+
+    With ``validate=True`` Digifact rejects a second DTE with the same
+    reference (error 9022), which makes retries safe. DTE types whose builder
+    carries no ADENDA (NCRE, NDEB, FCAM, FESP, CCA) get a minimal one.
+    """
+    flag = {"Name": _VALIDATION_FLAG, "Data": None, "Value": VALIDATE_REFERENCE if validate else SKIP_REFERENCE_VALIDATION}
+    document_info = payload.get("AdditionalDocumentInfo") or {}
+    entries = document_info.setdefault("AdditionalInfo", [])
+    adenda = next((entry for entry in entries if entry.get("Type") == "ADENDA"), None)
+    if adenda is None:
+        entries.append({"Code": reference, "Type": "ADENDA", "AditionalInfo": [flag]})
+    else:
+        adenda["Code"] = reference
+        others = [info for info in adenda.get("AditionalInfo") or [] if info.get("Name") != _VALIDATION_FLAG]
+        adenda["AditionalInfo"] = [flag, *others]
+    payload["AdditionalDocumentInfo"] = document_info
+    return payload
+
+
+# ── Exención temporal de combustibles (Decreto 22-2026) ──────────────────────
+FUEL_EXEMPT_SUPER = "18"
+FUEL_EXEMPT_REGULAR_IMPORTER = "19"
+FUEL_EXEMPT_DIESEL = "20"
+FUEL_EXEMPT_REGULAR_ETHANOL = "21"
+
+_FUEL_EXEMPT_IDP_RATES = {
+    FUEL_EXEMPT_SUPER: Decimal("4.70"),
+    FUEL_EXEMPT_REGULAR_IMPORTER: Decimal("4.60"),
+    FUEL_EXEMPT_DIESEL: Decimal("1.30"),
+    FUEL_EXEMPT_REGULAR_ETHANOL: Decimal("4.14"),
+}
+_FUEL_EXEMPTION_FRASES = [
+    {"tipo_frase": "9", "escenario": "23"},
+    {"tipo_frase": "4", "escenario": "38"},
+]
+_IVA_EXEMPT_CODE = "2"
+_IVA_RATE = Decimal("0.12")
+_CENTS = Decimal("0.01")
+
+
+def is_exempt_fuel_item(item: dict) -> bool:
+    return str(item.get("petroleo_code", "")) in _FUEL_EXEMPT_IDP_RATES
+
+
+@dataclass(frozen=True)
+class FuelExemption:
+    """Taxes a fuel sale would have paid without the Decreto 22-2026 exemption."""
+
+    iva: Decimal
+    idp: Decimal
+
+    @property
+    def leyendas(self) -> list[str]:
+        if not self.iva and not self.idp:
+            return []
+        return [
+            f"Monto de exención temporal de IDP aplicada: Q {fmt(self.idp, 2)}, según Decreto Número 22-2026",
+            f"Monto de exención temporal de IVA aplicada: Q {fmt(self.iva, 2)}, según Decreto Número 22-2026",
+        ]
+
+
+def fuel_exemption(items: list[dict]) -> FuelExemption:
+    """Return the exempted IVA and IDP for the exempt fuel items in ``items``.
+
+    ``qty`` must be in gallons: the IDP rates are per gallon.
+    """
+    exempt_total = Decimal("0")
+    idp = Decimal("0")
+    for item in items:
+        if not is_exempt_fuel_item(item):
+            continue
+        qty = Decimal(str(item.get("qty", 1)))
+        exempt_total += qty * Decimal(str(item["price"]))
+        idp += qty * _FUEL_EXEMPT_IDP_RATES[str(item["petroleo_code"])]
+    return FuelExemption(
+        iva=(exempt_total * _IVA_RATE).quantize(_CENTS, rounding=ROUND_HALF_UP),
+        idp=idp.quantize(_CENTS, rounding=ROUND_HALF_UP),
+    )
+
+
 # ── Frases ───────────────────────────────────────────────────────────────────
 
 
@@ -59,19 +147,25 @@ def resolve_fuel_frases(
     frases: list[dict] | None,
     tipo_frase: str | None,
     escenario: str | None,
+    *,
+    exempt: bool = False,
 ) -> list[dict]:
     """Return the final deduplicated frases list for a fuel invoice.
 
     Called only after mutual-exclusivity validation (frases vs tipo_frase/escenario).
+    ``exempt`` appends the Decreto 22-2026 frases, mandatory with exempt fuel codes.
     """
     if frases is not None:
         if not frases:
             from .exceptions import DigifactValidationError
             raise DigifactValidationError("frases must contain at least one TipoFrase/Escenario pair")
-        return _uniq_frases(frases)
-    result: list[dict] = []
-    if tipo_frase is not None and escenario is not None:
-        result.append({"tipo_frase": tipo_frase, "escenario": escenario})
+        result = list(frases)
+    else:
+        result = []
+        if tipo_frase is not None and escenario is not None:
+            result.append({"tipo_frase": tipo_frase, "escenario": escenario})
+    if exempt:
+        result.extend(_FUEL_EXEMPTION_FRASES)
     return _uniq_frases(result)
 
 
@@ -91,7 +185,7 @@ def default_frase(doc_type: str, afiliacion: str = "GEN") -> tuple[str, str] | N
     if doc_type == "RECI":
         return ("4", "5")
     if doc_type == "NABN":
-        return ("1", "1")
+        return ("9", "17")
     # FACT, NCRE, NDEB, FCAM, FACT+CCA, FACT+combustible
     if afi == "PEQ":
         return ("2", "1")
@@ -667,6 +761,8 @@ def build_nabn(
     items: list[dict],
     *,
     afiliacion: str = "GEN",
+    tipo_frase: str | None = "9",
+    escenario: str | None = "17",
     amount_str: str = "",
     observaciones: str = "-",
     seller_email: str | None = None,
@@ -676,14 +772,13 @@ def build_nabn(
     issue_dt, _, _ = gt_now()
     line_items, totals = _build_items(items, taxable=False)
 
-    # NABN: uses TipoFrase=1, Escenario=1 in seller (matches smoke runner)
     seller = _build_seller(
         taxid,
         seller_name,
         seller_address,
         afiliacion=afiliacion,
-        tipo_frase="1",
-        escenario="1",
+        tipo_frase=tipo_frase,
+        escenario=escenario,
         frases=frases,
         email=seller_email,
     )
@@ -1057,8 +1152,9 @@ def _build_fuel_items(
     """Build Items list for a combustible (fuel) invoice.
 
     Items with 'petroleo_amount' are treated as fuel items and receive two
-    Tax entries (IVA + PETROLEO). Items without 'petroleo_amount' are treated
-    as regular IVA-only items. Both types may coexist in the same invoice.
+    Tax entries (IVA + PETROLEO). Items whose 'petroleo_code' is an exempt
+    code (18-21) carry both taxes at zero. Items without 'petroleo_amount' are
+    treated as regular IVA-only items. All types may coexist in the same invoice.
 
     Returns (line_items, grand_total_str, total_iva_str, total_petroleo_str).
     """
@@ -1083,7 +1179,31 @@ def _build_fuel_items(
             "Discounts":     None,
         }
 
-        if "petroleo_amount" in item:
+        if is_exempt_fuel_item(item):
+            lc = LineCalc(qty, price, taxable=False)
+
+            built["Qty"]   = lc.f_qty()
+            built["Price"] = lc.f_price()
+            built["Taxes"] = {
+                "Tax": [
+                    {
+                        "Code":          _IVA_EXEMPT_CODE,
+                        "Description":   "IVA",
+                        "TaxableAmount": lc.f_line_total(),
+                        "Amount":        lc.f_iva(),
+                    },
+                    {
+                        "Code":          str(item["petroleo_code"]),
+                        "Description":   "PETROLEO",
+                        "TaxableAmount": lc.f_qty(),
+                        "Amount":        fmt(0),
+                    },
+                ]
+            }
+            built["Totals"] = {"TotalItem": lc.f_line_total()}
+
+            grand_total += lc.line_total
+        elif "petroleo_amount" in item:
             petrol_per_unit = Decimal(str(item["petroleo_amount"]))
             petrol_code     = str(item.get("petroleo_code", "1"))
 
@@ -1176,6 +1296,11 @@ def build_fact_combustible(
     "4"=DIESEL; default "1"). Items without ``petroleo_amount`` are treated as
     regular IVA-only items and may coexist in the same invoice.
 
+    Fuel sold under the Decreto 22-2026 exemption uses the exempt codes instead
+    ("18"=SUPER, "21"=REGULAR with ethanol, "20"=DIESEL, "19"=REGULAR for
+    importers): ``price`` is the pump price without IVA or IDP, no
+    ``petroleo_amount`` is needed, and frases 9/23 and 4/38 are added.
+
     ``frases`` and ``tipo_frase``/``escenario`` are mutually exclusive.
 
     Example fuel item::
@@ -1201,7 +1326,8 @@ def build_fact_combustible(
     tf = tipo_frase if tipo_frase is not None else def_tf
     es = escenario if escenario is not None else def_es
 
-    resolved_frases = resolve_fuel_frases(frases, tf, es)
+    has_exempt_fuel = any(is_exempt_fuel_item(item) for item in items)
+    resolved_frases = resolve_fuel_frases(frases, tf, es, exempt=has_exempt_fuel)
 
     # All frases go into Seller.AdditionlInfo as repeated pairs —
     # that is the field the API reads to generate <dte:Frases> in the certified XML.
@@ -1215,7 +1341,7 @@ def build_fact_combustible(
     )
 
     total_tax: list[dict] = [{"Description": "IVA", "Amount": total_iva}]
-    if float(total_petroleo) > 0.0:
+    if float(total_petroleo) > 0.0 or has_exempt_fuel:
         total_tax.append({"Description": "PETROLEO", "Amount": total_petroleo})
 
     combustible_payload: dict[str, Any] = {