tilde-afip 0.1.0a1

SDK oficial de Tilde para Python — facturación electrónica ARCA (ex AFIP) en Argentina. Server-side.

tilde-afip

SDK oficial de Tilde para Python — facturación electrónica ARCA (ex AFIP) en Argentina.

⚠️ Server-side / backend-to-backend. No uses Client Credentials en código que corra en un cliente no confiable. El client_secret nunca debe filtrarse.

Estado: alpha (0.1.0a1). API sujeta a cambios hasta 1.0.0.

Instalación

pip install tilde-afip

Requiere Python 3.10+. Sin dependencias de runtime (transport sobre la stdlib).

Quickstart

from tilde_afip import TildeClient

tilde = TildeClient(
    client_id="...",
    client_secret="...",
    environment="sandbox",        # "production" por default
    scopes=["invoicing:write"],
)

invoice = tilde.invoices.create({ ... }, idempotency_key=my_key)
print(invoice["cae"])

El token OAuth2 (client credentials) se obtiene y cachea automáticamente.

Errores tipados

from tilde_afip import TildeValidationError

try:
    tilde.invoices.create(req, idempotency_key=key)
except TildeValidationError as e:
    print(e.code, e.status, e.retryable, e.correlation_id, e.body.get("errors"))

Familias: TildeValidationError, TildeAuthenticationError, TildeAuthorizationError, TildeRateLimitError, TildeConflictError, TildeNotFoundError, TildePaymentRequiredError, TildeApiError.

Webhooks

Verificá con el raw body, antes de parsear:

from tilde_afip import construct_event

event = construct_event(
    payload=raw_body,                       # str | bytes, tal cual llegó
    signature_header=request.headers["X-Tilde-Signature"],
    secret=webhook_secret,
)
if event["type"] == "invoice.authorized":
    ...

HMAC-SHA256 en tiempo constante, con anti-replay por timestamp.

Entornos

Entorno	Base URL
production	https://api.tildeafip.com/v1
sandbox	https://sandbox.api.tildeafip.com/v1

Acceso genérico

Cualquier endpoint de la API: tilde.request("GET", "/cuit-profiles"). El recurso invoices está tipado como ejemplo; la cobertura tipada completa se generará del contrato.

Licencia

Ver LICENSE.