Errores

`conflict`

409. El estado actual del recurso impide la operación, una petición con la misma Idempotency-Key sigue en curso, u otra escritura retenía el recurso, o la base de datos abortó la transacción por un conflicto transitorio, así que no se escribió nada. La causa está en errors[0].code: invalid_state para el primer caso, in_progress para el segundo y lock_timeout para el tercero. detail no sirve para decidir. HTTP 409.

Estado HTTP: 409
Tipo del problema: https://docs.filmo.io/errors/conflict

{
  "type": "https://docs.filmo.io/errors/conflict",
  "title": "Conflict",
  "status": 409,
  "code": "conflict",
  "detail": "The current state of the resource does not allow the operation",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "errors": [
    {
      "path": "",
      "code": "invalid_state",
      "message": "The current state of the resource does not allow the operation"
    }
  ]
}

Cuándo ocurre

Qué hacer

Ramifica según errors[0].code. Para in_progress y lock_timeout, espera y envía de nuevo la misma petición con la misma Idempotency-Key; con backoff para lock_timeout. Si un 409 in_progress persiste unos dos minutos, la reserva se considera abandonada y el siguiente intento con la misma clave se ejecuta, así que lee el recurso antes de reintentar. Para invalid_state, no reintentes sin cambios: lee el recurso y, si la petición aún encaja, puedes enviarla de nuevo; si no, cámbiala para que encaje con su estado; por ejemplo, archivar un pedido que no es borrador ni está cancelado, anular la reserva de un pedido cancelado o cancelar uno ya recepcionado.

Reintento

Reintentar con la misma clave409 conflict · in_progress · Idempotency-Key: Sí
errors[0].code es in_progress: otra petición con la misma Idempotency-Key sigue en curso. Espera y reintenta con la misma clave (espera exponencial, hasta 3 veces): recibirás su respuesta guardada cuando termine.
Reintentar con espera exponencial409 conflict · lock_timeout
errors[0].code es lock_timeout: otra escritura condicional retuvo el recurso más de 5 s. Reintenta con la misma clave y espera exponencial, hasta 3 veces; si persiste, vuelve a leer el recurso.
Leer antes el recurso409 conflict · invalid_state
errors[0].code es invalid_state: el estado del recurso impide la operación (una violación de unicidad, una línea de un lote atómico). No reintentes: esperar no lo arregla nunca. Vuelve a leer el recurso y decide según su estado actual.

Campos de errors[]

errors[].codestring

Código estable del error de campo (required, must_not_be_null, invalid_type, invalid_value, too_small, too_big, unknown_field, invalid_format, not_found, must_be_after…). En un 409 conflict indica la causa: in_progress (otra petición con la misma Idempotency-Key sigue en curso), lock_timeout (otra escritura condicional retuvo el recurso durante más de cinco segundos) o invalid_state (el estado del recurso prohíbe la operación).

Lo devuelven

98 operaciones

