---
title: "Listar unidades de medida"
method: POST
path: "/tools/config_getUnits"
tags: ["Config"]
---

# Listar unidades de medida

`POST /tools/config_getUnits`

## Request

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

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:

```json
{
  "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.

## Request body

- object
  - `query` string: 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.
  - `key` string: Coincidencia exacta de la clave de la unidad (sin distinguir mayúsculas). Mutuamente excluyente con query, key_contains, value y value_contains.
  - `key_contains` string: Coincidencia parcial en la clave de la unidad. Mutuamente excluyente con query, key, value y value_contains.
  - `value` string: Coincidencia exacta del valor o nombre de la unidad (sin distinguir mayúsculas). Mutuamente excluyente con query, key, key_contains y value_contains.
  - `value_contains` string: 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.
  - `limit` integer: 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_version` string: 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_type` string: 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 `200`

Lista de unidades de medida disponibles

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)