README

Proyecto archivado

Este proyecto ha sido archivado en favor de phpcfdi/sat-estado-cfdi versión 2. Las características de este proyecto han sido integradas en phpcfdi/sat-estado-cfdi, por lo tanto, este proyecto no es mantenido a partir de 2024-03-06. Si implementaste la versión 1 de phpcfdi/sat-estado-cfdi y phpcfdi/sat-estado-cfdi-http-psr entonces puedes seguir la guía de actualización en https://github.com/phpcfdi/sat-estado-cfdi/blob/main/docs/UPGRADE_v1_v2.md para actualizar tu código.

Consulta el estado de un CFDI en el webservice del SAT usando HTTP (PSR-17 y PSR-18)

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

🇲🇽 La documentación del proyecto está en español porque ese es el lenguaje principal de los usuarios.

Esta librería contiene objetos para consumir el Servicio de Consulta de CFDI del SAT usando HTTP.

Esta librería provee un objeto HttpConsumerClient que se usa en \PhpCfdi\SatEstadoCfdi\Consumer de la librería phpcfdi/sat-estado-cfdi.

Para contactar al servicio no requiere ext-soap en su lugar usa los estándares de PHP-FIG PSR-18: HTTP Client y PSR-17: HTTP Factories. De esta forma, puedes usar el cliente HTTP que mejor te convenga.

Los estándares de los que depende son:

• PSR-18: HTTP Client: Interfaces para clientes HTTP (el que hace la llamada POST). https://www.php-fig.org/psr/psr-18/
• PSR-17: HTTP Factories: Interfaces de fábricas de HTTP Request y Response (para PSR-7). https://www.php-fig.org/psr/psr-17/

Esta librería no contiene las implementaciones de los estándares, pero ya existen fuera del ámbito de la aplicación.

Te recomiendo probar las librerías de Sunrise sunrise/http-client-curl, y sunrise/http-message.

O puedes ver en Packagist los que te agraden:

• PSR-18: https://packagist.org/providers/psr/http-client-implementation
• PSR-17: https://packagist.org/providers/psr/http-factory-implementation
• PSR-7: https://packagist.org/providers/psr/http-message-implementation

Instalación

Usa composer

composer require phpcfdi/sat-estado-cfdi-http-psr

Ejemplo básico de uso

<?php
declare(strict_types=1);

use PhpCfdi\SatEstadoCfdi\Consumer;
use PhpCfdi\SatEstadoCfdi\HttpPsr\HttpConsumerClient;
use PhpCfdi\SatEstadoCfdi\HttpPsr\HttpConsumerFactoryInterface;

// suponiendo que tienes un objeto factory que tu formaste
/** @var HttpConsumerFactoryInterface $factory */

// construimos el cliente
$client = new HttpConsumerClient($factory);

// creamos el consumidor con nuestro cliente
$consumer = new Consumer($client);

// consumimos el webservice!
$response = $consumer->execute('...expression');

// usamos el resultado
if ($response->cancellable()->isNotCancellable()) {
    echo 'CFDI no es cancelable';
}

Integraciones

Puedes ver los siguientes recursos para integrar phpcfdi/sat-estado-cfdi-http-psr a tu proyecto.

• Integración Guzzle Implementación con guzzlehttp/guzzle.
• Integración genérica Implementación de los PSR-17 y PSR-18 que decidas, ejemplo usando Sunrise.

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-estado-cfdi-http-psr library is copyright © PhpCfdi and licensed for use under the MIT License (MIT). Please see LICENSE for more information.