README

使用SAT门户网站的税务身份证明的QR码数据恢复税务识别证书信息的小工具。

安装

可以通过composer进行安装。

composer require francerz/mx-sat-cif

使用

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.
}