Partes de reparación

Obtener un ticket de reparación

Devuelve el detalle de un ticket de reparación con sus líneas: qué elemento se repara, su diagnóstico y su precio para el cliente.

Herramienta

filmo_repair_tickets_get

Lecturarepair-tickets:read

repair-tickets:read
120/min
Puede requerir un add-on
Anotación del servidor: Solo lectura
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_repair_tickets_get",
    "arguments": {
      "ticketId": "tick_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "number": "<number>",
      "date": "2026-09-01T08:00:00Z",
      "status": "draft",
      "orderId": "orde_8f2a1c",
      "orderNumber": "<orderNumber>",
      "contactId": "cont_8f2a1c",
      "contactName": "Example",
      "subTotal": "1234.50",
      "taxTotal": "1234.50",
      "total": "1234.50",
      "totalLines": 1,
      "notes": "<notes>",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z",
      "projectId": "proj_8f2a1c",
      "lines": [
        {
          "id": "id_8f2a1c",
          "entityType": "item",
          "entityId": "enti_8f2a1c",
          "entityName": "Example",
          "description": "<description>",
          "diagnosis": "<diagnosis>",
          "quantity": 1,
          "unitPrice": "1234.50",
          "incidentId": "inci_8f2a1c",
          "notes": "<notes>"
        }
      ],
      "sourceIncidentIds": [
        "sour_8f2a1c"
      ],
      "customFields": {
        "key": "<key>"
      }
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}

generado desde el esquema

Argumentos

ticketIdstringObligatorio

Identificador del ticket de reparación.

Límites: longitud mín. 1

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data

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 | null

Identificador del proyecto asociado; null si no tiene.

linesobject[]

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[]

Identificadores de las incidencias que originaron el ticket.

customFieldsobject<string, any>

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

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta GET /api/v1/repair-tickets/{ticketId}.

Partes de reparación
Obtener un ticket de reparación
Devuelve el detalle de un ticket de reparación con sus líneas: qué elemento se repara, su diagnóstico y su precio para el cliente.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

La misma operación por REST

Páginas relacionadas

Obtener un ticket de reparación

Escrituras seguras

Errores