Este recurso te permite gestionar los movimientos financieros de tu espacio de trabajo en tiempo real.
🔍 1. Listar Transacciones
GET /api/transactions
Obtiene un listado paginado de los movimientos del espacio de trabajo actual, ordenados cronológicamente de forma descendente.
- Scope requerido:
transactions:read - Parámetros de consulta (Query Params):
limit(Opcional): Número máximo de resultados (Default:20, Máximo:100).offset(Opcional): Número de elementos a omitir para paginación (Default:0).walletId(Opcional): Filtrar movimientos asociados a una cartera específica.type(Opcional): Filtrar por tipo (income,expense,transfer).
Ejemplo de Respuesta (200 OK):
{
"data": [
{
"id": "tx_gasto_987",
"amount": 450.00,
"type": "expense",
"description": "Cena de negocios",
"date": "2026-07-08",
"walletId": "w_nom_123",
"categoryId": "c_com_456",
"createdAt": "2026-07-08T19:00:00Z"
}
],
"pagination": {
"limit": 20,
"offset": 0,
"total": 142
}
}📝 2. Registrar Transacción
POST /api/transactions
Crea un nuevo ingreso, gasto o transferencia dentro del espacio de trabajo.
- Scope requerido:
transactions:write - Cuerpo de la Petición (JSON):
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
amount | number | Sí | El valor decimal del movimiento (debe ser mayor a 0). |
type | string | Sí | Tipo de movimiento: income, expense o transfer. |
walletId | string | Sí | ID de la cartera de donde sale o a donde entra el dinero. |
destinationWalletId | string | Condicional | ID de la cartera destino (Requerido solo si type es transfer). |
categoryId | string | Condicional | ID de la categoría asociada (Requerido si type es income o expense). |
description | string | No | Nota aclaratoria del movimiento (máx 255 caracteres). |
date | string | No | Fecha en formato YYYY-MM-DD (Default: día de hoy en hora servidor). |
Ejemplo de Petición (curl):
curl -X POST https://money.depot.center/api/transactions \
-H "Authorization: Bearer mm_live_xxxxxx" \
-H "Content-Type: application/json" \
-d '{
"amount": 125.50,
"type": "expense",
"walletId": "w_nom_123",
"categoryId": "c_com_456",
"description": "Café y snacks",
"date": "2026-07-08"
}'Ejemplo de Respuesta (201 Created):
{
"data": {
"id": "tx_gasto_988",
"amount": 125.50,
"type": "expense",
"description": "Café y snacks",
"date": "2026-07-08",
"walletId": "w_nom_123",
"categoryId": "c_com_456",
"createdAt": "2026-07-08T19:05:00Z"
}
}🗑️ 3. Eliminar Transacción
DELETE /api/transactions/[id]
Elimina físicamente un movimiento financiero y revierte automáticamente los balances correspondientes de la cartera asociada.
- Scope requerido:
transactions:write
Ejemplo de Petición:
curl -X DELETE https://money.depot.center/api/transactions/tx_gasto_988 \
-H "Authorization: Bearer mm_live_xxxxxx"Ejemplo de Respuesta (200 OK):
{
"data": {
"success": true,
"message": "La transacción tx_gasto_988 fue eliminada exitosamente y los balances de cartera revertidos."
}
}