Campos personalizados

Listar definiciones de campos personalizados

Devuelve las DEFINICIONES de los campos personalizados de la cuenta: qué identificador tiene cada uno, qué tipo admite y, si es un desplegable, qué valores acepta.

Herramienta

filmo_custom_fields_list

Lecturacustom-fields:read

custom-fields:read
120/min
Puede requerir un add-on
Anotación del servidor: Solo lectura
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_custom_fields_list",
    "arguments": {}
  }
}

{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "name": "Example",
        "dataType": "text",
        "description": "<description>",
        "options": [
          "<options>"
        ],
        "applyAt": [
          "order"
        ],
        "showOn": [
          "quote"
        ],
        "isActive": true,
        "createdAt": "2026-09-01T08:00:00Z",
        "updatedAt": "2026-09-01T08:00:00Z"
      }
    ],
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

Te permite identificar un campo personalizado y los valores que acepta. La v1 solo lee campos personalizados: ningún cuerpo de creación o actualización los admite, así que se establecen en la aplicación de Filmo. No devuelve el valor asignado a ninguna entidad: los valores viajan dentro de cada recurso.

Argumentos

applyAtstring

Filtra por la entidad a la que se aplica el campo: devuelve solo las definiciones utilizables en ese tipo de recurso.

Opciones disponibles: order, item, space, contact, project, kit, orderTemplate, repairTicket, serializedItem, vehicle, staff, service, purchaseOrder, incident, opportunity, document, all

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data

idstring

Identificador único de la definición. Es el que se usa al escribir un valor.

namestring

Nombre visible del campo.

dataTypestring

Tipo de dato que acepta el campo.

Opciones disponibles: text, multitext, dropdown, checkbox, radio, date, contact, item, space, staff_member, vehicle

descriptionstring | null

Descripción del campo; null si no tiene.

optionsstring[]

Valores permitidos cuando el campo es un desplegable. Vacío para los demás tipos.

applyAtstring[]

Entidades en las que se puede usar el campo.

showOnstring[]

Documentos en los que se imprime el campo.

Opciones disponibles: quote, proforma, invoice, contract, packing_slip, purchase_order, repair_ticket, all

isActiveboolean

true si la definición está activa y se puede usar.

createdAtstring<date-time> | null

Fecha de creación en ISO 8601 UTC; null si no consta.

updatedAtstring<date-time> | null

Fecha de la última modificación en ISO 8601 UTC; null si no está registrada.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta GET /api/v1/custom-fields.

Campos personalizados
Listar definiciones de campos personalizados
Devuelve las DEFINICIONES de los campos personalizados de la cuenta: qué identificador tiene cada uno, qué tipo admite y, si es un desplegable, qué valores acepta.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

La misma operación por REST

Páginas relacionadas

Listar definiciones de campos personalizados

Escrituras seguras

Errores