POST /api/v1/contacts — Crear un contacto
PATCH /api/v1/contacts/{contactId} — Actualizar un contacto
DELETE /api/v1/contacts/{contactId} — Eliminar un contacto
PATCH /api/v1/contacts/{contactId}/preferences — Actualizar las condiciones comerciales de un contacto
POST /api/v1/contacts/{contactId}/addresses — Añadir una dirección a un contacto
PATCH /api/v1/contacts/{contactId}/addresses/{addressId} — Actualizar una dirección de un contacto
DELETE /api/v1/contacts/{contactId}/addresses/{addressId} — Quitar una dirección de un contacto
POST /api/v1/contacts/{contactId}/related-contacts — Relacionar dos contactos
PATCH /api/v1/contacts/{contactId}/related-contacts/{relatedContactId} — Cambiar el rol de una relación
DELETE /api/v1/contacts/{contactId}/related-contacts/{relatedContactId} — Quitar la relación entre dos contactos
POST /api/v1/items — Crear un artículo
PATCH /api/v1/items/{itemId} — Actualizar un artículo
DELETE /api/v1/items/{itemId} — Eliminar un artículo
PATCH /api/v1/items/{itemId}/physical-properties — Actualizar peso y dimensiones
PATCH /api/v1/items/{itemId}/pricing — Actualizar los precios de un artículo
POST /api/v1/availability/check — Comprobar la disponibilidad de artículos
POST /api/v1/orders — Crear un pedido
PATCH /api/v1/orders/{orderId} — Actualizar la cabecera de un pedido
POST /api/v1/projects — Crear un proyecto
PUT /api/v1/projects/{projectId}/archive — Archivar o restaurar un proyecto
PATCH /api/v1/projects/{projectId} — Actualizar un proyecto
PATCH /api/v1/serialized-items/{serializedItemId} — Actualizar una unidad serializada
PATCH /api/v1/spaces/{spaceId} — Actualizar un almacén o espacio
DELETE /api/v1/spaces/{spaceId} — Eliminar un espacio
PUT /api/v1/spaces/{spaceId}/amenities — Reemplazar las comodidades y el equipamiento
PATCH /api/v1/spaces/{spaceId}/pricing — Actualizar los precios de un espacio
POST /api/v1/repair-tickets — Crear un parte de reparación
PATCH /api/v1/repair-tickets/{ticketId} — Actualizar un ticket de reparación
POST /api/v1/vehicles — Crear un vehículo
PATCH /api/v1/vehicles/{vehicleId} — Actualizar un vehículo
DELETE /api/v1/vehicles/{vehicleId} — Eliminar un vehículo
POST /api/v1/staff — Crear un miembro del personal
PATCH /api/v1/staff/{staffId} — Actualizar un miembro del personal
DELETE /api/v1/staff/{staffId} — Eliminar un miembro del personal
PATCH /api/v1/subrents/{subrentId} — Actualizar un subalquiler
PATCH /api/v1/purchase-orders/{purchaseOrderId} — Actualizar una orden de compra
POST /api/v1/staff/availability — Comprobar la disponibilidad del personal
POST /api/v1/vehicles/availability — Comprobar la disponibilidad de la flota
POST /api/v1/tags — Crear una etiqueta
DELETE /api/v1/tags/{tagId} — Eliminar una etiqueta
POST /api/v1/tags/{tagId}/assignments — Asignar una etiqueta a una entidad
DELETE /api/v1/tags/{tagId}/assignments — Quitar una etiqueta de una entidad
POST /api/v1/kits — Crear un kit
PATCH /api/v1/kits/{kitId} — Actualizar un kit
POST /api/v1/collections — Crear una colección
PATCH /api/v1/collections/{collectionId} — Actualizar una colección
POST /api/v1/services — Crear un servicio
PATCH /api/v1/services/{serviceId} — Actualizar un servicio
POST /api/v1/internal-services — Crear un servicio interno
PATCH /api/v1/internal-services/{internalServiceId} — Actualizar un servicio interno
POST /api/v1/planner/assignments — Asignar un recurso a un servicio
POST /api/v1/planner/assignments/remove — Quitar un recurso de un servicio
POST /api/v1/availability/unavailabilities — Declarar una indisponibilidad
PATCH /api/v1/availability/unavailabilities/{unavailabilityId} — Corregir o cerrar una indisponibilidad
DELETE /api/v1/availability/unavailabilities/{unavailabilityId} — Eliminar una indisponibilidad
POST /api/v1/incidents — Abrir una incidencia
PATCH /api/v1/incidents/{incidentId} — Actualizar una incidencia
POST /api/v1/incidents/{incidentId}/comments — Comentar una incidencia
POST /api/v1/notes — Escribe una nota en una entidad
POST /api/v1/tasks — Crear una tarea
PATCH /api/v1/tasks/{taskId} — Actualizar una tarea
DELETE /api/v1/tasks/{taskId} — Eliminar una tarea
POST /api/v1/crm/opportunities — Crear una oportunidad
PATCH /api/v1/crm/opportunities/{opportunityId} — Actualizar una oportunidad
PATCH /api/v1/crm/opportunities/{opportunityId}/stage — Mover una oportunidad a otra etapa
POST /api/v1/crm/opportunities/{opportunityId}/close — Cerrar una oportunidad
POST /api/v1/crm/opportunities/{opportunityId}/links — Vincular un documento a una oportunidad
POST /api/v1/purchase-orders/{purchaseOrderId}/approve — Aprobar un pedido de compra
POST /api/v1/purchase-orders/{purchaseOrderId}/receive — Recibir material de un pedido de compra
POST /api/v1/treasury/payments — Registrar un pago entrante o saliente
PATCH /api/v1/treasury/payments/{paymentId} — Actualizar un pago
POST /api/v1/treasury/payments/{paymentId}/links — Vincular un pago a un documento
POST /api/v1/orders/{orderId}/cancel — Cancelar un pedido
PUT /api/v1/orders/{orderId}/archive — Archivar o restaurar un pedido
PUT /api/v1/items/{itemId}/accessories — Actualizar los accesorios de un artículo
PUT /api/v1/items/{itemId}/alternatives — Actualizar las alternativas de un artículo
PATCH /api/v1/items/{itemId}/variants/{variantId} — Actualizar una variante de un artículo
POST /api/v1/contacts/lookup — Buscar contactos por referencia externa
POST /api/v1/orders/line-items/returns — Devolver líneas de pedido
POST /api/v1/ai/ask — Preguntar a la IA sobre tus datos
POST /api/v1/workflows/{workflowId}/runs — Ejecutar un workflow
POST /api/v1/orders/{orderId}/reserve — Reservar un pedido
POST /api/v1/orders/{orderId}/unreserve — Anula la reserva de un pedido
POST /api/v1/projects/{projectId}/orders/{orderId} — Vincular un pedido a un proyecto
DELETE /api/v1/projects/{projectId}/orders/{orderId} — Desvincular un pedido de un proyecto
POST /api/v1/invoices/{invoiceId}/validate — Validar una factura
POST /api/v1/invoices/{invoiceId}/void — Anular una factura
PUT /api/v1/invoices/external/{originSystem}/{originExternalId} — Crear o actualizar el espejo de una factura emitida externamente
POST /api/v1/credit-notes/{creditNoteId}/validate — Validar una nota de crédito
POST /api/v1/credit-notes/{creditNoteId}/void — Anular una nota de crédito
PATCH /api/v1/proformas/{proformaId}/status — Cambiar el estado comercial de una proforma
PATCH /api/v1/quotes/{quoteId}/status — Cambiar el estado comercial de un presupuesto
POST /api/v1/contracts/{contractId}/validate — Validar un contrato
POST /api/v1/contracts/{contractId}/sign — Registrar la firma de un contrato
POST /api/v1/contracts/{contractId}/void — Anular un contrato
POST /api/v1/contracts/{contractId}/cancel — Cancelar un contrato a efectos operativos
POST /api/v1/supplier-invoices/{supplierInvoiceId}/validate — Validar una factura de proveedor
POST /api/v1/supplier-invoices/{supplierInvoiceId}/void — Anular una factura de proveedor

Por MCP

Una llamada a una herramienta que falla vuelve con `isError` y el problema como contenido estructurado, con el mismo `code`.

¿Te ha resultado útil esta página?

Ejemplo