Actividades Económicas

GET /api/v1/actividades-economicas — árbol de códigos CIIU para asociar a un contribuyente.

GET /api/v1/actividades-economicas

Devuelve el árbol completo de actividades económicas (códigos CIIU adaptados a Paraguay). Usado durante la configuración del contribuyente para seleccionar las actividades declaradas ante SIFEN.

Autenticación

Authorization: Bearer {jwt} — JWT de Keycloak. Endpoint protegido.

Respuesta exitosa

Status: 200 OK

Devuelve un List<ActividadEconomicaDTO> con la jerarquía completa (1.051 registros). El árbol tiene 4 niveles: sector → división → grupo → clase.

[
  {
    "codigo": "G",
    "descripcion": "Comercio al por mayor y al por menor",
    "nivel": 1,
    "padreCodigo": null,
    "sector": "G",
    "esHoja": false,
    "hijos": [
      {
        "codigo": "47",
        "descripcion": "Comercio al por menor",
        "nivel": 2,
        "padreCodigo": "G",
        "sector": "G",
        "esHoja": false,
        "hijos": [
          {
            "codigo": "471",
            "descripcion": "Venta al por menor en almacenes no especializados",
            "nivel": 3,
            "padreCodigo": "47",
            "sector": "G",
            "esHoja": false,
            "hijos": [
              {
                "codigo": "47110",
                "descripcion": "Venta al por menor en almacenes no especializados con predominio de la venta de alimentos, bebidas o tabaco",
                "nivel": 4,
                "padreCodigo": "471",
                "sector": "G",
                "esHoja": true,
                "hijos": []
              }
            ]
          }
        ]
      }
    ]
  }
]

Campos del ActividadEconomicaDTO

Campo	Tipo	Descripción
`codigo`	`string`	Código CIIU (1 a 5 caracteres según el nivel)
`descripcion`	`string`	Descripción oficial
`nivel`	`integer`	Nivel jerárquico (1 a 4)
`padreCodigo`	`string\|null`	Código del nodo padre
`sector`	`string`	Letra del sector raíz (`A`-`U`)
`esHoja`	`boolean`	`true` si es nodo terminal seleccionable
`hijos`	`array`	Subnodos del árbol

Solo las hojas son seleccionables

Solo los registros con esHoja: true pueden asignarse a un contribuyente. Los nodos intermedios (sectores, divisiones, grupos) sirven para navegar el árbol pero no son válidos como actividad declarada.

Filtrar las hojas con jq:

curl https://api.sifende.com.py/api/v1/actividades-economicas \
  -H "Authorization: Bearer $JWT" \
  | jq '[.. | objects | select(.esHoja == true)]'

Errores

Status	Tipo	Descripción
401	—	JWT inválido, expirado o ausente

Ejemplo

curl https://api.sifende.com.py/api/v1/actividades-economicas \
  -H "Authorization: Bearer $JWT"