---
title: "Projects (Robaws)"
description: "Projects"
language: es
source_language: en
translation_state: pending
canonical: https://documentation.invantive.eu/es/datamodels/robaws/Robaws.Projects.Projects
original: https://documentation.invantive.eu/en/datamodels/robaws/Robaws.Projects.Projects
updated: 2026-11-18T01:12:20Z
license: https://documentation.invantive.eu/es/
---

# Projects: Robaws Projects

`insert` `update` `delete` `REST`

- Catálogo: `Robaws`
- Esquema: `Projects`
- Llaves Primarias: `id`
- Label: Projects

Buscar

Permite recuperar y modificar datos utilizando `insert`, `update` y `delete`.

## Fuente de la API

- Punto final: `/api/v2/projects`
- Operación: `get /api/v2/projects`

## Características de rendimiento

| Characteristic | Value |
|---|---:|
| Latencia media de acceso (ms) | 96 |
| Número de filas escaneadas por minuto | 21,800 |
| Número de filas de queries puntuales por minuto | 988 |
| Escribir filas por minuto | 539 |

El resultado se puede almacenar en la Caché del cliente.

## Parámetros

| Name | Tipo de Datos | Required | Default | Documentation |
|---|---|:---:|---|---|
| `clientId` | `` | [ ] |  |  |
| `logicId` | `` | [ ] |  |  |
| `purchaseInvoiceId` | `` | [ ] |  |  |
| `salesInvoiceId` | `` | [ ] |  |  |
| `searchText` | `` | [ ] |  |  |
| `sort` | `` | [ ] |  |  |
| `subscriptionId` | `` | [ ] |  |  |
| `supplierId` | `` | [ ] |  |  |
| `supplyOrderId` | `` | [ ] |  |  |
| `updatedFrom` | `` | [ ] |  |  |
| `withArchived` | `` | [ ] |  |  |

## Columnas de la Tabla

A continuación se muestran las columnas de la tabla `Projects`. Cada columna tiene un tipo de datos SQL. Se debe proporcionar un nuevo valor no nulo para cada columna requerida en todo momento durante la inserción y la actualización.

