Skip to content

facturaselectronicas.biz - PHP

Librería de acceso a la API de facturaselectronicas.biz para PHP.

Instalación

La instalación se realiza vía Composer:

1
composer require paperclip/facturas-electronicas

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 como método del objeto:

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

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

Este código emite una factura electrónica:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
<?php

use Paperclip\FacturasElectrónicas\Facturador;

// Autocargador de Composer. Más información en https://getcomposer.org/doc/01-basic-usage.md#autoloading
require __DIR__ . '/vendor/autoload.php';

// Creamos el objecto facturador con el token y la URL proporcionada al crear el acceso
// a la API. Debes colocar el token y URL de tu cuenta para que funcione.
$facturador = new Facturador(
    '5cfccd27b2bb0f0d3fc860c7a1fb7231d9484c0e59195a5da55af9b7b2b7b703',
    'https://api-testing.facturaselectronicas.biz/ebcf891b-9ec9-4409-a95f-cb8c3c803b17'
);

// Parámetros para la emisión de una factura
$parámetros = [

    // Estos datos son ficticios.
    'numero_doc' => 20123456786,
    'razon_social' => 'ABC CONSULTORES S.A.C',

    // f = Factura electrónica.
    'tipo' => 'f',
    'serie' => 'F001',
    'numero' => 21,
    'fecha' => '2021-01-26',
    'hora' => '07:23',

    // r = RUC
    'tipo_doc' => 'r',

    // PEN = Soles
    'moneda' => 'PEN',
    'total_gravado' => 76.48,
    'total_igv' => 13.77,
    'total_icbper' => 0.4,
    'items' => [
        [
            // NIU = Unidad genérica de bienes
            'unidad' => 'NIU',
            'cantidad' => 1,
            'codigo' => '98765',
            'descripcion' => 'ESCUDO DE VIBRANIUM',
            'precio_unitario' => 41,
            'valor_unitario' => 34.75,
            'valor_venta' => 34.75,
            'igv' => 6.25,

            // 10 = Gravado - operación onerosa
            'afectacion_igv' => 10,
        ],
        [
            'unidad' => 'NIU',
            'cantidad' => 1,
            'codigo' => '43210',
            'descripcion' => 'LAWGIVER MK II',
            'precio_unitario' => 49,
            'valor_unitario' => 41.53,
            'valor_venta' => 41.53,
            'igv' => 7.48,
            'afectacion_igv' => 10,
        ],
        [
            'unidad' => 'NIU',
            'cantidad' => 1,
            'codigo' => 'BP001',
            'descripcion' => 'BOLSA DE PLÁSTICO GRANDE',
            'precio_unitario' => 0.2,
            'valor_unitario' => 0.17,
            'igv' => 0.04,
            'afectacion_igv' => 10,
            'icbper' => 0.4,
        ]
    ],
];

try {
    // Emitimos el comprobante
    $resultado = $facturador->emitir($parámetros);
} catch (Exception $e) {
    // Si falla, generará una excepción. Obtenemos el resultado
    echo get_class($e) . ': ' . $e->getMessage() . PHP_EOL . PHP_EOL;

    // $resultado tendrá información del error.
    $resultado = $facturador->obtenerRespuesta();

    var_dump($resultado);
    exit;
}

// En este punto, el comprobante fue recibido satisfactoriamente por la API.
// El resultado del comando 'emitir' estará en la variable $resultado.
//
// Puedes ver más información sobre las variables del resultado en la URL
// https://docs.paperclip.com.pe/api-facturación/documentación/comando-emitir/#variables-de-retorno
//
echo "Comprobante emitido." . PHP_EOL . PHP_EOL;
var_dump($resultado);

Al ejecutar este código con un $token y $url válido, mostrará algo similiar a:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
Comprobante emitido.

array(7) {
  ["estado"]=>
  string(2) "ok"
  ["valor_resumen"]=>
  string(28) "AKXZBYFhI4idLnFLAnUvSPra95o="
  ["codigo_descarga"]=>
  string(40) "4c05b054213fb1663588a2281de81219cc8bbeae"
  ["codigo_documento"]=>
  string(22) "20123456781-01-F001-21"
  ["sunat_respuesta"]=>
  string(1) "0"
  ["sunat_descripcion"]=>
  string(43) "La Factura numero F001-21, ha sido aceptada"
  ["sunat_observacion"]=>
  array(0) {
  }
}