README

Librería PHP para recolectar los mensajes no leídos de Mis comunicados del Buzón Tributario del SAT México.

La documentación está en español porque es el idioma natural de las personas usuarias de esta herramienta.

Alcance y seguridad

La versión 0.x inicia sesión con RFC, Contraseña y captcha directamente en https://login.siat.sat.gob.mx/nidp/app/login. Después abre Mis comunicados y devuelve la fecha, hora y asunto de los mensajes que permanecen bajo Mensajes no leídos.

La librería no consulta Mis notificaciones, no expande comunicados, no envía e.firma, no genera acuses y no descarga documentos. Las notificaciones requieren ser atendidas dentro del Buzón Tributario y están deliberadamente fuera del alcance.

Instalación

composer require tecnofy/buzon-tributario-sat-scraper

Requiere PHP 8.4 o posterior, cURL y un resolvedor compatible con phpcfdi/image-captcha-resolver.

Uso básico

<?php

declare(strict_types=1);

require 'vendor/autoload.php';

use GuzzleHttp\RequestOptions;
use Tecnofy\BuzonTributarioSatScraper\HttpClientFactory;
use Tecnofy\BuzonTributarioSatScraper\Scraper;
use PhpCfdi\ImageCaptchaResolver\Resolvers\ConsoleResolver;

$client = HttpClientFactory::create([
    // Algunos entornos antiguos del SAT podrían necesitar esta opción:
    'curl' => [CURLOPT_SSL_CIPHER_LIST => 'DEFAULT@SECLEVEL=1'],
    // Conserve la validación TLS activa siempre que sea posible.
    RequestOptions::VERIFY => true,
]);

$scraper = Scraper::create(
    $client,
    new ConsoleResolver(),
    'TU_RFC',
    'TU_CONTRASEÑA',
);

$communications = $scraper->unreadCommunications();

foreach ($communications as $communication) {
    printf("%s | %s\n", $communication->receivedAt, $communication->subject);
}

Errores

Las fallas del SAT se expresan mediante excepciones específicas bajo Tecnofy\BuzonTributarioSatScraper\Exceptions: red, captcha, credenciales, SSO, página inesperada y estructura no reconocida. Los mensajes no incluyen RFC, contraseña, captcha, cookies ni HTML autenticado.

Desarrollo

composer install
composer dev:test

El proyecto utiliza PHPUnit, PHPStan, PHP_CodeSniffer, PHP-CS-Fixer y Composer Normalize. También se incluye un manifiesto Phive para instalar las herramientas como PHAR cuando ése sea el flujo preferido.

Las pruebas de integración reales son manuales y requieren que la persona propietaria de la cuenta capture sus credenciales. Nunca deben incorporarse credenciales, cookies ni HTML sin sanitizar al repositorio.

Compatibilidad

La rama inicial se prueba con PHP 8.4 y 8.5 y sigue Versionado Semántico.

Licencia

MIT. Consulte LICENSE.

tecnofy / buzon-tributario-sat-scraper

Maintainers

Package info

Statistics

Security