Últimos cambios a la API de Handy

La API de Handy es actualizada con mejoras de vez en cuando.

Hacemos todo lo posible para que sean mejoras que NO rompen integraciones ya desarrolladas. Si esto llegar a suceder, te lo haremos saber, pero es muy raro

Los cambios que pueden romper integraciones, aparecen en rojo.

Si quieres monitorear los cambios, puedes usar nuestro feed de RSS: changes.rss

Julio 2026
  • API v2

    Endpoints para crear, editar y deshabilitar pagos

    Se agregaron tres endpoints sobre /paymentLog para administrar cobranzas:

    • POST /paymentLog — crea un pago. Valida el type (cash por default, check, wire_transfer, debit_card, credit_card) y bloquea con 422 los pagos que excedan el saldo del cliente cuando la compañía no permite sobrepago.
    • PUT /paymentLog/{id} — edita un pago. Igual que en la web, deshabilita el pago original y crea uno nuevo con editedFrom apuntando al original; la respuesta es el pago nuevo.
    • POST /paymentLog/disable/{id} — deshabilita un pago (operación de una sola vía, idempotente).
Junio 2026
  • API v2

    Endpoints para Motivos de devolución

    Se agregaron los endpoints GET, POST, PUT y DELETE sobre /returnReason para administrar los motivos de devolución y merma (returnType: return o ullage).

  • API v2

    Endpoint de distancia recorrida por usuario

    Se agregó un nuevo endpoint GET /user/{userId}/distanceTravelled que regresa la distancia total recorrida por un usuario en un rango de fechas, expresada en kilómetros. El rango máximo permitido es de 7 días.

Mayo 2026