eclipxe/cfdiutils

PHP Common utilities for Mexican CFDI 3.2 & 3.3

eclipxe/CfdiUtils

![Source Code][badge-source] ![Latest Version][badge-release] [![Build Status][badge-build]][build] [![Maintainability][badge-maintainability]][maintainability] [![Violations][badge-violations]][violations] ![Source Code][badge-documentation] , _(*1)

PHP Common utilities for Mexican CFDI 3.2, 3.3 & 4.0., _(*2)

This library provides helper objects to work with Mexican CFDI (Comprobante Fiscal Digital por Internet)., _(*3)

:mexico: Visita la documentación en español de esta librería en Read the docs. También te esperamos en el canal #phpcfdi de discord., _(*4)

The documentation related to this library and its API is on Read the docs. It is written in spanish language since is the language of the intended audience., _(*5)

Nota: Este proyecto será migrado a phpcfdi/cfdiutils, aún no tenemos fecha planeada, _(*6)

No olvides visitar https://www.phpcfdi.com donde contamos con muchas más librerías relacionadas con CFDI y herramientas del SAT. Y próximamente el lugar donde publicaremos la versión 4.x., _(*7)

Main features

• Create CFDI version 3.3 & 4.0 based on a friendly extendable non XML objects (nodes).
• Read CFDI version 3.2, 3.3 & 4.0.
• Validate CFDI version 3.3 & 4.0 against schemas, CFDI signature (Sello) and custom rules.
• Validate that the Timbre Fiscal Digital signature match with the CFDI 3.3 & CFDI 4.0. If signature doesn't match, then the document has been modified after sealed.
• Helper objects to deal with:
  • Cadena de origen generation.
  • Extract information from CER files or Certificado attribute.
  • Calculate Comprobante sums based on the list of Conceptos.
  • Retrieve the CFDI version information.
• Keep a local copy of the tree of XSD and XSLT file dependencies from SAT.
• Keep a local copy of certificates to avoid download them each time.
• Check the SAT WebService to get the status of a CFDI (Estado, EsCancelable, EstatusCancelacion and EFOS) without WSDL.

Installation

Use composer, so please run, _(*8)

composer require eclipxe/cfdiutils

Major versions

• Version 1.x deprecated was deprecated time ago, that version didn't do much anyway.
• Version 2.x deprecated has a lot of features and helper objects.
• Version 3.x current is a maintenance release for compatibility with PHP 8.4.
• Version 4.x future will be released with backward compatibility breaks.
  • See docs/CHANGELOG.md for backward compatibility breaks.
  • It may change to PHP 8.2.
  • It could be possible to migrate to phpcfdi/cfdi-utils under phpCfdi organization.

PHP Support

This library is compatible with PHP 8.0 and above. Please, try to use the language's full potential., _(*9)

The intended support is to be aligned with the oldest Active support PHP Branch. See https://www.php.net/supported-versions.php for more details., _(*10)

Contributing

Contributions are welcome! Please read CONTRIBUTING for details and don't forget to take a look in the TODO and CHANGELOG files., _(*11)

Copyright and License

The eclipxe/CfdiUtils library is copyright © Carlos C Soto and licensed for use under the MIT License (MIT). Please see LICENSE for more information., _(*12)