HTTP-DTE

API HTTP para la emisión de documentos tributarios de Chile (SII)

MIT License

Stars
12

HTTP DTE

ESTE PROYECTO EST EN DESARROLLO, NO DEBE SER USADO EN PRODUCCIN

Este es un experimento en progreso que usa la librera PHP de LibreDTE para generar una API HTTP. Con esta API podrs generar documentos y enviarlos al Servicio de Impuestos Internos de Chile.

La implementacin de esta API est realizada con docker y docker-compose y slim, esto permite integrar la API con cualquier lenguage. La API no administra ningn estado, en cada peticin ser necesario enviar valores como la firma y los folios entre otros parmetros, Por lo mismo es responsabilidad del consumer implementar un sistema de autenticacin. El uso de docker-composer permite generar una red interna donde un segundo backend puede realizar peticiones HTTP a esta API, este segundo backend ser el encargado de administrar todo lo relacionado a los DTEs

Esquema con ejemplo de como usar la librera

Requisitos

Para Probar la librera necesitas

Instalacin

Desarrollo

API

Si deseas hacer llamadas directamente a la API ejecuta:

docker-compose up -f ./docker-compose.api.yml

Esto instalar todas las dependencias automticamente y quedar listo para usar

Puedes acceder a la api desde: http://localhost:8000

NOTA: No es necesario reiniciar el contenedor al realizar un cambio en la librera, estos sern reconocidos automticamente

Llamada entre contenedores

El archivo docker-compose.yml contiene ejemplos con diferentes lenguajes para utilizar HTTP-DTE

Para instalar las dependencias de NodeJS primero hay que ejecutar:

sudo docker-compose -f ejemplos/node/docker-compose.builder.yml run --rm install

Si no te interesa NodeJS comenta el servicio app-node en docker-compose-yml y no ejecutes el comando anterior)

Finalmente ejecuta

docker-compose up

Este timo comando ejecutar todos los ejemplos disponibles

  • Abrir http://localhost:3000 para ver el ejemplo de NodeJS
  • Abrir http://localhost:3001 para ver el ejemplo de PHP

Peticiones

Lista de endpoints disponibles

El archivo docker-compose.yml contiene un ejemplo de como comunicar el container de HTTP DTE y el que vayas a usar como backend

Lista de Tareas

  • Envo de Facturas (33)
  • Envo de Facturas Exentas (34)
  • Envo de Nota de Crdito (61)
  • Envo de Nota de Dbito (56)
  • Gua de Despacho (52)
  • Envo Libro de Guas de Despacho
  • Envo de Libro de Compras
  • Envo de Libro de Ventas
  • Envo de Boleta Electrnica (39)
  • Leer estado de DTE
  • Enviar Set de Pruebas Bsico
  • Enviar Multiples DTEs
  • Seleccin de Formato de Hoja en PDF
  • Lista de Contribuyentes Autorizados
  • Mejorar manejo de errores

Contribuciones

Cualquier PR es bienvenido y si tienes algn problema no dudes en abrir un issue para poder resolverlo.

LICENCIA

Este proyecto est liberado bajo la licencia MIT, quiere decir que puedes hacer lo que quieras (incluso comercialmente). Sin embargo LibreDTE tiene su propia licencia, verifica esto en su repositorio.