Changelog · Aguita API

Changelog debug

Cambios del API /api/v1 para front-end, mobile e integradores.

2026-07-22 — Ordenamiento por columna en los reportes de back-office

admin

Los reportes de órdenes, clientes y cisterneros aceptan `sort` + `direction` para ordenar por cualquier columna
Los listados paginados ordenan todo el dataset antes de paginar; la exportación usa el mismo orden

2026-07-21 — Tasa BCV fija por orden, franjas de comisión y endpoint de tasa BCV

cliente conductor admin

Nuevo GET /exchange-rates/bcv (autenticado) con rateBs, fetchedAt, expiresAt y stale
El preview en Bs de GET /orders/{orderId}/payment/form usa el snapshot BCV fijo de la orden
Franjas de comisión (commission_tiers) configurables por método y forma de pago (admin)
GET /surplus/nearby acepta paymentMethod opcional para previsualizar el precio por método

2026-07-20 — Reportes de back-office: órdenes, clientes y cisterneros

admin

Reportes de órdenes: detallado, cancelaciones/expiraciones y operativo por día (AGU-ADM-130/131/132)
Reportes de clientes: detallado y actividad/retención por período (AGU-ADM-140/141)
Reportes de cisterneros: detallado, documentación/KYC y desempeño por período (AGU-ADM-150/151/152)
Cada reporte se consulta en pantalla (JSON) y se exporta a CSV o Excel (.xlsx) bajo demanda

2026-07-17 — Nuevo inbox de notificaciones para cliente y conductor

cliente conductor

Nuevo GET /notifications con cursor y filtro unread
Nuevo GET /notifications/unread-count para el contador de no leídas
Marcar leídas (una o todas) y borrar notificaciones

2026-07-16 — Chat de soporte cliente-admin, registro de device tokens y aviso de mensaje fuera de la sala

cliente conductor admin

Nuevo chat de soporte cliente-admin (room ORDER_ADMIN_CLIENT_SUPPORT)
Nuevos POST y DELETE /device-tokens para registrar el token de push del dispositivo
Nuevo evento WebSocket chat.message_received_notice en el canal personal del destinatario
El inbox de soporte admin se filtra por kind (driver o client)

2026-07-15 — Los mensajes de chat ahora incluyen sender_name

cliente conductor admin

Cada mensaje de chat expone sender_name (nombre de quien lo envió)

2026-07-13 — Cambiar método de pago del pedido y ventana de pago con caducidad

cliente conductor admin

Nuevo PATCH /orders/{orderId}/payment-method para cambiar el método de pago
La orden se cancela si el pago no se completa dentro de su ventana
El payment expone reported_at y expires_at; la orden expone expires_at
Nuevo admin config para las ventanas de aceptación y pago (order/payment expiry)
Los formularios de pago admin aceptan auto_verify para la conciliación automática (Bancamiga)

2026-07-09 — Distancia y ETA en vivo por oferta para comparar (vista cliente)

cliente

Cada oferta PENDING trae distance_km, eta_minutes y driver_busy (vista cliente)
Distancia y ETA se recalculan en vivo desde la posicion actual del conductor
El objeto oferta guarda driver_latitude / driver_longitude al momento del bid

2026-07-06 — Remates: totalAmount reemplaza pricePerLiter y status reemplaza is_active

Breaking cliente conductor

POST /surplus recibe totalAmount (bruto total) en vez de pricePerLiter
Los remates exponen status (ACTIVA/RESERVADA/EXPIRADA/CANCELADA) en vez de is_active
La orden creada al reservar un remate incluye surplus_listing_id
durationMinutes es opcional: max 12h, default 6h

2026-07-03 — El chat pasa a salas y llega el soporte por orden admin-conductor

Breaking cliente conductor admin

GET/POST /chat/{orderId} se elimina: primero se resuelve una sala
Nuevo flujo: POST /orders/{orderId}/chat-rooms y /chat-rooms/{roomId}/messages
Los mensajes en vivo pasan al canal chat.rooms.{id}
Nuevo chat de soporte por orden entre conductor y admin
Nuevo evento order-support.queue en el canal admin.order-support