Contexto para registrar un gasto

Descripción

Devuelve las categorías de gasto y los orígenes de pago disponibles para el usuario.

Detalles

Retorna las categorías de gasto del negocio y los orígenes válidos para pagarlo: las cajas del usuario con sesión abierta y las cuentas bancarias del negocio. Si la caja preferida del usuario está abierta, queda preseleccionada.

Permisos requeridos

auth-tenant

Request

Este endpoint no recibe parámetros.

Ejemplo de request

curl -X POST https://app.restofy.co/api/expenses/get-context \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>"

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z

HTTP 200

Request

[]

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "categories": [
            {
                "accountId": 80,
                "code": "exp.manual.utilities",
                "name": "Servicios públicos"
            }
        ],
        "cashSources": [
            {
                "accountId": 16,
                "name": "Caja Principal",
                "cashRegisterSessionId": 2,
                "cashRegisterId": 1,
                "isDefault": true
            }
        ],
        "bankSources": [
            {
                "accountId": 25,
                "code": null,
                "name": "Banco general "
            },
            {
                "accountId": 9101,
                "code": null,
                "name": "Bancolombia cuenta principal"
            },
            {
                "accountId": 18,
                "code": null,
                "name": "Datáfono / Terminal POS"
            },
            {
                "accountId": 9102,
                "code": null,
                "name": "Davivienda ahorros"
            },
            {
                "accountId": 9103,
                "code": null,
                "name": "Tarjeta de credito BBVA"
            }
        ],
        "safeSources": [
            {
                "accountId": 9111,
                "code": null,
                "name": "Boveda principal",
                "typeCode": "asset.safe"
            },
            {
                "accountId": 9112,
                "code": null,
                "name": "Buzon nocturno",
                "typeCode": "asset.safe"
            },
            {
                "accountId": 55,
                "code": "asset.safe.system",
                "name": "Caja fuerte del sistema",
                "typeCode": "asset.safe"
            }
        ],
        "requiresPin": false
    }
}