backend YANCARLOSOFICIAL/api-facturas-2
API Facturas IA
Extracción de datos estructurados de facturas PDF usando GPT-4o y FastAPI.
Structured data extraction from PDF invoices using GPT-4o and FastAPI.
FastAPIPythonOpenAIDockerJWT
terminal — clonar
$ git clone https://github.com/YANCARLOSOFICIAL/api-facturas-2.git
$ cd api-facturas-2
// puntos clave
// key points
- Extracción estructurada: JSON validado con Pydantic (cliente, NIT, totals, IVA) a partir del PDF.
- Lotes y reintentos: sube 100 facturas a la vez; los fallos se reencolan con backoff exponencial.
- Autenticación JWT: por usuario, con límites de rate por plan.
- Docker: imagen de ~200 MB con worker de cola incluido.
// README.md del repositorio
Descargado del repositorio en cada build. Downloaded from the repository on every build.Sistema de Procesamiento de Facturas con IA
Descripción
Sistema basado en IA para procesar facturas en formato PDF y extraer información estructurada usando GPT-4o, FastAPI y Python.
Este sistema permite la extracción de datos estructurados a partir de facturas en formato PDF, desarrollado con FastAPI, Python y OpenAI.
Características
- Extracción automática de datos de facturas PDF
- API REST con FastAPI
- Procesamiento con GPT-4o
- Interfaz web moderna para subir facturas
- Validación de datos con Pydantic
- Autenticación JWT
Instalación
Opción 1: Usando entorno virtual (recomendado)
- Clonar el repositorio
- Crear entorno virtual:
python -m venv venv
venv\Scripts\activate
- Instalar dependencias:
pip install -r requirements.txt
- Configurar variables de entorno en
.env:
OPENAI_API_KEY=tu_api_key_aqui
- Iniciar el servidor:
python server_web.py
Opción 2: Sin entorno virtual
- Clonar el repositorio
- Instalar dependencias globalmente:
pip install -r requirements.txt
- Configurar variables de entorno en
.env:
OPENAI_API_KEY=tu_api_key_aqui
- Iniciar el servidor:
python server_web.py
Uso
Interfaz Web
Abre el navegador y ve a:
- http://localhost:8001 (con entorno virtual)
- http://localhost:8002 (sin entorno virtual)
Sube tu factura PDF y obtén los datos estructurados.
API REST
Procesar una factura
curl -X POST "http://localhost:8000/process" \
-H "Content-Type: multipart/form-data" \
-F "file=@factura.pdf"
Respuesta esperada:
{
"invoice_id": "uuid",
"document_type": "FACTURA ELECTRONICA",
"series": "A001",
"number": "12345",
"issue_date": "2025-07-24",
"due_date": "2025-08-24",
"supplier": {
"name": "Proveedor S.A.",
"tax_id": "123456789",
"address": "Calle 123"
},
"currency": "COP",
"items": [
{
"description": "Producto 1",
"quantity": 1,
"unit_price": 100000,
"subtotal": 100000
}
],
"taxes": {
"iva": 19.0
},
"totals": {
"subtotal": 100000,
"taxes_total": 19000,
"total": 119000
}
}
Estructura del Proyecto
app/
├── api/
│ ├── v1/
│ │ ├── endpoints/
│ │ └── __init__.py
│ └── __init__.py
├── core/
│ ├── config.py
│ └── __init__.py
├── schemas/
│ ├── invoice.py
│ └── __init__.py
├── services/
│ ├── pdf_processor.py
│ ├── ai_extractor.py
│ └── __init__.py
├── main.py
├── server_web.py
└── web_interface.html