Download the PHP package phpcfdi/sat-pys-scraper without Composer
On this page you can find all versions of the php package phpcfdi/sat-pys-scraper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package sat-pys-scraper
phpcfdi/sat-pys-scraper
Herramienta para obtener y generar un listado de las clasificaciones del catálogo de productos y servicios del SAT
:us: The documentation of this project is in Spanish, as this is the natural language for the intended audience.
Es posible que, lo único que buscas es el Listado de clasificaciones de productos y servicios del SAT, si es ese el caso, es mejor consumir el recurso phpcfdi/resources-pys, en donde el listado es actualizado automáticamente.
Acerca de phpcfdi/sat-pys-scraper
El SAT en el sitio de internet http://pys.sat.gob.mx/PyS/catPyS.aspx tiene publicada una clasificación de productos y servicios. Esta clasificación no pertenece oficialmente a los catálogos y no se encuentra publicada en ningún lugar.
Esta herramienta hace el scrap del sitio mencionado para obtener los 4 niveles de clasificación: Tipo, Segmento, Familia y Clase. Igualmente, la estructura se puede exportar como XML o como JSON.
Instalación usando composer
A diferencia de otras librerías o componentes, este proyecto es una herramienta, por lo que probablemente nunca tengas que instalar el proyecto como una dependencia. Sin embargo, se puede hacer para que realices la parte de obtener las clasificaciones del sitio del SAT, pero tú mismo te encargues de procesar la estructura y usarla para tus propios propósitos, como por ejemplo, almacenar en una base de datos.
Instalación usando Docker
Este proyecto provee un archivo Dockerfile para construir una imagen con todas sus dependencias.
Se puede usar esta imagen para correr de forma local, para más información consulte
el archivo README.Docker.md.
Ayuda de sat-pys-scraper (script)
Uso de la herramienta
Si usar el código de la herramienta, entonces es importante entender que la tarea trata de dos pasos:
- Obtener del sitio del SAT el listado de tipos, segmentos, familias y clases.
- Exportar el listado a un formato específico.
Para generar el listado de tipos, segmentos, familias y clases se usa el objeto Generator, que a su vez usa un
objeto Scraper para realizar la descarga de información, que a su vez utiliza un objeto Client de GuzzleHttp.
En el siguiente ejemplo se muestra cómo generar la estructura e iterar sobre sus elementos.
- Al ejecutar
Generator::generate()se devuelve un objeto de tipoTypes. - Se recorre la estructura con
foreach. - Se puede exportar usando
XmlExporter::export().
Tipos de datos
Un objeto Types es una colección iterable de objetos de tipo Type.
Un objeto Type contiene las propiedades key y name, y además es una colección iterable de objetos de tipo Segment.
Un objeto Segment contiene las propiedades key y name, y además es una colección iterable de objetos de tipo Family.
Un objeto Family contiene las propiedades key y name, y además es una colección iterable de objetos de tipo Classification.
Un objeto Classification solamente contiene las propiedades key y name.
Todos los objetos de datos implementan JsonSerializable, por lo que puedes usar esta característica para exportar a formato JSON.
Soporte
Puedes obtener soporte abriendo un ticket en Github.
Adicionalmente, esta librería pertenece a la comunidad PhpCfdi, así que puedes usar los canales oficiales de comunicación para obtener ayuda 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.
| Versión | PHP | Nota |
|---|---|---|
| 1.0.0 | 8.2, 8.3 | 2023-12-13 Fuera de mantenimiento |
| 2.0.0 | 8.2, 8.3 | 2024-03-07 Fuera de mantenimiento |
| 3.0.0 | 8.2, 8.3 | 2024-03-07 |
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/sat-pys-scraper tool is copyright © PhpCfdi
and licensed for use under the MIT License (MIT). Please see LICENSE for more information.
All versions of sat-pys-scraper with dependencies
ext-dom Version *
guzzlehttp/guzzle Version ^7.8
symfony/css-selector Version ^7.0
symfony/dom-crawler Version ^7.0