Este complemento incorpora la información requerida por el SAT para las organizaciones civiles o fideicomisos autorizados para recibir donativos. Su uso es indispensable para que los comprobantes fiscales sean deducibles para los donantes.
El complemento permite integrar los siguientes datos obligatorios a la factura.
Enlace directo al sitio del SAT. liga
| Recurso | Enlace |
|---|---|
| Estándar: | 📥 Descargar |
| Esquema XSD: | 📥 Descargar |
| Utilerías XSLT: | 📥 Descargar |
| Nombre | Dirección |
|---|---|
| namespace: | http://www.sat.gob.mx/donat |
| Location: | http://www.sat.gob.mx/sitio_internet/cfd/donat/donat11.xsd |
| Uso: | xsi:schemaLocation=“http://www.sat.gob.mx/cfd/4 http://www.sat.gob.mx/sitio_internet/cfd/4/cfdv40.xsd http://www.sat.gob.mx/donat http://www.sat.gob.mx/sitio_internet/cfd/donat/donat11.xsd“ |
<?xml version="1.0" encoding="utf-8"?>
<cfdi:Comprobante xmlns:cfdi="http://www.sat.gob.mx/cfd/4" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:donat="http://www.sat.gob.mx/donat" xsi:schemaLocation="http://www.sat.gob.mx/cfd/4 http://www.sat.gob.mx/sitio_internet/cfd/4/cfdv40.xsd http://www.sat.gob.mx/donat http://www.sat.gob.mx/sitio_internet/cfd/donat/donat11.xsd" Version="4.0" Serie="A" Folio="12345" Fecha="2024-03-01T12:00:00" Sello="" FormaPago="03" NoCertificado="30001000000500003416" Certificado="MIIFsDCCA5igAwIBAgIUMzAwMDEwMDAwMDA1MDAwMDM0MTYwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWxpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMjMwNTE4MTE0MzUxWhcNMjcwNTE4MTE0MzUxWjCB1zEnMCUGA1UEAxMeRVNDVUVMQSBLRU1QRVIgVVJHQVRFIFNBIERFIENWMScwJQYDVQQpEx5FU0NVRUxBIEtFTVBFUiBVUkdBVEUgU0EgREUgQ1YxJzAlBgNVBAoTHkVTQ1VFTEEgS0VNUEVSIFVSR0FURSBTQSBERSBDVjElMCMGA1UELRMcRUtVOTAwMzE3M0M5IC8gVkFEQTgwMDkyN0RKMzEeMBwGA1UEBRMVIC8gVkFEQTgwMDkyN0hTUlNSTDA1MRMwEQYDVQQLEwpTdWN1cnNhbCAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtmecO6n2GS0zL025gbHGQVxznPDICoXzR2uUngz4DqxVUC/w9cE6FxSiXm2ap8Gcjg7wmcZfm85EBaxCx/0J2u5CqnhzIoGCdhBPuhWQnIh5TLgj/X6uNquwZkKChbNe9aeFirU/JbyN7Egia9oKH9KZUsodiM/pWAH00PCtoKJ9OBcSHMq8Rqa3KKoBcfkg1ZrgueffwRLws9yOcRWLb02sDOPzGIm/jEFicVYt2Hw1qdRE5xmTZ7AGG0UHs+unkGjpCVeJ+BEBn0JPLWVvDKHZAQMj6s5Bku35+d/MyATkpOPsGT/VTnsouxekDfikJD1f7A1ZpJbqDpkJnss3vQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAFaUgj5PqgvJigNMgtrdXZnbPfVBbukAbW4OGnUhNrA7SRAAfv2BSGk16PI0nBOr7qF2mItmBnjgEwk+DTv8Zr7w5qp7vleC6dIsZFNJoa6ZndrE/f7KO1CYruLXr5gwEkIyGfJ9NwyIagvHHMszzyHiSZIA850fWtbqtythpAliJ2jF35M5pNS+YTkRB+T6L/c6m00ymN3q9lT1rB03YywxrLreRSFZOSrbwWfg34EJbHfbFXpCSVYdJRfiVdvHnewN0r5fUlPtR9stQHyuqewzdkyb5jTTw02D2cUfL57vlPStBj7SEi3uOWvLrsiDnnCIxRMYJ2UA2ktDKHk+zWnsDmaeleSzonv2CHW42yXYPCvWi88oE1DJNYLNkIjua7MxAnkNZbScNw01A6zbLsZ3y8G6eEYnxSTRfwjd8EP4kdiHNJftm7Z4iRU7HOVh79/lRWB+gd171s3d/mI9kte3MRy6V8MMEMCAnMboGpaooYwgAmwclI2XZCczNWXfhaWe0ZS5PmytD/GDpXzkX0oEgY9K/uYo5V77NdZbGAjmyi8cE2B2ogvyaN2XfIInrZPgEffJ4AB7kFA2mwesdLOCh0BLD9itmCve3A1FGR4+stO2ANUoiI3w3Tv2yQSg4bjeDlJ08lXaaFCLW2peEXMXjQUk7fmpb5MNuOUTW6BE=" SubTotal="200.00" Moneda="MXN" Total="232.00" TipoDeComprobante="I" Exportacion="01" MetodoPago="PUE" LugarExpedicion="20000">
<cfdi:Emisor Nombre="ESCUELA KEMPER URGATE" RegimenFiscal="601" Rfc="EKU9003173C9"/>
<cfdi:Receptor DomicilioFiscalReceptor="57740" Nombre="COMERCIALIZADORA TEODORIKAS" RegimenFiscalReceptor="601" Rfc="CTE950627K46" UsoCFDI="G03"/>
<cfdi:Conceptos>
<cfdi:Concepto ClaveProdServ="84101600" NoIdentificacion="DON001" Cantidad="1" ClaveUnidad="ACT" Unidad="Actividad" Descripcion="Donativo voluntario" ValorUnitario="200.00" Importe="200.00" ObjetoImp="02">
<cfdi:Impuestos>
<cfdi:Traslados>
<cfdi:Traslado Base="200.00" Impuesto="002" TipoFactor="Tasa" TasaOCuota="0.160000" Importe="32.00" />
</cfdi:Traslados>
</cfdi:Impuestos>
</cfdi:Concepto>
</cfdi:Conceptos>
<cfdi:Impuestos TotalImpuestosTrasladados="32.00">
<cfdi:Traslados>
<cfdi:Traslado Base="200.00" Impuesto="002" TipoFactor="Tasa" TasaOCuota="0.160000" Importe="32.00" />
</cfdi:Traslados>
</cfdi:Impuestos>
<cfdi:Complemento>
<donat:Donatarias version="1.1" noAutorizacion="8345" fechaAutorizacion="2025-01-09" leyenda="Este comprobante ampara un donativo, el cual será destinado por la donataria a los fines propios de su objeto social." />
</cfdi:Complemento>
</cfdi:Comprobante>
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import base64
import hashlib
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_DONAT11 = "http://www.sat.gob.mx/donat"
NS_XSI = "http://www.w3.org/2001/XMLSchema-instance"
DATOS = {
"Comprobante": {
"Version": "4.0",
"Serie": "A",
"Folio": "12345",
"Fecha": "2024-03-01T12:00:00",
"FormaPago": "03",
"SubTotal": "200.00",
"Moneda": "MXN",
"Total": "232.00",
"TipoDeComprobante": "I",
"Exportacion": "01",
"MetodoPago": "PUE",
"LugarExpedicion": "20000",
},
"Emisor": {
"Rfc": "EKU9003173C9",
"Nombre": "ESCUELA KEMPER URGATE",
"RegimenFiscal": "601",
},
"Receptor": {
"Rfc": "CTE950627K46",
"Nombre": "COMERCIALIZADORA TEODORIKAS",
"UsoCFDI": "G03",
"DomicilioFiscalReceptor": "57740",
"RegimenFiscalReceptor": "601",
},
"Concepto": {
"ClaveProdServ": "84101600",
"NoIdentificacion": "DON001",
"Cantidad": "1",
"ClaveUnidad": "ACT",
"Unidad": "Actividad",
"Descripcion": "Donativo voluntario",
"ValorUnitario": "200.00",
"Importe": "200.00",
"ObjetoImp": "02",
},
"TrasladoConcepto": {
"Base": "200.00",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.160000",
"Importe": "32.00",
},
"Impuestos": {
"TotalImpuestosTrasladados": "32.00",
},
"TrasladoGlobal": {
"Base": "200.00",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.160000",
"Importe": "32.00",
},
"Donatarias": {
"version": "1.1",
"noAutorizacion": "8345",
"fechaAutorizacion": "2025-01-09",
"leyenda": "Este comprobante ampara un donativo, el cual sera destinado por la donataria a los fines propios de su objeto social.",
},
}
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("donat", NS_DONAT11)
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_DONAT11} http://www.sat.gob.mx/sitio_internet/cfd/donat/donat11.xsd"
),
}
root = etree.Element(
f"{{{NS_CFDI}}}Comprobante",
root_attrs,
nsmap={
"cfdi": NS_CFDI,
"donat": NS_DONAT11,
"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")
etree.SubElement(complemento, f"{{{NS_DONAT11}}}Donatarias", **DATOS["Donatarias"])
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/Donatarias11_py.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_DONAT11 = 'http://www.sat.gob.mx/donat';
const NS_XSI = 'http://www.w3.org/2001/XMLSchema-instance';
$DATA = [
'Comprobante' => [
'Version' => '4.0',
'Serie' => 'A',
'Folio' => '12345',
'Fecha' => '2024-03-01T12:00:00',
'FormaPago' => '03',
'SubTotal' => '200.00',
'Moneda' => 'MXN',
'Total' => '232.00',
'TipoDeComprobante' => 'I',
'Exportacion' => '01',
'MetodoPago' => 'PUE',
'LugarExpedicion' => '20000',
],
'Emisor' => [
'Rfc' => 'EKU9003173C9',
'Nombre' => 'ESCUELA KEMPER URGATE',
'RegimenFiscal' => '601',
],
'Receptor' => [
'Rfc' => 'CTE950627K46',
'Nombre' => 'COMERCIALIZADORA TEODORIKAS',
'UsoCFDI' => 'G03',
'DomicilioFiscalReceptor' => '57740',
'RegimenFiscalReceptor' => '601',
],
'Conceptos' => [
[
'ClaveProdServ' => '84101600',
'NoIdentificacion' => 'DON001',
'Cantidad' => '1',
'ClaveUnidad' => 'ACT',
'Unidad' => 'Actividad',
'Descripcion' => 'Donativo voluntario',
'ValorUnitario' => '200.00',
'Importe' => '200.00',
'ObjetoImp' => '02',
'Traslado' => [
'Base' => '200.00',
'Impuesto' => '002',
'TipoFactor' => 'Tasa',
'TasaOCuota' => '0.160000',
'Importe' => '32.00',
],
],
],
'Impuestos' => [
'TotalImpuestosTrasladados' => '32.00',
'Traslado' => [
'Base' => '200.00',
'Impuesto' => '002',
'TipoFactor' => 'Tasa',
'TasaOCuota' => '0.160000',
'Importe' => '32.00',
],
],
'Donatarias' => [
'version' => '1.1',
'noAutorizacion' => '8345',
'fechaAutorizacion' => '2025-01-09',
'leyenda' => 'Este comprobante ampara un donativo, el cual sera destinado por la donataria a los fines propios de su objeto social.',
],
];
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 generarXmlDonatarias(
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:donat', NS_DONAT11);
$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_DONAT11 . ' http://www.sat.gob.mx/sitio_internet/cfd/donat/donat11.xsd'
);
setAttrs($root, $data['Comprobante']);
$root->setAttribute('NoCertificado', $noCertificado);
$root->setAttribute('Certificado', $certB64);
$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');
foreach ($data['Conceptos'] as $conceptoData) {
$concepto = $doc->createElementNS(NS_CFDI, 'cfdi:Concepto');
$trasladoData = $conceptoData['Traslado'] ?? null;
unset($conceptoData['Traslado']);
setAttrs($concepto, $conceptoData);
if (is_array($trasladoData)) {
$imp = $doc->createElementNS(NS_CFDI, 'cfdi:Impuestos');
$traslados = $doc->createElementNS(NS_CFDI, 'cfdi:Traslados');
$traslado = $doc->createElementNS(NS_CFDI, 'cfdi:Traslado');
setAttrs($traslado, $trasladoData);
$traslados->appendChild($traslado);
$imp->appendChild($traslados);
$concepto->appendChild($imp);
}
$conceptos->appendChild($concepto);
}
$root->appendChild($conceptos);
$impGlobal = $doc->createElementNS(NS_CFDI, 'cfdi:Impuestos');
$impGlobalData = $data['Impuestos'];
$trasladoGlobalData = $impGlobalData['Traslado'];
unset($impGlobalData['Traslado']);
setAttrs($impGlobal, $impGlobalData);
$trasladosGlobal = $doc->createElementNS(NS_CFDI, 'cfdi:Traslados');
$trasladoGlobal = $doc->createElementNS(NS_CFDI, 'cfdi:Traslado');
setAttrs($trasladoGlobal, $trasladoGlobalData);
$trasladosGlobal->appendChild($trasladoGlobal);
$impGlobal->appendChild($trasladosGlobal);
$root->appendChild($impGlobal);
$complemento = $doc->createElementNS(NS_CFDI, 'cfdi:Complemento');
$donat = $doc->createElement('donat:Donatarias');
setAttrs($donat, $data['Donatarias']);
$complemento->appendChild($donat);
$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/Donatarias11.xml';
$rutaCer = $base . '/certificados/EKU9003173C9/EKU9003173C9.cer';
$rutaKey = $base . '/certificados/EKU9003173C9/EKU9003173C9.pem';
$rutaXslt = $base . '/cadenaoriginal_4_0.xslt';
try {
$archivo = generarXmlDonatarias($rutaSalida, $rutaCer, $rutaKey, $rutaXslt, $DATA);
echo "XML generado: {$archivo}\n";
} catch (Throwable $e) {
fwrite(STDERR, "ERROR: " . $e->getMessage() . "\n");
exit(1);
}