Documentation API – Employee

Employee API

Gérez les employés à travers différents systèmes ERP avec une API REST unifiée.
Lisez les informations des employés pour Avantage, Servicentre et autres systèmes ERP.

GET/Entity/Employee

Aperçu

L’entité Employee (Employé) représente un employé dans votre système ERP.
Cette API permet principalement d’effectuer des opérations de lecture (Read) sur les fiches employés
de manière standardisée, facilitant l’accès aux données RH de votre organisation.

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

GET /Entity/Employee – Récupérer une liste d’employés
GET /Entity/Employee/{id} – Récupérer un employé spécifique

💡 Note importante

Les champs disponibles varient selon le système ERP. Avantage offre des informations RH complètes, tandis que Servicentre offre des informations de base.

Matrice de Support

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

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

GET Employee

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

GET/Entity/Employee

Paramètres de requêtes

Paramètre	Type	Requis	Description
$filter	string	Optionnel	Expression de filtrage de style OData (ex: `EstActif eq true`)
$select	string	Optionnel	Champs à retourner (séparés par des virgules)
$orderby	string	Optionnel	Permet de trier les résultats (ex: `NomEmploye asc`)
$top	integer	Optionnel	Nombre maximum de résultats
$skip	integer	Optionnel	Nombre de résultats à ignorer (pagination)

💡 Note pour composer une requête

Pour plus de détails, veuillez consulter cet article : Composer une requête à l’API d’ERP Connector

Get Employees

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

Response (200 OK) – Avantage

[
    {
        "NoUniqueSystemeSource": "0001",NAS
        "NoEmploye": "0001",
        "NomEmploye": "LAVALIN",
        "PrenomEmploye": "JACQUES",
        "NomCompletEmploye": "JACQUES LAVALIN",
        "EmailEmploye": "",
        "NoAssuranceSocial": "***********",
        "Adresse1": "34, GREEN",
        "Adresse2": "",
        "Ville": "WESTMOUNT",
        "CodePostal": "H4E 6T6",
        "Telephone1": "514-235-6363",
        "Departement": null,
        "DateEmbauche": null,
        "EstActif": true
    }
]

Response (200 OK) – Servicentre

{
    "EmployeeId": "1",
    "EmployeeNumber": "1",
    "EmployeeFirstName": "JOHN",
    "EmployeeLastName": "DOE"
}

⚠️ Limitation Servicentre

L’intégration Servicentre pour l’entité Employee est limitée. Seules les informations de base sont disponibles.

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

Identification

Propriété	Type	Description
NoEmploye	string	Numéro de l’employé
NoUniqueSystemeSource	string	Identifiant unique du système source ERP
NoAssuranceSocial	string	Numéro d’assurance sociale
EstActif	bool	Indique si l’employé est actif

Informations personnelles

Propriété	Type	Description
NomEmploye	string	Nom de l’employé
PrenomEmploye	string	Prénom de l’employé
NomCompletEmploye	string (readonly)	Nom complet formaté (Prénom + Nom)
DateNaissance	DateTime?	Date de naissance de l’employé

Coordonnées

Propriété	Type	Description
Adresse1	string	Adresse ligne 1
Adresse2	string	Adresse ligne 2
Ville	string	Ville
CodePostal	string	Code postal
Telephone1	string	Numéro de téléphone principal
Telephone2	string	Numéro de téléphone secondaire
EmailEmploye	string	Adresse courriel principale
Courriel1	string	Adresse courriel alternative

Informations d’emploi

Propriété	Type	Description
Departement	string	Département ou service de l’employé
DateEmbauche	DateTime?	Date d’embauche
DateFinEmploi	DateTime?	Date de fin d’emploi

Autres propriétés

Propriété	Type	Description
Fiche_DerniereModification	DateTime?	Date et heure de la dernière modification de la fiche