Download the PHP package phpcfdi/sat-ws-descarga-masiva-cli without Composer

On this page you can find all versions of the php package phpcfdi/sat-ws-descarga-masiva-cli. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package sat-ws-descarga-masiva-cli

phpcfdi/sat-ws-descarga-masiva-cli

Source Code Packagist PHP Version Support Discord Latest Version Software License Build Status Reliability Maintainability Code Coverage Violations Total Downloads Docker Downloads

Consumo del web service de descarga masiva del SAT por línea de comandos

:us: The documentation of this project is in spanish as this is the natural language for intented audience.

:mexico: La documentación del proyecto está en español porque ese es el lenguaje principal de los usuarios. También te esperamos en el canal #phpcfdi de discord

Esta librería contiene un cliente (consumidor) del servicio del SAT de Servicio Web de Descarga Masiva de CFDI y Retenciones.

Requerimientos

Esta herramienta usa PHP versión 8.2 o superior con las extensiones xml, openssl, zip, curl, intl y bcmath.

Instalación

Ejecutable

Puedes descargar el archivo PHAR desde la dirección https://github.com/phpcfdi/sat-ws-descarga-masiva-cli/releases/latest/download/descarga-masiva.phar.

Phive

Pendiente.

Docker

Composer

Puedes instalar el proyecto en una carpeta especial y usar la herramienta o como dependencia de tu proyecto. Personalmente, no recomiendo instalarla como una dependencia de algún proyecto, dado que se trata de una herramienta y no de un componente o libería.

Suponiendo que la herramienta se instaló en ~/projects/sat-ws-descarga-masiva-cli, entonces podrías poner después un script de ejecución como el siguiente en /usr/local/bin/descarga-masiva o en ~/.local/bin/descarga-masiva:

Instalación desde el repositorio Git

Puedes decargar el proyecto de github y ejecutar el archivo bin/descarga-masiva.php. Esta opción la recomiendo aún menos, dado que no es fácil mantener la herramienta desde Git.

Ejemplos de uso

Para entender plenamente el uso del servicio web y los códigos de respuesta consulta la documentación de la librería phpcfdi/sat-ws-descarga-masiva.

La aplicación cuenta con dos tipos de comandos: ws para trabajar con el servicio y zip para trabajar con los paquetes.

Para obtener la lista de comandos disponibles usa el comando list.

Para obtener ayuda de la aplicación o cualquier comando agrega el parámetro --help.

Comando ws:consulta

El comando ws:consulta presenta una consulta con los parámetros establecidos.

El siguiente comando presenta una consulta de CFDI de metadata de comprobantes emitidos en el periodo 2023-01-01 00:00:00 al 2023-12-31 23:59:59 con los datos de la FIEL del RFC EKU9003173C9.

Con lo que puede entregar el siguiente resultado:

Los parámetros --efirma, --certificado, --llave, --password, --token son de autenticación y se documentan más adelante.

Adicionalmente, se pueden especificar los siguientes parámetros:

Y los siguientes filtros, que son opcionales:

También se pueden hacer consultas por UUID con el paámetro --uuid. En caso de usar el filtro de UUID entonces no se toman en cuenta los parámetros --desde, --hasta o cualquiera de los filtros antes mencionados.

En la respuesta, entrega el resultado de la operación y el identificador de la solicitud, que puede ser usado después en el comando ws:verifica.

Comando ws:verifica

El comando ws:verifica verifica una consulta previamente presentada con los parámetros establecidos.

El siguiente comando verifica una consulta de CFDI con el identificador ba31f7fa-3713-4395-8e1f-39a79f02f5cc.

En la respuesta, entrega el resultado de la operación y el identificador de uno o más paquetes para descarga, que pueden ser usados después en el comando ws:descarga.

Los parámetros --efirma, --certificado, --llave, --password, --token son de autenticación y se documentan más adelante.

Adicionalmente, se pueden especificar los siguientes parámetros:

Comando ws:descarga

El comando ws:descarga descarga un paquete de una consulta previamente verificada.

El siguiente comando descarga un paquete de CFDI con el identificador BA31F7FA-3713-4395-8E1F-39A79F02F5CC_01 en el directorio de destino storage/paquetes.

En la respuesta, entrega el resultado de la operación y el identificador de uno o más paquetes para descarga, que pueden ser usados después en el comando ws:descarga.

Los parámetros --efirma, --certificado, --llave, --password, --token son de autenticación y se documentan más adelante.

Adicionalmente, se pueden especificar los siguientes parámetros:

Parámetros de autenticación

Los parámetros --efirma, --certificado, --llave, --password y --token son de autenticación y se utilizan en los comandos ws:consulta, ws:descarga y ws:verifica.

Es recomendado establecer la ruta del token, es en donde se almacena la autenticación con el servicio web del SAT y se intenta reutilizar para no realizar más peticiones de autenticación de las necesarias.

Archivos de eFirma

Para no tener que especificar los parámetros --certificado, --llave, --password y --token, se puede especificar el parámetro --efirma que espera la ubicación a un archivo JSON con la siguiente estructura:

Comando info:complementos

El comando info:complementos muestra la información de los complementos registrados para usarse en una consulta.

Adicionalmente, se pueden especificar los siguientes parámetros:

Comando zip:metadata

El comando zip:metadata lee un paquete de metadatos desde paquetes/ba31f7fa-3713-4395-8e1f-39a79f02f5cc_01.zip y exporta su información a un archivo de Excel en archivos/listado.xlsx.

Comando zip:xml

El comando zip:xml lee un paquete de XML y exporta los comprobantes a un directorio, el nombre de cada comprobante es el UUID con la extensión .xml.

El siguiente comando lee un paquete de XML desde paquetes/ba31f7fa-3713-4395-8e1f-39a79f02f5cc_01.zip y exporta todos los archivos de comprobantes en el directorio archivos/xml/.

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.

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-ws-descarga-masiva-cli project is copyright © PhpCfdi and licensed for use under the MIT License (MIT). Please see LICENSE for more information.


All versions of sat-ws-descarga-masiva-cli with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
ext-json Version *
composer-runtime-api Version ^2.2
azjezz/psl Version ^3.0.2
eclipxe/enum Version ^0.2.6
eclipxe/xlsxexporter Version ^2.0.0
guzzlehttp/guzzle Version ^7.8.1
phpcfdi/sat-ws-descarga-masiva Version ^0.5.4
psr/log Version ^3.0
symfony/console Version ^7.1.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package phpcfdi/sat-ws-descarga-masiva-cli contains the following files

Loading the files please wait ....