Errores

`contact_in_use`

HTTP HTTP 409.

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

{
  "type": "https://docs.filmo.io/errors/contact_in_use",
  "title": "Contact in use",
  "status": 409,
  "code": "contact_in_use",
  "detail": "The contact is used by orders, projects, documents or payments and cannot be deleted: archive it instead (status: archived). The count per type is in errors",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "errors": [
    {
      "path": "orders",
      "code": "in_use",
      "message": "Used by 3 records of this type",
      "count": 3
    },
    {
      "path": "quotes",
      "code": "in_use",
      "message": "Used by 1 record of this type",
      "count": 1
    }
  ]
}

Cuándo ocurre

409. DELETE /api/v1/contacts/{contactId} rechazado porque algo todavía usa el contacto (pedidos, proyectos, presupuestos, facturas y otros documentos). No se elimina nada. errors tiene una entrada por cada tipo de registro que lo usa: path nombra el tipo y count indica cuántos hay.

Qué hacer

Lee errors[] y mueve o quita antes esos registros. Si solo quieres que el contacto deje de verse, archívalo actualizándolo con status: archived; la eliminación no se puede deshacer.

Reintento

Corregir y reenviar409 contact_in_use · address_in_use · insufficient_stock
No reintentes. errors[] dice qué bloquea la operación: corrígelo primero.

Campos de errors[]

errors[].pathstring

Ruta del campo erróneo en notación de puntos y corchetes (lines[0].itemId); vacía si afecta a todo el cuerpo. En contact_in_use, address_in_use e insufficient_stock es uno de un conjunto cerrado, listado por código en x-path-values: el tipo de registro que usa el contacto o la dirección, o la clase de recurso que escasea (items o spaces).

Opciones disponibles: orders, projects, quotes, invoices, proformas, creditNotes, simpleCreditNotes, salesReceipts, supplierInvoices, contracts, subrents, purchaseOrders, sepaMandates, receipts, consignments

errors[].countinteger

En contact_in_use y address_in_use: cuántos registros del tipo indicado por path lo usan.

Lo devuelven

1 operaciones

DELETE /api/v1/contacts/{contactId} — Eliminar un contacto

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