ALalegra
Config

Consultar claves de producto

Herramienta MCP: config_getProductKeys.

Devuelve los códigos de claves de producto disponibles para clasificar ítems, con filtros opcionales de búsqueda y cantidad de resultados.

Ejemplo de llamada JSON-RPC:

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

Los filtros de búsqueda name, name_contains y key son mutuamente excluyentes: usa solo uno por llamada. Usa name_contains para búsquedas amplias y key para la consulta exacta de un código. Con limit limitas la cantidad máxima de resultados (por defecto 50).

Notas por país:

  • Colombia, México, Argentina, Panamá, Perú, España, Venezuela y República Dominicana: solo los parámetros compartidos.
  • Costa Rica: deprecated, includeDueDate, productType (valores: product, service, kit, surtido) y tax.

Úsala para descubrir el código de clasificación correcto antes de crear o actualizar un ítem con las herramientas de ítems.

Solo lectura.

post/tools/config_getProductKeys

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/config_getProductKeys
  • Auth
    HTTP bearer

Request body

namestring

Coincidencia exacta del nombre de la clave de producto. Mutuamente excluyente con name_contains y key.

name_containsstring

Búsqueda por nombre de la clave de producto (sin distinguir mayúsculas ni acentos). Mutuamente excluyente con name y key.

keystring

Coincidencia exacta del código de la clave de producto. Mutuamente excluyente con name y name_contains.

limitinteger

Cantidad máxima de resultados a devolver. Por defecto 50.

deprecated'true' | 'false'

Filtra por estado de obsolescencia de la clave. Solo Costa Rica.

includeDueDate'true' | 'false'

Si es true, incluye las claves de producto vencidas. Por defecto false. Solo Costa Rica.

productType'product' | 'service' | 'kit' | 'surtido'

Filtra por tipo de producto: product, service, kit o surtido. Solo Costa Rica.

taxstring

Filtra por porcentaje de impuesto (por ejemplo 0, 1 o 4). Solo Costa Rica.

Response

Lista de claves de producto disponibles

Changes

No recorded changes to this operation across all 1 revision of this API.