Documentation API – Project

Project Endpoint

Gérez les projets à travers différents systèmes ERP avec une API REST unifiée.

GET/Entity/Project

Aperçu

L’entité Project représente un projet de construction ou de travail dans votre système ERP.
Cette entité est différente de GLProject qui concerne les projets comptables (Grand Livre).
Les projets de construction incluent des informations sur les clients, les montants de ventes/achats, les retenues, et l’état d’avancement des travaux.

L’API utilise un endpoint REST standard en lecture seule :

GET /Entity/Project – Récupérer les projets de construction (Acomba Construction, Avantage)

💡 Distinction Project vs GLProject

Project (EntityType.Project) : Projets de construction/travail avec clients, montants, retenues
GLProject (EntityType.GLProject) : Projets comptables du Grand Livre avec budgets et segments
Ces deux entités sont indépendantes et servent des besoins différents.

Matrice de Support

Opérations supportées pour l’entité Project par système ERP :

Système ERP	GET	POST	PUT
Acomba Construction	✓ Oui	✗ Non	✗ Non
Avantage	✓ Oui	✗ Non	✗ Non
QuickBooks Online	✗ Non	✗ Non	✗ Non
Sage 50	✗ Non	✗ Non	✗ Non
Servex	✗ Non	✗ Non	✗ Non
Servicentre	✗ Non	✗ Non	✗ Non

GET Project

Récupère les projets de construction avec leurs informations financières et clients associés.

GET/Entity/Project

Paramètres de requêtes

Paramètre	Type	Requis	Description
$filter	string	Optionnel	Expression de filtrage de style OData
$select	string	Optionnel	Champs à retourner (séparés par des virgules)
$expand	string	Optionnel	Champs à épandre
$orderby	string	Optionnel	Permet de trier les résultats
$top	integer	Optionnel	Nombre maximum de résultats
$skip	integer	Optionnel	Nombre de résultats à ignorer (pagination)

GET All Projects

GET /Entity/Project
Host: https://v4.api.onlineerp.solution.quebec/api
Content-Type: application/json

Response (200 OK)

[
    {
        "NoUniqueSystemeSource": "0000000001",
        "NoProjet": "0000000001",
        "NomProjet": "Agrandissement Centre administratif",
        "EmployeResponsable_No": "0001",
        "EmployeResponsable_NoUniqueSystemeSource": null,
        "Client_No": "",
        "Client_NoUniqueSystemeSource": null,
        "ClientFacturerA_No": null,
        "ClientFacturerA_NoUniqueSystemeSource": null,
        "ProjetInitial_No": null,
        "ProjetInitial_NoUniqueSystemeSource": null,
        "EstActif": true,
        "Adresse": "1234, rue Principale",
        "Ville": "Québec",
        "Province": "QC",
        "TypeProjet1": null,
        "CompteClientMontantVenteADate": 0.0,
        "CompteClientMontantAchatADate": 0.0,
        "CompteClientRetenueTotaleADate": 0.0,
        "CompteClientRetetueARecevoirADate": 0.0,
        "CompteFournisseurMontantAchatADate": 0.0,
        "CompteFournisseurSoldeAPayerADate": 0.0,
        "CompteFournisseurRetenueTotaleADate": 0.0,
        "CompteFournisseurRetetueAPayerADate": 0.0,
        "DateDebutProjet": null,
        "DateFinProjet": null,
        "Fiche_DerniereModification": null
    }
]

Modèle de Données (FicheProjet)

Structure complète de l’entité Project :

Champ	Type	Description
NoUniqueSystemeSource	string	Identifiant unique du système source ERP
NoProjet	string	Numéro du projet (clé métier)
NomProjet	string	Nom du projet
EstActif	boolean	Indique si le projet est actif
TypeProjet1	string	Type ou catégorie du projet
Client_No	string	Numéro du client associé
Client_NoUniqueSystemeSource	string	Identifiant unique du client dans le système source
ClientFacturerA_No	string	Numéro du client à facturer (si différent du client principal)
ClientFacturerA_NoUniqueSystemeSource	string	Identifiant unique du client à facturer
EmployeResponsable_No	string	Numéro de l’employé responsable du projet
EmployeResponsable_NoUniqueSystemeSource	string	Identifiant unique de l’employé responsable
ProjetInitial_No	string	Numéro du projet initial (pour les projets liés)
ProjetInitial_NoUniqueSystemeSource	string	Identifiant unique du projet initial
Adresse	string	Adresse du site du projet
Ville	string	Ville du site du projet
Province	string	Province ou état du site du projet
DateDebutProjet	DateTime?	Date de début du projet
DateFinProjet	DateTime?	Date de fin prévue ou réelle du projet
CompteClientMontantVenteADate	decimal	Montant total des ventes au client à ce jour
CompteClientMontantAchatADate	decimal	Montant total des achats facturés au client à ce jour
CompteClientRetenueTotaleADate	decimal	Montant total des retenues appliquées par le client à ce jour
CompteClientRetetueARecevoirADate	decimal	Montant des retenues à recevoir du client à ce jour
CompteFournisseurMontantAchatADate	decimal	Montant total des achats aux fournisseurs à ce jour
CompteFournisseurSoldeAPayerADate	decimal	Solde à payer aux fournisseurs à ce jour
CompteFournisseurRetenueTotaleADate	decimal	Montant total des retenues appliquées aux fournisseurs à ce jour
CompteFournisseurRetetueAPayerADate	decimal	Montant des retenues à payer aux fournisseurs à ce jour
Fiche_DerniereModification	DateTime?	Date et heure de la dernière modification de la fiche