Activity Documentation Status Tests CodeQL Publish Releases Downloads Supported Versions Contributors Scrutinizer Code Quality Code Coverage Discord

SAT-CFDI

The best open-source python library to generate and process SAT’s CFDI

Documentation and User Guide available

SAT-CFDI Read the Docs

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)

    • Finkok

    • Prodigia

    • SW Sapien

  • Descarga Masiva

  • Validación de Comprobantes

  • 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.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (26.7.4)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for satcfdi from gravatar.com satcfdi

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: satcfdi@outlook.com

License

MIT License (MIT License)

Requires

Python >=3.10

Provides Extra

test docs

Tags

cfdi sat facturación comprobante retenciones nómina pagos carta porte contabilidad e-invoicing DIOT

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

satcfdi-26.7.3.tar.gz (10.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

satcfdi-26.7.3-py3-none-any.whl (11.4 MB view details)

Uploaded Python 3

File details

Details for the file satcfdi-26.7.3.tar.gz.

File metadata

  • Download URL: satcfdi-26.7.3.tar.gz
  • Upload date:
  • Size: 10.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for satcfdi-26.7.3.tar.gz
Algorithm Hash digest
SHA256 ffb38046a60f3aac71107905eafc7b484975d993bb58b9392c75ef1be340a9a1
MD5 ca127d15528947fd111c2f6270941c49
BLAKE2b-256 fbca7a9e446bef99b58f81438d2c43375f1c7c3c498ed4a64960d126182130f8

See more details on using hashes here.

File details

Details for the file satcfdi-26.7.3-py3-none-any.whl.

File metadata

  • Download URL: satcfdi-26.7.3-py3-none-any.whl
  • Upload date:
  • Size: 11.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for satcfdi-26.7.3-py3-none-any.whl
Algorithm Hash digest
SHA256 cf5317bc0c64b6c16d5f0425c1be892306e8634bcb45a62f60fdd1a055b6d7cf
MD5 600b18f18accff581d21797e1d0890d5
BLAKE2b-256 4b4d55110a85d15992d759286ec7bdcb7c8104543970dff78342d4c752795994

See more details on using hashes here.

Release history Release notifications | RSS feed

26.7.4

This release

26.7.3

26.7.2

26.7.1

4.9.25

4.9.24

4.9.23

4.9.22

4.9.21

4.9.20

4.9.19

4.9.18

4.9.17

4.9.16

4.9.15

4.9.14

4.9.13

4.9.12

4.9.11

4.9.10

4.9.9

4.9.8

4.9.7

4.9.6

4.9.5

4.9.4

4.9.3

4.9.2

4.9.1

4.9.0

4.8.6

4.8.5

4.8.4

4.8.3

4.8.2

4.8.1

4.8.0

4.7.6

4.7.5

4.7.4

4.7.3

4.7.2

4.7.1

4.7.0

4.6.5

4.6.4

4.6.3

4.6.2

4.6.1

4.6.0

4.5.7

4.5.6

4.5.5

4.5.4

4.5.3

4.5.2

4.5.1

4.5.0

4.4.16

4.4.15

4.4.14

4.4.13

4.4.12

4.4.11

4.4.10

4.4.9

4.4.8

4.4.7

4.4.6

4.4.5

4.4.4

4.4.3

4.4.2

4.4.1

4.4.0

4.3.5

4.3.4

4.3.3

4.3.2

4.3.1

4.3.0

4.2.9

4.2.8

4.2.7

4.2.6

4.2.5

4.2.4

4.2.3

4.2.2

4.2.1

4.2.0

4.1.5

4.1.4

4.1.3

4.1.2

4.1.1

4.1.0

4.0.27

4.0.26

4.0.25

4.0.24

4.0.23

4.0.22

4.0.21

4.0.19

4.0.18

4.0.17

4.0.16

4.0.15

4.0.14

4.0.13

4.0.12

4.0.11

4.0.10

4.0.9

4.0.8

4.0.7

4.0.6

4.0.5

4.0.4

4.0.3

4.0.2

4.0.1

4.0.0

2.0.2

2.0.1

2.0.0

1.1.8

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.22

1.0.21

1.0.20

1.0.19

1.0.18

1.0.17

1.0.16

1.0.15

1.0.14

1.0.13

1.0.12

1.0.11

1.0.10

1.0.9

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page