ecuafact (Python)

Cliente oficial en Python del API publico de facturacion electronica Ecuafact (contrato v1). Cubre autenticacion, idempotencia, reintentos y firma de webhooks. Requiere Python 3.9+.

Instalacion

pip install ecuafact

Uso

import os
from ecuafact import ComprobanteRequest, EcuafactClient, EcuafactClientOptions, InfoTributaria

client = EcuafactClient(EcuafactClientOptions(
    base_address="https://staging-api.mynexusapi.com/",  # sandbox; produccion: https://api.mynexusapi.com/
    api_key=os.environ["ECUAFACT_API_KEY"],
    identificacion="1790012345001",  # solo integraciones de un RUC
))

resultado = client.emitir(ComprobanteRequest(
    origen_referencia="MiERP",
    referencia_externa="FACTURA-2026-0001",
    info_tributaria=InfoTributaria(
        ruc="1790012345001", cod_doc="01", estab="002", pto_emi="001", secuencial="000000123"
    ),
    # info=..., detalles=...
))
print(resultado.admission.id_operacion, resultado.admission.codigo)

Multi-RUC

ruc = client.para("1790099987001")
pagina = ruc.listar_emitidos()

Idempotencia

idempotency_key es opcional: si no se envia, el SDK la genera, la reutiliza en los reintentos y la devuelve en resultado.idempotency_key (y en el error, como EcuafactApiException.idempotency_key). Al reintentar a nivel de aplicacion reutiliza la clave devuelta. La correlacion de la respuesta queda en resultado.correlation_id (o EcuafactApiException.id_seguimiento en error).

Los fallos transitorios (408/425/429/5xx) se reintentan con la misma clave respetando Retry-After; el resto de los 4xx no.

Opciones

Errores

Los errores del API se lanzan como EcuafactApiException (codigo, mensaje, estado_http, id_seguimiento, errores, idempotency_key). Los errores locales de configuracion o transporte son EcuafactSdkException.

Webhooks

from ecuafact import verify

valido = verify(secreto, cabecera, cuerpo_crudo, tolerance_seconds=300)

Documentacion

• Guia del SDK Python

Licencia

MIT.