Reporte de cobranza pendiente

GET

/teams/{teamId}/reports/collections

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

• Development environment (dominio custom)
• QA environment
• Production environment
• Development environment (legacy — execute-api URL directo)

Agregación server-side para la pantalla Cobranza: lista los viajes con saldo pendiente (excluye los ya PAGADO), con su estado de cobro derivado y fecha límite, ordenados por fecha límite. Igual que /reports/revenue, pagina internamente todos los viajes/clientes/pagos del equipo.

Authorizations

• cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

Query Parameters

clientId

string format: uuid

status

string

Allowed values: SIN_COBRAR PARCIAL ATRASADO

Filtra por estado de cobro derivado

Responses

200

Reporte de cobranza

Media typeapplication/json

object

rows

Array<object>

object

trip

object

id

string format: uuid

teamId

string format: uuid

status

Estado del viaje

string

Allowed values: NO_INICIADO EN_PROCESO FINALIZADO_A_TIEMPO FINALIZADO_CON_RETRASO CANCELADO

routeId

string format: uuid

nullable

routeName

string

nullable

clientId

string format: uuid

nullable

clientName

string

nullable

driverId

string format: uuid

nullable

driverName

string

nullable

driverPhone

string

nullable

vehicleId

string format: uuid

nullable

vehiclePlate

string

nullable

startDate

string format: date-time

nullable

endDate

string format: date-time

nullable

actualEndDate

string format: date-time

nullable

cargoDescription

string

nullable

cargoWeight

Weight in kg

number

nullable

cargoVolume

Volume in m3

number

nullable

cost

number

nullable

revenue

number

nullable

notes

string

nullable

specialInstructions

string

nullable

cancelledAt

string format: date-time

nullable

cancelledBy

string

nullable

createdAt

string format: date-time

balance

number

status

string

Allowed values: SIN_COBRAR PARCIAL ATRASADO

dueDate

string format: date-time

nullable

count

integer

totalPendiente

number

totalAtrasado

number

Example

{
  "rows": [
    {
      "trip": {
        "id": "880e8400-e29b-41d4-a716-446655440003",
        "revenue": 10000
      },
      "balance": 5000,
      "status": "PARCIAL",
      "dueDate": "2026-08-10T00:00:00Z"
    }
  ],
  "count": 1,
  "totalPendiente": 5000,
  "totalAtrasado": 0
}

400

Solicitud inválida

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

403

Sin permisos

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

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