Saltar a contenido

Empezando con Greenter

En este primero ejemplo, veremos el flujo básico del proceso de facturación electrónica, desde la elaboración del comprobante electrónico (archivo XML), la inclusión de la firma digital, y posterior envió a SUNAT, además de la lectura del CDR1.

Open in Gitpod

Instalación

La forma mas fácil de instalar grenter es utilizando composer.

composer require greenter/lite

Requerimientos

  • Certificado en formato PEM
  • Credenciales Clave SOL

Se necesita tener las siguientes extensiones habilitadas en php.ini.

extension=soap
extension=openssl

Para conocer más detalles sobre el proceso de Facturación Electrónica, puede consultar.

Configuración

Para firmar nuestro comprobante electrónico utilizaremos este certificado de prueba, y para conectarnos a los servicios BETA de SUNAT, usaremos las credenciales Clave SOL por defecto.

  • RUC: 20000000001
  • Usuario: MODDATOS
  • Contraseña: moddatos

Crearemos el archivo config.php donde configuraremos el certificado digital, la ruta del servicio y las credenciales (Clave SOL) a utilizar:

<?php
use Greenter\Ws\Services\SunatEndpoints;
use Greenter\See;

$see = new See();
$see->setCertificate(file_get_contents(__DIR__.'/certificate.pem'));
$see->setService(SunatEndpoints::FE_BETA);
$see->setClaveSOL('20000000001', 'MODDATOS', 'moddatos');

return $see;

Certificado .PFX - PKCS#12

Si cuentas con un certificado .p12 ó .pfx, puedes configurar el certificado con el siguiente código:

<?php
use Greenter\XMLSecLibs\Certificate\X509Certificate;
use Greenter\XMLSecLibs\Certificate\X509ContentType;

// ...

$pfx = file_get_contents('mycert.pfx');
$password = 'YOUR-PASSWORD';

$certificate = new X509Certificate($pfx, $password);

$see->setCertificate($certificate->export(X509ContentType::PEM));

// ...

Definición del comprobante

Para el ejemplo, el comprobante a utilizar será una factura gravada con el siguiente detalle.

Global
Numero F001-1
Fecha de Emisión 21/07/2020
Hora de Emisión 13:05
Moneda Sol (PEN)
RUC de Emisor 20123456789
RUC de Receptor 20000000001
Operaciones Gravadas S/ 100.00
Valor Venta S/ 100.00
IGV S/ 18.00
Total Impuestos S/ 18.00
Importe Total S/ 118.00
Detalle
Codigo P001
Descripcíon Tijeraas
Unidad de Medida Unidad (NIU)
Cantidad 2
Valor unitario S/ 50.00
Valor venta S/ 100.00
Tipo de afectación IGV Gravado (10)
IGV S/ 18.00
Total Impuestos S/ 18.00
Precio unitario S/ 59.00

Factura Electrónica

Crearemos nuestra primera factura electrónica siguiendo el estándar UBL 2.1, en nuevo archivo factura.php agregaremos el siguiente código:

<?php

use Greenter\Model\Client\Client;
use Greenter\Model\Company\Company;
use Greenter\Model\Company\Address;
use Greenter\Model\Sale\Invoice;
use Greenter\Model\Sale\SaleDetail;
use Greenter\Model\Sale\Legend;

require __DIR__.'/vendor/autoload.php';

$see = require __DIR__.'/config.php';

// Cliente
$client = new Client();
$client->setTipoDoc('6')
    ->setNumDoc('20000000001')
    ->setRznSocial('EMPRESA X');

// Emisor
$address = new Address();
$address->setUbigueo('150101')
    ->setDepartamento('LIMA')
    ->setProvincia('LIMA')
    ->setDistrito('LIMA')
    ->setUrbanizacion('-')
    ->setDireccion('Av. Villa Nueva 221')
    ->setCodLocal('0000'); // Codigo de establecimiento asignado por SUNAT, 0000 de lo contrario.

$company = new Company();
$company->setRuc('20123456789')
    ->setRazonSocial('GREEN SAC')
    ->setNombreComercial('GREEN')
    ->setAddress($address);