| Name | Tipo de Datos | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `archivedAt` | `datetime` | Archivado en | [ ] | filtros en la plataforma, modificables, `archivedAt` |  |
| `checkInAtWork` | `varchar2` | Registro de entrada al trabajo | [ ] | filtros en la plataforma, modificables, `checkInAtWork` |  |
| `clientContactId` | `varchar2` | Client ID | [ ] | filtros en la plataforma, modificables, `clientContactId` |  |
| `clientId` | `varchar2` | ID de Cliente | [ ] | filtros en la plataforma, modificables, `clientId` |  |
| `clientReference` | `varchar2` | Referencia del Cliente | [ ] | filtros en la plataforma, modificables, `clientReference` |  |
| `companyId` | `varchar2` | ID de la Empresa | [ ] | filtros en la plataforma, modificables, `companyId` |  |
| `createdAt` | `datetime` | Creado en | [ ] | filtros en la plataforma, modificables, `createdAt` |  |
| `date` | `datetime` | Date | [ ] | filtros en la plataforma, modificables, `date` |  |
| `deletedAt` | `datetime` | Eliminado el | [ ] | filtros en la plataforma, modificables, `deletedAt` |  |
| `distance` | `int32` | Distance | [ ] | filtros en la plataforma, modificables, `distance` |  |
| `endClientContactId` | `varchar2` | ID de contacto del cliente final | [ ] | filtros en la plataforma, modificables, `endClientContactId` |  |
| `endClientId` | `varchar2` | Client ID | [ ] | filtros en la plataforma, modificables, `endClientId` |  |
| `executorId` | `varchar2` | ID del ejecutor | [ ] | filtros en la plataforma, modificables, `executorId` |  |
| `extraFields` | `varchar2` | Campos adicionales | [ ] | writable | The JSON text of the nested object. |
| `geofence` | `varchar2` | Geofence | [ ] | filtros en la plataforma, modificables, `geofence` |  |
| `id` | `varchar2` | ID | [ ] | filtros en la plataforma, modificables, `id` |  |
| `lockedAt` | `datetime` | Bloqueado en | [ ] | filtros en la plataforma, modificables, `lockedAt` |  |
| `logicId` | `varchar2` | Identificador lógico | [ ] | filtros en la plataforma, modificables, `logicId` |  |
| `marginArticleCost` | `double` | Margen sobre el coste del artículo | [ ] | filtros en la plataforma, modificables, `marginArticleCost` |  |
| `marginMaterialCost` | `double` | Margen del coste de los materiales | [ ] | filtros en la plataforma, modificables, `marginMaterialCost` |  |
| `marginSubcontractorCost` | `double` | Margen del coste del subcontratista | [ ] | filtros en la plataforma, modificables, `marginSubcontractorCost` |  |
| `marginWorkCost` | `double` | Coste de mano de obra del margen | [ ] | filtros en la plataforma, modificables, `marginWorkCost` |  |
| `nssoDeclarationOfWorks` | `varchar2` | Declaración de obras de la NSSO | [ ] | filtros en la plataforma, modificables, `nssoDeclarationOfWorks` |  |
| `planningGroup` | `varchar2` | Grupo de Planificación | [ ] | filtros en la plataforma, modificables, `planningGroup` |  |
| `planningName` | `varchar2` | Nombre del proyecto | [ ] | filtros en la plataforma, modificables, `planningName` |  |
| `priceGroupId` | `varchar2` | ID del grupo de precios | [ ] | filtros en la plataforma, modificables, `priceGroupId` |  |
| `renderedWorkOrderInfo` | `varchar2` | Información sobre la orden de trabajo generada | [ ] | filtros en la plataforma, modificables, `renderedWorkOrderInfo` | When reading, only present if requested via 'include' query parameter, otherwise null. |
| `siteAddress_addressLine1` | `varchar2` | Dirección del sitio, línea 1 | [ ] | filtros en la plataforma, modificables, `siteAddress.addressLine1` |  |
| `siteAddress_addressLine2` | `varchar2` | Dirección del sitio, línea 2 | [ ] | filtros en la plataforma, modificables, `siteAddress.addressLine2` |  |
| `siteAddress_city` | `varchar2` | Dirección del sitio, Ciudad | [ ] | filtros en la plataforma, modificables, `siteAddress.city` |  |
| `siteAddress_country` | `varchar2` | Dirección del sitio web País | [ ] | filtros en la plataforma, modificables, `siteAddress.country` |  |
| `siteAddress_latitude` | `double` | Latitud de la dirección del emplazamiento | [ ] | filtros en la plataforma, modificables, `siteAddress.latitude` |  |
| `siteAddress_longitude` | `double` | Longitud de la dirección del emplazamiento | [ ] | filtros en la plataforma, modificables, `siteAddress.longitude` |  |
| `siteAddress_postalCode` | `varchar2` | Dirección del sitio Código postal | [ ] | filtros en la plataforma, modificables, `siteAddress.postalCode` |  |
| `siteManagerId` | `varchar2` | ID del responsable de la obra | [ ] | filtros en la plataforma, modificables, `siteManagerId` |  |
| `siteNssoIdNumber` | `varchar2` | Número de identificación NSSO del centro | [ ] | filtros en la plataforma, modificables, `siteNssoIdNumber` |  |
| `statistics_claimStateGrandTotal` | `decimal` | Estadísticas: Total general del Estado | [ ] | filtros en la plataforma, modificables, `statistics.claimStateGrandTotal` |  |
| `statistics_internalSupplyOrderTotalCostPrice` | `decimal` | Estadísticas: Suministro interno, Pedido, Coste total, Precio | [ ] | filtros en la plataforma, modificables, `statistics.internalSupplyOrderTotalCostPrice` |  |
| `statistics_offerGrandTotal` | `decimal` | Las estadísticas ofrecen el total general | [ ] | filtros en la plataforma, modificables, `statistics.offerGrandTotal` |  |
| `statistics_offerTotalCostPrice` | `decimal` | Las estadísticas indican el precio de coste total | [ ] | filtros en la plataforma, modificables, `statistics.offerTotalCostPrice` |  |
| `statistics_offerTotalIndirectCosts` | `decimal` | Las estadísticas muestran los costes indirectos totales | [ ] | filtros en la plataforma, modificables, `statistics.offerTotalIndirectCosts` |  |
| `statistics_purchaseInvoiceGrandTotal` | `decimal` | Estadísticas de la factura de compra: total general | [ ] | filtros en la plataforma, modificables, `statistics.purchaseInvoiceGrandTotal` |  |
| `statistics_realisedIndirectCosts` | `decimal` | Estadísticas sobre los costes indirectos incurridos | [ ] | filtros en la plataforma, modificables, `statistics.realisedIndirectCosts` |  |
| `statistics_salesInvoiceGrandTotal` | `decimal` | Estadísticas: Total general de las facturas de ventas | [ ] | filtros en la plataforma, modificables, `statistics.salesInvoiceGrandTotal` |  |
| `statistics_settlementGrandTotal` | `decimal` | Estadísticas: Total general de la liquidación | [ ] | filtros en la plataforma, modificables, `statistics.settlementGrandTotal` |  |
| `statistics_settlementTotalCostPrice` | `decimal` | Estadísticas Liquidación Coste total Precio | [ ] | filtros en la plataforma, modificables, `statistics.settlementTotalCostPrice` |  |
| `statistics_settlementTotalIndirectCosts` | `decimal` | Estadísticas: Liquidación de los costes indirectos totales | [ ] | filtros en la plataforma, modificables, `statistics.settlementTotalIndirectCosts` |  |
| `statistics_totalBudgetedCosts` | `decimal` | Estadísticas: Costes totales presupuestados | [ ] | filtros en la plataforma, modificables, `statistics.totalBudgetedCosts` |  |
| `statistics_totalBudgetedHours` | `decimal` | Estadísticas: Total de horas presupuestadas | [ ] | filtros en la plataforma, modificables, `statistics.totalBudgetedHours` |  |
| `statistics_totalBudgetedIncome` | `decimal` | Estadísticas: Ingresos totales presupuestados | [ ] | filtros en la plataforma, modificables, `statistics.totalBudgetedIncome` |  |
| `statistics_totalForecastedCosts` | `decimal` | Estadísticas: Costes totales previstos | [ ] | filtros en la plataforma, modificables, `statistics.totalForecastedCosts` |  |
| `statistics_totalForecastedIncome` | `decimal` | Estadísticas: ingresos totales previstos | [ ] | filtros en la plataforma, modificables, `statistics.totalForecastedIncome` |  |
| `statistics_totalForecastedIndirectCosts` | `decimal` | Estadísticas: Total de costes indirectos previstos | [ ] | filtros en la plataforma, modificables, `statistics.totalForecastedIndirectCosts` |  |
| `statistics_totalRealisedCosts` | `decimal` | Estadísticas: costes totales incurridos | [ ] | filtros en la plataforma, modificables, `statistics.totalRealisedCosts` |  |
| `statistics_totalRealisedIncome` | `decimal` | Estadísticas: ingresos totales obtenidos | [ ] | filtros en la plataforma, modificables, `statistics.totalRealisedIncome` |  |
| `statistics_workOrderTotalCostPrice` | `decimal` | Estadísticas: Orden de trabajo, coste total, precio | [ ] | filtros en la plataforma, modificables, `statistics.workOrderTotalCostPrice` |  |
| `statistics_workOrderTotalHours` | `decimal` | Estadísticas: horas totales de las órdenes de trabajo | [ ] | filtros en la plataforma, modificables, `statistics.workOrderTotalHours` |  |
| `status` | `varchar2` | Status | [ ] | filtros en la plataforma, modificables, `status` |  |
| `statusDetails_color` | `varchar2` | Color de los detalles del estado | [ ] | filtros en la plataforma, modificables, `statusDetails.color` |  |
| `statusDetails_name` | `varchar2` | Estado Detalles Nombre | [ ] | filtros en la plataforma, modificables, `statusDetails.name` |  |
| `updatedAt` | `datetime` | Actualizado en | [ ] | filtros en la plataforma, modificables, `updatedAt` |  |
| `workOrderInfo` | `varchar2` | Información sobre la orden de trabajo | [ ] | filtros en la plataforma, modificables, `workOrderInfo` | When reading, only present if requested via 'include' query parameter, otherwise null.HTML content.Embedded images are resolved to URLs based on the 'x-robaws-html-image-mode' request header: TEMPORARY_URL (default) returns time-limited presigned URLs that require no authentication; PERMANENT_URL returns stable URLs that require an authenticated session; NONE returns the stored HTML, where each image is an <img> with a data-robaws-id and an empty src — keep that tag and its data-robaws-id when writing the HTML back, or the image is lost.Any other value (e.g.BASE64_INLINE) returns 400 Bad Request.When writing, omit it or send null to keep the current text; send an empty string to clear it. |

