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.

GET
/api/v1/repair-tickets/{ticketId}

Ejemplos de petición

curl https://app.filmo.io/api/v1/repair-tickets/tick_8f2a1c \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": {
    "id": "repair_ticket_9f3a2b",
    "number": "2026-0001",
    "date": "2026-09-01T08:00:00.000Z",
    "status": "draft",
    "orderId": "order_9f3a2b",
    "orderNumber": "2026-0001",
    "contactId": "contact_9f3a2b",
    "contactName": "Example contact name",
    "subTotal": "120.00",
    "taxTotal": "120.00",
    "total": "120.00",
    "totalLines": 1,
    "notes": "Example text.",
    "createdAt": "2026-09-01T08:00:00.000Z",
    "updatedAt": "2026-09-01T08:00:00.000Z",
    "projectId": "project_9f3a2b",
    "lines": [
      {
        "id": "line_9f3a2b",
        "entityType": "item",
        "entityId": "entity_9f3a2b",
        "entityName": "Example entity name",
        "description": "Example text.",
        "diagnosis": "Example diagnosis",
        "quantity": 1,
        "unitPrice": "120.00",
        "incidentId": "incident_9f3a2b",
        "notes": "Example text."
      }
    ],
    "sourceIncidentIds": [
      "source_incident_9f3a2b"
    ],
    "customFields": {
      "example": "example"
    }
  }
}

Generado a partir del esquema

Autorizaciones

Clave de API como Bearer, con el permiso de abajo. repair-tickets:read

Cabeceras

If-None-Matchstring

Lectura condicional: el ETag de la copia que ya tienes. Si el recurso no ha cambiado, la respuesta es 304 sin cuerpo.

Ejemplo:"\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""

Parámetros de ruta

ticketIdstringObligatorio

Identificador del ticket de reparación.

Límites: longitud mín. 1

Respuesta

application/json

Respuesta correcta.

Esquema de la respuesta: RepairTicketDetailDto

Sobre: RepairTicketDetailResponse. meta.warnings solo aparece cuando la operación está obsoleta.

Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag

dataobject

Detalle de un parte de reparación, con sus líneas.

Mostrar atributos hijos
data.idstring

Identificador único del ticket.

data.numberstring

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

data.datestring<date-time>

Fecha de emisión en ISO 8601 UTC.

data.statusstring

Estado del ticket en su ciclo de vida.

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

data.orderIdstring | null

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

data.orderNumberstring | null

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

data.contactIdstring | null

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

data.contactNamestring | null

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

data.subTotalstring

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

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

data.taxTotalstring

Total de impuestos, como cadena decimal "1234.50".

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

data.totalstring

Total con impuestos, como cadena decimal "1234.50".

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

data.totalLinesinteger

Número de líneas del ticket.

data.notesstring | null

Observaciones generales; null si no tiene.

data.createdAtstring<date-time>

Fecha de creación en ISO 8601 UTC.

data.updatedAtstring<date-time>

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

data.projectIdstring | null

Identificador del proyecto asociado; null si no tiene.

data.linesobject[]

Líneas del ticket.

Mostrar atributos hijos
data.lines.idstring

Identificador único de la línea.

data.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

data.lines.entityIdstring | null

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

data.lines.entityNamestring | null

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

data.lines.descriptionstring

Qué hay que reparar.

data.lines.diagnosisstring | null

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

data.lines.quantitynumber | null

Unidades afectadas; null si no aplica.

data.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}$

data.lines.incidentIdstring | null

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

data.lines.notesstring | null

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

data.sourceIncidentIdsstring[]

Identificadores de las incidencias que originaron el ticket.

data.customFieldsobject<string, any>

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

metaobject

Información adicional sobre la respuesta.

Mostrar atributos hijos
meta.warningsobject[]

Avisos del ciclo de vida; solo aparecen cuando la operación está obsoleta.

Mostrar atributos hijos
meta.warnings.codestring

Código de aviso estable.

Opciones disponibles: deprecated

meta.warnings.messagestring

Para personas: qué está obsoleto, hasta cuándo y qué usar.

meta.warnings.sunsetstring

Día (YYYY-MM-DD) en que la operación deja de estar disponible.

meta.warnings.replacementstring | null

operationId de la operación que hay que usar en su lugar, o null si no hay ninguna.

Errores

EstadoCódigosSignificado
402addon_requiredEl plan de la cuenta no incluye el add-on que necesita esta operación; requiredAddon lo nombra.
404not_foundNo existe o queda fuera del alcance de la clave de API.

401, 403, 429, 500 los puede devolver cualquier operación. Errores

Obsolescencia

Esta operación no está obsoleta. Las obsolescencias se anuncian con la cabecera Deprecation y una fecha de retirada. Política de versiones

  • Operaciones

    Ticket de reparación

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