Documentation API – Equipment

Equipment API

Gérez les équipements à travers différents systèmes ERP avec une API REST unifiée.
Lisez les fiches d’équipement pour Servicentre et autres systèmes ERP supportés.

GET/Entity/Equipment

Aperçu

L’entité Equipment représente un équipement enregistré dans votre système ERP.
Cette API permet d’effectuer des opérations de lecture (GET) sur les équipements
de manière standardisée, peu importe le système ERP sous-jacent.

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

  • GET /Entity/Equipment – Récupérer une liste d’équipements

Matrice de Support

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

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

GET Equipment

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

GET/Entity/Equipment

Paramètres de requêtes

Paramètre Type Requis Description
$select string Optionnel Champs à retourner (séparés par des virgules)
$top integer Optionnel Nombre maximum de résultats
$skip integer Optionnel Nombre de résultats à ignorer (pagination)
💡 Note importante

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

Get Equipment
GET /Entity/Equipment?$select=SerialNumber,PieceNumber,EquipmentDescription,CustomerNumber,EquipmentSite
Host: https://v4.api.onlineerp.solution.quebec/api
Content-Type: application/json
Response (200 OK)
[
    {
        "SerialNumber": "SN-2024-00123",
        "PieceNumber": "PC-4500",
        "EquipmentDescription": "Compresseur industriel 5HP",
        "CustomerNumber": "514-555-1234",
        "EquipmentSite": "Site A - Entrepôt principal"
    },
    {
        "SerialNumber": "SN-2024-00456",
        "PieceNumber": "PC-7800",
        "EquipmentDescription": "Système de ventilation HVAC",
        "CustomerNumber": "450-555-6789",
        "EquipmentSite": "Site B - Bureau administratif"
    },
    {
        "SerialNumber": "SN-2023-00789",
        "PieceNumber": "PC-3200",
        "EquipmentDescription": "Chaudière à gaz naturel",
        "CustomerNumber": "514-555-9876",
        "EquipmentSite": "Site A - Entrepôt principal"
    }
]

Modèle de Données

Fiche Équipement (ServicentreEquipment)

Structure retournée lors de l’extraction des équipements depuis Servicentre :

Champ Type Description
SerialNumber string Numéro de série de l’équipement
PieceNumber string Numéro de pièce de l’équipement
EquipmentDescription string Description de l’équipement
CustomerNumber string Numéro de téléphone du client associé
EquipmentSite string Site où se trouve l’équipement