Pedidos
Actualizar la cabecera de un pedido
Cambia la cabecera de un pedido: cliente, proyecto y fechas de alquiler (envía solo los campos que cambian; el resto queda como estaba).
Ejemplos de petición
curl https://app.filmo.io/api/v1/orders/orde_8f2a1c \
--request PATCH \
--header "Authorization: Bearer $FILMO_API_KEY" \
--header "Idempotency-Key: $(uuidgen 2>/dev/null || cat /proc/sys/kernel/random/uuid)" \
--header 'Content-Type: application/json' \
--data '{
"projectId": "prj_rodaje_otono",
"startDate": "2026-09-08T08:00:00+02:00",
"endDate": "2026-09-12T20:00:00+02:00"
}'Generado a partir del esquema
Cambiar startDate o endDate mueve el pedido ENTERO: se mueve con él cada línea que hereda el periodo del pedido (las secciones, los grupos por tipo y las líneas ya recepcionadas conservan el suyo), junto con sus reservas de stock y sus tareas de entrega y devolución; los precios no se recalculan. Si el stock no cabe en el nuevo periodo, o el pedido está cancelado o devuelto, responde 409 conflict y no se escribe nada; enviar las fechas que ya tiene no cambia nada. NO añade, quita ni edita líneas: eso pasa por el editor. Tampoco acepta importes ni estado, igual que la creación. El cliente y el proyecto se comprueban contra la cuenta de la clave de API antes de escribir nada. Devuelve el pedido completo, con la misma proyección que su GET.
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. orders:write
Cabeceras
Identificador único de la petición, elegido por el cliente (sirve un UUID). Entre 1 y 255 caracteres: una cabecera vacía se rechaza con 400 validation_error, porque el cliente se creería protegido. Repetir la misma clave con el MISMO cuerpo en 24 h devuelve la respuesta guardada sin volver a ejecutar, con la cabecera Idempotent-Replay: true. Con un cuerpo DISTINTO devuelve 422. Es la forma segura de reintentar tras un tiempo de espera de red.
Límites: longitud mín. 1, longitud máx. 255
Ejemplo:"9f1c2f4e-3a5b-4f6d-8e7a-0b1c2d3e4f5a"
Bloqueo optimista: el ETag que leíste del recurso (o *). Si el recurso ha cambiado desde entonces, la escritura se rechaza con 412 precondition_failed antes de hacer nada; léelo de nuevo y reintenta. Sin la cabecera, la escritura siempre se realiza.
Ejemplo:"\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
Parámetros de ruta
Identificador del pedido.
Límites: longitud mín. 1
Cuerpo
Esquema del cuerpo: OrderUpdateBody
Identificador del cliente del pedido. Debe pertenecer a la cuenta de la clave de API.
Límites: longitud mín. 1, longitud máx. 100
Proyecto al que está asignado el pedido; null lo desvincula (pedido independiente).
Límites: longitud mín. 1, longitud máx. 100
Inicio del alquiler (ISO 8601 con desplazamiento).
Fin del alquiler (ISO 8601 con desplazamiento); debe ser posterior a startDate.
Respuesta
Respuesta correcta.
Esquema de la respuesta: OrderDetailDto
Sobre: OrderDetailResponse. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag · Idempotent-Replay
El pedido completo, tal como lo devuelve la API.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del pedido.
Número de pedido legible.
Referencia externa del pedido (por ejemplo, del sistema del cliente); null si no consta.
Estado bruto del pedido tal como se almacena en la base de datos (12 valores): draft, reserved, prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned, checked_in_partially, checked_in, archived o cancelled. archived forma parte del conjunto almacenado, pero un pedido archivado no es visible para la API, así que no lo observarás.
Opciones disponibles: draft, reserved, prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned, checked_in_partially, checked_in, archived, cancelled
Inicio del periodo de alquiler en ISO 8601 con desplazamiento.
Fin del periodo de alquiler en ISO 8601 con desplazamiento.
Número de días de alquiler facturables; null si no se ha calculado.
Identificador del proyecto al que pertenece el pedido; null si no está vinculado.
Nombre del proyecto al que pertenece el pedido; null si no está vinculado.
Referencia compacta al contacto del pedido; null si no hay.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del contacto.
Nombre del contacto.
Número de artículos del pedido.
Subtotal antes de descuentos e impuestos, como cadena decimal "1234.50" (ROUND_HALF_UP).
Límites: patrón ^-?\d+\.\d{2}$
Total de descuentos como cadena decimal "1234.50" (ROUND_HALF_UP); null si no hay descuento.
Límites: patrón ^-?\d+\.\d{2}$
Total del seguro como cadena decimal "1234.50" (ROUND_HALF_UP).
Límites: patrón ^-?\d+\.\d{2}$
Total de fianzas como cadena decimal "1234.50" (ROUND_HALF_UP).
Límites: patrón ^-?\d+\.\d{2}$
Total de impuestos como cadena decimal "1234.50" (ROUND_HALF_UP).
Límites: patrón ^-?\d+\.\d{2}$
Base imponible (neto antes de impuestos) como cadena decimal "1234.50" (ROUND_HALF_UP).
Límites: patrón ^-?\d+\.\d{2}$
Total con impuestos, como cadena decimal "1234.50" (ROUND_HALF_UP).
Límites: patrón ^-?\d+\.\d{2}$
Valores de los campos personalizados por identificador de campo personalizado; las definiciones están en /api.
Origen desde el que se creó el pedido (por ejemplo web, mobile, admin); null si no consta.
Fecha de creación en ISO 8601 con desplazamiento.
Fecha de la última actualización en ISO 8601 con desplazamiento.
Dirección de facturación del pedido; null si no hay.
Mostrar atributos hijosOcultar atributos hijos
Etiqueta descriptiva de la dirección; null si no consta.
Primera línea de la dirección; null si no consta.
Segunda línea de la dirección; null si no consta.
Ciudad; null si no consta.
Provincia o región; null si no se ha registrado.
Código postal; null si no se ha registrado.
País; null si no consta.
Dirección de envío del pedido; null si no hay.
Mostrar atributos hijosOcultar atributos hijos
Etiqueta descriptiva de la dirección; null si no consta.
Primera línea de la dirección; null si no consta.
Segunda línea de la dirección; null si no consta.
Ciudad; null si no consta.
Provincia o región; null si no se ha registrado.
Código postal; null si no se ha registrado.
País; null si no consta.
Persona de contacto vinculada al pedido; null si no hay ninguna.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del contacto.
Nombre del contacto.
Referencias informativas a los presupuestos generados a partir del pedido.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del documento referenciado.
Número del documento; null hasta que se numera.
Estado del documento en el momento en que se escribió la referencia; null si no consta. Informativo: puede estar desactualizado.
Referencias informativas a las facturas generadas a partir del pedido.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del documento referenciado.
Número del documento; null hasta que se numera.
Estado del documento en el momento en que se escribió la referencia; null si no consta. Informativo: puede estar desactualizado.
Referencias informativas a las proformas generadas a partir del pedido.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del documento referenciado.
Número del documento; null hasta que se numera.
Estado del documento en el momento en que se escribió la referencia; null si no consta. Informativo: puede estar desactualizado.
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).
Petición no válida (validation_error): consulta o cuerpo mal formados. errors[] enumera cada campo erróneo con su código estable.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Idempotent-Replay
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 · Idempotent-Replay
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 · Idempotent-Replay
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 · Idempotent-Replay
Conflicto (conflict): el estado actual del recurso impide la operación, ya hay en curso una petición con esa Idempotency-Key, o otra escritura condicional (If-Match) retuvo el recurso durante más de cinco segundos. errors[0]. indica cuál: in_progress y lock_timeout se resuelven reintentando; invalid_state no, porque el estado del recurso prohíbe la operación.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Idempotent-Replay
Precondición fallida (precondition_failed): la etiqueta de entidad If-Match no coincide con la representación actual. Lee el recurso de nuevo y reintenta.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Idempotent-Replay
Idempotency-Key reutilizada (idempotency_key_reused): la misma clave se usó antes con un cuerpo distinto. Cambia la clave.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Idempotent-Replay
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 · Idempotent-Replay
Error interno (internal_error).
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Idempotent-Replay
Errores
| Estado | Códigos | Significado |
|---|---|---|
| 400 | validation_error | Consulta o cuerpo mal formados. errors[] enumera cada campo erróneo con su código estable. |
| 404 | not_found | No existe o queda fuera del alcance de la clave de API. |
| 409 | conflict | El estado actual del recurso impide la operación, ya hay en curso una petición con esa Idempotency-Key, u otra escritura condicional (If-Match) retuvo el recurso durante más de cinco segundos. errors[0]. indica cuál: in_progress y lock_timeout se resuelven reintentando; invalid_state no, porque el estado del recurso prohíbe la operación. |
| 412 | precondition_failed | La etiqueta de entidad If-Match no coincide con la representación actual. Vuelve a leer el recurso y reintenta. |
| 422 | idempotency_key_reused | La misma clave se usó antes con un cuerpo distinto. Cambia la clave. |
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
Relacionado
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasAlquileres
Pedido
El pedido, tal como lo devuelve la API.
¿Te ha resultado útil esta página?