PHPackages                             csfacturacion/csplug-php - 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. csfacturacion/csplug-php

ActiveLibrary[API Development](/categories/api)

csfacturacion/csplug-php
========================

SDK PHP para consumir los recursos del servicio CSPlug

v3.0.0(1mo ago)022MITPHPPHP ^8.3

Since Feb 26Pushed 1mo agoCompare

[ Source](https://github.com/ConroeSoluciones/csplug-php)[ Packagist](https://packagist.org/packages/csfacturacion/csplug-php)[ RSS](/packages/csfacturacion-csplug-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (14)Used By (0)

CSPlug PHP SDK
==============

[](#csplug-php-sdk)

[![Minimum PHP Version](https://camo.githubusercontent.com/86257b7125f85372c84554213e4d9cb960c79cfdb219d3e0f47cc525d8e978f6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d254532253839254135253230382e312d3838393242462e737667)](https://php.net/)

SDK PHP oficial para consumir los recursos de la API del servicio [CSPlug](https://csplug.csfacturacion.com).

📥 Instalación
-------------

[](#-instalación)

Puedes instalar la librería vía Composer:

```
composer require csfacturacion/csplug-php
```

🛠 Requisitos
------------

[](#-requisitos)

- PHP >= 8.1
- Extensiones de PHP requeridas por `symfony/http-client`

🚀 Uso Básico
------------

[](#-uso-básico)

Para hacer solicitudes a la API de CSPlug, necesitas inicializar el cliente `CsPlugClient` configurando tus credenciales de acceso (Usuario y Contraseña).

```
use Csfacturacion\CsPlug\CsPlugClient;

$client = CsPlugClient::create([
    'base_uri'  => 'https://csplug.csfacturacion.com', // Opcional, URI por defecto
    'username'  => 'tu_usuario',
    'password'  => 'tu_password',
]);
```

📚 Recursos Disponibles
----------------------

[](#-recursos-disponibles)

El cliente te da acceso a los diversos recursos disponibles de la API:

- **CFDI:** `$client->cfdi()`
- **Emisores Hijos:** `$client->emisoresHijos()`
- **Certificados:** `$client->certificados()`
- **Certificados Emisor Hijo:** `$client->certificadosEmisorHijo()`
- **Series:** `$client->series()`
- **Series Emisor Hijo:** `$client->seriesEmisorHijo()`
- **Plantillas:** `$client->plantillas()`

### 💡 Ejemplo de Uso en Recursos

[](#-ejemplo-de-uso-en-recursos)

```
// Obtener una lista de CFDI's
$facturas = $client->cfdi()->list();

// Crear un CFDI
$cfdi = $client->cfdi()->create([
    // array con la estructura y detalles requeridos para el payload del CFDI
]);
```

🔧 Integración con Laravel
-------------------------

[](#-integración-con-laravel)

El paquete incluye soporte nativo y un Proveedor de Servicios (*ServiceProvider*) para Laravel.

Al instalar vía Composer, Laravel realiza el **Auto-Discovery** por lo que no necesitas registrar el Provider manualmente.

### Configuración (Variables de Entorno .env)

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

Si usas Laravel, puedes configurar las credenciales usando tu archivo `.env`:

```
CSPLUG_BASE_URI=https://csplug.csfacturacion.com
CSPLUG_USERNAME=tu_usuario
CSPLUG_PASSWORD=tu_password
CSPLUG_SERVICE=CSP
CSPLUG_TIMEOUT=30
CSPLUG_CONNECT_TIMEOUT=10
CSPLUG_DEBUG=false
```

Puedes publicar el archivo de configuración en tu proyecto ejecutando:

```
php artisan vendor:publish --provider="Csfacturacion\CsPlug\Laravel\CsPlugServiceProvider"
```

### Uso del Facade en Laravel

[](#uso-del-facade-en-laravel)

Puedes invocar al cliente del SDK desde donde sea utilizando su Facade local `CsPlug`:

```
use CsPlug;

// Utiliza CsPlug estáticamente tal como usarías un cliente
$emisores = CsPlug::emisoresHijos()->list();
```

📝 Contribuir
------------

[](#-contribuir)

Si deseas contribuir, por ejemplo ejecutando tests y control de calidad (Lints):

```
composer install
composer test
```

Este proyecto cuenta con herramientas pre-configuradas para calidad de código (`phpcs`, `phpstan`, `psalm`, y `phpunit`).

📄 Licencia
----------

[](#-licencia)

Este proyecto está distribuido bajo los términos de la Licencia MIT.

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance90

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

13

Last Release

52d ago

Major Versions

v1.0.1 → v2.0.02026-03-09

v2.2.0 → v3.0.02026-03-28

PHP version history (2 changes)1.0.0PHP ^8.1

v2.0.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/5ba8cfa48d678c2469b12845b459df2d417216d0ecb193c0f404635c776eea96?d=identicon)[csgamboa](/maintainers/csgamboa)

---

Top Contributors

[![csmontero](https://avatars.githubusercontent.com/u/264214695?v=4)](https://github.com/csmontero "csmontero (1 commits)")

### Embed Badge

![Health badge](/badges/csfacturacion-csplug-php/health.svg)

```
[![Health](https://phpackages.com/badges/csfacturacion-csplug-php/health.svg)](https://phpackages.com/packages/csfacturacion-csplug-php)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[temporal/sdk

Temporal SDK

4002.2M18](/packages/temporal-sdk)[storyblok/php-content-api-client

PHP Client for Storyblok Content API

11136.8k4](/packages/storyblok-php-content-api-client)[storyblok/php-management-api-client

Storyblok PHP Client for Management API

1224.4k1](/packages/storyblok-php-management-api-client)[smnandre/pagespeed-api

PageSpeed Insight PHP Api Client 🚀 Analyse web pages for performances metrics, core web vitals...

1511.5k](/packages/smnandre-pagespeed-api)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)