Documentación
Ir a AlegraForoNovedadesContactoX/Twitter

Listar unidades de medida

post
https://mcp.alegra.com/tools/config_getUnits

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
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.

string

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

string

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

string

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

string

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

string
enum
Defaults to es

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

Allowed:
integer

Cantidad máxima de resultados a devolver.

string
enum

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

Allowed:
string

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

string
enum

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

Allowed:
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.

string
enum

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

Allowed:
string
enum

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

Allowed:
Responses

401

No autorizado (token de Alegra inválido o expirado).

Updated about 22 hours ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 22 hours ago