---
title: "Obtener actividades económicas"
method: POST
path: "/tools/incomeResources_getEconomicActivities"
tags: ["Income Catalogs"]
---

# Obtener actividades económicas

`POST /tools/incomeResources_getEconomicActivities`

## Request

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

Herramienta MCP: `incomeResources_getEconomicActivities`.

Obtiene el catálogo de actividades económicas del país de la cuenta actual. `value` es la etiqueta en lenguaje natural que se muestra al usuario; `id`/`key`/`code` es el valor de máquina que se envía de vuelta al documento que se está construyendo (por ejemplo `paymentMethod`, `saleCondition`). Nunca muestres al usuario el `id`/`key`/`code` crudo.

Es la herramienta predeterminada para consultar actividades económicas en cualquier país: resuelve el catálogo según el país de la empresa. Usa `invoice_getEconomicActivities` solo para el catálogo oficial de Costa Rica (en facturación electrónica 4.4, usa `subclassCode` como `invoice.economicActivity`, no el código heredado, que provoca el error de API 3132).

Con `catalog_version` filtras por una versión concreta del catálogo, cuando el país tiene más de una. `uniques` está documentado para deduplicar por `subclassCode`, pero se verificó que no tiene efecto en el servidor — no confíes en él: si el resultado trae valores de `subclassCode` duplicados (por ejemplo `costaRica` con `catalog_version` 4.4), deduplica tú mismo en el cliente por `subclassCode`.

Solo lectura.

## Request body

- object
  - `catalog_version` string: Filtra por una versión concreta del catálogo, cuando el país tiene más de una.
  - `uniques` boolean: Documentado para deduplicar por `subclassCode`, pero sin efecto real en el servidor — no confíes en él. Si hay `subclassCode` duplicados (por ejemplo Costa Rica con `catalog_version` 4.4), deduplica en el cliente por `subclassCode`.

## Response `200`

Catálogo de actividades económicas del país de la cuenta

## Other responses

- `401`: No autorizado

---

[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)