Firma electronica Sri con Xades Ecuador

El proyecto es una api creada en FastApi con python, dados los datos de la factura permite generar el archivo xml firmado, enviarlo a recepción y autorización al SRI, en la response obtendrás la clave de acceso del xml, el archivo firmado, y atributos que te dirán si el archivo fue recibido y autorizado. Nota: Es una base que te podría servir para tu proyecto ya que la idea es usarlo como micro-servicio.

Si te sirve regalame una estrella. ⭐️⭐️⭐️⭐️

Xades

La librería Xades se usa para firmar el xml generado y esta echa en Java, funciona bien con -> jdk version "1.8.0_402". Recomiendo que lo usen y sí lo hacen en docker lo configuren de esa forma.

Python

La versión de Python con la que se creo es: Python 3.11.3

Requisitos para Instalación Local

• Python 3.11
• Java JDK 1.8 (para la librería Xades)

Instalación de Java

Windows

1. Descarga JDK 1.8 desde el sitio oficial de Oracle o AdoptOpenJDK.
2. Instala el JDK.
3. Configura las variables de entorno:
   • Ve a "Propiedades del sistema" > "Variables de entorno".
   • Agrega JAVA_HOME con la ruta de instalación (ej: C:\Program Files\Java\jdk1.8.0_402).
   • Agrega %JAVA_HOME%\bin al PATH.

Mac

1. Instala Homebrew si no lo tienes: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. Instala JDK 1.8: brew install openjdk@8
3. Configura las variables:
   • Agrega a ~/.zshrc o ~/.bash_profile: export JAVA_HOME=/usr/local/opt/openjdk@8/libexec/openjdk.jdk/Contents/Home
   • Agrega export PATH=$JAVA_HOME/bin:$PATH
   • Ejecuta source ~/.zshrc

Linux (Ubuntu/Debian)

1. Actualiza el sistema: sudo apt update
2. Instala JDK 1.8: sudo apt install openjdk-8-jdk
3. Verifica: java -version
4. Las variables de entorno suelen configurarse automáticamente, pero si no, agrega a ~/.bashrc:
   • export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
   • export PATH=$JAVA_HOME/bin:$PATH
   • Ejecuta source ~/.bashrc

Instalación Local

1. Clonar el repositorio
2. Instalar las librerías: pip install -r requirements.txt
3. Colocar la firma electrónica en la carpeta app y nombrarla signature.p12 (p12 es la extensión del archivo)
4. En el archivo env se encuentra la variable PASSWORD allí debes colocar la clave de tu firma electronica
5. Correr la api con: uvicorn main:app --reload
6. Acceder a Swagger UI en: http://localhost:8000/docs (puerto por defecto de Uvicorn)

Ejecución con Docker (Sin Instalación Local)

Este proyecto incluye un Dockerfile que permite ejecutarlo en un contenedor Docker sin necesidad de instalar Python, Java u otras dependencias en tu sistema local (Windows, Mac o Linux). El contenedor incluye automáticamente Java 11 para la librería Xades.

Requisitos

• Docker instalado en tu sistema.

Pasos

1. Clonar el repositorio.
2. Colocar la firma electrónica en la carpeta app y nombrarla signature.p12.
3. Configurar el archivo .env con la clave de tu firma electrónica en la variable PASSWORD.
4. Construir la imagen Docker:

   docker build -t sri-sign-xml-open-source .
   

5. Ejecutar el contenedor:

   docker run -p 5003:5003 sri-sign-xml-open-source
   

6. Acceder a la API en http://localhost:5003.
7. Para interactuar con la API, abre Swagger UI en tu navegador: http://localhost:5003/docs.

Ver Logs

• Para ver logs en tiempo real: docker logs -f <nombre_del_contenedor> (reemplaza con el nombre asignado).
• Si ejecutas en modo detached: docker run -d -p 5003:5003 --name sri-container sri-sign-xml-open-source

Cambios Recientes

• Puerto actualizado a 5003 para evitar conflictos.
• Agregado httpx a requirements.txt para compatibilidad con operaciones asíncronas de zeep.

Créditos

Este proyecto fue inspirado por https://github.com/cmruizg777/FirmaElectronicaPython/tree/master/db

Contacto

Para más información, recomendaciones o dudas puedes escribirme a correo electrónico.