isccarrasco/cfdi

CFDI python library

CFDI Python Library

This library helps to make Mexico CFDI invoice.

Is in early stage.

Installation

From PyPI

pip install cfdi

From local source

git clone https://github.com/Jarsa/cfdi.git
cd cfdi
pip install .

From remote source

pip install git+https://github.com/Jarsa/cfdi.git

How to use it?

Configure PAC options

import cfdi

cfdi.pac.name.pac = 'comercio_digital'  # PAC Driver name
cfdi.pac.usr = 'AAA010101AAA'
cfdi.pac.pwd = 'PWD'
cfdi.pac.mode = 'test'  # test/production

This library is prepared to Add PAC drivers

You must use CSD certificate and key in base64.

# Example to convert file to base64
import base64

certificate = open('/path/to/certificate.cer', 'r')
cer = base64.b64encode(certificate.read())

Assign CSD information and to generate XML then you call create method.

import cfdi

cfdi.invoice.cer = cer  # cer in base64
cfdi.invoice.key = key  # key in base64
cfdi.invoice.pwd = pwd  # string with CSD password
invoice = cfdi.invoice.create(data)  # to get data variable see below.

First you need to make a dictionary with invoice data with the following structure:

data = {
    'Atributos': {
        'serie': 'A',  # Optional
        'folio': '12345',  # Optional
        'fecha': 'aaaa-mm-ddThh:mm:ss',  # ISO 8601
        'sello': '',  # Generated with this lib.
        'formaDePago': 'Pago en una sola exhibicion',  # Pago en una sola exhibición o número de parcialidad pagada contra el total de parcialidades, Parcialidad 1 de X.
        'noCertificado': '',  # Generated with this lib.
        'certificado': '',  # Generated with tis lib.
        'condicionesDePago': '',  # Optional
        'subTotal': '100.00',
        'descuento': '0.0',  # Optional
        'motivoDescuento': '',  # Optional
        'TipoCambio': '1.0',  # Optional
        'Moneda': 'MXN',  # Optional
        'total': '116.00',
        'tipoDeComprobante': 'ingreso',  # ingreso egreso traslado
        'metodoDePago': 'NA',  # See catalog in SAT.
        'LugarExpedicion': 'Torreon Coahuila, Mexico',
        'NumCtaPago': '1234',  # Optional
        'FolioFiscalOrig': '',  # Optional
        'SerieFolioFiscalOrig': '',   # Optional
        'FechaFolioFiscalOrig': 'aaaa-mm-ddThh:mm:ss',  # Optional ISO 8601
        'MontoFolioFiscalOrig': '0.00',  # Optional
    },
    'Emisor': {
        'rfc': 'JSI140527TS9',
        'nombre': 'Jarsa Sistemas, S.A. de C.V.',  # Optional
        'DomicilioFiscal': {
            'calle': 'Calle',
            'noExterior': '49',  # Optional
            'noInterior': '',  # Optional
            'colonia': 'Colonia',  # Optional
            'localidad': 'Torreon',  # Optional
            'referencia': 'Referencia',  # Optional
            'municipio': 'Torreon',
            'estado': 'Coahuila',
            'pais': 'Mexico',
            'codigoPostal': '27200',
        },
        'ExpedidoEn': {
            'calle': 'Calle',  # Optional
            'noExterior': '49',  # Optional
            'noInterior': '',  # Optional
            'colonia': 'Colonia',  # Optional
            'localidad': 'Torreon',  # Optional
            'referencia': 'Referencia',  # Optional
            'municipio': 'Torreon',  # Optional
            'estado': 'Coahuila',  # Optional
            'pais': 'Mexico',  # Optional
            'codigoPostal': '27200',  # Optional
        },
        'RegimenFiscal': 'Parsona Fisica con Actividad Empresarial',
    },
    'Receptor': {
        'rfc': 'XAXX010101000',
        'nombre': 'Cliente',  # Optional
        'Domicilio': {
            'calle': 'Calle',  # Optional
            'noExterior': '50',  # Optional
            'noInterior': '',  # Optional
            'colonia': 'Colonia',  # Optional
            'localidad': 'Torreon',  # Optional
            'referencia': 'Referencia',  # Optional
            'municipio': 'Torreon',  # Optional
            'estado': 'Coahuila',  # Optional
            'pais': 'Mexico',  # Optional
            'codigoPostal': '27200',  # Optional
        },
    },
    'Conceptos': [
        {
            'cantidad': '1.0',
            'unidad': 'pieza',
            'noIdentificacion': 'A123',  # Reference or serial no. Optional
            'descripcion': '',  # Optional
            'valorUnitario': '100.00',
            'importe': '100.00',
            'InformacionAduanera': {
                'numero': '',
                'fecha': '',
                'aduana': '',  # Optional
            },
            'CuentaPredial': {
                'numero': '',
            },
            'Parte': [
                {
                    'cantidad': '1.0',
                    'unidad': 'pieza',  # Optional
                    'noIdentificacion': '',  # Optional
                    'descripcion': '',
                    'valorUnitario': '0.0',  # Optional
                    'importe': '0.0',  # Optional
                    'InformacionAduanera': {
                        'numero': '',
                        'fecha': '',
                        'aduana': '',  # Optional
                    }

                },
            ],
        },
    ],
    'Impuestos': {
        'totalImpuestosRetenidos': '0.0',  # Optional
        'totalImpuestosTrasladados': '16.0',  # Optional
        'Retenciones': [
            {
                'impuesto': '',  # IVA ISR
                'importe': '0.00',

            },
        ],
        'Traslados': [
            {
                'impuesto': 'IVA',  # IVA IEPS
                'tasa': '16.00',
                'importe': '16.00',
            },
        ],
    },

}

Add PAC drivers

To add a new driver you only need to create a method in cfdi/pac.py file as the example.

@classmethod
def stamp_pac_name(cls, xml):
    '''
    You will receive the xml ready to stamp as a string
    '''
    Code to stamp...

This method MUST be called stamp_pac + pac_name.

Known issues / Roadmap

• Hability to cancel invoices.
• Hability to create Addendas.
• Test & document everything.
• Compatibility to CFDI v3.3.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback here.

Credits

Contributors

• Alan Ramos <alan.ramos@jarsa.com.mx>

Maintainer

This package is maintained by Jarsa Sistemas, S.A. de C.V.