---
title: "Projects (Robaws)"
description: "Projects"
language: fr
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/fr/datamodels/robaws/Robaws.Projects.Projects
original: https://documentation.invantive.eu/en/datamodels/robaws/Robaws.Projects.Projects
updated: 2026-11-18T23:43:02Z
license: https://documentation.invantive.eu/fr/
---

# Projets : Projets Robaws

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

- Catalogue : `Robaws`
- Schéma : `Projects`
- Clés primaires : `id`
- Libellé : Projets

Rechercher

Permet de récupérer et de modifier des données à l'aide de `insert`, `update` et `delete`.

## Source de l'API

- Point de terminaison : `/api/v2/projects`
- Opération : `get /api/v2/projects`

## Caractéristiques de performance

| Characteristic | Value |
|---|---:|
| Latence moyenne d'accès (ms) | 96 |
| Nombre de lignes par minute en mode de balayage complet | 21,800 |
| Nombre de lignes de requêtes ponctuelles par minute | 988 |
| Nombre d'enregistrements écrits par minute | 539 |

Le résultat peut être mis en cache côté client.

## Paramètres

| Name | Type de données | Required | Default | Documentation |
|---|---|:---:|---|---|
| `clientId` | `` | [ ] |  |  |
| `logicId` | `` | [ ] |  |  |
| `purchaseInvoiceId` | `` | [ ] |  |  |
| `salesInvoiceId` | `` | [ ] |  |  |
| `searchText` | `` | [ ] |  |  |
| `sort` | `` | [ ] |  |  |
| `subscriptionId` | `` | [ ] |  |  |
| `supplierId` | `` | [ ] |  |  |
| `supplyOrderId` | `` | [ ] |  |  |
| `updatedFrom` | `` | [ ] |  |  |
| `withArchived` | `` | [ ] |  |  |

## Colonnes de table

Les colonnes de la table `Projects` sont présentées ci-dessous. Chaque colonne possède un type de données SQL. Une nouvelle valeur non nulle doit être fournie pour chaque colonne requise à tout moment lors de l'insertion et de la mise à jour.

