CAcardda
Budget request

Ask for more funds or a new budget

Creates a pending budget request and notifies whoever can approve it.

Who can ask

  • more_funds ("Más fondos"): someone in the budget (its Encargado, a co-encargado, or a participant, explicit or through a card) without budgets_manage. An admin / budgets_manage user gets budget_requests/use_top_up: they adjust the budget directly, with POST /v1/budgets/{id}/top_up for a funded budget or PATCH /v1/budgets/{id}/amount for a tracking one. GET /v1/budgets/{id} says whether the caller can ask (viewer.can.request_funds) and returns their pending request (own_pending_request).
  • new_budget ("Presupuesto nuevo"): any active member of the company.

Only one pending request per person and budget (more_funds) or per person and name (new_budget): another one answers budget_requests/already_pending.

post/v1/budget_requests

Request

  • Base URL
    https://api.cardda.com
  • URL
    https://api.cardda.com/v1/budget_requests
  • Auth
    HTTP bearer

Parameters

#/paths/~1v1~1bills/get/parameters/0 (unresolved $ref)

Request body

OR

Example request

{
  "kind": "more_funds",
  "amount_cents": 500000,
  "reason": "Viaje a la feria de Santiago",
  "period_scope": "current_period",
  "name": "Eventos Q4",
  "recurrence_every": 1
}

Response

The request created, pending.

idstring uuid required
company_idstring uuid required
kind'more_funds' | 'new_budget' required
  • more_funds ("Más fondos"): more money for an existing budget (budget_id).
  • new_budget ("Presupuesto nuevo"): a budget that doesn't exist yet; approving it creates the budget and budget_id points to it from then on.
status'pending' | 'approved' | 'rejected' | 'withdrawn' | 'canceled' required
  • pending: waiting for an admin.
  • approved: an admin approved it; the money moved (or the budget was created).
  • rejected: an admin rejected it; resolution_note says why.
  • withdrawn: whoever asked withdrew it.
  • canceled: the budget closed while it was pending (resolution_note is budget_closed).
budget_idstring uuid nullable

The budget asked about (more_funds), or the one created on approval (new_budget). null for a new_budget request not approved.

requested_amount_centsinteger required

What was asked for.

approved_amount_centsinteger nullable

What the admin approved (the amount asked for unless changed). null until approved.

currencystring required
period_scope'current_period' | 'next_periods' | 'null' nullable

Only for more_funds on a recurring budget (null otherwise):

  • current_period: the money is for the period in progress.
  • next_periods: raises what each period starts with (base_amount_cents) from the next renewal on.
reasonstring

Why the requester needs it.

resolution_notestring nullable

The admin's note when rejecting it. budget_closed when it was canceled because its budget closed.

namestring nullable

Name of the budget asked for (new_budget only).

recurrence_unit'week' | 'month' | 'year' | 'null' nullable

How often the budget asked for should renew (new_budget only). null if it shouldn't.

recurrence_everyinteger nullable

How many recurrence_unit each period of the budget asked for spans (new_budget only).

participant_idsstring[]

Users the requester wants in the new budget (new_budget only; empty otherwise).

origin_channel'web' | 'whatsapp' required

Where it was asked from.

resolved_atstring date-time nullable

When it was approved, rejected, withdrawn or canceled.

created_atstring date-time required

Example response

{
  "kind": "more_funds",
  "status": "pending",
  "requested_amount_cents": 500000,
  "approved_amount_cents": 400000,
  "currency": "CLP",
  "period_scope": "current_period",
  "reason": "Viaje a la feria de Santiago",
  "name": "Eventos Q4",
  "origin_channel": "web"
}

Changes

No recorded changes to this operation across all 1 revision of this API.