## Teclas

| Key | Column | Se refiere a | Kind | Description |
|---|---|---|---|---|
| `Projects_clientContactId_txt` | `clientContactId` | [Contacts](Robaws.Contacts.Contacts)`.id` | Textual | The referenced row, for as long as Robaws still lists it: a deleted or purged row is no longer listed, and a document may keep referring to it. |
| `Projects_clientId_txt` | `clientId` | [Clients](Robaws.Clients.Clients)`.id` | Textual | The referenced row, for as long as Robaws still lists it: a deleted or purged row is no longer listed, and a document may keep referring to it. |
| `Projects_companyId_fk` | `companyId` | [Companies](Robaws.Companies.Companies)`.id` | Key |  |
| `Projects_endClientContactId_fk` | `endClientContactId` | [Contacts](Robaws.Contacts.Contacts)`.id` | Key |  |
| `Projects_endClientId_txt` | `endClientId` | [Clients](Robaws.Clients.Clients)`.id` | Textual | The referenced row, for as long as Robaws still lists it: a deleted or purged row is no longer listed, and a document may keep referring to it. |
| `Projects_siteManagerId_txt` | `siteManagerId` | [Users](Robaws.Users.Users)`.id` | Textual | The referenced row, for as long as Robaws still lists it: a deleted or purged row is no longer listed, and a document may keep referring to it. |

