🚀 Laravel-FiscalAPI

Esta aplicación es un ejemplo de integración entre Laravel y FiscalAPI, que te permite utilizar los servicios de facturación electrónica en México de manera sencilla a través de una API RESTful.

📋 Descripción

Este proyecto implementa una API web con Laravel que se integra con FiscalAPI para generar documentos fiscales (CFDI). FiscalAPI 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, entre otros.

✨ Características

• API RESTful completa para emisión de documentos fiscales
• Documentación con Swagger/OpenAPI
• Base de datos SQLite para desarrollo local
• Integración con FiscalAPI SDK

📦 Requisitos

• PHP >= 8.1
• Composer
• SQLite
• Extensiones PHP requeridas (ver sección de configuración)

⚙️ Configuración del entorno

1. Configuración de PHP

⚠️ ADVERTENCIA: Es necesario configurar correctamente tu archivo php.ini. Asegúrate de tener habilitadas las siguientes extensiones:

extension_dir = "C:\php-8.4.6\ext"  # Ajusta esta ruta a tu instalación de PHP
extension=fileinfo
extension=openssl
extension=pdo_sqlite
extension=sqlite3
extension=zip

2. Variables de entorno

Crea un archivo .env en la raíz del proyecto con las siguientes variables:

# FiscalAPI Configuration
FISCALAPI_URL=https://test.fiscalapi.com
FISCALAPI_KEY=<api-key>
FISCALAPI_TENANT=<tenant>
FISCALAPI_DEBUG=false
FISCALAPI_VERIFY_SSL=false
FISCALAPI_API_VERSION=v4
FISCALAPI_TIMEZONE=America/Mexico_City

🔧 Instalación

1. Clona este repositorio:

git clone https://github.com/FiscalAPI/fiscalapi-samples-laravel.git
cd fiscalapi-samples-laravel

2. Instala las dependencias:

composer install

3. Ejecuta las migraciones:

php artisan migrate

🚀 Uso

Iniciar servidor de desarrollo

php artisan serve

La aplicación estará disponible en: http://127.0.0.1:8000

Documentación de la API

La documentación de la API con Swagger está disponible en: http://127.0.0.1:8000/api/documentation

📋 Operaciones Principales

• Facturas (CFDI)
  Crear facturas de ingreso, notas de crédito, complementos de pago, cancelaciones, generación de PDF/XML.
• Personas (Clientes/Emisores)
  Alta y administración de personas, gestión de certificados (CSD).
• Productos y Servicios
  Administración de catálogos de productos, búsqueda en catálogos SAT.

🤝 Contribuir

1. Haz un fork del repositorio.
2. Crea una rama para tu feature: git checkout -b feature/AmazingFeature.
3. Realiza commits de tus cambios: git commit -m 'Add some AmazingFeature'.
4. Sube tu rama: git push origin feature/AmazingFeature.
5. Abre un Pull Request en GitHub.

🐛 Reportar Problemas

1. Asegúrate de usar la última versión del SDK.
2. Verifica si el problema ya fue reportado.
3. Proporciona un ejemplo mínimo reproducible.
4. Incluye los mensajes de error completos.

📄 Licencia

Este proyecto está licenciado bajo la Licencia MPL. Consulta el archivo LICENSE para más detalles.

🔗 Enlaces Útiles

• Documentación Oficial
• Portal de FiscalAPI
• Ejemplos PHP
• Ejemplos Laravel

---

Desarrollado con ❤️ por Fiscalapi