// Venta
$invoice = (new Invoice())
    ->setUblVersion('2.1')
    ->setTipoOperacion('0101') // Venta - Catalog. 51
    ->setTipoDoc('01') // Factura - Catalog. 01 
    ->setSerie('F001')
    ->setCorrelativo('1')
    ->setFechaEmision(new DateTime('2020-08-24 13:05:00'))
    ->setTipoMoneda('PEN') // Sol - Catalog. 02
    ->setCompany($company)
    ->setClient($client)
    ->setMtoOperGravadas(100.00)
    ->setMtoIGV(18.00)
    ->setTotalImpuestos(18.00)
    ->setValorVenta(100.00)
    ->setSubTotal(118.00)
    ->setMtoImpVenta(118.00)
    ;

$item = (new SaleDetail())
    ->setCodProducto('P001')
    ->setUnidad('NIU') // Unidad - Catalog. 03
    ->setCantidad(2)
    ->setDescripcion('PRODUCTO 1')
    ->setMtoBaseIgv(100)
    ->setPorcentajeIgv(18.00) // 18%
    ->setIgv(18.00)
    ->setTipAfeIgv('10') // Gravado Op. Onerosa - Catalog. 07
    ->setTotalImpuestos(18.00)
    ->setMtoValorVenta(100.00)
    ->setMtoValorUnitario(50.00)
    ->setMtoPrecioUnitario(59.00)
    ;

$legend = (new Legend())
    ->setCode('1000') // Monto en letras - Catalog. 52
    ->setValue('SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES');

$invoice->setDetails([$item])
        ->setLegends([$legend]);

Los catálogos que se mencionan en los comentarios del código se encuentran en la Reglas de Validaciones de SUNAT, puedes obtener la última versión en la página oficial de SUNAT.

Envío a SUNAT

En el mismo archivo factura.php agregaremos el código de abajo, el método send envuelve varios procesos en si, primero genera el XML, lo firma digitalmente, lo envía al servició de SUNAT y procesa la respuesta (CDR).

<?php

$result = $see->send($invoice);

// Guardar XML firmado digitalmente.
file_put_contents($invoice->getName().'.xml',
                  $see->getFactory()->getLastXml());

// Verificamos que la conexión con SUNAT fue exitosa.
if (!$result->isSuccess()) {
    // Mostrar error al conectarse a SUNAT.
    echo 'Codigo Error: '.$result->getError()->getCode();
    echo 'Mensaje Error: '.$result->getError()->getMessage();
    exit();
}

// Guardamos el CDR
file_put_contents('R-'.$invoice->getName().'.zip', $result->getCdrZip());
Para saber como actuar según el código de error que SUNAT devuelve, es muy importante revisar las Reglas de Validación, allí encontraremos todas las validaciones que SUNAT aplica a los diferentes comprobantes electrónicos disponibles, además de lista de catálogos y la lista completa de codigos de error.

Lectura del CDR

Finalmente para saber si nuestro comprobante fue procesado correctamente y ha sido aceptado por SUNAT, necesitamos leer la informacíon contenida en el CDR1.

<?php
/*
* file: factura.php 
*/

$cdr = $result->getCdrResponse();

$code = (int)$cdr->getCode();

if ($code === 0) {
    echo 'ESTADO: ACEPTADA'.PHP_EOL;
    if (count($cdr->getNotes()) > 0) {
        echo 'OBSERVACIONES:'.PHP_EOL;
        // Corregir estas observaciones en siguientes emisiones.
        var_dump($cdr->getNotes());
    }  
} else if ($code >= 2000 && $code <= 3999) {
    echo 'ESTADO: RECHAZADA'.PHP_EOL;
} else {
    /* Esto no debería darse, pero si ocurre, es un CDR inválido que debería tratarse como un error-excepción. */
    /*code: 0100 a 1999 */
    echo 'Excepción';
}

echo $cdr->getDescription().PHP_EOL;

Más detalles sobre que hacer si una factura fue observada o rechazada, aquí.

Ejecutar

Finalmente ejecutaremos el script desde la linea de comandos.

php factura.php
y si todo sale bien obtendremos como respuesta.

Exito!

ESTADO: ACEPTADA
La Factura numero F001-1, ha sido aceptada

Estructura finald del proyecto de ejemplo:

/
├── vendor/
├── certificate.pem
├── composer.json
├── config.php
├── factura.php
├── 20123456789-01-F001-1.xml
├── R-20123456789-01-F001-1.zip

Este ejemplo puedes encontrarlo en @thegreenter/firststeps.

¿Que sigue?

Comentarios

Pueden unirse a 👋 Greenter Community.


  1. Comprobante de Recepción (CDR), es un archivo xml que contiene la respuesta de SUNAT, al envío previo de un comprobante electrónico, en ella se indica si un comprobante ha sido aceptado, aceptado con observaciones o rechazado.