Download the PHP package anglemx/sat-cfdi without Composer

SAT CFDI

A pure PHP library to simplify the handling and processing of CFDIs. Creates new CFDIs and parses and validates existing CFDI files.

A CFDI is a "Comprobante Fiscal Digital por Internet" of Mexico's SAT "Servicio de Administración Tributaria" (Tax Administration Service).

Features

• Parse XML representation of CFDIs
• Write XML files from a CFDI
• Validate cryptographic signatures
• Validate CFDI status online

Installation

Requires PHP 7.2+ and Composer.

Usage

For more implementation examples, check the Test files.

Dependencies

In order to make this library as robust as possible, we're using many libraries that are included by default on most environments.

• Implements XSD schema files to validate XML. (ext-dom, ext-libxml)
• Implements XSLT stylesheets to generate the Original Chain Sequence for signature validations. (ext-xsl)
• Implements OpenSSL to operate and verify X.509 Certificates. ( ext-openssl)

Translations

This library is written in english to maintain code consistency. However, some keywords are very specific to this domain.

pending..

Resources

This library bundles some resources to simplify the installation process on production servers, and to allow for offline processing. All of these files are published by SAT and are made available completely free through SAT's official website.

This list is not complete, but any reference to the complementary XSD and XSLT resources are included in the root definition schemas.

Certificates

We've bundled the production root X.509 Certificates (CA) in a convenient PEM file. If you'd prefer, you can download them from the official website and install those files locally: http://omawww.sat.gob.mx/tramitesyservicios/Paginas/certificado_sello_digital.htm

SAT publishes a list of all the certificates for every single registered and active taxpayer. You can consult any specific certificate with SAT's official tool "Recuperación de Certificados".

You can use that system to look up all of SAT's certificates by searching their RFC: SAT970701NN3

References

The official publication regarding CFDI is called "Anexo 20" and we are currently on CFDI version 3.3. View online.

Web Services

This employs some public web services to validate the status of CFDI.

pending..

Validations

See tests/ValidatorTest.php for a sample implementation of the Validation Steps

• STEP 1: Parse XML into an Invoice
• STEP 2: Validate properties
• STEP 3: Validate CFDI signature
• STEP 4: Validate Fiscal Stamp (TFD)
• STEP 5: Validate CFDI's UUID against SAT

Testing

To run tests with PHPUnit, simply install the dev dependencies

Create a /test-data/ directory in this library's root path, and place all the XML files inside that you would like to test.

Finally, run the tests:

TO DO

• Validate properties when parsing
• Validate basic business rules
• Implement cache for X.509 Certificates
• Check for Certificate Revocation status before validating
• Implement cache for XSLT 2.0 transpilation
• Documentation and more samples

TO FIX

• Duplicated Namespace declarations on CFDI::toXML() when we have any child (even if not on the root node) with a different namespace than the default for the Document. We should clean this up when pretty printing our XMLs.
• Replace all instances of Node::NODE_NS_NAME with Node::NODE_NS_URI_NAME inside setChildrenFromDOMNodes(). See CFDI40\Complements for reference.

Other notes