PHPackages                             fiscalapi/fiscalapi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. fiscalapi/fiscalapi

ActiveLibrary[API Development](/categories/api)

fiscalapi/fiscalapi
===================

SDK de PHP para FiscalAPI

4.0.360(8mo ago)6172↑50%[1 PRs](https://github.com/FiscalAPI/fiscalapi-php/pulls)MPL-2.0PHPPHP >=7.4

Since Apr 6Pushed 1mo agoCompare

[ Source](https://github.com/FiscalAPI/fiscalapi-php)[ Packagist](https://packagist.org/packages/fiscalapi/fiscalapi)[ Docs](https://www.fiscalapi.com)[ RSS](/packages/fiscalapi-fiscalapi/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (7)Used By (0)

FiscalAPI SDK para PHP
======================

[](#fiscalapi-sdk-para-php)

[![Latest Stable Version](https://camo.githubusercontent.com/7ab65b5fb0260486bca20e29e2c895ca65083165ab14eec1426a941645630e3d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66697363616c6170692f66697363616c6170692e737667)](https://packagist.org/packages/fiscalapi/fiscalapi)[![License](https://camo.githubusercontent.com/77c2add7380639e924c65f5fe8b5ec768e4bbed4addba4c4612f6a5de4d82a3b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f46697363616c4150492f66697363616c6170692d706870)](https://github.com/FiscalAPI/fiscalapi-php/blob/master/LICENSE.txt)

**SDK oficial de FiscalAPI para PHP**, la API de facturación CFDI y otros servicios fiscales en México. Simplifica la integración con los servicios de facturación electrónica, eliminando las complejidades del SAT y facilitando la generación de facturas, notas de crédito, complementos de pago, nómina, carta porte, y más. ¡Factura sin dolor!

📋 Facturación CFDI 4.0
----------------------

[](#-facturación-cfdi-40)

- **Soporte completo para CFDI 4.0** con todas las especificaciones oficiales
- **Timbrado de facturas de ingreso** con validación automática
- **Timbrado de notas de crédito** (facturas de egreso)
- **Timbrado de complementos de pago** en MXN, USD y EUR.
- **Consulta del estatus de facturas** en el SAT en tiempo real
- **Cancelación de facturas**
- **Generación de archivos PDF** de las facturas con formato profesional
- **Personalización de logos y colores** en los PDF generados
- **Envío de facturas por correo electrónico** automatizado
- **Descarga de archivos XML** con estructura completa
- **Almacenamiento y recuperación** de facturas por 5 años.
- Dos [modos de operación](https://docs.fiscalapi.com/modes-of-operation): **Por valores** o **Por referencias**

📥 Descarga Masiva
-----------------

[](#-descarga-masiva)

- **Acceso a catálogos de descarga masiva** del SAT
- **Descarga de CFDI y Metadatos** en lotes grandes
- **Descarga masiva XML** con filtros personalizados
- **Reglas de descarga automática por RFC**
- **Solicitudes de descarga** via API y Dashboard.
- **Automatización de solicitudes de descarga**

👥 Gestión de Personas
---------------------

[](#-gestión-de-personas)

- **Administración de personas** (emisores, receptores, clientes, usuarios, etc.)
- **Gestión de certificados CSD y FIEL** (subir archivos .cer y .key a FiscalAPI)
- **Configuración de datos fiscales** (RFC, domicilio fiscal, régimen fiscal)
- **Gestión de datos de empleador** (patrón) asociados a una persona
- **Gestión de datos de empleado** (trabajador) asociados a una persona

🛍️ Gestión de Productos/Servicios
---------------------------------

[](#️-gestión-de-productosservicios)

- **Gestión de productos y servicios** con catálogo personalizable
- **Administración de impuestos aplicables** (IVA, ISR, IEPS)

📚 Consulta de Catálogos SAT
---------------------------

[](#-consulta-de-catálogos-sat)

- **Consulta en catálogos oficiales del SAT** actualizados
- **Consulta en catálogos oficiales de Descarga masiva del SAT** actualizados
- **Búsqueda de información** en catálogos del SAT con filtros avanzados
- **Acceso y búsqueda** en catálogos completos

📖 Recursos Adicionales
----------------------

[](#-recursos-adicionales)

- **Cientos de ejemplos de código** disponibles en múltiples lenguajes de programación
- Documentación completa con guías paso a paso
- Ejemplos prácticos para casos de uso comunes
- Soporte técnico especializado
- Actualizaciones regulares conforme a cambios del SAT

📦 Instalación
-------------

[](#-instalación)

Compatible con **PHP 7.4** y superiores

**Composer**:

```
composer require fiscalapi/fiscalapi
```

⚙️ Configuración
----------------

[](#️-configuración)

El SDK se puede utilizar tanto en aplicaciones básicas de PHP como en frameworks que utilizan inyección de dependencias (como Laravel o Symfony).

### 1. Configuración de Variables de Entorno

[](#1-configuración-de-variables-de-entorno)

Crea o actualiza tu archivo `.env` con las siguientes variables:

```
# FiscalAPI Configuration
FISCALAPI_URL=https://test.fiscalapi.com # https://live.fiscalapi.com (produción)
FISCALAPI_KEY=tu_api_key
FISCALAPI_TENANT=tu_tenant_id
FISCALAPI_DEBUG=false
FISCALAPI_VERIFY_SSL=true
FISCALAPI_API_VERSION=v4
FISCALAPI_TIMEZONE=America/Mexico_City

```

### Configuración con inyección de dependencias

[](#configuración-con-inyección-de-dependencias)

#### Laravel

[](#laravel)

##### Paso 1: Crear el archivo de configuración

[](#paso-1-crear-el-archivo-de-configuración)

Crea el archivo `config/fiscalapi.php`:

```