Subproyectos

Cuando un proyecto es muy grande — por ejemplo, una obra que incluye cimentación, estructura y acabados, o un proyecto con varias fases — llevarlo como un solo bloque puede volverse confuso. En esos casos conviene dividirlo en subproyectos, de modo que cada fase tenga su propio control de gastos e ingresos sin perder la visión del proyecto completo. El siguiente video le muestra cómo crearlos y aprovecharlos al máximo.

Este video muestra como poder utilizarlos y aprovecharlos al máximo:

Ya conoce cómo dividir sus proyectos en subproyectos. Al organizar cada fase por separado, podrá seguir el avance de cada una en su propio balance y tomar decisiones con mucha más claridad sobre dónde están sus recursos.

API (llamadas desde sistemas externos)

Los subproyectos se manejan como categorias de etiquetas (grupos de proyectos), que pueden tener una categoria padre (parent_tag_category_id) para armar la jerarquia de subproyectos.

Consultar listado de grupos de proyectos (subproyectos)

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/tags/tag_categories.json

Esto devolverá un JSON similar a este:

[
  {
    "id": 1,
    "zid": 1,
    "parent_tag_category_id": null,
    "name": "Proyecto Torre Norte",
    "description": "Proyecto principal",
    "updater_id": 1,
    "entity_id": 1,
    "pdf": null,
    "image": null,
    "created_at": "2026-08-01 10:00:00.000000",
    "updated_at": "2026-08-01 10:00:00.000000",
    "active": true
  },
  {
    "id": 2,
    "zid": 2,
    "parent_tag_category_id": 1,
    "name": "Subproyecto Cimentacion",
    "description": "Fase de cimentacion",
    "updater_id": 1,
    "entity_id": 1,
    "pdf": null,
    "image": null,
    "created_at": "2026-08-01 10:00:00.000000",
    "updated_at": "2026-08-01 10:00:00.000000",
    "active": true
  }
]

Obtener detalle de un grupo de proyectos

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/tags/tag_categories/1.json

Esto devolverá un JSON similar a este:

{
  "id": 1,
  "zid": 1,
  "parent_tag_category_id": null,
  "name": "Proyecto Torre Norte",
  "description": "Proyecto principal",
  "updater_id": 1,
  "entity_id": 1,
  "pdf": null,
  "image": null,
  "created_at": "2026-08-01 10:00:00.000000",
  "updated_at": "2026-08-01 10:00:00.000000",
  "active": true
}

Crear un grupo de proyectos (subproyecto)

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "tag_category": {
      "name": "Subproyecto Cimentacion",
      "description": "Fase de cimentacion",
      "parent_tag_category_id": 1,
      "active": true
    }
  }' \
  https://app.zauru.com/settings/tags/tag_categories.json

Esto devolverá un JSON similar a este:

{
  "id": 2,
  "zid": 2,
  "parent_tag_category_id": 1,
  "name": "Subproyecto Cimentacion",
  "description": "Fase de cimentacion",
  "updater_id": 1,
  "entity_id": 1,
  "pdf": null,
  "image": null,
  "created_at": "2026-08-01 10:00:00.000000",
  "updated_at": "2026-08-01 10:00:00.000000",
  "active": true
}

Actualizar un grupo de proyectos

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PUT \
  -d '{
    "tag_category": {
      "name": "Subproyecto Cimentacion Actualizado"
    }
  }' \
  https://app.zauru.com/settings/tags/tag_categories/2.json

En caso de exito, retorna un codigo HTTP 204 No Content (sin cuerpo).

Borrar un grupo de proyectos

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/settings/tags/tag_categories/2.json

En caso de exito, retorna un codigo HTTP 204 No Content (sin cuerpo).