README

Scraper para descargar la Opinión de Cumplimiento del SAT México

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

Acerca de phpcfdi/opinion-cumplimiento-sat-scraper

Esta herramienta se conecta usando Guzzle como cliente HTTP a la página del SAT en México para descargar la Opinión de Cumplimiento usando los datos de RFC y clave CIEC.

Requiere un resolvedor de Captcha, para lo que se puede utilizar alguno de los que ya se encuentran implementados en phpcfdi/image-captcha-resolver.

Instalación usando composer

composer require phpcfdi/opinion-cumplimiento-sat-scraper

Uso Básico

<?php

use GuzzleHttp\Client;
use GuzzleHttp\Cookie\CookieJar;
use GuzzleHttp\RequestOptions;
use PhpCfdi\ImageCaptchaResolver\Resolvers\ConsoleResolver;
use PhpCfdi\OpinionCumplimientoSatScraper\Scraper;

$cookieJar = new CookieJar();

$client = new Client([
    'cookies' => $cookieJar,
    'curl' => [
        CURLOPT_SSL_CIPHER_LIST => 'DEFAULT@SECLEVEL=1',
    ],
    RequestOptions::VERIFY => false,
]);

$captchaSolver = new ConsoleResolver();

$scraper = new Scraper(
    $client,
    $captchaSolver,
    'TU_RFC',
    'TU_CIEC'
);

$content = $scraper->download();
file_put_contents('opinion.pdf', (string) $content);

Importante: El método Scraper::download() devuelve un objeto de tipo Stringable, por lo que se recomienda siempre hacer la conversión de tipos explícita para obtener el contenido.

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 Mínima	Nota
0.1.0	8.2, 8.3, 8.4, 8.5	2026-01-22

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

Autor original: Cesar Aguilera cesargnu29@gmail.com.

phpcfdi / opinion-cumplimiento-sat-scraper

Maintainers

Details