#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import base64
import hashlib
import os
import subprocess
from pathlib import Path
from lxml import etree
from M2Crypto.RSA import load_key_string
NS_CFDI = "http://www.sat.gob.mx/cfd/4"
NS_CCB11 = "http://www.sat.gob.mx/ConsumoDeCombustibles11"
NS_XSI = "http://www.w3.org/2001/XMLSchema-instance"
DATOS = {
"Comprobante": {
"Version": "4.0",
"Serie": "Serie",
"Folio": "Folio",
"Fecha": "2026-03-24T00:00:10",
"FormaPago": "99",
"SubTotal": "200",
"Descuento": "1",
"Moneda": "MXN",
"TipoCambio": "1",
"Total": "230.84",
"TipoDeComprobante": "I",
"Exportacion": "01",
"MetodoPago": "PPD",
"LugarExpedicion": "90000",
"CondicionesDePago": "CondicionesDePago",
},
"Emisor": {
"Rfc": "EKU9003173C9",
"Nombre": "ESCUELA KEMPER URGATE",
"RegimenFiscal": "601",
},
"Receptor": {
"Rfc": "MASO451221PM4",
"Nombre": "MARIA OLIVIA MARTINEZ SAGAZ",
"DomicilioFiscalReceptor": "80290",
"RegimenFiscalReceptor": "616",
"UsoCFDI": "S01",
},
"Concepto": {
"ClaveProdServ": "84111506",
"Cantidad": "1",
"ClaveUnidad": "LTR",
"Unidad": "Litro",
"Descripcion": "Litro",
"ValorUnitario": "200.00",
"Descuento": "1",
"Importe": "200.00",
"ObjetoImp": "02",
},
"TrasladoConcepto": {
"Base": "199",
"Importe": "31.84",
"Impuesto": "002",
"TasaOCuota": "0.160000",
"TipoFactor": "Tasa",
},
"Impuestos": {
"TotalImpuestosTrasladados": "31.84",
},
"TrasladoGlobal": {
"Base": "199",
"Importe": "31.84",
"Impuesto": "002",
"TasaOCuota": "0.160000",
"TipoFactor": "Tasa",
},
"ConsumoDeCombustibles": {
"version": "1.1",
"tipoOperacion": "monedero electrónico",
"numeroDeCuenta": "123456",
"subTotal": "10.00",
"total": "10.00",
},
"ConceptoCombustible": {
"identificador": "987654321",
"fecha": "2020-01-01T10:00:00",
"rfc": "CCT060731DD1",
"claveEstacion": "98745",
"tipoCombustible": "3",
"cantidad": "1.000",
"nombreCombustible": "Premium",
"folioOperacion": "0000001",
"valorUnitario": "5.00",
"importe": "5.00",
},
"Determinado": {
"impuesto": "IEPS",
"tasaOCuota": "0.08",
"importe": "0.08",
},
}
# RFC del enajenante de combustible (debe tener obligaciones vigentes para este complemento).
DATOS["ConceptoCombustible"]["rfc"] = os.environ.get(
"CCB11_RFC_ENAJENANTE", DATOS["ConceptoCombustible"]["rfc"]
).strip().upper()
def _leer_certificado(cer_path: Path) -> tuple[str, str]:
cert_bytes = cer_path.read_bytes()
cert_b64 = base64.b64encode(cert_bytes).decode("utf-8").replace("\n", "").replace("\r", "")
serial_raw = subprocess.check_output(
["openssl", "x509", "-inform", "DER", "-in", str(cer_path), "-noout", "-serial"],
text=True,
).strip()
serial_hex = serial_raw.split("=", 1)[1].strip()
no_certificado = bytes.fromhex(serial_hex).decode("latin1").upper()
return cert_b64, no_certificado
def _parser_xslt_complements(xslt_path: Path):
class LocalResolver(etree.Resolver):
def resolve(self, url, pubid, context):
if "sitio_internet/cfd" in url or "sat.gob.mx" in url:
filename = url.split("/")[-1]
local_path = xslt_path.parent / "complements" / filename
if local_path.exists():
return self.resolve_filename(str(local_path), context)
return None
parser = etree.XMLParser(resolve_entities=True, remove_blank_text=False)
parser.resolvers.add(LocalResolver())
return parser
def _cadena_original(xml_path: Path, xslt_path: Path) -> str:
xml_doc = etree.parse(str(xml_path))
xslt_doc = etree.parse(str(xslt_path), parser=_parser_xslt_complements(xslt_path))
transform = etree.XSLT(xslt_doc)
return (
str(transform(xml_doc))
.replace('<?xml version="1.0" encoding="UTF-8"?>', "")
.replace("\n", "")
.strip()
)
def _sello(cadena: str, key_path: Path) -> str:
key_data = key_path.read_text(encoding="utf-8")
rsa = load_key_string(key_data.encode("utf-8"))
digest = hashlib.sha256(cadena.encode("utf-8")).digest()
firma = rsa.sign(digest, "sha256")
return base64.b64encode(firma).decode("utf-8")
def generar_xml(output_path: Path, cer_path: Path, key_path: Path, xslt_path: Path) -> Path:
etree.register_namespace("cfdi", NS_CFDI)
etree.register_namespace("consumodecombustibles11", NS_CCB11)
etree.register_namespace("xsi", NS_XSI)
cert_b64, no_certificado = _leer_certificado(cer_path)
root_attrs = {
**DATOS["Comprobante"],
"NoCertificado": no_certificado,
"Certificado": cert_b64,
"Sello": "",
f"{{{NS_XSI}}}schemaLocation": (
f"{NS_CFDI} http://www.sat.gob.mx/sitio_internet/cfd/4/cfdv40.xsd "
f"{NS_CCB11} http://www.sat.gob.mx/sitio_internet/cfd/consumodecombustibles/consumodeCombustibles11.xsd"
),
}
root = etree.Element(
f"{{{NS_CFDI}}}Comprobante",
root_attrs,
nsmap={
"cfdi": NS_CFDI,
"consumodecombustibles11": NS_CCB11,
"xsi": NS_XSI,
},
)
etree.SubElement(root, f"{{{NS_CFDI}}}Emisor", **DATOS["Emisor"])
etree.SubElement(root, f"{{{NS_CFDI}}}Receptor", **DATOS["Receptor"])
conceptos = etree.SubElement(root, f"{{{NS_CFDI}}}Conceptos")
concepto = etree.SubElement(conceptos, f"{{{NS_CFDI}}}Concepto", **DATOS["Concepto"])
imp_concepto = etree.SubElement(concepto, f"{{{NS_CFDI}}}Impuestos")
traslados_concepto = etree.SubElement(imp_concepto, f"{{{NS_CFDI}}}Traslados")
etree.SubElement(traslados_concepto, f"{{{NS_CFDI}}}Traslado", **DATOS["TrasladoConcepto"])
imp_global = etree.SubElement(root, f"{{{NS_CFDI}}}Impuestos", **DATOS["Impuestos"])
traslados_global = etree.SubElement(imp_global, f"{{{NS_CFDI}}}Traslados")
etree.SubElement(traslados_global, f"{{{NS_CFDI}}}Traslado", **DATOS["TrasladoGlobal"])
complemento = etree.SubElement(root, f"{{{NS_CFDI}}}Complemento")
ccb = etree.SubElement(
complemento,
f"{{{NS_CCB11}}}ConsumoDeCombustibles",
**DATOS["ConsumoDeCombustibles"],
)
ccb_conceptos = etree.SubElement(ccb, f"{{{NS_CCB11}}}Conceptos")
ccb_concepto = etree.SubElement(
ccb_conceptos,
f"{{{NS_CCB11}}}ConceptoConsumoDeCombustibles",
**DATOS["ConceptoCombustible"],
)
determinados = etree.SubElement(ccb_concepto, f"{{{NS_CCB11}}}Determinados")
etree.SubElement(determinados, f"{{{NS_CCB11}}}Determinado", **DATOS["Determinado"])
output_path.parent.mkdir(parents=True, exist_ok=True)
etree.ElementTree(root).write(
str(output_path),
encoding="utf-8",
pretty_print=True,
xml_declaration=True,
)
cadena = _cadena_original(output_path, xslt_path)
sello = _sello(cadena, key_path)
tree = etree.parse(str(output_path))
tree.getroot().set("Sello", sello)
tree.write(str(output_path), encoding="utf-8", pretty_print=True, xml_declaration=True)
return output_path
if __name__ == "__main__":
salida = Path("xml/ConsumoDeCombustibles11.xml")
cer = Path("certificados/EKU9003173C9/EKU9003173C9.cer")
key = Path("certificados/EKU9003173C9/EKU9003173C9.pem")
xslt = Path("xslt/cfdi/v40/cadenaoriginal.xslt")
archivo = generar_xml(salida, cer, key, xslt)
print(f"XML generado: {archivo}")
<?php
declare(strict_types=1);
date_default_timezone_set('America/Mexico_City');
const NS_CFDI = 'http://www.sat.gob.mx/cfd/4';
const NS_CCB11 = 'http://www.sat.gob.mx/ConsumoDeCombustibles11';
const NS_XSI = 'http://www.w3.org/2001/XMLSchema-instance';
$DATA = [
'Comprobante' => [
'Version' => '4.0',
'Serie' => 'Serie',
'Folio' => 'Folio',
'Fecha' => '2026-03-24T00:00:10',
'FormaPago' => '99',
'SubTotal' => '200',
'Descuento' => '1',
'Moneda' => 'MXN',
'TipoCambio' => '1',
'Total' => '230.84',
'TipoDeComprobante' => 'I',
'Exportacion' => '01',
'MetodoPago' => 'PPD',
'LugarExpedicion' => '90000',
'CondicionesDePago' => 'CondicionesDePago',
],
'Emisor' => [
'Rfc' => 'EKU9003173C9',
'Nombre' => 'ESCUELA KEMPER URGATE',
'RegimenFiscal' => '601',
],
'Receptor' => [
'Rfc' => 'MASO451221PM4',
'Nombre' => 'MARIA OLIVIA MARTINEZ SAGAZ',
'DomicilioFiscalReceptor' => '80290',
'RegimenFiscalReceptor' => '616',
'UsoCFDI' => 'S01',
],
'Concepto' => [
'ClaveProdServ' => '84111506',
'Cantidad' => '1',
'ClaveUnidad' => 'LTR',
'Unidad' => 'Litro',
'Descripcion' => 'Litro',
'ValorUnitario' => '200.00',
'Descuento' => '1',
'Importe' => '200.00',
'ObjetoImp' => '02',
],
'TrasladoConcepto' => [
'Base' => '199',
'Importe' => '31.84',
'Impuesto' => '002',
'TasaOCuota' => '0.160000',
'TipoFactor' => 'Tasa',
],
'Impuestos' => [
'TotalImpuestosTrasladados' => '31.84',
],
'TrasladoGlobal' => [
'Base' => '199',
'Importe' => '31.84',
'Impuesto' => '002',
'TasaOCuota' => '0.160000',
'TipoFactor' => 'Tasa',
],
'ConsumoDeCombustibles' => [
'version' => '1.1',
'tipoOperacion' => 'monedero electrónico',
'numeroDeCuenta' => '123456',
'subTotal' => '10.00',
'total' => '10.00',
],
'ConceptoCombustible' => [
'identificador' => '987654321',
'fecha' => '2020-01-01T10:00:00',
'rfc' => 'CCT060731DD1',
'claveEstacion' => '98745',
'tipoCombustible' => '3',
'cantidad' => '1.000',
'nombreCombustible' => 'Premium',
'folioOperacion' => '0000001',
'valorUnitario' => '5.00',
'importe' => '5.00',
],
'Determinado' => [
'impuesto' => 'IEPS',
'tasaOCuota' => '0.08',
'importe' => '0.08',
],
];
// RFC del enajenante de combustible (debe tener obligaciones vigentes para este complemento).
$envRfcEnajenante = getenv('CCB11_RFC_ENAJENANTE');
if ($envRfcEnajenante !== false && trim($envRfcEnajenante) !== '') {
$DATA['ConceptoCombustible']['rfc'] = strtoupper(trim($envRfcEnajenante));
}
function setAttrs(DOMElement $node, array $attrs): void
{
foreach ($attrs as $k => $v) {
$node->setAttribute((string)$k, (string)$v);
}
}
function leerCertificado(string $cerPath): array
{
$certBytes = file_get_contents($cerPath);
if ($certBytes === false) {
throw new RuntimeException("No se pudo leer el certificado: {$cerPath}");
}
$certB64 = str_replace(["\n", "\r"], '', base64_encode($certBytes));
$certPem = "-----BEGIN CERTIFICATE-----\n"
. chunk_split(base64_encode($certBytes), 64, "\n")
. "-----END CERTIFICATE-----\n";
$parsed = openssl_x509_parse($certPem);
if ($parsed === false || empty($parsed['serialNumberHex'])) {
throw new RuntimeException('No se pudo obtener serialNumberHex del certificado.');
}
$hex = preg_replace('/\s+/', '', (string)$parsed['serialNumberHex']);
$decoded = hex2bin($hex);
if ($decoded === false || $decoded === '') {
throw new RuntimeException('No se pudo decodificar el serial del certificado.');
}
return [$certB64, strtoupper($decoded)];
}
function cadenaOriginal(string $xmlPath, string $xsltPath): string
{
$xml = new DOMDocument();
if (!$xml->load($xmlPath)) {
throw new RuntimeException("No se pudo cargar XML: {$xmlPath}");
}
$xsl = new DOMDocument();
if (!$xsl->load($xsltPath)) {
throw new RuntimeException("No se pudo cargar XSLT: {$xsltPath}");
}
$proc = new XSLTProcessor();
$proc->importStylesheet($xsl);
$result = $proc->transformToXML($xml);
if ($result === false) {
throw new RuntimeException('No se pudo generar la cadena original con XSLT.');
}
return trim(str_replace(["\n", '<?xml version="1.0"?>'], '', $result));
}
function crearSello(string $cadena, string $keyPath): string
{
$pem = file_get_contents($keyPath);
if ($pem === false) {
throw new RuntimeException("No se pudo leer la llave privada: {$keyPath}");
}
$privateKey = openssl_pkey_get_private($pem);
if ($privateKey === false) {
throw new RuntimeException('No se pudo cargar la llave privada.');
}
$ok = openssl_sign($cadena, $firma, $privateKey, OPENSSL_ALGO_SHA256);
if (!$ok) {
throw new RuntimeException('No se pudo firmar la cadena original.');
}
return base64_encode($firma);
}
function generarXmlConsumoDeCombustibles(
string $outputPath,
string $cerPath,
string $keyPath,
string $xsltPath,
array $data
): string {
[$certB64, $noCertificado] = leerCertificado($cerPath);
$doc = new DOMDocument('1.0', 'UTF-8');
$doc->formatOutput = true;
$root = $doc->createElementNS(NS_CFDI, 'cfdi:Comprobante');
$root->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:consumodecombustibles11', NS_CCB11);
$root->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xsi', NS_XSI);
$root->setAttributeNS(
NS_XSI,
'xsi:schemaLocation',
NS_CFDI . ' http://www.sat.gob.mx/sitio_internet/cfd/4/cfdv40.xsd '
. NS_CCB11 . ' http://www.sat.gob.mx/sitio_internet/cfd/consumodecombustibles/consumodeCombustibles11.xsd'
);
setAttrs($root, $data['Comprobante']);
$root->setAttribute('NoCertificado', $noCertificado);
$root->setAttribute('Certificado', $certB64);
$root->setAttribute('Sello', '');
$doc->appendChild($root);
$emisor = $doc->createElementNS(NS_CFDI, 'cfdi:Emisor');
setAttrs($emisor, $data['Emisor']);
$root->appendChild($emisor);
$receptor = $doc->createElementNS(NS_CFDI, 'cfdi:Receptor');
setAttrs($receptor, $data['Receptor']);
$root->appendChild($receptor);
$conceptos = $doc->createElementNS(NS_CFDI, 'cfdi:Conceptos');
$concepto = $doc->createElementNS(NS_CFDI, 'cfdi:Concepto');
setAttrs($concepto, $data['Concepto']);
$impConcepto = $doc->createElementNS(NS_CFDI, 'cfdi:Impuestos');
$trasladosConcepto = $doc->createElementNS(NS_CFDI, 'cfdi:Traslados');
$trasladoConcepto = $doc->createElementNS(NS_CFDI, 'cfdi:Traslado');
setAttrs($trasladoConcepto, $data['TrasladoConcepto']);
$trasladosConcepto->appendChild($trasladoConcepto);
$impConcepto->appendChild($trasladosConcepto);
$concepto->appendChild($impConcepto);
$conceptos->appendChild($concepto);
$root->appendChild($conceptos);
$impGlobal = $doc->createElementNS(NS_CFDI, 'cfdi:Impuestos');
setAttrs($impGlobal, $data['Impuestos']);
$trasladosGlobal = $doc->createElementNS(NS_CFDI, 'cfdi:Traslados');
$trasladoGlobal = $doc->createElementNS(NS_CFDI, 'cfdi:Traslado');
setAttrs($trasladoGlobal, $data['TrasladoGlobal']);
$trasladosGlobal->appendChild($trasladoGlobal);
$impGlobal->appendChild($trasladosGlobal);
$root->appendChild($impGlobal);
$complemento = $doc->createElementNS(NS_CFDI, 'cfdi:Complemento');
$ccb = $doc->createElementNS(NS_CCB11, 'consumodecombustibles11:ConsumoDeCombustibles');
setAttrs($ccb, $data['ConsumoDeCombustibles']);
$ccbConceptos = $doc->createElementNS(NS_CCB11, 'consumodecombustibles11:Conceptos');
$ccbConcepto = $doc->createElementNS(NS_CCB11, 'consumodecombustibles11:ConceptoConsumoDeCombustibles');
setAttrs($ccbConcepto, $data['ConceptoCombustible']);
$determinados = $doc->createElementNS(NS_CCB11, 'consumodecombustibles11:Determinados');
$determinado = $doc->createElementNS(NS_CCB11, 'consumodecombustibles11:Determinado');
setAttrs($determinado, $data['Determinado']);
$determinados->appendChild($determinado);
$ccbConcepto->appendChild($determinados);
$ccbConceptos->appendChild($ccbConcepto);
$ccb->appendChild($ccbConceptos);
$complemento->appendChild($ccb);
$root->appendChild($complemento);
$dir = dirname($outputPath);
if (!is_dir($dir) && !mkdir($dir, 0777, true) && !is_dir($dir)) {
throw new RuntimeException("No se pudo crear directorio de salida: {$dir}");
}
$doc->save($outputPath);
$cadena = cadenaOriginal($outputPath, $xsltPath);
$sello = crearSello($cadena, $keyPath);
$sellado = new DOMDocument();
$sellado->formatOutput = true;
$sellado->load($outputPath);
$sellado->documentElement->setAttribute('Sello', $sello);
$sellado->save($outputPath);
return $outputPath;
}
$base = __DIR__;
$rutaSalida = $base . '/xml/ConsumoDeCombustibles11.xml';
$rutaCer = $base . '/certificados/EKU9003173C9/EKU9003173C9.cer';
$rutaKey = $base . '/certificados/EKU9003173C9/EKU9003173C9.pem';
$rutaXslt = $base . '/cadenaoriginal_4_0.xslt';
try {
$archivo = generarXmlConsumoDeCombustibles($rutaSalida, $rutaCer, $rutaKey, $rutaXslt, $DATA);
echo "XML generado: {$archivo}\n";
} catch (Throwable $e) {
fwrite(STDERR, "ERROR: " . $e->getMessage() . "\n");
exit(1);
}