giansalex/lycet
giansalex/lycet has 106 GitHub stars and 63 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-18 08:40 UTC. Last push 2026-11-10.
Measured star growth
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
API REST de Facturación Electrónica Sunat utilizando Greenter.
Developer ToolsREADME.md
OriginalLycet - Greenter
Lycet es un API REST basado en greenter y Symfony Framework, UBL 2.1 es soportado.
Objetivo: Ofrecer una interfaz a greenter desde otros lenguajes de programación.
LIVE (Pruebas)
| :rocket: | |
|---|---|
| URL | https://greenter-lycet.herokuapp.com/ |
| API TOKEN | greenter |
Requerimientos
- Php 7.4 o superior
- Php Extensions habilitadas (soap, xml, openssl, zlib)
- WkhtmltoPdf executable (PDF report)
- Pem Certificate - convert pfx to pem
Pasos
Instalar Lycet
git clone https://github.com/giansalex/lycet
cd lycet
composer install -o
Configuraciones
En el archivo .env ubicado en la raíz del proyecto, podrá cambiar estas configuraciones.
###> greenter/greenter ###
WKHTMLTOPDF_PATH=full/path/wkhtmltopdf.exe
CLIENT_TOKEN=123456
SOL_USER=20000000001MODDATOS
SOL_PASS=moddatos
FE_URL=https://e-beta.sunat.gob.pe/ol-ti-itcpfegem-beta/billService
RE_URL=https://e-beta.sunat.gob.pe/ol-ti-itemision-otroscpe-gem-beta/billService
GUIA_URL=https://e-beta.sunat.gob.pe/ol-ti-itemision-guia-gem-beta/billService
###< greenter/greenter ###
Tener en cuenta que
SOL_USERes la concatenación del RUC + Usuario SOL
Archivos Requeridos
Se necesita almacenar el certificado y logo en la carpeta /data, los archivos deben tener nombres específicos que se indican
a continuación.
/data
├── cert.pem
├── logo.png
├── empresas.json (opcional para multiples empresas)
También puede usar lycet-ui-config como interfaz de usuario, siendo mas útil esta opción cuando emplea contenedores.
API de gestión de empresas
También puede gestionar empresas programáticamente via API:
Registrar/Actualizar empresa:
curl -X PUT "http://localhost:8000/api/v1/configuration/company/20000000001?token=123456" \
-H "Content-Type: application/json" \
-d '{
"SOL_USER": "20000000001MODDATOS",
"SOL_PASS": "moddatos",
"certificate": "<certificado .pem en base64>",
"FE_URL": "https://e-factura.sunat.gob.pe/ol-ti-itcpfegem/billService"
}'
Subir logo (separado para evitar límite de payload):
curl -X PUT "http://localhost:8000/api/v1/configuration/company/20000000001/logo?token=123456" \
-H "Content-Type: application/json" \
-d '{"logo": "<logo en base64>"}'
Eliminar logo:
curl -X DELETE "http://localhost:8000/api/v1/configuration/company/20000000001/logo?token=123456"
Eliminar empresa:
curl -X DELETE "http://localhost:8000/api/v1/configuration/company/20000000001?token=123456"
Los campos opcionales (FE_URL, RE_URL, GUIA_URL, AUTH_URL, API_URL, CLIENT_ID, CLIENT_SECRET) permiten configurar URLs por empresa. Si no se proporcionan, se usan las del .env.
Ejemplo de contenido del archivo empresas.json, tambien puede cambiar la URL de los servicios para apuntar a un OSE.
{
"20000000001": {
"SOL_USER": "20000000001MODDATOS",
"SOL_PASS": "moddatos",
"certificate": "20000000001-cert.pem",
"logo": "20000000001-logo.png"
},
"20000000002": {
"SOL_USER": "20000000002MODDATOS",
"SOL_PASS": "moddatos",
"certificate": "20000000002-cert.pem",
"logo": "20000000002-logo.png",
"FE_URL": "https://my-ose.com/billService",
"RE_URL": "https://my-ose.com/billService",
"GUIA_URL": "https://my-ose.com/billService",
"AUTH_URL": "https://api-test-seguridad.sunat.gob.pe/v1",
"API_URL": "https://api-test.sunat.gob.pe/v1",
"CLIENT_ID": "85e5b0ae-255c-4891-a595-0b98c65c9854",
"CLIENT_SECRET": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
Para pruebas de Guia de remision, utilizar la siguiente configuración issue#605
Ejecutar
Usando Php Built-in Web Server.
php -S 0.0.0.0:8000 -t public
Docker
Desplegar con Docker.
git clone https://github.com/giansalex/lycet
cd lycet
docker build -t lycet .
# copiar certificado y logo de prueba (puedes reemplazar por uno personal)
cp tests/Resources/* data
# ejecutar el contenedor
docker run -d -p 8000:8000 -v ./data:/var/www/html/data --name lycet_app lycet
Abrir el navegador, y dirígete a http://localhost:8000/
Docs
Puedes visitar greenter en postman que contiene ejemplos del envío de algunos comprobantes.
Ver swagger documentation, puedes crear un cliente en swagger editor, para tu lenguaje de preferencia.
