Resumen de la entidad
Proyecto
Usa los proyectos de Flowtly como referencia única para PMO y finanzas.
Endpoints
/api/projects
Listar proyectos
Recupera proyectos filtrando por cliente, estado o tipo contractual.
/api/projects
Crear proyecto
Da de alta un proyecto con tipo de facturación, cliente y fechas.
/api/projects/{id}
Obtener proyecto por ID
Consulta miembros, divisa y campos clave de un proyecto.
/api/projects/{id}
Actualizar proyecto
Actualiza metadatos, fechas o tipo de facturación de un proyecto.
/api/projects/preview
Preview projects
Preview project data before creation.
/api/projects/search
Search projects
Search projects by filters.
/api/projects/{id}/profitability
Get project profitability
Inspect profitability metrics for a project.
Casos de uso
Campos del esquema
Project-project.read| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador interno del proyecto. |
client |
string | null | IRI del cliente asociado. |
currency |
string | null | Moneda utilizada para el proyecto. |
dateFrom |
string | null | Fecha prevista de inicio. |
dateTo |
string | null | Fecha prevista de finalización. |
name |
string | Nombre del proyecto. |
publicDescription |
string | null | Descripción visible para el cliente. |
type |
string | Modelo de facturación (precio fijo, T&M, etc.). |
clientHash |
string | Identificador del cliente hasheado que usa Flowtly. |
notes |
string | null | Notas internas. |
color |
string | Color que se muestra en la interfaz. |
priceNet |
string | null | Precio neto del proyecto (si existe). |
taxGroup |
string | null | IRI del grupo fiscal aplicado. |
projectMembers |
array | Lista de miembros (IRIs) asignados. |
status |
string | Estado de ciclo de vida del proyecto. |
flattenType |
string | Tipo normalizado de proyecto en Flowtly. |
Ejemplos
/api/projects
Crear el proyecto Aurora Rollout
Añade un proyecto T&M vinculado a un cliente del CRM con fechas planificadas.
{
"name": "Aurora Rollout",
"type": "time-and-material",
"currency": "/api/currencies/EUR",
"client": "/api/clients/cl_901",
"dateFrom": "2024-06-01T00:00:00+00:00",
"dateTo": "2024-12-31T00:00:00+00:00",
"notes": "Expansion to Germany and France"
}{
"@id": "/api/projects/prj_aurora",
"@type": "Project",
"id": 9821,
"name": "Aurora Rollout",
"type": "time-and-material",
"currency": "/api/currencies/EUR",
"client": "/api/clients/cl_901",
"dateFrom": "2024-06-01T00:00:00+00:00",
"dateTo": "2024-12-31T00:00:00+00:00",
"status": "active"
}