Listar pagos del equipo (ledger de cobranza)

GET

/teams/{teamId}/payments

const url = 'https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/payments';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/payments \
  --header 'Authorization: Bearer <token>'

Lista todos los pagos del equipo, con filtros opcionales por cliente y rango de fechas. Usado por Reportes (ingresos cobrados) y por la pantalla de Cobranza en el frontend, que cruza esta lista con GET /teams/{teamId}/trips para derivar el saldo pendiente por viaje.

Authorizations

cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

Query Parameters

clientId

string format: uuid

from

string format: date

Fecha inicial (ISO 8601), filtra por GSI1SK

string format: date

Fecha final (ISO 8601)

Responses

200

Lista de pagos del equipo

application/json

object

payments

Array<object>

Abono/pago registrado contra el saldo de un viaje (no confundir con el CFDI de Invoice)

object

string format: uuid

paymentId

string format: uuid

teamId

string format: uuid

tripId

string format: uuid

clientId

string

nullable

clientName

string

amount

number

> 0

paidAt

string format: date-time

method

Forma en que se cobró el pago

string

Allowed values: EFECTIVO TRANSFERENCIA CHEQUE TARJETA OTRO

reference

string

notes

string

registeredBy

string format: uuid

nullable

createdAt

string format: date-time

updatedAt

string format: date-time

count

integer

Example

{
  "payments": [
    {
      "id": "aa0e8400-e29b-41d4-a716-446655440005",
      "tripId": "880e8400-e29b-41d4-a716-446655440003",
      "amount": 5000,
      "method": "TRANSFERENCIA"
    }
  ],
  "count": 1
}

403

Sin permisos

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}