| Name | Type de données | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `archivedAt` | `datetime` | Archivé à | [ ] | filtres sur la plateforme, modifiables, `archivedAt` |  |
| `checkInAtWork` | `varchar2` | Pointage au travail | [ ] | filtres sur la plateforme, modifiables, `checkInAtWork` |  |
| `clientContactId` | `varchar2` | Identifiant de contact client | [ ] | filtres sur la plateforme, modifiables, `clientContactId` |  |
| `clientId` | `varchar2` | Id du client | [ ] | filtres sur la plateforme, modifiables, `clientId` |  |
| `clientReference` | `varchar2` | Référence client | [ ] | filtres sur la plateforme, modifiables, `clientReference` |  |
| `companyId` | `varchar2` | ID de l'entreprise | [ ] | filtres sur la plateforme, modifiables, `companyId` |  |
| `createdAt` | `datetime` | Créé le | [ ] | filtres sur la plateforme, modifiables, `createdAt` |  |
| `date` | `datetime` | Date | [ ] | filtres sur la plateforme, modifiables, `date` |  |
| `deletedAt` | `datetime` | Supprimé le | [ ] | filtres sur la plateforme, modifiables, `deletedAt` |  |
| `distance` | `int32` | Distance | [ ] | filtres sur la plateforme, modifiables, `distance` |  |
| `endClientContactId` | `varchar2` | Identifiant de contact du client final | [ ] | filtres sur la plateforme, modifiables, `endClientContactId` |  |
| `endClientId` | `varchar2` | Client ID | [ ] | filtres sur la plateforme, modifiables, `endClientId` |  |
| `executorId` | `varchar2` | Identifiant de l'exécuteur testamentaire | [ ] | filtres sur la plateforme, modifiables, `executorId` |  |
| `extraFields` | `varchar2` | Champs supplémentaires | [ ] | writable | Le texte JSON de l'objet imbriqué. |
| `geofence` | `varchar2` | Geofence | [ ] | filtres sur la plateforme, modifiables, `geofence` |  |
| `id` | `varchar2` | ID | [ ] | filtres sur la plateforme, modifiables, `id` |  |
| `lockedAt` | `datetime` | Verrouillé à | [ ] | filtres sur la plateforme, modifiables, `lockedAt` |  |
| `logicId` | `varchar2` | Identifiant logique | [ ] | filtres sur la plateforme, modifiables, `logicId` |  |
| `marginArticleCost` | `double` | Marge sur le coût de l'article | [ ] | filtres sur la plateforme, modifiables, `marginArticleCost` |  |
| `marginMaterialCost` | `double` | Marge sur le coût des matières premières | [ ] | filtres sur la plateforme, modifiables, `marginMaterialCost` |  |
| `marginSubcontractorCost` | `double` | Marge sur les coûts des sous-traitants | [ ] | filtres sur la plateforme, modifiables, `marginSubcontractorCost` |  |
| `marginWorkCost` | `double` | Coût de main-d'œuvre lié à la marge | [ ] | filtres sur la plateforme, modifiables, `marginWorkCost` |  |
| `nssoDeclarationOfWorks` | `varchar2` | Déclaration des travaux de la NSSO | [ ] | filtres sur la plateforme, modifiables, `nssoDeclarationOfWorks` |  |
| `planningGroup` | `varchar2` | Groupe de planification | [ ] | filtres sur la plateforme, modifiables, `planningGroup` |  |
| `planningName` | `varchar2` | Nom du projet | [ ] | filtres sur la plateforme, modifiables, `planningName` |  |
| `priceGroupId` | `varchar2` | Identifiant du groupe de prix | [ ] | filtres sur la plateforme, modifiables, `priceGroupId` |  |
| `renderedWorkOrderInfo` | `varchar2` | Informations sur les ordres de travail traités | [ ] | filtres sur la plateforme, modifiables, `renderedWorkOrderInfo` | Lors de la lecture, présent uniquement si demandé via le paramètre de requête 'include', sinon null. |
| `siteAddress_addressLine1` | `varchar2` | Adresse du site – Ligne 1 | [ ] | filtres sur la plateforme, modifiables, `siteAddress.addressLine1` |  |
| `siteAddress_addressLine2` | `varchar2` | Adresse du site – Ligne 2 | [ ] | filtres sur la plateforme, modifiables, `siteAddress.addressLine2` |  |
| `siteAddress_city` | `varchar2` | Adresse du site Ville | [ ] | filtres sur la plateforme, modifiables, `siteAddress.city` |  |
| `siteAddress_country` | `varchar2` | Adresse du site Pays | [ ] | filtres sur la plateforme, modifiables, `siteAddress.country` |  |
| `siteAddress_latitude` | `double` | Latitude de l'adresse du site | [ ] | filtres sur la plateforme, modifiables, `siteAddress.latitude` |  |
| `siteAddress_longitude` | `double` | Longitude de l'adresse du site | [ ] | filtres sur la plateforme, modifiables, `siteAddress.longitude` |  |
| `siteAddress_postalCode` | `varchar2` | Adresse du site Code postal | [ ] | filtres sur la plateforme, modifiables, `siteAddress.postalCode` |  |
| `siteManagerId` | `varchar2` | Identifiant du responsable de site | [ ] | filtres sur la plateforme, modifiables, `siteManagerId` |  |
| `siteNssoIdNumber` | `varchar2` | Numéro d'identification NSSO du site | [ ] | filtres sur la plateforme, modifiables, `siteNssoIdNumber` |  |
| `statistics_claimStateGrandTotal` | `decimal` | Statistiques - Réclamations par État - Total général | [ ] | filtres sur la plateforme, modifiables, `statistics.claimStateGrandTotal` |  |
| `statistics_internalSupplyOrderTotalCostPrice` | `decimal` | Statistiques Commande d'approvisionnement interne Coût total Prix | [ ] | filtres sur la plateforme, modifiables, `statistics.internalSupplyOrderTotalCostPrice` |  |
| `statistics_offerGrandTotal` | `decimal` | Statistiques : total général | [ ] | filtres sur la plateforme, modifiables, `statistics.offerGrandTotal` |  |
| `statistics_offerTotalCostPrice` | `decimal` | Statistiques sur le prix de revient total | [ ] | filtres sur la plateforme, modifiables, `statistics.offerTotalCostPrice` |  |
| `statistics_offerTotalIndirectCosts` | `decimal` | Statistiques sur le montant total des coûts indirects | [ ] | filtres sur la plateforme, modifiables, `statistics.offerTotalIndirectCosts` |  |
| `statistics_purchaseInvoiceGrandTotal` | `decimal` | Statistiques - Facture d'achat - Total général | [ ] | filtres sur la plateforme, modifiables, `statistics.purchaseInvoiceGrandTotal` |  |
| `statistics_realisedIndirectCosts` | `decimal` | Statistiques sur les coûts indirects effectifs | [ ] | filtres sur la plateforme, modifiables, `statistics.realisedIndirectCosts` |  |
| `statistics_salesInvoiceGrandTotal` | `decimal` | Statistiques : total général des factures de vente | [ ] | filtres sur la plateforme, modifiables, `statistics.salesInvoiceGrandTotal` |  |
| `statistics_settlementGrandTotal` | `decimal` | Statistiques – Règlement – Total général | [ ] | filtres sur la plateforme, modifiables, `statistics.settlementGrandTotal` |  |
| `statistics_settlementTotalCostPrice` | `decimal` | Statistiques Règlement Coût total Prix | [ ] | filtres sur la plateforme, modifiables, `statistics.settlementTotalCostPrice` |  |
| `statistics_settlementTotalIndirectCosts` | `decimal` | Statistiques relatives au règlement – Total des coûts indirects | [ ] | filtres sur la plateforme, modifiables, `statistics.settlementTotalIndirectCosts` |  |
| `statistics_totalBudgetedCosts` | `decimal` | Statistiques : Coûts totaux prévus au budget | [ ] | filtres sur la plateforme, modifiables, `statistics.totalBudgetedCosts` |  |
| `statistics_totalBudgetedHours` | `decimal` | Statistiques : nombre total d'heures prévues au budget | [ ] | filtres sur la plateforme, modifiables, `statistics.totalBudgetedHours` |  |
| `statistics_totalBudgetedIncome` | `decimal` | Statistiques : total des recettes budgétisées | [ ] | filtres sur la plateforme, modifiables, `statistics.totalBudgetedIncome` |  |
| `statistics_totalForecastedCosts` | `decimal` | Statistiques : coûts totaux prévisionnels | [ ] | filtres sur la plateforme, modifiables, `statistics.totalForecastedCosts` |  |
| `statistics_totalForecastedIncome` | `decimal` | Statistiques : revenu total prévu | [ ] | filtres sur la plateforme, modifiables, `statistics.totalForecastedIncome` |  |
| `statistics_totalForecastedIndirectCosts` | `decimal` | Statistiques : total des coûts indirects prévisionnels | [ ] | filtres sur la plateforme, modifiables, `statistics.totalForecastedIndirectCosts` |  |
| `statistics_totalRealisedCosts` | `decimal` | Statistiques : coûts totaux réels | [ ] | filtres sur la plateforme, modifiables, `statistics.totalRealisedCosts` |  |
| `statistics_totalRealisedIncome` | `decimal` | Statistiques : revenu total réalisé | [ ] | filtres sur la plateforme, modifiables, `statistics.totalRealisedIncome` |  |
| `statistics_workOrderTotalCostPrice` | `decimal` | Statistiques : coût total des ordres de travail | [ ] | filtres sur la plateforme, modifiables, `statistics.workOrderTotalCostPrice` |  |
| `statistics_workOrderTotalHours` | `decimal` | Statistiques relatives aux ordres de travail : nombre total d'heures | [ ] | filtres sur la plateforme, modifiables, `statistics.workOrderTotalHours` |  |
| `status` | `varchar2` | Status | [ ] | filtres sur la plateforme, modifiables, `status` |  |
| `statusDetails_color` | `varchar2` | Détails de l'état Couleur | [ ] | filtres sur la plateforme, modifiables, `statusDetails.color` |  |
| `statusDetails_name` | `varchar2` | Détails du statut Nom | [ ] | filtres sur la plateforme, modifiables, `statusDetails.name` |  |
| `updatedAt` | `datetime` | Mise à jour à | [ ] | filtres sur la plateforme, modifiables, `updatedAt` |  |
| `workOrderInfo` | `varchar2` | Informations relatives à l'ordre de travail | [ ] | filtres sur la plateforme, modifiables, `workOrderInfo` | Lors de la lecture, présent uniquement si demandé via le paramètre de requête 'include', sinon null.Contenu HTML.Les images intégrées sont résolues en URL selon l'en-tête de requête 'x-robaws-html-image-mode' : TEMPORARY_URL (par défaut) renvoie des URL pré-signées à durée limitée qui ne nécessitent aucune authentification ; PERMANENT_URL renvoie des URL stables qui nécessitent une session authentifiée ; NONE renvoie le HTML stocké, où chaque image est une <img> avec un data-robaws-id et un src vide — conservez cette balise et son data-robaws-id lors de la réécriture du HTML, faute de quoi l'image sera perdue.Toute autre valeur (par ex.BASE64_INLINE) renvoie 400 Bad Request.En écriture, omettez-le ou envoyez null pour conserver le texte actuel ; envoyez une chaîne vide pour le vider. |

