PHPackages                             paperclip/facturas-electronicas - 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. paperclip/facturas-electronicas

Abandoned → [paperclip/fabo](/?search=paperclip%2Ffabo)ArchivedLibrary[API Development](/categories/api)

paperclip/facturas-electronicas
===============================

Integración de la API facturaselectronicas.biz de Paperclip.

v1.22(2y ago)027GPL-3.0-or-laterPHP

Since Jun 13Pushed 2y ago1 watchersCompare

[ Source](https://github.com/paperclip-eirl/facturas-electronicas)[ Packagist](https://packagist.org/packages/paperclip/facturas-electronicas)[ Docs](https://facturaselectronicas.biz)[ RSS](/packages/paperclip-facturas-electronicas/feed)WikiDiscussions master Synced yesterday

READMEChangelog (6)DependenciesVersions (7)Used By (0)

facturaselectronicas.biz - PHP
==============================

[](#facturaselectronicasbiz---php)

Librería de acceso a la API de [facturaselectronicas.biz](https://facturaselectronicas.biz/) para PHP.

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

[](#instalación)

La instalación se realiza vía [Composer](https://packagist.org/packages/paperclip/facturas-electronicas):

```
composer require paperclip/facturas-electronicas
```

Uso
---

[](#uso)

El constructor de la clase `Paperclip\FacturasElectrónicas\Facturador` acepta tres parámetros:

- `$token`, el token recibido cuando creas el acceso a la API de facturación de Paperclip.
- `$url`, la URL para acceder a la API de facturación de Paperclip, también recibida cuando creas el acceso.

Al instanciar un objecto `Paperclip\FacturasElectrónicas\Facturador`, puedes ejecutar un [comando de la API](https://docs.paperclip.com.pe/api-facturaci%C3%B3n/#comandos) como método del objeto:

- [`Facturador::hola(array $parámetros):array`](https://docs.paperclip.com.pe/api-facturaci%C3%B3n/documentaci%C3%B3n/comando-hola/): Comando para realizar pruebas de comunicación.
- [`Facturador::emitir(array $parámetros):array`](https://docs.paperclip.com.pe/api-facturaci%C3%B3n/documentaci%C3%B3n/comando-emitir/): Genera un nuevo comprobante, ya sea factura, boleta, o sus notas correspondientes.
- [`Facturador::baja(array $parámetros): array`](https://docs.paperclip.com.pe/api-facturaci%C3%B3n/documentaci%C3%B3n/comando-baja/): Solicita la baja (anulación) un comprobante.
- [`Facturador::correo(array $parámetros):array`](https://docs.paperclip.com.pe/api-facturaci%C3%B3n/documentaci%C3%B3n/comando-correo/): Envia el PDF y el XML por correo electrónico a los destinatarios especificados.
- [`Facturador::consultarRuc(array $parámetros):array`](https://docs.paperclip.com.pe/api-facturaci%C3%B3n/documentaci%C3%B3n/comando-consultarruc/): Obtiene información sobre un RUC, o un DNI con empresa.
- [`Facturador::consultarTicket(array $parámetros):array`](https://docs.paperclip.com.pe/api-facturaci%C3%B3n/documentaci%C3%B3n/comando-consultarticket/): Consulta el estado de un ticket de una transacción diferida de la SUNAT.

`$parámetros` es el array de parámetros requerido por cada comando de la API.

Excepciones
-----------

[](#excepciones)

Cuando la API retorna un error, se genera varias excepciones según el tipo de error. Todas las excepciones extienden `\Exception`:

- **`Paperclip\FacturasElectrónicas\ExcepciónAutorización`**: Excepción lanzada cuando hubo un error en la fase de autorización, como un UUID o token inválido.
- **`Paperclip\FacturasElectrónicas\ExcepciónNegociación`**: Excepción lanzada cuando hubo un error en la fase de negociaciación con la API, como error en la cabecera HTML del formato a usar, etc.
- **`Paperclip\FacturasElectrónicas\ExcepciónParámetros`**: Excepción lanzada cuando hubo un error en los parámetros enviados a la API.
- **`Paperclip\FacturasElectrónicas\ExcepciónFatal`**: Excepción lanzada cuando hubo un error no previsto en la API o en esta librería.

Ejemplo
-------

[](#ejemplo)

Este código emite una factura electrónica:

```