API de Fiscal Lens

Tu sistema le manda la factura y recibe de vuelta los datos ya extraídos, cada comprobación hecha y el dictamen sobre el crédito fiscal. Sin que nadie teclee un monto, sin abrir el navegador y sin cambiar cómo trabaja tu equipo.

Para qué la vas a querer

• Tu sistema administrativo valida solo. Cuando alguien carga una compra, la factura ya viene revisada.
• Cierre de mes sin teclear. Recorres la carpeta de facturas del mes y cada una vuelve con sus montos.
• Tu software, tu marca. Si desarrollas para terceros, la auditoría queda dentro de tu producto.

Cómo se identifica

Con la cabecera x-license-token y el código de licencia que aparece en tu portal de cliente. Es el mismo que usa la página de Fiscal Lens.

Ese código es tuyo y da acceso a tu plan: guárdalo en tu servidor, nunca dentro de una página web ni de una aplicación que entregues a terceros.

Comprobar que la licencia responde

curl -H "x-license-token: TU_LICENCIA" \
     https://accountingtech.store/api/v1/salud

{"estado": "ok", "plan": "MASIVO", "vence": "2027-09-04"}

Auditar una factura

POST /api/v1/facturas, con el archivo en multipart/form-data. Acepta PDF, JPG y PNG.

curl -X POST https://accountingtech.store/api/v1/facturas \
     -H "x-license-token: TU_LICENCIA" \
     -F "file=@factura.pdf" \
     -F "rif=J-12345678-9" \
     -F "precision=medio"

Qué te devuelve

Dos cosas: factura, que es el resumen listo para guardar en tu base de datos, e informe, con todas las comprobaciones y el dictamen completo.

{
  "estado": "ok",
  "factura": {
    "numero": "000012",
    "control": "00-123456",
    "fecha": "18/07/2026",
    "emisor_rif": "J-40660009-1",
    "emisor_nombre": "DISTRIBUIDORA EJEMPLO C.A.",
    "receptor_rif": "J-12345678-9",
    "base": 34603.36,
    "iva": 5536.54,
    "exento": 0.0,
    "igtf": 0.0,
    "total": 40139.90,
    "estado_lectura": "fiable",
    "veredicto": "si"
  },
  "informe": { "meta": {...}, "validaciones": [...], "auditoria_texto": "..." }
}

• estado_lectura: fiable cuando la lectura se sostiene, dudosa cuando conviene que una persona la mire. Preferimos decírtelo antes que inventar un monto.
• veredicto: si, revisar o no, sobre el aprovechamiento del crédito fiscal.
• validaciones: cada comprobación con su resultado y su explicación.

Qué precisión pedir

Respuestas de error

Un ejemplo completo

import requests

LICENCIA = "tu-licencia"

with open("factura.pdf", "rb") as f:
    r = requests.post(
        "https://accountingtech.store/api/v1/facturas",
        headers={"x-license-token": LICENCIA},
        files={"file": f},
        data={"rif": "J-12345678-9", "precision": "medio"},
        timeout=180,
    )

if r.status_code == 200:
    d = r.json()["factura"]
    print(d["numero"], d["total"], d["veredicto"])
else:
    print("no se pudo:", r.status_code, r.text)

Pon un tiempo de espera generoso: una foto en precisión alta tarda cerca de un minuto, y más en horas de mucho uso. Si vas a auditar muchas, mándalas de una en una o en grupos pequeños.