xavicabot/laravel-holded

Cliente PHP para la API de Holded, listo para Laravel

v1.0.20 2025-07-16 12:05 UTC

README

Cliente PHP para la API de Holded, diseñado para integrarse fácilmente con Laravel.

🚀 Instalación

composer require xavicabot/laravel-holded

⚙️ Configuración

Publica el archivo de configuración:

php artisan vendor:publish --tag=config --provider="LaravelHolded\HoldedServiceProvider"

Agrega en tu .env:

HOLDED_API=your_api_key
HOLDED_API_URL=https://api.holded.com/api/invoicing/v1/

✅ Uso

use LaravelHolded\Facades\Holded;

$contacts = Holded::listContacts();
$contact = Holded::getContact('contactId');
$newContact = Holded::createContact(['name' => 'Cliente nuevo']);

🧪 Tests

Instala dependencias de desarrollo:

composer install

Lanza los tests:

composer test

📂 Estructura del paquete

  • src/ → Código fuente principal
  • config/ → Archivo de configuración Laravel
  • tests/ → Pruebas con Pest
  • composer.json → Autoload, dependencias, provider

✍️ Créditos

Creado por Xavi Cabot

📄 Licencia

MIT ©