Operaciones

Ticket de reparación

Ticket de reparación: qué se rompió y qué se presupuesta para repararlo.

Esquemas: RepairTicketDto, RepairTicketDetailDto

{
  "id": "id_8f2a1c",
  "number": "string",
  "date": "2026-09-01T08:00:00Z",
  "status": "draft",
  "orderId": "string",
  "orderNumber": "string",
  "contactId": "string",
  "contactName": "Example",
  "subTotal": "1234.50",
  "taxTotal": "1234.50",
  "total": "1234.50",
  "totalLines": 1,
  "notes": "string",
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z",
  "projectId": "string",
  "lines": [
    {
      "id": "id_8f2a1c",
      "entityType": "item",
      "entityId": "string",
      "entityName": "Example",
      "description": "string",
      "diagnosis": "string",
      "quantity": 1,
      "unitPrice": "1234.50",
      "incidentId": "string",
      "notes": "string"
    }
  ],
  "sourceIncidentIds": [
    "string"
  ],
  "customFields": {
    "key": "string"
  }
}

Generado a partir del esquema

Un ticket de reparación de mantenimiento: qué se averió y qué se presupuesta al cliente por arreglarlo. unitPrice es un precio de venta, no un coste, porque el coste de la reparación no se publica. Necesita el add-on incidence. Los tickets de reparación están acotados a la suscripción que posee la clave. La lectura de detalle, GET /api/v1/repair-tickets/{ticketId}, añade las líneas, el proyecto, las incidencias de origen y los campos personalizados.

Atributos

idstring

Identificador único del ticket.

numberstring

Número de ticket, por ejemplo "RT-2026-0001".

datestring<date-time>

Fecha de emisión en ISO 8601 UTC.

statusstring

Estado del ticket en su ciclo de vida.

Opciones disponibles: draft, sent, partially_converted, fully_invoiced, closed

orderIdstring | null

Identificador del pedido del que procede; null si se creó de forma independiente.

orderNumberstring | null

Número del pedido del que procede; null si se creó de forma independiente.

contactIdstring | null

Identificador del cliente responsable; null si no se ha asignado ninguno.

contactNamestring | null

Nombre del cliente responsable; null si no se ha resuelto.

subTotalstring

Suma de las líneas antes de impuestos, como cadena decimal "1234.50".

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

taxTotalstring

Total de impuestos, como cadena decimal "1234.50".

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

totalstring

Total con impuestos, como cadena decimal "1234.50".

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

totalLinesinteger

Número de líneas del ticket.

notesstring | null

Observaciones generales; null si no tiene.

createdAtstring<date-time>

Fecha de creación en ISO 8601 UTC.

updatedAtstring<date-time>

Fecha de la última modificación en ISO 8601 UTC.

projectIdstring | nullsolo en el detalle

Identificador del proyecto asociado; null si no tiene.

linesobject[]solo en el detalle

Líneas del ticket.

Mostrar atributos hijos

lines.idstring

Identificador único de la línea.

lines.entityTypestring | null

Tipo de elemento que se repara: item, serializedItem (una unidad concreta), space o kit; null para una línea libre (un servicio, un cargo).

Opciones disponibles: item, serializedItem, space, kit

lines.entityIdstring | null

Identificador del elemento que se repara; null si es una línea libre.

lines.entityNamestring | null

Nombre del elemento que se repara; null si no se ha resuelto.

lines.descriptionstring

Qué hay que reparar.

lines.diagnosisstring | null

Diagnóstico técnico; null si no se ha registrado ninguno.

lines.quantitynumber | null

Unidades afectadas; null si no aplica.

lines.unitPricestring | null

Precio unitario NETO presupuestado al cliente, como cadena decimal "1234.50". No es el coste de reparación: ese no se publica. null si la línea no tiene precio.

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

lines.incidentIdstring | null

Identificador de la incidencia que originó esta línea; null si no procede de ninguna.

lines.notesstring | null

Notas de la línea; null si no tiene.

sourceIncidentIdsstring[]solo en el detalle

Identificadores de las incidencias que originaron el ticket.

customFieldsobject<string, any>solo en el detalle

Valores de los campos personalizados por identificador de campo personalizado; las definiciones están en /api/v1/custom-fields.

Valores

status: draft, sent, partially_converted, fully_invoiced, closed

Lo devuelven

GET /api/v1/repair-tickets — Listar tickets de reparación
GET /api/v1/repair-tickets/{ticketId} — Obtener un ticket de reparación

Lo modifican

POST /api/v1/repair-tickets — Crear un parte de reparación
PATCH /api/v1/repair-tickets/{ticketId} — Actualizar un ticket de reparación

¿Te ha resultado útil esta página?

Ejemplo

Atributos

Valores

Lo devuelven

Lo modifican