## Clés

| Key | Column | Se réfère à | Kind | Description |
|---|---|---|---|---|
| `Projects_clientContactId_txt` | `clientContactId` | [Contacts](Robaws.Contacts.Contacts)`.id` | Textual | La ligne référencée, tant que Robaws la répertorie encore : une ligne supprimée ou purgée n'est plus répertoriée, et un document peut continuer à y faire référence. |
| `Projects_clientId_txt` | `clientId` | [Clients](Robaws.Clients.Clients)`.id` | Textual | La ligne référencée, tant que Robaws la répertorie encore : une ligne supprimée ou purgée n'est plus répertoriée, et un document peut continuer à y faire référence. |
| `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 | La ligne référencée, tant que Robaws la répertorie encore : une ligne supprimée ou purgée n'est plus répertoriée, et un document peut continuer à y faire référence. |
| `Projects_siteManagerId_txt` | `siteManagerId` | [Users](Robaws.Users.Users)`.id` | Textual | La ligne référencée, tant que Robaws la répertorie encore : une ligne supprimée ou purgée n'est plus répertoriée, et un document peut continuer à y faire référence. |

## Référencée

- [DeliveryNotes](Robaws.DeliveryNotes.DeliveryNotes) `projectId` (textuel)
- [Installations](Robaws.Installations.Installations) `assignedProjectId` (Textuel)
- [Matériaux](Robaws.Materials.Materials) `assignedProjectId` (textuel)
- [ProjectConstructionPartners](Robaws.ProjectConstructionPartners.ProjectConstructionPartners) `projectId` (Key)
- [SalesInvoiceLineItems](Robaws.SalesInvoiceLineItems.SalesInvoiceLineItems) `projectId` (textuel)
- [SalesOrders](Robaws.SalesOrders.SalesOrders) `projectId` (textuel)
- [Règlements](Robaws.Settlements.Settlements) `projectId` (Textuel)
- [StockReservations](Robaws.StockReservations.StockReservations) `projectId` (textuel)
- [SubscriptionLineItems](Robaws.SubscriptionLineItems.SubscriptionLineItems) `projectId` (Key)
- [TimeRegistrations](Robaws.TimeRegistrations.TimeRegistrations) `projectId` (textuel)

## Exemples 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
```


## Notes de Version

Quels ont été les changements apportés à chaque version au niveau des tables, des colonnes, des attributs et des fonctionnalités du chauffeur :

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