APIs

Suite de APIs Fiscales para España

Tres APIs REST desplegadas en producción que cubren las necesidades fiscales más habituales para aplicaciones dirigidas al mercado español. Desarrolladas con FastAPI y publicadas en marketplaces de APIs para uso externo.

API 1 — Spain Tax ID Validator

Valida en tiempo real los principales identificadores fiscales españoles usando los algoritmos oficiales de la AEAT:

• NIF: Módulo 23 sobre tabla TRWAGMYFPDXBNJZSQVHLCKE
• NIE: Prefijos X/Y/Z, conversión a dígito y aplicación de módulo 23
• CIF: Suma de pares e impares, control por letra o dígito según tipo de entidad (SA, SL, Coop…)
• IBAN: Reordenación + conversión alfanumérica + módulo 97
• Código Postal: Verificación de provincia (01-52, incl. Ceuta y Melilla)
• Batch: Hasta 100 validaciones en una sola llamada

API 2 — Spanish Invoice PDF Generator

Genera facturas en PDF conformes al RD 1619/2012 a partir de un JSON. Todos los campos obligatorios AEAT incluidos automáticamente:

• Numeración correlativa por serie (A-0001, A-0002…)
• IVA múltiple por línea (0%, 4%, 10%, 21%)
• Retención IRPF (0%, 7%, 15%) para autónomos
• Descuentos por línea, notas, vencimiento
• Respuesta: PDF en base64 + totales calculados

API 3 — Spain IRPF & Tax Calculator

Calculadora fiscal completa para 2025, actualizada con los últimos tramos y cuotas:

• Simulación autónomo: bruto facturado → gastos → cuota SS → IRPF → neto final
• Tramos IRPF: estatales + autonómicos para las 17 CC.AA.
• Cuotas SS autónomos 2025: 13 tramos según rendimiento neto
• Simulación asalariado: bruto → neto, coste empresa incluido
• Pago trimestral: cálculo Modelo 130

Tecnologías

Python · FastAPI · Pydantic · ReportLab · Nginx