cfdi (cfdi-toolkit)

Python toolkit for Mexican electronic invoicing — CFDI (Comprobante Fiscal Digital por Internet, SAT México). Validate, build, stamp, verify and convert CFDI documents.

Features

• Validation of invoice requests
• Building of CFDI XML documents
• SOAP integration with the PAC (digital stamping)
• Sealed XML and PDF download
• SAT verification QR code generation
• Digital stamp (timbre) information extraction
• Number-to-words conversion in Spanish (Mexican pesos)
• Creation of ZIP archives with multiple documents

Installation

pip install cfdi-toolkit

Or, to develop locally from this repository:

pip install -e .[test]

Quick start

from cfdi import CFDI

# Validate a request
datos = {
    'jbautoinc': 12345,
    'RFC': 'ABC123456XYZ',
    'CFDI': '<xml>...</xml>',
    'MetodoPago': 'PUE',
    'FormaPago': '01',
}
es_valido, errores = CFDI.validate_invoice_request(datos)

# Build XML and stamp via PAC
cfdi = CFDI(timeout=600)
xml = CFDI.get_cfdi_xml({'CFDI': {'Folio': '001', 'Total': '1500.00'}})
resultado = cfdi.obtener_xml_pdf(xml)   # seals via SOAP and downloads

# Number to words
print(CFDI.num2letras(1234.56))
# Mil doscientos treinta y cuatro pesos 56/100 M.N.

# SAT verification QR
qr = CFDI.generate_qr('uuid', 'RfcEmisor', 'RfcReceptor', '1500.00', 'sello123')

# Extract timbre from a sealed XML
timbre = CFDI.get_timbre(xml_sellado)
print(timbre['UUID'])

API overview

Exceptions: CFDIError (base), CFDIValidationError, CFDISoapError.

Configuration

Environment variables (optionally loaded via python-dotenv):

Note: the PAC endpoint is configured through CFDI.CFDI_360_URL. Set this value (or a PAC_URL) before using it in production.

Tests

pip install -e .[test]
python -m pytest tests -v

Examples

Run the practical examples:

python examples/examples.py

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.