Errores

`not_found`

404. El recurso no existe, o existe fuera del aislamiento de la clave; la API responde igual en ambos casos, así que nunca revela que algo existe. Los pedidos archivados también responden 404 en su GET, y un registro eliminado responde 404 a partir de entonces. HTTP 404.

Estado HTTP: 404
Tipo del problema: https://docs.filmo.io/errors/not_found

{
  "type": "https://docs.filmo.io/errors/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "Resource not found",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}

Cuándo ocurre

Qué hacer

Comprueba el identificador y que la clave pertenece a la cuenta (o a la cuenta principal, en los recursos que heredan de ella) propietaria del registro. En una sincronización, un 404 en un registro que ya tienes significa que se eliminó, se archivó o quedó fuera de alcance: confirma cuál de los casos es antes de quitarlo de tu lado.

Reintento

Corregir y reenviarCualquier 4xx de validación
Corrige la petición y reenvíala; nunca en bucle.

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

129 operaciones

POST /api/v1/contacts — Crear un contacto
GET /api/v1/contacts/{contactId} — Obtener 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
GET /api/v1/contacts/{contactId}/related-contacts — Listar los contactos relacionados con 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
GET /api/v1/items/{itemId} — Obtener 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
GET /api/v1/orders/{orderId} — Obtener un pedido
PATCH /api/v1/orders/{orderId} — Actualizar la cabecera de un pedido
GET /api/v1/orders/{orderId}/lines — Listar las líneas de un pedido
GET /api/v1/invoices/{invoiceId} — Obtener una factura
GET /api/v1/quotes/{quoteId} — Obtener un presupuesto
POST /api/v1/projects — Crear un proyecto
PUT /api/v1/projects/{projectId}/archive — Archivar o restaurar un proyecto
GET /api/v1/projects/{projectId} — Obtener un proyecto
PATCH /api/v1/projects/{projectId} — Actualizar un proyecto
GET /api/v1/invoices/{invoiceId}/payments — Listar los pagos de una factura
GET /api/v1/invoices/{invoiceId}/lines — Listar las líneas de una factura
GET /api/v1/quotes/{quoteId}/lines — Listar las líneas de un presupuesto
GET /api/v1/serialized-items/{serializedItemId} — Obtener una unidad serializada
PATCH /api/v1/serialized-items/{serializedItemId} — Actualizar una unidad serializada
GET /api/v1/spaces/{spaceId} — Obtener un almacén o espacio
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
GET /api/v1/repair-tickets/{ticketId} — Obtener un ticket de reparación
PATCH /api/v1/repair-tickets/{ticketId} — Actualizar un ticket de reparación
POST /api/v1/vehicles — Crear un vehículo
GET /api/v1/vehicles/{vehicleId} — Obtener 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
GET /api/v1/staff/{staffId} — Obtener un miembro del personal
PATCH /api/v1/staff/{staffId} — Actualizar un miembro del personal
DELETE /api/v1/staff/{staffId} — Eliminar un miembro del personal
GET /api/v1/subrents/{subrentId} — Obtener un subalquiler
PATCH /api/v1/subrents/{subrentId} — Actualizar un subalquiler
GET /api/v1/purchase-orders/{purchaseOrderId} — Obtener una orden de compra
PATCH /api/v1/purchase-orders/{purchaseOrderId} — Actualizar una orden de compra
GET /api/v1/contracts/{contractId} — Obtener un contrato
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
GET /api/v1/kits/{kitId} — Obtener 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
GET /api/v1/services/{serviceId} — Obtener un servicio
PATCH /api/v1/services/{serviceId} — Actualizar un servicio
POST /api/v1/internal-services — Crear un servicio interno
GET /api/v1/internal-services/{internalServiceId} — Obtener 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
GET /api/v1/incidents/{incidentId} — Obtener 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
GET /api/v1/tasks/{taskId} — Obtener 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
GET /api/v1/crm/opportunities/{opportunityId} — Obtener 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
GET /api/v1/crm/pipelines/{pipelineId} — Obtener un embudo
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
GET /api/v1/supplier-invoices/{supplierInvoiceId} — Obtener una factura de proveedor
GET /api/v1/treasury/accounts/{accountId} — Obtener una cuenta de tesorería
POST /api/v1/treasury/payments — Registrar un pago entrante o saliente
GET /api/v1/treasury/payments/{paymentId} — Obtener un pago
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
GET /api/v1/credit-notes/{creditNoteId} — Obtener una nota de crédito
GET /api/v1/proformas/{proformaId} — Obtener una proforma
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