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.
repair-tickets:read- 120/min
- Ámbito estricto
- Complemento (402)
- If-None-Match
- MCP: filmo_repair_tickets_get
Ejemplos de petición
curl https://app.filmo.io/api/v1/repair-tickets/tick_8f2a1c \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. repair-tickets:read
Cabeceras
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
Identificador del ticket de reparación.
Límites: longitud mín. 1
Respuesta
Respuesta correcta.
Esquema de la respuesta: RepairTicketDetailDto
Sobre: RepairTicketDetailResponse. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag
Detalle de un parte de reparación, con sus líneas.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del ticket.
Número de ticket, por ejemplo "RT-2026-0001".
Fecha de emisión en ISO 8601 UTC.
Estado del ticket en su ciclo de vida.
Opciones disponibles: draft, sent, partially_converted, fully_invoiced, closed
Identificador del pedido del que procede; null si se creó de forma independiente.
Número del pedido del que procede; null si se creó de forma independiente.
Identificador del cliente responsable; null si no se ha asignado ninguno.
Nombre del cliente responsable; null si no se ha resuelto.
Suma de las líneas antes de impuestos, como cadena decimal "1234.50".
Límites: patrón ^-?\d+\.\d{2}$
Total de impuestos, como cadena decimal "1234.50".
Límites: patrón ^-?\d+\.\d{2}$
Total con impuestos, como cadena decimal "1234.50".
Límites: patrón ^-?\d+\.\d{2}$
Número de líneas del ticket.
Observaciones generales; null si no tiene.
Fecha de creación en ISO 8601 UTC.
Fecha de la última modificación en ISO 8601 UTC.
Identificador del proyecto asociado; null si no tiene.
Líneas del ticket.
Mostrar atributos hijosOcultar atributos hijos
Identificador único de la línea.
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
Identificador del elemento que se repara; null si es una línea libre.
Nombre del elemento que se repara; null si no se ha resuelto.
Qué hay que reparar.
Diagnóstico técnico; null si no se ha registrado ninguno.
Unidades afectadas; null si no aplica.
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}$
Identificador de la incidencia que originó esta línea; null si no procede de ninguna.
Notas de la línea; null si no tiene.
Identificadores de las incidencias que originaron el ticket.
Valores de los campos personalizados por identificador de campo personalizado; las definiciones están en /api.
Información adicional sobre la respuesta.
Mostrar atributos hijosOcultar atributos hijos
Avisos del ciclo de vida; solo aparecen cuando la operación está obsoleta.
Mostrar atributos hijosOcultar atributos hijos
Código de aviso estable.
Opciones disponibles: deprecated
Para personas: qué está obsoleto, hasta cuándo y qué usar.
Día (YYYY-MM-DD) en que la operación deja de estar disponible.
operationId de la operación que hay que usar en su lugar, o null si no hay ninguna.
Dónde está documentada la deprecación (el changelog).
No modificado: el If-None-Match enviado coincide con el ETag actual. Sin cuerpo; la copia que tienes está al día.
Cabeceras: ETag
Sin cuerpo.
Fallo de autenticación (unauthorized, api_key_invalid, api_key_revoked, api_key_expired, api_key_owner_inactive, api_key_owner_not_admin).
Cabeceras: X-Request-Id · Content-Language
Add-on requerido (addon_required): el plan de la cuenta no incluye el add-on que necesita esta operación; requiredAddon lo nombra.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
No permitido (insufficient_scope: la clave de API no tiene el scope requerido, indicado en requiredScope; forbidden: el propietario de la clave carece del permiso que exige la operación). insufficient_scope se responde antes de que la petición cuente contra el límite de peticiones, así que no lleva cabeceras RateLimit-*; forbidden sí.
Cabeceras: X-Request-Id · Content-Language
Recurso no encontrado (not_found): no existe o está fuera del alcance de la clave de API.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Límite de peticiones superado (rate_limited): reintenta tras Retry-After segundos; RateLimit-* indica qué cuota se ha agotado.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Retry-After
Error interno (internal_error).
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Errores
| Estado | Códigos | Significado |
|---|---|---|
| 402 | addon_required | El plan de la cuenta no incluye el add-on que necesita esta operación; requiredAddon lo nombra. |
| 404 | not_found | No 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
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasOperaciones
Ticket de reparación
Ticket de reparación: qué se rompió y qué se presupuesta para repararlo.
¿Te ha resultado útil esta página?