## Referenciado por

- [DeliveryNotes](Robaws.DeliveryNotes.DeliveryNotes) `projectId` (Textual)
- [Installations](Robaws.Installations.Installations) `assignedProjectId` (Textual)
- [Materials](Robaws.Materials.Materials) `assignedProjectId` (Textual)
- [ProjectConstructionPartners](Robaws.ProjectConstructionPartners.ProjectConstructionPartners) `projectId` (Key)
- [SalesInvoiceLineItems](Robaws.SalesInvoiceLineItems.SalesInvoiceLineItems) `projectId` (Textual)
- [SalesOrders](Robaws.SalesOrders.SalesOrders) `projectId` (Textual)
- [Settlements](Robaws.Settlements.Settlements) `projectId` (Textual)
- [StockReservations](Robaws.StockReservations.StockReservations) `projectId` (Textual)
- [SubscriptionLineItems](Robaws.SubscriptionLineItems.SubscriptionLineItems) `projectId` (Key)
- [TimeRegistrations](Robaws.TimeRegistrations.TimeRegistrations) `projectId` (Textual)

## Ejemplos de queries

```sql
select prj.logicId
,      prj.date
,      prj.siteAddress_city site_city
,      cnt.name client_name
from   Robaws.Projects.Projects prj
join   Robaws.Clients.Clients cnt
on     cnt.id = prj.clientId
where  prj.archivedAt is null
```


## Notas de la Versión

Cambios introducidos en cada versión en las tablas, columnas, atributos y capacidades del controlador:

- [ROBAWS](/es/release-notes/drivers?driver=robaws)
