README

Programa PHP para generar los recursos desde los archivos XSD y XSLT del SAT para CFDI.

🇺🇸 The documentation of this project is in spanish as this is the natural language for the intended audience.

Este proyecto fue creado con el propósito de generar una copia local utilizable de los archivos XSD y XSLT del SAT.

Para generar la copia local utiliza eclipxe/xmlresourceretriever y de esta manera los archivos descargados contienen referencias relativas y no referencias absolutas.

Utiliza phpcfdi/sat-ns-registry para tener un registro completo de todos los archivos XSD y XSLT que ofrece el SAT, el cual contiene la información de CFDI en todas sus versiones así como de los complementos en sus múltiples versiones.

Esta herramienta se utiliza para la creación de los recursos compartidos en el repositorio phpcfdi/resources-sat-xml.

Instalación

Usa composer

composer require phpcfdi/resources-sat-xml-generator

También puedes descargarlo, instalar las dependencias y utilizarlo

git clone https://github.com/phpcfdi/resources-sat-xml-generator resources-sat-xml-generator
cd resources-sat-xml-generator
composer install
php bin/resources-sat-xml-generator fetch:sat xml-resources/ all

Uso básico

php bin/resources-sat-xml-generator fetch http://...

Uso con docker

En el repositorio se encuentran los archivos para construir la imagen de docker y así ejecutar el contenedor.

Para construir la imagen con el nombre resources-sat-xml-generator:

git clone https://github.com/phpcfdi/resources-sat-xml-generator.git
docker build resources-sat-xml-generator -t resources-sat-xml-generator

Para ejecutar la imagen generando los archivos en /tmp/output, los archivos pertenecerán al usuario que está ejecutando el comando:

docker run -it --rm --volume /tmp/output:/tmp/output --user="$(id -u):$(id -g)" \
    resources-sat-xml-generator fetch:sat /tmp/output

Problemas conocidos

• Recursos no disponibles en el sitio del SAT
• Recursos con nombres incorrectos en el sitio del SAT

Soporte

Puedes obtener soporte abriendo un ticket en Github.

Adicionalmente, esta librería pertenece a la comunidad PhpCfdi, así que puedes usar los mismos canales de comunicación para obtener ayuda de algún miembro de la comunidad.

Compatibilidad

Esta librería se mantendrá compatible con al menos la versión con soporte activo de PHP más reciente.

También utilizamos Versionado Semántico 2.0.0 por lo que puedes usar esta librería sin temor a romper tu aplicación.

Acerca de este proyecto

Este recurso se crea dentro de la iniciativa de PhpCfdi para contar con información pública del SAT pero de forma descentralizada, con control de cambios y utilizable en formatos abiertos para sistemas informáticos.

Estos recursos, a pesar de estar vinculados con una tecnología en su formato, no están vinculados con un lenguaje de programación o una librería específica para su consumo. Cualquier proyecto, privado o público, desde cualquier lenguaje de programación, arquitectura o tecnología debe ser capaz de explotarlo siempre que pueda utilizar el formato de almacenamiento.

Contribuciones

Las contribuciones con bienvenidas. Por favor lee CONTRIBUTING para más detalles y recuerda revisar el archivo de tareas pendientes TODO y el archivo CHANGELOG.

Copyright and License

The phpcfdi/resources-sat-xml-generator library is copyright © PhpCfdi and licensed for use under the MIT License (MIT). Please see LICENSE for more information.