Stars: 173
Forks: 139
Pull Requests: 31
Issues: 47
Watchers: 38
Last Updated: 2022-12-07 20:47:43
Biblioteca Estándar de LibreDTE en PHP
License: GNU Affero General Public License v3.0
Languages: PHP, Makefile
https://packagist.org/packages/sasco/libredte
LibreDTE: Biblioteca Estándar en PHP
LibreDTE es un proyecto que tiene por objetivo proveer Facturación Electrónica
Libre para Chile.
Aquí podrás encontrar la biblioteca escrita en lenguaje PHP para la integración
con el Servicio de Impuestos Internos (SII) asociada a los Documentos Tributarios
Electrónicos (DTE).
La biblioteca se construye originalmente para ser usada en la
Aplicación Web de LibreDTE Versión Comunidad.
En esta biblioteca sólo estará lo básico, sin interfaces de usuario, para que un
desarrollador pueda construir su propia aplicación.
Si deseas una aplicación "llegar y usar" sin preocuparte por instalaciones o
servidores, revisa la Aplicación Web de LibreDTE Versión Oficial.
Podrás registrarte y usar la plataforma web de facturación junto a otros módulos.
Importante: SASCO SpA, empresa autora y dueña de LibreDTE, no provee soporte
oficial para integraciones usando esta Biblioteca de manera directa. SASCO SpA
sólo provee el soporte para integraciones mediante servicios web de la
plataforma web de LibreDTE, normalmente en www.libredte.cl.
Funcionalidades implementadas
- Conexión a maullin o palena.
- Obtención de token para autenticación automática.
- Obtención de estado de un DTE a través del folio, fecha y monto.
- Parser para set de pruebas.
- Generación de XML, timbraje y firma del DTE.
- Generación, y envío, de XML EnvioDTE firmado.
- Consulta del estado de envío de DTE a través de su Track ID.
- Consulta del estado de envío de un Libro a través de su Track ID.
- Documentos oficialmente soportados (sets certificados):
- Factura electrónica (33).
- Factura exenta electrónica (34).
- Boleta electrónica (39).
- Boleta exenta electrónica (41).
- Factura de compra electrónica (46).
- Guía de despacho electrónica (52).
- Nota de débito electrónica (56).
- Nota de crédito electrónica (61).
- Factura de exportación electrónica (110).
- Nota de débito exportación electrónica (111).
- Nota de crédito exportación electrónica (112).
- Información electrónica de compras y ventas (IECV).
- Libro de guías de despacho electrónico.
- Libro de boletas y reporte de consumo de folios (RCOF).
- Etapa de intercambio con otros contribuyentes:
- Acuse de recibo.
- Recibo de mercaderías y servicios prestados.
- Resultado validación.
- Generación de DTE en PDF a partir de su XML, hoja carta y papel contínuo.
- Generación de IECV en PDF a partir de su XML.
- Impuestos adicionales (excepto combustibles).
- Cesión electrónica (factoring).
- Acciones para el Registro de Compras y Ventas (RCV).
- Ingresar aceptación o reclamo.
- Listar eventos del DTE.
- Consultar posibilidad de cesión del DTE.
- Consultar fecha de recepción en SII del DTE.
Funcionalidades independientes
- Conversión de arreglos PHP a XML.
- Firma electrónica de un XML.
- Internacionalización.
- Sistema de logs.
Formatos soportados de entrada de datos de DTE
- Formatos oficiales con estructura del SII:
Instalación
Directamente desde la terminal con:
$ composer require sasco/libredte
O editando el archivo composer.json y agregando:
{
"require": {
"sasco/libredte": "21.10.*"
}
}
Los ejemplos están disponibles en el directorio
examples.
Los ejemplos que requieren archivos XML son casos donde el XML es entregado
por el SII o bien casos de XML generados por la misma biblioteca.
Términos y condiciones de uso
Al utilizar este proyecto, total o parcialmente, automáticamente se acepta
cumplir con los términos y condiciones de uso
que rigen a LibreDTE. La Licencia Pública General Affero de GNU (AGPL)
sólo aplica para quienes respeten los términos y condiciones de uso. No existe
una licencia comercial de LibreDTE, por lo cual no es posible usar el proyecto
si no aceptas cumplir dichos términos y condiciones.
La versión resumida de los términos y condiciones de uso de LibreDTE que
permiten utilizar el proyecto, son los siguientes:
- Tienes la libertad de: usar, estudiar, distribuir y cambiar LibreDTE.
- Si utilizas LibreDTE en tu software, el código fuente de dicho software deberá
ser liberado de manera pública bajo licencia AGPL.
- Si haces cambios a LibreDTE deberás liberar de manera pública el código fuente
de dichos cambios bajo licencia AGPL.
- Debes hacer referencia de manera pública en tu software al proyecto y autor
original de LibreDTE, tanto si usas LibreDTE sin modificar o realizando
cambios al código.
Es obligación de quienes quieran usar el proyecto leer y aceptar por completo
los términos y condiciones de uso.
Contribuir al proyecto
Si deseas contribuir con el proyecto, especialmente resolviendo alguna de las
issues abiertas o creando nuevos
ejemplos sobre el
uso de la biblioteca, debes:
- Hacer fork del proyecto en GitHub
- Crear una branch para los cambios: git checkout -b nombre-branch
- Modificar código: git commit -am 'Se agrega...'
- Publicar cambios: git push origin nombre-branch
- Crear un pull request para unir la nueva branch con LibreDTE.
IMPORTANTE: antes de hacer un pull request verificar que el código
cumpla con los estándares PSR-1,
PSR-2 y
PSR-4.
Contacto y redes sociales