SAT-CFDI
The best open-source python library to generate and process SAT’s CFDI
Documentation and User Guide available
Supported Features
CFDI 3.2, 3.3, 4.0 - Ingreso, Nomina, Pagos, Traslados y Complementos
Retenciones 1.0, 2.0
Contabilidad Electronica 1.3
Representación Impresa PDF, HTML, JSON
Facturación con PAC’s
Comercio Digital
Diverza
Facturama (Multiemisor y API Web)
Finkok
Prodigia
SW Sapien
Descarga Masiva
Validación de Comprobantes
Listado 69
Listado 69B
Exportar Comprobantes a Excel
Descarga de Constancia de Situación Fiscal
Portal SAT - Factura Electrónica
Validación de RFC, Razón Social
LCO - Lista de Contribuyentes Obligados
DIOT - Declaración Informativa de Operaciones con Terceros
Certifica - Solicitud de Certificados, Renovación de Fiel
PLD - Prevención de Lavado de Dinero
Installation
Install SAT-CFDI from PyPI with:
python -m pip install satcfdi
or install from source with:
git clone https://github.com/SAT-CFDI/python-satcfdi
cd python-satcfdi
python -m pip install .
Load
from satcfdi.cfdi import CFDI
# from file
invoice = CFDI.from_file('comprobante.xml')
# from string/bytes
invoice = CFDI.from_string(open('comprobante.xml', 'rb').read())
Create
from decimal import Decimal
from satcfdi.models import Signer
from satcfdi.create.cfd import cfdi40
from satcfdi.create.cfd.catalogos import RegimenFiscal, UsoCFDI, MetodoPago, Impuesto, TipoFactor
# Load signing certificate
signer = Signer.load(
certificate=open('csd/xiqb891116qe4_csd.cer', 'rb').read(),
key=open('csd/xiqb891116qe4_csd.key', 'rb').read(),
password=open('csd/xiqb891116qe4_csd.txt', 'r').read()
)
# create Comprobante
invoice = cfdi40.Comprobante(
emisor=cfdi40.Emisor(
rfc=signer.rfc,
nombre=signer.legal_name,
regimen_fiscal=RegimenFiscal.GENERAL_DE_LEY_PERSONAS_MORALES
),
lugar_expedicion="56820",
receptor=cfdi40.Receptor(
rfc='KIJ0906199R1',
nombre='KIJ, S.A DE C.V.',
uso_cfdi=UsoCFDI.GASTOS_EN_GENERAL,
domicilio_fiscal_receptor="59820",
regimen_fiscal_receptor=RegimenFiscal.GENERAL_DE_LEY_PERSONAS_MORALES
),
metodo_pago=MetodoPago.PAGO_EN_PARCIALIDADES_O_DIFERIDO,
serie="A",
folio="123456",
conceptos=[
cfdi40.Concepto(
clave_prod_serv='84111506',
cantidad=Decimal('1.00'),
clave_unidad='E48',
descripcion='SERVICIOS DE FACTURACION',
valor_unitario=Decimal('1250.30'),
impuestos=cfdi40.Impuestos(
traslados=cfdi40.Traslado(
impuesto=Impuesto.IVA,
tipo_factor=TipoFactor.TASA,
tasa_o_cuota=Decimal('0.160000'),
),
retenciones=[
cfdi40.Retencion(
impuesto=Impuesto.ISR,
tipo_factor=TipoFactor.TASA,
tasa_o_cuota=Decimal('0.100000'),
),
cfdi40.Retencion(
impuesto=Impuesto.IVA,
tipo_factor=TipoFactor.TASA,
tasa_o_cuota=Decimal('0.106667'),
)
],
)
)
]
)
invoice.sign(signer)
invoice = invoice.process()
Output
from satcfdi import render
from satcfdi.render import BODY_TEMPLATE
# XML
invoice.xml_write("my_invoice.xml")
# JSON
render.json_write(invoice, "my_invoice.json", pretty_print=True)
# HTML
render.html_write(invoice, "my_invoice.html")
# PDF
render.pdf_write(invoice, "my_invoice.pdf")
# Multiple HTML
render.html_write([invoice1, invoice2], "my_invoice.html")
# Multiple PDF
render.pdf_write([invoice1, invoice2], "my_invoice.pdf")
# HTML Body only
html_body = render.html_str(invoice, template=BODY_TEMPLATE)
Contributing
We value feedback and contributions from our community.
Metadata
Release files for satcfdi 26.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| satcfdi-26.10.1.tar.gz | 10.5 MB | Without provenance | Details for satcfdi-26.10.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| satcfdi-26.10.1-py3-none-any.whl | Python 3 | none | any | Details for satcfdi-26.10.1-py3-none-any.whl |
Total release size: 22.0 MB
Release files / satcfdi-26.10.1.tar.gz
| Download URL | satcfdi-26.10.1.tar.gz |
|---|---|
| Size | 10.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
64f1383b4dc3ca497ac22819c96933da1f1c88d431ae36c5bde2580447232150
|
|
BLAKE2b-256 checksum How to use checksums |
faf6dc894ea61b156992133b693ab056be5430db4a41f2fe9b5c71a219181689
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / satcfdi-26.10.1-py3-none-any.whl
| Download URL | satcfdi-26.10.1-py3-none-any.whl |
|---|---|
| Size | 11.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
119a59502dde9e3126750417ddf412c82ae6143e8509b4b148da513d98c7d112
|
|
BLAKE2b-256 checksum How to use checksums |
bfedfa9e09f07b45c86332f6eade61dfa8bf39288ff4a024d89796e7ce2551cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for satcfdi 26.10.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.