arca-status

¿Están funcionando los web services de ARCA/AFIP? Averigualo desde Python o la terminal, sin certificados ni clave fiscal.

Cuando ARCA se cae, tu integración de facturación electrónica se cae con ella. arca-status consulta el método FEDummy de WSFEv1 — que devuelve la salud de los servidores de ARCA (AppServer / DbServer / AuthServer) sin necesidad de ticket WSAA ni certificado — para que sepas al instante si el problema es tuyo o de ellos.

Parte del toolkit de FactuARCA, el servicio que factura en ARCA automáticamente desde Zoho Books.

Instalación

pip install arca-status

CLI

$ arca-status
WSFEv1 [produccion]: OK  app=OK db=OK auth=OK (412 ms)

$ arca-status --env homologacion --wsaa
WSFEv1 [homologacion]: OK  app=OK db=OK auth=OK (388 ms)
WSAA   [homologacion]: ALCANZABLE (HTTP 200, 201 ms)

$ arca-status --json
{
  "wsfev1": {
    "env": "produccion", "reachable": true,
    "app_server": "OK", "db_server": "OK", "auth_server": "OK",
    "latency_ms": 412, "error": null, "service": "wsfev1", "ok": true
  }
}

El exit code es 0 si WSFEv1 está OK y 1 en caso contrario — útil en scripts y health checks.

Uso como librería

from arca_status import probe_wsfe, probe_all

s = probe_wsfe("produccion")
if not s.ok:
    print(f"ARCA con problemas: app={s.app_server} db={s.db_server} auth={s.auth_server}")

# Ambos servicios (WSFEv1 + reachability de WSAA) en un dict serializable:
probe_all("produccion")

probe_wsfe() nunca levanta excepción: ante un problema de red/TLS devuelve un WsfeStatus con reachable=False y el error en .error.

Cómo funciona

FEDummy es un método público de WSFEv1 pensado justamente para monitoreo: no lleva la sección Auth (token/sign/cuit) que exigen el resto de las operaciones, así que no hace falta ni certificado ni delegación. arca-status también resuelve el detalle de que los servidores de ARCA usan claves DH cortas que el OpenSSL por defecto de Python 3.10+ rechaza (baja SECLEVEL a 1 solo para esos hosts).

Desarrollo

pip install -e ".[dev]"
pytest
ruff check .

Licencia

MIT © FactuARCA.

Hecho por FactuARCA — facturá en ARCA automáticamente desde Zoho Books.