Finanzas

Proforma

Proforma: la factura anticipada que todavía no es una factura.

Esquemas: ProformaDto

{
  "id": "id_8f2a1c",
  "proformaNumber": "string",
  "status": "string",
  "operativeStatus": "string",
  "issueDate": "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"
}

Generado a partir del esquema

Una proforma: la factura anticipada que todavía no es una factura. Tiene un estado de documento y un estado operativo (pending, confirmed o cancelled), que es la respuesta del cliente, y el operativo se cambia con PATCH /api/v1/proformas/{proformaId}/status. Comparte el scope de las facturas.

Atributos

idstring

Identificador de la proforma.

proformaNumberstring | null

Número de la proforma; null mientras es un borrador.

statusstring

Estado del ciclo de vida del documento.

operativeStatusstring | null

Estado comercial: pending (a la espera de respuesta), confirmed (aceptado por el cliente) o cancelled; null si no consta.

issueDatestring<date-time> | null

Fecha de emisión en ISO 8601 UTC; null mientras no tiene.

currencystring

Moneda de los importes, como código ISO 4217.

contactobject | null

Contacto al que se emite la proforma; null si no consta.

Mostrar atributos hijos

contact.idstring

Identificador del contacto.

contact.namestring

Nombre del contacto.

orderIdstring | null

Pedido de origen de la proforma; null si no procede de uno.

orderNumberstring | null

Número de ese pedido; null si no procede de uno.

projectIdstring | null

Proyecto vinculado a la proforma; null si no hay ninguno.

subTotalstring

Subtotal antes de descuentos e impuestos, como cadena decimal.