ALalegra
Config

Listar unidades de medida

Herramienta MCP: config_getUnits.

Devuelve las unidades de medida disponibles en Alegra para asignar a ítems, con filtros opcionales de búsqueda, idioma y cantidad de resultados.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "config_getUnits",
    "arguments": { "query": "kilo", "limit": 20 }
  }
}

Los filtros de búsqueda query, key, key_contains, value y value_contains son mutuamente excluyentes: usa solo uno por llamada. Si el usuario da un término de búsqueda, prefiere query para una búsqueda amplia. Con lang eliges el idioma de los nombres de las unidades (es o en, es por defecto) y con limit la cantidad máxima de resultados.

Notas por país:

  • Argentina, Panamá, Perú, España y Venezuela: solo los parámetros compartidos.
  • Colombia: deprecated (por defecto false), electronic_invoicing_version (versión soportada: 2.1), only_electronic_invoicing y unit_type (valores: Unidad, Longitud, Area, Peso, Servicio, AIU).
  • Costa Rica: los mismos cuatro parámetros que Colombia, con versión soportada 4.3 y estos valores de unit_type: Longitud, Area, Peso, Servicio.
  • México: most_used, para devolver solo las 30 unidades más usadas.
  • República Dominicana: item_type, para filtrar por tipo de ítem (product, service o all).

Úsala para descubrir las claves de unidad válidas antes de crear o actualizar un ítem con las herramientas de ítems.

Solo lectura.

post/tools/config_getUnits

Request

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

Request body

querystring

Texto de búsqueda que coincide con la clave y el valor de la unidad (sin distinguir mayúsculas ni acentos). Mutuamente excluyente con key, key_contains, value y value_contains.

keystring

Coincidencia exacta de la clave de la unidad (sin distinguir mayúsculas). Mutuamente excluyente con query, key_contains, value y value_contains.

key_containsstring

Coincidencia parcial en la clave de la unidad. Mutuamente excluyente con query, key, value y value_contains.

valuestring

Coincidencia exacta del valor o nombre de la unidad (sin distinguir mayúsculas). Mutuamente excluyente con query, key, key_contains y value_contains.

value_containsstring

Coincidencia parcial en el valor de la unidad. Mutuamente excluyente con query, key, key_contains y value.

lang'es' | 'en'

Idioma de los nombres de las unidades: es o en. Por defecto es.

limitinteger

Cantidad máxima de resultados a devolver.

deprecated'true' | 'false'

Filtra unidades obsoletas. Por defecto false (Colombia); en Costa Rica solo enviarlo si se necesitan unidades obsoletas. Solo Colombia y Costa Rica.

electronic_invoicing_versionstring

Filtra por versión de factura electrónica. Colombia soporta 2.1 y Costa Rica 4.3. Solo Colombia y Costa Rica.

only_electronic_invoicing'true' | 'false'

Si es true, devuelve solo unidades con atributo de factura electrónica; si es false, solo unidades sin él. Solo Colombia y Costa Rica.

unit_typestring

Filtra por categoría de unidad. Valores en Colombia: Unidad, Longitud, Area, Peso, Servicio, AIU. Valores en Costa Rica: Longitud, Area, Peso, Servicio. Solo Colombia y Costa Rica.

most_used'true' | 'false'

Si es true, devuelve solo las 30 unidades más frecuentemente usadas en México. Solo México.

item_type'product' | 'service' | 'all'

Filtra por tipo de ítem: product, service o all. Solo República Dominicana.

Response

Lista de unidades de medida disponibles

Changes

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