# Casos de uso

## 1. Recibo individual

Un sistema comercial genera un recibo de agua potable y solicita una referencia Paynet. La API responde con referencia, codigo de barras, fecha limite e identificador Openpay.

## 2. Layout masivo JSON

El cliente envia hasta 10,000 recibos en una sola solicitud. La API procesa asincronamente y reporta errores por item.

## 3. Layout CSV/XLSX

El operador carga un archivo desde el portal administrativo o por API. La plataforma valida columnas, guarda lote y procesa cada linea con trazabilidad.

## 4. Pago en tienda

El ciudadano paga en tienda afiliada Paynet. Openpay envia webhook, la plataforma actualiza estado y avisa por callback al sistema comercial.

## 5. Sistema externo fuera de linea

Si el callback falla, la plataforma registra `callback_failed`, programa reintentos y permite reenvio manual.

## 6. Webhook perdido

La conciliacion automatica consulta Openpay y detecta que una referencia fue pagada aunque no haya llegado webhook.

## 7. Diferencia de importe

La conciliacion marca alerta `amount_difference`, registra evidencia y evita confirmar pagos inconsistentes sin revision.

## 8. Multiples organismos

Cada municipio u organismo tiene API keys, configuracion Openpay, webhooks, callbacks, usuarios y auditoria independiente.