francerz/mx-sat-cif

Consulta Datos Fiscales de Sistema de Administración Tributaria de México.

v0.2.1 2024-02-01 15:46 UTC

Requires

• fig/http-message-util: ^1.1
• psr/http-client: ^1.0
• psr/http-factory: ^1.0

Requires (Dev)

• francerz/http: ^0.3.14
• phpunit/phpunit: ^9.6

ISC

README

Herramienta para recuperar la información de las Cédulas de Identificación Fiscal del portal SAT utilizando los datos del QR de la Constancia de Situación Fiscal.

Instalación

La instalación se puede realizar mediante composer.

composer require francerz/mx-sat-cif

Utilización

use Francerz\MxSatCif\WebServiceCIF;

/**
 * Un objeto compatible con ClientInterface (PSR-18).
 * 
 * @var Psr\Http\Client\ClientInterface
 */
$httpClient = new HttpClient();

/**
 * Un objeto compatible con RequestFactoryInterface (PSR-17).
 * 
 * @var Psr\Http\Message\RequestFactoryInterface
 */
$requestFactory = new RequestFactory();

/**
 * Crea una instancia de la conexión al web service para recuperar los datos
 * de las cédulas de identificación fiscal.
 */
$wscif = new WebServiceCIF($httpClient, $requestFactory);

/**
 * Identificador de la Cédula de Identificación Fiscal (idCIF).
 *
 * Se puede encontrar en el documento de RFC y Constancia de Situación Fiscal.
 *
 * @var string
 */
$idCIF = '12000000000';

/**
 * Clave del Registo Federal del Contribuyente (RFC).
 *
 * @var string
 */
$rfc = 'XAXX010101000';

/**
 * Una instancia de Cédula de Identificación Fiscal, correspondiente a los datos
 * obtenidos del idCif y rfc proporcionados.
 * 
 * Si no existe, se devolverá null.
 * 
 * @var Francerz\MxSatCif\CedulaIdentificacionFiscal
 */
$cedula = $wscif->fetch($idCIF, $rfc);

/*
    DATOS DE IDENTIFICACION
*/
echo $cedula->idCif;    // (string) ID de la Cedula de Identificación Fiscal.
echo $cedula->rfc;      // (string) Registro Federal del Contribuyente.

/*
    DATOS DE IDENTIFICACIÓN (PERSONA FISICA)
*/
echo $cedula->tipo;                 // (string) DatosIdentificacion::TIPO_PERSONA_FISICA = "Persona Física"
echo $cedula->curp;                 // (string) Clave Única de Registro de Población
echo $cedula->nombre;               // (string) Nombre del contribuyente
echo $cedula->apellidoPaterno;      // (string) Primer apellido del contribuyente
echo $cedula->apellidoMaterno;      // (string) Segundo apellido del contribuyente
echo $cedula->fechaNacimiento;      // (DateTimeImmutable) Fecha de nacimiento

/*
    DATOS DE IDENTIFICACION (PERSONA MORAL)
*/
echo $cedula->tipo;                 // (string) DatosIdentificacion::TIPO_PERSONA_MORAL =  "Persona Moral"
echo $cedula->razonSocial;          // (string) Denominación o Razón Social.
echo $cedula->regimenCapital;       // (string) Régimen capital.
echo $cedula->fechaConstitucion;    // (DateTimeImmutable) Fecha de constitución de la persona moral

/*
    DATOS DE IDENTIFICACIÓN (PERSONA FÍSICA Y MORAL)
*/
echo $cedula->fechaInicioOperaciones;       // (DateTimeImmutable) Fecha de inicio de operaciones.
echo $cedula->situacionContribuyente;       // (string) Situación del Contribuyente.
echo $cedula->fechaUltimoCambioSituacion;   // (DateTimeImmutable) Fecha del último cambio de situación.


/*
    DATOS DE UBICACIÓN
*/
echo $cedula->entidadFederativa;    // (string) Nombre de la entidad federativa del domicilio fiscal.
echo $cedula->municipio;            // (string) Nombre del municipio.
echo $cedula->colonia;              // (string) Nombre de la colonia.
echo $cedula->tipoVialidad;         // (string) Tipo de vialidad (ej. calle, avenida, boulevard).
echo $cedula->nombreVialidad;       // (string) Nombre de la vialidad del domicilio fiscal.
echo $cedula->numeroExterior;       // (string) Número exterior del domicilio.
echo $cedula->numeroInterior;       // (string) Número interior del domicilio (vacío si no aplica).
echo $cedula->codigoPostal;         // (string) Código postal del asentamiento (colonia).
echo $cedula->correoElectronico;    // (string) Dirección de correo electrónico registrada.

/*
    CACTERÍSTICAS FISCALES (REGÍMENES)


    El atributo características de CedulaIdentificacionFiscal es un arreglo de
    objetos del tipo Característica Fiscal.

    $cedula->caracteristicas : CaracteristicaFiscal[]
*/
foreach ($cedula->caracteristicas as $caracteristica) {
    /* $caracteristica->regimen (tipo:RegimenFiscal) */
    echo $caracteristica->regimen->clave;       // (string) Clave del régimen fiscal.
    echo $caracteristica->regimen->descripcion; // (string) Descripción del régimen.

    echo $caracteristica->fechaAlta;            // (DateTimeImmutable) Fecha de alta del régimen.
}