Alquileres

Presupuesto

El presupuesto, tal como lo devuelve la API.

Esquemas: QuoteDto, QuoteDetailDto

{
  "id": "id_8f2a1c",
  "quoteNumber": "string",
  "versionNumber": 1,
  "status": "draft",
  "operativeStatus": "pending",
  "issueDate": "2026-09-01T08:00:00Z",
  "validUntil": "2026-09-01T08:00:00Z",
  "startDate": "2026-09-01T08:00:00Z",
  "endDate": "2026-09-01T08:00:00Z",
  "currency": "EUR",
  "contact": {
    "id": "id_8f2a1c",
    "name": "Example"
  },
  "orderId": "string",
  "orderNumber": "string",
  "projectId": "string",
  "subTotal": "1234.50",
  "discountTotal": "1234.50",
  "taxesPrice": "1234.50",
  "netPrice": "1234.50",
  "grossPrice": "1234.50",
  "totalPaid": "1234.50",
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z",
  "projectName": "Example",
  "taxBreakdown": [
    {
      "taxType": "1234.50",
      "label": "Example",
      "rate": 1,
      "baseAmount": "1234.50",
      "amount": "1234.50"
    }
  ]
}

Generado a partir del esquema

Un presupuesto, mostrado como su versión activa. status es el ciclo de vida del documento y operativeStatus es el estado comercial; confirmar una versión deja las demás como superseded. Los presupuestos están acotados a la suscripción que posee la clave. La lectura de detalle, GET /api/v1/quotes/{quoteId}, añade el nombre del proyecto y el desglose de impuestos. Las líneas se leen con GET /api/v1/quotes/{quoteId}/lines.

Atributos

idstring

Identificador único del presupuesto (contenedor).

quoteNumberstring

Número de presupuesto legible.

versionNumberinteger

Número de la versión activa del presupuesto.

statusstring

Estado del ciclo de vida del documento de la versión activa: draft o validated (validado y numerado).

Opciones disponibles: draft, validated

operativeStatusstring

Estado comercial de la versión activa: pending (a la espera de respuesta), confirmed (aceptada), cancelled (rechazada o cancelada) o superseded (sustituida).

Opciones disponibles: pending, confirmed, cancelled, superseded

issueDatestring<date-time> | null

Fecha de emisión de la versión activa en ISO 8601 con desfase; null si no se ha emitido.

validUntilstring<date-time> | null

Fecha de validez del presupuesto en ISO 8601 con desplazamiento; null si no se ha fijado.

startDatestring<date-time>

Inicio del periodo de alquiler presupuestado en ISO 8601 con desplazamiento.

endDatestring<date-time>

Fin del periodo de alquiler presupuestado en ISO 8601 con desplazamiento.

currencystring

Divisa del presupuesto como código ISO 4217 (por ejemplo "EUR").

contactobject | null

Referencia compacta al contacto del presupuesto; null si no hay.

Mostrar atributos hijos

contact.idstring

Identificador único del contacto.

contact.namestring

Nombre del contacto.

orderIdstring | null

Identificador del pedido vinculado; null si no está vinculado.

orderNumberstring | null

Número del pedido vinculado; null si no está vinculado.

projectIdstring | null

Identificador del proyecto vinculado; null si no está vinculado.

subTotalstring

Subtotal antes de descuentos e impuestos, como cadena decimal "1234.50" (ROUND_HALF_UP).

Límites: patrón ^-?\d+\.\d{2}$

discountTotalstring

Total de descuentos como cadena decimal "1234.50" (ROUND_HALF_UP).

Límites: patrón ^-?\d+\.\d{2}$

taxesPricestring

Total de impuestos como cadena decimal "1234.50" (ROUND_HALF_UP).

Límites: patrón ^-?\d+\.\d{2}$

netPricestring

Base imponible (neto antes de impuestos) como cadena decimal "1234.50" (ROUND_HALF_UP).

Límites: patrón ^-?\d+\.\d{2}$

grossPricestring

Total con impuestos, como cadena decimal "1234.50" (ROUND_HALF_UP).

Límites: patrón ^-?\d+\.\d{2}$

totalPaidstring | null

Importe cobrado contra el presupuesto como cadena decimal "1234.50" (ROUND_HALF_UP); null si no consta.

Límites: patrón ^-?\d+\.\d{2}$

createdAtstring<date-time>

Fecha de creación del contenedor en ISO 8601 con desplazamiento.

updatedAtstring<date-time>

Fecha de la última actualización en ISO 8601 con desplazamiento.

projectNamestring | nullsolo en el detalle

Nombre del proyecto vinculado; null si no está vinculado.

taxBreakdownobject[] | nullsolo en el detalle

Desglose de impuestos por tipo; null si no se ha calculado.

Mostrar atributos hijos

taxBreakdown.taxTypestring

Clave del tipo de impuesto (por ejemplo "IVA_21").

taxBreakdown.labelstring

Etiqueta de impuesto legible.

taxBreakdown.ratenumber

Tipo impositivo aplicado, como porcentaje (por ejemplo 21 para el 21%).

taxBreakdown.baseAmountstring

Base imponible sobre la que se aplica el impuesto, como cadena decimal "1234.50" (ROUND_HALF_UP).

Límites: patrón ^-?\d+\.\d{2}$

taxBreakdown.amountstring

Importe del impuesto como cadena decimal "1234.50" (ROUND_HALF_UP).

Límites: patrón ^-?\d+\.\d{2}$

Valores

status: draft, validated
operativeStatus: pending, confirmed, cancelled, superseded

Lo devuelven

GET /api/v1/quotes — Listar presupuestos
GET /api/v1/quotes/{quoteId} — Obtener un presupuesto

Lo modifican

PATCH /api/v1/quotes/{quoteId}/status — Cambiar el estado comercial de un presupuesto

¿Te ha resultado útil esta página?

Ejemplo

Atributos

Valores

Lo devuelven

Lo modifican