Documentation API – Activity

Activity Endpoint

Gérez les activités à travers différents systèmes ERP avec une API REST unifiée.
Les activités représentent des codes ou catégories utilisées pour classifier les transactions,
les achats et les projets dans votre système comptable.

GET/Entity/Activity

Aperçu

L’entité Activity représente une activité (ou code d’activité) dans votre système ERP.
Les activités sont généralement utilisées pour catégoriser les transactions, associer des comptes GL
et suivre les coûts par projet ou par fournisseur.

L’API utilise des endpoints REST standards avec les méthodes HTTP appropriées :

GET /Entity/Activity – Récupérer une liste d’activités

💡 Note importante

L’entité Activity est actuellement supportée uniquement en lecture (GET) pour le système ERP Avantage.
Elle permet d’extraire les codes d’activités avec leurs associations aux comptes GL et fournisseurs.

Matrice de Support

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

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

GET Activity

Récupère une liste d’activités avec support de filtrage, pagination et sélection de champs.

GET/Entity/Activity

Paramètres de requêtes

Paramètre	Type	Requis	Description
$filter	string	Optionnel	Filtre OData pour filtrer les résultats
$select	string	Optionnel	Sélectionne les champs à retourner
$expand	string	Optionnel	Inclut les entités liées (ex: RepartitionParProjet)
$orderby	string	Optionnel	Trie les résultats
$top	integer	Optionnel	Nombre maximum de résultats
$skip	integer	Optionnel	Nombre de résultats à sauter

💡 Note importante

Pour plus de détails sur la composition des requêtes, consultez : Composer une requête à l’API d’ERP Connector

Expand disponibles

Valeur	Description
RepartitionParProjet	Inclut les répartitions par projet associées à l’activité

Get Activity

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

Response (200 OK)

{
    "NoUniqueSystemeSource": "02820",
    "NoActivite": "02820",
    "DescriptionFR": "Clôtures et barrières",
    "DescriptionEN": null,
    "NoFournisseur": null,
    "NoCompteGL": "41100",
    "ExtendedProperties": {
        "RepartitionParProjet": [
            {
                "NoUniqueSystemeSource": "P000022",
                "NoActivite": "02820",
                "NoCompteGL": "33510",
                "DateTransaction": "2015-02-25T00:00:00",
                "MontantReparti": 1717.5,
                "NoProjet": "0000000110"
            }
        ]
    }
}

Get Activity avec répartition par projet

GET /Entity/Activity?$expand=RepartitionParProjet
Host: https://v4.api.onlineerp.solution.quebec/api
Content-Type: application/json

Response (200 OK) avec $expand

{
    "NoUniqueSystemeSource": "02820",
    "NoActivite": "02820",
    "DescriptionFR": "Clôtures et barrières",
    "DescriptionEN": null,
    "NoFournisseur": null,
    "NoCompteGL": "41100",
    "ExtendedProperties": {
        "RepartitionParProjet": [
            {
                "NoUniqueSystemeSource": "P000022",
                "NoActivite": "02820",
                "NoCompteGL": "33510",
                "DateTransaction": "2015-02-25T00:00:00",
                "MontantReparti": 1717.5,
                "NoProjet": "0000000110"
            }
        ]
    }
}

Propriétés détaillées de Activity

Identification et informations principales

Propriété	Type	Description
NoUniqueSystemeSource	string	Identifiant unique de l’activité dans le système source (correspond au numéro d’activité)
NoActivite	string	Numéro de l’activité (clé business)
DescriptionFR	string	Description de l’activité en français
DescriptionEN	string	Description de l’activité en anglais
NoFournisseur	string	Numéro du fournisseur associé à cette activité
NoCompteGL	string	Numéro du compte GL d’achat associé à l’activité

Propriétés étendues

Propriété	Type	Description
ExtendedProperties	Dictionary<string, object>	Dictionnaire contenant des propriétés additionnelles (ex: RepartitionParProjet)

💡 RepartitionParProjet

Lorsque vous utilisez $expand=RepartitionParProjet, le dictionnaire ExtendedProperties
contiendra une liste de répartitions par projet avec les propriétés suivantes :

Propriétés de RepartitionParProjet

Propriété	Type	Description
NoUniqueSystemeSource	string	Identifiant unique de la transaction de répartition
NoActivite	string	Numéro de l’activité parent
NoCompteGL	string	Numéro du compte GL de la transaction
DateTransaction	DateTime	Date de la transaction
MontantReparti	decimal	Montant réparti sur le projet
NoProjet	string	Numéro du projet associé à la répartition