Proyectos y obras

El económico de cada obra: ventas, costes, margen y horas imputadas.

4 endpoints GET · 4 Solo lectura

Para quien trabaja por obra o por proyecto, el área que responde a ¿esta obra gana dinero?. Reproduce exactamente la aritmética del cuadro de mandos interno de proyectos.

Las ventas son las líneas de albarán más las de factura directa (proviene_albaranes = 0, para no contar dos veces el albarán ya facturado); los costes son las compras imputadas más el coste de personal —horas fichadas valoradas al coste/hora del contrato vigente— y el de maquinaria. De ahí salen resultado y margen. consultarProyectos da la tabla completa, obtenerProyecto la ficha con su resumen de tareas, consultarTareas el detalle de las tareas y consultarTiemposProyecto el de horas por proyecto y persona.

Flujo típico

Un recorrido habitual por esta área, de principio a fin.

/api/v1/projects Ves el margen de cada obra
/api/v1/projects/{id} Entras en la que se desvía
/api/v1/project-times Miras dónde se van las horas

Endpoints del área 4

GET /api/v1/projects

Proyectos y su económico

Cada obra con sus ventas, sus costes, su resultado y su margen, con el mismo criterio que el panel interno.

GET /api/v1/projects/{id}

Obtener proyecto

La ficha de una obra: cabecera, económico agregado y resumen de tareas.

GET /api/v1/project-times

Horas imputadas a proyectos

Las horas fichadas contra proyectos entre dos fechas, agregadas por proyecto y por persona, con su coste.

GET /api/v1/tasks

Tareas de proyecto

Las tareas de obra con su proyecto, su estado, su responsable y su progreso.

Antes de empezar

Todos estos endpoints comparten el mismo formato de llamada, autenticación por API key y envelope de respuesta: los tienes en Primeros pasos.